Freigeben über

Virtual Machines - Reimage

  • Referenz
Dienst:
Lab Services
API-Version:
2023-06-07

Erstellen Sie ein erneutes Image eines virtuellen Laborcomputers. Der virtuelle Computer wird mithilfe der neuesten veröffentlichten Momentaufnahme der Referenzumgebung des Labors gelöscht und 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

minLength: 1
maxLength: 100

Der Name des Labors, das es innerhalb eines Laborplans eindeutig identifiziert. Wird in Ressourcen-URIs verwendet.
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.
virtualMachineName
 path True

string

minLength: 1
maxLength: 100
pattern: ^[-\w\\._\\(\\)]+$

Die ID des virtuellen Computers, der ihn innerhalb des enthaltenden Labors eindeutig identifiziert. Wird in Ressourcen-URIs verwendet.
api-version
 query True

string

minLength: 1

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

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

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

Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail

Das Fehlerdetails.
ErrorResponse

Fehlerantwort

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.
type

string

Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.
code

string

Der Fehlercode.
details

ErrorDetail[]

Die Fehlerdetails.
message

string

Die Fehlermeldung.
target

string

Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.