Descreva um tópico usando o AWS CLI - Amazon Managed Streaming for Apache Kafka
Entendendo o status do tópicoEntendendo as configurações de tópicos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Descreva um tópico usando o AWS CLI

Execute o comando a seguir, ClusterArn substituindo-o pelo Amazon Resource Name (ARN) do seu cluster e TopicName pelo nome do tópico que você deseja descrever.

aws kafka describe-topic --cluster-arn ClusterArn --topic-name TopicName

A saída desse comando é semelhante ao seguinte JSON de exemplo.

{
    "topicArn": "arn:aws:kafka:us-east-1:123456789012:topic/MyCluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/MyTopic",
    "topicName": "MyTopic",
    "partitionCount": 3,
    "replicationFactor": 3,
    "configs": "Y29tcHJlc3Npb24udHlwZT1wcm9kdWNlcgpyZXRlbnRpb24ubXM9NjA0ODAwMDAw",
    "status": "ACTIVE"
}

Entendendo o status do tópico

O status campo indica o estado atual do tópico. A tabela a seguir descreve os possíveis valores de status.

Valores de status do tópico
Status Description
CRIANDO O tópico está sendo criado.
ATIVO O tópico está ativo e pronto para uso.
ATUALIZANDO A configuração do tópico está sendo atualizada.
EXCLUINDO O tópico está sendo excluído.

Entendendo as configurações de tópicos

O configs campo contém as propriedades de configuração do Kafka do tópico, codificadas no formato Base64. Para visualizar a configuração em um formato legível, você precisa decodificar a string Base64.

O exemplo a seguir mostra como decodificar a configuração usando o base64 comando no Linux ou no macOS.

echo "Y29tcHJlc3Npb24udHlwZT1wcm9kdWNlcgpyZXRlbnRpb24ubXM9NjA0ODAwMDAw" | base64 --decode

A saída decodificada mostra as propriedades de configuração do tópico no formato de valor-chave.

compression.type=producer
retention.ms=604800000

Para obter mais informações sobre propriedades de configuração em nível de tópico, consulte. Configuração no nível de tópico do Amazon MSK