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

Profiles - check Traffic Manager Name Availability V2

检查流量管理器相对 DNS 名称的可用性。

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/checkTrafficManagerNameAvailabilityV2?api-version=2022-04-01

URI 参数

名称 必需 类型 说明
subscriptionId
path True

string

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

api-version
query True

string

客户端 API 版本。

请求正文

名称 类型 说明
name

string

资源的名称。

type

string

资源类型。

响应

名称 类型 说明
200 OK

TrafficManagerNameAvailability

流量管理器名称可用性。

Other Status Codes

CloudError

默认响应。 它将根据错误定义进行反序列化。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

NameAvailabilityV2Test_NameAvailablePOST21
NameAvailabilityV2Test_NameNotAvailablePOST23

NameAvailabilityV2Test_NameAvailablePOST21

示例请求

POST https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Network/checkTrafficManagerNameAvailabilityV2?api-version=2022-04-01

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

示例响应

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

NameAvailabilityV2Test_NameNotAvailablePOST23

示例请求

POST https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Network/checkTrafficManagerNameAvailabilityV2?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."
}

定义

名称 说明
CheckTrafficManagerRelativeDnsNameAvailabilityParameters

提供给检查流量管理器名称操作的参数。

CloudError

Azure 资源管理器返回的错误

CloudErrorBody

Azure 资源管理器返回的错误的内容

TrafficManagerNameAvailability

表示流量管理器名称可用性响应的类。

CheckTrafficManagerRelativeDnsNameAvailabilityParameters

提供给检查流量管理器名称操作的参数。

名称 类型 说明
name

string

资源的名称。

type

string

资源类型。

CloudError

Azure 资源管理器返回的错误

名称 类型 说明
error

CloudErrorBody

错误的内容。

CloudErrorBody

Azure 资源管理器返回的错误的内容

名称 类型 说明
code

string

错误代码

details

CloudErrorBody[]

错误详细信息

message

string

错误消息

target

string

错误目标

TrafficManagerNameAvailability

表示流量管理器名称可用性响应的类。

名称 类型 说明
message

string

说明名称不可用(如果适用)的说明性消息。

name

string

相对名称。

nameAvailable

boolean

描述相对名称是否可用。

reason

string

名称不可用的原因(如果适用)。

type

string

流量管理器配置文件资源类型。