你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Profiles - Migrate

服务:

CDN

API 版本:

2024-02-01

将 CDN 配置文件迁移到 Azure Frontdoor (标准/高级) 配置文件。 需要在此之后提交更改。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/migrate?api-version=2024-02-01

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string	Azure 订阅中的资源组的名称。 正则表达式模式: ^[-\w\._\(\)]+$
subscriptionId	path	True	string	Azure 订阅 ID。
api-version	query	True	string	要与客户端请求一起使用的 API 的版本。 当前版本为 2024-02-01。

请求正文

名称	必需	类型	说明
classicResourceReference	True	ResourceReference	需要迁移的经典 cdn 配置文件或经典前门的资源引用。
profileName	True	string	需要创建的新配置文件的名称。
sku	True	Sku	迁移的 SKU
migrationWebApplicationFirewallMappings		MigrationWebApplicationFirewallMapping[]	已迁移配置文件的 Waf 映射

响应

名称	类型	说明
200 OK	MigrateResult	没问题。 请求已成功。
202 Accepted	MigrateResult	已接受。 已接受请求进行处理，操作将以异步方式完成。 标头 location: string
Other Status Codes	ErrorResponse	描述操作失败原因的 CDN 错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Profiles_Migrate

示例请求

HTTP

POST https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/migrate?api-version=2024-02-01

{
  "sku": {
    "name": "Standard_AzureFrontDoor"
  },
  "classicResourceReference": {
    "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Network/frontdoors/frontdoorname"
  },
  "profileName": "profile1"
}

Java

import com.azure.resourcemanager.cdn.models.MigrationParameters;
import com.azure.resourcemanager.cdn.models.ResourceReference;
import com.azure.resourcemanager.cdn.models.Sku;
import com.azure.resourcemanager.cdn.models.SkuName;

/**
 * Samples for Profiles Migrate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/cdn/resource-manager/Microsoft.Cdn/stable/2024-02-01/examples/Profiles_Migrate.json
     */
    /**
     * Sample code: Profiles_Migrate.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void profilesMigrate(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.cdnProfiles().manager().serviceClient().getProfiles().migrate("RG",
            new MigrationParameters().withSku(new Sku().withName(SkuName.STANDARD_AZURE_FRONT_DOOR))
                .withClassicResourceReference(new ResourceReference().withId(
                    "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Network/frontdoors/frontdoorname"))
                .withProfileName("profile1"),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.cdn import CdnManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-cdn
# USAGE
    python profiles_migrate.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = CdnManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.profiles.begin_migrate(
        resource_group_name="RG",
        migration_parameters={
            "classicResourceReference": {
                "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Network/frontdoors/frontdoorname"
            },
            "profileName": "profile1",
            "sku": {"name": "Standard_AzureFrontDoor"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/cdn/resource-manager/Microsoft.Cdn/stable/2024-02-01/examples/Profiles_Migrate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armcdn_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/cdn/armcdn/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/cdn/resource-manager/Microsoft.Cdn/stable/2024-02-01/examples/Profiles_Migrate.json
func ExampleProfilesClient_BeginMigrate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcdn.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewProfilesClient().BeginMigrate(ctx, "RG", armcdn.MigrationParameters{
		ClassicResourceReference: &armcdn.ResourceReference{
			ID: to.Ptr("/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Network/frontdoors/frontdoorname"),
		},
		ProfileName: to.Ptr("profile1"),
		SKU: &armcdn.SKU{
			Name: to.Ptr(armcdn.SKUNameStandardAzureFrontDoor),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.MigrateResult = armcdn.MigrateResult{
	// 	Type: to.Ptr("Microsoft.Cdn/migrate"),
	// 	ID: to.Ptr("/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/operationresults/operationid/profileresults/profile1/migrateresults/profile1"),
	// 	Properties: &armcdn.MigrateResultProperties{
	// 		MigratedProfileResourceID: &armcdn.ResourceReference{
	// 			ID: to.Ptr("/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1"),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { CdnManagementClient } = require("@azure/arm-cdn");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Migrate the CDN profile to Azure Frontdoor(Standard/Premium) profile. The change need to be committed after this.
 *
 * @summary Migrate the CDN profile to Azure Frontdoor(Standard/Premium) profile. The change need to be committed after this.
 * x-ms-original-file: specification/cdn/resource-manager/Microsoft.Cdn/stable/2024-02-01/examples/Profiles_Migrate.json
 */
async function profilesMigrate() {
  const subscriptionId = process.env["CDN_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["CDN_RESOURCE_GROUP"] || "RG";
  const migrationParameters = {
    classicResourceReference: {
      id: "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Network/frontdoors/frontdoorname",
    },
    profileName: "profile1",
    sku: { name: "Standard_AzureFrontDoor" },
  };
  const credential = new DefaultAzureCredential();
  const client = new CdnManagementClient(credential, subscriptionId);
  const result = await client.profiles.beginMigrateAndWait(resourceGroupName, migrationParameters);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Cdn.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Resources.Models;
using Azure.ResourceManager.Cdn;

// Generated from example definition: specification/cdn/resource-manager/Microsoft.Cdn/stable/2024-02-01/examples/Profiles_Migrate.json
// this example is just showing the usage of "Profiles_Migrate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "subid";
string resourceGroupName = "RG";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// invoke the operation
MigrationContent content = new MigrationContent(new CdnSku()
{
    Name = CdnSkuName.StandardAzureFrontDoor,
}, new WritableSubResource()
{
    Id = new ResourceIdentifier("/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Network/frontdoors/frontdoorname"),
}, "profile1");
ArmOperation<MigrateResult> lro = await resourceGroupResource.MigrateProfileAsync(WaitUntil.Completed, content);
MigrateResult result = lro.Value;

Console.WriteLine($"Succeeded: {result}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:

200

{
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/operationresults/operationid/profileresults/profile1/migrateresults/profile1",
  "type": "Microsoft.Cdn/migrate",
  "properties": {
    "migratedProfileResourceId": {
      "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1"
    }
  }
}

状态代码:

202

azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2024-02-01

{
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/operationresults/operationid/profileresults/profile1/migrateresults/profile1",
  "type": "Microsoft.Cdn/migrate",
  "properties": {
    "migratedProfileResourceId": {
      "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1"
    }
  }
}

定义

名称	说明
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
MigrateResult	迁移操作的结果。
MigrationParameters	Migrate 操作的请求正文。
MigrationWebApplicationFirewallMapping	Web 应用程序防火墙映射
ResourceReference	对另一个资源的引用。
Sku	Standard_Verizon = 标准 Verizon CDN 配置文件的 SKU 名称。 Premium_Verizon = Premium Verizon CDN 配置文件的 SKU 名称。 Custom_Verizon = 自定义 Verizon CDN 配置文件的 SKU 名称。 Standard_Akamai = Akamai CDN 配置文件的 SKU 名称。 Standard_ChinaCdn = 使用基于 GB 的计费模型进行 VOD、Web 和下载方案的中国 CDN 配置文件的 SKU 名称。 Standard_Microsoft = 标准 Microsoft CDN 配置文件的 SKU 名称。 Standard_AzureFrontDoor = Azure Front Door 标准配置文件的 SKU 名称。 Premium_AzureFrontDoor = Azure Front Door Premium 配置文件的 SKU 名称。 Standard_955BandWidth_ChinaCdn = 使用 95-5 峰值带宽计费模型的 VOD、Web 和下载方案的中国 CDN 配置文件的 SKU 名称。 Standard_AvgBandWidth_ChinaCdn = 使用每月平均峰值带宽计费模型的 VOD、Web 和下载方案的中国 CDN 配置文件的 SKU 名称。 StandardPlus_ChinaCdn = 使用基于 GB 的计费模型进行实时流式传输的中国 CDN 配置文件的 SKU 名称。 StandardPlus_955BandWidth_ChinaCdn = 使用 95-5 峰值带宽计费模型的中国 CDN 实时流式处理配置文件的 SKU 名称。 StandardPlus_AvgBandWidth_ChinaCdn = 使用每月平均峰值带宽计费模型的中国 CDN 实时流式处理配置文件的 SKU 名称。
SkuName	定价层的名称。

ErrorAdditionalInfo

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

MigrateResult

迁移操作的结果。

名称	类型	说明
id	string	资源 ID。
properties.migratedProfileResourceId	ResourceReference	已迁移配置文件的 Arm 资源 ID
type	string	资源类型。

MigrationParameters

Migrate 操作的请求正文。

名称	类型	说明
classicResourceReference	ResourceReference	需要迁移的经典 cdn 配置文件或经典前门的资源引用。
migrationWebApplicationFirewallMappings	MigrationWebApplicationFirewallMapping[]	已迁移配置文件的 Waf 映射
profileName	string	需要创建的新配置文件的名称。
sku	Sku	迁移的 SKU

MigrationWebApplicationFirewallMapping

Web 应用程序防火墙映射

名称	类型	说明
migratedFrom	ResourceReference	从 Waf 策略迁移
migratedTo	ResourceReference	迁移到 Waf 策略

ResourceReference

对另一个资源的引用。

名称	类型	说明
id	string	资源 ID。

Sku

Standard_Verizon = 标准 Verizon CDN 配置文件的 SKU 名称。 Premium_Verizon = Premium Verizon CDN 配置文件的 SKU 名称。 Custom_Verizon = 自定义 Verizon CDN 配置文件的 SKU 名称。 Standard_Akamai = Akamai CDN 配置文件的 SKU 名称。 Standard_ChinaCdn = 使用基于 GB 的计费模型进行 VOD、Web 和下载方案的中国 CDN 配置文件的 SKU 名称。 Standard_Microsoft = 标准 Microsoft CDN 配置文件的 SKU 名称。 Standard_AzureFrontDoor = Azure Front Door 标准配置文件的 SKU 名称。 Premium_AzureFrontDoor = Azure Front Door Premium 配置文件的 SKU 名称。 Standard_955BandWidth_ChinaCdn = 使用 95-5 峰值带宽计费模型的 VOD、Web 和下载方案的中国 CDN 配置文件的 SKU 名称。 Standard_AvgBandWidth_ChinaCdn = 使用每月平均峰值带宽计费模型的 VOD、Web 和下载方案的中国 CDN 配置文件的 SKU 名称。 StandardPlus_ChinaCdn = 使用基于 GB 的计费模型进行实时流式传输的中国 CDN 配置文件的 SKU 名称。 StandardPlus_955BandWidth_ChinaCdn = 使用 95-5 峰值带宽计费模型的中国 CDN 实时流式处理配置文件的 SKU 名称。 StandardPlus_AvgBandWidth_ChinaCdn = 使用每月平均峰值带宽计费模型的中国 CDN 实时流式处理配置文件的 SKU 名称。

名称	类型	说明
name	SkuName	定价层的名称。

SkuName

定价层的名称。

名称	类型	说明
Custom_Verizon	string
Premium_AzureFrontDoor	string
Premium_Verizon	string
StandardPlus_955BandWidth_ChinaCdn	string
StandardPlus_AvgBandWidth_ChinaCdn	string
StandardPlus_ChinaCdn	string
Standard_955BandWidth_ChinaCdn	string
Standard_Akamai	string
Standard_AvgBandWidth_ChinaCdn	string
Standard_AzureFrontDoor	string
Standard_ChinaCdn	string
Standard_Microsoft	string
Standard_Verizon	string