List Cloud Services

List Cloud Services 操作は、指定されたサブスクリプションで使用可能なクラウド サービスを一覧表示します。

要求

List Cloud Services要求は、次のように指定できます。 <subscription-id> は、サブスクリプション ID で置き換えてください。

Method	要求 URI
GET	https://management.core.windows.net/<subscription-id>/services/hostedservices

URI パラメーター

なし。

要求ヘッダー

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

要求ヘッダー	説明
x-ms-version	必須。 この要求に使用する操作のバージョンを指定します。 このヘッダーは 以上に設定する 2009-10-01 必要があります。
x-ms-continuation-token	省略可能。 継続トークンを指定します。継続トークンにより、割り当てられた時間で返すことができる以上のクラウド サービスが存在するとき、応答の残りが提供されます。 このトークンの値は、前の応答のヘッダー内に返されます。このトークンの値が返されるのは、追加のクラウド サービスを一覧表示する必要がある場合のみです。

要求本文

なし。

[応答]

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

状態コード

操作に成功すると、状態コード 200 (OK) が返されます。

レスポンス ヘッダー

この操作の応答には、次のヘッダーが含まれています。 応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。

応答ヘッダー	Description
x-ms-request-id	管理サービスに対して行われた要求を一意に識別する値を指定します。
x-ms-continuation-token	継続トークンを指定します。継続トークンにより、割り当てられた時間で返すことができる以上のクラウド サービスが存在するとき、応答の残りが提供されます。 サブスクリプションに多数のクラウド サービスが存在する場合、1 回の応答でそのすべてを一覧表示できるとは限りません。 すべてのクラウド サービスが返されるまで、サブスクリプション操作要求でこのヘッダー内にトークンを使用できます。

応答本文

応答本文の形式は次のとおりです。

  
<?xml version="1.0" encoding="utf-8"?>  
  <HostedServices xmlns=”http://schemas.microsoft.com/windowsazure”>  
    <HostedService>  
      <Url>address-of-cloud-service</Url>  
      <ServiceName>name-of-cloud-service</ServiceName>  
      <HostedServiceProperties>  
        <Description>description-of-cloud-service</Description>  
        <AffinityGroup>name-of-affinity-group</AffinityGroup>  
        <Location>location-of-cloud-service</Location>  
        <Label>label-of-cloud-service</Label>  
        <Status>status-of-cloud-service</Status>  
        <DateCreated>date-created</DateCreated>  
        <DateLastModified>date-modified</DateLastModified>  
        <ExtendedProperties>  
          <ExtendedProperty>  
            <Name>name-of-property-name</Name>  
            <Value>value-of-property</Value>  
          </ExtendedProperty>  
        </ExtendedProperties>  
        <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
      </HostedServiceProperties>  
      <DefaultWinRMCertificateThumbprint>certificate-thumbprint-for-winrm</DefaultWinRMCertificateThumbprint>  
      <ComputeCapabilities>  
        <VirtualMachineRoleSizes>  
          <RoleSize>role-size-name</RoleSize>  
        </VirtualMachineRoleSizes>  
        <WebWorkerRoleSizes>  
          <RoleSize>role-size-name</RoleSize>  
        </WebWorkerRoleSizes>  
      </ComputeCapabilities>  
    </HostedService>  
  </HostedServices>  
  

応答本文の要素は次のとおりです。

要素名	説明
url	クラウド サービスに関する情報の取得に使用する要求 URI を指定します。
ServiceName	クラウド サービスの名前を指定します。 この名前は DNS プレフィックス名であり、サービスにアクセスするために使用できます。 たとえば、サービス名が MyService の場合、http://MyService.cloudapp.net の呼び出しを使用してサービスにアクセスできます。
Description	クラウド サービスの説明を指定します。 Description 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
AffinityGroup	クラウド サービスが関連付けられているアフィニティ グループを指定します (グループがある場合)。 サービスにアフィニティ グループが関連付けられている場合、Location 要素は返されません。 AffinityGroup 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
場所	Azure でクラウド サービスがアフィニティ グループが関連付けられていない場合に、そのサービスの地理的な場所を指定します。 場所が指定されている場合、AffinityGroup 要素は返されません。 Location 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
Label	クラウド サービスの Base 64 エンコード形式の識別子を指定します。 この識別子は追跡の目的で使用できます。 Label 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
Status	クラウド サービスのステータスを指定します。 次のいずれかの値になります。 - Creating - Created - Deleting - Deleted - Changing - ResolvingDns Status 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
DateCreated	クラウド サービスの作成日を、[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z の形式で指定します。 たとえば、DateCreated 要素または DateLastModified 要素から、2011-05-11T16:15:26Z という日付が返されます。 DateCreated 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
DateLastModified	クラウド サービスの最終更新日を、[4DigitYear]-[2DigitMonth]-[2DigitDay]T[2DigitHour]:[2DigitMinute]:[2DigitSecond]Z の形式で指定します。 たとえば、DateCreated 要素または DateLastModified 要素から、2011-05-11T16:15:26Z という日付が返されます。 DateLastModified 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
名前	クラウド サービスの拡張プロパティの名前を指定します。 各拡張プロパティには、定義済みの名前と値の両方が必要です。 最大 50 個の拡張プロパティを定義できます。 Name 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
値	クラウド サービスの拡張プロパティの値を表します。 拡張プロパティの値には最大 255 文字まで使用できます。 Value 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
ReverseDnsFqdn	省略可能。 逆引き DNS クエリを使用してクエリが実行された場合に、クラウド サービスの IP アドレスの解決先となる DNS アドレスを指定します。 ReverseDnsFqdn 要素は、バージョン 01.06.14 以上を使用している場合のみ使用できます。
DefaultWinRMCertificateThumbprint	WinRM によるセキュリティで保護された接続のための既定の証明書を指定します。 仮想マシンをクラウド サービスにデプロイするとき、WinRM 向けに証明書のサムプリントが指定されない場合、証明書が自動的に作成され、サムプリントがこの要素の値として一覧表示されます。 WinRM の定義の詳細については、「 仮想マシンのデプロイの作成 」または 「ロールの追加」を参照してください。
ComputeCapabilities	クラウド サービスでの展開に使用できるロール サイズ指定します。 使用できるロール サイズは、クラウド サービスによってサポートされているリソースによって定義されます。 たとえば、Web ロールとワーカー ロールの展開では、使用できるサイズが仮想マシンの展開とは異なる場合があります。 ComputeCapabilities 要素は、バージョン 01.05.14 以上を使用している場合のみ使用できます。

ComputeCapabilities

クラウド サービスでの展開に使用できるロール サイズ指定します。

要素名	説明
VirtualMachineRoleSizes	RoleSize 要素のコレクションが含まれます。
WebWorkerRoleSizes	RoleSize 要素のコレクションが含まれます。
RoleSize	その種類の展開で使用できるロール サイズ指定します。

注釈

x-ms-version が 2012-03-01 より前のバージョンの場合、仮想マシンのデプロイを含むクラウド サービスは返されません。

管理ポータルのクラウド サービスのセクションを調べると、サブスクリプションに含まれるクラウド サービスを確認できます。 Get-AzureService コマンドレットを使用して、クラウド サービスの一覧を取得することもできます。