Nichtflüchtige Ressource löschen

Nichtflüchtige Ressourcen sind verfügbar, bis sie gelöscht werden. Es gibt keine Garantie, dass Sie eine nichtflüchtige Ressource desselben Ressourcentyps noch einmal erstellen können, wenn ein Engpass besteht. Auf dieser Seite erfahren Sie, wie Sie eine nichtflüchtige Ressource mit der Google Cloud Console, der Google Cloud CLI, dem Vertex AI SDK für Python und der REST API löschen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die Rolle Vertex AI Administrator (roles/aiplatform.admin) für Ihr Projekt zu gewähren, um die Berechtigung zum Löschen einer nichtflüchtigen Ressource zu erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung aiplatform.persistentResources.delete, die zum Löschen einer nichtflüchtigen Ressource erforderlich ist.

Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Nichtflüchtige Ressource löschen

Um eine nichtflüchtige Ressource zu löschen, wenn Sie sie nicht mehr benötigen, wählen Sie einen der folgenden Tabs aus. Wenn beim Löschen benutzerdefinierte Jobs auf der nichtflüchtige Ressource ausgeführt werden, werden diese benutzerdefinierten Jobs automatisch abgebrochen, bevor die nichtflüchtige Ressource gelöscht wird.

Console

So löschen Sie eine nichtflüchtige Ressource in der Google Cloud Console:

1. Öffnen Sie in der Google Cloud Console die Seite Nichtflüchtige Ressourcen.

   Nichtflüchtige Ressourcen aufrufen

2. Klicken Sie auf den Namen der nichtflüchtigen Ressource, die Sie löschen möchten.

3. Klicken Sie auf Löschen.

4. Klicken Sie auf Bestätigen.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• PROJECT_ID: Die Projekt-ID der nichtflüchtigen Ressource, die Sie löschen möchten.
• LOCATION: Die Region der nichtflüchtigen Ressource, die Sie löschen möchten.
• PERSISTENT_RESOURCE_ID: Die ID der nichtflüchtigen Ressource, die Sie löschen möchten.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud ai persistent-resources delete PERSISTENT_RESOURCE_ID \
    --project=PROJECT_ID \
    --region=LOCATION

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud ai persistent-resources delete PERSISTENT_RESOURCE_ID `
    --project=PROJECT_ID `
    --region=LOCATION

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud ai persistent-resources delete PERSISTENT_RESOURCE_ID ^
    --project=PROJECT_ID ^
    --region=LOCATION

Sie sollten eine Antwort ähnlich der folgenden erhalten:

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

Bevor Sie dieses Beispiel anwenden, folgen Sie den Python-Einrichtungsschritten in der Vertex AI-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der Referenzdokumentation zur Vertex AI Python API.

Richten Sie zur Authentifizierung bei Vertex AI Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

resource_to_delete = persistent_resource.PersistentResource(
    EXAMPLE_PERSISTENT_RESOURCE_ID
)

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

REST

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: Die Projekt-ID der nichtflüchtigen Ressource, die Sie löschen möchten.
• LOCATION: Die Region der nichtflüchtigen Ressource, die Sie löschen möchten.
• PERSISTENT_RESOURCE_ID: Die ID der nichtflüchtigen Ressource, die Sie löschen möchten.

HTTP-Methode und URL:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/persistentResources/PERSISTENT_RESOURCE_ID"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/persistentResources/PERSISTENT_RESOURCE_ID" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Nächste Schritte

• Mehr über nichtflüchtige Ressourcen erfahren.
• Trainingsjobs für eine nichtflüchtige Ressource ausführen.
• Nichtflüchtige Ressource erstellen und verwenden.
• Informationen zu einer nichtflüchtigen Ressource abrufen.
• Nichtflüchtige Ressource neu starten.