Update Cloud Service

Update Cloud Service 操作は、クラウドサービスのラベルまたは説明を更新します。

要求

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

Method	要求 URI
PUT	`https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>`

URI パラメーター

なし。

要求ヘッダー

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

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

要求本文

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

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

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

要素名	説明
Label	Description が指定されている場合は省略可能。クラウドサービスの Base 64 エンコード形式の識別子を指定します。識別子は半角 100 文字まで設定できます。サブスクリプション内で一意のラベルを使用することをお勧めします。ラベルは追跡の目的で使用できます。
Description	Label が指定されている場合は省略可能。クラウドサービスの説明を指定します。説明は 1024 文字まで指定できます。
名前	省略可能。クラウドサービスの拡張プロパティの名前を指定します。各プロパティの名前と値を指定する必要があります。最大 50 個の拡張プロパティを使用できます。名前には最大 64 文字まで使用できます。名前では英数字とアンダースコアのみが有効で、先頭には文字を使用する必要があります `Name` 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
値	省略可能。クラウドサービスの拡張プロパティの値を指定します。各拡張プロパティには、定義済みの名前と値の両方が必要です。値は半角 255 文字まで設定できます。既存のプロパティを削除するには、値を NULL に設定します。 `Value` 要素は、バージョン 01.03.12 以上を使用している場合のみ使用できます。
ReverseDnsFqdn	省略可能。逆引き DNS クエリを使用してクエリが実行された場合に、クラウドサービスの IP アドレスの解決先となる DNS アドレスを指定します。 `ReverseDnsFqdn` 要素は、バージョン 01.06.14 以上を使用している場合のみ使用できます。

[応答]

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

状態コード

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

レスポンスヘッダー

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

応答ヘッダー	Description
`x-ms-request-id`	管理サービスに対して行われた要求を一意に識別する値。

応答本文

なし。

最終更新: 2023-07-19