主题操作

您可以使用 Amazon MSK 查看 APIs 有关 MSK 预配置集群中主题的信息。它们 APIs 提供对主题元数据的只读访问权限，包括分区计数、复制因子、配置和分区详细信息。此信息对于监控、故障排除和理解 Kafka 主题的结构非常有用。

重要

ListTopicsDescribeTopic、和DescribeTopicPartitions APIs 响应反映的数据大约每分钟更新一次。要了解更改后的最新主题状态，请在查询前等待大约一分钟。

注意

它们 APIs 提供对主题元数据的只读访问权限。要创建或修改主题，请使用 Apache Kafka 工具或 Kafka。 AdminClient有关更多信息，请参阅 步骤 4：在 Amazon MSK 集群中创建主题。

查看主题信息的要求

• 您的集群必须是 MSK 预配置的集群。 APIs 这些不适用于 MSK 无服务器集群。

• 您的集群必须运行 Apache Kafka 版本 3.6.0 或更高版本。有关支持的版本的更多信息，请参阅支持的 Apache Kafka 版本。

• 您的集群必须处于ACTIVE状态。有关集群状态的更多信息，请参阅了解预置 MSK 集群状态。

• 您必须拥有相应的 IAM 权限。有关更多信息，请参阅 查看主题信息的 IAM 权限。

查看主题信息的 IAM 权限

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

查看主题信息所需的权限

API	所需权限	资源
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

注意

对于ListTopics，请在您的 IAM 策略中指定集群 ARN。对于DescribeTopic和DescribeTopicPartitions，请在您的 IAM 策略中指定主题 ARN。

有关适用于 Amazon MSK 的 IAM 访问控制的更多信息，请参阅IAM 访问控制。

主题

• 在 Amazon MSK 集群中列出主题

• 获取有关某个主题的详细信息

• 查看主题的分区信息