Laufzeitvorlagen verwalten

Laufzeitvorlagen verwalten

Auf dieser Seite wird beschrieben, wie Sie eine Colab Enterprise-Laufzeitvorlage verwalten, einschließlich der folgenden Aufgaben:

• Laufzeitvorlage bearbeiten
• Laufzeitvorlage löschen

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die Colab Enterprise Admin (roles/aiplatform.colabEnterpriseAdmin) IAM-Rolle für das Projekt zuzuweisen, damit Sie die Berechtigungen zum Verwalten einer Colab Enterprise-Laufzeitvorlage erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Mindestens eine der erforderlichen Rollen enthält die dataform.repositories.list Berechtigung. Nutzer, denen die Berechtigung dataform.repositories.list oder die Rolle Code-Ersteller (roles/dataform.codeCreator) in einem Projekt gewährt wurde, können die Namen von Code-Assets in diesem Projekt mit der Dataform API oder der Dataform-Befehlszeile verwenden. Nicht-Administratoren, die BigQuery Studio verwenden, sehen nur Code-Assets, die sie erstellt haben oder für sie freigegeben wurden.

Laufzeitvorlage bearbeiten

Sie können einige der Spezifikationen Ihrer Laufzeitvorlage ändern, einschließlich der Python-Version und der Konfiguration des Verschlüsselungsschlüssels. Änderungen an der Laufzeitvorlage wirken sich nur auf neu erstellte Laufzeiten aus dieser Vorlage aus.

Sie können eine Laufzeitvorlage in der Google Cloud Console oder mit der REST API bearbeiten.

Console

So bearbeiten Sie eine Laufzeitvorlage:

1. Rufen Sie in der Google Cloud Console die Seite Laufzeitvorlagen von Colab Enterprise auf.

   Zu Laufzeitvorlagen

2. Wählen Sie im Menü Region die Region aus, in der sich Ihre Laufzeitvorlage befindet.

3. Klicken Sie in der Spalte ID auf die ID-Nummer der Laufzeitvorlage die Sie bearbeiten möchten.

4. Klicken Sie auf  Bearbeiten.

5. Nehmen Sie im Bereich Laufzeitvorlage bearbeiten Änderungen an der Laufzeitvorlage vor.

6. Klicken Sie auf Aktualisieren.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• REGION: die Region, in der sich Ihre Laufzeitvorlage befindet.
• PROJECT_ID: Ihre Projekt-ID.
• NOTEBOOK_RUNTIME_TEMPLATE_ID: die ID Ihrer Laufzeitvorlage.
• RELEASE_NAME: der Release-Name des Images, das Sie verwenden möchten. py311 ist beispielsweise der Release-Name für das Python 3.11-Image. Wenn Sie das Image auf Latest festlegen möchten, lassen Sie RELEASE_NAME leer.

HTTP-Methode und URL:

PATCH https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name

JSON-Text der Anfrage:

{
  softwareConfig: {
    colabImage: {
      releaseName: "RELEASE_NAME"
    }
  }
}

Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name"

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimeTemplates/NOTEBOOK_RUNTIME_TEMPLATE_ID?updateMask=software_config.colab_image.release_name" | Select-Object -Expand Content

Bei erfolgreicher Ausführung enthält der Antworttext eine Instanz von Operation.

Informationen zu den verfügbaren Abfrageparametern finden Sie in der notebookRuntimeTemplates.patch REST API Dokumentation.

Laufzeitvorlage löschen

Sie können eine Laufzeitvorlage in der Google Cloud Console, mit der gcloud CLI oder mit der REST API löschen.

Console

So löschen Sie eine Laufzeitvorlage:

1. Rufen Sie in der Google Cloud Console die Seite Laufzeitvorlagen von Colab Enterprise auf.

   Zu Laufzeitvorlagen

2. Wählen Sie im Menü Region die Region aus, in der sich Ihre Laufzeitvorlage befindet.

3. Wählen Sie die Laufzeitvorlage aus, die Sie löschen möchten.

4. Klicken Sie auf  Löschen.

5. Klicken Sie auf Bestätigen.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• RUNTIME_ID: die ID Ihrer Laufzeit.
• PROJECT_ID: Ihre Projekt-ID.
• REGION: die Region, in der sich Ihre Laufzeit befindet.

Führen Sie den folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud colab runtimes delete RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud colab runtimes delete RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu entweder gcloud init; oder gcloud auth login und gcloud config set project aus.

gcloud colab runtimes delete RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Weitere Informationen zum Befehl zum Löschen einer Laufzeitvorlage über die Befehlszeile finden Sie in der gcloud CLI Dokumentation.

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• REGION: die Region, in der sich Ihre Laufzeit befindet.
• PROJECT_ID: Ihre Projekt-ID.
• RUNTIME_ID: die ID Ihrer Laufzeit.

HTTP-Methode und URL:

DELETE https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID"

PowerShell

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie diesen Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID" | Select-Object -Expand Content

Bei erfolgreicher Ausführung enthält der Antworttext eine Instanz von Operation.

Weitere Informationen finden Sie in der notebookRuntimeTemplates.delete REST API Dokumentation.

Nächste Schritte

• Weitere Informationen zu Laufzeiten und Laufzeitvorlagen.
• Laufzeit erstellen