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.
Opérations du sujet
Vous pouvez utiliser Amazon MSK APIs pour consulter les informations relatives aux sujets de votre cluster MSK Provisioned. Ils APIs fournissent un accès en lecture seule aux métadonnées des rubriques, notamment le nombre de partitions, les facteurs de réplication, les configurations et les détails des partitions. Ces informations sont utiles pour surveiller, résoudre les problèmes et comprendre la structure de vos sujets Kafka.
Important
Les DescribeTopicPartitions APIs réponses ListTopicsDescribeTopic, et reflètent des données mises à jour toutes les minutes environ. Pour connaître l'état le plus récent du sujet après avoir apporté des modifications, attendez environ une minute avant de lancer la requête.
Note
Ils APIs fournissent un accès en lecture seule aux métadonnées des rubriques. Pour créer ou modifier des sujets, utilisez les outils Apache Kafka ou AdminClient Kafka. Pour de plus amples informations, veuillez consulter Étape 4 : créer une rubrique dans le cluster Amazon MSK.
Conditions requises pour consulter les informations du sujet
-
Votre cluster doit être un cluster provisionné par MSK. Ils ne APIs sont pas disponibles pour les clusters MSK Serverless.
-
Votre cluster doit exécuter Apache Kafka version 3.6.0 ou ultérieure. Pour plus d'informations sur les versions prises en charge, consultezVersions Apache Kafka prises en charge.
-
Votre cluster doit être dans
ACTIVEcet état. Pour de plus amples informations sur les états des clusters, consultez Comprendre les états des clusters provisionnés par MSK. -
Vous devez disposer des autorisations IAM appropriées. Pour de plus amples informations, veuillez consulter Autorisations IAM pour consulter les informations du sujet.
Autorisations IAM pour consulter les informations du sujet
Pour les appeler APIs, vous devez disposer des autorisations IAM appropriées. Le tableau suivant répertorie les autorisations requises pour chaque API.
| API | Autorisations nécessaires | Ressource |
|---|---|---|
| ListTopics |
|
ARN de cluster |
| DescribeTopic |
|
ARN de la rubrique |
| DescribeTopicPartitions |
|
ARN de la rubrique |
Note
PourListTopics, spécifiez l'ARN du cluster dans votre politique IAM. Pour DescribeTopic etDescribeTopicPartitions, spécifiez l'ARN du sujet dans votre politique IAM.
Pour plus d'informations sur le contrôle d'accès IAM pour Amazon MSK, consultez. Contrôle d'accès IAM
Rubriques
