Neste documento, mostramos como visualizar detalhes do 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 receber as permissões necessárias para visualizar detalhes do esquema e gerenciá-los,
peça ao administrador para conceder a você o papel do IAM
Editor do Pub/Sub (roles/pubsub.editor
) no projeto.
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
Esse papel predefinido contém as permissões necessárias para visualizar detalhes do esquema e gerenciá-los. 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 visualizar detalhes do esquema e gerenciá-los:
-
Criar esquema:
pubsub.schemas.create
-
Anexar esquema ao tópico:
pubsub.schemas.attach
-
Confirme uma revisão de esquema:
pubsub.schemas.commit
-
Exclua um esquema ou uma revisão de esquema:
pubsub.schemas.delete
-
Receba 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
-
Consiga a política do IAM para um esquema:
pubsub.schemas.getIamPolicy
-
Configure a política do IAM para um esquema:
pubsub.schemas.setIamPolicy
Também é possível receber essas permissões com papéis personalizados ou outros papéis predefinidos.
É possível conceder papéis e permissões aos 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.
Mais detalhes do esquema
É possível conseguir os detalhes de um esquema usando o Console do Google Cloud, a CLI gcloud, a API Pub/Sub ou as bibliotecas de cliente do Cloud. Os resultados retornam os detalhes do ID de revisão mais recente.
Console
No console do Google Cloud, acesse a página Esquemas do Pub/Sub.
Clique no nome do esquema que você quer visualizar.
A página Detalhes do esquema é aberta.
gcloud
Para conferir a revisão mais recente de um esquema, faça o seguinte:
gcloud pubsub schemas describe SCHEMA_NAME
Para ver uma revisão específica de um esquema:
gcloud pubsub schemas describe SCHEMA_ID@REVISION_ID
Em que:
- REVISION_ID é a revisão para a qual você quer reverter.
REST
Para acessar os detalhes da revisão mais recente de um esquema, envie uma solicitação GET como esta:
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID
Por exemplo, para um esquema com o ID de esquema schema-inventory
, envie a seguinte solicitação: https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/schema-inventory
Para acessar os detalhes de uma revisão específica de um esquema, envie uma solicitação GET como esta:
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID@REVISION_ID
Por exemplo, para um esquema com o ID de esquema schema-inventory
e o ID de revisão fa567a3e
, envie a seguinte solicitação: https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/schema-inventory@fa567a3e
Em que:
- PROJECT_ID é o ID do projeto;
- SCHEMA_ID é o ID do esquema.
- REVISION_ID é o ID da revisão do esquema específico.
Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância da classe Schema.
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++.
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.
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.
PHP
Antes de tentar esse exemplo, siga as instruções de configuração do PHP 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 PHP.
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.
Ruby
Antes de tentar esse exemplo, siga as instruções de configuração do Ruby 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 Ruby.
A seguir
- Excluir uma revisão de esquema
- Excluir um esquema
- Esquemas de listas
- Listar revisões de um esquema
- Assinar um tópico com um esquema