

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Expansión de la cantidad de agentes en un clúster de Amazon MSK
<a name="msk-update-broker-count"></a>

Utilice esta operación de Amazon MSK cuando quiera aumentar el número de agentes en el clúster de MSK. Para ampliar un clúster, asegúrese de que está en el estado `ACTIVE`.

**importante**  
Si quiere expandir un clúster de MSK, asegúrese de utilizar esta operación de Amazon MSK. No intente agregar agentes a un clúster sin usar esta operación.

Para obtener información acerca de cómo volver a equilibrar particiones después de agregar agentes a un clúster, consulte [Reasignar particiones](bestpractices.md#bestpractices-balance-cluster).

## Amplíe un clúster de Amazon MSK mediante Consola de administración de AWS
<a name="expand-cluster-console"></a>

Este proceso describe cómo aumentar el número de agentes en un clúster de Amazon MSK mediante la Consola de administración de AWS.

1. ¿Iniciar sesión en la Consola de administración de AWS consola Amazon MSK y abrirla desde [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. Elija el clúster de MSK para aumentar su número de agentes.

1. En el menú desplegable **Acciones**, elija **Editar número de agentes**.

1. Introduzca el número de agentes que quiere que tenga el clúster por zona de disponibilidad y, luego, elija **Guardar cambios**.

## Amplíe un clúster de Amazon MSK mediante AWS CLI
<a name="expand-cluster-cli"></a>

Este proceso describe cómo aumentar el número de agentes en un clúster de Amazon MSK mediante la AWS CLI.

1. Ejecute el siguiente comando, reemplazando *ClusterArn*por el nombre de recurso de Amazon (ARN) que obtuvo al crear el clúster. Si no tiene el ARN para su clúster, puede encontrarlo enumerando todos los clústeres. Para obtener más información, consulte [Enumeración de clústeres de Amazon MSK](msk-list-clusters.md).

   Reemplace *Current-Cluster-Version* con la versión actual del clúster. 
**importante**  
Las versiones de clúster no son enteros simples. Para encontrar la versión actual del clúster, utilice la [DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster)operación o el comando [AWS CLI describe-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html). Un ejemplo de ID de versión es `KTVPDKIKX0DER`.

   El *Target-Number-of-Brokers* parámetro representa el número total de nodos intermediarios que desea que tenga el clúster cuando la operación se complete correctamente. El valor que especifique *Target-Number-of-Brokers* debe ser un número entero superior al número actual de corredores del clúster. También debe ser un múltiplo del número de zonas de disponibilidad.

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

   El resultado de esta operación `update-broker-count` se parece al siguiente 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 obtener el resultado de la `update-broker-count` operación, ejecute el siguiente comando y *ClusterOperationArn* reemplácelo por el ARN que obtuvo en el resultado del `update-broker-count` comando.

   ```
   aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn
   ```

   El resultado de este comando `describe-cluster-operation` tendrá un aspecto similar al siguiente.

   ```
   {
       "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
           }
       }
   }
   ```

   En esta salida, `OperationType` es `INCREASE_BROKER_COUNT`. Si `OperationState` tiene el valor `UPDATE_IN_PROGRESS`, espere un rato y vuelva a ejecutar el comando `describe-cluster-operation`. 

## Expansión de un clúster de Amazon MSK mediante la API
<a name="expand-cluster-api"></a>

Para aumentar el número de agentes de un clúster que utilizan la API, consulte [UpdateBrokerCount](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-nodes-count.html#UpdateBrokerCount).