Method: projects.locations.sampleQuerySets.sampleQueries.create

创建 SampleQuery

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。父级资源名称，例如 projects/{project}/locations/{location}/sampleQuerySets/{sampleQuerySet}。

查询参数

参数
sampleQueryId

string

必需。要用于 SampleQuery 的 ID，该 ID 将成为 SampleQuery.name 的最后一个组成部分。

如果调用方没有创建 SampleQuery 的权限，无论该 SampleQuery 是否存在，都会返回 PERMISSION_DENIED 错误。

此字段在具有相同 parent 的所有 SampleQuery 中必须是唯一的。否则，系统将返回 ALREADY_EXISTS 错误。

此字段必须符合 RFC-1034 标准，且长度上限为 63 个字符。否则，系统将返回 INVALID_ARGUMENT 错误。

请求正文

请求正文包含一个 SampleQuery 实例。

响应正文

如果成功，响应正文将包含一个新创建的 SampleQuery 实例。

授权范围

需要以下 OAuth 范围之一：

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

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • discoveryengine.sampleQueries.create

如需了解详情，请参阅 IAM 文档。