Los suscriptores usan una suscripción Lite para leer mensajes de un Lite. Cuando creas una suscripción Lite, la adjuntas a un tema Lite. Puedes adjuntar muchas suscripciones Lite a un solo tema Lite.
Existen dos tipos de suscripción:
- Suscripción estándar. Crea una suscripción estándar cuando tengas un cliente que necesite leer mensajes del tema de Lite.
- Exportar suscripción. Crea una suscripción de exportación cuando necesites exportar mensajes Lite a Pub/Sub. Para obtener más información, consulta Exporta mensajes de Pub/Sub Lite a Pub/Sub.
Propiedades de una suscripción Lite
Una suscripción a un tema de Lite zonal tiene propiedades idénticas a las de una suscripción a un tema de Lite regional, excepto por lo siguiente:
Es un tipo de ubicación, una zona o una región, que se usa en el nombre del recurso. Un ejemplo de una ubicación de región es
us-central1
; un ejemplo de una ubicación de zona esus-central1-a
.Confiabilidad: Consulta Replicación de datos en un tema de Lite. para obtener más información sobre las diferencias de confiabilidad entre los temas regionales y zonales.
Requisito de entrega para los mensajes
Una falla temporal al escribir un mensaje en el almacenamiento provoca que el publicador vuelve a intentar enviar el mensaje. Estos reintentos son transparentes para el usuario final. Las suscripciones Lite tienen una propiedad de requisito de entrega que cambia la forma en que las suscripciones reaccionan a estos reintentos de mensajes. Puedes configurar esta propiedad a una de las siguientes dos opciones:
Enviar mensajes de inmediato Con esta opción habilitada, los clientes del suscriptor reciben todos los mensajes después de que llegan al servidor. Este proceso es y esto no depende del estado de los mensajes que se escriben en el disco. Los desplazamientos no se vuelven a usar, pero es posible que los mensajes con desplazamientos que no se escriben en el almacenamiento no se puedan volver a leer después de una operación de búsqueda.
Enviar mensajes después de almacenarlos Si habilitas esta opción, el suscriptor no recibirá mensajes hasta que se escriban en el disco. Se garantiza que los mensajes se puedan volver a leer después de una operación de búsqueda. Habilitando esta opción Aumenta la latencia de extremo a extremo para recibir mensajes del publicador. para el suscriptor.
Lineamientos para asignar un nombre a una suscripción
El nombre de un recurso de Pub/Sub Lite identifica de forma única recurso de Pub/Sub Lite, como un tema, una suscripción o 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 de proyecto.123456789123
es un número de proyecto.collection
: Debe sertopics
,subscriptions
oreservations
.ID
: Debe cumplir con los siguientes lineamientos:- No 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 las 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 REST.- No comenzar con la cadena
Crea una suscripción Lite
Una suscripción Lite debe estar en el mismo proyecto y la misma ubicación que la Tema de Lite al que se adjuntó la suscripción Lite.
Para crear un tema de Lite, consulta Cómo crear y administrar un tema de Lite.
Para obtener una lista de las ubicaciones disponibles, consulta Ubicaciones de Pub/Sub Lite.
Puedes crear una suscripción Lite con la consola de Google Cloud, Google Cloud CLI o la API de Pub/Sub Lite.
Si quieres obtener información para crear una suscripción de exportación, consulta Exporta mensajes de Pub/Sub Lite a Pub/Sub.
Console
Ve a la página Suscripciones Lite.
Haz clic en Crear suscripción Lite.
Ingresa un ID de suscripción Lite.
Elige un tema Lite para recibir mensajes.
Elige Enviar mensajes de inmediato o Enviar mensajes después de almacenarlos.
Elige un tipo de Desplazamiento inicial.
Elige un Tipo de entrega.
Haz clic en Crear.
gcloud
Para crear una suscripción Lite, usa el comando gcloud pubsub lite-subscriptions create
:
gcloud pubsub lite-subscriptions create SUBSCRIPTION_ID \ --location=LOCATION \ --topic=TOPIC_ID \ --delivery-requirement=DELIVERY_REQUIREMENT
Reemplaza lo siguiente:
SUBSCRIPTION_ID: Es el ID de la suscripción Lite.
LOCATION: Es el nombre de una ubicación que admite Pub/Sub Lite.
TOPIC_ID: Es el ID del tema Lite para adjuntar a la suscripción Lite
DELIVERY_REQUIREMENT:
deliver-after-stored
odeliver-immediately
Si la solicitud es exitosa, la línea de comandos muestra una confirmación:
Created [SUBSCRIPTION_ID].
Protocolo
Para crear una suscripción Lite, envía una solicitud POST
como la siguiente:
POST https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Reemplaza lo siguiente:
REGION: Es la región en la que se almacenará la suscripción de Lite.
PROJECT_NUMBER: Es el número de proyecto del proyecto para crear la suscripción básica
LOCATION: Es el nombre de una ubicación que admite Pub/Sub Lite.
SUBSCRIPTION_ID: Es el ID de la suscripción Lite.
Especifica los siguientes campos en el cuerpo de la solicitud:
{ "topic": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } }
Reemplaza DELIVERY_REQUIREMENT por deliver-after-stored
o deliver-immediately
.
Si la solicitud es exitosa, la respuesta es la suscripción Lite en formato JSON:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
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 una suscripción Lite a un tema Lite, puedes recibir mensajes de la suscripción Lite.
Actualiza una suscripción Lite
Puedes actualizar las suscripciones Lite con la consola de Google Cloud. Google Cloud CLI o la API de Pub/Sub Lite.
Console
Ve a la página Suscripciones Lite.
Haz clic en el ID de suscripción Lite.
En la página Detalles de la suscripción Lite, haz clic en Editar.
gcloud
Para actualizar una suscripción Lite, usa el comando gcloud pubsub lite-subscriptions update
:
gcloud pubsub lite-subscriptions update SUBSCRIPTION_ID \ --location=LOCATION \ --delivery-requirement=DELIVERY_REQUIREMENT
Reemplaza lo siguiente:
SUBSCRIPTION_ID: Es el ID de la suscripción Lite.
LOCATION: Es el nombre de la ubicación en la que se encuentra la suscripción de Lite.
DELIVERY_REQUIREMENT:
deliver-after-stored
odeliver-immediately
Si la solicitud es exitosa, la línea de comandos muestra el tema de Lite:
deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protocolo
Para actualizar una suscripción Lite, envía una solicitud PATCH
como la siguiente:
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)
Reemplaza lo siguiente:
REGION: Es la región en la que se almacenará la suscripción de Lite.
PROJECT_NUMBER: Es el número de proyecto con la suscripción Lite.
LOCATION: Es el nombre de la ubicación en la que se encuentra la suscripción de Lite.
SUBSCRIPTION_ID: Es el ID de la suscripción Lite.
Especifica los siguientes campos en el cuerpo de la solicitud:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } }
Reemplaza DELIVERY_REQUIREMENT por deliver-after-stored
o deliver-immediately
.
Si la solicitud es exitosa, la respuesta es la suscripción Lite en formato JSON:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
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.
Cómo ver los detalles de la suscripción Lite
Puedes obtener detalles sobre una suscripción Lite con la consola de Google Cloud, Google Cloud CLI o la API de Pub/Sub Lite.
Console
Ve a la página Suscripciones Lite.
Haz clic en el ID de suscripción Lite.
En la página de detalles de la suscripción Lite, haz clic en la pestaña Detalles.
gcloud
Para obtener detalles sobre una suscripción Lite, usa el comando gcloud pubsub lite-subscriptions describe
:
gcloud pubsub lite-subscriptions describe SUBSCRIPTION_ID \ --location=LOCATION
Reemplaza lo siguiente:
SUBSCRIPTION_ID: Es el ID de la suscripción Lite.
LOCATION: Es el nombre de la ubicación en la que se encuentra la suscripción de Lite.
Si la solicitud es exitosa, la línea de comandos muestra el tema de Lite:
deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protocolo
Para obtener detalles sobre una suscripción Lite, envía una solicitud GET
como la siguiente:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Reemplaza lo siguiente:
REGION: Es la región en la que se almacenará la suscripción de Lite.
PROJECT_NUMBER: Es el número de proyecto del proyecto con la suscripción Lite.
LOCATION: Es el nombre de la ubicación en la que se encuentra la suscripción de Lite.
SUBSCRIPTION_ID: Es el ID de la suscripción Lite.
Si la solicitud se realiza correctamente, la respuesta es el tema de Lite en formato JSON:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
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.
Cómo enumerar suscripciones Lite
Puedes enumerar las suscripciones Lite en un proyecto o las suscripciones Lite a un tema Lite.
Enumera las suscripciones Lite en un proyecto
Puedes enumerar las suscripciones Lite de un proyecto con la consola de Google Cloud. Google Cloud CLI o la API de Pub/Sub Lite.
Console
Ve a la página Suscripciones Lite.
gcloud
- Para mostrar una lista de las suscripciones Lite en un proyecto, usa el comando
gcloud pubsub lite-subscriptions list
:
gcloud pubsub lite-subscriptions list \ --location=LOCATION
Reemplaza LOCATION por el nombre de la ubicación en la que se encuentran las suscripciones de Lite.
Si la solicitud es exitosa, la línea de comandos muestra las subscripciones 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
Protocolo
- Para enumerar las suscripciones Lite en un proyecto, envía una solicitud
GET
como la siguiente:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/subscriptions Authorization: Bearer $(gcloud auth print-access-token)
Reemplaza lo siguiente:
REGION: Es la región en la que se almacenará la suscripción de Lite.
PROJECT_NUMBER: Es el número de proyecto con la suscripción Lite.
Si la solicitud se realiza correctamente, la respuesta es el tema de Lite en formato JSON:
{ "subscriptions": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" } ] }
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.
Enumera suscripciones Lite a un tema Lite
Puedes enumerar las suscripciones Lite a un tema de Lite con 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.
Selecciona un ID del tema Lite.
En la página de detalles de temas de Lite, la sección Suscripciones Lite incluye una lista de suscripciones Lite al tema de Lite.
gcloud
- Para enumerar las suscripciones Lite a un tema, usa el comando
gcloud pubsub lite-topics list-subscriptions
:
gcloud pubsub lite-topics list-subscriptions TOPIC_ID \ --location=LOCATION
Reemplaza lo siguiente:
TOPIC_ID: Es el ID del tema Lite al que se vinculan las suscripciones Lite.
LOCATION: Es el nombre de la ubicación en la que se encuentra la suscripción de Lite.
Si la solicitud es exitosa, la línea de comandos muestra las subscripciones 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
Protocolo
- Para enumerar las suscripciones a un tema Lite, envía una solicitud
GET
como la siguiente:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/lite-topics/TOPIC_ID/subscriptions Authorization: Bearer $(gcloud auth print-access-token)
Reemplaza lo siguiente:
REGION: Es la región en la que se almacenará la suscripción de Lite.
PROJECT_NUMBER: Es el número de proyecto con la suscripción Lite.
LOCATION: Es el nombre de la ubicación en la que se encuentra la suscripción de Lite.
TOPIC_ID: Es el ID del tema Lite al que se vinculan las suscripciones Lite.
Si la solicitud se realiza de forma correcta, la respuesta es una lista de suscripciones Lite en formato JSON:
{ "subscriptions": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" } ] }
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.
Cómo borrar una suscripción Lite
Puedes borrar suscripciones Lite con la consola de Google Cloud, Google Cloud CLI o la API de Pub/Sub Lite.
Console
Ve a la página Suscripciones Lite.
Haz clic en el ID de suscripción Lite.
En la página Detalles de la suscripción Lite, haz clic en Borrar.
En el cuadro de diálogo que aparece, haz clic en Borrar para confirmar que deseas borrar la suscripción Lite.
gcloud
Para borrar una suscripción Lite, usa el comando gcloud pubsub lite-subscriptions delete
:
Ejecuta el comando
delete
:gcloud pubsub lite-subscriptions delete SUBSCRIPTION_ID \ --location=LOCATION
Reemplaza lo siguiente:
SUBSCRIPTION_ID: Es el ID de la suscripción Lite.
LOCATION: Es el nombre de la ubicación en la que se encuentra la suscripción de Lite.
Para confirmar, ingresa
Y
.
Si la solicitud es exitosa, la línea de comandos muestra una confirmación:
Deleted subscription [SUBSCRIPTION_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/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Reemplaza lo siguiente:
REGION: Es la región en la que se almacenará la suscripción de Lite.
PROJECT_NUMBER: Es el número de proyecto con la suscripción Lite.
LOCATION: Es el nombre de la ubicación en la que se encuentra la suscripción de Lite.
SUBSCRIPTION_ID: Es el ID de la suscripción Lite.
Si la solicitud es correcta, la respuesta es un objeto JSON vacío.
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.
Pasos siguientes
- Crea y administra un tema de Lite.
- Publica mensajes en un tema Lite.
- Recibir mensajes de una suscripción Lite