Funktionen über Metadaten verwalten
Auf dieser Seite wird beschrieben, wie Sie einige Features von Vertex AI Workbench-Instanzen verwalten, indem Sie die Metadaten-Schlüssel/Wert-Paare der Instanz ändern.
Metadatenschlüssel
Informationen zu Features und den zugehörigen Metadatenschlüsseln finden Sie in der folgenden Tabelle.
Funktion | Beschreibung | Metadatenschlüssel | Gültige Werte und Standardeinstellungen |
---|---|---|---|
nbconvert |
Ermöglicht das Exportieren und Herunterladen von Notebooks als anderen Dateityp. |
notebook-disable-nbconvert |
|
Über Papierkorb löschen |
Verwendet das Papierkorbverhalten des Betriebssystems, wenn aus JupyterLab gelöscht wird. |
notebook-enable-delete-to-trash |
|
Dataproc |
Ermöglicht den Zugriff auf Dataproc-Kernels. Weitere Informationen finden Sie unter Dataproc-fähige Instanz erstellen. |
disable-mixer |
|
Herunterfahren bei Inaktivität |
Aktiviert das Herunterfahren bei Inaktivität. Weitere Informationen finden Sie unter Herunterfahren bei Inaktivität. |
idle-timeout-seconds |
Eine Ganzzahl, die die Inaktivitätszeit in Sekunden darstellt. Der Standardwert beträgt 10800 Sekunden (180 Minuten).
|
Benutzerdefinierter Jupyter-Nutzer |
Gibt den Namen des Jupyter-Standardnutzers an. Diese Einstellung bestimmt den Namen des Ordners für Ihre Notebooks. Anstelle des Standardverzeichnisses |
jupyter-user |
Ein String. Der Standardwert ist jupyter . |
Download von Dateien |
Ermöglicht das Herunterladen von Dateien aus JupyterLab. |
notebook-disable-downloads |
|
Root-Zugriff |
Aktiviert Root-Zugriff. |
notebook-disable-root |
|
Terminalzugriff |
Aktiviert den Terminalzugriff. |
notebook-disable-terminal |
|
Geplante Upgrades |
Plant automatische Upgrades der Instanz. |
notebook-upgrade-schedule |
Der von Ihnen festgelegte wöchentliche oder monatliche Zeitplan im Unix-Cron-Format, z. B. 00 19 * * MON bedeutet wöchentlich am Montag, um 19:00 Uhr Greenwich Mean Time (GMT).
Diese Funktion ist standardmäßig deaktiviert.
|
Post-Startskript |
Führt nach dem Start ein benutzerdefiniertes Skript aus. |
post-startup-script |
Der URI eines Post-Startscripts in Cloud Storage, z. B. gs://bucket/hello.sh . Diese Funktion ist standardmäßig deaktiviert.
|
Verhalten nach dem Startskript |
Definiert, wann und wie das Post-Startscript ausgeführt wird. |
post-startup-script-behavior |
|
Ereignisstatus melden |
Prüft den Zustand alle 30 Sekunden auf VM-Messwerte. |
report-event-health |
|
Von Compute Engine verwaltete Metadaten
Einige Metadatenschlüssel sind von Compute Engine vordefiniert. Weitere Informationen finden Sie unter Vordefinierte Metadatenschlüssel .
Geschützte Metadatenschlüssel
Einige Metadatenschlüssel sind für die Verwendung durch das System reserviert. Wenn Sie diesen Metadatenschlüsseln Werte zuweisen, werden die neuen Werte von den Systemwerten überschrieben.
Zu den reservierten Metadatenschlüsseln gehören unter anderem:
data-disk-uri
enable-oslogin
framework
notebooks-api
notebooks-api-version
nvidia-driver-gcs-path
proxy-url
restriction
shutdown-script
title
version
Instanz mit bestimmten Metadaten erstellen
Sie können eine Vertex AI Workbench-Instanz mit bestimmten Metadaten über die Google Cloud Console, die gcloud CLI, Terraform oder die Notebooks API erstellen:
Console
Wenn Sie eine Vertex AI Workbench-Instanz erstellen, können Sie unter Erweiterte Optionen im Abschnitt Umgebung Metadaten hinzufügen.
gcloud
Wenn Sie eine Vertex AI Workbench-Instanz erstellen, können Sie mit dem folgenden Befehl Metadaten hinzufügen.
gcloud workbench instances create INSTANCE_NAME --metadata=KEY=VALUE
Terraform
Zum Hinzufügen von Metadaten erstellen Sie die Ressource mit Metadaten-Schlüssel/Wert-Paaren.
Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.
Notebooks API
Verwenden Sie die Methode instances.create
mit Metadatenwerten, um die entsprechenden Features zu verwalten.
Metadaten einer Instanz aktualisieren
Sie können die Metadaten einer Vertex AI Workbench-Instanz über die Google Cloud Console, die Google Cloud CLI, Terraform oder die Notebooks API aktualisieren.
Console
Sie können die Metadaten einer Vertex AI Workbench-Instanz auf der Seite Details im Abschnitt Software und Sicherheit aktualisieren.
gcloud
Sie können die Metadaten auf einer Vertex AI Workbench-Instanz mit dem folgenden Befehl aktualisieren.
gcloud workbench instances update INSTANCE_NAME --metadata=KEY=VALUE
Terraform
Sie können die Metadaten-Schlüssel/Wert-Paare ändern, um die entsprechenden Features auf Vertex AI Workbench-Instanzen zu verwalten.
Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.
Notebooks API
Verwenden Sie die Methode instances.patch
mit Metadatenwerten und gce_setup.metadata
in updateMask
, um die entsprechenden Features zu verwalten.
Metadaten aus einer Instanz entfernen
Sie können Metadaten mithilfe der Google Cloud Console, der Google Cloud CLI, Terraform oder der Notebooks API aus einer Vertex AI Workbench-Instanz entfernen.
Console
Sie können Metadaten aus einer Vertex AI Workbench-Instanz im Abschnitt Software und Sicherheit auf der Seite Details entfernen.
gcloud
Mit dem folgenden Befehl können Sie Metadaten aus einer Vertex AI Workbench-Instanz entfernen.
gcloud workbench instances update INSTANCE_NAME --metadata=KEY=
Terraform
Sie können Metadaten-Schlüssel/Wert-Paare entfernen, um die entsprechenden Features einer Vertex AI Workbench-Instanz zu verwalten.
Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.
Notebooks API
Verwenden Sie die Methode instances.patch
, bei der der Metadatenwert auf einen leeren String festgelegt ist, und gce_setup.metadata
in updateMask
, um das entsprechende Feature zu entfernen.