Virtual Machines - Reimage

Dienst:

Lab Services

API-Version:

2023-06-07

Erstellen Sie ein neues Image für einen virtuellen Labcomputer. Der virtuelle Computer wird gelöscht und mithilfe der neuesten veröffentlichten Momentaufnahme der Referenzumgebung des Labs neu erstellt.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.LabServices/labs/{labName}/virtualMachines/{virtualMachineName}/reimage?api-version=2023-06-07

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
labName	path	True	string	Der Name des Labs, das es innerhalb des lab-Plans eindeutig identifiziert. Wird in Ressourcen-URIs verwendet.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string	Hierbei handelt es sich um die ID des Zielabonnements.
virtualMachineName	path	True	string	Die ID des virtuellen Computers, der ihn innerhalb des enthaltenden Labs eindeutig identifiziert. Wird in Ressourcen-URIs verwendet. RegEx-Muster: ^[-\w\\._\\(\\)]+$
api-version	query	True	string	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name	Typ	Beschreibung
200 OK		Die Anforderung wurde abgeschlossen.
202 Accepted		Die Anforderung wurde akzeptiert.
Other Status Codes	ErrorResponse	Die Standardfehlerantwort.

Beispiele

reimageVirtualMachine

Beispielanforderung

HTTP

POST https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.LabServices/labs/testlab/virtualMachines/template/reimage?api-version=2023-06-07

Beispiel für eine Antwort

Statuscode:

200

Statuscode:

202

Location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.LabServices/operationresults/a64149d8-84cb-4566-ab8e-b4ee1a074174

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Fehlerinformationen.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.