Method: projects.locations.collections.engines.controls.list

按父级 DataStore 列出所有控制变量。

HTTP 请求

GET https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/controls

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。数据存储区资源名称。格式：projects/{project}/locations/{location}/collections/{collectionId}/dataStores/{dataStoreId} 或 projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}。

查询参数

参数
pageSize

integer

可选。页面中结果的数量上限。如果未指定，则默认为 50。允许的最大值为 1000。
pageToken

string

可选。从之前的 controls.list 调用接收的页面令牌。利用其进行后续页面检索。
filter

string

可选。要应用于列表结果的过滤条件。支持的功能：

  • 如果未设置 filter，则列出父分支下的所有商品。目前不支持此字段。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 ListControlsResponse 实例。

授权范围

需要以下 OAuth 范围之一：

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

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

IAM 权限

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

  • discoveryengine.controls.list

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