View a markdown version of this page

Actions, resources, and condition keys for Apache Kafka APIs for Amazon MSK clusters - Service Authorization Reference
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Actions, resources, and condition keys for Apache Kafka APIs for Amazon MSK clusters

Apache Kafka APIs for Amazon MSK clusters (service prefix: kafka-cluster) provides the following service-specific operations, resources, actions, and condition keys for use in IAM permission policies.

References:

Actions defined by Apache Kafka APIs for Amazon MSK clusters

You can specify the following actions in the Action element of an IAM policy statement. Use policies to grant permissions to perform an operation in Amazon. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions.

Actions Description Resource types (*required) Condition keys Access level

AlterCluster

Grants permission to alter various aspects of the cluster, equivalent to Apache Kafka's ALTER CLUSTER ACL

cluster*

aws:ResourceTag/${TagKey}

Write

AlterClusterDynamicConfiguration

Grants permission to alter the dynamic configuration of a cluster, equivalent to Apache Kafka's ALTER_CONFIGS CLUSTER ACL

cluster*

aws:ResourceTag/${TagKey}

Write

AlterGroup

Grants permission to join groups on a cluster, equivalent to Apache Kafka's READ GROUP ACL

group*

Write

AlterTopic

Grants permission to alter topics on a cluster, equivalent to Apache Kafka's ALTER TOPIC ACL

topic*

Write

AlterTopicDynamicConfiguration

Grants permission to alter the dynamic configuration of topics on a cluster, equivalent to Apache Kafka's ALTER_CONFIGS TOPIC ACL

topic*

Write

AlterTransactionalId

Grants permission to alter transactional IDs on a cluster, equivalent to Apache Kafka's WRITE TRANSACTIONAL_ID ACL

transactional-id*

Write

Connect

Grants permission to connect and authenticate to the cluster

cluster*

aws:ResourceTag/${TagKey}

Write

CreateTopic

Grants permission to create topics on a cluster, equivalent to Apache Kafka's CREATE CLUSTER/TOPIC ACL

topic*

Write

DeleteGroup

Grants permission to delete groups on a cluster, equivalent to Apache Kafka's DELETE GROUP ACL

group*

Write

DeleteTopic

Grants permission to delete topics on a cluster, equivalent to Apache Kafka's DELETE TOPIC ACL

topic*

Write

DescribeCluster

Grants permission to describe various aspects of the cluster, equivalent to Apache Kafka's DESCRIBE CLUSTER ACL

cluster*

aws:ResourceTag/${TagKey}

List

DescribeClusterDynamicConfiguration

Grants permission to describe the dynamic configuration of a cluster, equivalent to Apache Kafka's DESCRIBE_CONFIGS CLUSTER ACL

cluster*

aws:ResourceTag/${TagKey}

List

DescribeGroup

Grants permission to describe groups on a cluster, equivalent to Apache Kafka's DESCRIBE GROUP ACL

group*

List

DescribeTopic

Grants permission to describe topics on a cluster, equivalent to Apache Kafka's DESCRIBE TOPIC ACL

topic*

List

DescribeTopicDynamicConfiguration

Grants permission to describe the dynamic configuration of topics on a cluster, equivalent to Apache Kafka's DESCRIBE_CONFIGS TOPIC ACL

topic*

List

DescribeTransactionalId

Grants permission to describe transactional IDs on a cluster, equivalent to Apache Kafka's DESCRIBE TRANSACTIONAL_ID ACL

transactional-id*

List

ReadData

Grants permission to read data from topics on a cluster, equivalent to Apache Kafka's READ TOPIC ACL

topic*

Read

WriteData

Grants permission to write data to topics on a cluster, equivalent to Apache Kafka's WRITE TOPIC ACL

topic*

Write

WriteDataIdempotently

Grants permission to write data idempotently on a cluster, equivalent to Apache Kafka's IDEMPOTENT_WRITE CLUSTER ACL

cluster*

aws:ResourceTag/${TagKey}

Write

Resource types defined by Apache Kafka APIs for Amazon MSK clusters

The following resource types are defined by this service and can be used in the Resource element of IAM permission policy statements.

Resource types ARN Condition keys

cluster

arn:${Partition}:kafka:${Region}:${Account}:cluster/${ClusterName}/${ClusterUuid}

aws:ResourceTag/${TagKey}

group

arn:${Partition}:kafka:${Region}:${Account}:group/${ClusterName}/${ClusterUuid}/${GroupName}

topic

arn:${Partition}:kafka:${Region}:${Account}:topic/${ClusterName}/${ClusterUuid}/${TopicName}

transactional-id

arn:${Partition}:kafka:${Region}:${Account}:transactional-id/${ClusterName}/${ClusterUuid}/${TransactionalId}

Condition keys for Apache Kafka APIs for Amazon MSK clusters

Apache Kafka APIs for Amazon MSK clusters defines the following condition keys that can be used in the Condition element of an IAM policy.

Condition keys Description Type

aws:ResourceTag/${TagKey}

Filters actions based on tag key-value pairs attached to the resource. The resource tag context key will only apply to the cluster resource, not topics, groups and transactional IDs

String