Method: projects.locations.targets.delete

Löscht ein einzelnes Ziel.

HTTP-Anfrage

DELETE https://clouddeploy.googleapis.com/v1/{name=projects/*/locations/*/targets/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich Der Name der zu löschenden Target. Verwenden Sie das Format projects/{projectId}/locations/{location_name}/targets/{target_name}.

Abfrageparameter

Parameter
requestId

string

Optional. Eine Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, wenn sie noch einmal ausgeführt wurde. Der Server garantiert dies für mindestens 60 Minuten nach der ersten Anfrage.

Stellen Sie sich beispielsweise eine Situation vor, in der Sie eine erste Anfrage stellen und diese das Zeitlimit überschreitet. Wenn Sie die Anfrage mit derselben Anfrage-ID noch einmal senden, kann der Server prüfen, ob der ursprüngliche Vorgang mit derselben Anfrage-ID empfangen wurde. Ist dies der Fall, wird die zweite Anfrage ignoriert. Dadurch wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, mit der Ausnahme, dass null UUID nicht unterstützt wird (00000000-0000-0000-0000-000000000000).
allowMissing

boolean

Optional. Wenn die Richtlinie auf „true“ gesetzt ist, wird eine bereits gelöschte oder nicht vorhandene Target erfolgreich gelöscht.
validateOnly

boolean

Optional. Wenn festgelegt, validieren Sie die Anfrage und zeigen Sie eine Vorschau der Rezension an, aber posten Sie sie nicht.
etag

string

Optional. Diese Prüfsumme wird vom Server basierend auf dem Wert anderer Felder berechnet und kann bei Aktualisierungs- und Löschanfragen gesendet werden, um sicherzustellen, dass der Client vor dem Fortfahren über einen aktuellen Wert verfügt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/cloud-platform

Weitere Informationen finden Sie in der Authentifizierungsübersicht.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource name:

  • clouddeploy.targets.delete

Weitere Informationen finden Sie in der IAM-Dokumentation.