检查存储帐户名称是否可用
检查存储帐户名称可用性 操作检查指定的存储帐户名称是否可用,或者是否已采用。
请求
检查存储帐户名称可用性 可能指定请求,如下所示。 替换 <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 或更高版本。 |