Este documento mostra 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 mais antigas.
Antes de começar
- Entenda como os esquemas do Pub/Sub funcionam.
- Crie um esquema.
Papéis e permissões necessárias
Para receber as permissões necessárias para validar definições de esquemas e gerenciá-las, peça ao administrador para conceder a você o papel do IAM de Editor do Pub/Sub (roles/pubsub.editor) no 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 definições de esquemas e gerenciá-las. Para acessar as permissões exatas que são necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As seguintes permissões são necessárias para validar definições de esquemas e gerenciá-las:
-
Criar esquema:
pubsub.schemas.create -
Anexar 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 -
Receber a política do IAM para um esquema:
pubsub.schemas.getIamPolicy -
Configurar a política do IAM para um esquema:
pubsub.schemas.setIamPolicy
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
É possível conceder papéis e permissões a principais, como usuários, grupos, domínios ou contas de serviço. Você pode 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 Cloud de Confiance console, a CLI gcloud, a API Pub/Sub, ou as bibliotecas de cliente do Cloud.
Siga as etapas discutidas em Criar um esquema.
A verificação de validação não verifica a compatibilidade da nova revisão com as mais antigas.