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 パラメーター

名前 / 必須 説明
resourceGroupName
path True

string

リソース グループの名前。

subscriptionId
path True

string

Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、すべてのサービス呼び出しの URI の一部を形成します。

vmScaleSetName
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

OSProfileProvisioningData

一時的でない OS ディスクを再イメージ化するために必要な情報を指定します。

tempDisk

boolean

一時ディスクを再イメージ化するかどうかを指定します。 既定値: false。 注: この一時ディスク再イメージ化パラメーターは、エフェメラル OS ディスクを使用する VM/VMSS でのみサポートされます。

応答

名前 説明
200 OK

わかりました

202 Accepted

受け入れ られる

Other Status Codes

CloudError

操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

VirtualMachineScaleSet_Reimage_MaximumSet_Gen
VirtualMachineScaleSet_Reimage_MinimumSet_Gen

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

要求のサンプル

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-03-01

応答のサンプル

location: https://foo.com/operationstatus

定義

名前 説明
ApiError

API エラー。

ApiErrorBase

API エラーベース。

CloudError

コンピューティング サービスからのエラー応答。

InnerError

内部エラーの詳細。

OSProfileProvisioningData

非エフェメラル仮想マシンを再イメージ化するための追加パラメーター。

VirtualMachineScaleSetReimageParameters

仮想マシン スケール セット VM の再イメージ化パラメーターについて説明します。

ApiError

API エラー。

名前 説明
code

string

エラー コード。

details

ApiErrorBase[]

Api エラーの詳細

innererror

InnerError

Api 内部エラー

message

string

エラー メッセージ。

target

string

特定のエラーのターゲット。

ApiErrorBase

API エラーベース。

名前 説明
code

string

エラー コード。

message

string

エラー メッセージ。

target

string

特定のエラーのターゲット。

CloudError

コンピューティング サービスからのエラー応答。

名前 説明
error

ApiError

API エラー。

InnerError

内部エラーの詳細。

名前 説明
errordetail

string

内部エラー メッセージまたは例外ダンプ。

exceptiontype

string

例外の種類。

OSProfileProvisioningData

非エフェメラル仮想マシンを再イメージ化するための追加パラメーター。

名前 説明
adminPassword

string

管理者アカウントのパスワードを指定します。

最小長 (Windows): 8 文字

最小長 (Linux): 6 文字

最大長 (Windows): 123 文字

最大長 (Linux): 72 文字

複雑さの要件: 以下の 4 つの条件のうち 3 つ を満たす必要があります
文字が小さい
上の文字を含む
数字を含む
特殊文字を持つ (Regex match [\W_])

許可されていない値: "abc@123"、"P@$$w 0rd"、"P@ssw0rd"、"P@ssword123"、"Pa$$word"、"pass@word1"、"Password!"、"Password1"、"Password22"、"iloveyou!"

パスワードのリセットについては、「Windows VM でリモート デスクトップ サービスまたはそのログイン パスワードをリセットする方法」を参照してください。

ルート パスワードのリセットについては、「VMAccess 拡張機能 を使用した Azure Linux VM でのユーザー、SSH の管理、ディスクの確認または修復を行う方法に関するページを参照してください。

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

OSProfileProvisioningData

一時的でない OS ディスクを再イメージ化するために必要な情報を指定します。

tempDisk

boolean

一時ディスクを再イメージ化するかどうかを指定します。 既定値: false。 注: この一時ディスク再イメージ化パラメーターは、エフェメラル OS ディスクを使用する VM/VMSS でのみサポートされます。