Ce document explique comment créer, afficher et supprimer un objet Pub/Sub Lite sur un sujet.
Présentation d'un sujet Lite
Un service Pub/Sub Lite nécessite un sujet auquel les éditeurs peuvent envoyer messages afin que les abonnés puissent les recevoir. Dans Pub/Sub Lite, vous pouvez choisir de créer une instance Lite zonale ou régionale sur un sujet.
La seule différence entre un sujet Lite zonal et un sujet Lite régional dépend de la façon dont ils se répliquent données. Toutes les autres propriétés de sujet sont identiques à celles décrites dans une section ultérieure de ce document.
Réplication de données dans un sujet Lite
Les sujets régionaux Pub/Sub Lite stockent les données dans deux zones d'une même région. Réplication des sujets zonaux Pub/Sub Lite dans une seule zone. Pub/Sub Lite réplique les données de manière asynchrone.
La disponibilité de Pub/Sub Lite dépend de la disponibilité ses composants sous-jacents, y compris l'interface et stockage.
La disponibilité d'un sujet zonal Pub/Sub Lite dépend de la la disponibilité de l'interface de l'application et du stockage dans la zone. Si le frontend de l'application ou le stockage rencontre un échec zonal, le sujet Lite zonal devient indisponible pendant toute la durée de l'indisponibilité.
La disponibilité d'un sujet régional Pub/Sub Lite dépend de la la disponibilité de l'interface et du stockage de l'application dans la région configurée. Les types de défaillance suivants sont possibles:
Si le stockage ou le frontend de l'application fait l'objet d'une défaillance zonale, le sujet Lite régional reste disponible.
Si le frontend de l'application et le stockage font l'objet d'une défaillance zonale, le sujet Lite régional reste disponible tant que les deux composants ne commencent pas à échouer en même temps.
Si l'interface de l'application et le stockage échouent simultanément, le sujet Lite régional reste indisponible pendant toute la durée de l'indisponibilité. Pendant cette période, les clients peuvent ne pas réussir à publier ni à consommer des messages, mais les messages sont toujours distribués dans l'ordre correct.
Un sujet Lite régional fournit une protection contre la plupart des types de zones uniques d'échecs. Cependant, dans de rares cas, la nature asynchrone de la réplication peut provoque une défaillance simultanée de plusieurs composants dans une seule zone. En tant que résultat, un sujet Lite régional devient indisponible.
Propriétés d'un sujet Lite
Les sujets Lite ont les propriétés suivantes:
Nombre de partitions. Une partition est l'unité de base du parallélisme dans et Pub/Sub Lite. Un sujet Lite peut comporter une ou plusieurs partitions.
Capacité d'une partition. La capacité d'une partition est décrite par les trois propriétés suivantes :
Débit en publication (Mbit/s). Le taux maximal auquel vous pouvez publier des messages.
Débit en abonnement (Mio/s) Le taux maximal qui permet de transférer les messages vers les abonnements Lite.
Espace de stockage (Gio). Taille maximale des messages dans la partition. La capacité configurable minimale d'une partition est de 30 Gio.
Capacité de stockage d'un sujet Lite. Toutes les partitions d'un sujet Lite ont la même capacité de stockage configurée. La capacité de stockage totale d'un sujet Lite correspond à la somme de la capacité de stockage de toutes les partitions du sujet. Pour Exemple : si un sujet Lite comporte huit partitions et que chacune d'elles est de taille 30 Gio, la capacité de stockage totale du sujet Lite est de 240 Gio (8 x 30).
Capacité de débit d'un sujet Lite. La capacité de débit correspond à la capacité de débit totale de publication et d'abonnement de toutes les partitions du sujet Lite. Même si l'ensemble d'un sujet peut accompagner 1 Gbit/s de débit en publication, il s'agit de la limite de publication par partition que limite efficacement le débit.
Limite du client abonné et des abonnements. Pub/Sub Lite prend en charge un seul client abonné pour une seule partition et un seul abonnement. Par exemple, un abonnement à un sujet avec 5 partitions peut avoir cinq clients abonnés au maximum qui consomment ses messages. Si davantage de clients abonnés sont configurés, les clients en trop restent inactifs. Le même sujet avec deux abonnements peut comporter jusqu'à 10 clients abonnés, cinq clients pour chaque abonnement.
Réservations. Une réservation est le moyen le plus simple de provisionner et de gérer de débit pour un certain nombre de sujets. Provisionnement de la capacité de débit avec des réservations est obligatoire pour la version Lite régionale et facultatif pour les zones Sujets Lite.
Si vous n'utilisez pas de réservations pour un sujet Lite zonal, vous devez explicitement la capacité de débit en publication et en abonnement du sujet. Sans réservation, toutes les partitions d'un sujet Lite ont la même capacité de débit configurée. Pour en savoir plus, consultez Configurer la capacité de débit sans réservations.
Configuration du stockage. Pour configurer le stockage, vous devez spécifier la capacité de stockage et éventuellement la durée de conservation des messages.
Durée de conservation des messages. Durée maximale d'un cycle Lite stocke les messages. Si vous ne spécifiez pas de durée de conservation des messages, le Le sujet Lite stocke les messages jusqu'à ce que vous dépassiez la capacité de stockage.
Capacité de stockage. La capacité du sujet Pub/Sub Lite est déterminée par le nombre de partitions du sujet et la capacité de stockage de chaque partition. Le stockage par partition correspond à la quantité d'espace de stockage, en octets, pour chaque partition. Notez que les sujets Lite régionaux utilisent deux octets de stockage pour chaque octet publié. Les sujets Lite zonaux utilisent un octet de stockage pour chaque octet publié.
Si vous dépassez la capacité de stockage, le service Pub/Sub Lite continue de publier des messages. Toutefois, afin de créer plus de capacité de stockage, les messages les plus anciens de la partition sont supprimés. La suppression de les messages les plus anciens apparaissent même s'ils figurent dans le message et la durée de conservation. Le service ne supprime jamais les messages avant leur valeur TTL. expire, sauf si sa suppression est nécessaire afin de faire de la place pour messages. Pour plus d'informations sur le lien entre la capacité et la tarification, consultez la page Pub/Sub Tarification Lite.
Consignes pour nommer un sujet
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 du 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
: saisisseztopics
,subscriptions
oureservations
.ID
: doit respecter les consignes suivantes :- ne doivent 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 de 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 codés ou décodés lorsque vous les utilisez dans des URL. Par exemple,
mi-tópico
est un ID non valide. En revanche,mi-t%C3%B3pico
est une valeur valide. Ce format est important lorsque vous effectuez des appels REST.- ne doivent pas commencer par la chaîne
Augmenter la capacité de débit d'un sujet Lite
Si vous n'utilisez pas de réservations Lite, vous pouvez définir la capacité de débit de chaque partition de n'importe quel sujet Lite zonal sur une valeur définie par les limites suivantes :
Débit en publication compris entre 4 et 16 Mbit/s
Débit en abonnement compris entre 4 et 32 Mbit/s
Ces limites s'appliquent également aux partitions associées à une réservation Lite. Avec les réservations, chaque partition peut consommer n'importe quelle capacité de débit dans les limites spécifiées, à condition que la capacité totale de la réservation ne soit pas dépassée. Vous pouvez éventuellement définir une limite inférieure pour le le débit réel par partition pour rendre votre trafic plus prévisible.
Vous pouvez augmenter le nombre de partitions d'un sujet pour l'adapter horizontalement. Le nombre de partitions d'un sujet ne peut pas être réduit.
Lorsque vous modifiez le nombre de partitions, l'ordre relatif des messages n'est pas préservées. En interne, les messages sont attribués à des partitions à l'aide d'un hachage . La mise à jour du nombre de partitions dans un sujet modifie cette fonction de hachage. Messages avec la même clé publiés après la mise à jour du nombre de partitions sont susceptibles d'être mappées sur une partition différente de celles publiées avant mise à jour.
En outre, le redimensionnement du sujet prend quelques secondes pour se propager à tous aux éditeurs. Il est donc possible que certains de ces éditeurs utilisent la nouvelle fonction de hachage pendant un court laps de temps alors que d'autres continuent d'utiliser l'ancienne.
Augmenter la capacité de stockage d'un sujet Lite
Vous pouvez augmenter ou diminuer l'espace de stockage dans un sujet Lite. Le sujet Lite provisionne la même quantité d'espace de stockage sur chaque partition. Si vous augmentez le stockage à 60 Gio, chacune des partitions dispose de 60 Gio d'espace de stockage.
Si vous réduisez la quantité de stockage dans un sujet Lite, le service Pub/Sub Lite supprime d'abord les messages les plus anciens.
Pour en savoir plus sur le lien entre la capacité et la tarification, consultez la page Tarifs de Pub/Sub Lite.
Créer un sujet Lite
Vous pouvez créer des sujets Lite avec la console Google Cloud, la Google Cloud CLI ou l'API Pub/Sub Lite.
Pour obtenir la liste des régions et zones disponibles, consultez la section Emplacements Pub/Sub Lite.
Console
Accédez à la page Sujets Lite.
Cliquez sur Créer un sujet Lite.
Pour créer un sujet Lite zonal, sélectionnez une région et une zone dans cette région.
Pour créer un sujet Lite régional, sélectionnez une région.
Vous ne pouvez pas modifier l'emplacement d'un sujet après sa création.
Dans la section Nom, saisissez un ID de sujet Lite.
Le nom du sujet Lite inclut l'ID du sujet Lite, l'emplacement et le numéro du projet.
Dans la section Débit:
Sélectionnez ou créez une réservation.
Cette option est facultative pour un sujet Lite zonal et obligatoire pour un sujet Lite régional.
Saisissez le débit maximal en publication et le débit maximal en abonnement.
Un certain nombre de partitions sont définies automatiquement en fonction de vos entrées. Vous pouvez modifier ce nombre après avoir enregistré le sujet.
Dans la section Stockage des messages:
Saisissez l'espace de stockage par partition.
Sélectionnez l'une des deux options pour la durée de conservation des messages.
Examinez les modifications, puis cliquez sur Créer.
gcloud
Pour créer un sujet Lite, utilisez la commande gcloud pubsub lite-topics create
:
gcloud pubsub lite-topics create TOPIC_ID \ --location=LOCATION \ --partitions=NUMBER_OF_PARTITIONS \ --per-partition-bytes=STORAGE_PER_PARTITION \ [--throughput-reservation=RESERVATION_NAME \] [--message-retention-period=MESSAGE_RETENTION_PERIOD]
Remplacez l'élément suivant :
TOPIC_ID: ID du sujet Lite
LOCATION : nom d'un emplacement compatible avec Pub/Sub Lite
NUMBER_OF_PARTITIONS: un entier représentant le nombre de partitions dans le sujet Lite
STORAGE_PER_PARTITION : quantité de stockage pour chaque partition, par exemple
30GiB
RESERVATION_NAME : chemin d'accès complet d'une réservation Lite, par exemple
projects/123456789/locations/us-west1/reservations/my-reservation
.MESSAGE_RETENTION_PERIOD : durée pendant laquelle le sujet Lite stocke des messages, tels que
1d
ou2w
.
Si la requête aboutit, la ligne de commande affiche une confirmation :
Created [TOPIC_ID].
Protocole
Pour créer un sujet Lite, envoyez une requête POST
comme suit :
POST https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
Remplacez les éléments suivants :
REGION : région dans laquelle stocker le sujet Lite
PROJECT_NUMBER: le numéro de projet dans lequel créer le sujet Lite
LOCATION : nom d'un emplacement compatible avec Pub/Sub Lite
TOPIC_ID: ID du sujet Lite
Spécifiez les champs suivants dans le corps de la requête :
{ "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, "reservationConfig": { "throughputReservation": RESERVATION_NAME } }
Remplacez l'élément suivant :
NUMBER_OF_PARTITIONS: un entier représentant le nombre de partitions dans le sujet Lite
STORAGE_PER_PARTITION : quantité de stockage pour chaque partition, par exemple
30GiB
publish_CAPACITY : entier correspondant à la capacité de débit de publication de chaque partition
subscribe_CAPACITY: entier pour le débit en abonnement capacité de chaque partition
MESSAGE_RETENTION_PERIOD : durée pendant laquelle le sujet Lite stocke des messages, tels que
1d
ou2w
.RESERVATION_NAME : chemin d'accès complet d'une réservation Lite, par exemple
projects/123456789/locations/us-west1/reservations/my-reservation
.
Si la requête aboutit, la réponse est le sujet Lite au format JSON:
{ "name": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, "reservationConfig": { "throughputReservation": RESERVATION_NAME } }
Go
Avant d'exécuter cet exemple, suivez les instructions de configuration pour Go décrites dans l'article Bibliothèques clientes 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éé le sujet Lite, vous pouvez adapter le débit et la capacité de stockage par partition. Vous pouvez également augmenter, mais pas diminuer le nombre de partitions.
Mettre à jour un sujet Lite
Vous pouvez mettre à jour les propriétés suivantes d'un sujet Lite :
Réservation associée au sujet Lite
Nombre de partitions dans le sujet (vous ne pouvez l'augmenter que)
Limites de capacité de débit en publication et en abonnement
Le stockage par partition
Type de conservation des messages
Avant de procéder au scaling de la capacité de débit ou de stockage d'une reportez-vous aux sections Effectuer le scaling de la capacité de débit et Effectuer le scaling du stockage capacité.
Vous pouvez mettre à jour un sujet Lite avec la console Google Cloud, la Google Cloud CLI ou l'API Pub/Sub Lite.
Console
Accédez à la page Sujets Lite.
Cliquez sur l'ID de sujet Lite.
Cliquez sur Modifier.
Vous pouvez apporter les modifications suivantes:
- Utilisez une autre réservation. Pour les sujets zonaux, vous pouvez choisir de ne pas utiliser de réservation.
- Saisissez le nombre de partitions. Cette valeur peut être augmentée, mais pas diminuée.
- Activez ou désactivez le débit maximal autorisé en publication et en abonnement.
- Pour les sujets zonaux, mettez à jour le débit réservé en publication et en abonnement. Pour les sujets associés à une réservation, le débit mis à jour reflète la nouvelle limite maximale.
- Modifiez la capacité de stockage par partition.
- Modifiez la durée de conservation des messages.
Cliquez sur Mettre à jour.
gcloud
Pour mettre à jour un sujet Lite, utilisez la commande gcloud pubsub lite-topics update
:
gcloud pubsub lite-topics update TOPIC_ID \ --location=LOCATION \ --partitions=NUMBER_OF_PARTITIONS \ --per-partition-publish-mib=publish_CAPACITY \ --per-partition-subscribe-mib=subscribe_CAPACITY \ --per-partition-bytes=STORAGE_PER_PARTITION \ --message-retention-period=MESSAGE_RETENTION_PERIOD
Remplacez l'élément suivant :
TOPIC_ID: ID du sujet Lite
LOCATION : nom de l'emplacement dans lequel se trouve le sujet Lite.
NUMBER_OF_PARTITIONS : nombre de partitions à configurer pour le sujet Lite.
publish_CAPACITY: entier pour le débit en publication capacité de chaque partition
subscribe_CAPACITY: entier pour le débit en abonnement capacité de chaque partition
STORAGE_PER_PARTITION : quantité de stockage pour chaque partition, par exemple
30GiB
MESSAGE_RETENTION_PERIOD : durée pendant laquelle le sujet Lite stocke des messages, tels que
1d
ou2w
.
Si la requête aboutit, la ligne de commande affiche le sujet Lite:
name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOD
Protocole
Pour mettre à jour un sujet Lite, envoyez une requête PATCH
comme suit:
PATCH https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID?updateMask=partitionConfig.capacity,retentionConfig.perPartitionBytes,retentionConfig.period,partitionConfig.count Authorization: Bearer $(gcloud auth print-access-token)
Remplacez les éléments suivants :
REGION : région dans laquelle se trouve le sujet Lite
PROJECT_NUMBER : numéro du projet contenant le sujet Lite
LOCATION : nom de l'emplacement dans lequel se trouve le sujet Lite.
TOPIC_ID: ID du sujet Lite
Spécifiez les champs suivants dans le corps de la requête :
{ "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
Remplacez les éléments suivants :
publish_CAPACITY: entier pour le débit en publication capacité de chaque partition
subscribe_CAPACITY: entier pour le débit en abonnement capacité de chaque partition
STORAGE_PER_PARTITION : quantité de stockage pour chaque partition, par exemple
30GiB
MESSAGE_RETENTION_PERIOD : durée pendant laquelle le sujet Lite stocke des messages, tels que
1d
ou2w
.NUMBER_OF_PARTITIONS : nombre de partitions à configurer pour le sujet Lite.
Si la requête aboutit, la réponse est le sujet Lite au format JSON:
{ "name": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
Go
Avant d'exécuter cet exemple, suivez les instructions de configuration pour Go décrites dans l'article Bibliothèques clientes 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 du sujet Lite
Vous pouvez obtenir des détails sur un sujet 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 Sujets Lite.
Cliquez sur l'ID de sujet Lite.
gcloud
Pour obtenir des détails sur un sujet Lite, utilisez la commande gcloud pubsub lite-topics describe
:
gcloud pubsub lite-topics describe TOPIC_ID \ --location=LOCATION
Remplacez l'élément suivant :
TOPIC_ID: ID du sujet Lite
LOCATION : nom de l'emplacement dans lequel se trouve le sujet Lite.
Si la requête aboutit, la ligne de commande affiche le sujet Lite:
name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOD
Protocole
Pour obtenir des détails sur un sujet Lite, envoyez une requête GET
comme suit:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
Remplacez les éléments suivants :
REGION : région dans laquelle se trouve le sujet Lite
PROJECT_NUMBER : numéro du projet contenant le sujet Lite
LOCATION : nom de l'emplacement dans lequel se trouve le sujet Lite.
TOPIC_ID: ID du sujet Lite
Si la requête aboutit, la réponse est le sujet Lite au format JSON:
{ "name": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
Go
Avant d'exécuter cet exemple, suivez les instructions de configuration pour Go décrites dans l'article Bibliothèques clientes 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 sujets Lite
Vous pouvez répertorier des sujets Lite dans un projet à l'aide de la console Google Cloud, de la Google Cloud CLI ou de l'API Pub/Sub Lite.
Console
Pour afficher la liste des sujets Lite d'un projet, accédez à la page Sujets Lite.
gcloud
- Pour répertorier les sujets Lite d'un projet, utilisez la commande
gcloud pubsub lite-topics list
:
gcloud pubsub lite-topics list \ --location=LOCATION
Remplacez LOCATION par le nom de l'emplacement dans lequel se trouve le sujet Lite.
Si la requête aboutit, la ligne de commande affiche les sujets Lite:
--- name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOND --- name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOND
Protocole
Pour répertorier les sujets Lite d'un projet, envoyez une requête GET
comme suit:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/topics Authorization: Bearer $(gcloud auth print-access-token)
Remplacez les éléments suivants :
REGION : région dans laquelle se trouve le sujet Lite
PROJECT_NUMBER: numéro du projet contenant le sujet Lite
Si la requête aboutit, la réponse est une liste de sujets Lite au format JSON :
{ "topics": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }, { "name": "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.
Supprimer un sujet Lite
Vous pouvez supprimer des sujets Lite à l'aide de la console Google Cloud, de la Google Cloud CLI, ou l'API Pub/Sub Lite.
Console
Accédez à la page Sujets Lite.
Cliquez sur l'ID de sujet Lite.
Sur la page Détails du sujet Lite, cliquez sur Supprimer.
Dans le champ qui s'affiche, saisissez
delete
pour confirmer la suppression du sujet Lite.Cliquez sur Supprimer.
gcloud
Pour supprimer un sujet Lite, utilisez la commande gcloud pubsub lite-topics delete
:
Exécutez la commande
delete
:gcloud pubsub lite-topics delete TOPIC_ID \ --location=LOCATION
Remplacez l'élément suivant :
TOPIC_ID: ID du sujet Lite
LOCATION : nom de l'emplacement dans lequel se trouve le sujet Lite.
Pour confirmer, saisissez
Y
.
Si la requête aboutit, la réponse est la suivante :
Deleted topic [TOPIC_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/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
Remplacez les éléments suivants :
REGION : région dans laquelle se trouve le sujet Lite
PROJECT_NUMBER : numéro du projet contenant le sujet Lite
LOCATION : nom de l'emplacement dans lequel se trouve le sujet Lite.
TOPIC_ID: ID du sujet 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 pour Go décrites dans l'article Bibliothèques clientes 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.
Si vous supprimez un sujet Lite, vous ne pouvez plus publier de messages dessus. Les abonnements au sujet Lite existent toujours, mais vous ne pouvez pas recevoir de messages provenant de ces abonnements Lite.
Étape suivante
- Publier des messages dans un sujet Lite
- Créez un abonnement Lite associé à un sujet Lite.
- Recevoir des messages à partir d'un abonnement Lite