En Pub/Sub, un tema es un recurso con nombre que representa un feed de mensajes. Debes crear un tema antes de poder publicarlo o suscribirte a él. Pub/Sub admite dos tipos de temas: uno estándar y uno de importación.
En este documento, se describe cómo crear un tema estándar de Pub/Sub. Si quieres obtener más información sobre un tema de importación y cómo crear uno, consulta Cómo crear un tema de importación.
Para crear un tema, puedes usar la consola de Google Cloud, Google Cloud CLI, la biblioteca cliente o la API de Pub/Sub.
Antes de comenzar
Obtén más información sobre el servicio de Pub/Sub y su terminología.
Obtén más información sobre el proceso de publicación.
Roles y permisos obligatorios para administrar temas
Si quieres obtener los permisos que necesitas para crear y administrar temas,
pídele a tu administrador que te otorgue el
rol de IAM de editor de Pub/Sub(roles/pubsub.editor
)
en tu tema o proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Cómo administrar el acceso.
Este rol predefinido contiene los permisos necesarios para crear y administrar temas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para crear y administrar temas:
-
Crea un tema:
pubsub.topics.create
-
Borra un tema:
pubsub.topics.delete
-
Desvincula una suscripción de un tema:
pubsub.topics.detachSubscription
-
Obtener un tema:
pubsub.topics.get
-
Enumera un tema:
pubsub.topics.list
-
Publicar en un tema:
pubsub.topics.publish
-
Actualiza un tema:
pubsub.topics.update
-
Obtén la política de IAM de un tema:
pubsub.topics.getIamPolicy
-
Configura la política de IAM para un tema:
pubsub.topics.setIamPolicy
Es posible que también puedas obtener estos permisos con funciones personalizadas o con otras funciones predefinidas.
Puedes configurar el control de acceso a nivel de proyecto y a nivel de recurso individual. Puedes crear una suscripción en un proyecto y vincularla a un tema ubicado en un proyecto diferente. Asegúrate de tener los permisos necesarios para cada proyecto.
Propiedades de un tema
Cuando creas o actualizas un tema, debes especificar sus propiedades.
-
Agrega una suscripción predeterminada. Agrega una suscripción predeterminada al tema de Pub/Sub. Puedes crear otra suscripción para el tema después de crearlo. La suscripción predeterminada tiene las siguientes propiedades:
- ID de suscripción de
-sub
- Tipo de entrega de extracción
- Duración de retención de mensajes de siete días
- Vencimiento después de 31 días de inactividad
- Plazo de confirmación de 10 segundos
- Política de reintento inmediato
- ID de suscripción de
- Esquema: Un esquema es un formato que debe seguir el campo de datos del mensaje. Un esquema es un contrato entre el publicador y el suscriptor que Pub/Sub aplica. Los esquemas de temas ayudan a estandarizar los tipos de mensajes y los permisos para que diferentes equipos de tu organización los consuman. Pub/Sub crea una autoridad central para los tipos de mensajes y los permisos. Para crear un tema con un esquema, consulta Descripción general del esquema.
-
Habilita la transferencia. Habilitar esta propiedad te permite transferir datos de transmisión de fuentes externas a un tema para que puedas aprovechar las funciones de Google Cloud. Si quieres crear un tema de importación para la transferencia, consulta Crea un tema de importación.
-
Duración de la retención de mensajes. Especifica por cuánto tiempo el tema de Pub/Sub retiene mensajes después de la publicación. Una vez que finaliza la duración de la retención de mensajes, es posible que Pub/Sub descarte el mensaje sin importar su estado de confirmación. Se cobran tarifas de almacenamiento de mensajes por almacenar todos los mensajes publicados en el tema.
- Predeterminado = No habilitado
- Valor mínimo = 10 minutos
- Valor máximo: 31 días
- Usa una clave de encriptación administrada por el cliente (CMEK). Especifica si el tema está encriptado con una CMEK. Pub/Sub encripta los mensajes con claves administradas por Google de forma predeterminada. Si especificas esta opción, Pub/Sub usará el patrón de encriptación de sobre con CMEK. En este enfoque, Cloud KMS no encripta los mensajes. En cambio, Cloud KMS encripta las claves de encriptación de datos (DEK) que Pub/Sub crea para cada tema. Pub/Sub encripta los mensajes con la DEK más reciente que se generó para el tema. Pub/Sub desencripta los mensajes poco antes de que se entreguen a los suscriptores. Para obtener más información sobre la creación de una clave, consulta Configura la encriptación de mensajes.
Crea un tema
Crea un tema antes de publicarlo o suscribirte a él.
Console
Para crear un tema, sigue estos pasos:
En la consola de Google Cloud, ve a la página Temas de Pub/Sub.
Haga clic en Crear tema.
En el campo ID de tema, ingresa un ID para tu tema. Para obtener más información sobre cómo asignar nombres a temas, consulta los lineamientos para asignar nombres.
Mantén la opción Agregar una suscripción predeterminada.
No selecciones las otras opciones.
Haz clic en Crear tema.
gcloud
-
En la consola de Google Cloud, activa Cloud Shell.
En la parte inferior de la consola de Google Cloud, se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.
-
Para crear un tema, ejecuta el comando
gcloud pubsub topics create
:gcloud pubsub topics create TOPIC_ID
REST
Para crear un tema, usa el método projects.topics.create
:
La solicitud debe autenticarse con un token de acceso en el encabezado Authorization
. A fin de obtener un token de acceso para las credenciales predeterminadas actuales de la aplicación, usa el siguiente comando: gcloud auth application-default print-access-token
.
PUT https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics/TOPIC_ID Authorization: Bearer ACCESS_TOKEN
Aquí:
Respuesta:
{ "name": "projects/PROJECT_ID/topics/TOPIC_ID" }
C++
Antes de probar esta muestra, sigue las instrucciones de configuración de C++ que se encuentran en la guía de inicio rápido de Pub/Sub con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub C++.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
C#
Antes de probar esta muestra, sigue las instrucciones de configuración de C# que se encuentran en la guía de inicio rápido de Pub/Sub con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub C#.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go que se encuentran en la guía de inicio rápido de Pub/Sub con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub Go.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java que se encuentran en la guía de inicio rápido de Pub/Sub con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub Java.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Node.js
PHP
Antes de probar esta muestra, sigue las instrucciones de configuración de PHP que se encuentran en la guía de inicio rápido de Pub/Sub con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub PHP.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python que se encuentran en la guía de inicio rápido de Pub/Sub con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub Python.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Antes de probar esta muestra, sigue las instrucciones de configuración de Ruby que se encuentran en la guía de inicio rápido de Pub/Sub con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub Ruby.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Restricciones de las políticas de la organización
Las políticas de la organización pueden restringir la creación de temas, por ejemplo, una política puede restringir el almacenamiento de mensajes en una región de Compute Engine. Para evitar errores en la creación de temas, examina y actualiza las políticas de la organización, según sea necesario, antes de crear un tema.
Si tu proyecto se creó recientemente, espera unos minutos a que se inicialice la política de la organización antes de crear un tema.
Ir a Políticas de la organización
Para obtener más información, consulta Configura políticas de almacenamiento de mensajes.
¿Qué sigue?
Elige el tipo de suscripción para tu tema.
Aprende a publicar un mensaje en un tema.
Crea o modifica un tema con la gcloud CLI, las APIs de REST o las bibliotecas cliente.