주제 작업

Amazon MSK APIs 사용하여 MSK 프로비저닝 클러스터의 주제에 대한 정보를 볼 수 있습니다. 이러한 APIs 파티션 수, 복제 인자, 구성 및 파티션 세부 정보를 포함한 주제 메타데이터에 대한 읽기 전용 액세스를 제공합니다. 이 정보는 Kafka 주제의 구조를 모니터링, 문제 해결 및 이해하는 데 유용합니다.

중요

ListTopics, DescribeTopic및 DescribeTopicPartitions APIs 응답에는 약 1분마다 업데이트되는 데이터가 반영됩니다. 변경 후 최신 주제 상태의 경우 쿼리하기 전에 약 1분 정도 기다려야 합니다.

참고

이러한 APIs 주제 메타데이터에 대한 읽기 전용 액세스를 제공합니다. 주제를 생성하거나 수정하려면 Apache Kafka 도구 또는 Kafka AdminClient를 사용합니다. 자세한 내용은 4단계: Amazon MSK 클러스터에서 주제 생성 단원을 참조하십시오.

주제 정보 보기 요구 사항

• 클러스터는 MSK 프로비저닝 클러스터여야 합니다. MSK Serverless 클러스터에는 이러한 APIs를 사용할 수 없습니다.

• 클러스터가 Apache Kafka 버전 3.6.0 이상을 실행 중이어야 합니다. 지원되는 버전에 대한 자세한 내용은 섹션을 참조하세요지원되는 Apache Kafka 버전.

• 클러스터가 ACTIVE 상태여야 합니다. 클러스터 상태에 대한 자세한 내용은 MSK 프로비저닝된 클러스터의 상태 이해 섹션을 참조하세요.

• 적절한 IAM 권한이 있어야 합니다. 자세한 내용은 주제 정보를 볼 수 있는 IAM 권한 단원을 참조하십시오.

주제 정보를 볼 수 있는 IAM 권한

이러한 APIs 호출하려면 적절한 IAM 권한이 있어야 합니다. 다음 표에는 각 API에 필요한 권한이 나열되어 있습니다.

주제 정보를 보는 데 필요한 권한

API	필수 권한	Resource
ListTopics	kafka-cluster:Connect kafka-cluster:DescribeTopic	클러스터 ARN
DescribeTopic	kafka-cluster:Connect kafka-cluster:DescribeTopic kafka-cluster:DescribeTopicDynamicConfiguration	주제 ARN
DescribeTopicPartitions	kafka-cluster:Connect kafka-cluster:DescribeTopic kafka-cluster:DescribeTopicDynamicConfiguration	주제 ARN

참고

의 경우 IAM 정책에서 클러스터 ARN을 ListTopics지정합니다. DescribeTopic 및의 경우 IAM 정책에서 주제 ARN을 DescribeTopicPartitions지정합니다.

Amazon MSK의 IAM 액세스 제어에 대한 자세한 내용은 섹션을 참조하세요IAM 액세스 제어.

주제

• Amazon MSK 클러스터의 주제 나열

• 주제에 대한 자세한 정보 가져오기

• 주제에 대한 파티션 정보 보기