クラウド サービスの作成

  • [アーティクル]

Create Cloud Service 非同期操作は、Microsoft Azure で新しいクラウド サービスを作成します。

要求

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

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

URI パラメーター

なし。

要求ヘッダー

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

要求ヘッダー 説明
Content-Type 必須。 このヘッダーには、application/xml を設定します。
x-ms-version 必須。 この要求に使用する操作のバージョンを指定します。 このヘッダーの値は 以上に設定する 2010-10-28 必要があります。

要求本文

要求本文の形式は次のとおりです。

<?xml version="1.0" encoding="utf-8"?>  
<CreateHostedService xmlns="http://schemas.microsoft.com/windowsazure">  
  <ServiceName>name-of-cloud-service</ServiceName>  
  <Label>base64-encoded-label-of-cloud-service</Label>  
  <Description>description-of-cloud-service</Description>  
  <Location>location-of-cloud-service</Location>  
  <AffinityGroup>name-of-affinity-group</AffinityGroup>  
  <ExtendedProperties>  
    <ExtendedProperty>  
      <Name>name-of-property</Name>  
      <Value>value-of-property</Value>  
    </ExtendedProperty>  
  </ExtendedProperties>  
  <ReverseDnsFqdn>reverse-dns-fqdn</ReverseDnsFqdn>  
</CreateHostedService>

要求本文の要素を次の表に示します。

要素名 説明
ServiceName 必須。 クラウド サービスの名前を指定します。 この名前は、Azure 内で一意である必要があります。 この名前は DNS プレフィックス名であり、サービスにアクセスするために使用されます。 名前の可用性を確認するには、[ クラウド サービス名の可用性の確認] を使用できます。
Label 必須。 クラウド サービスの Base 64 エンコード形式の識別子を指定します。 識別子は半角 100 文字まで設定できます。 ラベルは追跡の目的で使用できます。
説明 省略可能。 クラウド サービスの説明を指定します。 説明は 1024 文字まで指定できます。
場所 AffinityGroup が指定されていない場合は必須です。 クラウド サービスが作成される場所を指定します。

Location または AffinityGroup を指定します。両方を指定しないでください。 使用可能な場所を表示するには、リストの 場所を使用できます。
AffinityGroup Location が指定されていない場合は必須です。 サブスクリプションに関連付けられている既存のアフィニティ グループの名前を指定します。 Location または AffinityGroup を指定します。両方を指定しないでください。 使用可能なアフィニティ グループを表示するには、 アフィニティ グループの一覧表示を使用できます。
名前 省略可能。 クラウド サービスの拡張プロパティの名前を指定します。 この名前は最大 64 文字まで指定できます。名前には英数字とアンダースコアのみが有効であり、名前の先頭にはアルファベットを使用する必要があります。 各拡張プロパティには、定義済みの名前と値の両方が必要です。 最大 50 個の拡張プロパティを定義できます。

Name 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
値 省略可能。 クラウド サービスの拡張プロパティの値を指定します。 拡張プロパティの値には最大 255 文字まで使用できます。

Value 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
ReverseDnsFqdn 省略可能。 逆引き DNS クエリを使用してクエリが実行された場合に、クラウド サービスの IP アドレスの解決先となる DNS アドレスを指定します。

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

[応答]

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

状態コード

操作が正常に終了すると、状態コード 201 (Created) が返されます。

レスポンス ヘッダー

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

応答ヘッダー 説明
x-ms-request-id 管理サービスに対して行われた要求を一意に識別する値。 非同期操作の場合は、ヘッダーの値を指定して Get Operation Status を呼び出して、操作が完了したか、失敗したか、進行中であるかを判断できます。

応答本文

なし。