本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

您可以使用 Amazon MSK APIs 來管理 MSK 佈建叢集中的主題，而不需要設定和維護 Kafka 管理員用戶端。使用這些 APIs，您可以定義或讀取複寫係數和分割區計數等主題屬性，以及保留和清除政策等組態設定。您可以使用熟悉的界面以程式設計方式管理 Kafka 主題，包括 AWS CLI、SDK 和 AWS CloudFormation。 AWS SDKs 這些 APIs也會整合到 Amazon MSK 主控台，將所有主題操作集中到一處。您現在可以使用引導式預設值，只要按幾下滑鼠就能建立或更新主題，同時全面了解主題組態、分割區層級資訊和指標。

**重要**  
這些主題 API 回應反映大約每分鐘更新的資料。對於進行變更後的最新主題狀態，請等待大約一分鐘再查詢。

## 使用主題 APIs的需求
<a name="topic-operations-requirements"></a>
+ 您的叢集必須是 MSK 佈建叢集。這些 APIs不適用於 MSK Serverless 叢集。
+ 您的叢集必須執行 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 | 所需的許可 | 資源 | 
| --- | --- | --- | 
| 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)
+ [主題操作 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)