As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Operações do tópico
Você pode usar o Amazon MSK APIs para visualizar informações sobre tópicos em seu cluster provisionado pelo MSK. Eles APIs fornecem acesso somente para leitura aos metadados do tópico, incluindo contagens de partições, fatores de replicação, configurações e detalhes da partição. Essas informações são úteis para monitorar, solucionar problemas e entender a estrutura dos tópicos do Kafka.
Importante
As DescribeTopicPartitions APIs respostasListTopics,DescribeTopic, e refletem dados que são atualizados aproximadamente a cada minuto. Para obter o estado mais atual do tópico após fazer alterações, aguarde aproximadamente um minuto antes de consultar.
nota
Eles APIs fornecem acesso somente para leitura aos metadados do tópico. Para criar ou modificar tópicos, use as ferramentas do Apache Kafka ou o Kafka. AdminClient Para obter mais informações, consulte Etapa 4: criar um tópico no cluster do Amazon MSK.
Requisitos para visualizar as informações do tópico
-
Seu cluster deve ser um cluster provisionado pelo MSK. Eles não APIs estão disponíveis para clusters MSK Serverless.
-
Seu cluster deve estar executando o Apache Kafka versão 3.6.0 ou posterior. Para obter mais informações sobre as versões compatíveis, consulteVersões compatíveis do Apache Kafka.
-
Seu cluster deve estar no
ACTIVEestado. Para obter mais informações sobre estados de cluster, consulte Entenda os estados do cluster do MSK Provisioned. -
Você deve ter as permissões apropriadas do IAM. Para obter mais informações, consulte Permissões do IAM para visualizar informações de tópicos.
Permissões do IAM para visualizar informações de tópicos
Para chamá-los APIs, você deve ter as permissões apropriadas do IAM. A tabela a seguir lista as permissões necessárias para cada API.
| solicitações de | Permissões obrigatórias | Recurso |
|---|---|---|
| ListTopics |
|
ARN do cluster |
| DescribeTopic |
|
Tópico ARN |
| DescribeTopicPartitions |
|
Tópico ARN |
nota
ParaListTopics, especifique o ARN do cluster na sua política do IAM. Para DescribeTopic eDescribeTopicPartitions, especifique o ARN do tópico em sua política do IAM.
Para obter mais informações sobre o controle de acesso do IAM para o Amazon MSK, consulteControle de acesso do IAM.
Tópicos
