Virtual Machine Scale Sets - Reimage

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resource group. 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.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

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

Voorbeeldaanvraag

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
}

Voorbeeldrespons

location: https://foo.com/operationstatus

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Api-fout.

Name Type Description
code

string

De foutcode.

details

ApiErrorBase[]

Details van de API-fout

innererror

InnerError

De interne API-fout

message

string

Het foutbericht.

target

string

Het doel van de specifieke fout.

ApiErrorBase

Api-foutbasis.

Name Type Description
code

string

De foutcode.

message

string

Het foutbericht.

target

string

Het doel van de specifieke fout.

CloudError

Een foutreactie van de Compute-service.

Name Type Description
error

ApiError

Api-fout.

InnerError

Interne foutdetails.

Name Type Description
errordetail

string

Het interne foutbericht of de uitzonderingsdump.

exceptiontype

string

Het uitzonderingstype.

OSProfileProvisioningData

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.

Minimale lengte (Windows): 8 tekens

Minimale lengte (Linux): 6 tekens

Maximale 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!"

Zie De extern bureaublad-service of het aanmeldingswachtwoord opnieuw instellen in een Windows-VM voor het opnieuw instellen van het wachtwoord.

Zie Gebruikers, SSH beheren en schijven controleren of herstellen op virtuele Azure Linux-machines met behulp van de VMAccess-extensie voor het opnieuw instellen van het hoofdwachtwoord

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 virtuele machine die als bestand moet worden opgeslagen. Zie Aangepaste gegevens op Virtuele Azure-machinesvoor meer informatie. Als u cloud-init gebruikt voor uw Linux-VM, raadpleegt u Cloud-init gebruiken om een Virtuele Linux-machine aan te passen tijdens het maken van.

VirtualMachineScaleSetReimageParameters

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.