Method: projects.locations.sessions.list

Hier werden interaktive Sitzungen aufgelistet.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Pflichtangabe. Das übergeordnete Element, das dieser Sammlung von Sitzungen zugewiesen ist.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource parent erforderlich:

  • dataproc.sessions.list

Suchparameter

Parameter
pageSize

integer

Optional. Die maximale Anzahl von Sitzungen, die in jeder Antwort zurückgegeben werden sollen. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.
pageToken

string

Optional. Ein Seitentoken, das von einem vorherigen sessions.list-Aufruf empfangen wurde. Geben Sie dieses Token an, um die nachfolgende Seite abzurufen.
filter

string

Optional. Ein Filter für die Sitzungen, die in der Antwort zurückgegeben werden sollen.

Ein Filter ist ein logischer Ausdruck, der die Werte verschiedener Felder in jeder Sitzungsressource einschränkt. Bei Filtern wird die Groß- und Kleinschreibung berücksichtigt. Sie können mehrere Klauseln mit logischen Operatoren (AND, OR) enthalten. Unterstützte Felder sind sessionId, sessionUuid, state, createTime und labels.

Beispiel: state = ACTIVE and createTime < "2023-01-01T00:00:00Z" ist ein Filter für Sitzungen im Status „AKTIV“, die vor dem 01.01.2023 erstellt wurden. state = ACTIVE and labels.environment=production ist ein Filter für Sitzungen im Status „AKTIV“, die ein Label für die Produktionsumgebung haben.

Eine detaillierte Beschreibung der Filtersyntax und eine Liste der unterstützten Vergleichsoperatoren finden Sie unter https://google.aip.dev/assets/misc/ebnf-filtering.txt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Eine Liste interaktiver Sitzungen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "sessions": [
    {
      object (Session)
    }
  ],
  "nextPageToken": string
}
Felder
sessions[]

object (Session)

Nur Ausgabe. Die Sitzungen aus der angegebenen Sammlung.
nextPageToken

string

Ein Token, das als pageToken gesendet werden kann, um die nächste Seite abzurufen. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.