Anúncio: todos os projetos não comerciais registrados para usar o Earth Engine antes de
15 de abril de 2025 precisam
verificar a qualificação não comercial para manter o acesso ao Earth Engine.
Method: projects.operations.cancel
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Inicia o cancelamento assíncrono de uma operação de longa duração. São feitas várias tentativas para cancelar a operação no servidor, mas o sucesso não é garantido. Se o servidor não for compatível com esse método, ele retornará google.rpc.Code.UNIMPLEMENTED
. Os clientes podem usar Operations.GetOperation
ou outros métodos para verificar se o cancelamento ocorreu ou se a operação foi concluída mesmo com o cancelamento. Se o cancelamento for bem-sucedido, a operação não será excluída. Em vez disso, ela se tornará uma operação com um valor Operation.error
que tem um google.rpc.Status.code
de 1
, correspondente a Code.CANCELLED
.
Solicitação HTTP
POST https://earthengine.googleapis.com/v1beta/{name=projects/*/operations/**}:cancel
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros |
name |
string
O nome do recurso de operação a ser cancelado.
|
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 será um objeto JSON vazio.
Escopos de autorização
Requer um dos seguintes escopos do OAuth:
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
Para mais informações, consulte OAuth 2.0 Overview.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eInitiates an asynchronous cancellation process for long-running operations, although cancellation success is not guaranteed.\u003c/p\u003e\n"],["\u003cp\u003eThe server may return an \u003ccode\u003eUNIMPLEMENTED\u003c/code\u003e error if it lacks cancellation support; use \u003ccode\u003eOperations.GetOperation\u003c/code\u003e to verify cancellation status.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful cancellation, the operation persists with an error code indicating cancellation instead of deletion.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eCancelOperation\u003c/code\u003e request is sent to a specific URL with the operation's name as a path parameter and an empty request body.\u003c/p\u003e\n"],["\u003cp\u003eProper authorization is needed using either \u003ccode\u003eearthengine\u003c/code\u003e or \u003ccode\u003ecloud-platform\u003c/code\u003e OAuth scopes to execute the request.\u003c/p\u003e\n"]]],["This describes how to asynchronously cancel a long-running operation. A `POST` request to a specific URL using `gRPC Transcoding` initiates cancellation, with the operation's name as a path parameter. The request body must be empty. Upon success, the server returns an empty JSON object, but cancellation isn't guaranteed. The status of the operation is checked via `Operations.GetOperation` and a successful cancellation changes the operation's status `Code.CANCELLED` and is not deleted.\n"],null,["# Method: projects.operations.cancel\n\nStarts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use [Operations.GetOperation](/earth-engine/reference/rest/v1alpha/projects.operations/get#google.longrunning.Operations.GetOperation) or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an [Operation.error](/earth-engine/reference/rest/Shared.Types/ListOperationsResponse#Operation.FIELDS.error) value with a [google.rpc.Status.code](/earth-engine/reference/rest/Shared.Types/ListOperationsResponse#Status.FIELDS.code) of `1`, corresponding to `Code.CANCELLED`.\n\n### HTTP request\n\n`POST https://earthengine.googleapis.com/v1beta/{name=projects/*/operations/**}:cancel`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------|\n| `name` | `string` The name of the operation resource to be cancelled. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]