Les abonnés utilisent un abonnement Lite pour lire les messages d'un sujet Lite. Lorsque vous créez un abonnement Lite, vous l'associez à un sujet Lite. Vous pouvez associer de nombreux abonnements Lite à un même sujet Lite.
Il existe deux types d'abonnements:
- Abonnement standard Créez un abonnement standard lorsqu'un client doit lire les messages du sujet Lite.
- Exportez l'abonnement. Créez un abonnement d'exportation lorsque vous devez exporter des messages Lite vers Pub/Sub. Pour en savoir plus, consultez la page Exporter des messages Pub/Sub Lite vers Pub/Sub.
Propriétés d'un abonnement Lite
Un abonnement à un sujet Lite zonal a les mêmes propriétés qu'un abonnement à un sujet Lite régional, à l'exception des éléments suivants:
Type d'emplacement (zone ou région) utilisé dans le nom de la ressource.
us-central1
est un exemple d'emplacement de région, etus-central1-a
est un exemple d'emplacement de zone.Fiabilité. Consultez Réplication des données dans un sujet Lite pour en savoir plus sur les différences de fiabilité entre les sujets régionaux et zonaux.
Critères de distribution des messages
Un échec temporaire lors de l'écriture d'un message dans l'espace de stockage entraîne une nouvelle tentative d'envoi du message par l'éditeur. Ces nouvelles tentatives sont transparentes pour l'utilisateur final. Les abonnements Lite comportent une propriété condition de diffusion qui modifie la façon dont les abonnements réagissent à ces nouvelles tentatives de diffusion des messages. Vous pouvez définir cette propriété sur l'une des deux options suivantes:
Distribuez les messages immédiatement. Lorsque cette option est activée, les clients abonnés reçoivent tous les messages une fois qu'ils sont arrivés sur le serveur. Ce processus ne dépend pas de l'état des messages écrits sur le disque. Les décalages ne sont pas réutilisés, mais les messages dont les décalages ne sont pas écrits dans l'espace de stockage peuvent ne pas être lisibles après une opération de recherche.
Distribuer les messages après leur stockage Lorsque cette option est activée, l'abonné ne reçoit pas les messages tant qu'ils ne sont pas écrits sur le disque. Les messages sont garantis comme étant lisibles après une opération de recherche. L'activation de cette option augmente la latence de bout en bout pour la réception des messages de l'éditeur à l'abonné.
Consignes de dénomination d'un abonnement
Un nom attribué à une ressource Pub/Sub Lite, comme un sujet, un abonnement ou une réservation, permet d'identifier cette ressource de manière unique. Le nom de la ressource doit respecter le format suivant:
projects/project-identifier/collection/ID
project-identifier
: doit correspondre à l'ID ou au numéro de projet, disponible dans la console Google Cloud. Par exemple,my-cool-project
est un ID de projet.123456789123
est un numéro de projet.collection
: doit être défini surtopics
,subscriptions
oureservations
.ID
: doit respecter les consignes suivantes:- ne pas commencer par la chaîne
goog
; - Commencer par une lettre
- contenir entre 3 et 255 caractères ;
- ne contenir que les caractères suivants: lettres
[A-Za-z]
, chiffres[0-9]
, tirets-
, traits de soulignement_
, points.
, tildes~
, signes plus+
et signes pourcentage%
;
Vous pouvez utiliser les caractères spéciaux de la liste précédente dans les noms de ressources sans codage d'URL. Toutefois, vous devez vous assurer que tous les autres caractères spéciaux sont correctement encodés ou décodés lorsque vous les utilisez dans des URL. Par exemple,
mi-tópico
n'est pas un ID valide. En revanche,mi-t%C3%B3pico
est une valeur valide. Ce format est important lorsque vous effectuez des appels REST.- ne pas commencer par la chaîne
Créer un abonnement Lite
Un abonnement Lite doit se trouver dans le même projet et le même emplacement que le sujet Lite auquel il est associé.
Pour créer un sujet Lite, consultez Créer et gérer un sujet Lite.
Pour obtenir la liste des zones disponibles, consultez la section Emplacements Pub/Sub Lite.
Vous pouvez créer un abonnement Lite avec la console Google Cloud, Google Cloud CLI ou l'API Pub/Sub Lite.
Pour savoir comment créer un abonnement d'exportation, consultez la section Exporter des messages Pub/Sub Lite vers Pub/Sub.
Console
Accédez à la page Abonnements Lite.
Cliquez sur Créer un abonnement Lite.
Saisissez un ID d'abonnement Lite.
Choisissez un sujet Lite pour recevoir des messages de celui-ci
Sélectionnez Distribuer les messages immédiatement ou Distribuer les messages après leur stockage.
Choisissez un type de décalage de début.
Choisissez un type de diffusion.
Cliquez sur Créer.
gcloud
Pour créer un abonnement Lite, exécutez la commande gcloud pubsub lite-subscriptions create
:
gcloud pubsub lite-subscriptions create SUBSCRIPTION_ID \ --location=LOCATION \ --topic=TOPIC_ID \ --delivery-requirement=DELIVERY_REQUIREMENT
Remplacez les éléments suivants :
SUBSCRIPTION_ID : ID de l'abonnement Lite
LOCATION : nom d'un emplacement compatible avec Pub/Sub Lite
TOPIC_ID : ID du sujet Lite à associer à l'abonnement Lite.
DELIVERY_REQUIREMENT :
deliver-after-stored
oudeliver-immediately
Si la requête aboutit, la ligne de commande affiche une confirmation :
Created [SUBSCRIPTION_ID].
Protocole
Pour créer un abonnement Lite, envoyez une requête POST
comme suit :
POST https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Remplacez les éléments suivants :
REGION : région dans laquelle stocker l'abonnement Lite
PROJECT_NUMBER : le numéro de projet dans lequel créer l'abonnement Lite
LOCATION : nom d'un emplacement compatible avec Pub/Sub Lite
SUBSCRIPTION_ID : ID de l'abonnement Lite
Spécifiez les champs suivants dans le corps de la requête :
{ "topic": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } }
Remplacez DELIVERY_REQUIREMENT par deliver-after-stored
ou deliver-immediately
.
Si la requête aboutit, la réponse est l'abonnement Lite au format JSON :
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
Go
Avant d'exécuter cet exemple, suivez les instructions de configuration de Go dans la section Bibliothèques clientes de Pub/Sub Lite.
Java
Avant d'exécuter cet exemple, suivez les instructions de configuration de Java dans la section Bibliothèques clientes de Pub/Sub Lite.
Python
Avant d'exécuter cet exemple, suivez les instructions de configuration de Python dans la section Bibliothèques clientes de Pub/Sub Lite.
Après avoir créé un abonnement Lite associé à un sujet Lite, vous pouvez recevoir des messages depuis l'abonnement Lite.
Modifier un abonnement Lite
Vous pouvez mettre à jour des abonnements Lite avec la console Google Cloud, la Google Cloud CLI ou l'API Pub/Sub Lite.
Console
Accédez à la page Abonnements Lite.
Cliquez sur l'ID d'abonnement Lite.
Sur la page Détails de l'abonnement Lite, cliquez sur Modifier.
gcloud
Pour mettre à jour un abonnement Lite, exécutez la commande gcloud pubsub lite-subscriptions update
:
gcloud pubsub lite-subscriptions update SUBSCRIPTION_ID \ --location=LOCATION \ --delivery-requirement=DELIVERY_REQUIREMENT
Remplacez les éléments suivants :
SUBSCRIPTION_ID : ID de l'abonnement Lite
LOCATION : nom de l'emplacement dans lequel l'abonnement Lite se trouve
DELIVERY_REQUIREMENT :
deliver-after-stored
oudeliver-immediately
Si la requête aboutit, la ligne de commande affiche l'abonnement Lite :
deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protocole
Pour mettre à jour un abonnement Lite, envoyez une requête PATCH
comme suit :
PATCH https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID?updateMask=deliveryConfig.deliveryRequirement Authorization: Bearer $(gcloud auth print-access-token)
Remplacez les éléments suivants :
REGION : région dans laquelle stocker l'abonnement Lite
PROJECT_NUMBER : numéro du projet associé à l'abonnement Lite
LOCATION : nom de l'emplacement dans lequel l'abonnement Lite se trouve
SUBSCRIPTION_ID : ID de l'abonnement Lite
Spécifiez les champs suivants dans le corps de la requête :
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } }
Remplacez DELIVERY_REQUIREMENT par deliver-after-stored
ou deliver-immediately
.
Si la requête aboutit, la réponse est l'abonnement Lite au format JSON :
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
Go
Avant d'exécuter cet exemple, suivez les instructions de configuration de Go dans la section Bibliothèques clientes de Pub/Sub Lite.
Java
Avant d'exécuter cet exemple, suivez les instructions de configuration de Java dans la section Bibliothèques clientes de Pub/Sub Lite.
Python
Avant d'exécuter cet exemple, suivez les instructions de configuration de Python dans la section Bibliothèques clientes de Pub/Sub Lite.
Afficher les détails de l'abonnement Lite
Vous pouvez obtenir des détails sur un abonnement Lite à l'aide de la console Google Cloud, de la Google Cloud CLI ou de l'API Pub/Sub Lite.
Console
Accédez à la page Abonnements Lite.
Cliquez sur l'ID d'abonnement Lite.
Sur la page des détails de l'abonnement Lite, cliquez sur l'onglet Détails.
gcloud
Pour obtenir des détails sur un abonnement Lite, utilisez la commande gcloud pubsub lite-subscriptions describe
:
gcloud pubsub lite-subscriptions describe SUBSCRIPTION_ID \ --location=LOCATION
Remplacez les éléments suivants :
SUBSCRIPTION_ID : ID de l'abonnement Lite
LOCATION : nom de l'emplacement dans lequel l'abonnement Lite se trouve
Si la requête aboutit, la ligne de commande affiche le sujet Lite :
deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protocole
Pour obtenir des détails sur un abonnement Lite, envoyez une requête GET
comme suit :
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Remplacez les éléments suivants :
REGION : région dans laquelle stocker l'abonnement Lite
PROJECT_NUMBER : numéro du projet associé à l'abonnement Lite
LOCATION : nom de l'emplacement dans lequel l'abonnement Lite se trouve
SUBSCRIPTION_ID : ID de l'abonnement Lite
Si la requête aboutit, la réponse est le sujet Lite au format JSON :
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
Go
Avant d'exécuter cet exemple, suivez les instructions de configuration de Go dans la section Bibliothèques clientes de Pub/Sub Lite.
Java
Avant d'exécuter cet exemple, suivez les instructions de configuration de Java dans la section Bibliothèques clientes de Pub/Sub Lite.
Python
Avant d'exécuter cet exemple, suivez les instructions de configuration de Python dans la section Bibliothèques clientes de Pub/Sub Lite.
Répertorier les abonnements Lite
Vous pouvez répertorier les abonnements Lite d'un projet ou les abonnements Lite associés à un sujet Lite.
Répertorier les abonnements Lite dans un projet
Vous pouvez répertorier les abonnements Lite dans un projet à l'aide de la console Google Cloud, de Google Cloud CLI ou de l'API Pub/Sub Lite.
Console
Accédez à la page Abonnements Lite.
gcloud
- Pour répertorier les abonnements Lite d'un projet, exécutez la commande
gcloud pubsub lite-subscriptions list
:
gcloud pubsub lite-subscriptions list \ --location=LOCATION
Remplacez LOCATION par le nom de l'emplacement dans lequel les abonnements Lite se trouvent.
Si la requête aboutit, la ligne de commande affiche les abonnements Lite :
--- deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID --- deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protocole
- Pour répertorier les abonnements Lite d'un projet, envoyez une requête
GET
comme suit :
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/subscriptions Authorization: Bearer $(gcloud auth print-access-token)
Remplacez les éléments suivants :
REGION : région dans laquelle stocker l'abonnement Lite
PROJECT_NUMBER : numéro du projet associé à l'abonnement Lite
Si la requête aboutit, la réponse est le sujet Lite au format JSON :
{ "subscriptions": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" } ] }
Go
Avant d'exécuter cet exemple, suivez les instructions de configuration de Go dans la section Bibliothèques clientes de Pub/Sub Lite.
Java
Avant d'exécuter cet exemple, suivez les instructions de configuration de Java dans la section Bibliothèques clientes de Pub/Sub Lite.
Python
Avant d'exécuter cet exemple, suivez les instructions de configuration de Python dans la section Bibliothèques clientes de Pub/Sub Lite.
Répertorier les abonnements Lite associés à un sujet Lite
Vous pouvez répertorier les abonnements Lite à un sujet Lite à l'aide de la console Google Cloud, du Google Cloud CLI ou de l'API Pub/Sub Lite.
Console
Accédez à la page Sujets Lite.
Sélectionnez un ID de sujet Lite.
Sur la page de détails des sujets Lite, la section Abonnements Lite inclut une liste des abonnements Lite au sujet Lite.
gcloud
- Pour répertorier les abonnements Lite à un sujet, utilisez la commande
gcloud pubsub lite-topics list-subscriptions
:
gcloud pubsub lite-topics list-subscriptions TOPIC_ID \ --location=LOCATION
Remplacez les éléments suivants :
TOPIC_ID : ID du sujet Lite auquel les abonnements Lite sont associés.
LOCATION : nom de l'emplacement dans lequel l'abonnement Lite se trouve
Si la requête aboutit, la ligne de commande affiche les abonnements Lite :
--- deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID --- deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protocole
- Pour répertorier les abonnements Lite à un sujet Lite, envoyez une requête
GET
comme suit :
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/lite-topics/TOPIC_ID/subscriptions Authorization: Bearer $(gcloud auth print-access-token)
Remplacez les éléments suivants :
REGION : région dans laquelle stocker l'abonnement Lite
PROJECT_NUMBER : numéro du projet associé à l'abonnement Lite
LOCATION : nom de l'emplacement dans lequel l'abonnement Lite se trouve
TOPIC_ID : ID du sujet Lite auquel les abonnements Lite sont associés.
Si la requête aboutit, la réponse est une liste d'abonnements Lite au format JSON :
{ "subscriptions": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" } ] }
Go
Avant d'exécuter cet exemple, suivez les instructions de configuration de Go dans la section Bibliothèques clientes de Pub/Sub Lite.
Java
Avant d'exécuter cet exemple, suivez les instructions de configuration de Java dans la section Bibliothèques clientes de Pub/Sub Lite.
Python
Avant d'exécuter cet exemple, suivez les instructions de configuration de Python dans la section Bibliothèques clientes de Pub/Sub Lite.
Supprimer un abonnement Lite
Vous pouvez supprimer des abonnements Lite à l'aide de la console Google Cloud, de la Google Cloud CLI ou de l'API Pub/Sub Lite.
Console
Accédez à la page Abonnements Lite.
Cliquez sur l'ID d'abonnement Lite.
Sur la page Informations sur l'abonnement Lite, cliquez sur Supprimer.
Dans la boîte de dialogue qui s'affiche, cliquez sur Supprimer pour confirmer la suppression de l'abonnement Lite.
gcloud
Pour supprimer un abonnement Lite, exécutez la commande gcloud pubsub lite-subscriptions delete
:
Exécutez la commande
delete
:gcloud pubsub lite-subscriptions delete SUBSCRIPTION_ID \ --location=LOCATION
Remplacez les éléments suivants :
SUBSCRIPTION_ID : ID de l'abonnement Lite
LOCATION : nom de l'emplacement dans lequel l'abonnement Lite se trouve
Pour confirmer, saisissez
Y
.
Si la requête aboutit, la ligne de commande affiche une confirmation :
Deleted subscription [SUBSCRIPTION_ID].
Protocole
- Pour supprimer un sujet Lite, envoyez une requête
DELETE
comme suit :
DELETE https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Remplacez les éléments suivants :
REGION : région dans laquelle stocker l'abonnement Lite
PROJECT_NUMBER : numéro du projet associé à l'abonnement Lite
LOCATION : nom de l'emplacement dans lequel l'abonnement Lite se trouve
SUBSCRIPTION_ID : ID de l'abonnement Lite
Si la requête aboutit, la réponse est un objet JSON vide.
Go
Avant d'exécuter cet exemple, suivez les instructions de configuration de Go dans la section Bibliothèques clientes de Pub/Sub Lite.
Java
Avant d'exécuter cet exemple, suivez les instructions de configuration de Java dans la section Bibliothèques clientes de Pub/Sub Lite.
Python
Avant d'exécuter cet exemple, suivez les instructions de configuration de Python dans la section Bibliothèques clientes de Pub/Sub Lite.
Étape suivante
- Créez et gérez un sujet Lite.
- Publier des messages dans un sujet Lite
- Recevoir des messages à partir d'un abonnement Lite