メソッド: operations.cancel

長時間実行オペレーションの非同期キャンセルを開始します。サーバーはオペレーションをキャンセルするために最善の努力を行いますが、成功は保証されません。サーバーがこのメソッドをサポートしていない場合、サーバーから google.rpc.Code.UNIMPLEMENTED が返されます。クライアントは Operations.GetOperation または他のメソッドを使用して、キャンセルが成功したかどうか、あるいはキャンセルしたにもかかわらずオペレーションが完了したかどうかを確認できます。キャンセルが成功すると、そのオペレーションは削除されず、Operation.error の値を持つオペレーションになります。google.rpc.Status.code は 1 になります。これは Code.CANCELLED に相当します。

HTTP リクエスト

POST https://serviceusage.googleapis.com/v1/{name=operations/**}:cancel

この URL は Google API HTTP アノテーション構文を使用します。

パスパラメータ

パラメータ
name

string

キャンセルするオペレーション リソースの名前。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功すると、レスポンスの本文は空になります。

承認スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/service.management
  • https://www.googleapis.com/auth/cloud-platform

詳細については、認証の概要をご覧ください。