Virtual Machine Scale Sets - Reimage

Service:: Compute

API-versie:: 2025-11-01

Installatiekopieën (upgrade het besturingssysteem) een of meer virtuele machines in een VM-schaalset die geen tijdelijke besturingssysteemschijf hebben, voor virtuele machines die een tijdelijke besturingssysteemschijf hebben, wordt de virtuele machine opnieuw ingesteld op de beginstatus.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string minLength: 1	De ID van het doelabonnement.
vmScaleSetName	path	True	string	De naam van de VM-schaalset.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Type	Description
exactVersion	string	Hiermee geeft u een decimaal getal op, de versie waarnaar de besturingssysteemschijf moet worden hersteld. Als er geen exacte versie is opgegeven, wordt de installatiekopie van de besturingssysteemschijf hersteld naar de bestaande versie van de besturingssysteemschijf.
forceUpdateOSDiskForEphemeral	boolean	Parameter voor het afdwingen van het bijwerken van kortstondige besturingssysteemschijf voor een VM op een virtuele-machineschaal
instanceIds	string[]	De exemplaar-id's van de virtuele-machineschaalset. Als u de instantie-id's van de virtuele-machineschaalset weglaat, wordt de bewerking uitgevoerd op alle virtuele machines in de virtuele-machineschaalset.
osProfile	OSProfileProvisioningData	Specificeert de informatie die nodig is voor het opnieuw maken van een image van de niet-kortstondige besturingssysteemschijf.
tempDisk	boolean	Hiermee geeft u op of de tijdelijke schijf moet worden hersteld. Standaardwaarde: false. Opmerking: deze tijdelijke parameter voor schijfherinstallatiekopie wordt alleen ondersteund voor VM/VMSS met tijdelijke besturingssysteemschijf.

Antwoorden

Name	Type	Description
200 OK		De aanvraag is voltooid.
202 Accepted		Resourcebewerking geaccepteerd. Kopteksten Location: string Retry-After: integer
Other Status Codes	CloudError	Een onverwachte foutreactie.

Name

Type

Description

200 OK

De aanvraag is voltooid.

202 Accepted

Resourcebewerking geaccepteerd.

Kopteksten

Location: string
Retry-After: integer

Other Status Codes

CloudError

Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

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

Voorbeeldrespons

Statuscode:: 200

Statuscode:: 202

location: https://foo.com/operationstatus

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:: 200

Statuscode:: 202

location: https://foo.com/operationstatus

Definities

Name	Description
ApiError	Api-fout.
ApiErrorBase	Api-foutbasis.
CloudError	Een foutreactie van de Compute-service.
InnerError	Interne foutdetails.
OSProfileProvisioningData	Aanvullende parameters voor het opnieuw opgeven van niet-tijdelijke virtuele machine.
VirtualMachineScaleSetReimageParameters	Beschrijft parameters voor het opnieuw instellen van virtuele-machineschaalsets.

ApiError

Object

Api-fout.

Name	Type	Description
code	string	De foutcode.
details	ApiErrorBase[]	Details van de Api-fout
innererror	InnerError	De innerlijke fout van de Api
message	string	Het foutbericht.
target	string	Het doel van de specifieke fout.

ApiErrorBase

Object

Api-foutbasis.

Name	Type	Description
code	string	De foutcode.
message	string	Het foutbericht.
target	string	Het doel van de specifieke fout.

CloudError

Object

Een foutreactie van de Compute-service.

Name	Type	Description
error	ApiError	Api-fout.

InnerError

Object

Interne foutdetails.

Name	Type	Description
errordetail	string	De interne foutmelding of uitzonderingsdump.
exceptiontype	string	Het uitzonderingstype.

OSProfileProvisioningData

Object

Aanvullende parameters voor het opnieuw opgeven van niet-tijdelijke virtuele machine.

Name	Type	Description
adminPassword	string (password)	Hiermee geeft u het wachtwoord van het beheerdersaccount. Minimumlengte (Windows): 8 tekens Minimale lengte (Linux): 6 tekens Max-lengte (Windows): 123 tekens Maximale lengte (Linux): 72 tekens Complexiteitsvereisten: aan 3 van de 4 onderstaande voorwaarden moet worden voldaan Heeft lagere tekens Bevat bovenliggende tekens Heeft een cijfer Heeft een speciaal teken (Regex-overeenkomst [\W_]) Niet-toegestane waarden: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Wachtwoord!", "Wachtwoord1", "Wachtwoord22", "iloveyou!" Voor het resetten van het wachtwoord, zie Hoe reset je de Remote Desktop-dienst of het inlogwachtwoord in een Windows VM Voor het resetten van het rootwachtwoord, zie Beheerders, SSH beheren en disks controleren of repareren op Azure Linux-VM's met de VMAccess Extension
customData	string	Hiermee geeft u een met base 64 gecodeerde tekenreeks van aangepaste gegevens op. De met base 64 gecodeerde tekenreeks wordt gedecodeerd naar een binaire matrix die wordt opgeslagen als een bestand op de virtuele machine. De maximale lengte van de binaire matrix is 65535 bytes. Opmerking: geef geen geheimen of wachtwoorden door in de eigenschap customData. Deze eigenschap kan niet worden bijgewerkt nadat de virtuele machine is gemaakt. De eigenschap customData wordt doorgegeven aan de VM om als bestand te worden opgeslagen, zie Aangepaste gegevens op Azure-VM's voor meer informatie. Als u cloud-init gebruikt voor uw Linux-VM, raadpleegt u Cloud-init gebruiken om een Linux-VM aan te passen tijdens het maken.

VirtualMachineScaleSetReimageParameters

Object

Beschrijft parameters voor het opnieuw instellen van virtuele-machineschaalsets.

Name	Type	Description
exactVersion	string	Hiermee geeft u een decimaal getal op, de versie waarnaar de besturingssysteemschijf moet worden hersteld. Als er geen exacte versie is opgegeven, wordt de installatiekopie van de besturingssysteemschijf hersteld naar de bestaande versie van de besturingssysteemschijf.
forceUpdateOSDiskForEphemeral	boolean	Parameter voor het afdwingen van het bijwerken van kortstondige besturingssysteemschijf voor een VM op een virtuele-machineschaal
instanceIds	string[]	De exemplaar-id's van de virtuele-machineschaalset. Als u de instantie-id's van de virtuele-machineschaalset weglaat, wordt de bewerking uitgevoerd op alle virtuele machines in de virtuele-machineschaalset.
osProfile	OSProfileProvisioningData	Specificeert de informatie die nodig is voor het opnieuw maken van een image van de niet-kortstondige besturingssysteemschijf.
tempDisk	boolean	Hiermee geeft u op of de tijdelijke schijf moet worden hersteld. Standaardwaarde: false. Opmerking: deze tijdelijke parameter voor schijfherinstallatiekopie wordt alleen ondersteund voor VM/VMSS met tijdelijke besturingssysteemschijf.