Lister les versions d'un sujet

Vous pouvez lister les versions d'un sujet dans un registre de schémas spécifique de votre projet.

Ce document explique comment lister les versions de sujets à l'aide de la consoleGoogle Cloud ou de l'API Managed Kafka.

Rôles et autorisations nécessaires

Pour obtenir les autorisations dont vous avez besoin pour lister les versions de sujet, demandez à votre administrateur de vous accorder le rôle IAM Lecteur du registre de schémas Kafka géré (roles/managedkafka.schemaRegistryViewer) sur votre registre de schémas. 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 versions d'un sujet. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour lister les versions d'un sujet :

Accordez l'autorisation suivante au sujet parent : managedkafka.versions.list

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

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 les versions de schéma dans un sujet

Pour lister toutes les versions d'un sujet dans un registre de schémas spécifique de votre projet, procédez comme suit.

Console

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

Accéder aux registres de schémas
Cliquez sur le nom du registre de schémas où se trouve votre sujet.
Sous Sujets dans ce registre de schémas, cliquez sur le nom du sujet.
Sur la page Détails du sujet, les versions du schéma sont listées sous Toutes les versions.
Facultatif : Pour afficher la définition du schéma d'une version, cochez la case correspondant à l'ID de version. La définition du schéma est affichée sous Définition.
Facultatif : Pour afficher les différences entre deux versions de schéma pour ce sujet, procédez comme suit :
1. Sous Toutes les versions, sélectionnez les versions à comparer.
2. Dans la section Définition, cliquez sur Afficher les différences.
Les deux définitions de schéma sont affichées côte à côte, avec les ajouts, les suppressions et les modifications mis en évidence.

REST

La demande doit être authentifiée à l'aide d'un jeton d'accès dans l'en-tête Authorization. Pour obtenir un jeton d'accès pour les identifiants par défaut actuels de l'application, exécutez la commande suivante : gcloud auth application-default print-access-token.

Pour lister les versions d'un sujet, envoyez une requête GET à la méthode projects.locations.schemaRegistries.subjects.versions.list.

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)

Remplacez les éléments suivants :

PROJECT_ID : ID de votre projet Google Cloud .
LOCATION : région Google Cloud où se trouve le registre de schémas.
REGISTRY_ID : ID de votre registre de schémas.
SUBJECT_ID : ID du sujet.

Exemple :

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)

Ou avec un contexte :

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)

Où :

test-project est l'ID de votre projet Google Cloud .
us-central1 est la région Google Cloud où se trouve le registre de schémas.
test_registry est l'ID de votre registre de schémas.
test_context est l'ID du contexte.
test_subject est l'ID du sujet.

Si la requête aboutit, l'API renvoie un code d'état 200 OK. Le corps de la réponse contient un tableau JSON des versions du sujet.

Voici un exemple de réponse réussie :

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

Pour en savoir plus, consultez la documentation sur la méthode projects.locations.schemaRegistries.subjects.versions.list.

Étapes suivantes

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.