Supprimer une ressource persistante

Les ressources persistantes restent disponibles jusqu'à leur suppression. Une fois supprimée, il n'y a aucune garantie que vous puissiez à nouveau créer la ressource persistante du même type en cas de rupture. Cette page explique comment supprimer une ressource persistante à l'aide de la console Google Cloud, de la Google Cloud CLI, du SDK Vertex AI pour Python et de l'API REST.

Rôles requis

Pour obtenir l'autorisation dont vous avez besoin pour supprimer une ressource persistante, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Vertex AI (roles/aiplatform.admin) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Ce rôle prédéfini contient l'autorisation aiplatform.persistentResources.delete, qui est requise pour supprimer une ressource persistante.

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

Supprimer une ressource persistante

Pour savoir comment supprimer une ressource persistante lorsque vous n'en avez plus besoin, sélectionnez l'un des onglets suivants. Notez que si des jobs personnalisés sont en cours d'exécution sur la ressource persistante lorsque vous la supprimez, ils sont automatiquement annulés avant la suppression de la ressource persistante.

Console

Pour supprimer une ressource persistante dans la console Google Cloud, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Ressources persistantes.

    Accéder à la page Ressources persistantes

  2. Cliquez sur le nom de la ressource persistante que vous souhaitez éliminer.

  3. Cliquez sur Supprimer.

  4. Cliquez sur Confirm (Confirmer).

gcloud

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

  • PROJECT_ID : ID du projet de la ressource persistante que vous souhaitez supprimer.
  • LOCATION : région de la ressource persistante que vous souhaitez supprimer.
  • PERSISTENT_RESOURCE_ID : ID de la ressource persistante que vous souhaitez supprimer.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud ai persistent-resources delete PERSISTENT_RESOURCE_ID \
    --project=PROJECT_ID \
    --region=LOCATION

Windows (PowerShell)

gcloud ai persistent-resources delete PERSISTENT_RESOURCE_ID `
    --project=PROJECT_ID `
    --region=LOCATION

Windows (cmd.exe)

gcloud ai persistent-resources delete PERSISTENT_RESOURCE_ID ^
    --project=PROJECT_ID ^
    --region=LOCATION

Vous devriez obtenir un résultat semblable à celui-ci :

Using endpoint [http://us-central1-aiplatform.googleapis.com/]
Request to delete the PersistentResource [projects/sample-project/locations/us-central1/persistentResources/test-persistent-resource] has been sent.

You may view the status of your persistent resource with the command

  $ gcloud ai persistent-resources describe projects/sample-project/locations/us-central1/persistentResources/test-persistent-resource

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python décrites dans le guide de démarrage rapide de Vertex AI à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Vertex AI Python.

Pour vous authentifier auprès de Vertex AI, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

resource_to_delete = persistent_resource.PersistentResource(
    EXAMPLE_PERSISTENT_RESOURCE_ID
)

# Delete the persistent resource.
resource_to_delete.delete(sync=SYNC)

REST

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

  • PROJECT_ID : ID du projet de la ressource persistante que vous souhaitez supprimer.
  • LOCATION : région de la ressource persistante que vous souhaitez supprimer.
  • PERSISTENT_RESOURCE_ID : ID de la ressource persistante que vous souhaitez supprimer.

Méthode HTTP et URL :

DELETE http://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/persistentResources/PERSISTENT_RESOURCE_ID

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/123456789012/locations/us-central1/operations/1234567890123456789",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.DeleteOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-07-28T17:22:08.316883Z",
      "updateTime": "2023-07-28T17:22:08.316883Z"
    }
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  }
}

Étapes suivantes