コレクション: projects.configs.operations

リソース: オペレーション

このリソースは、ネットワーク API 呼び出しの結果の長時間実行オペレーションを示します。

JSON 表現 
{
  "name": string,
  "metadata": {
    "@type": string,
    field1: ...,
    ...
  },
  "done": boolean,

  // Union field result can be only one of the following:
  "error": {
    object(Status)
  },
  "response": {
    "@type": string,
    field1: ...,
    ...
  },
  // End of list of possible types for union field result.
}
項目
name

string

サーバーによって割り当てられる名前で、その名前を最初に返した同じサービス内でのみ一意になります。デフォルトの HTTP マッピングを使用している場合、name は operations/some/unique/name の形式になります。

metadata

object

オペレーションに関連付けられているサービス固有のメタデータ。通常は進捗情報や、作成日時などの共通メタデータが含まれます。一部のサービスでは、このようなメタデータが提供されないこともあります。メタデータがある場合、長時間実行オペレーションを返すメソッドでは、メタデータの型をドキュメント化しておく必要があります。

任意のデータ型のフィールドを含むオブジェクト。タイプを識別する URI を含む追加フィールド "@type"。例: { "id": 1234, "@type": "types.example.com/standard/id" }。
done

boolean

値が false の場合は、操作が進行中であることを意味します。true の場合、オペレーションは完了しており、error または response が利用可能です。

Union フィールド result。オペレーションの結果。error または有効な response にすることができます。done == false の場合は、error と response のいずれも設定されません。done == true の場合は、error または response のいずれか 1 つが設定されます。result に設定できるのは次のいずれかのみです。
error

object(Status)

失敗またはキャンセルされた場合のエラー結果。

response

object

成功した場合はオペレーションの通常のレスポンス。元のメソッドで成功時にデータが返されない場合（Delete など）、この応答は google.protobuf.Empty です。元のメソッドが標準の Get/Create/Update である場合、レスポンスはリソースである必要があります。他のメソッドについては、レスポンスのデータ型が XxxResponse である必要があり、ここで Xxx は元のメソッド名です。たとえば、元のメソッド名が TakeSnapshot() であれば、推測される応答のデータ型は TakeSnapshotResponse になります。

任意のデータ型のフィールドを含むオブジェクト。タイプを識別する URI を含む追加フィールド "@type"。例: { "id": 1234, "@type": "types.example.com/standard/id" }。

メソッド

get

 長時間実行オペレーションの最新の状態を取得します。