- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Permisos de IAM
Inicia la cancelación asincrónica en una operación de larga duración. El servidor realiza su mejor esfuerzo para cancelar la operación, pero no se garantiza el éxito. Si el servidor no es compatible con este método, muestra google.rpc.Code.UNIMPLEMENTED
. Los clientes pueden usar Operations.GetOperation
o los otros métodos para comprobar si la cancelación se realizó de forma correcta o si la operación se completó a pesar de la cancelación. Si la cancelación se realiza de forma correcta, la operación no se borra. En lugar de ello, se convierte en una operación que tiene un valor Operation.error
con un google.rpc.Status.code
de 1, que corresponde a Code.CANCELLED
.
Solicitud HTTP
POST https://{endpoint}/v1/{name=projects/*/locations/*/operations/*}:cancel
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 |
El nombre del recurso de la operación que se cancelará. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.
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.operations.cancel
Para obtener más información, consulta la documentación de IAM.