Listar versões de assunto

É possível listar as versões de um assunto em um registro de esquema específico no seu projeto.

Este documento mostra como listar versões de assunto usando o consoleGoogle Cloud ou a API Managed Kafka.

Papéis e permissões necessárias

Para ter as permissões necessárias para listar versões de assunto, peça ao administrador para conceder a você o papel do IAM de Leitor do Managed Kafka Schema Registry (roles/managedkafka.schemaRegistryViewer) no seu registro de esquema. 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 versões de assunto. 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 versões de assunto:

Conceda a seguinte permissão no assunto principal: managedkafka.versions.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 as versões de esquema em um assunto

Para listar todas as versões de um assunto em um registro de esquema específico no seu projeto, siga estas etapas.

Console

No console do Google Cloud , acesse a página Registros de esquema.

Acessar "Registros de esquema"
Clique no nome do registro de esquema em que seu assunto está localizado.
Em Assuntos neste registro de esquema, clique no nome do assunto.
Na página Detalhes do assunto, as versões do esquema são listadas em Todas as versões.
Opcional: para conferir a definição de esquema de uma versão, marque a caixa de seleção do ID da versão. A definição do esquema é mostrada em Definição.
Opcional: para conferir as diferenças entre duas versões de esquema para esse assunto, siga estas etapas:
1. Em Todas as versões, selecione as versões que você quer comparar.
2. Na área Definição, clique em Ver diferença.
As duas definições de esquema são mostradas lado a lado, com adições, exclusões e mudanças destacadas.

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 versões de assunto, faça uma solicitação GET para o método projects.locations.schemaRegistries.subjects.versions.list.

GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/subjects/SUBJECT_ID/versions
Authorization: Bearer $(gcloud auth application-default print-access-token)

Substitua:

PROJECT_ID: o ID do projeto Google Cloud .
LOCATION: a região Google Cloud em que o registro de esquema está localizado.
REGISTRY_ID: o ID do seu registro de esquema.
SUBJECT_ID: o ID do assunto.

Exemplo:

GET https://managedkafka.googleapis.com/v1main/projects/test-project/locations/us-central1/schemaRegistries/test_registry/subjects/test_subject/versions
Authorization: Bearer $(gcloud auth application-default print-access-token)

Ou com um contexto:

GET https://managedkafka.googleapis.com/v1main/projects/test-project/locations/us-central1/schemaRegistries/test_registry/contexts/test_context/subjects/test_subject/versions
Authorization: Bearer $(gcloud auth application-default print-access-token)

Em que:

test-project é o ID do projeto Google Cloud .
us-central1 é a região Google Cloud em que o registro de esquema está localizado.
test_registry é o ID do seu registro de esquema.
test_context é o ID do contexto.
test_subject é o ID do assunto.

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 versões de assunto.

Confira a seguir um exemplo de resposta bem-sucedida:

{
  "versions": [
    {
      "name": "projects/test-project/locations/us-central1/schemaRegistries/test_registry/subjects/test_subject/versions/1",
      "revisionId": "1a2b3c4d",
      "schemaId": "S12345",
      "createTime": "2024-07-15T12:00:00Z",
      "revisionCreateTime": "2024-07-15T12:00:00Z"
    },
    {
      "name": "projects/test-project/locations/us-central1/schemaRegistries/test_registry/subjects/test_subject/versions/2",
      "revisionId": "5e6f7g8h",
      "schemaId": "S67890",
      "createTime": "2024-07-16T14:30:00Z",
      "revisionCreateTime": "2024-07-16T14:30:00Z"
    }
  ]
}

Para mais informações, consulte a documentação do método projects.locations.schemaRegistries.subjects.versions.list.

A seguir

Apache Kafka® é uma marca registrada da The Apache Software Foundation ou afiliadas nos Estados Unidos e/ou em outros países.