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 ter as permissões necessárias para visualizar detalhes do esquema e gerenciá-los,
peça ao administrador para conceder a você
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
-
Receber um esquema ou revisões de esquema:
pubsub.schemas.get
-
Listar esquemas:
pubsub.schemas.list
-
Listar revisões de esquema:
pubsub.schemas.listRevisions
-
Reverta um esquema:
pubsub.schemas.rollback
-
Validar uma mensagem:
pubsub.schemas.validate
-
Encontre a política do IAM para um esquema:
pubsub.schemas.getIamPolicy
-
Configure 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 aos principais, como usuários, grupos domínios ou contas de serviço. É possível criar um esquema em um projeto anexar a um tópico localizado em um projeto diferente. Verifique se você tem as permissões necessárias para para cada projeto.
Mais detalhes do esquema
É possível conferir 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 das atualizações ID de revisão.
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 do tipo o seguinte:
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 o
seguinte solicitação: https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/schema-inventory
Para conseguir os detalhes de uma revisão específica de um esquema, envie uma solicitação GET como o seguinte:
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 bem-sucedido, o corpo da resposta conterá uma instância do Classe 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++.
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