In diesem Dokument erfahren Sie, wie Sie ein Schema für ein Pub/Sub-Thema zurücksetzen.
Mit dem Rollback-Vorgang können Sie eine weitere Schemaversion mit derselben Schemadefinition wie die angegebene vorherige Version erstellen.
Hinweise
Erforderliche Rollen und Berechtigungen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Pub/Sub-Bearbeiter (roles/pubsub.editor
) für Ihr Projekt zuzuweisen, damit Sie die Berechtigungen erhalten, die Sie zum Zurücksetzen und Verwalten von Schemas benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Zurücksetzen und Verwalten von Schemas erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um Schemas zurückzusetzen und zu verwalten:
-
Schema erstellen:
pubsub.schemas.create
-
Schema an Thema anhängen:
pubsub.schemas.attach
-
Schemaüberarbeitung übernehmen:
pubsub.schemas.commit
-
Schema oder Schemaüberarbeitung löschen:
pubsub.schemas.delete
-
Schema oder Schemaversionen abrufen:
pubsub.schemas.get
-
Schemas auflisten:
pubsub.schemas.list
-
Schemaüberarbeitungen auflisten:
pubsub.schemas.listRevisions
-
Schema zurücksetzen:
pubsub.schemas.rollback
-
Nachricht validieren:
pubsub.schemas.validate
-
So 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 Rollen und Berechtigungen zuweisen. Sie können ein Schema in einem Projekt erstellen und es an ein Thema anhängen, das sich in einem anderen Projekt befindet. Prüfen Sie, ob Sie die erforderlichen Berechtigungen für jedes Projekt haben.
Rollback einer Schemaversion durchführen
Sie können ein Schema über dieGoogle Cloud Console, die gcloud CLI, die Pub/Sub API oder die Cloud-Clientbibliotheken zurücksetzen. 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 Schema zurücksetzen wird geöffnet.
Wählen Sie die Version aus, zu der Sie das Rollback Ihres Schemas durchführen möchten.
Klicken Sie auf Bestätigen, um den Rollback-Vorgang zu speichern.
Es wird eine neue Version mit dem im Rollback-Vorgang angegebenen Schema erstellt.
Wählen Sie auf der Seite Schemadetails die neueste Version des Schemas und die Version aus, die Sie als Quelle für den Rollbackvorgang ausgewählt haben.
Klicken Sie auf Unterschied einblenden.
Sie können prüfen, ob die beiden Schemas identisch sind.
Sie können die gerade erstellte Schemaversion als letzte Version zum Validieren eines Themas verwenden, indem Sie das Feld Letzte zulässige Version aktualisieren.
gcloud
gcloud pubsub schemas rollback SCHEMA_ID \ --revision-id=REVISION_ID
Wobei:
- REVISION_ID ist die Version, zu der Sie ein Rollback durchführen möchten.
REST
Senden Sie zum Zurücksetzen eines Schemas 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 Revision, zu der 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
- Schemaüberarbeitung löschen
- Schema löschen
- Schemas auflisten
- Überarbeitungen eines Schemas auflisten
- Thema mit einem Schema abonnieren