共用方式為


Endpoints - Validate Custom Domain

驗證自定義網域對應,以確保對應至 DNS 中的正確 CDN 端點。

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

URI 參數

名稱 位於 必要 類型 Description
endpointName
path True

string

配置檔下唯一的端點名稱。

profileName
path True

string

資源群組內唯一的CDN配置檔名稱。

resourceGroupName
path True

string

Azure 訂用帳戶內的資源組名。

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

subscriptionId
path True

string

Azure 訂用帳戶識別碼。

api-version
query True

string

要與用戶端要求搭配使用的 API 版本。 目前的版本是 2024-02-01。

要求本文

名稱 必要 類型 Description
hostName True

string

自定義網域的主機名。 必須是網域名稱。

回應

名稱 類型 Description
200 OK

ValidateCustomDomainOutput

正常。 要求已成功。

Other Status Codes

ErrorResponse

描述作業失敗原因的CDN錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

Endpoints_ValidateCustomDomain

範例要求

POST https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/endpoints/endpoint1/validateCustomDomain?api-version=2024-02-01

{
  "hostName": "www.someDomain.com"
}

範例回覆

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

定義

名稱 Description
ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

ValidateCustomDomainInput

要驗證 DNS 對應之自定義網域的輸入。

ValidateCustomDomainOutput

自訂網域驗證的輸出。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

錯誤物件。

ValidateCustomDomainInput

要驗證 DNS 對應之自定義網域的輸入。

名稱 類型 Description
hostName

string

自定義網域的主機名。 必須是網域名稱。

ValidateCustomDomainOutput

自訂網域驗證的輸出。

名稱 類型 Description
customDomainValidated

boolean

指出自定義網域是否有效。

message

string

描述自定義網域無效原因的錯誤訊息。

reason

string

自定義網域無效的原因。