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
<a name="msk-topic-operations-information"></a>

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
<a name="topic-operations-requirements"></a>
+ 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, consulte[Versões compatíveis do Apache Kafka](supported-kafka-versions.md).
+ Seu cluster deve estar no `ACTIVE` estado. Para obter mais informações sobre estados de cluster, consulte [Entenda os estados do cluster do MSK Provisioned](msk-cluster-states.md).
+ 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](#topic-operations-permissions).

## Permissões do IAM para operações de tópicos APIs
<a name="topic-operations-permissions"></a>

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.


**Permissões necessárias para operações de tópicos APIs**  

| solicitações de | Permissões obrigatórias | Recurso | 
| --- | --- | --- | 
| ListTopics | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic` | ARN do cluster, ARN do tópico | 
| DescribeTopic | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic`<br />`kafka-cluster:DescribeTopicDynamicConfiguration` | ARN do cluster, ARN do tópico | 
| DescribeTopicPartitions | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic`<br />`kafka-cluster:DescribeTopicDynamicConfiguration` | ARN do cluster, ARN do tópico | 
| CreateTopic | `kafka-cluster:Connect`<br />`kafka-cluster:CreateTopic` | ARN do cluster, ARN do tópico | 
| DeleteTopic | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic`<br />`kafka-cluster:DeleteTopic` | ARN do cluster, ARN do tópico | 
| UpdateTopic | `kafka-cluster:Connect`<br />`kafka-cluster:DescribeTopic`<br />`kafka-cluster:AlterTopic`<br />`kafka-cluster:AlterTopicDynamicConfiguration` | ARN do cluster, ARN do tópico | 

**nota**  
Para`kafka-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**  
Para`ListTopics`, 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, consulte[Controle de acesso do IAM](iam-access-control.md).

**Topics**
+ [Requisitos para usar o tópico APIs](#topic-operations-requirements)
+ [Permissões do IAM para operações de tópicos APIs](#topic-operations-permissions)
+ [Listar tópicos em um cluster Amazon MSK](msk-list-topics.md)
+ [Obtenha informações detalhadas sobre um tópico](msk-describe-topic.md)
+ [Exibir informações de partição de um tópico](msk-describe-topic-partitions.md)
+ [Crie tópicos em um cluster Amazon MSK](msk-create-topic.md)
+ [Atualizar um tópico em um cluster do Amazon MSK](msk-update-topic.md)
+ [Excluir um tópico em um cluster do Amazon MSK](msk-delete-topic.md)