Method: projects.locations.sampleQuerySets.create

建立 SampleQuerySet

HTTP 要求

POST https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}/sampleQuerySets

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

路徑參數

參數
parent

string

這是必要旗標，父項資源名稱，例如 projects/{project}/locations/{location}。

查詢參數

參數
sampleQuerySetId

string

這是必要旗標，用於 SampleQuerySet 的 ID，會成為 SampleQuerySet.name 的最終元件。

如果呼叫者沒有建立 SampleQuerySet 的權限 (無論該檔案是否存在)，系統都會傳回 PERMISSION_DENIED 錯誤。

這個欄位在所有具有相同 parent 的 SampleQuerySet 中不得重複。否則，系統會傳回 ALREADY_EXISTS 錯誤。

這個欄位必須符合 RFC-1034 標準，長度上限為 63 個字元。否則，系統會傳回 INVALID_ARGUMENT 錯誤。

要求主體

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

回應主體

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

授權範圍

需要下列其中一種 OAuth 範圍：

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

詳情請參閱Authentication Overview。

IAM 權限

需要 parent 資源的下列 IAM 權限：

  • discoveryengine.sampleQuerySets.create

詳情請參閱 IAM 說明文件。