Freigeben über

Virtual Machine Scale Set VMs - Reimage

Dienst:
Compute
API-Version:
2025-11-01

Erstellt ein neues Image (Upgrade des Betriebssystems) für einen bestimmten virtuellen Computer in einer VM-Skalierungsgruppe.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
instanceId
 path True

string

Die Instanz-ID des virtuellen Computers.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId
 path True

string

minLength: 1

Die ID des Zielabonnements.
vmScaleSetName
 path True

string

Der Name des VM-Skalierungssatzes.
api-version
 query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name Typ Beschreibung
exactVersion

string

Gibt eine Dezimalzahl an, in der die Version des Betriebssystemdatenträgers neu erstellt werden soll. Wenn keine genaue Version bereitgestellt wird, wird der Betriebssystemdatenträger auf die vorhandene Version des Betriebssystemdatenträgers umgestellt.
forceUpdateOSDiskForEphemeral

boolean

Parameter zum Erzwingen der Aktualisierung eines kurzlebigen Betriebssystemdatenträgers für eine VM mit VM mit Skalierungsgruppe
osProfile

OSProfileProvisioningData

Gibt Informationen an, die für das erneute Erstellen eines Images des nicht kurzlebigen Betriebssystemdatenträgers erforderlich sind.
tempDisk

boolean

Gibt an, ob der temporäre Datenträger neu erstellt werden soll. Standardwert: False. Hinweis: Dieser parameter für temporäre Datenträgerumwendung wird nur für VM/VMSS mit ephemeralem Betriebssystemdatenträger unterstützt.

Antworten

Name Typ Beschreibung
200 OK

Die Anforderung ist erfolgreich.
202 Accepted

Ressourcenvorgang akzeptiert.

Header

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

CloudError

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen
VirtualMachineScaleSetVM_Reimage_MinimumSet_Gen

VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen

Beispielanforderung

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

{
  "forceUpdateOSDiskForEphemeral": true,
  "tempDisk": true
}

Beispiel für eine Antwort

Statuscode:
200
Statuscode:
202 
location: https://foo.com/operationstatus

VirtualMachineScaleSetVM_Reimage_MinimumSet_Gen

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200
Statuscode:
202 
location: https://foo.com/operationstatus

Definitionen

Name Beschreibung
ApiError

API-Fehler.
ApiErrorBase

API-Fehlerbasis.
CloudError

Eine Fehlerantwort vom Compute-Dienst.
InnerError

Innere Fehlerdetails.
OSProfileProvisioningData

Zusätzliche Parameter für das Reimaging non-Ephemeral Virtual Machine.
VirtualMachineScaleSetVMReimageParameters

Beschreibt einen VM Scale Set VM Reimage Parameters.

ApiError

Objekt

API-Fehler.

Name Typ Beschreibung
code

string

Der Fehlercode.
details

ApiErrorBase[]

Die Details zum API-Fehler
innererror

InnerError

Der innere API-Fehler
message

string

Die Fehlermeldung.
target

string

Das Ziel des bestimmten Fehlers.

ApiErrorBase

Objekt

API-Fehlerbasis.

Name Typ Beschreibung
code

string

Der Fehlercode.
message

string

Die Fehlermeldung.
target

string

Das Ziel des bestimmten Fehlers.

CloudError

Objekt

Eine Fehlerantwort vom Compute-Dienst.

Name Typ Beschreibung
error

ApiError

API-Fehler.

InnerError

Objekt

Innere Fehlerdetails.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder der Ausnahmedump.
exceptiontype

string

Der Ausnahmetyp.

OSProfileProvisioningData

Objekt

Zusätzliche Parameter für das Reimaging non-Ephemeral Virtual Machine.

Name Typ Beschreibung
adminPassword

string (password)

Gibt das Kennwort des Administratorkontos an.

Mindestlänge (Windows): 8 Zeichen

Mindestlänge (Linux): 6 Zeichen

Max-Länge (Windows): 123 Zeichen

Maximale Länge (Linux): 72 Zeichen

Komplexitätsanforderungen: 3 von 4 unten aufgeführten Bedingungen müssen erfüllt sein
Enthält Zeichen mit niedrigeren Zeichen
Enthält groß geschriebene Zeichen
Hat eine Ziffer
Weist ein Sonderzeichen auf (Regex-Übereinstimmung [\W_])

Unzulässige Werte: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Passwort!", "Passwort1", "Passwort22", "iloveyou!"

Um das Passwort zurückzusetzen, siehe Wie man den Remote Desktop-Dienst oder sein Anmeldepasswort in einer Windows VM

Um das Root-Passwort zurückzusetzen, siehe Benutzer verwalten, SSH und Festplatten auf Azure Linux-VMs mit der VMAccess-Erweiterung
customData

string

Gibt eine base64-codierte Zeichenfolge von benutzerdefinierten Daten an. Die base64-codierte Zeichenfolge wird mit einem binären Array decodiert, das als Datei auf dem virtuellen Computer gespeichert wird. Die maximale Länge des binären Arrays beträgt 65535 Bytes. Hinweis: Übergeben Sie keine geheimen Schlüssel oder Kennwörter in der customData-Eigenschaft. Diese Eigenschaft kann nicht aktualisiert werden, nachdem der virtuelle Computer erstellt wurde. Die Eigenschaft customData wird an die VM übergeben, die als Datei gespeichert werden soll. Weitere Informationen finden Sie unter Benutzerdefinierte Daten auf Azure-VMs. Wenn Sie cloud-init für Ihre Linux-VM verwenden, finden Sie weitere Informationen unter Verwenden von cloud-init zum Anpassen einer Linux-VM während der Erstellung.

VirtualMachineScaleSetVMReimageParameters

Objekt

Beschreibt einen VM Scale Set VM Reimage Parameters.

Name Typ Beschreibung
exactVersion

string

Gibt eine Dezimalzahl an, in der die Version des Betriebssystemdatenträgers neu erstellt werden soll. Wenn keine genaue Version bereitgestellt wird, wird der Betriebssystemdatenträger auf die vorhandene Version des Betriebssystemdatenträgers umgestellt.
forceUpdateOSDiskForEphemeral

boolean

Parameter zum Erzwingen der Aktualisierung eines kurzlebigen Betriebssystemdatenträgers für eine VM mit VM mit Skalierungsgruppe
osProfile

OSProfileProvisioningData

Gibt Informationen an, die für das erneute Erstellen eines Images des nicht kurzlebigen Betriebssystemdatenträgers erforderlich sind.
tempDisk

boolean

Gibt an, ob der temporäre Datenträger neu erstellt werden soll. Standardwert: False. Hinweis: Dieser parameter für temporäre Datenträgerumwendung wird nur für VM/VMSS mit ephemeralem Betriebssystemdatenträger unterstützt.