Excluir um recurso persistente

Os recursos persistentes ficam disponíveis até serem excluídos. Uma vez excluído, não há garantia de que você poderá criar o recurso permanente do mesmo tipo de recurso novamente se houver um estoque esgotado. Nesta página, mostramos como excluir um recurso permanente usando o Google Cloud console, a Google Cloud CLI, o SDK da Vertex AI para Python e a API REST.

Funções exigidas

Para receber a permissão necessária a fim de excluir um recurso permanente, peça ao administrador para conceder a você o papel do IAM de Administrador da plataforma de agentes (roles/aiplatform.admin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a permissão aiplatform.persistentResources.delete, que é necessária para excluir um recurso permanente.

Também é possível conseguir essa permissão com papéis personalizados ou outros papéis predefinidos.

Excluir um recurso persistente

Para instruções sobre como excluir um recurso permanente quando não precisar mais dele, selecione uma das guias a seguir. Observe que, se houver jobs personalizados em execução no recurso permanente quando você o excluir, eles serão cancelados automaticamente antes da exclusão do recurso.

Console

Para excluir um recurso permanente no Google Cloud console, faça o seguinte:

  1. No Google Cloud console, acesse a página Recursos permanentes.

    Acessar recursos permanentes

  2. Clique no nome do recurso persistente que você quer excluir.

  3. Clique em Excluir.

  4. Clique em Confirmar.

gcloud

Antes de usar os dados do comando abaixo, faça estas substituições:

  • PROJECT_ID: o ID do projeto do recurso permanente que você quer excluir.
  • LOCATION: a região do recurso permanente que você quer excluir.
  • PERSISTENT_RESOURCE_ID: o ID do recurso permanente que você quer excluir.

Execute o seguinte comando:

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

Você receberá uma resposta semelhante a esta:

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 testar esta amostra, siga as instruções de configuração Python no Guia de início rápido da plataforma de agentes: como usar bibliotecas de cliente.

Para autenticar na plataforma de agentes, configure o Application Default Credentials. Se quiser mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento 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 os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto do recurso permanente que você quer excluir.
  • LOCATION: a região do recurso permanente que você quer excluir.
  • PERSISTENT_RESOURCE_ID: o ID do recurso permanente que você quer excluir.

Método HTTP e URL: 

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

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

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

A seguir