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á.
# Atualizar a configuração de um cluster do Amazon MSK
Para atualizar a configuração de um cluster, certifique-se de que ele esteja no estado `ACTIVE`. Você também deve garantir que o número de partições por agente em seu cluster do MSK esteja abaixo dos limites descritos em [Dimensione seu cluster adequadamente: número de partições por agente Standard](bestpractices.md#partitions-per-broker). Você não pode atualizar a configuração de um cluster que exceda esses limites.
Para obter informações sobre a configuração do MSK, incluindo como criar uma configuração personalizada, quais propriedades você pode atualizar e o que acontece quando você atualiza a configuração de um cluster existente, consulte [Configurações do Amazon MSK Provisioned](msk-configuration.md).
**Topics**
+ [Disponibilidade do agente durante as atualizações de configuração](#update-config-cluster-availability)
+ [Atualizando a configuração de um cluster usando o AWS CLI](#update-config-cli)
+ [Atualizar a configuração de um cluster do Amazon MSK usando a API](#update-config-api)
## Disponibilidade do agente durante as atualizações de configuração
O Amazon MSK mantém alta disponibilidade durante a maioria das atualizações de configuração do cluster. O Amazon MSK realiza uma atualização contínua em que atualiza um agente por vez. Durante esse processo, o cluster permanece disponível, embora os agentes individuais sejam reiniciados à medida que suas configurações forem atualizadas. No entanto, algumas alterações na configuração podem exigir que todos os agentes sejam atualizados simultaneamente, o que pode causar uma breve interrupção em todo o cluster. Para saber mais sobre o impacto na disponibilidade do agente durante as atualizações, consulte [Configurações do Amazon MSK Provisioned](msk-configuration.md).
Antes de atualizar os clusters de produção, recomendamos que você teste as alterações de configuração em um ambiente que não seja de produção e agende atualizações durante as janelas de manutenção.
Se você enfrentar algum problema ao atualizar seu cluster do MSK, consulte [Como solucionar problemas ao atualizar meu cluster do Amazon MSK](https://repost.aws/knowledge-center/msk-upgrade-cluster-issues)?
## Atualizando a configuração de um cluster usando o AWS CLI
1. Copie o seguinte JSON e salve-o em um arquivo. Nomeie o arquivo `configuration-info.json`. *ConfigurationArn*Substitua pelo Amazon Resource Name (ARN) da configuração que você deseja usar para atualizar o cluster. A string do ARN deve estar entre aspas no seguinte JSON.
*Configuration-Revision*Substitua pela revisão da configuração que você deseja usar. As revisões de configuração são inteiros (números inteiros) que começam em `1`. Esse número inteiro não deve estar entre aspas no seguinte JSON.
```
{
"Arn": ConfigurationArn,
"Revision": Configuration-Revision
}
```
1. Execute o comando a seguir, *ClusterArn* substituindo-o pelo ARN obtido ao criar seu cluster. Se você não tiver o ARN do cluster, poderá encontrá-lo listando todos os clusters. Para obter mais informações, consulte [Listar clusters do Amazon MSK](msk-list-clusters.md).
*Path-to-Config-Info-File*Substitua pelo caminho para seu arquivo de informações de configuração. Se você nomeou o arquivo que criou na etapa anterior `configuration-info.json` e o salvou no diretório atual, então *Path-to-Config-Info-File* é`configuration-info.json`.
Substitua *Current-Cluster-Version* pela versão atual do cluster.
**Importante**
As versões de cluster não são inteiros simples. Para encontrar a versão atual do cluster, use a [DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster)operação ou o comando [AWS CLI describe-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html). Uma versão de exemplo é `KTVPDKIKX0DER`.
```
aws kafka update-cluster-configuration --cluster-arn ClusterArn --configuration-info file://Path-to-Config-Info-File --current-version Current-Cluster-Version
```
Veja a seguir um exemplo de como usar esse 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"
```
A saída desse comando `update-cluster-configuration` é semelhante ao seguinte JSON de exemplo.
```
{
"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. Para obter o resultado da `update-cluster-configuration` operação, execute o comando a seguir, *ClusterOperationArn* substituindo-o pelo ARN obtido na saída do `update-cluster-configuration` comando.
```
aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn
```
A saída desse comando `describe-cluster-operation` é semelhante ao seguinte JSON de exemplo.
```
{
"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
}
}
}
}
```
Nesta saída, `OperationType` é `UPDATE_CLUSTER_CONFIGURATION`. Se `OperationState` tiver o valor `UPDATE_IN_PROGRESS`, aguarde um pouco e execute o comando `describe-cluster-operation` novamente.
## Atualizar a configuração de um cluster do Amazon MSK usando a API
Para usar a API para atualizar a configuração de um cluster Amazon MSK, consulte [UpdateClusterConfiguration](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-configuration.html#UpdateClusterConfiguration).