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

AFD Endpoints - Update

使用指定的订阅、资源组和配置文件下指定终结点名称更新现有的 AzureFrontDoor 终结点。 创建终结点后只能更新标记。 若要更新源,请使用“更新源”操作。 若要更新源组,请使用 Update Origin 组操作。 若要更新域,请使用更新Custom Domain操作。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/afdEndpoints/{endpointName}?api-version=2021-06-01

URI 参数

Name In Required Type Description
endpointName
path True
  • string

全局唯一的配置文件下的终结点的名称。

profileName
path True
  • string

Azure Front Door Standard 或 Azure Front Door 高级版配置文件的名称,该配置文件在资源组中是唯一的。

resourceGroupName
path True
  • string

Azure 订阅中的资源组的名称。

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True
  • string

Azure 订阅 ID。

api-version
query True
  • string

要与客户端请求一起使用的 API 版本。 当前版本为 2021-06-01。

请求正文

Name Type Description
properties.enabledState

是否要启用此规则。 允许的值为“Enabled”或“Disabled”

tags
  • object

终结点标记。

响应

Name Type Description
200 OK

OK

202 Accepted

已接受

Other Status Codes

CDN错误响应,描述操作失败的原因

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 模拟用户帐户

示例

AFDEndpoints_Update

Sample Request

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdEndpoints/endpoint1?api-version=2021-06-01
{
  "tags": {},
  "properties": {
    "enabledState": "Enabled"
  }
}

Sample Response

{
  "name": "endpoint1",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdendpoints/endpoint1",
  "type": "Microsoft.Cdn/profiles/afdendpoints",
  "tags": {},
  "location": "WestCentralUs",
  "properties": {
    "hostName": "endpoint1.azureedge.net",
    "enabledState": "Enabled",
    "provisioningState": "Succeeded",
    "deploymentStatus": "InProgress"
  }
}
azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2021-06-01
{
  "name": "endpoint1",
  "id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/afdendpoints/endpoint1",
  "type": "Microsoft.Cdn/profiles/afdendpoints",
  "tags": {},
  "location": "WestCentralUs",
  "properties": {
    "hostName": "endpoint1.azureedge.net",
    "enabledState": "Enabled",
    "provisioningState": "Updating",
    "deploymentStatus": "NotStarted"
  }
}

定义

AFDEndpoint

CDN终结点是包含配置信息(如源、协议、内容缓存和传递行为)的CDN配置文件中的实体。 AzureFrontDoor 终结点使用 URL 格式 .azureedge.net。

AFDEndpointUpdateParameters

创建或更新终结点所需的属性。

AfdErrorResponse

错误响应

AfdProvisioningState

预配状态

AutoGeneratedDomainNameLabelScope

指示终结点名称重用范围。 默认值为 TenantReuse。

DeploymentStatus
EnabledState

是否要启用此规则。 允许的值为“Enabled”或“Disabled”

ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

IdentityType

创建/修改资源的标识类型

SystemData

只读系统数据

AFDEndpoint

CDN终结点是包含配置信息(如源、协议、内容缓存和传递行为)的CDN配置文件中的实体。 AzureFrontDoor 终结点使用 URL 格式 .azureedge.net。

Name Type Description
id
  • string

资源 ID。

location
  • string

资源位置。

name
  • string

资源名称。

properties.autoGeneratedDomainNameLabelScope

指示终结点名称重用范围。 默认值为 TenantReuse。

properties.deploymentStatus
properties.enabledState

是否要启用此规则。 允许的值为“Enabled”或“Disabled”

properties.hostName
  • string

结构化为 {endpointName} 的终结点的主机名。{DNSZone},例如 contoso.azureedge.net

properties.profileName
  • string

保存终结点的配置文件的名称。

properties.provisioningState

预配状态

systemData

只读系统数据

tags
  • object

资源标记。

type
  • string

资源类型。

AFDEndpointUpdateParameters

创建或更新终结点所需的属性。

Name Type Description
properties.enabledState

是否要启用此规则。 允许的值为“Enabled”或“Disabled”

properties.profileName
  • string

保存终结点的配置文件的名称。

tags
  • object

终结点标记。

AfdErrorResponse

错误响应

Name Type Description
error

错误对象。

AfdProvisioningState

预配状态

Name Type Description
Creating
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Updating
  • string

AutoGeneratedDomainNameLabelScope

指示终结点名称重用范围。 默认值为 TenantReuse。

Name Type Description
NoReuse
  • string
ResourceGroupReuse
  • string
SubscriptionReuse
  • string
TenantReuse
  • string

DeploymentStatus

Name Type Description
Failed
  • string
InProgress
  • string
NotStarted
  • string
Succeeded
  • string

EnabledState

是否要启用此规则。 允许的值为“Enabled”或“Disabled”

Name Type Description
Disabled
  • string
Enabled
  • string

ErrorAdditionalInfo

资源管理错误附加信息。

Name Type Description
info
  • object

其他信息。

type
  • string

其他信息类型。

ErrorDetail

错误详细信息。

Name Type Description
additionalInfo

错误附加信息。

code
  • string

错误代码。

details

错误详细信息。

message
  • string

错误消息。

target
  • string

错误目标。

IdentityType

创建/修改资源的标识类型

Name Type Description
application
  • string
key
  • string
managedIdentity
  • string
user
  • string

SystemData

只读系统数据

Name Type Description
createdAt
  • string

资源创建时间戳 (UTC)

createdBy
  • string

创建资源的标识的标识符

createdByType

创建资源的标识的类型

lastModifiedAt
  • string

资源上次修改的时间戳 (UTC)

lastModifiedBy
  • string

上次修改资源的标识的标识符

lastModifiedByType

上次修改资源的标识的类型