기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 를 사용하여 주제 나열 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`.