Method: projects.locations.unitOperations.patch

更新單一單元作業。

HTTP 要求

PATCH https://saasservicemgmt.googleapis.com/v1/{unitOperation.name=projects/*/locations/*/unitOperations/*}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
unitOperation.name

string

ID。資源名稱 (資源的完整 URI)，遵循標準命名架構：

"projects/{project}/locations/{location}/unitOperations/{unitOperation}"

查詢參數

參數
validateOnly

boolean

如果「validateOnly」設為 true，服務會嘗試驗證這項要求是否會成功，但不會實際進行變更。
requestId

string

用於識別要求的選用要求 ID。指定專屬要求 ID，這樣一來，如果必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內，

舉例來說，假設您提出初始要求，但要求逾時。如果使用相同要求 ID 再次提出要求，伺服器可以檢查是否已收到具有相同要求 ID 的原始作業，如果已收到，就會忽略第二次要求。避免客戶不慎建立重複的承諾。

要求 ID 必須是有效的 UUID，但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。
updateMask

string (FieldMask format)

欄位遮罩用於指定更新作業要覆寫 UnitOperation 資源中的哪些欄位。

updateMask 中指定的欄位與資源相關，而非完整要求。如果欄位位於遮罩中，系統會覆寫該欄位。

如果使用者未提供遮罩，系統會覆寫 UnitOperation 中的所有欄位。

這是以半形逗號分隔的完整欄位名稱清單，範例："user.displayName,photo"。

要求主體

要求主體包含 UnitOperation 的執行個體。

回應主體

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱Authentication Overview。

IAM 權限

需要 name 資源的下列 IAM 權限：

  • saasservicemgmt.unitOperations.update

詳情請參閱 IAM 說明文件。