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
<a name="describe-topic-cli"></a>

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
<a name="describe-topic-status"></a>

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
<a name="describe-topic-configs"></a>

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](msk-configuration-properties.md#msk-topic-confinguration)