Walk Upgrade Domain
Walk Upgrade Domain 非同期操作は、ロール インスタンスの更新が必要な更新ドメインを指定します。
要求
Walk Upgrade Domain要求は、次のように指定できます。 <subscription-id> をサブスクリプション ID に、<cloudservice-name> をクラウド サービスの名前に、<deployment-slot> を staging または production に、<deployment-name> をデプロイの名前でそれぞれ置き換えます。
| Method | 要求 URI |
|---|---|
| POST | https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/?comp=walkupgradedomain |
| POST | https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/?comp=walkupgradedomain |
URI パラメーター
| URI パラメーター | 説明 |
|---|---|
comp=walkupgradedomain |
必須。 手動でのインプレース更新中に、デプロイのロール インスタンスが、更新ドメインごとに 1 つずつ更新されることを指定します。 |
要求ヘッダー
要求ヘッダーの説明を次の表に示します。
| 要求ヘッダー | 説明 |
|---|---|
Content-Type |
必須。 このヘッダーには、application/xml を設定します。 |
x-ms-version |
必須。 この要求に使用する操作のバージョンを指定します。 このヘッダーは 以上に設定する 2009-10-01 必要があります。 |
要求本文
要求本文の形式は次のとおりです。
<?xml version="1.0" encoding="utf-8"?>
<WalkUpgradeDomain xmlns="http://schemas.microsoft.com/windowsazure">
<UpgradeDomain>update-domain-id</UpgradeDomain>
</WalkUpgradeDomain>
要求本文の要素を次の表に示します。
| 要素名 | 説明 |
|---|---|
| UpgradeDomain | 必須。 更新対象の更新ドメインを識別する整数値を指定します。 更新ドメインは、ゼロから始まるインデックスで識別されます。最初の更新ドメインの ID は 0、2 番目の更新ドメインの ID は 1 のようになります。 |
[応答]
応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。
状態コード
操作に成功すると、状態コード 200 (OK) が返されます。
レスポンス ヘッダー
この操作の応答には、次のヘッダーが含まれています。 応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。
| 応答ヘッダー | Description |
|---|---|
x-ms-request-id |
管理サービスに対して行われた要求を一意に識別する値。 非同期操作の場合は、ヘッダーの値を指定して Get Operation Status を 呼び出して、操作が完了したか、失敗したか、またはまだ進行中であるかを判断できます。 |
応答本文
[なし] :
解説
操作を呼び出す前に、アップグレードの展開、展開構成の変更、または更新またはアップグレードのロールバックを呼び出Walk Upgrade Domainしておく必要があります。
既定では、デプロイされるサービスあたりの更新ドメインの数は 5 つです。インプレース更新中はこれらのドメインが一度に 1 つずつ更新されます。
デプロイの手動更新を実行するには、次の手順を記載された順序で実行します。
要素を に設定して
Mode、Upgrade Deployment をmanual呼び出します。Walk Upgrade Domainを呼び出して、デプロイ内の各ドメインを更新します。 更新ドメインは順番に更新する必要があります。 たとえば、ドメイン 0 から開始してドメイン 1 に進む必要があります。
ロール インスタンスを追加または削除する更新では、クラウド サービスでデプロイされるすべてのロールの構成が更新されます。 既存のロール インスタンスでは、すべてのロール インスタンスがクラウド サービスで通信できるように、新しいロール インスタンスについての通知を受ける必要があります。
更新プログラムの進行中に、展開の 取得 を呼び出してその状態を確認します。 更新が進行中の場合、Get Deployment は、その更新に関する情報を含む UpgradeStatus 要素を返します。 更新が完了している場合、または更新が進行中でない場合は、UpgradeStatus 要素は null になります。