Method: projects.locations.targets.delete

Borra un solo destino.

Solicitud HTTP

DELETE https://clouddeploy.googleapis.com/v1/{name=projects/*/locations/*/targets/*}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. El nombre de la Target que se borrará. El formato debe ser projects/{projectId}/locations/{location_name}/targets/{target_name}.

Parámetros de consulta

Parámetros
requestId

string

Opcional. Un ID de solicitud para identificar solicitudes. Especifica un ID de solicitud único para que, si debes reintentar tu solicitud, el servidor sepa que debe ignorarla si ya se completó. El servidor lo garantiza durante al menos 60 minutos después de la primera solicitud.

Por ejemplo, imagina una situación en la que haces una solicitud inicial y se agota el tiempo de espera de la solicitud. Si vuelves a hacer la solicitud con el mismo ID de solicitud, el servidor puede verificar si se recibió la operación original con el mismo ID de solicitud y, de ser así, ignorar la segunda solicitud. Esto evita que los clientes creen compromisos duplicados por accidente.

El ID de solicitud debe ser un UUID válido, con la excepción de que no se admite ningún UUID cero (00000000-0000-0000-0000-000000000000).
allowMissing

boolean

Opcional. Si se configura como verdadera, se borrará correctamente un Target ya borrado o inexistente.
validateOnly

boolean

Opcional. Si está configurada, valida la solicitud y obtén una vista previa de la opinión, pero no la publiques.
etag

string

Opcional. El servidor calcula esta suma de verificación según el valor de otros campos, y puede enviarse en las solicitudes de actualización y eliminación para garantizar que el cliente tenga un valor actualizado antes de continuar.

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:

  • clouddeploy.targets.delete

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