Lister tous les registres de schémas

Preview

Ce produit ou cette fonctionnalité sont soumis aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités de pré-DG sont proposés "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Vous pouvez lister les registres de schémas dans votre projet. Ce document vous explique comment lister les registres de schémas à l'aide de la consoleGoogle Cloud , de la Google Cloud CLI ou de l'API Managed Kafka.

Rôles et autorisations nécessaires

Pour obtenir les autorisations nécessaires pour lister les registres de schémas, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de registre de schémas Kafka géré (roles/managedkafka.schemaRegistryViewer) sur votre projet et votre emplacement. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour lister les registres de schémas. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour lister les registres de schémas :

• Accordez l'autorisation suivante pour l'emplacement parent : managedkafka.schemaRegistries.list

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Les rôles de niveau supérieur tels que Éditeur du registre de schémas Managed Kafka (roles/managedkafka.schemaRegistryEditor) et Administrateur du registre de schémas Managed Kafka (roles/managedkafka.schemaRegistryAdmin) vous permettent également de lister les registres de schémas.

Pour en savoir plus sur les rôles prédéfinis, consultez la page Rôles prédéfinis de Managed Service pour Apache Kafka.

Lister vos registres de schémas

Pour lister tous vos registres de schémas dans votre projet, procédez comme suit.

Console

1. Dans la console Google Cloud , accédez à la page Registres de schémas.

   Accéder aux registres de schémas

   La page affiche la liste des registres de schémas de votre projet. La liste inclut des colonnes pour les propriétés suivantes :

   • Nom : identifiant unique du registre de schémas.
   • Région : région Google Cloud où est hébergé le registre de schémas.

gcloud

1. Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante :

   gcloud init

   Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

2. Exécutez la commande gcloud beta managed-kafka schema-registries list :

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

Remplacez les éléments suivants :

• LOCATION (obligatoire) : région Google Cloud pour laquelle répertorier les registres de schémas.

Par exemple, pour lister tous les registres de schémas dans l'emplacement us-central1, exécutez la commande suivante :

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

Exemple de résultat :

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

REST

Pour lister les registres de schémas, utilisez la méthode projects.locations.schemaRegistries.list.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet Google Cloud
• LOCATION : emplacement à partir duquel vous souhaitez obtenir la liste des registres de schémas (par exemple, us-central1)

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

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)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Exécutez la commande suivante :

$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

Vous devriez recevoir une réponse JSON de ce type :

{
  "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"
      ]
    }
}

L'objet JSON renvoyé inclut une liste des registres de schémas trouvés à l'emplacement spécifié. Si le paramètre de requête view est défini sur SCHEMA_REGISTRY_VIEW_FULL, la réponse inclut également les contextes associés à chaque registre de schémas.

Apache Kafka® est une marque déposée d'Apache Software Foundation ou de ses filiales aux États-Unis et/ou dans d'autres pays.