Valida un mensaje para un esquema

En este documento, se muestra cómo validar esquemas para temas de Pub/Sub.

Puedes validar que los mensajes se adhieran a un esquema determinado, antes o después de que se cree un recurso de esquema. Este paso garantiza que los mensajes que deseas enviar a través de un tema asociado con un esquema coincidan antes de aplicar el esquema.

Antes de comenzar

Roles y permisos requeridos

Para obtener los permisos que necesitas para validar mensajes de esquema y administrarlos, 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 mensajes de esquema y administrarlos. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para validar mensajes de esquema y administrarlos:

  • Crear esquema: pubsub.schemas.create
  • Adjuntar esquema al tema: pubsub.schemas.attach
  • Confirmar una revisión del esquema: pubsub.schemas.commit
  • Borrar un esquema o una revisión del esquema: pubsub.schemas.delete
  • Obtener un esquema o revisiones del esquema: pubsub.schemas.get
  • Enumerar esquemas: pubsub.schemas.list
  • Enumerar revisiones del esquema: pubsub.schemas.listRevisions
  • Revertir un esquema: pubsub.schemas.rollback
  • Validar un mensaje: pubsub.schemas.validate
  • Obtener la política de IAM para un esquema: pubsub.schemas.getIamPolicy
  • Configurar la política de IAM para un esquema: pubsub.schemas.setIamPolicy

También puedes obtener estos permisos con roles personalizados o otros roles predefinidos.

Puedes otorgar roles y permisos a entidades, 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 un mensaje para un esquema

Console

  1. En la Google Cloud consola de, ve a la página Esquemas de Pub/Sub.

    Ir a Esquemas

    Se muestra la lista de esquemas.

  2. Haz clic en el ID de esquema de un esquema existente.

    Se abrirá la página Detalles del esquema del esquema.

  3. En la sección Revisiones, haz clic en la revisión para la que deseas validar un mensaje.

  4. En la sección Detalles, haz clic en Probar mensaje.

  5. En la ventana Probar mensaje, selecciona un tipo de Codificación de mensajes.

  6. En el cuerpo del Mensaje, ingresa un mensaje de prueba.

  7. Haga clic en Probar.

gcloud

  1. En la Google Cloud consola de, activa Cloud Shell.

    Activa Cloud Shell

    En la parte inferior de la Google Cloud consola de, 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.

  2. Para validar un mensaje en función de un esquema, usa el comando gcloud pubsub schemas validate-message.

    gcloud pubsub schemas validate-message --message=MESSAGE \
    --message-encoding=MESSAGE_ENCODING \
    (--schema-name=SCHEMA_NAME | \
    --type=TYPE \
    (--definition=DEFINITION | \
    --definition-file=DEFINITION_FILE))

    Reemplaza lo siguiente:

    • MESSAGE: Es el mensaje que se validará en función del esquema.

    • MESSAGE_ENCODING: Es la codificación del mensaje. Especifica uno de los siguientes valores: binary o json.

    • SCHEMA_NAME: Es el nombre o la ruta de acceso completa de un esquema existente.

    • TYPE: Es el tipo de esquema intercalado. Especifica uno de los siguientes valores: avro o protocol-buffer.

    • DEFINITION: Es la definición de esquema intercalado.

    • DEFINITION_FILE: Es el archivo que contiene la definición del esquema.

¿Qué sigue?