- Solicitação HTTP
- Parâmetros do caminho
- Corpo da solicitação
- Corpo de resposta
- Escopos de autorização
- Permissões do IAM
Inicia o cancelamento assíncrono em uma operação de longa duração. O servidor faz o máximo possível para cancelar a operação, mas o sucesso não é garantido. Se o servidor não suportar esse método, ele retornará google.rpc.Code.UNIMPLEMENTED
. Os clientes podem usar Operations.GetOperation
ou outros métodos para verificar se o cancelamento foi bem-sucedido ou se a operação foi concluída apesar do cancelamento. Em caso de cancelamento bem-sucedido, a operação não é excluída; em vez disso, ela se torna uma operação com um valor Operation.error
e um google.rpc.Status.code
de 1
, correspondente a Code.CANCELLED
.
Solicitação HTTP
POST https://{endpoint}/v1/{name=projects/*/locations/*/operations/*}:cancel
Onde {endpoint}
é um dos pontos de extremidade de serviço suportados .
Os URLs usam a sintaxe de transcodificação gRPC .
Parâmetros do caminho
Parâmetros | |
---|---|
name | O nome do recurso da operação a ser cancelado. |
Corpo da solicitação
O corpo da solicitação deve estar vazio.
Corpo de resposta
Se bem-sucedido, o corpo da resposta será um objeto JSON vazio.
Escopos de autorização
Requer o seguinte escopo OAuth:
-
https://www.googleapis.com/auth/cloud-platform
Para mais informações, consulte oAuthentication Overview .
Permissões do IAM
Requer a seguinte permissão do IAM no recurso name
:
-
gkemulticloud.operations.cancel
Para obter mais informações, consulte a documentação do IAM .