Eliminare una risorsa permanente

Le risorse permanenti sono disponibili fino a quando non vengono eliminate. Una volta eliminata, non c'è alcuna garanzia che tu possa creare di nuovo la risorsa permanente dello stesso tipo se si verifica un'interruzione dell'inventario. 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) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

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

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

Eliminare una risorsa permanente

Per istruzioni su come eliminare una risorsa permanente quando non ne hai più bisogno, seleziona una delle seguenti schede. Tieni presente che, se al momento dell'eliminazione della risorsa permanente sono in esecuzione job personalizzati, questi vengono annullati automaticamente prima dell'eliminazione della risorsa.

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 che vuoi eliminare.

  3. Fai clic su Elimina.

  4. Fai clic su Conferma.

gcloud

Prima di utilizzare i dati dei comandi riportati 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 il 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 di configurazione Python riportate nella guida rapida all'utilizzo delle librerie client di Vertex AI. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Vertex AI.

Per autenticarti a Vertex AI, configura le 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, apporta 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 di queste 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