Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Décrivez un sujet à l'aide du AWS CLI
<a name="describe-topic-cli"></a>

Exécutez la commande suivante, en la *ClusterArn* remplaçant par le Amazon Resource Name (ARN) de votre cluster et *TopicName* par le nom du sujet que vous souhaitez décrire.

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

La sortie de cette commande ressemble à l'exemple JSON suivant.

```
{
    "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"
}
```

## Comprendre le statut du sujet
<a name="describe-topic-status"></a>

Le `status` champ indique l'état actuel du sujet. Le tableau suivant décrit les valeurs d'état possibles.


**Valeurs d'état du sujet**  

| Statut | Description | 
| --- | --- | 
| CRÉATION | Le sujet est en cours de création. | 
| ACTIF | Le sujet est actif et prêt à être utilisé. | 
| MISE À JOUR | La configuration de la rubrique est en cours de mise à jour. | 
| SUPPRESSION | Le sujet est en cours de suppression. | 

## Comprendre les configurations des rubriques
<a name="describe-topic-configs"></a>

Le `configs` champ contient les propriétés de configuration Kafka du sujet, codées au format Base64. Pour afficher la configuration dans un format lisible, vous devez décoder la chaîne Base64.

L'exemple suivant montre comment décoder la configuration à l'aide de la `base64` commande sous Linux ou macOS.

```
echo "Y29tcHJlc3Npb24udHlwZT1wcm9kdWNlcgpyZXRlbnRpb24ubXM9NjA0ODAwMDAw" | base64 --decode
```

La sortie décodée affiche les propriétés de configuration du sujet au format clé-valeur.

```
compression.type=producer
retention.ms=604800000
```

Pour plus d'informations sur les propriétés de configuration au niveau des rubriques, consultez. [Configuration Amazon MSK au niveau du sujet](msk-configuration-properties.md#msk-topic-confinguration)