エクスポート (0) 印刷
すべて展開

Check Cloud Service Name Availability

更新日: 2015年2月

Check Hosted Service Name Availability 操作は、指定されたクラウド サービス名を使用できるかどうかを確認します。

Check Hosted Service Name Availability要求は、次のように指定できます。<subscription-id> をサブスクリプション ID で、<cloudservice-name> を使用するクラウド サービス名でそれぞれ置き換えます。

 

メソッド 要求 URI

GET

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

管理サービスに対して行われる要求をセキュリティで保護する必要があります。詳細については、「サービス管理要求の認証」を参照してください。

ありません。

要求ヘッダーの説明を次の表に示します。

 

要求ヘッダー 説明

x-ms-version

必須。この要求に使用する操作のバージョンを指定します。このヘッダーは、01.03.12 以上に設定する必要があります。バージョン管理ヘッダーの詳細については、「サービス管理のバージョン管理」を参照してください。

ありません。

応答には、HTTP 状態コード、一連の応答ヘッダー、および応答本文が含まれています。

操作が正常に終���すると、ステータス コード 200 (OK) が返されます。ステータス コードの詳細については、「サービス管理のステータス コードとエラー コード」を参照してください。

この操作の応答には、次のヘッダーが含まれています。応答に追加の標準 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

クラウド サービスの作成に名前を使用できない理由を示します。

次の値をとります。

  • HostedServiceAlreadyExists - クラウド サービス名が既に存在する場合に返されます。

  • HostedServiceNameNotValid - クラウド サービス名にサポートされていない文字、予約語、不適切な用語が使用されている場合に返されます。

Reason 要素は、バージョン 01.03.13 以上を使用している場合のみ使用できます。

表示:
© 2015 Microsoft