在指定專案和位置建立新的調查。
HTTP 要求
POST https://geminicloudassist.googleapis.com/v1alpha/{parent=projects/*/locations/*}/investigations
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 | |
|---|---|
parent |
這是必要旗標，父項的值。 |
查詢參數
| 參數 | |
|---|---|
investigationId |
(選用步驟) 用於調查的 ID，會成為調查資源名稱的最終元件。 這個值的長度應為 4 至 63 個字元，有效字元為 /[a-z][0-9]-/。 如果未提供，伺服器會為調查產生專屬 ID。 |
requestId |
(選用步驟) (選用) 用於識別要求的 ID。指定專屬要求 ID，這樣一來，如果必須重試要求，伺服器就會知道要忽略已完成的要求。伺服器會保證至少在第一次要求後的 60 分鐘內， 舉例來說，假設您提出初始要求，但要求逾時。如果您使用相同要求 ID 再次提出要求，伺服器會檢查是否已收到具有相同要求 ID 的原始作業，如果已收到，就會忽略第二次要求。這樣可避免用戶端不慎建立重複的承諾。 要求 ID 必須是有效的 UUID，但系統不支援零 UUID (00000000-0000-0000-0000-000000000000)。 |
要求主體
要求主體包含 Investigation 的執行個體。
回應主體
如果成功，回應主體會包含新建立的 Investigation 執行個體。
授權範圍
需要下列 OAuth 範圍：
https://www.googleapis.com/auth/cloud-platform
詳情請參閱Authentication Overview。
IAM 權限
需要 parent 資源的下列 IAM 權限：
geminicloudassist.investigations.create
詳情請參閱 IAM 說明文件。