Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
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
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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-09 (UTC)"],[],[],null,["This document shows you how to validate schemas for Pub/Sub topics.\nThe validation check does not check the compatibility of the new revision\nwith the older revisions.\n\nBefore you begin\n\n- Understand how [Pub/Sub schemas work](/pubsub/docs/schemas).\n- [Create a schema](/pubsub/docs/create-schemas).\n\nRequired roles and permissions\n\n\nTo get the permissions that\nyou need to validate schemas definitions and manage them,\n\nask your administrator to grant you the\n\n\n[Pub/Sub Editor](/iam/docs/roles-permissions/pubsub#pubsub.editor) (`roles/pubsub.editor`)\nIAM role on your project.\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nThis predefined role contains\n\nthe permissions required to validate schemas definitions and manage them. To see the exact permissions that are\nrequired, expand the **Required permissions** section:\n\n\nRequired permissions\n\nThe following permissions are required to validate schemas definitions and manage them:\n\n- Create schema: ` ``pubsub.schemas.create`\n- Attach schema to topic: ` ``pubsub.schemas.attach`\n- Commit a schema revision: ` ``pubsub.schemas.commit`\n- Delete a schema or a schema revision: ` ``pubsub.schemas.delete`\n- Get a schema or schema revisions: ` ``pubsub.schemas.get`\n- List schemas: ` ``pubsub.schemas.list`\n- List schema revisions: ` ``pubsub.schemas.listRevisions`\n- Rollback a schema: ` ``pubsub.schemas.rollback`\n- Validate a message: ` ``pubsub.schemas.validate`\n- Get the IAM policy for a schema: ` ``pubsub.schemas.getIamPolicy`\n- Configure the [IAM policy](/iam/docs/reference/rest/v1/Policy) for a schema: ` ``pubsub.schemas.setIamPolicy`\n\n\nYou might also be able to get\nthese permissions\nwith [custom roles](/iam/docs/creating-custom-roles) or\nother [predefined roles](/iam/docs/roles-overview#predefined).\n\nYou can grant roles and permissions to principals such as users, groups,\ndomains, or service accounts. You can create a schema in one project and\nattach it to a topic located in a different project.\nEnsure that you have the required permissions for\neach project.\n\nValidate a schema definition\n\nYou can validate a schema by using the\nGoogle Cloud console, the gcloud CLI, the Pub/Sub API,\nor the Cloud Client Libraries.\n\nFollow the steps discussed in [Create a schema](/pubsub/docs/create-schemas).\n\nThe validation check does not check the compatibility of the new revision\nwith the older revisions.\n\nWhat's next\n\n- [Validate a message for a schema](/pubsub/docs/validate-schema-message)\n\n- [Publish messages to a topic with a schema](/pubsub/docs/publish-topics-schema)"]]
