Gérer les modèles d'exécution

Cette page explique comment gérer un modèle d'exécution Colab Enterprise, y compris les tâches suivantes :

  • Modifier un modèle d'exécution
  • Supprimer un modèle d'exécution

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer un modèle d'exécution Colab Enterprise, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Modifier un modèle d'exécution

Vous pouvez modifier certaines spécifications de votre modèle d'exécution, y compris la version de Python et la configuration de la clé de chiffrement. Les modifications apportées au modèle d'exécution ne s'appliquent qu'aux exécutions nouvellement créées à partir de ce modèle.

Pour modifier un modèle d'exécution, vous pouvez utiliser la Google Cloud console ou l'API REST.

Console

Pour modifier un modèle d'exécution, procédez comme suit :

  1. Dans la Google Cloud console, accédez à la page Modèles d'exécution de Colab Enterprise.

    Accéder aux modèles d'exécution

  2. Dans le menu Région, sélectionnez la région contenant votre modèle d'exécution.

  3. Dans la colonne ID, cliquez sur le numéro d'ID du modèle d'exécution que vous souhaitez modifier.

  4. Cliquez sur  Modifier.

  5. Dans le panneau Modifier le modèle d'exécution, apportez des modifications au modèle d'exécution.

  6. Cliquez sur Mettre à jour.

REST

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • REGION : région où se trouve votre modèle d'exécution.
  • PROJECT_ID : ID du projet.
  • NOTEBOOK_RUNTIME_TEMPLATE_ID : ID de votre modèle d'exécution.
  • RELEASE_NAME : nom de la version de l'image que vous souhaitez utiliser. Par exemple, py311 est le nom de la version de l'image Python 3.11. Pour définir l'image sur Latest, laissez RELEASE_NAME vide.

Méthode HTTP et 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

Corps JSON de la requête : 

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante : 

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

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante : 

$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
Si elle aboutit, le corps de la réponse contient une instance de Operation.

Pour en savoir plus sur les paramètres de requête disponibles, consultez la notebookRuntimeTemplates.patch documentation de l'API REST.

Supprimer un modèle d'exécution

Pour supprimer un modèle d'exécution, vous pouvez utiliser la Google Cloud console, la gcloud CLI ou l'API REST.

Console

Pour supprimer un modèle d'exécution, procédez comme suit :

  1. Dans la Google Cloud console, accédez à la page Modèles d'exécution de Colab Enterprise.

    Accéder aux modèles d'exécution

  2. Dans le menu Région, sélectionnez la région contenant votre modèle d'exécution.

  3. Sélectionnez le modèle d'exécution que vous souhaitez supprimer.

  4. Cliquez sur  Supprimer.

  5. Cliquez sur Confirmer.

gcloud

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • RUNTIME_ID : ID de votre environnement d'exécution.
  • PROJECT_ID : ID du projet.
  • REGION : région où se trouve votre environnement d'exécution.

Exécutez la commande suivante :

Linux, macOS ou 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

Pour en savoir plus sur la commande permettant de supprimer un modèle d'exécution à partir de la ligne de commande, consultez la documentation de la gcloud CLI.

REST

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • REGION : région où se trouve votre environnement d'exécution.
  • PROJECT_ID : ID du projet.
  • RUNTIME_ID : ID de votre environnement d'exécution.

Méthode HTTP et URL : 

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

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante : 

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

Exécutez la commande suivante : 

$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
Si elle aboutit, le corps de la réponse contient une instance de Operation.

Pour en savoir plus, consultez la documentation de l'API REST notebookRuntimeTemplates.delete.

Étape suivante