Method: projects.locations.sessions.list

Liste les sessions interactives.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Élément parent qui possède cette collection de sessions.

L'autorisation IAM suivante est requise pour la ressource parent indiquée :

  • dataproc.sessions.list

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Nombre maximal de sessions à renvoyer dans chaque réponse. Le service peut renvoyer un nombre inférieur à cette valeur.

pageToken

string

Facultatif. Jeton de page reçu d'un appel sessions.list précédent. Fournissez ce jeton pour récupérer la page suivante.

filter

string

Facultatif. Filtre pour les sessions à renvoyer dans la réponse.

Un filtre est une expression logique qui limite les valeurs de divers champs dans chaque ressource de session. Les filtres sont sensibles à la casse et peuvent contenir plusieurs clauses combinées à des opérateurs logiques (AND, OR). Les champs acceptés sont sessionId, sessionUuid, state, createTime et labels.

Exemple: state = ACTIVE and createTime < "2023-01-01T00:00:00Z" est un filtre pour les sessions en état ACTIVE créées avant le 1er janvier 2023. state = ACTIVE and labels.environment=production est un filtre pour les sessions en état ACTIVE qui disposent d'un libellé d'environnement de production.

Pour obtenir une description détaillée de la syntaxe des filtres et une liste des comparateurs compatibles, consultez la page https://google.aip.dev/assets/misc/ebnf-filtering.txt.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Liste des sessions interactives.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON
{
  "sessions": [
    {
      object (Session)
    }
  ],
  "nextPageToken": string
}
Champs
sessions[]

object (Session)

Uniquement en sortie. Sessions de la collection spécifiée.

nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.