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à.
# Aggiornamento della configurazione di un cluster Amazon MSK
Per aggiornare la configurazione di un cluster, assicurati che lo stato del cluster sia `ACTIVE`. Inoltre, devi assicurarti che il numero di partizioni per broker sul cluster MSK sia inferiore ai limiti descritti nella sezione [Dimensioni corrette del cluster: numero di partizioni per broker Standard](bestpractices.md#partitions-per-broker). Non è possibile aggiornare la configurazione di un cluster che supera questi limiti.
Per informazioni sulla configurazione MSK, incluso come creare una configurazione personalizzata, quali proprietà è possibile aggiornare e cosa accade quando si aggiorna la configurazione di un cluster esistente, consulta [Configurazione Amazon MSK Provisioned](msk-configuration.md).
**Topics**
+ [Disponibilità del broker durante gli aggiornamenti della configurazione](#update-config-cluster-availability)
+ [Aggiornamento della configurazione di un cluster utilizzando il AWS CLI](#update-config-cli)
+ [Aggiorna la configurazione di un cluster Amazon MSK utilizzando l'API](#update-config-api)
## Disponibilità del broker durante gli aggiornamenti della configurazione
Amazon MSK mantiene un'elevata disponibilità durante la maggior parte degli aggiornamenti della configurazione del cluster. Amazon MSK esegue un aggiornamento progressivo in cui aggiorna un broker alla volta. Durante questo processo, il cluster rimane disponibile, anche se i singoli broker verranno riavviati man mano che le relative configurazioni vengono aggiornate. Tuttavia, alcune modifiche alla configurazione potrebbero richiedere l'aggiornamento simultaneo di tutti i broker, il che può causare una breve interruzione a livello di cluster. Per ulteriori informazioni sull'impatto della disponibilità dei broker durante gli aggiornamenti, consulta. [Configurazione Amazon MSK Provisioned](msk-configuration.md)
Prima di aggiornare i cluster di produzione, ti consigliamo di testare le modifiche alla configurazione in un ambiente non di produzione e di pianificare gli aggiornamenti durante le finestre di manutenzione.
In caso di problemi durante l'aggiornamento del cluster MSK, vedi [Come posso risolvere i problemi quando aggiorno il mio](https://repost.aws/knowledge-center/msk-upgrade-cluster-issues) cluster Amazon MSK?
## Aggiornamento della configurazione di un cluster utilizzando il AWS CLI
1. Copiare il JSON seguente e salvarlo in un file. Assegnare un nome al file `configuration-info.json`. Sostituisci *ConfigurationArn* con l'Amazon Resource Name (ARN) della configurazione che desideri utilizzare per aggiornare il cluster. La stringa ARN deve essere racchiusa tra virgolette nel seguente JSON.
Sostituisci *Configuration-Revision* con la revisione della configurazione che desideri utilizzare. Le revisioni di configurazione sono interi (numeri interi) che iniziano da `1`. Questo intero non deve essere racchiuso tra virgolette nel seguente JSON.
```
{
"Arn": ConfigurationArn,
"Revision": Configuration-Revision
}
```
1. Esegui il comando seguente, sostituendolo *ClusterArn* con l'ARN ottenuto quando hai creato il cluster. Se non disponi dell'ARN per il cluster, puoi trovarlo elencando tutti i cluster. Per ulteriori informazioni, consulta [Elenca i cluster Amazon MSK](msk-list-clusters.md).
Sostituiscilo *Path-to-Config-Info-File* con il percorso del file di informazioni di configurazione. Se hai dato un nome al file creato nel passaggio precedente `configuration-info.json` e lo hai salvato nella directory corrente, allora *Path-to-Config-Info-File* è`configuration-info.json`.
Sostituiscilo *Current-Cluster-Version* con la versione corrente del cluster.
**Importante**
Le versioni del cluster non sono interi semplici. Per trovare la versione corrente del cluster, usa l'[DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster)operazione o il comando [AWS CLI describe-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html). Una versione di esempio è `KTVPDKIKX0DER`.
```
aws kafka update-cluster-configuration --cluster-arn ClusterArn --configuration-info file://Path-to-Config-Info-File --current-version Current-Cluster-Version
```
Di seguito è riportato un esempio di come utilizzare questo comando:
```
aws kafka update-cluster-configuration --cluster-arn "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1" --configuration-info file://c:\users\tester\msk\configuration-info.json --current-version "K1X5R6FKA87"
```
L'output di questo comando `update-cluster-configuration` è simile all'esempio JSON seguente.
```
{
"ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
"ClusterOperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef"
}
```
1. Per ottenere il risultato dell'`update-cluster-configuration`operazione, esegui il comando seguente, sostituendolo *ClusterOperationArn* con l'ARN ottenuto nell'output del `update-cluster-configuration` comando.
```
aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn
```
L'output di questo comando `describe-cluster-operation` è simile all'esempio JSON seguente.
```
{
"ClusterOperationInfo": {
"ClientRequestId": "982168a3-939f-11e9-8a62-538df00285db",
"ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
"CreationTime": "2019-06-20T21:08:57.735Z",
"OperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef",
"OperationState": "UPDATE_COMPLETE",
"OperationType": "UPDATE_CLUSTER_CONFIGURATION",
"SourceClusterInfo": {},
"TargetClusterInfo": {
"ConfigurationInfo": {
"Arn": "arn:aws:kafka:us-east-1:123456789012:configuration/ExampleConfigurationName/abcdabcd-abcd-1234-abcd-abcd123e8e8e-1",
"Revision": 1
}
}
}
}
```
In questo output, `OperationType` è `UPDATE_CLUSTER_CONFIGURATION`. Se il valore di `OperationState` è `UPDATE_IN_PROGRESS`, attendi qualche minuto, quindi esegui nuovamente il comando `describe-cluster-operation`.
## Aggiorna la configurazione di un cluster Amazon MSK utilizzando l'API
Per utilizzare l'API per aggiornare la configurazione di un cluster Amazon MSK, consulta [UpdateClusterConfiguration](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-configuration.html#UpdateClusterConfiguration).