Method: projects.locations.flags.create

建立新旗標。

HTTP 要求

POST https://saasservicemgmt.googleapis.com/v1beta1/{parent=projects/*/locations/*}/flags

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

路徑參數

參數
parent

string

這是必要旗標,旗幟的父項。

查詢參數

參數
flagId

string

這是必要旗標,新旗標的 ID 值。

validateOnly

boolean

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

requestId

string

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

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

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

要求主體

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

回應主體

如果成功,回應主體會包含新建立的 Flag 執行個體。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱Authentication Overview