Acciones, recursos y claves de condición para las API de Apache Kafka para clústeres de Amazon MSK

Las API de Apache Kafka para clústeres de Amazon MSK (prefijo de servicio: kafka-cluster) brindan los siguientes recursos, acciones y claves de contexto de condición específicos del servicio para su uso en las políticas de permisos de IAM.

Referencias:

• Obtenga información para configurar este servicio.

• Vea una lista de las operaciones de API disponibles para este servicio.

• Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos de IAM.

Acciones definidas por las API de Apache Kafka para clústeres de Amazon MSK

Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.

La columna Tipos de recurso de la tabla de Acción indica si cada acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") a los que aplica la política en el elemento Resource de la instrucción de su política. Si la columna incluye un tipo de recurso, puede especificar un ARN de ese tipo en una instrucción con dicha acción. Si la acción tiene uno o más recursos necesarios, la persona que llama debe tener permiso para usar la acción con esos recursos. Los recursos necesarios se indican en la tabla con un asterisco (*). Si limita el acceso a los recursos con el elemento Resource de una política de IAM, debe incluir un ARN o patrón para cada tipo de recurso requerido. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno de los tipos de recursos opcionales.

La columna Claves de condición de la tabla Acciones incluye claves que puede especificar en el elemento Condition de la instrucción de una política. Para obtener más información sobre las claves de condición asociadas a los recursos del servicio, consulte la columna Claves de condición de la tabla Tipos de recursos.

nota

Las claves de condición de recursos se enumeran en la tabla Tipos de recursos. Encontrará un enlace al tipo de recurso que se aplica a una acción en la columna Tipos de recursos (*obligatorio) de la tabla Acciones. El tipo de recurso de la tabla Tipos de recursos incluye la columna Claves de condición, que son las claves de condición del recurso que se aplican a una acción de la tabla Acciones.

Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Acciones.

Acciones	Descripción	Nivel de acceso	Tipos de recursos (*necesarios)	Claves de condición	Acciones dependientes
AlterCluster	Otorga permiso para alterar varios aspectos del clúster, equivalente a la ACL ALTER CLUSTER de Apache Kafka	Write	cluster*		kafka-cluster:Connect kafka-cluster:DescribeCluster
AlterClusterDynamicConfiguration	Otorga permiso para modificar la configuración dinámica de un clúster, equivalente a la ACL de CLÚSTER ALTER_CONFIGS de Apache Kafka	Write	cluster*		kafka-cluster:Connect kafka-cluster:DescribeClusterDynamicConfiguration
AlterGroup	Otorga permiso para unirse a grupos en un clúster, equivalente a la ACL READ GROUP de Apache Kafka	Write	group*		kafka-cluster:Connect kafka-cluster:DescribeGroup
AlterTopic	Otorga permiso para modificar temas en un clúster, equivalente a la ACL ALTER TOPIC de Apache Kafka	Write	topic*		kafka-cluster:Connect kafka-cluster:DescribeTopic
AlterTopicDynamicConfiguration	Otorga permiso para modificar la configuración dinámica de temas en un clúster, equivalente a la ACL de TEMA ALTER_CONFIGS de Apache Kafka	Write	topic*		kafka-cluster:Connect kafka-cluster:DescribeTopicDynamicConfiguration
AlterTransactionalId	Otorga permiso para modificar los ID transaccionales en un clúster, equivalente a la ACL WRITE TRANSACTIONAL_ID de Apache Kafka	Write	transactional-id*		kafka-cluster:Connect kafka-cluster:DescribeTransactionalId kafka-cluster:WriteData
Connect	Otorga permiso para conectarse y autenticarse en el clúster	Write	cluster*
CreateTopic	Otorga permiso para crear temas en un clúster, equivalente a la ACL CREATE CLUSTER/TOPIC de Apache Kafka	Write	topic*		kafka-cluster:Connect
DeleteGroup	Otorga permiso para eliminar grupos de un clúster, equivalente a la ACL DELETE GROUP de Apache Kafka	Write	group*		kafka-cluster:Connect kafka-cluster:DescribeGroup
DeleteTopic	Otorga permiso para eliminar temas de un clúster, equivalente a la ACL DELETE TOPIC de Apache Kafka	Write	topic*		kafka-cluster:Connect kafka-cluster:DescribeTopic
DescribeCluster	Otorga permiso para describir varios aspectos del clúster, equivalente a la ACL DESCRIBE CLUSTER de Apache Kafka	List	cluster*		kafka-cluster:Connect
DescribeClusterDynamicConfiguration	Otorga permiso para describir la configuración dinámica de un clúster, equivalente a la ACL de CLÚSTER DESCRIBE_CONFIGS de Apache Kafka	List	cluster*		kafka-cluster:Connect
DescribeGroup	Otorga permiso para describir grupos en un clúster, equivalente a la ACL DESCRIBE GROUP de Apache Kafka	List	group*		kafka-cluster:Connect
DescribeTopic	Otorga permiso para describir temas en un clúster, equivalente a la ACL DESCRIBE TOPIC de Apache Kafka	List	topic*		kafka-cluster:Connect
DescribeTopicDynamicConfiguration	Otorga permiso para describir la configuración dinámica de temas en un clúster, equivalente a la ACL DESCRIBE_CONFIGS TOPIC de Apache Kafka	List	topic*		kafka-cluster:Connect
DescribeTransactionalId	Otorga permiso para describir los ID transaccionales en un clúster, equivalente a la ACL DESCRIBE TRANSACTIONAL_ID de Apache Kafka	List	transactional-id*		kafka-cluster:Connect
ReadData	Otorga permiso para leer datos de temas de un clúster, equivalente a la ACL READ TOPIC de Apache Kafka	Read	topic*		kafka-cluster:AlterGroup kafka-cluster:Connect kafka-cluster:DescribeTopic
WriteData	Otorga permiso para escribir datos en temas de un clúster, equivalente a la ACL WRITE TOPIC de Apache Kafka	Write	topic*		kafka-cluster:Connect kafka-cluster:DescribeTopic
WriteDataIdempotently	Otorga permiso para escribir datos idempotentemente en un clúster, equivalente a la ACL de CLÚSTER IDEMPOTENT_WRITE de Apache Kafka	Write	cluster*		kafka-cluster:Connect kafka-cluster:WriteData

Tipos de recursos definidos por las API de Apache Kafka para clústeres de Amazon MSK

Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento Resource de las instrucciones de política de permisos de IAM. Cada acción de la tabla Acciones identifica los tipos de recursos que se pueden especificar con dicha acción. Un tipo de recurso también puede definir qué claves de condición se pueden incluir en una política. Estas claves se muestran en la última columna de la tabla Tipos de recursos. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Tipos de recurso.

Tipos de recurso	ARN	Claves de condición
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}

Claves de condición de las API de Apache Kafka para clústeres de Amazon MSK

Las API de Apache Kafka para clústeres de Amazon MSK definen las siguientes claves de condición que pueden usarse en el elemento Condition de una política de IAM. Puede utilizar estas claves para ajustar más las condiciones en las que se aplica la instrucción de política. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Claves de condición.

Para ver las claves de condición globales que están disponibles para todos los servicios, consulte Claves de condición globales disponibles.

Claves de condición	Descripción	Tipo
aws:ResourceTag/${TagKey}	Filtra acciones en función de pares de clave-valor de etiqueta asociados al recurso. La clave de contexto de etiqueta de recurso solo se aplicará al recurso del clúster, no a temas, grupos e ID transaccionales.	Cadena