Method: projects.locations.tenants.delete

Einzelnen Mandanten löschen.

HTTP-Anfrage

DELETE https://saasservicemgmt.googleapis.com/v1/{name=projects/*/locations/*/tenants/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Name der Ressource in einem Dienst.

Suchparameter

Parameter
etag

string

Das ETag, das dem Client für den erwarteten Status des Mandanten bekannt ist. Diese wird mit Methoden verwendet, die den Status ändern, um versehentliches Überschreiben zu verhindern, wenn mehrere User-Agents parallel auf dieselbe Ressource zugreifen.

Ein ETag-Wildcard bietet optimistische Parallelität basierend auf der erwarteten Existenz des Mandanten. Für den Platzhalter „Beliebig“ (*) muss die Ressource bereits vorhanden sein, für den Platzhalter „Nicht beliebig“ (!*) darf sie nicht vorhanden sein.
validateOnly

boolean

Wenn „validateOnly“ auf „true“ gesetzt ist, versucht der Dienst zu validieren, ob diese Anfrage erfolgreich wäre, nimmt aber keine Änderungen vor.
requestId

string

Eine optionale Anfrage-ID zur Identifizierung von Anfragen. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignoriert, falls sie bereits abgeschlossen wurde und wiederholt wird. Der Server gewährleistet dies für mindestens 60 Minuten nach der ersten Anfrage.

Nehmen wir an, Sie senden eine erste Anfrage, deren Zeitlimit überschritten wird. Wenn Sie die Anfrage mit derselben Anfrage-ID erneut 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. So wird verhindert, dass Clients versehentlich doppelte Zusicherungen erstellen.

Die Anfrage-ID muss eine gültige UUID sein, es sei denn, UUIDs mit Nullen werden nicht unterstützt (00000000-0000-0000-0000-000000000000).

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

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

  • saasservicemgmt.tenants.delete

Weitere Informationen finden Sie in der IAM-Dokumentation.