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á.

# Expandir o número de agentes em um cluster do Amazon MSK
<a name="msk-update-broker-count"></a>

Execute esta operação do Amazon MSK quando você quiser aumentar o número de agentes em seu cluster do MSK. Para expandir um cluster, certifique-se de que ele esteja no estado `ACTIVE`.

**Importante**  
Certifique-se de usar esta operação do Amazon MSK se quiser expandir um cluster do MSK. Não tente adicionar agentes a um cluster sem usar essa operação.

Para obter informações sobre como reequilibrar partições depois de adicionar agentes a um cluster, consulte [Reatribuir partições](bestpractices.md#bestpractices-balance-cluster).

## Expanda um cluster Amazon MSK usando o Console de gerenciamento da AWS
<a name="expand-cluster-console"></a>

Este processo descreve como aumentar o número de agentes em um cluster do Amazon MSK usando o Console de gerenciamento da AWS.

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon MSK em [https://console.aws.amazon.com/msk/casa? region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/).

1. Escolha o cluster do MSK cujo número de agentes deseja aumentar.

1. No menu suspenso **Ações**, escolha **Editar número de agentes**.

1. Insira o número de agentes que você deseja que o cluster tenha por zona de disponibilidade e escolha **Salvar alterações**.

## Expanda um cluster Amazon MSK usando o AWS CLI
<a name="expand-cluster-cli"></a>

Este processo descreve como aumentar o número de agentes em um cluster do Amazon MSK usando o AWS CLI.

1. Execute o comando a seguir, substituindo *ClusterArn* pelo nome do recurso da Amazon (ARN) que você obteve quando criou o 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).

   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`.

   O *Target-Number-of-Brokers* parâmetro representa o número total de nós de intermediários que você deseja que o cluster tenha quando essa operação for concluída com êxito. O valor especificado *Target-Number-of-Brokers* deve ser um número inteiro maior que o número atual de corretores no cluster. Também deve ser um múltiplo do número de zonas de disponibilidade.

   ```
   aws kafka update-broker-count --cluster-arn ClusterArn --current-version Current-Cluster-Version --target-number-of-broker-nodes Target-Number-of-Brokers
   ```

   A saída dessa operação `update-broker-count` é semelhante ao seguinte JSON.

   ```
   {
       
       "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-broker-count` operação, execute o comando a seguir, *ClusterOperationArn* substituindo-o pelo ARN obtido na saída do `update-broker-count` 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": "c0b7af47-8591-45b5-9c0c-909a1a2c99ea",
           "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
           "CreationTime": "2019-09-25T23:48:04.794Z",
           "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": "INCREASE_BROKER_COUNT",
           "SourceClusterInfo": {
               "NumberOfBrokerNodes": 9
           },
           "TargetClusterInfo": {
               "NumberOfBrokerNodes": 12
           }
       }
   }
   ```

   Nesta saída, `OperationType` é `INCREASE_BROKER_COUNT`. Se `OperationState` tiver o valor `UPDATE_IN_PROGRESS`, aguarde um pouco e execute o comando `describe-cluster-operation` novamente. 

## Expandir um cluster do Amazon MSK usando a API
<a name="expand-cluster-api"></a>

Para aumentar o número de corretores em um cluster usando a API, consulte [UpdateBrokerCount](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-nodes-count.html#UpdateBrokerCount).