本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

執行下列命令，以叢集的 Amazon Resource Name (ARN) 取代 *ClusterArn*。若您沒有叢集的 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`。