Themenversionen auflisten

Sie können die Versionen eines Subjekts in einer bestimmten Schemaregistrierung in Ihrem Projekt auflisten.

In diesem Dokument wird beschrieben, wie Sie mit derGoogle Cloud Console oder der Managed Kafka API Versionsinformationen zu Themen auflisten.

Erforderliche Rollen und Berechtigungen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Managed Kafka Schema Registry Viewer (roles/managedkafka.schemaRegistryViewer) für Ihre Schemaregistrierung zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Auflisten von Betreffversionen 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 Auflisten von Fachversionen erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Fachversionen aufzulisten:

  • Erteilen Sie die folgende Berechtigung für das übergeordnete Thema: managedkafka.versions.list

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

Weitere Informationen zu vordefinierten Rollen finden Sie unter Vordefinierte Rollen für Managed Service for Apache Kafka.

Schemaversionen in einem Subjekt auflisten

So listen Sie alle Versionen eines Themas in einer bestimmten Schemaregistry in Ihrem Projekt auf:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Schema-Registries auf.

    Zu Schemaregistrierungen

  2. Klicken Sie auf den Namen der Schemaregistry, in der sich Ihr Thema befindet.

  3. Klicken Sie unter Subjekte in dieser Schema-Registry auf den Namen des Subjekts.

  4. Auf der Seite Subject details (Details zum Thema) sind die Schemaversionen unter All Versions (Alle Versionen) aufgeführt.

  5. Optional: Wenn Sie die Schemadefinition für eine Version aufrufen möchten, klicken Sie das Kästchen für die Versions-ID an. Die Schemadefinition wird unter Definition angezeigt.

  6. Optional: So rufen Sie die Unterschiede zwischen zwei beliebigen Schemaversionen für dieses Thema auf:

    1. Wählen Sie unter Alle Versionen die Versionen aus, die Sie vergleichen möchten.
    2. Klicken Sie im Bereich Definition auf  Unterschied anzeigen.

    Die beiden Schemadefinitionen werden nebeneinander angezeigt. Hinzufügungen, Löschungen und Änderungen sind hervorgehoben.

REST

Die Anfrage muss mit einem Zugriffstoken im Header Authorization authentifiziert werden. So rufen Sie ein Zugriffstoken für die aktuellen Standardanmeldedaten für Anwendungen ab: gcloud auth application-default print-access-token.

Stellen Sie eine GET-Anfrage an die Methode projects.locations.schemaRegistries.subjects.versions.list, um Fachversionen aufzulisten.

GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/subjects/SUBJECT_ID/versions
Authorization: Bearer $(gcloud auth application-default print-access-token)

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID in Google Cloud .
  • LOCATION: die Google Cloud Region, in der sich die Schemaregistrierung befindet.
  • REGISTRY_ID: die ID Ihrer Schemaregistry.
  • SUBJECT_ID: Die ID des Subjekts.

Beispiel:

GET https://managedkafka.googleapis.com/v1main/projects/test-project/locations/us-central1/schemaRegistries/test_registry/subjects/test_subject/versions
Authorization: Bearer $(gcloud auth application-default print-access-token)

Oder mit einem Kontext:

GET https://managedkafka.googleapis.com/v1main/projects/test-project/locations/us-central1/schemaRegistries/test_registry/contexts/test_context/subjects/test_subject/versions
Authorization: Bearer $(gcloud auth application-default print-access-token)

Wobei:

  • test-project ist die Google Cloud Projekt-ID.
  • us-central1 ist die Google Cloud Region, in der sich die Schemaregistrierung befindet.
  • test_registry ist die ID Ihrer Schemaregistrierung.
  • test_context ist die ID des Kontexts.
  • test_subject ist die ID des Subjekts.

Bei einer erfolgreichen Anfrage gibt die API den Statuscode 200 OK zurück. Der Antworttext enthält ein JSON-Array mit Betreffversionen.

Hier ist ein Beispiel für eine erfolgreiche Antwort:

{
  "versions": [
    {
      "name": "projects/test-project/locations/us-central1/schemaRegistries/test_registry/subjects/test_subject/versions/1",
      "revisionId": "1a2b3c4d",
      "schemaId": "S12345",
      "createTime": "2024-07-15T12:00:00Z",
      "revisionCreateTime": "2024-07-15T12:00:00Z"
    },
    {
      "name": "projects/test-project/locations/us-central1/schemaRegistries/test_registry/subjects/test_subject/versions/2",
      "revisionId": "5e6f7g8h",
      "schemaId": "S67890",
      "createTime": "2024-07-16T14:30:00Z",
      "revisionCreateTime": "2024-07-16T14:30:00Z"
    }
  ]
}

Weitere Informationen finden Sie in der Dokumentation zur Methode projects.locations.schemaRegistries.subjects.versions.list.

Nächste Schritte

Apache Kafka® ist eine eingetragene Marke der Apache Software Foundation oder deren Tochtergesellschaften in den USA und/oder anderen Ländern.