Listar todos os registros de esquema

Pré-lançamento

Este produto ou recurso está sujeito aos "Termos das Soluções Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os produtos e recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

É possível listar os registros de esquema no seu projeto. Este documento mostra como listar registros de esquema usando o consoleGoogle Cloud , a Google Cloud CLI ou a API Managed Kafka.

Papéis e permissões necessárias

Para receber as permissões necessárias para listar registros de esquema, peça ao administrador para conceder a você o papel do IAM de Leitor do registro de esquema do Kafka gerenciado (roles/managedkafka.schemaRegistryViewer) no seu projeto e local. 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 registros de esquema. 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 registros de esquema:

• Conceda a seguinte permissão no local principal: managedkafka.schemaRegistries.list

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Funções de nível mais alto, como Editor do registro de esquema do Kafka gerenciado (roles/managedkafka.schemaRegistryEditor) e Administrador do registro de esquema do Kafka gerenciado (roles/managedkafka.schemaRegistryAdmin), também permitem listar registros de esquema.

Para mais informações sobre papéis predefinidos, consulte os papéis predefinidos do Managed Service para Apache Kafka.

Listar os registros de esquema

Para listar todos os registros de esquema no projeto, siga estas etapas.

Console

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

   Acessar registros de esquema

   A página mostra uma lista de registros de esquema no seu projeto. A lista inclui colunas para as seguintes propriedades:

   • Nome: o identificador exclusivo do registro de esquema.
   • Região: a Google Cloud região em que o registro de esquema está hospedado.

gcloud

1. Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando:

   gcloud init

   Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.

2. Execute o comando gcloud beta managed-kafka schema-registries list:

gcloud beta managed-kafka schema-registries list \
    --location=LOCATION \

Substitua:

• LOCATION (obrigatório): a Google Cloud região para listar os registros de esquema.

Por exemplo, para listar todos os registros de esquema no local us-central1, execute o seguinte comando:

gcloud beta managed-kafka schema-registries list --location=us-central1

Exemplo de resposta:

NAME             LOCATION
sr_docs      us-central1
sr_docs23    us-central1
sr23wert     us-central1

REST

Para listar os registros de esquema, use o método projects.locations.schemaRegistries.list.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID: o ID do projeto do Google Cloud
• LOCATION: o local em que você quer receber a lista de registros de esquema. Por exemplo, us-central1

Método HTTP e URL:

GET https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "schemaRegistries": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID",
      "contexts": [
        "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID/contexts/.",
        "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID/contexts/CONTEXT_NAME"
      ]
    }
}

O objeto JSON retornado inclui uma lista de registros de esquema encontrados no local especificado. Se o parâmetro de consulta view for SCHEMA_REGISTRY_VIEW_FULL, a resposta também vai incluir os contextos associados a cada registro de esquema.

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