Borra un recurso persistente

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

Funciones obligatorias

Para obtener el permiso que necesitas para borrar un recurso persistente, pídele a tu administrador que te otorgue el rol de IAM de administrador de Vertex AI (roles/aiplatform.admin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Este rol predefinido contiene el permiso aiplatform.persistentResources.delete, que se requiere para borrar un recurso persistente.

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

Borra un recurso persistente

Para obtener instrucciones sobre cómo borrar un recurso persistente cuando ya no lo necesites, selecciona una de las siguientes pestañas. Ten en cuenta que si hay trabajos personalizados que se ejecutan en el recurso persistente cuando lo borras, esos trabajos se cancelan de forma automática antes de que se borre el recurso persistente.

Console

Para borrar un recurso persistente en la consola de Google Cloud, haz lo siguiente:

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

    Ir a Recursos persistentes

  2. Haz clic en el nombre del recurso persistente que deseas borrar.

  3. Haz clic en Borrar.

  4. Haz clic en Confirmar.

gcloud

Antes de usar cualquiera de los datos de comando a continuación, haz los siguientes reemplazos:

  • PROJECT_ID: el ID del proyecto del recurso persistente que deseas borrar.
  • LOCATION: la región del recurso persistente que deseas borrar.
  • PERSISTENT_RESOURCE_ID: El ID del recurso persistente que deseas borrar.

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 que figura a continuación:

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 instrucciones de configuración para Python incluidas en la guía de inicio rápido de Vertex AI sobre cómo usar bibliotecas cliente. Para obtener más información, consulta la documentación de referencia de la API de Vertex AI Python.

Para autenticarte en Vertex AI, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.

resource_to_delete = persistent_resource.PersistentResource(
    EXAMPLE_PERSISTENT_RESOURCE_ID
)

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

REST

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: el ID del proyecto del recurso persistente que deseas borrar.
  • LOCATION: la región del recurso persistente que deseas borrar.
  • PERSISTENT_RESOURCE_ID: El ID del recurso persistente que deseas borrar.

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, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

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

¿Qué sigue?