Method: projects.locations.services.list

列出项目和位置中的服务。

HTTP 请求

GET https://metastore.googleapis.com/v1beta/{parent}/services

路径参数

参数
parent

string

必需。要列出的 Metastore 服务所在位置的相对资源名称,采用以下格式:

projects/{projectNumber}/locations/{locationId}

必须对指定的资源 parent 具有以下 IAM 权限才能进行授权:

  • metastore.services.list

查询参数

参数
pageSize

integer

可选。要返回的服务的最大数量。响应中包含的数量可能少于上限。如果未指定,则最多返回 500 项服务。最大值为 1,000;大于 1,000 的值会更改为 1,000。

pageToken

string

可选。从之前的 DataprocMetastore.ListServices 调用接收的页面令牌。提供此令牌以检索后续页面。

如需检索第一页,请提供空的页面令牌。

进行分页时,提供给 DataprocMetastore.ListServices 的其他参数必须与提供页面令牌的调用匹配。

filter

string

可选。要应用于列表结果的过滤条件。

orderBy

string

可选。指定结果的排序,如排序顺序中所述。如果未指定,结果将按默认顺序排序。

请求正文

请求正文必须为空。

响应正文

DataprocMetastore.ListServices 的响应消息。

如果成功,响应正文将包含结构如下的数据:

JSON 表示法
{
  "services": [
    {
      object (Service)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
字段
services[]

object (Service)

指定位置的服务。

nextPageToken

string

可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段,则不存在后续页面。

unreachable[]

string

无法到达的位置。

授权范围

需要以下 OAuth 范围:

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

如需了解详情,请参阅身份验证概览