Elimina una risorsa permanente

Le risorse permanenti sono disponibili finché non vengono eliminate. Una volta eliminata, non è garantito che tu possa creare di nuovo la risorsa permanente dello stesso tipo in caso di disponibilità. Questa pagina mostra come eliminare una risorsa permanente utilizzando la console Google Cloud, Google Cloud CLI, l'SDK Vertex AI per Python e l'API REST.

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per eliminare una risorsa permanente, chiedi all'amministratore di concederti il ruolo IAM Amministratore Vertex AI (roles/aiplatform.admin) per il tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene l'autorizzazione aiplatform.persistentResources.delete, necessaria per eliminare una risorsa permanente.

Potresti riuscire a ottenere questa autorizzazione anche con i ruoli personalizzati o altri ruoli predefiniti.

Elimina una risorsa permanente

Per istruzioni su come eliminare una risorsa permanente quando non ti serve più, seleziona una delle seguenti schede. Tieni presente che, se sulla risorsa permanente sono in esecuzione job personalizzati quando la elimini, questi vengono annullati automaticamente prima dell'eliminazione della risorsa permanente.

Console

Per eliminare una risorsa permanente nella console Google Cloud, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina Risorse permanenti.

    Vai a Risorse permanenti

  2. Fai clic sul nome della risorsa permanente da eliminare.

  3. Fai clic su Elimina.

  4. Fai clic su Conferma.

gcloud

Prima di utilizzare qualsiasi dato di comando riportato di seguito, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto della risorsa permanente che vuoi eliminare.
  • LOCATION: la regione della risorsa permanente che vuoi eliminare.
  • PERSISTENT_RESOURCE_ID: l'ID della risorsa permanente che vuoi eliminare.

Esegui questo seguente 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

Dovresti ricevere una risposta simile alla seguente:

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

Prima di provare questo esempio, segui le istruzioni per la configurazione di Python nella guida rapida di Vertex AI sull'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python Vertex AI.

Per eseguire l'autenticazione su Vertex AI, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale. 

resource_to_delete = persistent_resource.PersistentResource(
    EXAMPLE_PERSISTENT_RESOURCE_ID
)

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

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto della risorsa permanente che vuoi eliminare.
  • LOCATION: la regione della risorsa permanente che vuoi eliminare.
  • PERSISTENT_RESOURCE_ID: l'ID della risorsa permanente che vuoi eliminare.

Metodo HTTP e URL: 

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

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

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

Passaggi successivi