In diesem Dokument erfahren Sie, wie Sie Schemaversionen für Pub/Sub-Themen löschen. Beim Löschen eines Schemas werden auch alle mit dem Schema verknüpften Versionen gelöscht.
Hinweise
Erforderliche Rollen und Berechtigungen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Pub/Sub Editor (roles/pubsub.editor
) für Ihr Projekt zu erteilen, um die Berechtigungen zu erhalten, die Sie zum Löschen und Verwalten von Schemaüberarbeitungen 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 Löschen und Verwalten von Schemarevisionen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um Schemaüberarbeitungen zu löschen 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.
Schemaüberarbeitung löschen
Hier sind einige wichtige Richtlinien zum Löschen einer Schemaüberarbeitung:
Sie können eine oder mehrere Schemaüberarbeitungen aus einem Schema löschen.
Wenn das Schema nur eine Version hat, können Sie die Version nicht löschen. Löschen Sie stattdessen das Schema.
Beim Löschen eines Schemas werden auch alle mit dem Schema verknüpften Versionen gelöscht.
Wenn Sie ein Schema löschen, schlägt die Veröffentlichung von Nachrichten in Themen fehl, die mit diesem Schema verknüpft sind.
Wenn Sie eine Schemaüberarbeitung löschen, die als erste Überarbeitung für ein Thema angegeben ist, wird stattdessen die nächste Überarbeitung zur Validierung verwendet.
Wenn die gelöschte Schemaversion als letzte Version für ein Thema angegeben ist, wird stattdessen die vorherige Schemaversion für die Validierung verwendet.
Wenn die gelöschte Schemaversion in den angegebenen Versionsbereich für ein Thema zur Validierung fällt, wird die Version übersprungen.
Sie können eine Schemaversion mit derGoogle Cloud -Konsole, der gcloud CLI, der Pub/Sub API oder den Cloud-Clientbibliotheken löschen.
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.
Wählen Sie die Überarbeitung aus, die Sie löschen möchten. Sie können auch mehrere Überarbeitungen auswählen.
Klicken Sie auf Überarbeitung löschen.
Bestätigen Sie den Löschvorgang.
gcloud
gcloud pubsub schemas delete-revision SCHEMA_NAME@REVISION_ID
Wobei:
- REVISION_ID ist die Version, zu der Sie ein Rollback durchführen möchten.
REST
Um eine Schemaüberarbeitung zu löschen, senden Sie eine DELETE-Anfrage wie diese:
POST https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID@REVISION_ID:deleteRevision Authorization: Bearer $(gcloud auth application-default print-access-token) Content-Type: application/json --data @response-body.json
Der Antworttext sollte eine JSON-Darstellung der gelöschten 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 löschen
- Schemas auflisten
- Überarbeitungen eines Schemas auflisten
- Thema mit einem Schema abonnieren