Elimina una risorsa permanente

Le risorse permanenti restano disponibili finché non vengono eliminate. Una volta eliminata, non vi è alcuna garanzia che sia possibile 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 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 anche essere in grado di ottenere questa autorizzazione 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 schede seguenti. Tieni presente che se esistono job personalizzati in esecuzione sulla risorsa permanente 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 che vuoi eliminare.

  3. Fai clic su Elimina.

  4. Fai clic su Conferma.

gcloud

Prima di utilizzare uno qualsiasi dei dati di comando 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 [http://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 di Python riportate nella guida rapida di Vertex AI sull'utilizzo delle librerie client. Per maggiori informazioni, consulta la documentazione di riferimento dell'API Python Vertex AI.

Per eseguire l'autenticazione in 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, 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 http://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