長時間実行オペレーションの非同期キャンセルを開始します。サーバーはオペレーションをキャンセルするために最善の努力を行いますが、成功は保証されません。サーバーがこのメソッドをサポートしていない場合、サーバーからは google.rpc.Code.UNIMPLEMENTED
が返されます。クライアントは Operations.GetOperation
などのメソッドを使用して、キャンセルが成功したかどうか、あるいはキャンセルしたにもかかわらずオペレーションが完了したかどうかを確認できます。キャンセルが成功すると、そのオペレーションは削除されず、Operation.error
値を持つオペレーションになり、google.rpc.Status.code
が 1 になります。これは、Code.CANCELLED
に相当します。
HTTP リクエスト
POST https://cloudchannel.googleapis.com/v1/{name=operations/**}:cancel
この URL は Google API HTTP アノテーション構文を使用します。
パスパラメータ
パラメータ | |
---|---|
name |
キャンセルするオペレーション リソースの名前。 |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功すると、レスポンスの本文は空になります。
承認スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/apps.order
詳細については、認証の概要をご覧ください。