Auth aktualisieren

Version 4.0.23.4

API-Sitzung aktualisieren

API-Sitzung – Arbeitsbereich

Mit diesem Endpunkt können Sie den aktiven Arbeitsbereich für die aktuelle API-Sitzung ändern.

Pro Sitzung kann nur ein Arbeitsbereich aktiv sein. Der aktive Arbeitsbereich kann beliebig oft in einer Sitzung geändert werden.

Der Standardarbeitsbereich für API-Sitzungen ist der Arbeitsbereich „Produktion“.

Alle Looker APIs, die Projekte oder Lookml-Modelle verwenden (z. B. laufende Abfragen), verwenden die Version dieses Projekt- und Modelldateien, die während der gesamten Dauer der aktuellen API-Sitzung definiert ist, oder bis der Sitzungsarbeitsbereich wieder geändert wird.

Eine API-Sitzung hat dieselbe Lebensdauer wie das Zugriffstoken, das zur Authentifizierung von API-Anfragen verwendet wird. Bei jeder erfolgreichen API-Anmeldung werden ein neues Zugriffstoken und eine neue API-Sitzung generiert.

Wenn Ihre Looker API-Clientanwendung in mehreren API-Sitzungen in einem Entwicklerarbeitsbereich muss, müssen Sie den Entwicklungsarbeitsbereich nach jeder Anmeldung auswählen.

Anfrage

PATCH /Sitzung
Datentyp
Beschreibung
Anfrage
HTTPRequest
body
HTTP-Text
HTTPBody-Definition maximieren...
body
Auth
ApiSession-Definition maximieren...
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
Arbeitsbereich_ID
String
Die ID des aktiven Arbeitsbereichs für diese Sitzung
Sudo-User-ID
String
Die ID des tatsächlichen Nutzers, falls diese Sitzung einen anderen Nutzer als einen anderen Nutzer darstellt

Antwort

200: Authentifizierung

Datentyp
Beschreibung
(Objekt)
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
Arbeitsbereich_ID
String
Die ID des aktiven Arbeitsbereichs für diese Sitzung
Sudo-User-ID
String
Die ID des tatsächlichen Nutzers, falls diese Sitzung einen anderen Nutzer als einen anderen Nutzer darstellt

400: Ungültige Anfrage

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

404: Nicht gefunden

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

422: Validierungsfehler

Datentyp
Beschreibung
nachricht
String
Fehlerdetails
ValidationErrorDetail-Definition maximieren...
Feld
String
Feld mit Fehler
Code
String
Fehlercode
nachricht
String
Fehlermeldung
Dokumentations-URL
String
Link zur Dokumentation
Dokumentations-URL
String
Link zur Dokumentation

429: Zu viele Anfragen

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

Beispiele