Eliminar un recurso persistente

Los recursos persistentes están disponibles hasta que se eliminan. Una vez eliminado, no se garantiza que puedas volver a crear el recurso persistente del mismo tipo si se agota el stock. En esta página se muestra cómo eliminar un recurso persistente mediante la Google Cloud consola, la CLI de Google Cloud, el SDK de Vertex AI para Python y la API REST.

Roles obligatorios

Para obtener el permiso que necesitas para eliminar un recurso persistente, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Vertex AI (roles/aiplatform.admin) en tu proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el permiso aiplatform.persistentResources.delete, que es necesario para eliminar un recurso persistente.

También puedes obtener este permiso con roles personalizados u otros roles predefinidos.

Eliminar un recurso persistente

Para obtener instrucciones sobre cómo eliminar un recurso persistente cuando ya no lo necesites, selecciona una de las siguientes pestañas. Ten en cuenta que, si hay trabajos personalizados en ejecución en el recurso persistente cuando lo elimines, esos trabajos personalizados se cancelarán automáticamente antes de que se elimine el recurso persistente.

Consola

Para eliminar un recurso persistente en la consola Google Cloud , sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Recursos persistentes.

    Ir a Recursos persistentes

  2. Haz clic en el nombre del recurso persistente que quieras eliminar.

  3. Haz clic en Eliminar.

  4. Haz clic en Confirmar.

gcloud

Antes de usar los datos de los comandos que se indican a continuación, haz los siguientes cambios:

  • PROJECT_ID: el ID de proyecto del recurso persistente que quieres eliminar.
  • LOCATION: la región del recurso persistente que quieres eliminar.
  • PERSISTENT_RESOURCE_ID: el ID del recurso persistente que quieres eliminar.

Ejecuta el siguiente comando:

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

Deberías recibir una respuesta similar a la siguiente:

Using endpoint [https://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

Antes de probar este ejemplo, sigue las Python instrucciones de configuración de la guía de inicio rápido de Vertex AI con bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Python de Vertex AI.

Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación en un entorno de desarrollo local. 

from google.cloud.aiplatform.preview import persistent_resource

resource_to_delete = persistent_resource.PersistentResource(
    PERSISTENT_RESOURCE_ID
)

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

REST

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID de proyecto del recurso persistente que quieres eliminar.
  • LOCATION: la región del recurso persistente que quieres eliminar.
  • PERSISTENT_RESOURCE_ID: el ID del recurso persistente que quieres eliminar.

Método HTTP y URL: 

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

Para enviar tu solicitud, despliega una de estas opciones:

Deberías recibir una respuesta JSON similar a la siguiente:

{
  "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"
  }
}

Siguientes pasos