En este documento, se muestra cómo enumerar las revisiones de un esquema para temas de Pub/Sub.
Antes de comenzar
- Comprender cómo funcionan los esquemas de Pub/Sub
- Crea un esquema.
Roles y permisos requeridos
Para obtener los permisos que necesitas para enumerar y administrar las revisiones de esquemas, pídele a tu administrador que te otorgue el rol de IAM de editor de Pub/Sub (roles/pubsub.editor
) en tu proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene los permisos necesarios para enumerar las revisiones de esquemas y administrarlas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para enumerar las revisiones de esquemas y administrarlas:
-
Crear esquema:
pubsub.schemas.create
-
Adjunta el esquema al tema:
pubsub.schemas.attach
-
Confirma una revisión de esquema:
pubsub.schemas.commit
-
Borra un esquema o una revisión de esquema:
pubsub.schemas.delete
-
Obtén un esquema o revisiones de esquema:
pubsub.schemas.get
-
Enumera los esquemas:
pubsub.schemas.list
-
Revisiones del esquema de la lista:
pubsub.schemas.listRevisions
-
Revierte un esquema:
pubsub.schemas.rollback
-
Valida un mensaje:
pubsub.schemas.validate
-
Obtén la política de IAM de un esquema:
pubsub.schemas.getIamPolicy
-
Configura la política de IAM para un esquema:
pubsub.schemas.setIamPolicy
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Puedes otorgar roles y permisos a principales, como usuarios, grupos, dominios o cuentas de servicio. Puedes crear un esquema en un proyecto y vincularlo a un tema ubicado en un proyecto diferente. Asegúrate de tener los permisos necesarios para cada proyecto.
Cómo enumerar las revisiones de un esquema
Puedes enumerar las revisiones de un esquema en un proyecto de Google Cloud con la consola de Google Cloud, gcloud CLI, la API de Pub/Sub o las bibliotecas cliente de Cloud.
Console
En la consola de Google Cloud, ve a la página Esquemas de Pub/Sub.
Se muestra la lista de esquemas.
Haz clic en el nombre del esquema que deseas ver.
Se abrirá la página Detalles del esquema del esquema.
En la sección Revisiones, puedes ver la lista de revisiones disponibles para el esquema.
gcloud
Para ver la revisión más reciente de un esquema, haz lo siguiente:
gcloud pubsub schemas list-revisions SCHEMA_ID
Usa el gcloud pubsub schemas list-revisions <var>SCHEMA_ID</var> --view=FULL
para ver las definiciones de las revisiones del esquema.
REST
A fin de mostrar una lista de las revisiones de un esquema, envía una solicitud GET como la siguiente:
GET https://pubsub.googleapis.com/v1/projects/SCHEMA_NAME:listRevisions
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá un Un objeto JSON que contiene todas las revisiones del esquema.
C++
Antes de probar esta muestra, sigue las instrucciones de configuración de C++ en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para C++.
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Go.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Java.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Python.
Node.js
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Node.js.
Node.js
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Node.js.
¿Qué sigue?
Procesa mensajes cuando te suscribas a temas configurados con un esquema.