检查存储帐户名称是否可用

 

检查存储帐户名称可用性 操作检查指定的存储帐户名称是否可用,或者是否已采用。

请求

检查存储帐户名称可用性 可能指定请求,如下所示。 替换 <subscription-id> 替换为订阅 ID 和 <storage-account-name> 要使用的存储帐户具有该名称。

方法 请求 URI
获取 https://management.core.windows.net/<subscription-id>/services/storageservices/operations/isavailable/<storage-account-name>

必须确保向管理服务发出请求的安全性。 有关其他详细信息,请参阅 进行身份验证服务管理请求

URI 参数

None。

请求标头

下表介绍请求标头。

请求标头 说明
x-ms-version 必需。 指定要用于此请求的操作的版本。 此标头应设置为 2012-03-01 或更高版本。 有关版本控制标头的详细信息,请参阅 服务管理版本控制

请求正文

None。

响应

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

状态代码

此操作成功后返回状态代码 200 (正常)。 有关状态代码的信息,请参阅 服务管理状态和错误代码

响应标头

此操作的响应包括以下标头。 响应还可能包括其他标准 HTTP 标头。 所有标准标头都符合 HTTP/1.1 协议规范

响应标头 说明
x-ms-request-id 一个值,唯一标识针对管理服务发出的请求。

响应正文

响应正文的格式为,如下所示:

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

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

元素名称 说明
结果 指定一个布尔值,该值指示名称是否可供你使用。 如果 true, 的名称是否可用。 如果 false, ,该名称已被使用,不能使用。
原因 指定无法使用存储帐户名称的原因。 值将为 true 如果可以使用该名称。

 原因 元素才返回使用版本 2013年-03-01 或更高版本。