Freigeben über


Deployments - Delete At Scope

Löscht eine Bereitstellung aus dem Bereitstellungsverlauf.
Eine Vorlagenbereitstellung, die aktuell ausgeführt wird, kann nicht gelöscht werden. Durch das Löschen einer Vorlagenbereitstellung werden die zugehörigen Bereitstellungsvorgänge ebenfalls entfernt. Dies ist ein asynchroner Vorgang, der den status 202 zurückgibt, bis die Vorlagenbereitstellung erfolgreich gelöscht wurde. Der Location-Antwortheader enthält den URI, der zum Abrufen der status des Prozesses verwendet wird. Während der Prozess ausgeführt wird, gibt ein Aufruf des URIs im Speicherortheader den Status 202 zurück. Wenn der Prozess abgeschlossen ist, gibt der URI im Location-Header bei Erfolg den status 204 zurück. Wenn bei der asynchronen Anforderung ein Fehler aufgetreten ist, gibt der URI im Location-Header eine Fehlerebene status Code zurück.

DELETE https://management.azure.com/{scope}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2021-04-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
deploymentName
path True

string

Der Name der Bereitstellung

RegEx-Muster: ^[-\w\._\(\)]+$

scope
path True

string

Der Ressourcenbereich.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name Typ Beschreibung
202 Accepted

Akzeptiert: Gibt diesen status zurück, bis der asynchrone Vorgang abgeschlossen ist.

204 No Content

Kein Inhalt

Other Status Codes

CloudError

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

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

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Definitionen

Name Beschreibung
CloudError

Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorResponse

Fehlerantwort

CloudError

Eine Fehlerantwort für eine Ressourcenverwaltungsanforderung.

Name Typ Beschreibung
error

ErrorResponse

Fehlerantwort
Allgemeine Fehlerantwort für alle Azure Resource Manager-APIs, zur Rückgabe von Fehlerdetails für fehlgeschlagene Vorgänge. (Dies folgt auch dem OData-Fehlerantwortformat.)

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorResponse[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.