Eliminare una risorsa permanente

Le risorse permanenti sono disponibili fino a quando non vengono eliminate. Una volta eliminate, non è garantito che tu possa creare di nuovo la risorsa permanente dello stesso tipo di risorsa in caso di esaurimento scorte. Questa pagina mostra come eliminare una risorsa permanente utilizzando la Google Cloud console, Google Cloud CLI, SDK Vertex AI 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 Vertex AI Administrator (roles/aiplatform.admin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

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

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

Elimina 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 sono in esecuzione job personalizzati sulla risorsa permanente quando la elimini, questi job personalizzati vengono annullati automaticamente prima dell'eliminazione della risorsa permanente.

Console

Per eliminare una risorsa permanente nella Google Cloud console:

  1. Nella Google Cloud console, 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 questo 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 nella guida rapida di Vertex AI utilizzando le librerie client. Per saperne di più, consulta la documentazione di riferimento dell' API Python di Vertex AI.

Per eseguire l'autenticazione in Vertex AI, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale. 

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

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

  • 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