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

Front Doors - Validate Custom Domain

验证自定义域映射,以确保它映射到 DNS 中正确的 Front Door 终结点。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}/validateCustomDomain?api-version=2019-05-01

URI 参数

Name In Required Type Description
frontDoorName
path True
  • string

全局唯一的 Front Door 的名称。

Regex pattern: ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$

resourceGroupName
path True
  • string

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

Regex pattern: ^[a-zA-Z0-9_\-\(\)\.]*[^\.]$

subscriptionId
path True
  • string

唯一标识Microsoft Azure订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。

api-version
query True
  • string

客户端 API 版本。

请求正文

Name Required Type Description
hostName True
  • string

自定义域的主机名。 必须是域名。

响应

Name Type Description
200 OK

没问题。 请求已成功。

Other Status Codes

Front Door 错误响应,描述操作失败的原因。

安全性

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 模拟用户帐户

示例

FrontDoor_ValidateCustomDomain

Sample Request

POST https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/validateCustomDomain?api-version=2019-05-01
{
  "hostName": "www.someDomain.com"
}

Sample Response

{
  "customDomainValidated": true,
  "message": null,
  "reason": null
}

定义

ErrorResponse

错误响应指示 Front Door 服务无法处理传入请求。 错误消息中提供了原因。

ValidateCustomDomainInput

要验证 DNS 映射的自定义域的输入。

ValidateCustomDomainOutput

自定义域验证的输出。

ErrorResponse

错误响应指示 Front Door 服务无法处理传入请求。 错误消息中提供了原因。

Name Type Description
code
  • string

错误代码。

message
  • string

指示操作失败的原因的错误消息。

ValidateCustomDomainInput

要验证 DNS 映射的自定义域的输入。

Name Type Description
hostName
  • string

自定义域的主机名。 必须是域名。

ValidateCustomDomainOutput

自定义域验证的输出。

Name Type Description
customDomainValidated
  • boolean

指示自定义域是否有效。

message
  • string

描述自定义域无效原因的错误消息。

reason
  • string

自定义域无效的原因。