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:

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

Ir a Recursos persistentes
Haz clic en el nombre del recurso persistente que deseas borrar.
Haz clic en Borrar.
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:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/persistentResources/PERSISTENT_RESOURCE_ID"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/persistentResources/PERSISTENT_RESOURCE_ID" | Select-Object -Expand Content

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

Borra un recurso persistente

Funciones obligatorias

Borra un recurso persistente

Console

gcloud

Linux, macOS o Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

Python

REST

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

¿Qué sigue?