

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Argomento Operazioni
<a name="msk-topic-operations-information"></a>

Puoi usare Amazon MSK APIs per gestire argomenti nel tuo cluster MSK Provisioned senza la necessità di configurare e gestire i client di amministrazione Kafka. Con questi APIs, puoi definire o leggere le proprietà degli argomenti come il fattore di replica e il numero di partizioni, oltre a impostazioni di configurazione come le politiche di conservazione e pulizia. Puoi gestire in modo programmatico gli argomenti di Kafka utilizzando le tue interfacce familiari, tra cui AWS CLI e. AWS SDKs AWS CloudFormation Questi APIs sono inoltre integrati nella console Amazon MSK, riunendo tutte le operazioni tematiche in un unico posto. Ora puoi creare o aggiornare argomenti con pochi clic utilizzando impostazioni predefinite guidate, ottenendo al contempo una visibilità completa sulle configurazioni degli argomenti, sulle informazioni a livello di partizione e sulle metriche.

**Importante**  
Le risposte API di questi argomenti riflettono i dati che si aggiornano all'incirca ogni minuto. Per conoscere lo stato più recente dell'argomento dopo aver apportato le modifiche, attendi circa un minuto prima di eseguire l'interrogazione.

## Requisiti per l'utilizzo dell'argomento APIs
<a name="topic-operations-requirements"></a>
+ Il cluster deve essere un cluster MSK Provisioned. Questi non APIs sono disponibili per i cluster MSK Serverless.
+ Il cluster deve eseguire Apache Kafka versione 3.6.0 o successiva. Per ulteriori informazioni sulle versioni supportate, consulta. [Versioni di Apache Kafka supportate](supported-kafka-versions.md)
+ Il cluster deve trovarsi nello `ACTIVE` stato. Per ulteriori informazioni sugli stati del cluster, consulta [Comprendi gli stati del cluster MSK Provisioned](msk-cluster-states.md).
+ È necessario disporre delle autorizzazioni IAM appropriate. Per ulteriori informazioni, consulta [Autorizzazioni IAM per le operazioni tematiche APIs](#topic-operations-permissions).

## Autorizzazioni IAM per le operazioni tematiche APIs
<a name="topic-operations-permissions"></a>

Per chiamarle APIs, devi disporre delle autorizzazioni IAM appropriate. La tabella seguente elenca le autorizzazioni richieste per ogni API.


**Autorizzazioni richieste per le operazioni sugli argomenti APIs**  

| "Hello, World\$1" | Autorizzazioni richieste | Risorsa | 
| --- | --- | --- | 
| ListTopics |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic`  | ARN del cluster, Argomento ARN | 
| DescribeTopic |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:DescribeTopicDynamicConfiguration`  | ARN del cluster, Argomento ARN | 
| DescribeTopicPartitions |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:DescribeTopicDynamicConfiguration`  | ARN del cluster, Argomento ARN | 
| CreateTopic |  `kafka-cluster:Connect` `kafka-cluster:CreateTopic`  | ARN del cluster, Argomento ARN | 
| DeleteTopic |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:DeleteTopic`  | ARN del cluster, Argomento ARN | 
| UpdateTopic |  `kafka-cluster:Connect` `kafka-cluster:DescribeTopic` `kafka-cluster:AlterTopic` `kafka-cluster:AlterTopicDynamicConfiguration`  | ARN del cluster, Argomento ARN | 

**Nota**  
Per`kafka-cluster:Connect`, specifica l'ARN del cluster nella tua policy IAM. Per tutte le altre azioni, specifica l'argomento ARN nella tua policy IAM.

**Nota**  
Infatti`ListTopics`, puoi usare un carattere jolly (\$1) per abbinare tutti gli argomenti di un cluster. Ad esempio: `arn:aws:kafka:us-east-1:123456789012:topic/my-cluster/abcd1234-abcd-dcba-4321-a1b2abcd9f9f-2/*`.

Per ulteriori informazioni sul controllo degli accessi IAM per Amazon MSK, consulta[Controllo degli accessi IAM](iam-access-control.md).

**Topics**
+ [Requisiti per l'utilizzo dell'argomento APIs](#topic-operations-requirements)
+ [Autorizzazioni IAM per le operazioni tematiche APIs](#topic-operations-permissions)
+ [Elenca gli argomenti in un cluster Amazon MSK](msk-list-topics.md)
+ [Ottieni informazioni dettagliate su un argomento](msk-describe-topic.md)
+ [Visualizzare le informazioni sulla partizione per un argomento](msk-describe-topic-partitions.md)
+ [Crea argomenti in un cluster Amazon MSK](msk-create-topic.md)
+ [Aggiornare un argomento in un cluster Amazon MSK](msk-update-topic.md)
+ [Eliminare un argomento in un cluster Amazon MSK](msk-delete-topic.md)