Method: projects.locations.awsClusters.delete

Löscht eine bestimmte AwsCluster-Ressource.

Führt zu einem Fehler, wenn dem Cluster eine oder mehrere AwsNodePool-Ressourcen zugeordnet sind.

Bei Erfolg 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.

Die URLs verwenden die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname der zu löschenden AwsCluster.

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

Weitere Informationen zu Google Cloud-Ressourcennamen finden Sie unter Ressourcennamen.

Abfrageparameter

Parameter
validateOnly

boolean

Wenn diese Option festgelegt ist, wird die Anfrage nur validiert, die Ressource jedoch nicht gelöscht.
allowMissing

boolean

Wenn diese Option auf „true“ gesetzt ist und die AwsCluster-Ressource nicht gefunden wird, ist die Anfrage erfolgreich, es wird jedoch keine Aktion auf dem Server ausgeführt und eine fertige Operation wird zurückgegeben.

Nützlich für idempotentes Löschen.
ignoreErrors

boolean

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

string

Das aktuelle etag der AwsCluster.

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

Wenn das angegebene etag nicht mit dem aktuellen etag des Clusters übereinstimmt, schlägt die Anfrage fehl und es wird der Fehler ABORTED 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.