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.

# Répertoriez les sujets en utilisant le AWS CLI
<a name="list-topics-cli"></a>

Exécutez la commande suivante, en la *ClusterArn* remplaçant par le Amazon Resource Name (ARN) de votre cluster. Si vous n'avez pas l'ARN pour votre cluster, vous pouvez le trouver en listant tous les clusters. Pour de plus amples informations, veuillez consulter [Répertorier les clusters Amazon MSK](msk-list-clusters.md).

```
aws kafka list-topics --cluster-arn ClusterArn
```

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

```
{
    "topics": [
        {
            "topicArn": "arn:aws:kafka:us-east-1:123456789012:topic/MyCluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/MyTopic",
            "topicName": "MyTopic",
            "partitionCount": 3,
            "replicationFactor": 3,
            "outOfSyncReplicaCount": 0
        },
        {
            "topicArn": "arn:aws:kafka:us-east-1:123456789012:topic/MyCluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/AnotherTopic",
            "topicName": "AnotherTopic",
            "partitionCount": 6,
            "replicationFactor": 3,
            "outOfSyncReplicaCount": 1
        }
    ]
}
```

## Pagination des résultats
<a name="list-topics-pagination"></a>

Si votre cluster comporte de nombreux sujets, vous pouvez utiliser la pagination pour récupérer les résultats par petits lots. Utilisez le `--max-results` paramètre pour spécifier le nombre maximum de sujets à renvoyer et utilisez-le `--next-token` pour récupérer la page de résultats suivante.

```
aws kafka list-topics --cluster-arn ClusterArn --max-results 10
```

Si d'autres résultats sont disponibles, la réponse inclut une `nextToken` valeur. Utilisez ce jeton pour récupérer la page de résultats suivante.

```
aws kafka list-topics --cluster-arn ClusterArn --max-results 10 --next-token NextToken
```

## Filtrer les sujets par nom
<a name="list-topics-filter"></a>

Vous pouvez filtrer la liste des sujets en spécifiant un préfixe à l'aide du `--topic-name-filter` paramètre. Cela renvoie uniquement les sujets dont le nom commence par le préfixe spécifié.

```
aws kafka list-topics --cluster-arn ClusterArn --topic-name-filter "prod-"
```

Cette commande renvoie uniquement les rubriques dont le nom commence par`prod-`, par exemple `prod-orders` ou`prod-inventory`.