翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# を使用してトピックを一覧表示する 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-orders`や など`prod-`、名前が で始まるトピックのみを返します`prod-inventory`。