Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Neste documento, mostramos como validar esquemas para tópicos do Pub/Sub.
A verificação de validação não verifica a compatibilidade da nova revisão
com as revisões mais antigas.
Para receber as permissões necessárias para
validar e gerenciar definições de esquemas,
peça ao administrador para conceder a você o
papel do IAM de Editor do Pub/Sub (roles/pubsub.editor)
no seu projeto.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esse papel predefinido contém
as permissões necessárias para validar e gerenciar definições de esquemas. Para conferir as permissões exatas
necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para validar e gerenciar definições de esquemas:
Criar esquema:
pubsub.schemas.create
Anexe o esquema ao tópico:
pubsub.schemas.attach
Confirmar uma revisão de esquema:
pubsub.schemas.commit
Excluir um esquema ou uma revisão de esquema:
pubsub.schemas.delete
Receber um esquema ou revisões de esquema:
pubsub.schemas.get
Listar esquemas:
pubsub.schemas.list
Listar revisões de esquema:
pubsub.schemas.listRevisions
Reverter um esquema:
pubsub.schemas.rollback
Validar uma mensagem:
pubsub.schemas.validate
Acessar a política do IAM de um esquema:
pubsub.schemas.getIamPolicy
Configure a política do IAM para um esquema:
pubsub.schemas.setIamPolicy
É possível conceder papéis e permissões a principais como usuários, grupos, domínios ou contas de serviço. É possível criar um esquema em um projeto e anexá-lo a um tópico localizado em outro projeto.
Verifique se você tem as permissões necessárias para
cada projeto.
Validar uma definição de esquema
É possível validar um esquema usando o
consoleGoogle Cloud , a CLI gcloud, a API Pub/Sub
ou as bibliotecas de cliente do Cloud.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-03 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)"]]
