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

# 주제 작업
<a name="msk-topic-operations-information"></a>

Amazon MSK APIs 사용하면 Kafka 관리자 클라이언트를 설정하고 유지 관리할 필요 없이 MSK 프로비저닝 클러스터의 주제를 관리할 수 있습니다. 이러한 APIs 사용하면 보존 및 정리 정책과 같은 구성 설정과 함께 복제 인수 및 파티션 수와 같은 주제 속성을 정의하거나 읽을 수 있습니다. AWS CLI, AWS SDKs 및 AWS CloudFormation을 비롯한 친숙한 인터페이스를 사용하여 Kafka 주제를 프로그래밍 방식으로 관리할 수 있습니다. 이러한 APIs는 Amazon MSK 콘솔에도 통합되어 모든 주제 작업을 한 곳에서 수행할 수 있습니다. 이제 안내 기본값을 사용하여 몇 번의 클릭만으로 주제를 생성하거나 업데이트할 수 있으며 주제 구성, 파티션 수준 정보 및 지표에 대한 포괄적인 가시성을 얻을 수 있습니다.

**중요**  
이러한 주제 API 응답은 약 1분마다 업데이트되는 데이터를 반영합니다. 변경 후 최신 주제 상태의 경우 쿼리하기 전에 약 1분 정도 기다려야 합니다.

## 주제 APIs 사용 요구 사항
<a name="topic-operations-requirements"></a>
+ 클러스터는 MSK 프로비저닝 클러스터여야 합니다. MSK Serverless 클러스터에는 이러한 APIs를 사용할 수 없습니다.
+ 클러스터가 Apache Kafka 버전 3.6.0 이상을 실행 중이어야 합니다. 지원되는 버전에 대한 자세한 내용은 섹션을 참조하세요[지원되는 Apache Kafka 버전](supported-kafka-versions.md).
+ 클러스터가 `ACTIVE` 상태여야 합니다. 클러스터 상태에 대한 자세한 내용은 [MSK 프로비저닝된 클러스터의 상태 이해](msk-cluster-states.md) 섹션을 참조하세요.
+ 적절한 IAM 권한이 있어야 합니다. 자세한 내용은 [주제 작업 APIs에 대한 IAM 권한](#topic-operations-permissions) 단원을 참조하십시오.

## 주제 작업 APIs에 대한 IAM 권한
<a name="topic-operations-permissions"></a>

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


**주제 작업 APIs에 필요한 권한**  

| API | 필수 권한 | Resource | 
| --- | --- | --- | 
| ListTopics | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic` | 클러스터 ARN, 주제 ARN | 
| DescribeTopic | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic`<br />`kafka-cluster:DescribeTopicDynamicConfiguration` | 클러스터 ARN, 주제 ARN | 
| DescribeTopicPartitions | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic`<br />`kafka-cluster:DescribeTopicDynamicConfiguration` | 클러스터 ARN, 주제 ARN | 
| CreateTopic | `kafka-cluster:Connect`<br />`kafka-cluster:CreateTopic` | 클러스터 ARN, 주제 ARN | 
| DeleteTopic | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic`<br />`kafka-cluster:DeleteTopic` | 클러스터 ARN, 주제 ARN | 
| UpdateTopic | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic`<br />`kafka-cluster:AlterTopic`<br />`kafka-cluster:AlterTopicDynamicConfiguration` | 클러스터 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 액세스 제어](iam-access-control.md).

**Topics**
+ [주제 APIs 사용 요구 사항](#topic-operations-requirements)
+ [주제 작업 APIs에 대한 IAM 권한](#topic-operations-permissions)
+ [Amazon MSK 클러스터의 주제 나열](msk-list-topics.md)
+ [주제에 대한 자세한 정보 가져오기](msk-describe-topic.md)
+ [주제에 대한 파티션 정보 보기](msk-describe-topic-partitions.md)
+ [Amazon MSK 클러스터에서 주제 생성](msk-create-topic.md)
+ [Amazon MSK 클러스터에서 주제 업데이트](msk-update-topic.md)
+ [Amazon MSK 클러스터에서 주제 삭제](msk-delete-topic.md)