Method: projects.locations.privateClouds.externalAddresses.patch

更新單一外部 IP 位址的參數。系統只會套用 updateMask 中指定的欄位。

作業處理期間,資源會暫時處於 ACTIVE 狀態,直到作業完全完成為止。在這段期間,您無法更新資源。使用作業狀態判斷處理程序何時完全完成。

HTTP 要求

PATCH https://vmwareengine.googleapis.com/v1/{externalAddress.name=projects/*/locations/*/privateClouds/*/externalAddresses/*}

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

路徑參數

參數
externalAddress.name

string

僅供輸出。ID。這個外部 IP 位址的資源名稱。資源名稱是無配置的 URI,遵循 https://cloud.google.com/apis/design/resource_names 中的慣例。例如:projects/my-project/locations/us-central1-a/privateClouds/my-cloud/externalAddresses/my-address

查詢參數

參數
updateMask

string (FieldMask format)

這是必要旗標,欄位遮罩用於指定更新作業要覆寫 ExternalAddress 資源中的哪些欄位。updateMask 中指定的欄位與資源相關,而非完整要求。如果欄位位於遮罩中,系統會覆寫該欄位。如果使用者未提供遮罩,系統會覆寫所有欄位。

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

requestId

string

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

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

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

要求主體

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

回應主體

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

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱Authentication Overview