公告：凡是在
2025 年 4 月 15 日前註冊使用 Earth Engine 的非商業專案，都必須
驗證非商業用途資格，才能繼續存取 Earth Engine。
Method: projects.operations.cancel
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
POST https://earthengine.googleapis.com/v1alpha/{name=projects/*/operations/**}:cancel
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
name |
string
要取消的作業資源名稱。
|
回應主體
如果成功，回應主體會是空的 JSON 物件。
授權範圍
需要下列其中一種 OAuth 範圍：
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/cloud-platform
詳情請參閱 OAuth 2.0 Overview。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eInitiates an asynchronous cancellation request for a long-running Earth Engine operation, with no guarantee of success and returning \u003ccode\u003egoogle.rpc.Code.UNIMPLEMENTED\u003c/code\u003e if unsupported by the server.\u003c/p\u003e\n"],["\u003cp\u003eClients should use alternative methods such as \u003ccode\u003eOperations.GetOperation\u003c/code\u003e to confirm cancellation success or if the operation completed despite the request.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful cancellation marks the operation with an error having a \u003ccode\u003egoogle.rpc.Status.code\u003c/code\u003e of 1 (\u003ccode\u003eCode.CANCELLED\u003c/code\u003e) instead of deleting it.\u003c/p\u003e\n"],["\u003cp\u003eThis request requires an empty body and utilizes the \u003ccode\u003ePOST\u003c/code\u003e method with specific path parameters and authorization scopes documented.\u003c/p\u003e\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/v1alpha/{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)."]]
