Virtual Machine Scale Sets - Reimage
一時的な OS ディスクを持つ仮想マシンの場合、仮想マシンが初期状態にリセットされる場合は、一時的な OS ディスクがない VM スケール セット内の 1 つ以上の仮想マシンを再イメージ化 (オペレーティング システムのアップグレード) します。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/reimage?api-version=2024-03-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
resource
|
path | True |
string |
リソース グループの名前。 |
subscription
|
path | True |
string |
Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、すべてのサービス呼び出しの URI の一部を形成します。 |
vm
|
path | True |
string |
VM スケール セットの名前。 |
api-version
|
query | True |
string |
クライアント API のバージョン。 |
要求本文
名前 | 型 | 説明 |
---|---|---|
exactVersion |
string |
OS ディスクの再イメージ化の対象となるバージョンを 10 進数で指定します。 正確なバージョンが指定されていない場合、OS ディスクは既存のバージョンの OS ディスクに再イメージ化されます。 |
forceUpdateOSDiskForEphemeral |
boolean |
仮想マシン スケール セット VM の一時的な OS ディスクを強制的に更新するためのパラメーター |
instanceIds |
string[] |
仮想マシン スケール セットのインスタンス ID。 仮想マシン スケール セットのインスタンス ID を省略すると、仮想マシン スケール セット内のすべての仮想マシンで操作が実行されます。 |
osProfile |
一時的でない OS ディスクを再イメージ化するために必要な情報を指定します。 |
|
tempDisk |
boolean |
一時ディスクを再イメージ化するかどうかを指定します。 既定値: false。 注: この一時ディスク再イメージ化パラメーターは、エフェメラル OS ディスクを使用する VM/VMSS でのみサポートされます。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
わかりました |
|
202 Accepted |
受け入れ られる |
|
Other Status Codes |
操作が失敗した理由を説明するエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントを偽装する |
例
Virtual |
Virtual |
VirtualMachineScaleSet_Reimage_MaximumSet_Gen
要求のサンプル
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-03-01
{
"instanceIds": [
"aaaaaaaaaa"
],
"forceUpdateOSDiskForEphemeral": true,
"tempDisk": true
}
応答のサンプル
location: https://foo.com/operationstatus
VirtualMachineScaleSet_Reimage_MinimumSet_Gen
要求のサンプル
応答のサンプル
location: https://foo.com/operationstatus
定義
名前 | 説明 |
---|---|
Api |
API エラー。 |
Api |
API エラーベース。 |
Cloud |
コンピューティング サービスからのエラー応答。 |
Inner |
内部エラーの詳細。 |
OSProfile |
非エフェメラル仮想マシンを再イメージ化するための追加パラメーター。 |
Virtual |
仮想マシン スケール セット VM の再イメージ化パラメーターについて説明します。 |
ApiError
API エラー。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラー コード。 |
details |
Api エラーの詳細 |
|
innererror |
Api 内部エラー |
|
message |
string |
エラー メッセージ。 |
target |
string |
特定のエラーのターゲット。 |
ApiErrorBase
API エラーベース。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラー コード。 |
message |
string |
エラー メッセージ。 |
target |
string |
特定のエラーのターゲット。 |
CloudError
コンピューティング サービスからのエラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
API エラー。 |
InnerError
内部エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
errordetail |
string |
内部エラー メッセージまたは例外ダンプ。 |
exceptiontype |
string |
例外の種類。 |
OSProfileProvisioningData
非エフェメラル仮想マシンを再イメージ化するための追加パラメーター。
名前 | 型 | 説明 |
---|---|---|
adminPassword |
string |
管理者アカウントのパスワードを指定します。 |
customData |
string |
カスタム データの base-64 でエンコードされた文字列を指定します。 base-64 でエンコードされた文字列は、仮想マシン上のファイルとして保存されるバイナリ配列にデコードされます。 バイナリ配列の最大長は 65535 バイトです。 注: customData プロパティにシークレットやパスワードを渡さないでください。 このプロパティは、VM の作成後に更新できません。 プロパティ customData は、ファイルとして保存される VM に渡されます。詳細については、Azure VM 上のカスタム データ を参照してください。 Linux VM に cloud-init を使用する場合は、「cloud-init を使用して、の作成時に Linux VM をカスタマイズする」を参照してください。 |
VirtualMachineScaleSetReimageParameters
仮想マシン スケール セット VM の再イメージ化パラメーターについて説明します。
名前 | 型 | 説明 |
---|---|---|
exactVersion |
string |
OS ディスクの再イメージ化の対象となるバージョンを 10 進数で指定します。 正確なバージョンが指定されていない場合、OS ディスクは既存のバージョンの OS ディスクに再イメージ化されます。 |
forceUpdateOSDiskForEphemeral |
boolean |
仮想マシン スケール セット VM の一時的な OS ディスクを強制的に更新するためのパラメーター |
instanceIds |
string[] |
仮想マシン スケール セットのインスタンス ID。 仮想マシン スケール セットのインスタンス ID を省略すると、仮想マシン スケール セット内のすべての仮想マシンで操作が実行されます。 |
osProfile |
一時的でない OS ディスクを再イメージ化するために必要な情報を指定します。 |
|
tempDisk |
boolean |
一時ディスクを再イメージ化するかどうかを指定します。 既定値: false。 注: この一時ディスク再イメージ化パラメーターは、エフェメラル OS ディスクを使用する VM/VMSS でのみサポートされます。 |