適用於 Amazon MSK 叢集之 Apache Kafka API 的動作、資源和條件索引鍵

適用於 Amazon MSK 叢集的 Apache Kafka API (服務字首：kafka-cluster) 提供下列服務特有的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。

參考資料：

• 了解如何設定此服務。

• 檢視可供此服務使用的 API 操作清單。

• 了解如何使用 IAM 許可政策來保護此服務及其資源。

適用於 Amazon MSK 叢集之 Apache Kafka API 定義的動作

您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS 中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果此欄包含資源類型，則您可以在包含該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，發起人必須具有將動作與這些資源搭配使用的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱動作表。

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
AlterCluster	准許改變叢集的各個方面，相當於 Apache Kafka 的 ALTER CLUSTER ACL	寫入	cluster*		kafka-cluster:Connect kafka-cluster:DescribeCluster
AlterClusterDynamicConfiguration	准許改變叢集的動態組態，相當於 Apache Kafka 的 ALTER_CONFIGS CLUSTER ACL	寫入	cluster*		kafka-cluster:Connect kafka-cluster:DescribeClusterDynamicConfiguration
AlterGroup	准許加入叢集上的群組，相當於 Apache Kafka 的 READ GROUP ACL	寫入	group*		kafka-cluster:Connect kafka-cluster:DescribeGroup
AlterTopic	准許改變叢集上的主題，相當於 Apache Kafka 的 ALTER TOPIC ACL	寫入	topic*		kafka-cluster:Connect kafka-cluster:DescribeTopic
AlterTopicDynamicConfiguration	准許改變叢集上主題的動態組態，相當於 Apache Kafka 的 ALTER_CONFIGS TOPIC ACL	寫入	topic*		kafka-cluster:Connect kafka-cluster:DescribeTopicDynamicConfiguration
AlterTransactionalId	准許改變叢集上的交易 ID，相當於 Apache Kafka 的 WRITE TRANSACTIONAL_ID ACL	寫入	transactional-id*		kafka-cluster:Connect kafka-cluster:DescribeTransactionalId kafka-cluster:WriteData
Connect	准許連線和身分驗證叢集	寫入	cluster*
CreateTopic	准許在叢集上建立主題，相當於 Apache Kafka 的 CREATE CLUSTER/TOPIC ACL	寫入	topic*		kafka-cluster:Connect
DeleteGroup	准許刪除叢集上的群組，相當於 Apache Kafka 的 DELETE GROUP ACL	寫入	group*		kafka-cluster:Connect kafka-cluster:DescribeGroup
DeleteTopic	准許刪除叢集上的主題，相當於 Apache Kafka 的 DELETE TOPIC ACL	寫入	topic*		kafka-cluster:Connect kafka-cluster:DescribeTopic
DescribeCluster	准許描述集群的各個方面，相當於 Apache Kafka 的 DESCRIBE CLUSTER ACL	列出	cluster*		kafka-cluster:Connect
DescribeClusterDynamicConfiguration	准許描述叢集的動態組態，相當於 Apache Kafka 的 DESCRIBE_CONFIGS CLUSTER ACL	列出	cluster*		kafka-cluster:Connect
DescribeGroup	准許描述群集上的群組，相當於 Apache Kafka 的 DESCRIBE GROUP ACL	列出	group*		kafka-cluster:Connect
DescribeTopic	准許描述叢集上的主題，相當於 Apache Kafka 的 DESCRIBE TOPIC ACL	列出	topic*		kafka-cluster:Connect
DescribeTopicDynamicConfiguration	准許描述叢集上主題的動態組態，相當於 Apache Kafka 的 DESCRIBE_CONFIGS TOPIC ACL	列出	topic*		kafka-cluster:Connect
DescribeTransactionalId	准許描述叢集上的交易 ID，相當於 Apache Kafka 的 DESCRIBE TRANSACTIONAL_ID ACL	列出	transactional-id*		kafka-cluster:Connect
ReadData	准許讀取叢集上主題的資料，相當於 Apache Kafka 的 READ TOPIC ACL	讀取	topic*		kafka-cluster:AlterGroup kafka-cluster:Connect kafka-cluster:DescribeTopic
WriteData	准許寫入叢集上主題的資料，相當於 Apache Kafka 的 WRITE TOPIC ACL	寫入	topic*		kafka-cluster:Connect kafka-cluster:DescribeTopic
WriteDataIdempotently	准許等效地在叢集上寫入資料，相當於 Apache Kafka 的 IDEMPOTENT_WRITE CLUSTER ACL	寫入	cluster*		kafka-cluster:Connect kafka-cluster:WriteData

適用於 Amazon MSK 叢集之 Apache Kafka API 定義的資料類型

此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型表。

資源類型	ARN	條件索引鍵
cluster	arn:${Partition}:kafka:${Region}:${Account}:cluster/${ClusterName}/${ClusterUuid}	aws:ResourceTag/${TagKey}
topic	arn:${Partition}:kafka:${Region}:${Account}:topic/${ClusterName}/${ClusterUuid}/${TopicName}
group	arn:${Partition}:kafka:${Region}:${Account}:group/${ClusterName}/${ClusterUuid}/${GroupName}
transactional-id	arn:${Partition}:kafka:${Region}:${Account}:transactional-id/${ClusterName}/${ClusterUuid}/${TransactionalId}

適用於 Amazon MSK 叢集之 Apache Kafka API 的條件索引鍵

適用於 Amazon MSK 叢集之 Apache Kafka API 定義了下列條件索引鍵，可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。

若要檢視所有服務都可使用的全域條件索引鍵，請參閱可用的全域條件索引鍵。

條件索引鍵	描述	類型
aws:ResourceTag/${TagKey}	根據連接到資源的標籤鍵值組來篩選動作。資源標籤內容索引鍵僅適用於叢集資源，而不適用於主題、群組和交易 ID	字串