Reimage Role Instance 非同期操作では、Web ロールまたはワーカー ロールのインスタンスにオペレーティング システムを再インストールします。
要求
Reimage Role Instance要求は、次のように指定できます。
<subscription-id> をサブスクリプション ID に、<cloudservice-name> をクラウド サービスの名前に、<deployment-slot> を staging または production に、<deployment-name> をデプロイの名前にそれぞれ置き換えます。
<role-instance-name> をロール インスタンスの名前に置き換えます。
| Method | 要求 URI |
|---|---|
| POST | https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/roleinstances/<role-instance-name> |
| POST | https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/roleinstances/<role-instance-name> |
URI パラメーター
| URI パラメーター | 説明 |
|---|---|
comp=reimage |
必須。 ロール インスタンスのイメージを再適用する必要があることを指定します。 |
要求ヘッダー
要求ヘッダーの説明を次の表に示します。
| 要求ヘッダー | 説明 |
|---|---|
Content-Type |
必須。 このヘッダーには、application/xml を設定します。 |
x-ms-version |
必須。 この要求に使用する操作のバージョンを指定します。 このヘッダーの値は 以上に設定する 2010-10-28 必要があります。 |
ContentLength |
必須。 0 に設定する必要があります。 |
要求本文
なし。
[応答]
応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。
状態コード
操作に成功すると、状態コード 200 (OK) が返されます。
レスポンス ヘッダー
この操作の応答には、次のヘッダーが含まれています。 応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。
| 応答ヘッダー | 説明 |
|---|---|
x-ms-request-id |
管理サービスに対して行われた要求を一意に識別する値。 非同期操作の場合は、ヘッダーの値を指定して Get Operation Status を呼び出して、操作が完了したか、失敗したか、進行中であるかを判断できます。 |
応答本文
[なし] :
解説
ロール インスタンスが再イメージ化されている場合、インスタンスはオフラインになり、新しいゲスト オペレーティング システムのイメージが適用されます。 その後、ロール インスタンスはオンラインに戻ります。 ロールを再適用する際にすべてのローカル ストレージ リソース内のデータの維持が試みられます。ただし、遷移ハードウェア エラーが発生した場合、ローカル ストレージ リソースが失われる可能性があります。 アプリケーションでこのデータを維持する必要がある場合は、Azure ドライブなどの持続性があるデータ ソースに書き込むことをお勧めします。 ローカル ストレージ リソースによって定義されたローカル ディレクトリ以外のディレクトリに書き込まれたデータは、ロールのイメージが再適用されるときに失われます。