Method: projects.locations.sessions.list

Muestra una lista de las sesiones interactivas.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El elemento superior, que es propietario de esta colección de sesiones.

La autorización requiere el siguiente permiso IAM en el recurso especificado parent:

  • dataproc.sessions.list

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. Es la cantidad máxima de sesiones que se mostrarán en cada respuesta. El servicio puede mostrar menos que este valor.

pageToken

string

Opcional. Es un token de página recibido de una llamada a sessions.list anterior. Proporciona este token para recuperar la página siguiente.

filter

string

Opcional. Es un filtro para que las sesiones se muestren en la respuesta.

Un filtro es una expresión lógica que restringe los valores de varios campos en cada recurso de sesión. Los filtros distinguen mayúsculas de minúsculas y pueden contener varias cláusulas combinadas con operadores lógicos (Y, O). Los campos admitidos son sessionId, sessionUuid, state, createTime y labels.

Ejemplo: state = ACTIVE and createTime < "2023-01-01T00:00:00Z" es un filtro para sesiones en un estado ACTIVE que se crearon antes del 1/1/2023. state = ACTIVE and labels.environment=production es un filtro para sesiones en un estado ACTIVE que tienen una etiqueta de entorno de producción.

Consulta https://google.aip.dev/assets/misc/ebnf-filtering.txt para obtener una descripción detallada de la sintaxis del filtro y una lista de los comparadores admitidos.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Una lista de sesiones interactivas.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "sessions": [
    {
      object (Session)
    }
  ],
  "nextPageToken": string
}
Campos
sessions[]

object (Session)

Solo salida. Las sesiones de la colección especificada.

nextPageToken

string

Es un token, que se puede enviar como pageToken, para recuperar la página siguiente. Si se omite este campo, no habrá páginas siguientes.

Alcances de autorización

Se requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.