Share via


Check Domain Availability - Check Domain Availability

檢查網域是否可用。

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.CognitiveServices/checkDomainAvailability?api-version=2023-05-01

URI 參數

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

string

目標訂用帳戶的標識碼。

api-version
query True

string

用於此作業的 API 版本。

要求本文

名稱 必要 類型 Description
subdomainName True

string

要使用的子域名稱。

type True

string

資源的類型。

kind

string

資源的種類。

回應

名稱 類型 Description
200 OK

DomainAvailability

正常。

Other Status Codes

ErrorResponse

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

範例

Check SKU Availability

Sample Request

POST https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.CognitiveServices/checkDomainAvailability?api-version=2023-05-01

{
  "subdomainName": "contosodemoapp1",
  "type": "Microsoft.CognitiveServices/accounts"
}

Sample Response

{
  "isSubdomainAvailable": false,
  "reason": "Sub domain name 'contosodemoapp1' is not valid",
  "subdomainName": "contosodemoapp1",
  "type": "Microsoft.CognitiveServices/accounts"
}

定義

名稱 Description
CheckDomainAvailabilityParameter

檢查網域可用性參數。

DomainAvailability

網域可用性。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

CheckDomainAvailabilityParameter

檢查網域可用性參數。

名稱 類型 Description
kind

string

資源的種類。

subdomainName

string

要使用的子域名稱。

type

string

資源的類型。

DomainAvailability

網域可用性。

名稱 類型 Description
isSubdomainAvailable

boolean

指出指定的 SKU 可用或無法使用。

kind

string

資源的種類。

reason

string

SKU 無法使用的原因。

subdomainName

string

要使用的子域名稱。

type

string

資源的類型。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

錯誤物件。