En este documento, se muestra cómo validar esquemas para temas de Pub/Sub. La verificación de validación no comprueba la compatibilidad de la revisión nueva con las revisiones anteriores.
Antes de comenzar
- Comprende cómo funcionan los esquemas de Pub/Sub.
- Crea un esquema.
Roles y permisos requeridos
Para obtener los permisos que necesitas para validar y administrar definiciones 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 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:
-
Crea un esquema:
pubsub.schemas.create -
Adjunta el esquema al tema:
pubsub.schemas.attach -
Confirma una revisión del esquema:
pubsub.schemas.commit -
Borra un esquema o una revisión del esquema:
pubsub.schemas.delete -
Obtén un esquema o revisiones de esquemas:
pubsub.schemas.get -
Esquemas de lista:
pubsub.schemas.list -
Enumera las revisiones del esquema:
pubsub.schemas.listRevisions -
Cómo revertir un esquema:
pubsub.schemas.rollback -
Valida 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 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 adjuntarlo a un tema ubicado en otro proyecto. Asegúrate de tener los permisos necesarios para cada proyecto.
Valida una definición de esquema
Puedes validar un esquema con laGoogle Cloud consola, 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 revisiones anteriores.