In diesem Dokument erfahren Sie, wie Sie ein Rollback eines Schemas für ein Pub/Sub .
Mit dem Rollback-Vorgang können Sie eine weitere Schemaversion mit genau dieser Schemadefinition der angegebenen vorherigen Version.
Hinweise
Erforderliche Rollen und Berechtigungen
Um die Berechtigungen zu erhalten, die Sie für das Rollback von Schemas und deren Verwaltung benötigen,
bitten Sie Ihren Administrator, Ihnen
IAM-Rolle Pub/Sub-Bearbeiter (roles/pubsub.editor
) für Ihr Projekt
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.
Diese vordefinierte Rolle enthält Berechtigungen, die für das Rollback von Schemas und deren Verwaltung erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um ein Rollback von Schemas durchzuführen und diese zu verwalten:
-
Schema erstellen:
pubsub.schemas.create
-
Schema an Thema anhängen:
pubsub.schemas.attach
-
Führen Sie einen Commit für eine Schemaversion durch:
pubsub.schemas.commit
-
So löschen Sie ein Schema oder eine Schemaversion:
pubsub.schemas.delete
-
Rufen Sie ein Schema oder eine Schemaversion ab:
pubsub.schemas.get
-
Schemas auflisten:
pubsub.schemas.list
-
Schemaversionen auflisten:
pubsub.schemas.listRevisions
-
Rollback eines Schemas durchführen:
pubsub.schemas.rollback
-
Validieren Sie eine Nachricht:
pubsub.schemas.validate
-
Rufen Sie die IAM-Richtlinie für ein Schema ab:
pubsub.schemas.getIamPolicy
-
Konfigurieren Sie die IAM-Richtlinie für ein Schema:
pubsub.schemas.setIamPolicy
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Sie können Hauptkonten wie Nutzern, Gruppen, Domains oder Dienstkonten. Sie können ein Schema in einem Projekt erstellen und an ein Thema in einem anderen Projekt anhängen. Achten Sie darauf, dass Sie die erforderlichen Berechtigungen für für jedes Projekt.
Rollback einer Schemaversion durchführen
Sie können für ein Schema mit der Methode Google Cloud Console, gcloud CLI, Pub/Sub API Cloud-Clientbibliotheken. Gehen Sie so vor:
Console
Rufen Sie in der Google Cloud Console die Seite Pub/Sub-Schemas auf.
Klicken Sie auf den Namen eines vorhandenen Schemas.
Die Seite Schemadetails für das Schema wird geöffnet.
Klicken Sie auf Rollback.
Das Dialogfeld Rollback des Schemas wird geöffnet.
Wählen Sie die Version aus, auf die Sie das Rollback des Schemas durchführen möchten.
Klicken Sie auf Bestätigen, um den Rollback-Vorgang zu speichern.
Eine neue Version wird mit dem Schema erstellt, das im Rollback-Vorgang.
Wählen Sie auf der Seite Schemadetails die neueste Version des Schemas aus. und die Version, die Sie als Quelle für den Rollback-Vorgang ausgewählt haben.
Klicken Sie auf Unterschied ansehen.
Sie können prüfen, ob die beiden Schemas identisch sind.
Sie können die soeben erstellte Schemaversion als letzte Version verwenden zur Validierung eines Themas. Aktualisieren Sie dazu das Feld Letzte zulässige Überarbeitung.
gcloud
gcloud pubsub schemas rollback SCHEMA_ID \ --revision-id=REVISION_ID
Wobei:
- REVISION_ID ist die Überarbeitung, auf die ein Rollback durchgeführt werden soll.
REST
Um ein Schema rückgängig zu machen, senden Sie eine POST-Anfrage wie die folgende:
POST https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID:rollback Authorization: Bearer $(gcloud auth application-default print-access-token) Content-Type: application/json --data @response-body.json
Geben Sie im Anfragetext die folgenden Felder an:
{ "revisionId": REVISION_KD }
Wobei:
- REVISION_KD ist die ID der Version, auf die ein Rollback durchgeführt werden soll.
Der Antworttext sollte eine JSON-Darstellung einer Schemaressource enthalten.
C++
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für C++ in der Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub C++ API.
Go
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Go in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Go API.
Java
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Java in der Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Java API.
Python
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Python in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Python API.
Node.js
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für PHP in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Node.js API.
Node.js
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für PHP in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Node.js API.
Nächste Schritte
- Schemaversion löschen
- Schema löschen
- Schemas auflisten
- Schemaversionen auflisten
- Thema mit einem Schema abonnieren