銷售: 1-800-867-1380

檢查雲端服務名稱可用性

更新日期: 2014年4月

Check Hosted Service Name Availability 作業會檢查指定的雲端服務名稱的可用性。

請使用下列格式指定 Check Hosted Service Name Availability 要求。請以您的訂用帳戶 ID 取代 <subscription-id>,並以您想要使用的雲端服務名稱取代 <cloudservice-name>

 

方法 要求 URI HTTP 版本

GET

https://management.core.windows.net/<subscription-id>/services/hostedservices/operations/isavailable/<cloudservice-name>

HTTP/1.1

無。

下表描述要求標頭。

 

要求標頭 說明

x-ms-version

必要項。指定用於這個要求的作業版本。此標頭應該設定為 2012-03-01 或更新版本。如需有關版本設定標頭的詳細資訊,請參閱<服務管理版本設定>。

無。

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

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

這項作業的回應包括下列標頭。回應也可能包括其他標準 HTTP 標頭。所有標準標頭都符合 HTTP/1.1 通訊協定規格

 

回應標頭 說明

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

Reason

描述無法使用該名稱建立雲端服務的原因。

必須使用 2013-03-01 版或更高版本,才能使用 Reason 元素。

<subscription-id> 指定之訂用帳戶相關聯的任何管理憑證都可用來驗證此作業。如需其他詳細資訊,請參閱<驗證服務管理要求>。

無。

本文對您有任何幫助嗎?
(剩餘 1500 個字元)
感謝您提供意見
顯示:
© 2014 Microsoft