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

检查云服务名称可用性

项目
08/05/2023

Check Hosted Service Name Availability 操作检查指定的云服务名称的可用性。

请求

可以按以下方式指定 Check Hosted Service Name Availability 请求。使用你的订阅 ID 替代 <subscription-id>，使用你要使用的云服务名称替代 <cloudservice-name>。

方法	请求 URI
GET	`https://management.core.windows.net/<subscription-id>/services/hostedservices/operations/isavailable/<cloudservice-name>`

URI 参数

无。

请求标头

下表介绍请求标头。

请求标头	说明
`x-ms-version`	必需。指定用于此请求的操作的版本。此标头应设置为 `2012-03-01` 或更高。

请求正文

无。

响应

响应包括 HTTP 状态代码、一组响应标头和响应正文。

状态代码

此操作成功后返回状态代码 200（正常）。

响应标头

此操作的响应包括以下标头。该响应还可能包括其他标准 HTTP 标头。

响应标头	说明
`x-ms-request-id`	一个值，它唯一地标识对管理服务做出的请求。

响应正文

响应正文的格式如下所示：

  
<?xml version="1.0" encoding="utf-8"?>  
<AvailabilityResponse xmlns=”http://schemas.microsoft.com/windowsazure”>  
  <Result>name-availability</Result>  
  <Reason>reason</Reason>  
</AvailabilityResponse>

下表介绍响应正文中的元素。

元素名称	说明
结果	一个布尔值，指示名称是否可供你使用。 `true` 如果名称可用，则为 ;否则为 `false`。对于 2013-03-01 之前的版本，该操作对于未采用的名称返回 `true`，即使在这些名称是保留名称或者是不敬的名称时也是如此。对于 2013-03-01 和更高版本的版本标头，该操作对于保留字或不敬词返回 `false`。
原因	说明名称为什么不能用于创建云服务。可能的值包括： - `HostedServiceAlreadyExists` – 如果云服务名称已存在，则返回。 - `HostedServiceNameNotValid` – 如果云服务名称使用不受支持的字符、保留字或亵渎字词，则返回。元素 `Reason` 仅在版本 2013-03-01 或更高版本中可用。

通过