Vorgänge mit langer Ausführungszeit verwalten

Auf dieser Seite wird beschrieben, wie Sie Vorgänge mit langer Ausführungszeit im Zertifikatmanager prüfen und verwalten.

Wenn eine Mutationsanfrage im Zertifikatmanager, z. B. zum Erstellen, Aktualisieren oder Löschen einer Ressource, nicht sofort fehlschlägt, gibt die API einen Vorgang mit langer Ausführungszeit zurück. Mit diesen Vorgängen wird der Status von Verarbeitungsvorgängen verfolgt, die länger dauern. Standardmäßig warten gcloud-Mutationsbefehle, bis der Vorgang abgeschlossen ist, es sei denn, Sie geben das Flag --async an.

Sie können die Sammlung projects.locations.operations verwenden, um den Status von Vorgängen zu prüfen.

Erforderliche Berechtigungen

Zum Verwalten von Vorgängen mit langer Ausführungszeit im Zielprojekt benötigen Sie die Berechtigung, die der Aufgabe entspricht, die Sie ausführen möchten:

  • certificatemanager.operations.get: Ruft Details zu einem bestimmten Vorgang ab.
  • certificatemanager.operations.list: Listet alle Vorgänge an einem bestimmten Standort auf.
  • certificatemanager.operations.delete: Löscht eine abgeschlossene Vorgangsressource (nur API).

Weitere Informationen zu Rollen und Berechtigungen finden Sie unter Rollen und Berechtigungen.

Details zu einem Vorgang mit langer Ausführungszeit abrufen

Wenn Sie einen Aufruf ausführen, der einen Vorgang startet, z. B. das Erstellen eines Zertifikats, enthält die Antwort einen Vorgangsnamen im Format projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID.

Wenn Sie prüfen möchten, ob der Vorgang abgeschlossen ist, fordern Sie Details zum Zielvorgang an. Wenn die Antwort "done": false enthält oder das Feld "done" nicht enthält, ist der Vorgang noch aktiv. Prüfen Sie den Status noch einmal, bis in der Antwort "done": true angezeigt wird.

gcloud

Verwenden Sie den Befehl certificate-manager operations describe, um einen Vorgang mit langer Ausführungszeit zu beschreiben:

gcloud certificate-manager operations describe OPERATION_ID \
    --location="LOCATION"

Ersetzen Sie Folgendes:

  • OPERATION_ID: die ID des Vorgangs.
  • LOCATION: der Zielstandort in Google Cloud . Der Standardspeicherort ist global.

API

Wenn Sie Details zu einem Vorgang mit langer Ausführungszeit abrufen möchten, senden Sie eine GET-Anfrage an die Methode projects.locations.operations.get:

GET https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID Ihres Projekts in Google Cloud .
  • LOCATION: der Zielstandort in Google Cloud . Der Standardspeicherort ist global.
  • OPERATION_ID: die ID des Vorgangs.

Vorgänge mit langer Ausführungszeit auflisten

Sie können Vorgänge auflisten, um Vorgangs-IDs zu finden und aktive Änderungen in Ihrem Projekt zu überwachen.

gcloud

Verwenden Sie den Befehl certificate-manager operations list, um Vorgänge an einem bestimmten Standort aufzulisten:

gcloud certificate-manager operations list \
    --location="LOCATION"

Ersetzen Sie Folgendes:

  • LOCATION: der Zielstandort in Google Cloud . Der Standardspeicherort ist global.

API

Wenn Sie Vorgänge an einem Standort auflisten möchten, senden Sie eine GET-Anfrage an die Methode projects.locations.operations.list:

GET https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID Ihres Projekts in Google Cloud .
  • LOCATION: der Zielstandort in Google Cloud . Der Standardspeicherort ist global.

Abgeschlossenen Vorgang mit langer Ausführungszeit löschen

Sie können eine abgeschlossene Vorgangsressource löschen, wenn Sie das Ergebnis nicht mehr benötigen. Wenn Sie einen abgeschlossenen Vorgang löschen, wird nur der Vorgangsdatensatz entfernt. Die durch den Vorgang vorgenommenen Änderungen werden nicht abgebrochen oder rückgängig gemacht.

Sie können Vorgänge nicht mit gcloud-Befehlen löschen. Verwenden Sie stattdessen die REST API.

API

Senden Sie eine DELETE-Anfrage an die Methode projects.locations.operations.delete, um einen abgeschlossenen Vorgang zu löschen:

DELETE https://certificatemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID Ihres Projekts in Google Cloud .
  • LOCATION: der Zielstandort in Google Cloud . Der Standardspeicherort ist global.
  • OPERATION_ID: die ID des Vorgangs.

Aufbewahrungsrichtlinien

Der Zertifikatmanager behält abgeschlossene LROs automatisch bei und löscht sie gemäß den folgenden Regeln in der Reihenfolge ihrer Priorität:

  1. Weniger als 1 Stunde alt: Wenn ein Vorgang vor weniger als 1 Stunde abgeschlossen wurde, wird er vom Zertifikatmanager beibehalten.
  2. Älter als 1 Woche: Wenn ein Vorgang vor mehr als 1 Woche abgeschlossen wurde, wird er vom Zertifikatmanager gelöscht.
  3. Maximale Anzahl: Wenn ein Vorgang vor einer Stunde bis einer Woche abgeschlossen wurde, speichert der Zertifikatmanager bis zu 5.000 der zuletzt abgeschlossenen Vorgänge in jedem Projekt und löscht alle älteren abgeschlossenen Vorgänge.

Die folgenden Beispiele zeigen, wie diese Regeln angewendet werden:

  • Wenn Ihr Projekt 10.000 abgeschlossene Vorgänge hat, die alle weniger als 1 Stunde alt sind, behält der Zertifikatmanager alle 10.000 Vorgänge bei.
  • Wenn Ihr Projekt 1.000 abgeschlossene Vorgänge hat, die alle älter als eine Woche sind, löscht der Zertifikatmanager alle 1.000 Vorgänge.
  • Wenn Ihr Projekt 10.000 abgeschlossene Vorgänge hat, die alle zwischen 1 Stunde und 1 Woche alt sind, behält der Zertifikatmanager nur die 5.000 neuesten Vorgänge bei.