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 gérer les sujets de votre cluster MSK Provisioned sans avoir à configurer et à gérer les clients d'administration Kafka. Vous pouvez ainsi définir ou lire les APIs propriétés des rubriques telles que le facteur de réplication et le nombre de partitions, ainsi que les paramètres de configuration tels que les politiques de conservation et de nettoyage. Vous pouvez gérer les sujets Kafka par programmation à l'aide de vos interfaces habituelles, notamment AWS CLI et AWS SDKs. AWS CloudFormation Ils APIs sont également intégrés à la console Amazon MSK, regroupant ainsi toutes les opérations liées aux sujets en un seul endroit. Vous pouvez désormais créer ou mettre à jour des rubriques en quelques clics à l'aide de paramètres guidés par défaut, tout en bénéficiant d'une visibilité complète sur les configurations des rubriques, les informations au niveau des partitions et les métriques.
Important
Les réponses de l'API de cette rubrique 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.
Conditions requises pour utiliser le sujet APIs
-
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 les opérations sur les sujets APIs.
Autorisations IAM pour les opérations sur les sujets APIs
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 du cluster, ARN du sujet |
| DescribeTopic |
|
ARN du cluster, ARN du sujet |
| DescribeTopicPartitions |
|
ARN du cluster, ARN du sujet |
| CreateTopic |
|
ARN du cluster, ARN du sujet |
| DeleteTopic |
|
ARN du cluster, ARN du sujet |
| UpdateTopic |
|
ARN du cluster, ARN du sujet |
Note
Pourkafka-cluster:Connect, spécifiez l'ARN du cluster dans votre politique IAM. Pour toutes les autres actions, spécifiez l'ARN du sujet dans votre politique IAM.
Note
En ListTopics effet, vous pouvez utiliser un caractère générique (*) pour faire correspondre tous les sujets d'un cluster. Par exemple : arn:aws:kafka:us-east-1:123456789012:topic/my-cluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/*.
Pour plus d'informations sur le contrôle d'accès IAM pour Amazon MSK, consultez. Contrôle d'accès IAM
Rubriques
