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

Media Service - Check Name Availability

检查媒体服务资源名称是否可用。 该名称必须全局唯一。

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Media/CheckNameAvailability?api-version=2015-10-01

URI 参数

名称 必需 类型 说明
subscriptionId
path True

string

Microsoft Azure 订阅的唯一标识符。

api-version
query True

string

要与客户端请求一起使用的 API 的版本。 当前版本为 2015-10-01。

请求正文

名称 必需 类型 说明
name True

string

资源的名称。 名称必须全局唯一。

type True

ResourceType

资源的类型 - 媒体服务。

响应

名称 类型 说明
200 OK

CheckNameAvailabilityOutput

成功。 返回有关媒体服务资源名称是否可用的详细信息。

Other Status Codes

ApiError

媒体服务的 CheckNameAvailability 失败。

安全性

azure_auth

Azure Active Directory OAuth2 流

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

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

MediaServiceCheckNameAvailability

示例请求

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Media/CheckNameAvailability?api-version=2015-10-01

{
  "name": "contosomedia",
  "type": "mediaservices"
}

示例响应

{
  "nameAvailable": true,
  "reason": "None",
  "message": ""
}

定义

名称 说明
ApiError

失败的媒体服务 REST API 调用返回的错误。

CheckNameAvailabilityInput

CheckNameAvailability API 的请求正文。

CheckNameAvailabilityOutput

CheckNameAvailability API 的响应正文。

EntityNameUnavailabilityReason

指定名称不可用时的原因。

ResourceType

MediaService 资源的类型。

ApiError

失败的媒体服务 REST API 调用返回的错误。

名称 类型 说明
code

string

错误代码。

message

string

错误消息。

CheckNameAvailabilityInput

CheckNameAvailability API 的请求正文。

名称 类型 说明
name

string

资源的名称。 名称必须全局唯一。

type

ResourceType

资源的类型 - 媒体服务。

CheckNameAvailabilityOutput

CheckNameAvailability API 的响应正文。

名称 类型 说明
message

string

指定名称不可用时的详细原因。

nameAvailable

boolean

指定名称是否可用。

reason

EntityNameUnavailabilityReason

指定名称不可用时的原因。

EntityNameUnavailabilityReason

指定名称不可用时的原因。

名称 类型 说明
AlreadyExists

string

Invalid

string

None

string

ResourceType

MediaService 资源的类型。

名称 类型 说明
mediaservices

string