檢查雲端服務名稱可用性

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 (OK)。

回應標頭

這項作業的回應包括下列標頭。 回應也可能包括其他標準 HTTP 標頭。

回應標頭	Description
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 版或更新版本。