Method: projects.locations.sessions.list

列出交互式会话。

HTTP 请求

GET https://dataproc.googleapis.com/v1/{parent=projects/*/locations/*}/sessions

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。拥有此会话集合的父级。

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

  • dataproc.sessions.list

查询参数

参数
pageSize

integer

可选。每个响应中返回的会话数量上限。服务返回的值可能小于此值。

pageToken

string

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

filter

string

可选。用于在响应中返回的会话的过滤条件。

过滤条件是一种逻辑表达式,用于约束每个会话资源中各个字段的值。过滤条件区分大小写,并且可以包含多个子句以及逻辑运算符(AND、OR)。支持的字段为 sessionIdsessionUuidstatecreateTimelabels

示例:state = ACTIVE and createTime < "2023-01-01T00:00:00Z" 是用于过滤 2023 年 1 月 1 日之前创建且处于“有效”状态的会话的过滤条件。state = ACTIVE and labels.environment=production 是用于过滤处于 ACTIVE 状态且具有生产环境标签的会话的过滤条件。

如需详细了解过滤条件语法以及受支持的比较运算符的列表,请参阅 https://google.aip.dev/assets/misc/ebnf-filtering.txt

请求正文

请求正文必须为空。

响应正文

交互式会话列表。

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

JSON 表示法
{
  "sessions": [
    {
      object (Session)
    }
  ],
  "nextPageToken": string
}
字段
sessions[]

object (Session)

仅限输出。指定集合中的会话。

nextPageToken

string

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

授权范围

需要以下 OAuth 范围:

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

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