Method: operations.cancel
Bắt đầu huỷ không đồng bộ trên một thao tác chạy trong thời gian dài. Máy chủ sẽ cố gắng hết sức để huỷ thao tác, nhưng không đảm bảo sẽ huỷ thành công. Nếu không hỗ trợ phương thức này, máy chủ sẽ trả về google.rpc.Code.UNIMPLEMENTED. Ứng dụng có thể sử dụng Operations.GetOperation hoặc các phương thức khác để kiểm tra xem thao tác huỷ có thành công hay không hoặc liệu thao tác có hoàn tất mặc dù đã huỷ hay không. Khi huỷ thành công, thao tác sẽ không bị xoá; thay vào đó, thao tác đó sẽ trở thành một thao tác có giá trị Operation.error với google.rpc.Status.code là 1, tương ứng với Code.CANCELLED.
Yêu cầu HTTP
POST https://vault.googleapis.com/v1/{name=operations/**}:cancel
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số |
name |
string
Tên của tài nguyên thao tác cần huỷ.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ là một đối tượng JSON trống.
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/ediscovery
Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-02-06 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-02-06 UTC."],[[["Initiates the cancellation process for a long-running operation, although cancellation success is not guaranteed."],["Uses the `POST` method with a specific URL structure including the operation name for cancellation."],["Requires an empty request body and returns an empty response body upon successful cancellation."],["In case of unsupported cancellation by the server, an `UNIMPLEMENTED` error code is returned."],["If cancelled successfully, the operation is not deleted but marked with a `CANCELLED` status code."]]],["This document details the process of initiating asynchronous cancellation for a long-running operation. It uses an HTTP POST request to `vault.googleapis.com/v1/{name=operations/**}:cancel`. The `name` parameter specifies the operation to cancel. The request body must be empty, and a successful response returns an empty JSON object. The server attempts cancellation, and clients can check the status via `Operations.GetOperation`. Successful cancellation results in an `Operation.error` with `Code.CANCELLED`. Authorization requires the `https://www.googleapis.com/auth/ediscovery` OAuth scope.\n"]]
