本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 主题操作
<a name="msk-topic-operations-information"></a>

您可以使用 Amazon MSK APIs 管理您的 MSK 预配置集群中的主题，而无需设置和维护 Kafka 管理员客户端。有了这些 APIs，您可以定义或读取主题属性，例如复制因子和分区计数，以及保留和清理策略等配置设置。您可以使用熟悉的界面（包括 CL Amazon I、 Amazon SDKs和）以编程方式管理 Kafka 主题。 Amazon CloudFormation APIs 它们还集成到 Amazon MSK 控制台中，将所有主题操作集中到一个地方。现在，您只需点击几下即可使用引导式默认设置创建或更新主题，同时全面了解主题配置、分区级信息和指标。

**重要**  
这些主题 API 响应反映的数据大约每分钟更新一次。要了解更改后的最新主题状态，请在查询前等待大约一分钟。

## 使用主题的要求 APIs
<a name="topic-operations-requirements"></a>
+ 您的集群必须是 MSK 预配置的集群。 APIs 这些不适用于 MSK 无服务器集群。
+ 您的集群必须运行 Apache Kafka 版本 3.6.0 或更高版本。有关支持的版本的更多信息，请参阅[支持的 Apache Kafka 版本](supported-kafka-versions.md)。
+ 您的集群必须处于`ACTIVE`状态。有关集群状态的更多信息，请参阅[了解预置 MSK 集群状态](msk-cluster-states.md)。
+ 您必须拥有相应的 IAM 权限。有关更多信息，请参阅 [用于主题操作的 IAM 权限 APIs](#topic-operations-permissions)。

## 用于主题操作的 IAM 权限 APIs
<a name="topic-operations-permissions"></a>

要调用它们 APIs，您必须拥有相应的 IAM 权限。下表列出了每个 API 所需的权限。


**主题操作所需的权限 APIs**  

| API | 所需权限 | 资源 | 
| --- | --- | --- | 
| ListTopics |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic`  | 集群 ARN，主题 ARN | 
| DescribeTopic |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:DescribeTopicDynamicConfiguration`  | 集群 ARN，主题 ARN | 
| DescribeTopicPartitions |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:DescribeTopicDynamicConfiguration`  | 集群 ARN，主题 ARN | 
| CreateTopic |  `kafka-cluster:Connect` `kafka-cluster:CreateTopic`  | 集群 ARN，主题 ARN | 
| DeleteTopic |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:DeleteTopic`  | 集群 ARN，主题 ARN | 
| UpdateTopic |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:AlterTopic` `kafka-cluster:AlterTopicDynamicConfiguration`  | 集群 ARN，主题 ARN | 

**注意**  
对于`kafka-cluster:Connect`，请在您的 IAM 策略中指定集群 ARN。对于所有其他操作，请在您的 IAM 策略中指定主题 ARN。

**注意**  
对于`ListTopics`，您可以使用通配符 (\$1) 来匹配集群上的所有主题。例如：`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)
+ [用于主题操作的 IAM 权限 APIs](#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)