En este documento, se muestra cómo validar esquemas para los temas de Pub/Sub. La verificación de validación no comprueba la compatibilidad de la revisión nueva con las anteriores.
Antes de comenzar
- Obtén información sobre cómo funcionan los esquemas de Pub/Sub.
- Crea un esquema.
Roles y permisos requeridos
Si deseas obtener los permisos que necesitas para validar las definiciones de esquemas y administrarlas,
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.
Este rol predefinido contiene los permisos necesarios para validar las definiciones 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 validar las definiciones de esquemas y administrarlas:
-
Crear esquema:
pubsub.schemas.create -
Adjuntar un esquema al tema:
pubsub.schemas.attach -
Confirma una revisión del esquema:
pubsub.schemas.commit -
Borra un esquema o una revisión de esquema:
pubsub.schemas.delete -
Obtener un esquema o revisiones de esquema:
pubsub.schemas.get -
Enumerar esquemas:
pubsub.schemas.list -
Enumera las revisiones de esquema:
pubsub.schemas.listRevisions -
Revierte un esquema:
pubsub.schemas.rollback -
Validar un mensaje:
pubsub.schemas.validate -
Obtén la política de IAM para 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, también, 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 adjuntarlo a un tema ubicado en un proyecto diferente. Asegúrate de tener los permisos necesarios para cada proyecto.
Valida una definición de esquema
Puedes validar un esquema con la consola de Google Cloud, gcloud CLI, la API de Pub/Sub o las bibliotecas cliente de Cloud.
Sigue los pasos que se describen en Crea un esquema.
La verificación de validación no comprueba la compatibilidad de la revisión nueva con las anteriores.