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á.

# Listar tópicos usando o AWS CLI
<a name="list-topics-cli"></a>

Execute o comando a seguir, *ClusterArn* substituindo-o pelo Amazon Resource Name (ARN) do seu cluster. Se você não tiver o ARN do cluster, poderá encontrá-lo listando todos os clusters. Para obter mais informações, consulte [Listar clusters do Amazon MSK](msk-list-clusters.md).

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

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

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

## Como paginar resultados
<a name="list-topics-pagination"></a>

Se seu cluster tiver muitos tópicos, você poderá usar a paginação para recuperar os resultados em lotes menores. Use o `--max-results` parâmetro para especificar o número máximo de tópicos a serem retornados e use o `--next-token` parâmetro para recuperar a próxima página de resultados.

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

Se houver mais resultados disponíveis, a resposta incluirá um `nextToken` valor. Use esse token para recuperar a próxima página de resultados.

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

## Filtrando tópicos por nome
<a name="list-topics-filter"></a>

Você pode filtrar a lista de tópicos especificando um prefixo usando o `--topic-name-filter` parâmetro. Isso retorna somente tópicos cujos nomes começam com o prefixo especificado.

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

Esse comando retorna somente tópicos cujos nomes começam com`prod-`, como `prod-orders` ou`prod-inventory`.