Profiles - Get

服务:

CDN

API 版本:

2025-04-15

获取具有指定订阅和资源组下指定配置文件名称的 Azure Front Door Standard 或 Azure Front Door Premium 或 CDN 配置文件。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}?api-version=2025-04-15

URI 参数

名称	在	必需	类型	说明
profileName	path	True	string	Azure Front Door Standard 或 Azure Front Door Premium 或 CDN 配置文件的名称，该配置文件在资源组中是唯一的。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。 此名称不区分大小写。
subscriptionId	path	True	string (uuid)	目标订阅的 ID。 该值必须是 UUID。
api-version	query	True	string minLength: 1	用于此操作的 API 版本。

响应

名称	类型	说明
200 OK	Profile	还行。 请求已成功。
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_Get

示例请求

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1?api-version=2025-04-15

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.Cdn;

// Generated from example definition: specification/cdn/resource-manager/Microsoft.Cdn/stable/2025-04-15/examples/Profiles_Get.json
// this example is just showing the usage of "Profiles_Get" 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);

// get the collection of this ProfileResource
ProfileCollection collection = resourceGroupResource.GetProfiles();

// invoke the operation
string profileName = "profile1";
NullableResponse<ProfileResource> response = await collection.GetIfExistsAsync(profileName);
ProfileResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // the variable result is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    ProfileData resourceData = result.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

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

示例响应

状态代码:

200

{
  "name": "profile1",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1",
  "type": "Microsoft.Cdn/profiles",
  "tags": {},
  "location": "global",
  "sku": {
    "name": "Premium_AzureFrontDoor"
  },
  "kind": "frontdoor",
  "properties": {
    "originResponseTimeoutSeconds": 30,
    "logScrubbing": {
      "state": "Enabled",
      "scrubbingRules": []
    },
    "frontDoorId": "3b4682da-b3e2-47a1-96ca-08ab3cb7294e",
    "provisioningState": "Succeeded",
    "resourceState": "Active"
  }
}

定义

名称	说明
scrubbingRuleEntryMatchOperator	如果 matchVariable 是集合，请对选择器进行操作，以指定此规则应用于的集合中的哪些元素。
scrubbingRuleEntryState	定义日志清理规则的状态。 默认值处于启用状态。
createdByType	创建资源的标识的类型。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
ManagedServiceIdentity	托管服务标识（系统分配和/或用户分配的标识）
ManagedServiceIdentityType	托管服务标识的类型（其中允许 SystemAssigned 和 UserAssigned 类型）。
Profile	配置文件是共享相同设置的终结点的逻辑分组。
ProfileLogScrubbing	定义在 Azure Front Door 配置文件日志中清理敏感字段的规则。
ProfileProvisioningState	配置文件的预配状态。
ProfileResourceState	配置文件的资源状态。
ProfileScrubbingRules	定义日志清理规则的内容。
ProfileScrubbingState	日志清理配置的状态。默认值为“已启用”。
scrubbingRuleEntryMatchVariable	要从日志中清理的变量。
Sku	Standard_Verizon = 标准 Verizon CDN 配置文件的 SKU 名称。 Premium_Verizon = 高级 Verizon CDN 配置文件的 SKU 名称。 Custom_Verizon = 自定义 Verizon CDN 配置文件的 SKU 名称。 Standard_Akamai = Akamai CDN 配置文件的 SKU 名称。 Standard_ChinaCdn = VOD、Web 的中国 CDN 配置文件的 SKU 名称，以及使用基于 GB 的计费模型下载方案。 Standard_Microsoft = Standard Microsoft CDN 配置文件的 SKU 名称。 Standard_AzureFrontDoor = Azure Front Door 标准配置文件的 SKU 名称。 Premium_AzureFrontDoor = Azure Front Door Premium 配置文件的 SKU 名称。 Standard_955BandWidth_ChinaCdn = 使用 95-5 峰值带宽计费模型的中国 CDN 配置文件的 SKU 名称，适用于 VOD、Web 和下载方案。 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	定价层的名称。
systemData	与创建和上次修改资源相关的元数据。
UserAssignedIdentity	用户分配的标识属性

scrubbingRuleEntryMatchOperator

枚举

如果 matchVariable 是集合，请对选择器进行操作，以指定此规则应用于的集合中的哪些元素。

值	说明
EqualsAny

scrubbingRuleEntryState

枚举

定义日志清理规则的状态。 默认值处于启用状态。

值	说明
Disabled
Enabled

createdByType

枚举

创建资源的标识的类型。

值	说明
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

资源管理错误附加信息。

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

ErrorDetail

Object

错误详细信息。

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

ErrorResponse

Object

错误响应

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

ManagedServiceIdentity

Object

托管服务标识（系统分配和/或用户分配的标识）

名称	类型	说明
principalId	string (uuid)	系统分配标识的服务主体 ID。 此属性仅针对系统分配的标识提供。
tenantId	string (uuid)	系统分配标识的租户 ID。 此属性仅针对系统分配的标识提供。
type	ManagedServiceIdentityType	托管服务标识的类型（其中允许 SystemAssigned 和 UserAssigned 类型）。
userAssignedIdentities	<string,  UserAssignedIdentity>	与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将为 ARM 资源 ID，格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 字典值可以是请求中的空对象（{}）。

ManagedServiceIdentityType

枚举

托管服务标识的类型（其中允许 SystemAssigned 和 UserAssigned 类型）。

值	说明
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

Profile

Object

配置文件是共享相同设置的终结点的逻辑分组。

名称	类型	说明
id	string (arm-id)	资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
identity	ManagedServiceIdentity	托管服务标识（系统分配和/或用户分配的标识）。
kind	string	配置文件的类型。 门户用于区分传统的 CDN 配置文件和新的 AFD 配置文件。
location	string	资源所在的地理位置
name	string	资源的名称
properties.extendedProperties	object	Key-Value 对，表示配置文件的其他属性。
properties.frontDoorId	string	前门的 ID。
properties.logScrubbing	ProfileLogScrubbing	定义在 Azure Front Door 配置文件日志中清理敏感字段的规则。
properties.originResponseTimeoutSeconds	integer (int32) minimum: 16 exclusiveMinimum: False	向源转发请求时发送和接收超时。 达到超时时，请求会失败并返回。
properties.provisioningState	ProfileProvisioningState	配置文件的预配状态。
properties.resourceState	ProfileResourceState	配置文件的资源状态。
sku	Sku	定价层（定义 Azure Front Door 标准版或高级版或 CDN 提供程序、功能列表和费率）配置文件。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object	资源标记。
type	string	资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

ProfileLogScrubbing

Object

定义在 Azure Front Door 配置文件日志中清理敏感字段的规则。

名称	类型	说明
scrubbingRules	ProfileScrubbingRules[]	应用于 Azure Front Door 配置文件日志的日志清理规则列表。
state	ProfileScrubbingState	日志清理配置的状态。默认值为“已启用”。

ProfileProvisioningState

枚举

配置文件的预配状态。

值	说明
Creating
Deleting
Failed
Succeeded
Updating

ProfileResourceState

枚举

配置文件的资源状态。

值	说明
AbortingMigration
Active
CommittingMigration
Creating
Deleting
Disabled
Migrated
Migrating
PendingMigrationCommit

ProfileScrubbingRules

Object

定义日志清理规则的内容。

名称	类型	说明
matchVariable	scrubbingRuleEntryMatchVariable	要从日志中清理的变量。
selector	string	matchVariable 是集合时，运算符用于指定此规则应用于的集合中的哪些元素。
selectorMatchOperator	scrubbingRuleEntryMatchOperator	如果 matchVariable 是集合，请对选择器进行操作，以指定此规则应用于的集合中的哪些元素。
state	scrubbingRuleEntryState	定义日志清理规则的状态。 默认值处于启用状态。

ProfileScrubbingState

枚举

日志清理配置的状态。默认值为“已启用”。

值	说明
Disabled
Enabled

scrubbingRuleEntryMatchVariable

枚举

要从日志中清理的变量。

值	说明
QueryStringArgNames
RequestIPAddress
RequestUri

Sku

Object

Standard_Verizon = 标准 Verizon CDN 配置文件的 SKU 名称。 Premium_Verizon = 高级 Verizon CDN 配置文件的 SKU 名称。 Custom_Verizon = 自定义 Verizon CDN 配置文件的 SKU 名称。 Standard_Akamai = Akamai CDN 配置文件的 SKU 名称。 Standard_ChinaCdn = VOD、Web 的中国 CDN 配置文件的 SKU 名称，以及使用基于 GB 的计费模型下载方案。 Standard_Microsoft = Standard Microsoft CDN 配置文件的 SKU 名称。 Standard_AzureFrontDoor = Azure Front Door 标准配置文件的 SKU 名称。 Premium_AzureFrontDoor = Azure Front Door Premium 配置文件的 SKU 名称。 Standard_955BandWidth_ChinaCdn = 使用 95-5 峰值带宽计费模型的中国 CDN 配置文件的 SKU 名称，适用于 VOD、Web 和下载方案。 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
Premium_AzureFrontDoor
Premium_Verizon
StandardPlus_955BandWidth_ChinaCdn
StandardPlus_AvgBandWidth_ChinaCdn
StandardPlus_ChinaCdn
Standard_955BandWidth_ChinaCdn
Standard_Akamai
Standard_AvgBandWidth_ChinaCdn
Standard_AzureFrontDoor
Standard_ChinaCdn
Standard_Microsoft
Standard_Verizon

systemData

Object

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

UserAssignedIdentity

Object

用户分配的标识属性

名称	类型	说明
clientId	string (uuid)	分配的标识的客户端 ID。
principalId	string (uuid)	已分配标识的主体 ID。