主題操作

您可以使用 Amazon MSK APIs 來檢視 MSK 佈建叢集中主題的相關資訊。這些 APIs提供主題中繼資料的唯讀存取權，包括分割區計數、複寫因素、組態和分割區詳細資訊。此資訊有助於監控、疑難排解和了解 Kafka 主題的結構。

重要

ListTopics、 DescribeTopic和 DescribeTopicPartitions APIs 回應反映大約每分鐘更新一次的資料。對於進行變更後的最新主題狀態，請等待大約一分鐘再查詢。

注意

這些 APIs提供主題中繼資料的唯讀存取權。若要建立或修改主題，請使用 Apache Kafka 工具或 Kafka AdminClient。如需詳細資訊，請參閱步驟 4：在 Amazon MSK 叢集中建立主題。

檢視主題資訊的需求

• 您的叢集必須是 MSK 佈建的叢集。這些 APIs不適用於 MSK Serverless 叢集。

• 您的叢集必須執行 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 叢集中的主題

• 取得主題的詳細資訊

• 檢視主題的分割區資訊