Gestisci i modelli di runtime

Questa pagina descrive come gestire un modello di runtime Colab Enterprise, incluse le seguenti attività:

  • Modifica un template di runtime.
  • Elimina un modello di runtime.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire un modello di runtime Colab Enterprise, chiedi all'amministratore di concederti il ruolo IAM Colab Enterprise Admin (roles/aiplatform.colabEnterpriseAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Modificare un template di runtime

Puoi apportare modifiche ad alcune specifiche del modello di runtime, inclusa la versione di Python e la configurazione della chiave di crittografia. Qualsiasi modifica apportata al modello di runtime viene applicata solo ai runtime appena creati da questo modello.

Per modificare un modello di runtime, puoi utilizzare la console Google Cloud o l'API REST.

Console

Per modificare un modello di runtime:

  1. Nella console Google Cloud , vai alla pagina Modelli di runtime di Colab Enterprise.

    Vai a Modelli di runtime

  2. Nel menu Regione, seleziona la regione che contiene il modello di runtime.

  3. Nella colonna ID, fai clic sul numero ID del modello di runtime che vuoi modificare.

  4. Fai clic su  Modifica.

  5. Nel riquadro Modifica template di runtime, apporta modifiche al template di runtime.

  6. Fai clic su Aggiorna.

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • REGION: la regione in cui si trova il modello di runtime.
  • PROJECT_ID: il tuo ID progetto.
  • NOTEBOOK_RUNTIME_TEMPLATE_ID: l'ID del modello di runtime.
  • RELEASE_NAME: il nome della release dell'immagine che vuoi utilizzare. Ad esempio, py311 è il nome della release per l'immagine Python 3.11. Per impostare l'immagine su Latest, lascia vuoto il campo RELEASE_NAME.

Metodo HTTP e 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

Corpo JSON della richiesta: 

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente: 

$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
In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Per informazioni sui parametri di ricerca disponibili, consulta la documentazione dell'API REST notebookRuntimeTemplates.patch.

Eliminare un modello di runtime

Per eliminare un modello di runtime, puoi utilizzare la console Google Cloud , gcloud CLI o l'API REST.

Console

Per eliminare un modello di runtime:

  1. Nella console Google Cloud , vai alla pagina Modelli di runtime di Colab Enterprise.

    Vai a Modelli di runtime

  2. Nel menu Regione, seleziona la regione che contiene il modello di runtime.

  3. Seleziona il modello di runtime che vuoi eliminare.

  4. Fai clic su  Elimina

  5. Fai clic su Conferma.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • RUNTIME_ID: l'ID del runtime.
  • PROJECT_ID: il tuo ID progetto.
  • REGION: la regione in cui si trova il runtime.

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Per saperne di più sul comando per eliminare un modello di runtime dalla riga di comando, consulta la documentazione della CLI gcloud.

REST

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • REGION: la regione in cui si trova il runtime.
  • PROJECT_ID: il tuo ID progetto.
  • RUNTIME_ID: l'ID del runtime.

Metodo HTTP e URL: 

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

Per inviare la richiesta, scegli una di queste opzioni:

curl

Esegui questo comando: 

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

Esegui questo comando: 

$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
In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

Per saperne di più, consulta la documentazione dell'API REST di notebookRuntimeTemplates.delete.

Passaggi successivi