

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

# 适用于 Amazon MSK 集群的 Apache Kafka API 的操作、资源和条件键
<a name="list_kafka-cluster"></a>

适用于亚马逊 MSK 集群的 Apache Kafka API（服务前缀： `kafka-cluster`) 提供以下特定服务的操作、资源、操作和条件密钥，用于 IAM 权限策略。

参考：
+ 了解如何[配置该服务](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html)。
+ 查看[适用于该服务的 API 操作列表](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html)。
+ 了解如何[使用 IAM](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html) 权限策略保护该服务及其资源。
+ 查看 [编程服务授权参考](https://servicereference.us-east-1.amazonaws.com/v1/kafka-cluster/kafka-cluster.json) 用于此服务。

**Topics**
+ [Apache Kafka API 为 Amazon MSK 集群定义的操作](#list_kafka-cluster-actions-as-permissions)
+ [Apache Kafka API 为 Amazon MSK 集群定义的资源类型](#list_kafka-cluster-resources-for-iam-policies)
+ [适用于 Amazon MSK 集群的 Apache Kafka API 的条件键](#list_kafka-cluster-policy-keys)

## Apache Kafka API 为 Amazon MSK 集群定义的操作
<a name="list_kafka-cluster-actions-as-permissions"></a>

您可以在 IAM 策略语句的 `Action` 元素中指定以下操作。对于每个操作，该表列出了该操作支持的资源类型和条件键。可以使用策略授予在 Amazon中执行操作的权限。您在策略中使用一项操作时，通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下，单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。




- **   [AlterCluster](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予更改集群各个方面的权限，相当于 Apache Kafka 的 ALTER CLUSTER ACL
  - **资源类型（\* 为必需）:** [cluster\*](#list_kafka-cluster-resource-cluster)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_kafka-cluster-aws_ResourceTag___TagKey_)
  - **访问级别:** Write

- **   [AlterClusterDynamicConfiguration](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予更改集群动态配置的权限，相当于 Apache Kafka 的 ALTER\_CONFIGS CLUSTER ACL
  - **资源类型（\* 为必需）:** [cluster\*](#list_kafka-cluster-resource-cluster)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_kafka-cluster-aws_ResourceTag___TagKey_)
  - **访问级别:** Write

- **   [AlterGroup](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予加入集群上群组的权限，相当于 Apache Kafka 的 READ GROUP ACL
  - **资源类型（\* 为必需）:** [group\*](#list_kafka-cluster-resource-group)
  - **条件键:**  
  - **访问级别:** Write

- **   [AlterTopic](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予更改集群上主题的权限，相当于 Apache Kafka 的 ALTER TOPIC ACL
  - **资源类型（\* 为必需）:** [topic\*](#list_kafka-cluster-resource-topic)
  - **条件键:**  
  - **访问级别:** Write

- **   [AlterTopicDynamicConfiguration](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予更改集群上主题的动态配置的权限，相当于 Apache Kafka 的 ALTER\_CONFIGS TOPIC ACL
  - **资源类型（\* 为必需）:** [topic\*](#list_kafka-cluster-resource-topic)
  - **条件键:**  
  - **访问级别:** Write

- **   [AlterTransactionalId](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予更改集群上事务 ID 的权限，相当于 Apache Kafka 的 WRITE TRANSACTIONAL\_ID ACL
  - **资源类型（\* 为必需）:** [transactional-id\*](#list_kafka-cluster-resource-transactional-id)
  - **条件键:**  
  - **访问级别:** Write

- **   [Connect](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予连接和验证集群的权限
  - **资源类型（\* 为必需）:** [cluster\*](#list_kafka-cluster-resource-cluster)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_kafka-cluster-aws_ResourceTag___TagKey_)
  - **访问级别:** 写入

- **   [CreateTopic](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予在集群上创建主题的权限，等同于 Apache Kafka 的 CREATE CLUSTER/TOPIC ACL
  - **资源类型（\* 为必需）:** [topic\*](#list_kafka-cluster-resource-topic)
  - **条件键:**  
  - **访问级别:** 写入

- **   [DeleteGroup](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予删除集群上的群组的权限，相当于 Apache Kafka 的 DELETE GROUP ACL
  - **资源类型（\* 为必需）:** [group\*](#list_kafka-cluster-resource-group)
  - **条件键:**  
  - **访问级别:** Write

- **   [DeleteTopic](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予删除集群上主题的权限，相当于 Apache Kafka 的 DELETE TOPIC ACL
  - **资源类型（\* 为必需）:** [topic\*](#list_kafka-cluster-resource-topic)
  - **条件键:**  
  - **访问级别:** Write

- **   [DescribeCluster](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予描述集群各个方面的权限，相当于 Apache Kafka 的 DESCRIBE CLUSTER ACL
  - **资源类型（\* 为必需）:** [cluster\*](#list_kafka-cluster-resource-cluster)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_kafka-cluster-aws_ResourceTag___TagKey_)
  - **访问级别:** List

- **   [DescribeClusterDynamicConfiguration](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予描述集群动态配置的权限，相当于 Apache Kafka 的 DESCRIBE\_CONFIGS CLUSTER ACL
  - **资源类型（\* 为必需）:** [cluster\*](#list_kafka-cluster-resource-cluster)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_kafka-cluster-aws_ResourceTag___TagKey_)
  - **访问级别:** List

- **   [DescribeGroup](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予描述集群上的群组的权限，相当于 Apache Kafka 的 DESCRIBE GROUP ACL
  - **资源类型（\* 为必需）:** [group\*](#list_kafka-cluster-resource-group)
  - **条件键:**  
  - **访问级别:** List

- **   [DescribeTopic](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予描述集群上的主题的权限，相当于 Apache Kafka 的 DESCRIBE TOPIC ACL
  - **资源类型（\* 为必需）:** [topic\*](#list_kafka-cluster-resource-topic)
  - **条件键:**  
  - **访问级别:** List

- **   [DescribeTopicDynamicConfiguration](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予描述集群上的主题动态配置的权限，相当于 Apache Kafka 的 DESCRIBE\_CONFIGS TOPIC ACL
  - **资源类型（\* 为必需）:** [topic\*](#list_kafka-cluster-resource-topic)
  - **条件键:**  
  - **访问级别:** List

- **   [DescribeTransactionalId](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予描述集群上的事务 ID 的权限，相当于 Apache Kafka 的 DESCRIBE TRANSACTIONAL\_ID ACL
  - **资源类型（\* 为必需）:** [transactional-id\*](#list_kafka-cluster-resource-transactional-id)
  - **条件键:**  
  - **访问级别:** List

- **   [ReadData](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予从集群上的主题中读取数据的权限，相当于 Apache Kafka 的 READ TOPIC ACL
  - **资源类型（\* 为必需）:** [topic\*](#list_kafka-cluster-resource-topic)
  - **条件键:**  
  - **访问级别:** Read

- **   [WriteData](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予向集群上的主题写入数据的权限，相当于 Apache Kafka 的 WRITE TOPIC ACL
  - **资源类型（\* 为必需）:** [topic\*](#list_kafka-cluster-resource-topic)
  - **条件键:**  
  - **访问级别:** Write

- **   [WriteDataIdempotently](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#actions)  **
  - **说明:** 授予在集群上以幂等方式写入数据的权限，相当于 Apache Kafka 的 IDEMPOTENT\_WRITE CLUSTER ACL
  - **资源类型（\* 为必需）:** [cluster\*](#list_kafka-cluster-resource-cluster)
  - **条件键:** [aws:ResourceTag/${TagKey}](#list_kafka-cluster-aws_ResourceTag___TagKey_)
  - **访问级别:** Write



## Apache Kafka API 为 Amazon MSK 集群定义的资源类型
<a name="list_kafka-cluster-resources-for-iam-policies"></a>

以下资源类型是由该服务定义的，可以在 IAM 权限策略语句的 `Resource` 元素中使用这些资源类型。



| 资源类型 | ARN | 条件键 | 
| --- | --- | --- | 
|  [cluster](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#msk-iam-resources)  | arn:${Partition}:kafka:${Region}:${Account}:cluster/${ClusterName}/${ClusterUuid} | [aws:ResourceTag/${TagKey}](#list_kafka-cluster-aws_ResourceTag___TagKey_) | 
|  [group](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#msk-iam-resources)  | arn:${Partition}:kafka:${Region}:${Account}:group/${ClusterName}/${ClusterUuid}/${GroupName} |   | 
|  [topic](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#msk-iam-resources)  | arn:${Partition}:kafka:${Region}:${Account}:topic/${ClusterName}/${ClusterUuid}/${TopicName} |   | 
|  [transactional-id](https://docs.amazonaws.cn/msk/latest/developerguide/iam-access-control.html#msk-iam-resources)  | arn:${Partition}:kafka:${Region}:${Account}:transactional-id/${ClusterName}/${ClusterUuid}/${TransactionalId} |   | 

## 适用于 Amazon MSK 集群的 Apache Kafka API 的条件键
<a name="list_kafka-cluster-policy-keys"></a>

适用于 Amazon MSK 集群的 Apache Kafka API 定义以下可以在 IAM policy 的 `Condition` 元素中使用的条件键。



| 条件键 | 描述 | 类型 | 
| --- | --- | --- | 
|   [aws:ResourceTag/${TagKey}](https://docs.amazonaws.cn/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-resourcetag)  | 根据附加到资源的标签键值对筛选操作。资源标签上下文键仅适用于集群资源，不适用于主题、组和事务 ID | String | 