Method: projects.operations.wait

等待指定的長時間執行作業完成,或是最多等到指定的逾時時間為止,並傳回最新狀態。如果作業已經完成,系統會立刻傳回最新狀態。如果指定的逾時時間比預設的 HTTP/RPC 逾時時間還要長,則會使用 HTTP/RPC 逾時時間。如果伺服器不支援這個方法,則會傳回 google.rpc.Code.UNIMPLEMENTED。請注意,這個方法會盡可能完成作業。由於它可能會在作業達到指定的逾時時間 (包含立即) 之前就傳回最新狀態,因此就算您立即收到回應,也不代表作業已經完成。

HTTP 要求

POST https://{TRANSLATION_GDC_ENDPOINT}/v3/{name}:wait

路徑參數

參數
name

string

要等待的作業資源名稱。

要求主體

要求主體包含下列結構的資料:

JSON 表示法
{
  "timeout": string
}
欄位
timeout

string (Duration format)

逾時前的等待時間上限。如果留空,系統最多會等待基本 HTTP/RPC 通訊協定允許的時間。如果同時指定了 RPC 內容期限,則系統會採用較短的期限。

時間長度以秒為單位,最多可有 9 個小數位數,並應以「s」結尾,例如:"3.5s"

回應主體

如果成功,回應主體會包含 Operation 的執行個體。

授權範圍

需要下列其中一種 OAuth 範圍:

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