共用方式為


Profiles - Check Traffic Manager Relative Dns Name Availability

檢查流量管理員相對 DNS 名稱的可用性。

POST https://management.azure.com/providers/Microsoft.Network/checkTrafficManagerNameAvailability?api-version=2022-04-01

URI 參數

名稱 位於 必要 類型 Description
api-version
query True

string

用戶端 API 版本。

要求本文

名稱 類型 Description
name

string

資源名稱。

type

string

資源類型。

回應

名稱 類型 Description
200 OK

TrafficManagerNameAvailability

流量管理員名稱可用性。

Other Status Codes

CloudError

默認回應。 它會根據錯誤定義還原串行化。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

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

範圍

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

範例

NameAvailabilityTest_NameAvailablePOST21
NameAvailabilityTest_NameNotAvailablePOST23

NameAvailabilityTest_NameAvailablePOST21

範例要求

POST https://management.azure.com/providers/Microsoft.Network/checkTrafficManagerNameAvailability?api-version=2022-04-01

{
  "name": "azsmnet5403",
  "type": "microsoft.network/trafficmanagerprofiles"
}

範例回覆

{
  "name": "azsmnet5403",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "nameAvailable": true
}

NameAvailabilityTest_NameNotAvailablePOST23

範例要求

POST https://management.azure.com/providers/Microsoft.Network/checkTrafficManagerNameAvailability?api-version=2022-04-01

{
  "name": "azsmnet4696",
  "type": "microsoft.network/trafficmanagerprofiles"
}

範例回覆

{
  "name": "azsmnet4696",
  "type": "Microsoft.Network/trafficManagerProfiles",
  "nameAvailable": false,
  "reason": "AlreadyExists",
  "message": "Domain name azsmnet4696.tmpreview.watmtest.azure-test.net already exists. Please choose a different DNS prefix."
}

定義

名稱 Description
CheckTrafficManagerRelativeDnsNameAvailabilityParameters

提供用來檢查流量管理員名稱作業的參數。

CloudError

Azure Resource Manager 傳回的錯誤

CloudErrorBody

Azure Resource Manager 傳回的錯誤內容

TrafficManagerNameAvailability

代表流量管理員名稱可用性響應的類別。

CheckTrafficManagerRelativeDnsNameAvailabilityParameters

提供用來檢查流量管理員名稱作業的參數。

名稱 類型 Description
name

string

資源名稱。

type

string

資源類型。

CloudError

Azure Resource Manager 傳回的錯誤

名稱 類型 Description
error

CloudErrorBody

錯誤的內容。

CloudErrorBody

Azure Resource Manager 傳回的錯誤內容

名稱 類型 Description
code

string

錯誤碼

details

CloudErrorBody[]

錯誤詳細資料

message

string

錯誤訊息

target

string

錯誤目標

TrafficManagerNameAvailability

代表流量管理員名稱可用性響應的類別。

名稱 類型 Description
message

string

描述性訊息,說明何時無法使用名稱。

name

string

相對名稱。

nameAvailable

boolean

描述相對名稱是否可用。

reason

string

當適用時,無法使用名稱的原因。

type

string

流量管理員配置檔資源類型。