Virtual Machines - Delete

Dienst:
Compute
API-Version:
2023-09-01

Der Vorgang zum Löschen eines virtuellen Computers.

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}?api-version=2023-09-01
Mit optionalen Parametern: 
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}?forceDeletion={forceDeletion}&api-version=2023-09-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.
vmName
 path True

string

Der Name des virtuellen Computers.
api-version
 query True

string

Client-API-Version.
forceDeletion
 query

boolean

Optionaler Parameter zum Erzwingen des Löschens virtueller Computer.

Antworten

Name Typ Beschreibung
200 OK

OKAY
202 Accepted

Angenommen
204 No Content

Kein Inhalt
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

Force delete a VM

Beispielanforderung

DELETE https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM?forceDeletion=true&api-version=2023-09-01

Beispiel für eine Antwort

Statuscode:
200
Statuscode:
202 
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2023-09-01
Statuscode:
204

Definitionen

Name Beschreibung
ApiError

API-Fehler.
ApiErrorBase

API-Fehlerbasis.
CloudError

Eine Fehlerantwort des Computediensts.
InnerError

Innere Fehlerdetails.

ApiError

Objekt

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

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 des Computediensts.

Name Typ Beschreibung
error

ApiError

API-Fehler.

InnerError

Objekt

Innere Fehlerdetails.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder das Ausnahmeabbild.
exceptiontype

string

Der Ausnahmetyp.