REST Resource: projects.locations.operations

資源：Operation

這個資源表示屬於網路 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/{uniqueId} 結尾的資源名稱。
metadata

object

{

createTime：作業的建立時間。

endTime：作業執行完成的時間。

target：作業目標的伺服器定義資源路徑。

verb：作業執行的動詞名稱。

statusDetail：作業狀態 (如有)，使用者可自然閱讀。

cancelRequested：識別使用者是否要求取消作業。成功取消的作業會擁有 Operation.error 值，且 google.rpc.Status.code 為 1 (也就是 Code.CANCELLED)。

apiVersion：用於啟動作業的 API 版本。

}
done

boolean

如果值為 false，代表作業仍在執行中。如果值為 true，代表作業已執行完畢，系統會顯示 error 或 response 的執行結果。
聯集欄位 result。這是作業的執行結果，可能為 error，或是有效的 response。如果 done == false，系統不會將結果設定為 error，也不會設定為 response。如果 done == true，系統會將結果設定為 error 或 response。部分服務可能不會提供結果。result 只能是下列其中一個設定：
error

object (Status)

作業執行失敗或遭到取消時，所顯示的錯誤結果。
response

object

作業執行成功時的一般回應。如果原始方法在執行成功時沒有傳回資料 (例如 Delete)，則回應為 google.protobuf.Empty。如果原始方法是標準的 Get/Create/Update，回應則應該為資源。如果是其他方法，回應必須包含類型 XxxResponse，其中 Xxx 是原始方法的名稱。舉例來說，如果原始方法的名稱為 TakeSnapshot()，您就能推測出回應類型應該是 TakeSnapshotResponse。

方法

cancel

 開始以非同步的方式，取消長時間執行的作業。

delete

 刪除長時間執行的作業。

get

 取得長時間執行的作業的最新狀態。

list

 列出符合要求中指定篩選器的作業。