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 gerenciar tópicos em seu cluster provisionado pelo MSK sem a necessidade de configurar e manter clientes administrativos do Kafka. Com eles APIs, você pode definir ou ler as propriedades do tópico, como fator de replicação e contagem de partições, junto com as definições de configuração, como políticas de retenção e limpeza. Você pode gerenciar programaticamente os tópicos do Kafka usando suas interfaces familiares, incluindo CLI AWS , e. AWS SDKs AWS CloudFormation Elas também APIs são integradas ao console do Amazon MSK, reunindo todas as operações temáticas em um só lugar. Agora você pode criar ou atualizar tópicos com apenas alguns cliques usando padrões guiados e, ao mesmo tempo, obter visibilidade abrangente das configurações de tópicos, informações em nível de partição e métricas.
Importante
Essas respostas da API de tópicos 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.
Requisitos para usar o tópico APIs
-
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 operações de tópicos APIs.
Permissões do IAM para operações de tópicos APIs
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, ARN do tópico |
| DescribeTopic |
|
ARN do cluster, ARN do tópico |
| DescribeTopicPartitions |
|
ARN do cluster, ARN do tópico |
| CreateTopic |
|
ARN do cluster, ARN do tópico |
| DeleteTopic |
|
ARN do cluster, ARN do tópico |
| UpdateTopic |
|
ARN do cluster, ARN do tópico |
nota
Parakafka-cluster:Connect, especifique o ARN do cluster na sua política do IAM. Para todas as outras ações, especifique o ARN do tópico em sua política do IAM.
nota
ParaListTopics, você pode usar um caractere curinga (*) para corresponder a todos os tópicos em um cluster. Por exemplo: arn:aws:kafka:us-east-1:123456789012:topic/my-cluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/*.
Para obter mais informações sobre o controle de acesso do IAM para o Amazon MSK, consulteControle de acesso do IAM.
Tópicos
