主题操作 - Amazon Managed Streaming for Apache Kafka
要求IAM 权限
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

主题操作

您可以使用 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 访问控制。

主题