Method: projects.locations.awsClusters.delete

Supprime une ressource AwsCluster spécifique.

Échoue si le cluster est associé à une ou plusieurs ressources AwsNodePool.

Si la requête aboutit, la réponse contient une ressource Operation nouvellement créée qui peut être décrite pour suivre l'état de l'opération.

Requête HTTP

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

Où {endpoint} est l'un des points de terminaison de service compatibles.

Les URL utilisent la syntaxe de transcodage gRPC.

Paramètres de chemin

Paramètres
name

string

Obligatoire. Nom de ressource du AwsCluster à supprimer.

Les noms AwsCluster sont au format projects/<project-id>/locations/<region>/awsClusters/<cluster-id>.

Pour en savoir plus sur les noms de ressources Google Cloud Platform, consultez Noms de ressources.

Paramètres de requête

Paramètres
validateOnly

boolean

Si cette valeur est définie, validez uniquement la requête, mais ne supprimez pas réellement la ressource.
allowMissing

boolean

Si elle est définie sur "true" et que la ressource AwsCluster est introuvable, la requête aboutit, mais aucune action n'est effectuée sur le serveur et une Operation terminée est renvoyée.

Utile pour la suppression idempotente.
ignoreErrors

boolean

Facultatif. Si la valeur est "true", la suppression de la ressource AwsCluster aboutit même si des erreurs se produisent lors de la suppression des ressources du cluster. L'utilisation de ce paramètre peut entraîner des ressources orphelines dans le cluster.
etag

string

Etag actuel de AwsCluster.

Permet aux clients d'effectuer des suppressions via un contrôle de simultanéité optimiste.

Si l'etag fourni ne correspond pas à l'etag actuel du cluster, la requête échoue et une erreur ABORTED est renvoyée.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource name :

  • gkemulticloud.awsClusters.delete

Pour en savoir plus, consultez la documentation IAM.