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=2026-04-01

URI パラメーター

Name / 必須 型 説明
resourceGroupName
path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前は大文字と小文字を区別しません。

subscriptionId
path True

string

minLength: 1

ターゲット サブスクリプションの ID。

vmScaleSetName
path True

string

VM スケール セットの名前。

api-version
query True

string

minLength: 1

この操作に使用する API バージョン。

要求本文

Name 型 説明
exactVersion

string

OS ディスクの再イメージ化の対象となるバージョンを 10 進数で指定します。 正確なバージョンが指定されていない場合、OS ディスクは既存のバージョンの OS ディスクに再イメージ化されます。

forceUpdateOSDiskForEphemeral

boolean

仮想マシン スケール セット VM のエフェメラル OS ディスクを強制的に更新するパラメーター

instanceIds

string[]

仮想マシン スケール セットのインスタンス ID。 仮想マシン スケール セットのインスタンス ID を省略すると、仮想マシン スケール セット内のすべての仮想マシンで操作が実行されます。

osProfile

OSProfileProvisioningData

非エフェメラルOSディスクの再イメージ化に必要な情報を指定します。

tempDisk

boolean

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

応答

Name 型 説明
200 OK

要求は成功しました。

202 Accepted

リソース操作が受け入れられます。

ヘッダー

  • Location: string
  • Retry-After: integer
Other Status Codes

CloudError

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

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

スコープ

Name 説明
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=2026-04-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=2026-04-01

応答のサンプル

location: https://foo.com/operationstatus

定義

Name 説明
ApiError

API エラー。

ApiErrorBase

API エラーベース。

CloudError

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

InnerError

内部エラーの詳細。

OSProfileProvisioningData

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

VirtualMachineScaleSetReimageParameters

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

ApiError

API エラー。

Name 型 説明
code

string

エラー コード。

details

ApiErrorBase[]

Api エラーの詳細

innererror

InnerError

Api 内部エラー

message

string

エラー メッセージ。

target

string

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

ApiErrorBase

API エラーベース。

Name 型 説明
code

string

エラー コード。

message

string

エラー メッセージ。

target

string

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

CloudError

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

Name 型 説明
error

ApiError

API エラー。

InnerError

内部エラーの詳細。

Name 型 説明
errordetail

string

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

exceptiontype

string

例外の種類。

OSProfileProvisioningData

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

Name 型 説明
adminPassword

string (password)

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

最小長 (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 の再イメージ化パラメーターについて説明します。

Name 型 説明
exactVersion

string

OS ディスクの再イメージ化の対象となるバージョンを 10 進数で指定します。 正確なバージョンが指定されていない場合、OS ディスクは既存のバージョンの OS ディスクに再イメージ化されます。

forceUpdateOSDiskForEphemeral

boolean

仮想マシン スケール セット VM のエフェメラル OS ディスクを強制的に更新するパラメーター

instanceIds

string[]

仮想マシン スケール セットのインスタンス ID。 仮想マシン スケール セットのインスタンス ID を省略すると、仮想マシン スケール セット内のすべての仮想マシンで操作が実行されます。

osProfile

OSProfileProvisioningData

非エフェメラルOSディスクの再イメージ化に必要な情報を指定します。

tempDisk

boolean

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