Method: projects.locations.awsClusters.delete

Borra un recurso AwsCluster específico.

Falla si el clúster tiene uno o más recursos AwsNodePool asociados.

Si se ejecuta de forma correcta, la respuesta contiene un recurso Operation recién creado que se puede describir para realizar un seguimiento del estado de la operación.

Solicitud HTTP

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

En el que {endpoint} es uno de los extremos del servicio admitidos.

Las URL usan la sintaxis de transcodificación gRPC.

Parámetros de ruta

Parámetros
name

string

Obligatorio. El nombre del recurso AwsCluster que se borrará.

Los nombres AwsCluster tienen el formato projects/<project-id>/locations/<region>/awsClusters/<cluster-id>.

Consulta Nombres de recursos para obtener más detalles sobre los nombres de recursos de Google Cloud.

Parámetros de consulta

Parámetros
validateOnly

boolean

Si se configura, solo válida la solicitud, pero no borra el recurso.

allowMissing

boolean

Si se configura como verdadero y no se encuentra el recurso AwsCluster, la solicitud se realizará de forma correcta, pero no se realizará ninguna acción en el servidor y se devolverá una Operation completa.

Es útil para la eliminación idempotente.

ignoreErrors

boolean

Opcional. Si se configura como verdadero, la eliminación del recurso AwsCluster se realizará de forma correcta incluso si se producen errores durante la eliminación de los recursos del clúster. El uso de este parámetro puede dar como resultado recursos huérfanos en el clúster.

etag

string

La ETag actual del AwsCluster.

Permite a los clientes realizar operaciones de borrado a través del control de simultaneidad optimista.

Si la etag proporcionada no coincide con la etag actual del clúster, la solicitud fallará y se devolverá un error ABORTED.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso name:

  • gkemulticloud.awsClusters.delete

Para obtener más información, consulta la documentación de IAM.