檢查儲存體帳戶名稱可用性

 

檢查儲存體帳戶名稱可用性 作業會檢查指定的儲存體帳戶名稱是否可用，或如果已經存在。

要求

檢查儲存體帳戶名稱可用性 要求可能會指定，如下所示。 取代 <subscription-id> 取代為訂閱 ID 和 <storage-account-name> 想要使用儲存體帳戶的名稱。

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

您必須確定對管理服務的要求是安全。 如需詳細資訊，請參閱 驗證服務管理要求。

URI 參數

無。

要求標頭

下表描述要求標頭。

要求標頭	描述
x-ms-version	必要的。 指定要用於此要求之作業的版本。 此標頭應該設定為 2012-03-01 或更高版本。 如需版本設定標頭的詳細資訊，請參閱 服務管理版本設定。

要求本文

無。

回應

回應包括 HTTP 狀態碼、 一組回應標頭和回應主體。

狀態碼

成功的作業會傳回狀態碼 200 (確定)。 如需狀態碼的詳細資訊，請參閱 服務管理狀態和錯誤碼。

回應標頭

這項作業的回應包括下列標頭。 回應也可能包括其他標準 HTTP 標頭。 所有標準標頭都符合 HTTP/1.1 通訊協定規格https://go.microsoft.com/fwlink/?linkid=150478。

回應標頭	描述
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 版或更高版本。