Ce document explique comment effectuer un rollback du schéma d'une application Pub/Sub sur un sujet.
L'opération de rollback vous permet de créer une autre révision du schéma avec la définition du schéma que la révision précédente spécifiée.
Avant de commencer
- Découvrez le fonctionnement des schémas Pub/Sub.
- Créez un schéma.
Rôles et autorisations requis
Pour obtenir les autorisations nécessaires pour effectuer
un rollback des schémas et les gérer,
demandez à votre administrateur de vous accorder le
Rôle IAM Éditeur Pub/Sub (roles/pubsub.editor
) sur votre projet.
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.
Ce rôle prédéfini contient les autorisations requises pour effectuer un rollback des schémas et les gérer. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour effectuer le rollback des schémas et les gérer:
-
Créez un schéma:
pubsub.schemas.create
-
Associez le schéma au sujet:
pubsub.schemas.attach
-
Effectuez un commit d'une révision du schéma:
pubsub.schemas.commit
-
Supprimez un schéma ou une révision de schéma:
pubsub.schemas.delete
-
Obtenez un schéma ou des révisions de schéma:
pubsub.schemas.get
-
Listez les schémas:
pubsub.schemas.list
-
Répertoriez les révisions de schéma:
pubsub.schemas.listRevisions
-
Effectuez le rollback d'un schéma:
pubsub.schemas.rollback
-
Pour valider un message:
pubsub.schemas.validate
-
Obtenez la stratégie IAM pour un schéma:
pubsub.schemas.getIamPolicy
-
Configurez la stratégie IAM pour un schéma:
pubsub.schemas.setIamPolicy
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Vous pouvez attribuer des rôles et des autorisations à des comptes principaux des domaines ou des comptes de service. Vous pouvez créer un schéma dans un projet à un sujet situé dans un autre projet. Assurez-vous de disposer des autorisations requises pour chaque projet.
Effectuer un rollback de la révision du schéma
Vous pouvez effectuer un rollback du schéma la console Google Cloud, la gcloud CLI, l'API Pub/Sub, ou les bibliothèques clientes Cloud. Procédez comme suit :
Console
Dans la console Google Cloud, accédez à la page Schémas Pub/Sub.
Cliquez sur le nom d'un schéma existant.
La page Détails du schéma du schéma s'ouvre.
Cliquez sur Restaurer.
La boîte de dialogue Effectuer un rollback du schéma s'ouvre.
Sélectionnez la révision vers laquelle vous souhaitez effectuer le rollback de votre schéma.
Cliquez sur Confirmer pour enregistrer l'opération de rollback.
Une nouvelle révision est créée avec le schéma spécifié dans la section opération de rollback.
Sur la page Détails du schéma, sélectionnez la dernière version du schéma. et la version que vous avez sélectionnée comme source pour l'opération de rollback.
Cliquez sur Afficher les différences.
Vous pouvez vérifier que les deux schémas sont identiques.
Vous pouvez utiliser la révision de schéma que vous venez de créer comme dernière révision pour valider un sujet en mettant à jour le champ Dernière révision autorisée.
gcloud
gcloud pubsub schemas rollback SCHEMA_ID \ --revision-id=REVISION_ID
Où :
- REVISION_ID est la révision vers laquelle vous souhaitez effectuer un rollback.
REST
Pour effectuer le rollback d'un schéma, envoyez une requête POST semblable à celle-ci:
POST https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID:rollback Authorization: Bearer $(gcloud auth application-default print-access-token) Content-Type: application/json --data @response-body.json
Spécifiez les champs suivants dans le corps de la requête :
{ "revisionId": REVISION_KD }
Où :
- REVISION_KD est l'ID de la révision vers laquelle effectuer le rollback.
Le corps de la réponse doit contenir une représentation JSON d'une ressource de schéma.
C++
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage C++ qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour C++.
Go
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Go qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Go.
Java
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Java qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Java.
Python
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Python qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Python.
Node.js
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Node.js qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Node.js.
Node.js
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Node.js qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Node.js.
Étape suivante
- Supprimer une révision de schéma
- Supprimer un schéma
- Lister les schémas
- Répertorier les révisions d'un schéma
- S'abonner à un sujet avec un schéma