本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用列出主题 AWS CLI
<a name="list-topics-cli"></a>

运行以下命令，*ClusterArn*替换为集群的 Amazon 资源名称 (ARN)。如果您没有该集群的 ARN，可以通过列出所有集群来找到它。有关更多信息，请参阅 [列出 Amazon MSK 集群](msk-list-clusters.md)。

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

该 命令的输出如以下 JSON 示例所示。

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

## 对结果进行分页
<a name="list-topics-pagination"></a>

如果您的集群有许多主题，则可以使用分页功能以较小的批量检索结果。使用`--max-results`参数指定要返回的最大主题数，并使用`--next-token`参数检索下一页的结果。

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

如果有更多结果可用，则响应中会包含一个`nextToken`值。使用此令牌检索下一页的结果。

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

## 按名称筛选主题
<a name="list-topics-filter"></a>

您可以通过使用`--topic-name-filter`参数指定前缀来筛选主题列表。这将仅返回名称以指定前缀开头的主题。

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

此命令仅返回名称以开头的主题`prod-`，例如`prod-orders`或`prod-inventory`。