En este documento, se explica cómo crear, ver y borrar un tema de Pub/Sub Lite.
Descripción general de un tema de Lite
Un servicio de Pub/Sub Lite requiere un tema al que los publicadores puedan enviar para que los suscriptores puedan recibirlos. En un radio de Pub/Sub Lite, puedes crear un entorno Lite zonal o regional en este tema.
Los temas Lite zonales y regionales de Lite solo se diferencian en la forma en que se replican de datos no estructurados. Todas las demás propiedades de temas son las mismas que se describen en una sección posterior de este documento.
Replicación de datos en un tema Lite
Los temas regionales de Pub/Sub Lite almacenan datos en dos zonas de una sola región. Replicación de temas zonales de Pub/Sub Lite datos dentro de una sola zona. Pub/Sub Lite replica datos de forma asíncrona.
La disponibilidad de Pub/Sub Lite depende de la disponibilidad de sus componentes subyacentes, que incluyen el frontend y el almacenamiento de la aplicación.
La disponibilidad de un tema zonal de Pub/Sub Lite depende de la disponibilidad del frontend de la aplicación y del almacenamiento en su zona configurada. Si el frontend o el almacenamiento de la aplicación experimenta una falla zonal, el El tema zonal Lite no estará disponible mientras dure la interrupción.
La disponibilidad de un tema regional de Pub/Sub Lite depende de la disponibilidad del frontend de la aplicación y el almacenamiento en la región configurada. Los siguientes tipos de fallas son posibles:
Si el frontend de la aplicación o el almacenamiento experimentan una falla zonal, el tema regional de Lite siga estando disponible.
Si el frontend de la aplicación y el almacenamiento experimentan una falla zonal, el tema de Lite regional seguirá disponible, siempre y cuando ambos componentes no comiencen a fallar al mismo tiempo.
Si el frontend y el almacenamiento de la aplicación fallan de forma simultánea, el tema regional Lite no estará disponible mientras dure la interrupción. Durante este tiempo, es posible que los clientes no puedan publicar o consumir mensajes, pero estos aún se entreguen en el orden correcto.
Un tema Lite regional proporciona protección contra la mayoría de los tipos de fallas de una sola zona. Sin embargo, en casos excepcionales, la naturaleza asíncrona de la replicación puede causar una falla simultánea de varios componentes en una sola zona. Como resultado, un tema Lite regional deja de estar disponible.
Propiedades de un tema de Lite
Los temas de Lite tienen las siguientes propiedades:
Cantidad de particiones. Una partición es la unidad básica de paralelismo en Pub/Sub Lite. Un tema Lite puede tener una o más particiones.
Capacidad de una partición. La capacidad de una partición se describe con las siguientes tres propiedades:
Capacidad de procesamiento de publicación (MiBps). La velocidad máxima a la que puedes publicar mensajes.
Capacidad de procesamiento de suscripción (MiBps). La tasa máxima a la que se reenvían los mensajes a las suscripciones Lite.
Almacenamiento (GiB) El tamaño máximo de los mensajes en la partición. La capacidad configurable mínima de una partición es de 30 GiB.
Capacidad de almacenamiento de un tema Lite. Todas las particiones de un tema Lite con la misma capacidad de almacenamiento configurada. La capacidad de almacenamiento total de un Lite es la suma de la capacidad de almacenamiento de todas las particiones del tema. Para Por ejemplo, si un tema de Lite tiene 8 particiones y cada partición es de tamaño 30 GiB, la capacidad de almacenamiento total del tema Lite es de 240 GiB (8 x 30).
Capacidad de procesamiento de un tema Lite. La capacidad de procesamiento consiste en de capacidad de procesamiento de publicación y suscripción de todas las particiones del Lite. Incluso si tienes un tema que, en conjunto, puede respaldar 1 GiBps de capacidad de procesamiento de publicación, es el límite de publicación por partición que limita eficazmente la capacidad de procesamiento.
Límite de suscripciones y clientes suscriptores. Pub/Sub Lite admite un único cliente suscriptor para una sola partición y un único suscripción. Por ejemplo, una suscripción a un tema con 5 particiones puede tener, como máximo, 5 clientes suscriptores que consumen mensajes de él. Si tienes más suscriptores de la configuración predeterminada, los clientes excedentes permanecen inactivos. El mismo tema con 2 Las suscripciones pueden tener hasta 10 clientes suscriptores, 5 clientes por cada uno suscripción.
Reservas. Una reserva es la forma más fácil de aprovisionar y administrar la capacidad de procesamiento de varios temas. Cómo aprovisionar la capacidad de procesamiento con reservas es obligatorio para Lite regional y es opcional para las cargas zonales Temas de Lite.
Si no usas reservas para un tema de Lite zonal, debes aprovisionar de forma explícita la capacidad de procesamiento de publicación y suscripción del tema. Sin una reserva, todas las particiones de un tema Lite tienen el mismo la capacidad de procesamiento configurada. Para obtener más información, consulta Configura la capacidad de procesamiento sin reservas.
Configuración de almacenamiento. Para configurar el almacenamiento, debes especificar la capacidad de almacenamiento y, de forma opcional, el período de retención de mensajes.
Período de retención de mensajes. El tiempo máximo durante el que un dispositivo Lite un tema que almacena mensajes. Si no especificas un período de retención de mensajes, el tema de Lite almacenará los mensajes hasta que excedas la capacidad de almacenamiento.
Capacidad de almacenamiento. La capacidad del tema de Pub/Sub Lite es determinadas por la cantidad de particiones del tema y la capacidad de almacenamiento de cada partición. El almacenamiento por partición es la cantidad de almacenamiento, en bytes, para cada partición. Ten en cuenta que los temas Lite regionales usan dos bytes de almacenamiento. para cada byte publicado. Los temas Lite zonales usan un byte de capacidad de almacenamiento por cada byte publicado.
Si superas la capacidad de almacenamiento, el servicio de Pub/Sub Lite continúa publicando mensajes. Sin embargo, para crear más capacidad de almacenamiento, se borran los mensajes más antiguos de la partición. La eliminación de los mensajes más antiguos aparecen incluso si están dentro del mensaje período de retención. El servicio nunca borra mensajes antes de su TTL a menos que sea necesario quitarlas para liberar espacio y mensajes nuevos. Para obtener información sobre cómo se relaciona la capacidad con los precios, consulta Pub/Sub Precios de Lite.
Lineamientos para asignar nombres a temas
Con un nombre de recurso de Pub/Sub Lite, se identifica de forma exclusiva un recurso de Pub/Sub Lite, como un tema, una suscripción o una reserva. El nombre del recurso debe tener el siguiente formato:
projects/project-identifier/collection/ID
project-identifier
: Debe ser el ID o número del proyecto, disponible en la Consola de Google Cloud Por ejemplo,my-cool-project
es un ID del proyecto.123456789123
es un número de proyecto.collection
: Debe sertopics
,subscriptions
oreservations
.ID
: Debe cumplir con los siguientes lineamientos:- No debe comenzar con la cadena
goog
. - Comenzar con una letra
- tener entre 3 y 255 caracteres
- Tener solo los siguientes caracteres: letras
[A-Za-z]
, números[0-9]
, guiones-
, guiones bajos_
, puntos.
, virgulillas~
, signos más+
y signos de porcentaje%
Puedes usar los caracteres especiales de la lista anterior en los nombres de recursos sin codificación de URL. Sin embargo, debes asegurarte de que los demás caracteres especiales estén codificados o decodificados de forma correcta cuando los uses en URLs. Por ejemplo,
mi-tópico
es un ID no válido. Sin embargo,mi-t%C3%B3pico
es válido. Este formato es importante cuando realizas llamadas a REST.- No debe comenzar con la cadena
Aumenta la capacidad de procesamiento de un tema Lite
Si no usas las reservas de Lite, puedes configurar la capacidad de procesamiento de cada partición de cualquier tema zonal de Lite a un valor establecido por los siguientes límites:
Capacidad de procesamiento de publicación de entre 4 y 16 MiBps
Capacidad de procesamiento de suscripción de entre 4 y 32 MiBps
También se aplican estos límites a las particiones asociadas con una reserva de Lite. Con las reservas, cada partición puede consumir cualquier capacidad de procesamiento los límites especificados, siempre que la capacidad total de la reserva no se excede. También puedes establecer un límite más bajo en la de capacidad de procesamiento real por partición para que el tráfico sea más predecible.
Puedes aumentar la cantidad de particiones en un tema para escalarlo horizontalmente. La cantidad de particiones de un tema no se puede disminuir.
Cuando cambias la cantidad de particiones, el orden relativo de los mensajes no es y cómo se preservan. De forma interna, los mensajes se asignan a particiones con un hash . Actualizar la cantidad de particiones en un tema cambia este hash . Mensajes con la misma clave publicados después de la actualización del recuento de particiones se asignen a una partición diferente a las publicadas antes del actualización.
Además, el cambio de tamaño de un tema tarda unos segundos en propagarse a todos los editores. Habrá poco tiempo en que algunos editores usen la nueva hash y algunos aún usan la anterior.
Aumenta la capacidad de almacenamiento de un tema Lite
Puedes aumentar o disminuir la cantidad de almacenamiento en un tema de Lite. El tema de Lite aprovisiona la misma cantidad de almacenamiento para cada partición. Si aumentas el almacenamiento a 60 GiB, cada una de las particiones obtiene 60 GiB de almacenamiento.
Si disminuyes la cantidad de almacenamiento en un tema de Lite, el servicio de Pub/Sub Lite primero quitará los mensajes más antiguos.
Para obtener información sobre cómo se relaciona la capacidad con los precios, consulta Precios de Pub/Sub Lite.
Crea un tema de Lite
Puedes crear temas Lite con la consola de Google Cloud, Google Cloud CLI o la API de Pub/Sub Lite.
Para obtener una lista de las regiones y zonas disponibles, consulta Ubicaciones de Pub/Sub Lite.
Console
Ve a la página Temas de Lite.
Haz clic en Crear tema de Lite.
Para crear un tema Lite zonal, selecciona una región y una zona dentro de ella.
Para crear un tema Lite regional, selecciona una región.
No puedes actualizar la ubicación después de crear un tema.
En la sección Nombre, ingresa un ID de tema de Lite.
El nombre del tema Lite incluye su ID, la ubicación y el número del proyecto.
En la sección Capacidad de procesamiento, haz lo siguiente:
Selecciona o crea una reserva.
Es opcional para un tema Lite zonal y obligatorio para un tema regional de Lite.
Ingresa la capacidad de procesamiento máxima de publicación y la capacidad de procesamiento máxima de suscripción.
Varias particiones se configuran automáticamente según tus entradas. Tú puede editar este número después de guardar el tema.
En la sección Almacenamiento de mensajes, sigue estos pasos:
Ingresa el almacenamiento por partición.
Selecciona una de las dos opciones para el período de retención de mensajes.
Revisa los cambios y haz clic en Crear.
gcloud
Para crear un tema de Lite, usa el comando 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]
Reemplaza lo siguiente:
TOPIC_ID: el ID del tema de Lite
LOCATION: Es el nombre de una ubicación que admite Pub/Sub Lite.
NUMBER_OF_PARTITIONS: un número entero para la cantidad de particiones en el tema de Lite
STORAGE_PER_PARTITION: la cantidad de almacenamiento para cada partición, como
30GiB
RESERVATION_NAME: La ruta completamente calificada de un Lite reserva como
projects/123456789/locations/us-west1/reservations/my-reservation
MESSAGE_RETENTION_PERIOD: la cantidad de tiempo que el tema de Lite almacena mensajes, como
1d
o2w
Si la solicitud es exitosa, la línea de comandos muestra una confirmación:
Created [TOPIC_ID].
Protocolo
Para crear un tema de Lite, envía una solicitud POST
como la siguiente:
POST https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
Reemplaza lo siguiente:
REGION: Es la región en la que se almacenará el tema de Lite.
PROJECT_NUMBER: el número de proyecto del proyecto en el que se creará el tema de Lite
LOCATION: Es el nombre de una ubicación que admite Pub/Sub Lite.
TOPIC_ID: el ID del tema de Lite
Especifica los siguientes campos en el cuerpo de la solicitud:
{ "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 } }
Reemplaza lo siguiente:
NUMBER_OF_PARTITIONS: un número entero para la cantidad de particiones en el tema de Lite
STORAGE_PER_PARTITION: la cantidad de almacenamiento para cada partición, como
30GiB
publish_CAPACITY: Es un número entero para la capacidad de procesamiento de publicación. capacidad de cada partición
subscribe_CAPACITY: Es un número entero para la capacidad de procesamiento de suscripción. capacidad de cada partición
MESSAGE_RETENTION_PERIOD: la cantidad de tiempo que el tema de Lite almacena mensajes, como
1d
o2w
RESERVATION_NAME: La ruta completamente calificada de un Lite reserva como
projects/123456789/locations/us-west1/reservations/my-reservation
Si la solicitud se realiza correctamente, la respuesta es el tema de Lite en formato 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
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Go en las bibliotecas cliente de Pub/Sub Lite.
Java
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Java en las bibliotecas cliente de Pub/Sub Lite.
Python
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Python en las bibliotecas cliente de Pub/Sub Lite.
Después de crear el tema Lite, puedes escalar la capacidad de procesamiento por partición y de almacenamiento de Google. También puede aumentar, pero no disminuir el número de o particiones.
Actualizar un tema de Lite
Puedes actualizar las siguientes propiedades de un tema de Lite:
La reserva asociada con el tema Lite
La cantidad de particiones en el tema (solo se puede aumentar)
Los límites de la capacidad de procesamiento de publicación y suscripción
El almacenamiento por partición
El tipo de retención de mensajes
Antes de escalar la capacidad de procesamiento o la capacidad de almacenamiento de un consulta Escala la capacidad de procesamiento y Escala el almacenamiento capacidad.
Puedes actualizar un tema Lite con la consola de Google Cloud, Google Cloud CLI o la API de Pub/Sub Lite.
Console
Ve a la página Temas de Lite.
Haz clic en el ID del tema de Lite.
Haz clic en Edit.
Puedes realizar cualquiera de las siguientes actualizaciones:
- Usa otra reserva. En el caso de los temas zonales, puedes optar por no usar una reserva.
- Ingresa la cantidad de particiones. Este valor se puede aumentar, pero no disminuir.
- Habilita o inhabilita la capacidad de procesamiento máxima permitida de publicación y suscripción.
- Para los temas zonales, actualiza la capacidad de procesamiento de publicación y suscripción reservada. Para los temas con una reserva adjunta, la capacidad de procesamiento actualizada refleja el nuevo límite máximo.
- Edita la capacidad de almacenamiento por partición.
- Edita el período de retención de los mensajes.
Haz clic en Actualizar.
gcloud
Para actualizar un tema de Lite, usa el comando 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
Reemplaza lo siguiente:
TOPIC_ID: el ID del tema de Lite
LOCATION: Es el nombre de la ubicación en la que se encuentra el tema Lite.
NUMBER_OF_PARTITIONS: Es la cantidad de particiones que se deben configurar para el tema de Lite.
publish_CAPACITY: Es un número entero para la capacidad de procesamiento de publicación. capacidad de cada partición
subscribe_CAPACITY: Un número entero para la capacidad de procesamiento de la suscripción de cada partición
STORAGE_PER_PARTITION: la cantidad de almacenamiento para cada partición, como
30GiB
MESSAGE_RETENTION_PERIOD: la cantidad de tiempo que el tema de Lite almacena mensajes, como
1d
o2w
Si la solicitud es exitosa, la línea de comandos muestra el tema de 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
Protocolo
Para actualizar un tema de Lite, envía una solicitud PATCH
como la siguiente:
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)
Reemplaza lo siguiente:
REGION: Es la región en la que se encuentra el tema Lite.
PROJECT_NUMBER: el número del proyecto con el tema de Lite
LOCATION: Es el nombre de la ubicación en la que se encuentra el tema Lite.
TOPIC_ID: el ID del tema de Lite
Especifica los siguientes campos en el cuerpo de la solicitud:
{ "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
Reemplaza lo siguiente:
publish_CAPACITY: Un número entero para la capacidad de procesamiento de publicación de cada partición
subscribe_CAPACITY: Un número entero para la capacidad de procesamiento de la suscripción de cada partición
STORAGE_PER_PARTITION: la cantidad de almacenamiento para cada partición, como
30GiB
MESSAGE_RETENTION_PERIOD: la cantidad de tiempo que el tema de Lite almacena mensajes, como
1d
o2w
NUMBER_OF_PARTITIONS: Es la cantidad de particiones que se deben configurar para el tema de Lite.
Si la solicitud se realiza correctamente, la respuesta es el tema de Lite en formato 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
Antes de ejecutar este ejemplo, sigue las instrucciones de configuración de Go en Bibliotecas cliente de Pub/Sub Lite.
Java
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Java en las bibliotecas cliente de Pub/Sub Lite.
Python
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Python en las bibliotecas cliente de Pub/Sub Lite.
Ver detalles del tema Lite
Puedes obtener información sobre un tema Lite en el La consola de Google Cloud, Google Cloud CLI o la API de Pub/Sub Lite.
Console
Ve a la página Temas de Lite.
Haz clic en el ID del tema de Lite.
gcloud
Para obtener detalles sobre un tema de Lite, usa el comando gcloud pubsub lite-topics describe
:
gcloud pubsub lite-topics describe TOPIC_ID \ --location=LOCATION
Reemplaza lo siguiente:
TOPIC_ID: el ID del tema de Lite
LOCATION: Es el nombre de la ubicación en la que se encuentra el tema Lite.
Si la solicitud es exitosa, la línea de comandos muestra el tema de 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
Protocolo
Para obtener detalles sobre un tema de Lite, envía una solicitud GET
como la siguiente:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
Reemplaza lo siguiente:
REGION: Es la región en la que se encuentra el tema Lite.
PROJECT_NUMBER: el número del proyecto con el tema de Lite
LOCATION: Es el nombre de la ubicación en la que se encuentra el tema Lite.
TOPIC_ID: el ID del tema de Lite
Si la solicitud se realiza correctamente, la respuesta es el tema de Lite en formato 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
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Go en las bibliotecas cliente de Pub/Sub Lite.
Java
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Java en las bibliotecas cliente de Pub/Sub Lite.
Python
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Python en las bibliotecas cliente de Pub/Sub Lite.
Enumerar temas Lite
Puedes enumerar los temas de Lite en un proyecto usando la consola de Google Cloud. Google Cloud CLI o la API de Pub/Sub Lite.
Console
Para ver una lista de los temas de Lite en un proyecto, ve a la página Temas de Lite.
gcloud
- Para enumerar los temas de Lite en un proyecto, usa el comando
gcloud pubsub lite-topics list
:
gcloud pubsub lite-topics list \ --location=LOCATION
Reemplaza LOCATION por el nombre de la ubicación en la que se encuentra el tema Lite.
Si la solicitud se realiza correctamente, la línea de comandos muestra los temas de 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
Protocolo
Para enumerar los temas de Lite en un proyecto, envía una solicitud GET
como la siguiente:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/topics Authorization: Bearer $(gcloud auth print-access-token)
Reemplaza lo siguiente:
REGION: Es la región en la que se encuentra el tema Lite.
PROJECT_NUMBER: el número del proyecto con el tema de Lite
Si la solicitud se realiza correctamente, la respuesta es una lista de temas de Lite en formato JSON:
{ "topics": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", } ] }
Go
Antes de ejecutar este ejemplo, sigue las instrucciones de configuración de Go en Bibliotecas cliente de Pub/Sub Lite.
Java
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Java en las bibliotecas cliente de Pub/Sub Lite.
Python
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Python en las bibliotecas cliente de Pub/Sub Lite.
Borrar un tema de Lite
Puedes borrar temas de Lite con la consola de Google Cloud, Google Cloud CLI o la API de Pub/Sub Lite.
Console
Ve a la página Temas de Lite.
Haz clic en el ID del tema de Lite.
En la página Detalles del tema Lite, haz clic en Borrar.
En el campo que aparece, ingresa
delete
para confirmar que deseas borrar el tema de Lite.Haz clic en Borrar.
gcloud
Para borrar un tema de Lite, usa el comando gcloud pubsub lite-topics delete
:
Ejecuta el comando
delete
:gcloud pubsub lite-topics delete TOPIC_ID \ --location=LOCATION
Reemplaza lo siguiente:
TOPIC_ID: el ID del tema de Lite
LOCATION: Es el nombre de la ubicación en la que se encuentra el tema Lite.
Para confirmar, ingresa
Y
.
Si la solicitud es correcta, la respuesta es la siguiente:
Deleted topic [TOPIC_ID].
Protocolo
Para borrar un tema Lite, envía una solicitud DELETE
como la siguiente:
DELETE https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
Reemplaza lo siguiente:
REGION: Es la región en la que se encuentra el tema Lite.
PROJECT_NUMBER: el número del proyecto con el tema de Lite
LOCATION: Es el nombre de la ubicación en la que se encuentra el tema Lite.
TOPIC_ID: el ID del tema de Lite
Si la solicitud es correcta, la respuesta es un objeto JSON vacío.
Go
Antes de ejecutar este ejemplo, sigue las instrucciones de configuración de Go en Bibliotecas cliente de Pub/Sub Lite.
Java
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Java en las bibliotecas cliente de Pub/Sub Lite.
Python
Antes de ejecutar esta muestra, sigue las instrucciones de configuración de Python en las bibliotecas cliente de Pub/Sub Lite.
Si borras un tema de Lite, no podrás publicar mensajes en él. Las suscripciones Lite al tema de Lite aún existen, pero no puedes recibir mensajes de ellas.
Pasos siguientes
- Publica mensajes en un tema de Lite.
- Crea una suscripción Lite a un tema de Lite.
- Recibir mensajes de una suscripción Lite