Method: operations.cancel
Uzun süren bir işlemde eşzamansız iptal işlemini başlatır. Sunucu, işlemi iptal etmek için elinden geleni yapar ancak işlemin iptal edileceği garanti edilmez. Sunucu bu yöntemi desteklemiyorsa google.rpc.Code.UNIMPLEMENTED
döndürülür. İstemciler, iptal işleminin başarılı olup olmadığını veya iptal işlemine rağmen işlemin tamamlanıp tamamlanmadığını kontrol etmek için Operations.GetOperation
'ü veya başka yöntemler kullanabilir. İptal işlemi başarılı olduğunda işlem silinmez. Bunun yerine, Code.CANCELLED
değerine karşılık gelen 1
google.rpc.Status.code
değerine sahip bir Operation.error
değeri olan bir işlem haline gelir.
HTTP isteği
POST https://vault.googleapis.com/v1/{name=operations/**}:cancel
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler |
name |
string
İptal edilecek işlem kaynağının adı.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt metni boş bir JSON nesnesi olur.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/ediscovery
Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-02-06 UTC.
[null,null,["Son güncelleme tarihi: 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"]]