En este documento se explica cómo ver los detalles del esquema de los temas de Pub/Sub.
Antes de empezar
- Consulta cómo funcionan los esquemas de Pub/Sub.
- Crea un esquema.
Roles y permisos necesarios
Para obtener los permisos que necesitas para ver los detalles de los esquemas y gestionarlos, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Editor de Pub/Sub (roles/pubsub.editor
) en tu proyecto.
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene los permisos necesarios para ver los detalles del esquema y gestionarlos. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
Para ver los detalles de un esquema y gestionarlo, se necesitan los siguientes permisos:
-
Crea un esquema:
pubsub.schemas.create
-
Adjuntar un esquema a un tema:
pubsub.schemas.attach
-
Confirmar una revisión del esquema:
pubsub.schemas.commit
-
Eliminar un esquema o una revisión de un esquema:
pubsub.schemas.delete
-
Obtener un esquema o revisiones de un esquema:
pubsub.schemas.get
-
Ver esquemas:
pubsub.schemas.list
-
Lista de revisiones del esquema:
pubsub.schemas.listRevisions
-
Restaurar una versión anterior de un esquema:
pubsub.schemas.rollback
-
Validar un mensaje:
pubsub.schemas.validate
-
Obtener la política de gestión de identidades y accesos de un esquema:
pubsub.schemas.getIamPolicy
-
Configura la política de gestión de identidades y accesos de un esquema:
pubsub.schemas.setIamPolicy
También puedes obtener estos permisos con roles personalizados u otros roles predefinidos.
Puedes conceder roles y permisos a entidades principales, como usuarios, grupos, dominios o cuentas de servicio. Puedes crear un esquema en un proyecto y adjuntarlo a un tema ubicado en otro proyecto. Asegúrate de que tienes los permisos necesarios para cada proyecto.
Ver los detalles del esquema
Puedes obtener los detalles de un esquema mediante laGoogle Cloud consola, la CLI de gcloud, la API de Pub/Sub o las bibliotecas de cliente de Cloud. Los resultados devuelven los detalles del ID de revisión más reciente.
Consola
En la Google Cloud consola, ve a la página Esquemas de Pub/Sub.
Haga clic en el nombre del esquema que quiera ver.
Se abrirá la página Detalles del esquema del esquema.
gcloud
Para ver la última revisión de un esquema, sigue estos pasos:
gcloud pubsub schemas describe SCHEMA_NAME
Para ver una revisión específica de un esquema, sigue estos pasos:
gcloud pubsub schemas describe SCHEMA_ID@REVISION_ID
Donde:
- REVISION_ID es la revisión a la que quieres volver.
REST
Para obtener los detalles de la última revisión de un esquema, envía una solicitud GET como la siguiente:
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID
Por ejemplo, para un esquema con el ID schema-inventory
, envía la siguiente solicitud: https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/schema-inventory
Para obtener los detalles de una revisión específica de un esquema, envía una solicitud GET como la siguiente:
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID@REVISION_ID
Por ejemplo, para un esquema con el ID schema-inventory
y el ID de revisión fa567a3e
, envía la siguiente solicitud: https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/schema-inventory@fa567a3e
Donde:
- PROJECT_ID es el ID del proyecto.
- SCHEMA_ID es el ID de tu esquema.
- REVISION_ID es el ID de la revisión del esquema específico.
Si la solicitud se completa correctamente, en el cuerpo de la respuesta se incluye una instancia de la clase Schema.
C++
Antes de probar este ejemplo, sigue las instrucciones de configuración de C++ que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de C++ de Pub/Sub.
C#
Antes de probar este ejemplo, sigue las instrucciones de configuración de C# que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de C# de Pub/Sub.
Go
En el siguiente ejemplo se usa la versión principal de la biblioteca de cliente de Pub/Sub de Go (v2). Si sigues usando la biblioteca v1, consulta la guía de migración a la versión 2. Para ver una lista de ejemplos de código de la versión 1, consulta los ejemplos de código obsoletos.
Antes de probar este ejemplo, sigue las instrucciones de configuración de Go que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API Go de Pub/Sub.
Java
Antes de probar este ejemplo, sigue las instrucciones de configuración de Java que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Java de Pub/Sub.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración de Node.js que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Node.js de Pub/Sub.
Node.js
Antes de probar este ejemplo, sigue las instrucciones de configuración de Node.js que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Node.js de Pub/Sub.
PHP
Antes de probar este ejemplo, sigue las instrucciones de configuración de PHP que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Pub/Sub para PHP.
Python
Antes de probar este ejemplo, sigue las instrucciones de configuración de Python que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Python de Pub/Sub.
Ruby
En el siguiente ejemplo se usa la biblioteca de cliente de Ruby Pub/Sub v3. Si sigues usando la biblioteca v2, consulta la guía de migración a la versión 3. Para ver una lista de ejemplos de código de Ruby v2, consulta los ejemplos de código obsoletos.
Antes de probar este ejemplo, sigue las instrucciones de configuración de Ruby que se indican en la guía de inicio rápido sobre cómo usar bibliotecas de cliente. Para obtener más información, consulta la documentación de referencia de la API de Ruby de Pub/Sub.
Siguientes pasos
- Eliminar una revisión de un esquema
- Eliminar un esquema
- Ver esquemas
- Mostrar las revisiones de un esquema
- Suscribirse a un tema con un esquema