Alle Schema-Registries auflisten

Vorschau

Dieses Produkt oder diese Funktion unterliegt den Bedingungen für Pre‑GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und ‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

Sie können die Schemaregister in Ihrem Projekt auflisten. In diesem Dokument wird beschrieben, wie Sie Schemaregister mit derGoogle Cloud Console, der Google Cloud CLI oder der Managed Kafka API auflisten.

Erforderliche Rollen und Berechtigungen

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

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Schemaregister aufzulisten:

• Erteilen Sie die folgende Berechtigung für den übergeordneten Standort: managedkafka.schemaRegistries.list

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

Mit Rollen auf höherer Ebene wie Managed Kafka Schema Registry Editor (roles/managedkafka.schemaRegistryEditor) und Managed Kafka Schema Registry Admin (roles/managedkafka.schemaRegistryAdmin) können Sie auch Schema-Registries auflisten.

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

Schema-Registries auflisten

So listen Sie alle Schemaregister in Ihrem Projekt auf:

Console

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

   Zu Schema-Registries

   Auf der Seite wird eine Liste der Schemaregistrierungen in Ihrem Projekt angezeigt. Die Liste enthält Spalten für die folgenden Attribute:

   • Name: Die eindeutige Kennung für die Schemaregistrierung.
   • Region: Die Google Cloud Region, in der die Schemaregistrierung gehostet wird.

gcloud

1. Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:

   gcloud init

   Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

2. Führen Sie den Befehl gcloud beta managed-kafka schema-registries list aus:

gcloud beta managed-kafka schema-registries list \
    --location=LOCATION \

Ersetzen Sie Folgendes:

• LOCATION (erforderlich): Die Google Cloud Region, für die Schemaregister aufgelistet werden sollen.

Wenn Sie beispielsweise alle Schemaregister am Standort us-central1 auflisten möchten, führen Sie den folgenden Befehl aus:

gcloud beta managed-kafka schema-registries list --location=us-central1

Beispielausgabe:

NAME             LOCATION
sr_docs      us-central1
sr_docs23    us-central1
sr23wert     us-central1

REST

Verwenden Sie die Methode projects.locations.schemaRegistries.list, um Schemaregister aufzulisten.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_ID: Ihre Google Cloud Projekt-ID
• LOCATION: der Speicherort, an dem Sie die Liste der Schemaregister abrufen möchten, z. B. us-central1

HTTP-Methode und URL:

GET https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "schemaRegistries": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID",
      "contexts": [
        "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID/contexts/.",
        "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID/contexts/CONTEXT_NAME"
      ]
    }
}

Das zurückgegebene JSON-Objekt enthält eine Liste der Schemaregister, die am angegebenen Ort gefunden wurden. Wenn der Abfrageparameter view SCHEMA_REGISTRY_VIEW_FULL ist, enthält die Antwort auch die Kontexte, die mit jeder Schemaregistrierung verknüpft sind.

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