Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Actions, ressources et clés de condition pour les clusters Apache Kafka APIs pour Amazon MSK
Apache Kafka APIs pour les clusters Amazon MSK (préfixe de service :kafka-cluster) fournit les ressources, actions et clés de contexte de condition spécifiques aux services suivantes à utiliser dans les politiques d'autorisation IAM.
Références :
-
Découvrez comment configurer ce service.
-
Affichez la liste des opérations d'API disponibles pour ce service.
-
Découvrez comment protéger ce service et ses ressources avec les stratégies d'autorisation IAM.
Rubriques
Actions définies par Apache Kafka APIs pour les clusters Amazon MSK
Vous pouvez indiquer les actions suivantes dans l'élément Action d'une déclaration de politique IAM. Utilisez des politiques pour accorder des autorisations permettant d'effectuer une opération dans AWS. Lorsque vous utilisez une action dans une politique, vous autorisez ou refusez généralement l'accès à l'opération d'API ou à la commande CLI portant le même nom. Toutefois, dans certains cas, une seule action contrôle l'accès à plusieurs opérations. D'autres opérations, quant à elles, requièrent plusieurs actions différentes.
La colonne Types de ressources indique si chaque action prend en charge les autorisations au niveau des ressources. S'il n'y a pas de valeur pour cette colonne, vous devez indiquer toutes les ressources (« * ») dans l'élément Resource de votre déclaration de politique. Si la colonne inclut un type de ressource, vous pouvez indiquer un ARN de ce type dans une déclaration avec cette action. Si l'action comporte une ou plusieurs ressources requises, l'appelant doit être autorisé à utiliser l'action avec ces ressources. Les ressources requises sont indiquées dans le tableau par un astérisque (*). Si vous limitez l'accès aux ressources avec l'Resourceélément dans une politique IAM, vous devez inclure un ARN ou un modèle pour chaque type de ressource requis. Certaines actions prennent en charge plusieurs types de ressources. Si le type de ressource est facultatif (non indiqué comme obligatoire), vous pouvez choisir d'utiliser l'un, mais pas l'autre.
La colonne Clés de condition inclut des clés que vous pouvez spécifier dans l'élément Condition d'une déclaration de politique. Pour plus d'informations sur les clés de condition associées aux ressources du service, consultez la colonne Clés de condition du tableau des types de ressources.
Note
Les clés de condition des ressources sont répertoriées dans le tableau Types de ressources. Vous pouvez trouver un lien vers le type de ressource qui s'applique à une action dans la colonne Types de ressources (* obligatoire) du tableau Actions. Le type de ressource indiqué dans le tableau Types de ressources inclut la colonne Clés de condition, qui contient les clés de condition de ressource qui s'appliquent à une action dans le tableau Actions.
Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Actions.
| Actions | Description | Niveau d'accès | Types de ressources (*obligatoire) | Clés de condition | Actions dépendantes |
|---|---|---|---|---|---|
| AlterCluster | Autorise la modification de divers aspects du cluster, équivalent à l'ACL ALTER CLUSTER d'Apache Kafka. | Écriture |
kafka-cluster:Connect kafka-cluster:DescribeCluster |
||
| AlterClusterDynamicConfiguration | Autorise la modification de la configuration dynamique d'un cluster, équivalente à l'ACL ALTER_CONFIGS CLUSTER d'Apache Kafka. | Écriture |
kafka-cluster:Connect kafka-cluster:DescribeClusterDynamicConfiguration |
||
| AlterGroup | Autorise la participation à des groupes sur un cluster, équivalent à l'ACL READ GROUP d'Apache Kafka. | Écriture |
kafka-cluster:Connect kafka-cluster:DescribeGroup |
||
| AlterTopic | Autorise la modification de rubriques dans un cluster, équivalent à l'ACL ALTER TOPIC d'Apache Kafka. | Écriture |
kafka-cluster:Connect kafka-cluster:DescribeTopic |
||
| AlterTopicDynamicConfiguration | Autorise la modification de la configuration dynamique des rubriques dans un cluster, équivalent à l'ACL ALTER_CONFIGS TOPIC d'Apache Kafka. | Écrire |
kafka-cluster:Connect kafka-cluster:DescribeTopicDynamicConfiguration |
||
| AlterTransactionalId | Accorde l'autorisation de modifier les transactions IDs sur un cluster, ce qui est équivalent à l'ACL WRITE TRANSACTIONAL_ID d'Apache Kafka | Écrire |
kafka-cluster:Connect kafka-cluster:DescribeTransactionalId kafka-cluster:WriteData |
||
| Connect | Autorise la connexion et l'authentification dans un cluster. | Écriture | |||
| CreateTopic | Autorise la création de rubriques dans un cluster, équivalent à l'ACL CREATE CLUSTER/TOPIC d'Apache Kafka. | Écriture |
kafka-cluster:Connect |
||
| DeleteGroup | Autorise la suppression des groupes d'un cluster, équivalent à l'ACL DELETE GROUP d'Apache Kafka. | Écriture |
kafka-cluster:Connect kafka-cluster:DescribeGroup |
||
| DeleteTopic | Autorise la suppression des rubriques dans un cluster, équivalent à l'ACL DELETE TOPIC d'Apache Kafka. | Écriture |
kafka-cluster:Connect kafka-cluster:DescribeTopic |
||
| DescribeCluster | Autorise la description de divers aspects du cluster, équivalent à l'ACL DESCRIBE CLUSTER d'Apache Kafka. | Liste |
kafka-cluster:Connect |
||
| DescribeClusterDynamicConfiguration | Autorise la description de la configuration dynamique d'un cluster, équivalent à l'ACL DESCRIBE_CONFIGS CLUSTER d'Apache Kafka. | Liste |
kafka-cluster:Connect |
||
| DescribeGroup | Autorise la description des groupes sur un cluster, équivalent à l'ACL DESCRIBE GROUP d'Apache Kafka. | Liste |
kafka-cluster:Connect |
||
| DescribeTopic | Autorise la description des rubriques dans un cluster, équivalent à l'ACL DESCRIBE TOPIC d'Apache Kafka. | Liste |
kafka-cluster:Connect |
||
| DescribeTopicDynamicConfiguration | Autorise la description de la configuration dynamique des rubriques dans un cluster, équivalent à l'ACL DESCRIBE_CONFIGS TOPIC d'Apache Kafka. | Liste |
kafka-cluster:Connect |
||
| DescribeTransactionalId | Accorde l'autorisation de décrire les transactions IDs sur un cluster, ce qui est équivalent à l'ACL DESCRIBE TRANSACTIONAL_ID d'Apache Kafka | Liste |
kafka-cluster:Connect |
||
| ReadData | Autorise la lecture des données provenant de rubriques dans un cluster, équivalent à l'ACL READ TOPIC d'Apache Kafka. | Lecture |
kafka-cluster:AlterGroup kafka-cluster:Connect kafka-cluster:DescribeTopic |
||
| WriteData | Autorise l'écriture des données dans les rubriques d'un cluster, équivalent à l'ACL WRITE TOPIC d'Apache Kafka. | Écriture |
kafka-cluster:Connect kafka-cluster:DescribeTopic |
||
| WriteDataIdempotently | Autorise l'écriture des données de manière idempotente dans un cluster, équivalent à l'ACL IDEMPOTENT_WRITE CLUSTER d'Apache Kafka. | Écrire |
kafka-cluster:Connect kafka-cluster:WriteData |
Types de ressources définis par Apache Kafka APIs pour les clusters Amazon MSK
Ce service définit les types de ressources suivants, qui peuvent être utilisés dans l' Resource élément des déclarations de politique d'autorisation IAM. Chaque action du tableau Actions identifie les types de ressources pouvant être spécifiés avec cette action. Un type de ressource peut également définir les clés de condition que vous pouvez inclure dans une politique. Ces clés sont affichées dans la dernière colonne du tableau. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Types de ressources.
| Types de ressources | ARN | Clés de condition |
|---|---|---|
| cluster |
arn:${Partition}:kafka:${Region}:${Account}:cluster/${ClusterName}/${ClusterUuid}
|
|
| 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}
|
Clés de condition pour les clusters Apache Kafka APIs pour Amazon MSK
Apache Kafka APIs pour les clusters Amazon MSK définit les clés de condition suivantes qui peuvent être utilisées dans l'Conditionélément d'une politique IAM. Vous pouvez utiliser ces clés pour affiner les conditions d’application de la déclaration de politique. Pour plus de détails sur les colonnes du tableau suivant, veuillez consulter le tableau Clés de condition.
Pour afficher les clés de condition globales disponibles pour tous les services, consultez Clés de condition globales disponibles.
| Clés de condition | Description | Type |
|---|---|---|
| aws:ResourceTag/${TagKey} | Filtre les actions en fonction des paires clé-valeur de balise attachées à la ressource. La clé de contexte de la balise de ressource ne s'appliquera qu'à la ressource du cluster, et non aux sujets, aux groupes et aux transactions IDs | Chaîne |
