适用于 Amazon MSK 集群的 Apache Kafka API 的操作、资源和条件键 - 服务授权参考
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

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

适用于 Amazon MSK 集群的 Apache Kafka API 的操作、资源和条件键

适用于 Amazon MSK 的 Apache Kafka API(服务前缀:kafka-cluster)提供以下服务特定的资源、操作和条件上下文键以在 IAM 权限策略中使用。

参考:

Apache Kafka API 为 Amazon MSK 集群定义的操作

您可以在 Action 策略语句的 IAM 元素中指定以下操作。可以使用策略授予在 AWS 中执行操作的权限。您在策略中使用一项操作时,通常使用相同的名称允许或拒绝对 API 操作或 CLI 命令的访问。但在某些情况下,单一动作可控制对多项操作的访问。还有某些操作需要多种不同的动作。

资源类型列指示每项操作是否支持资源级权限。如果该列没有任何值,您必须在策略语句的 Resource 元素中指定所有资源(“*”)。如果该列包含一种资源类型,则可以在含有该操作的语句中指定该类型的 ARN。必需资源在表中以星号 (*) 表示。如果在使用该操作的语句中指定资源级权限 ARN,则它必须属于该类型。某些操作支持多种资源类型。如果资源类型是可选的(未指示为必需),则可以选择使用一种类型而不使用其他类型。

有关下表中各列的详细信息,请参阅 操作表

操作 描述 访问级别 资源类型(* 为必需) 条件键 相关操作
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 List

cluster*

kafka-cluster:Connect

DescribeClusterDynamicConfiguration 授予描述集群动态配置的权限,相当于 Apache Kafka 的 DESCRIBE_CONFIGS CLUSTER ACL List

cluster*

kafka-cluster:Connect

DescribeGroup 授予描述集群上的群组的权限,相当于 Apache Kafka 的 DESCRIBE GROUP ACL List

group*

kafka-cluster:Connect

DescribeTopic 授予描述集群上的主题的权限,相当于 Apache Kafka 的 DESCRIBE TOPIC ACL List

topic*

kafka-cluster:Connect

DescribeTopicDynamicConfiguration 授予描述集群上的主题动态配置的权限,相当于 Apache Kafka 的 DESCRIBE_CONFIGS TOPIC ACL List

topic*

kafka-cluster:Connect

DescribeTransactionalId 授予描述集群上的事务 ID 的权限,相当于 Apache Kafka 的 DESCRIBE TRANSACTIONAL_ID ACL List

transactional-id*

kafka-cluster:Connect

ReadData 授予从集群上的主题中读取数据的权限,相当于 Apache Kafka 的 READ TOPIC ACL Read

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

Apache Kafka API 为 Amazon MSK 集群定义的资源类型

以下资源类型是由该服务定义的,可以在 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 字符串