Method: projects.locations.awsClusters.delete

Exclui um recurso AwsCluster específico.

Falhará se o cluster tiver um ou mais recursos AwsNodePool associados.

Se bem-sucedida, a resposta conterá um recurso Operation recém-criado que poderá ser descrito para rastrear o status da operação.

Solicitação HTTP

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

Em que {endpoint} é um dos endpoints de serviço compatíveis.

Os URLs usam a sintaxe de Transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do recurso AwsCluster a ser excluído.

Os nomes de AwsCluster são formatados como projects/<project-id>/locations/<region>/awsClusters/<cluster-id>.

Consulte Nomes de recursos para mais detalhes sobre os nomes de recursos do Google Cloud Platform.

Parâmetros de consulta

Parâmetros
validateOnly

boolean

Se definido, só valida a solicitação, mas não exclui o recurso.
allowMissing

boolean

Se definido como verdadeiro e o recurso AwsCluster não for encontrado, a solicitação será bem-sucedida, mas nenhuma ação será realizada no servidor e um Operation completo será retornado.

Útil para exclusão idempotente.
ignoreErrors

boolean

Opcional. Se definido como verdadeiro, a exclusão do recurso AwsCluster será bem-sucedida mesmo que ocorram erros durante a exclusão dos recursos do cluster. O uso desse parâmetro pode resultar em recursos órfãos no cluster.
etag

string

A ETag atual do AwsCluster.

Permite que os clientes realizem exclusões por meio do controle de simultaneidade otimista.

Se a etag fornecida não corresponder à atual do cluster, a solicitação falhará e um erro ABORTED será retornado.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso name:

  • gkemulticloud.awsClusters.delete

Para mais informações, consulte a documentação do IAM.