Neste documento, mostramos como listar as revisões de um esquema para tópicos do Pub/Sub.
Antes de começar
- Entenda como os esquemas do Pub/Sub funcionam.
- Crie um esquema.
Papéis e permissões necessárias
Para ter as permissões necessárias para listar as revisões de esquema e gerenciá-las,
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 como conceder papéis, consulte Gerenciar acesso.
Este papel predefinido contém as permissões necessárias para listar revisões de esquema e gerenciá-las. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:
Permissões necessárias
As permissões a seguir são necessárias para listar revisões de esquema 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 uma revisão de esquema ou 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
-
Consiga a política do IAM para um esquema:
pubsub.schemas.getIamPolicy
-
Configure a política do IAM para um esquema:
pubsub.schemas.setIamPolicy
Talvez você também consiga receber essas permissões com papéis personalizados 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. É 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.
Listar as revisões de um esquema
É possível listar as revisões de um esquema em um projeto do Google Cloud usando o console do Google Cloud, a CLI gcloud, a API Pub/Sub ou as bibliotecas de cliente do Cloud.
Console
No console do Google Cloud, acesse a página Esquemas do Pub/Sub.
A lista de esquemas é exibida.
Clique no nome do esquema que você quer conferir.
A página Detalhes do esquema é aberta.
Na seção Revisões, você pode ver a lista de revisões disponíveis para o esquema.
gcloud
Para ver a revisão mais recente de um esquema:
gcloud pubsub schemas list-revisions SCHEMA_ID
Use o comando gcloud pubsub schemas list-revisions <var>SCHEMA_ID</var> --view=FULL
para ver as definições das revisões de esquema.
REST
Para listar as revisões de um esquema, envie uma solicitação GET como a seguinte:
GET https://pubsub.googleapis.com/v1/projects/SCHEMA_NAME:listRevisions
Se bem-sucedido, o corpo da resposta incluirá um objeto JSON com todas as revisões de esquema do esquema.
C++
Antes de tentar esse exemplo, siga as instruções de configuração do C++ em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
Go
Antes de tentar esse exemplo, siga as instruções de configuração do Go em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Java
Antes de tentar essa amostra, siga as instruções de configuração do Java em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Python
Antes de tentar esse exemplo, siga as instruções de configuração do Python em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Python.
Node.js
Antes de tentar essa amostra, siga as instruções de configuração do Node.js em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
Node.js
Antes de tentar essa amostra, siga as instruções de configuração do Node.js em Guia de início rápido: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Node.js.
A seguir
Processar mensagens ao se inscrever em tópicos configurados com um esquema.