Virtual Machine Scale Sets - Reimage

サービス:: Compute

API バージョン:: 2025-11-01

一時的な OS ディスクを持つ仮想マシンの場合、仮想マシンが初期状態にリセットされる場合は、一時的な OS ディスクがない VM スケールセット内の 1 つ以上の仮想マシンを再イメージ化 (オペレーティングシステムのアップグレード) します。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/reimage?api-version=2025-11-01

URI パラメーター

名前	/	必須	型	説明
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 バージョン。

要求本文

名前	型	説明
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		リソース操作が受け入れられます。ヘッダー Location: string Retry-After: integer
Other Status Codes	CloudError	予期しないエラー応答。

名前

型

説明

200 OK

要求は成功しました。

202 Accepted

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

ヘッダー

Location: string
Retry-After: integer

Other Status Codes

CloudError

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

型: 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=2025-11-01

{
  "instanceIds": [
    "aaaaaaaaaa"
  ],
  "forceUpdateOSDiskForEphemeral": true,
  "tempDisk": true
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.Resources.Models;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Reimage_MaximumSet_Gen.json
// this example is just showing the usage of "VirtualMachineScaleSets_Reimage" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this VirtualMachineScaleSetResource created on azure
// for more information of creating VirtualMachineScaleSetResource, please refer to the document of VirtualMachineScaleSetResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "rgcompute";
string virtualMachineScaleSetName = "aaaaaaaaaaaaaaaaaaaaaaaaaa";
ResourceIdentifier virtualMachineScaleSetResourceId = VirtualMachineScaleSetResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, virtualMachineScaleSetName);
VirtualMachineScaleSetResource virtualMachineScaleSet = client.GetVirtualMachineScaleSetResource(virtualMachineScaleSetResourceId);

// invoke the operation
VirtualMachineScaleSetReimageContent content = new VirtualMachineScaleSetReimageContent
{
    InstanceIds = { "aaaaaaaaaa" },
    ForceUpdateOSDiskForEphemeral = true,
    TempDisk = true,
};
await virtualMachineScaleSet.ReimageAsync(WaitUntil.Completed, content: content);

Console.WriteLine("Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

状態コード:: 202

location: https://foo.com/operationstatus

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

要求のサンプル

HTTP
dotnet

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Models;
using Azure.ResourceManager.Resources.Models;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSet_Reimage_MinimumSet_Gen.json
// this example is just showing the usage of "VirtualMachineScaleSets_Reimage" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this VirtualMachineScaleSetResource created on azure
// for more information of creating VirtualMachineScaleSetResource, please refer to the document of VirtualMachineScaleSetResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "rgcompute";
string virtualMachineScaleSetName = "aaaaaaaaaaaaaaaaaaaaaaaaaaaa";
ResourceIdentifier virtualMachineScaleSetResourceId = VirtualMachineScaleSetResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, virtualMachineScaleSetName);
VirtualMachineScaleSetResource virtualMachineScaleSet = client.GetVirtualMachineScaleSetResource(virtualMachineScaleSetResourceId);

// invoke the operation
await virtualMachineScaleSet.ReimageAsync(WaitUntil.Completed);

Console.WriteLine("Succeeded");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

応答のサンプル

状態コード:: 200

状態コード:: 202

location: https://foo.com/operationstatus

定義

名前	説明
ApiError	API エラー。
ApiErrorBase	API エラーベース。
CloudError	コンピューティングサービスからのエラー応答。
InnerError	内部エラーの詳細。
OSProfileProvisioningData	非エフェメラル仮想マシンを再イメージ化するための追加パラメーター。
VirtualMachineScaleSetReimageParameters	仮想マシンスケールセット VM の再イメージ化パラメーターについて説明します。

ApiError

Object

API エラー。

名前	型	説明
code	string	エラーコード。
details	ApiErrorBase[]	Api エラーの詳細
innererror	InnerError	Api 内部エラー
message	string	エラーメッセージ。
target	string	特定のエラーのターゲット。

ApiErrorBase

Object

API エラーベース。

名前	型	説明
code	string	エラーコード。
message	string	エラーメッセージ。
target	string	特定のエラーのターゲット。

CloudError

Object

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

名前	型	説明
error	ApiError	API エラー。

InnerError

Object

内部エラーの詳細。

名前	型	説明
errordetail	string	内部エラーメッセージまたは例外ダンプ。
exceptiontype	string	例外の種類。

OSProfileProvisioningData

Object

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

名前	型	説明
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」、「パスワード!」、「パスワード1」、「パスワード22」、「iloveyou!」パスワードのリセットについては、Windows VMでRemote Desktopサービスまたはそのログインパスワードをリセットする方法を参照してください rootパスワードのリセットについては、Manage users、SSH、そしてVMAccess拡張機能
customData	string	カスタムデータの base-64 でエンコードされた文字列を指定します。 base-64 でエンコードされた文字列は、仮想マシン上のファイルとして保存されるバイナリ配列にデコードされます。バイナリ配列の最大長は 65535 バイトです。注: customData プロパティにシークレットやパスワードを渡さないでください。このプロパティは、VM の作成後に更新できません。プロパティ customData は、ファイルとして保存される VM に渡されます (詳細については、「 Azure VM のカスタムデータ」を参照してください)。 Linux VM に cloud-init を使用する場合は、「作成時に cloud-init を使用して Linux VM をカスタマイズする」を参照してください。

VirtualMachineScaleSetReimageParameters

Object

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

名前	型	説明
exactVersion	string	OS ディスクの再イメージ化の対象となるバージョンを 10 進数で指定します。正確なバージョンが指定されていない場合、OS ディスクは既存のバージョンの OS ディスクに再イメージ化されます。
forceUpdateOSDiskForEphemeral	boolean	仮想マシンスケールセット VM のエフェメラル OS ディスクを強制的に更新するパラメーター
instanceIds	string[]	仮想マシンスケールセットのインスタンス ID。仮想マシンスケールセットのインスタンス ID を省略すると、仮想マシンスケールセット内のすべての仮想マシンで操作が実行されます。
osProfile	OSProfileProvisioningData	非エフェメラルOSディスクの再イメージ化に必要な情報を指定します。
tempDisk	boolean	一時ディスクを再イメージ化するかどうかを指定します。既定値: false 注: この一時ディスク再イメージ化パラメーターは、エフェメラル OS ディスクを使用する VM/VMSS でのみサポートされます。