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 |
---|---|---|---|---|
resource
|
path | True |
string |
Der Name der Ressourcengruppe. |
subscription
|
path | True |
string |
Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf. |
vm
|
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 |
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 |
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
Virtual |
Virtual |
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
Beispiel für eine Antwort
location: https://foo.com/operationstatus
Definitionen
Name | Beschreibung |
---|---|
Api |
API-Fehler. |
Api |
API-Fehlerbasis. |
Cloud |
Eine Fehlerantwort des Computediensts. |
Inner |
Innere Fehlerdetails. |
OSProfile |
Zusätzliche Parameter für das Reimaging non-Ephemeral Virtual Machine. |
Virtual |
Beschreibt einen VM Scale Set VM Reimage Parameters. |
ApiError
API-Fehler.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Fehlercode. |
details |
Die API-Fehlerdetails |
|
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 |
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. |
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 |
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. |