を使用してトピックを一覧表示するAWS CLI

次のコマンドを実行し、ClusterArn をクラスターの Amazon リソースネーム (ARN) に置き換えます。クラスターの ARN がない場合は、すべてのクラスターを一覧表示することで見つけられます。詳細については、「Amazon MSK クラスターを一覧表示する」を参照してください。

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
        }
    ]
}

結果のページ分割

クラスターに多くのトピックがある場合は、ページ分割を使用して小さなバッチで結果を取得できます。--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

名前によるトピックのフィルタリング

--topic-name-filter パラメータを使用してプレフィックスを指定することで、トピックのリストをフィルタリングできます。これにより、名前が指定されたプレフィックスで始まるトピックのみが返されます。

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

このコマンドは、 prod-ordersや などprod-、名前が で始まるトピックのみを返しますprod-inventory。