Freigeben über


Virtual Machine Scale Sets - Reimage

Reimages (upgrade the operating system) one or more virtual machines in a VM scale set which don't have a ephemeral OS disk, for virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

Der Name der Ressourcengruppe.

subscriptionId
path True

string

Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

vmScaleSetName
path True

string

Der Name des VM-Skalierungssatzes.

api-version
query True

string

Client-API-Version.

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 des kurzlebigen Betriebssystemdatenträgers für einen VM-Skalierungssatz für virtuelle Computer

instanceIds

string[]

Die VM-Skalierungssatzinstanz-IDs. Wenn die VM-Skalierungsgruppeninstanz-IDs weggelassen werden, wird der Vorgang auf allen virtuellen Computern im Skalierungssatz des virtuellen Computers ausgeführt.

osProfile

OSProfileProvisioningData

Gibt Informationen an, die zum Neubeigen des nicht ephemeren 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

OKAY

202 Accepted

Angenommen

Other Status Codes

CloudError

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

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

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

VirtualMachineScaleSet_Reimage_MaximumSet_Gen
VirtualMachineScaleSet_Reimage_MinimumSet_Gen

VirtualMachineScaleSet_Reimage_MaximumSet_Gen

Beispielanforderung

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

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

Beispiel für eine Antwort

location: https://foo.com/operationstatus

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

Beispielanforderung

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

Beispiel für eine Antwort

location: https://foo.com/operationstatus

Definitionen

Name Beschreibung
ApiError

API-Fehler.

ApiErrorBase

API-Fehlerbasis.

CloudError

Eine Fehlerantwort des Computediensts.

InnerError

Innere Fehlerdetails.

OSProfileProvisioningData

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

VirtualMachineScaleSetReimageParameters

Beschreibt einen VM Scale Set VM Reimage Parameters.

ApiError

API-Fehler.

Name Typ Beschreibung
code

string

Der Fehlercode.

details

ApiErrorBase[]

Die API-Fehlerdetails

innererror

InnerError

Interner API-Fehler

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

ApiErrorBase

API-Fehlerbasis.

Name Typ Beschreibung
code

string

Der Fehlercode.

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

CloudError

Eine Fehlerantwort des Computediensts.

Name Typ Beschreibung
error

ApiError

API-Fehler.

InnerError

Innere Fehlerdetails.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder das Ausnahmeabbild.

exceptiontype

string

Der Ausnahmetyp.

OSProfileProvisioningData

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

Name Typ Beschreibung
adminPassword

string

Gibt das Kennwort des Administratorkontos an.

Mindestlänge (Windows): 8 Zeichen

Mindestlänge (Linux): 6 Zeichen

Max. Länge (Windows): 123 Zeichen

Max-Length (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", "Password!", "Password1", "Password22", "iloveyou!"

Informationen zum Zurücksetzen des Kennworts finden Sie unter Zurücksetzen des Remotedesktopdiensts oder seines Anmeldekennworts in einer Windows-VM-

Informationen zum Zurücksetzen des Stammkennworts finden Sie unter Verwalten von Benutzern, SSH und Überprüfen oder Reparieren von Datenträgern auf Azure Linux-VMs mithilfe 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, lesen Sie Verwenden von Cloud-Init zum Anpassen einer Linux-VM während der Erstellung.

VirtualMachineScaleSetReimageParameters

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 des kurzlebigen Betriebssystemdatenträgers für einen VM-Skalierungssatz für virtuelle Computer

instanceIds

string[]

Die VM-Skalierungssatzinstanz-IDs. Wenn die VM-Skalierungsgruppeninstanz-IDs weggelassen werden, wird der Vorgang auf allen virtuellen Computern im Skalierungssatz des virtuellen Computers ausgeführt.

osProfile

OSProfileProvisioningData

Gibt Informationen an, die zum Neubeigen des nicht ephemeren 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.