Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Tema: Operaciones
Puede usar Amazon MSK APIs para administrar los temas de su clúster aprovisionado de MSK sin necesidad de configurar y mantener los clientes de administración de Kafka. Con ellos APIs, puede definir o leer las propiedades de los temas, como el factor de replicación y el recuento de particiones, junto con los ajustes de configuración, como las políticas de retención y limpieza. Puede administrar los temas de Kafka mediante programación mediante sus interfaces conocidas, incluidas AWS CLI, y AWS SDKs. AWS CloudFormation También APIs están integradas en la consola de Amazon MSK, lo que permite agrupar todas las operaciones relacionadas con los temas en un solo lugar. Ahora puede crear o actualizar temas con solo unos pocos clics utilizando los valores predeterminados guiados y, al mismo tiempo, obtener una visibilidad completa de las configuraciones de los temas, la información a nivel de partición y las métricas.
importante
Las respuestas de la API de estos temas reflejan datos que se actualizan aproximadamente cada minuto. Para ver el estado más actual del tema después de realizar cambios, espere aproximadamente un minuto antes de realizar la consulta.
Requisitos para usar el tema APIs
-
El clúster debe ser un clúster aprovisionado por MSK. No APIs están disponibles para los clústeres sin servidor de MSK.
-
El clúster debe ejecutar la versión 3.6.0 o posterior de Apache Kafka. Para obtener más información sobre las versiones compatibles, consulte. Versiones compatibles de Apache Kafka
-
El clúster debe estar en ese
ACTIVEestado. Para obtener más información acerca de los estados del clúster, consulte Descripción de los estados de los clústeres de MSK aprovisionados. -
Debe tener los permisos de IAM adecuados. Para obtener más información, consulte Permisos de IAM para las operaciones de los temas APIs.
Permisos de IAM para las operaciones de los temas APIs
Para llamarlas APIs, debe tener los permisos de IAM adecuados. En la siguiente tabla se enumeran los permisos necesarios para cada API.
| API | Permisos necesarios | Recurso |
|---|---|---|
| ListTopics |
|
Clúster: ARN, tema: ARN |
| DescribeTopic |
|
Clúster: ARN, tema: ARN |
| DescribeTopicPartitions |
|
Clúster: ARN, tema: ARN |
| CreateTopic |
|
Clúster: ARN, tema: ARN |
| DeleteTopic |
|
Clúster: ARN, tema: ARN |
| UpdateTopic |
|
Clúster: ARN, tema: ARN |
nota
Parakafka-cluster:Connect, especifique el ARN del clúster en su política de IAM. Para todas las demás acciones, especifique el ARN del tema en su política de IAM.
nota
Para elloListTopics, puede utilizar un comodín (*) para hacer coincidir todos los temas de un clúster. Por ejemplo: arn:aws:kafka:us-east-1:123456789012:topic/my-cluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/*.
Para obtener más información sobre el control de acceso de IAM para Amazon MSK, consulte. Control de acceso de IAM