기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
주제 작업
Amazon MSK APIs 사용하면 Kafka 관리자 클라이언트를 설정하고 유지 관리할 필요 없이 MSK 프로비저닝 클러스터의 주제를 관리할 수 있습니다. 이러한 APIs 사용하면 보존 및 정리 정책과 같은 구성 설정과 함께 복제 인수 및 파티션 수와 같은 주제 속성을 정의하거나 읽을 수 있습니다. AWS CLI, AWS SDKs 및 AWS CloudFormation을 비롯한 친숙한 인터페이스를 사용하여 Kafka 주제를 프로그래밍 방식으로 관리할 수 있습니다. 이러한 APIs는 Amazon MSK 콘솔에도 통합되어 모든 주제 작업을 한 곳에서 수행할 수 있습니다. 이제 안내 기본값을 사용하여 몇 번의 클릭만으로 주제를 생성하거나 업데이트할 수 있으며 주제 구성, 파티션 수준 정보 및 지표에 대한 포괄적인 가시성을 얻을 수 있습니다.
중요
이러한 주제 API 응답은 약 1분마다 업데이트되는 데이터를 반영합니다. 변경 후 최신 주제 상태의 경우 쿼리하기 전에 약 1분 정도 기다려야 합니다.
주제 APIs 사용 요구 사항
-
클러스터는 MSK 프로비저닝 클러스터여야 합니다. MSK Serverless 클러스터에는 이러한 APIs를 사용할 수 없습니다.
-
클러스터가 Apache Kafka 버전 3.6.0 이상을 실행 중이어야 합니다. 지원되는 버전에 대한 자세한 내용은 섹션을 참조하세요지원되는 Apache Kafka 버전.
-
클러스터가
ACTIVE상태여야 합니다. 클러스터 상태에 대한 자세한 내용은 MSK 프로비저닝된 클러스터의 상태 이해 섹션을 참조하세요. -
적절한 IAM 권한이 있어야 합니다. 자세한 내용은 주제 작업 APIs에 대한 IAM 권한 단원을 참조하십시오.
주제 작업 APIs에 대한 IAM 권한
이러한 APIs 호출하려면 적절한 IAM 권한이 있어야 합니다. 다음 표에는 각 API에 필요한 권한이 나열되어 있습니다.
| API | 필수 권한 | Resource |
|---|---|---|
| ListTopics |
|
클러스터 ARN, 주제 ARN |
| DescribeTopic |
|
클러스터 ARN, 주제 ARN |
| DescribeTopicPartitions |
|
클러스터 ARN, 주제 ARN |
| CreateTopic |
|
클러스터 ARN, 주제 ARN |
| DeleteTopic |
|
클러스터 ARN, 주제 ARN |
| UpdateTopic |
|
클러스터 ARN, 주제 ARN |
참고
의 경우 IAM 정책에서 클러스터 ARN을 kafka-cluster:Connect지정합니다. 다른 모든 작업의 경우 IAM 정책에서 주제 ARN을 지정합니다.
참고
의 경우 와일드카드(*)를 사용하여 클러스터의 모든 주제를 일치시킬 ListTopics수 있습니다. 예를 들어 arn:aws:kafka:us-east-1:123456789012:topic/my-cluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/*입니다.
Amazon MSK의 IAM 액세스 제어에 대한 자세한 내용은 섹션을 참조하세요IAM 액세스 제어.
주제
