É possível listar os assuntos em um registro de esquema ou contexto específico no seu projeto.
Este documento mostra como listar assuntos usando o consoleGoogle Cloud ou a API Managed Kafka.
Papéis e permissões necessárias
Para receber as permissões necessárias para listar assuntos,
peça ao administrador para conceder a você o
papel do IAM de Leitor do Managed Kafka Schema Registry (roles/managedkafka.schemaRegistryViewer)
no registro de esquema ou contexto.
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 listar assuntos. Para acessar 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 listar assuntos:
-
Conceda a seguinte permissão no registro de esquema ou contexto principal:
managedkafka.googleapis.com/subjects.list
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
Para mais informações sobre papéis predefinidos, consulte os papéis predefinidos do Managed Service para Apache Kafka.
Listar os assuntos em um registro de esquema
Para listar todos os assuntos em um registro de esquema ou contexto específico no seu projeto, siga estas etapas.
Console
No console do Google Cloud , acesse a página Registros de esquema.
Clique no nome do registro de esquema com os detalhes que você quer ver.
Na página Detalhes do registro de esquema, os assuntos são listados em Assuntos neste registro de esquema.
Opcional: para filtrar quais assuntos são mostrados, clique em Filtrar. É possível filtrar pelas seguintes propriedades:
- Nome
- Contexto
- Exclusão reversível (Sim/Não)
Opcional: para mostrar ou ocultar colunas, clique em Opções de exibição de colunas e selecione as colunas que você quer ver ou ocultar.
REST
A solicitação precisa ser autenticada com um token de acesso no cabeçalho Authorization. Para conseguir um token de acesso para o Application Default
Credentials:
gcloud auth application-default print-access-token.
Para listar assuntos diretamente em um registro de esquema, faça uma solicitação GET ao URI específico usando o método projects.locations.schemaRegistries.schemas.subjects.list para o contexto padrão.
GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/subjects
Authorization: Bearer $(gcloud auth application-default print-access-token)
Para listar assuntos em um contexto em um registro de esquema, faça uma solicitação GET
para o URI específico usando o método
projects.locations.schemaRegistries.contexts.schemas.subjects.list:
GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/contexts/CONTEXT_ID/subjects?subjectPrefix=SUBJECT_PREFIX
Authorization: Bearer $(gcloud auth application-default print-access-token)
Substitua:
PROJECT_ID (obrigatório): ID do projeto do Google Cloud.
LOCATION (obrigatório): a Google Cloud região em que o registro de esquema está localizado.
REGISTRY_ID (obrigatório): o ID do seu registro de esquema.
CONTEXT_ID (opcional): o ID do contexto (se listar assuntos em um contexto).
SUBJECT_PREFIX (opcional): o contexto para filtrar os assuntos, no formato
:.{context}:. Se não for definido, todos os assuntos no registro serão retornados. Se definido como uma string vazia, lista assuntos no contexto padrão.
Se a solicitação for bem-sucedida, a API vai retornar um código de status 200 OK. O corpo da resposta contém uma matriz JSON de nomes de assuntos.
Confira a seguir um exemplo de resposta bem-sucedida de assuntos em uma matriz JSON para o contexto padrão:
[
"orders-topic-key",
"orders-topic-value",
"user-profile-event"
]
Os assuntos em contextos não padrão são retornados no formato :.context:subject.
Para mais informações, consulte a
documentação
do método projects.locations.schemaRegistries.contexts.schemas.subjects/list.
A seguir
- Saiba mais sobre o registro de esquema
- Listar versões do assunto
- Registrar uma nova versão do esquema
- Excluir um assunto