Lorsque vous créez un abonnement, vous l'associez à un sujet et les abonnés peuvent recevoir des messages de l'abonnement. Pour empêcher les abonnés de recevoir des messages, vous pouvez dissocier les abonnements du sujet.
Avant de commencer
- En savoir plus sur les abonnements
- Créez l'un des abonnements suivants : pull, push ou BigQuery.
Rôles et autorisations nécessaires
Pour obtenir l'autorisation nécessaire pour dissocier des abonnements, demandez à votre administrateur de vous accorder le rôle IAM Éditeur Pub/Sub (roles/pubsub.editor) sur le sujet.
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 l'autorisation pubsub.topics.detachSubscription, qui est nécessaire pour dissocier des abonnements.
Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.
Vous pouvez configurer le contrôle des accès au niveau du projet et au niveau de ressources individuelles. Vous pouvez créer un abonnement dans un projet et l'associer à un sujet situé dans un autre projet. Assurez-vous de disposer des autorisations requises pour chaque projet.
Dissocier un abonnement d'un sujet
Vous pouvez dissocier un abonnement d'un sujet à l'aide de la console Google Cloud , de Google Cloud CLI, de la bibliothèque cliente ou de l'API Pub/Sub.
Console
Pour dissocier un abonnement, procédez comme suit :
Dans la console Google Cloud , accédez à la page Sujets.
Sélectionnez le thème dont vous souhaitez dissocier un abonnement.
Dans l'onglet Abonnements, sélectionnez l'abonnement à dissocier.
Sur la page Détails de l'abonnement, cliquez sur Dissocier.
Dans la boîte de dialogue qui s'affiche, cliquez de nouveau sur Dissocier.
gcloud
-
Dans la console Google Cloud , activez Cloud Shell.
En bas de la console Google Cloud , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.
-
Pour dissocier un abonnement, exécutez la commande
gcloud pubsub topics detach-subscription:gcloud pubsub topics detach-subscription SUBSCRIPTION_ID
Si la requête aboutit, la ligne de commande affiche une confirmation :
Detached subscription [SUBSCRIPTION_ID].
REST
Pour dissocier un abonnement, utilisez la méthode projects.subscriptions.detach.
Requête :
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, utilisez la commande
gcloud auth application-default print-access-token.
POST https://pubsub.googleapis.com/v1/projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID:detach Authorization: Bearer ACCESS_TOKEN
Où :
- PROJECT_ID est l'ID de votre projet.
- SUBSCRIPTION_ID est l'ID de votre abonnement.
Réponse :
Si la requête aboutit, la réponse est un objet JSON vide.
C++
Avant d'essayer cet exemple, suivez les instructions de configuration pour C++ dans le guide de démarrage rapide : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la