Method: projects.locations.networkPeerings.patch

修改 NetworkPeering 資源。只能更新 description 欄位。系統只會套用 updateMask 中指定的欄位。NetworkPeering 是全球資源,位置只能是全球。

HTTP 要求

PATCH https://vmwareengine.googleapis.com/v1/{networkPeering.name=projects/*/locations/*/networkPeerings/*}

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

路徑參數

參數
networkPeering.name

string

僅供輸出。ID。網路對等互連的資源名稱。NetworkPeering 是全球資源,位置只能是全球。資源名稱是不含結構定義的 URI,遵循 https://cloud.google.com/apis/design/resource_names 中的慣例。例如:projects/my-project/locations/global/networkPeerings/my-peering

查詢參數

參數
updateMask

string (FieldMask format)

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

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

requestId

string

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

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

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

要求主體

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

回應主體

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

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱Authentication Overview