Rebuild Role Instance 非同期操作では、Web ロールまたはワーカー ロールのインスタンスにオペレーティング システムを再インストールし、それらのロールによって使用されるストレージ リソースを初期化します。 ストレージ リソースを初期化しない場合は、 ロール インスタンスの再イメージ化を使用できます。
要求
Rebuild 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=rebuild |
必須。 ロール インスタンスおよびそのインスタンス用のリソースを再構築する必要があることを指定します。 |
resources=<resources> |
必須。 再構築する必要があるリソースを指定します。 現在サポートされている値は allLocalDrives のみです。 |
要求ヘッダー
要求ヘッダーの説明を次の表に示します。
| 要求ヘッダー | 説明 |
|---|---|
Content-Type |
必須。 このヘッダーには、application/xml を設定します。 |
x-ms-version |
必須。 この要求に使用する操作のバージョンを指定します。 このヘッダーの値は 以上に設定する 2013-06-01 必要があります。 |
ContentLength |
必須。 0 に設定する必要があります。 |
要求本文
なし。
[応答]
応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。
状態コード
操作に成功すると、状態コード 200 (OK) が返されます。
レスポンス ヘッダー
この操作の応答には、次のヘッダーが含まれています。 応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。
| 応答ヘッダー | 説明 |
|---|---|
x-ms-request-id |
管理サービスに対して行われた要求を一意に識別する値。 非同期操作の場合は、ヘッダーの値を指定して Get Operation Status を 呼び出して、操作が完了したか、失敗したか、またはまだ進行中であるかを判断できます。 |
応答本文
[なし] :
解説
ロール インスタンスが再構築されるとき、インスタンスはオフラインになり、新しいゲスト オペレーティング システムのイメージが適用されて、インスタンスに接続されているデータ ドライブが初期化されます。 その後、ロール インスタンスはオンラインに戻ります。