Method: projects.locations.awsClusters.delete

Löscht eine bestimmte AwsCluster-Ressource.

Schlägt fehl, wenn dem Cluster eine oder mehrere AwsNodePool-Ressourcen zugeordnet sind.

Bei erfolgreicher Ausführung enthält die Antwort eine neu erstellte Operation-Ressource, die beschrieben werden kann, um den Status des Vorgangs zu verfolgen.

HTTP-Anfrage

DELETE https://{endpoint}/v1/{name=projects/*/locations/*/awsClusters/*}

Dabei ist {endpoint} einer der unterstützten Dienstendpunkte.

Für die URLs wird die Syntax der gRPC-Transcodierung verwendet.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname des zu löschenden AwsCluster.

AwsCluster-Namen haben das Format projects/<project-id>/locations/<region>/awsClusters/<cluster-id>.

Weitere Informationen zu Ressourcennamen in der Google Cloud Platform finden Sie unter Ressourcennamen.

Suchparameter

Parameter
validateOnly

boolean

Wenn festgelegt, wird die Anfrage nur validiert, die Ressource wird aber nicht gelöscht.
allowMissing

boolean

Wenn auf „true“ gesetzt und die AwsCluster-Ressource nicht gefunden wird, wird die Anfrage erfolgreich ausgeführt, aber auf dem Server wird keine Aktion ausgeführt und eine abgeschlossene Operation wird zurückgegeben.

Nützlich für idempotente Löschvorgänge.
ignoreErrors

boolean

Optional. Wenn auf „true“ gesetzt, wird die AwsCluster-Ressource auch dann gelöscht, wenn beim Löschen von Clusterressourcen Fehler auftreten. Die Verwendung dieses Parameters kann zu verwaisten Ressourcen im Cluster führen.
etag

string

Das aktuelle ETag des AwsCluster.

Ermöglicht Clients, Löschvorgänge durch optimistische Nebenläufigkeitserkennung auszuführen.

Wenn das angegebene ETag nicht mit dem aktuellen ETag des Clusters übereinstimmt, schlägt die Anfrage fehl und es wird ein ABORTED-Fehler zurückgegeben.

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 unter Authentication Overview.

IAM-Berechtigungen

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

  • gkemulticloud.awsClusters.delete

Weitere Informationen finden Sie in der IAM-Dokumentation.