Method: projects.locations.applications.drafts.create

在指定的專案和位置中建立新草稿。

HTTP 要求

POST https://{endpoint}/v1/{parent=projects/*/locations/*/applications/*}/drafts

其中 {endpoint}支援的服務端點之一。

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

路徑參數

參數
parent

string

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

查詢參數

參數
draftId

string

這是必要旗標,要求物件的 ID。

requestId

string

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

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

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

要求主體

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

回應主體

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

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱驗證總覽一文。