Projekt aktualisieren

Version 3.1.23.2

Projektkonfiguration aktualisieren

Wenden Sie Änderungen an der Konfiguration eines Projekts an.

Git für ein Projekt konfigurieren

So richten Sie ein Looker-Projekt mit einem Remote-Git-Repository ein:

  1. Rufen Sie update_session auf, um den Arbeitsbereich „dev“ auszuwählen.
  2. Rufen Sie create_git_deploy_key auf, um einen neuen Bereitstellungsschlüssel für das Projekt zu erstellen
  3. Kopieren Sie den Text des Bereitstellungsschlüssels in die SSH-Schlüsselkonfiguration des Remote-Git-Repositorys
  4. Rufen Sie update_project auf, um git_remote_url () und git_service_name für das Projekt festzulegen.

Wenn Sie die git_remote_url eines Projekts ändern, stellt Looker eine Verbindung zum Remote-Repository her, um Metadaten abzurufen. Das Remote-Git-Repository MUSS mit dem von Looker generierten Bereitstellungsschlüssel für dieses Projekt konfiguriert werden, bevor git_remote_url des Projekts festgelegt wird.

So richten Sie ein Looker-Projekt mit einem Git-Repository auf dem Looker-Server ein („git“-Repository):

  1. Rufen Sie update_session auf, um den Arbeitsbereich „dev“ auszuwählen.
  2. Rufen Sie update_project auf, um git_remote_url auf null zu setzen und git_service_name auf „bar“.

Anfrage

PATCH /projects/{project_id}
Datentyp
Beschreibung
Anfrage
HTTPRequest
Pfad
HTTPPath
HTTPPath-Definition maximieren...
project_id
String
Projekt-ID
body
HTTP-Text
HTTPBody-Definition maximieren...
body
Projekt
Projektdefinition maximieren...
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
id
String
Projekt-ID
name
String
Anzeigename des Projekts
verwendet_git
boolean
Bei „true“ wurde das Projekt mit einem Git-Repository konfiguriert
Git_Remote_URL
String
URL des Git-Remote-Repositorys
Git-Nutzername
String
Git-Nutzername für die HTTPS-Authentifizierung. (Nur für die Produktion, wenn Nutzerattribute verwendet werden.)
Git-Passwort
String
(Nur-Schreibzugriff) Git-Passwort für die HTTPS-Authentifizierung. (Nur für die Produktion, wenn Nutzerattribute verwendet werden.)
Git_Production-Zweigname
String
Name der Git-Produktionszweig: Die Standardeinstellung ist „Master“. Wird nur in Looker 21.0 und höher unterstützt.
Verwendung von „git_cookie_auth“
boolean
Bei „true“ verwendet das Projekt ein Git-Cookie für die Authentifizierung.
„git_username_user_attribute“
String
Nutzerattributname für den Nutzernamen in der HTTPS-Authentifizierung pro Nutzer.
„git_password_user_attribute“
String
Nutzerattributname für das Passwort in der HTTPS-Authentifizierung pro Nutzer.
Git_Service_Name
String
Name des Git-Dienstanbieters
Git_Application_Server_http_Port
integer
Port, auf dem der HTTP(S)-Server ausgeführt wird (für PRs, Dateisuche usw.)
Git_Application_Server_http_Schema
String
Schema, das auf dem Nameserver ausgeführt wird (für PRs, Dateisuche usw.)
Secret bereitstellen
String
(Nur Schreibzugriff) Optionales geheimes Token, mit dem Anfragen an den Webhook-Bereitstellungsendpunkt authentifiziert werden. Wenn dies nicht festgelegt ist, ist der Endpunkt nicht authentifiziert.
Nicht festgelegt_deploy_secret
boolean
(Nur Schreibzugriff) Wenn für „true“ festgelegt, wird die Bereitstellung des Secrets beendet, um nicht authentifizierten Zugriff auf den Webhook-Endpunkt der Bereitstellung zu ermöglichen.
Pull-Modus "Anfrage"
String
Die Richtlinie für die Git-Pull-Anfrage für dieses Projekt. Gültige Werte sind: „off“, „links“, „recommended“ und „required“.
Validierung_erforderlich
boolean
Validierungsrichtlinie: Wenn dieser Wert auf „true“ gesetzt ist, muss das Projekt die Validierungsprüfungen bestehen, bevor Projektänderungen an das Git-Repository übergeben werden können
Git_release_mgmt_enabled
boolean
Bei "true" ist die erweiterte Git-Releaseverwaltung für dieses Projekt aktiviert
allow_warnings
boolean
Validierungsrichtlinie: Wenn "true", kann für das Projekt ein Commit mit Warnungen durchgeführt werden, wenn "validierung_required" wahr ist. „allow_warnings“ löst nichts aus, wenn „validierung_required“ auf „false“ festgelegt ist.
Ist_Beispiel
boolean
Bei „true“ ist das Projekt ein Beispielprojekt und kann nicht geändert werden
Abfrage
HTTP-Abfrage
HTTPQuery-Definition maximieren...
Felder
String
Angeforderte Felder

Antwort

200: Projekt

Datentyp
Beschreibung
(Objekt)
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
id
String
Projekt-ID
name
String
Anzeigename des Projekts
verwendet_git
boolean
Bei „true“ wurde das Projekt mit einem Git-Repository konfiguriert
Git_Remote_URL
String
URL des Git-Remote-Repositorys
Git-Nutzername
String
Git-Nutzername für die HTTPS-Authentifizierung. (Nur für die Produktion, wenn Nutzerattribute verwendet werden.)
Git-Passwort
String
(Nur-Schreibzugriff) Git-Passwort für die HTTPS-Authentifizierung. (Nur für die Produktion, wenn Nutzerattribute verwendet werden.)
Git_Production-Zweigname
String
Name der Git-Produktionszweig: Die Standardeinstellung ist „Master“. Wird nur in Looker 21.0 und höher unterstützt.
Verwendung von „git_cookie_auth“
boolean
Bei „true“ verwendet das Projekt ein Git-Cookie für die Authentifizierung.
„git_username_user_attribute“
String
Nutzerattributname für den Nutzernamen in der HTTPS-Authentifizierung pro Nutzer.
„git_password_user_attribute“
String
Nutzerattributname für das Passwort in der HTTPS-Authentifizierung pro Nutzer.
Git_Service_Name
String
Name des Git-Dienstanbieters
Git_Application_Server_http_Port
integer
Port, auf dem der HTTP(S)-Server ausgeführt wird (für PRs, Dateisuche usw.)
Git_Application_Server_http_Schema
String
Schema, das auf dem Nameserver ausgeführt wird (für PRs, Dateisuche usw.)
Secret bereitstellen
String
(Nur Schreibzugriff) Optionales geheimes Token, mit dem Anfragen an den Webhook-Bereitstellungsendpunkt authentifiziert werden. Wenn dies nicht festgelegt ist, ist der Endpunkt nicht authentifiziert.
Nicht festgelegt_deploy_secret
boolean
(Nur Schreibzugriff) Wenn für „true“ festgelegt, wird die Bereitstellung des Secrets beendet, um nicht authentifizierten Zugriff auf den Webhook-Endpunkt der Bereitstellung zu ermöglichen.
Pull-Modus "Anfrage"
String
Die Richtlinie für die Git-Pull-Anfrage für dieses Projekt. Gültige Werte sind: „off“, „links“, „recommended“ und „required“.
Validierung_erforderlich
boolean
Validierungsrichtlinie: Wenn dieser Wert auf „true“ gesetzt ist, muss das Projekt die Validierungsprüfungen bestehen, bevor Projektänderungen an das Git-Repository übergeben werden können
Git_release_mgmt_enabled
boolean
Bei "true" ist die erweiterte Git-Releaseverwaltung für dieses Projekt aktiviert
allow_warnings
boolean
Validierungsrichtlinie: Wenn "true", kann für das Projekt ein Commit mit Warnungen durchgeführt werden, wenn "validierung_required" wahr ist. „allow_warnings“ löst nichts aus, wenn „validierung_required“ auf „false“ festgelegt ist.
Ist_Beispiel
boolean
Bei „true“ ist das Projekt ein Beispielprojekt und kann nicht geändert werden

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

409: Ressource ist bereits vorhanden

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

500: Serverfehler

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