

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.

# Actualización del tamaño del agente del clúster de Amazon MSK
<a name="msk-update-broker-type"></a>

Puede escalar el clúster de MSK bajo demanda al cambiar el tamaño de los agentes sin tener que reasignar las particiones de Apache Kafka. Al cambiar el tamaño del agente, tendrá la flexibilidad necesaria para ajustar la capacidad de computación en clústeres de MSK en función de los cambios en las cargas de trabajo, sin interrumpir las E/S del clúster. Amazon MSK utiliza el mismo tamaño del agente para todos los agentes de un clúster determinado.

En el caso de agentes Standard, puede actualizar el tamaño del agente del clúster de M5 o T3 a M7g, de T3 a M5, o de M7g a M5.

**nota**  
No puede migrar de un tamaño de agente más grande a uno más pequeño. Por ejemplo, de M7g.large a T3.small.

En el caso de los agentes Express, solo puede usar tamaños de agente M7g.

Este tema describe cómo actualizar el tamaño del agente del clúster de MSK.

Tenga en cuenta que la migración a un tamaño de agente más pequeño puede disminuir el rendimiento y reducir el rendimiento máximo alcanzable por agente. Migrar a un tamaño de agente más grande puede aumentar el rendimiento, pero también puede implicar un mayor costo.

La actualización del tamaño del agente se hace de forma continua mientras el clúster está activo y en funcionamiento. Esto significa que Amazon MSK elimina un agente a la vez para actualizar el tamaño del agente. Para obtener información sobre cómo ofrecer alta disponibilidad en un clúster durante la actualización del tamaño del agente, consulte [Crear clústeres de alta disponibilidad](bestpractices.md#ensure-high-availability). Para reducir aún más cualquier posible impacto en la productividad, puede actualizar el tamaño del agente durante un periodo de poco tráfico.

Durante una actualización del tamaño del agente, puede seguir produciendo y consumiendo datos. Sin embargo, debe esperar a que finalice la actualización para poder reiniciar los agentes o invocar cualquiera de las operaciones de actualización que figuran en la sección [Operaciones de Amazon MSK](https://docs.aws.amazon.com/msk/1.0/apireference/operations.html).

Si quiere actualizar el clúster a un tamaño del agente más pequeño, le recomendamos que intente primero actualizar un clúster de prueba para ver cómo afecta a su escenario. 

**importante**  
No se puede actualizar un clúster a un tamaño del agente más pequeño si el número de particiones por agente supera el número máximo especificado en [Dimensione correctamente el clúster: número de particiones por agente Standard](bestpractices.md#partitions-per-broker).

**Topics**
+ [Actualice el tamaño del bróker de clústeres de Amazon MSK mediante el Consola de administración de AWS](#update-broker-type-console)
+ [Actualice el tamaño del bróker de clústeres de Amazon MSK mediante el AWS CLI](#update-broker-type-cli)
+ [Actualización del tamaño del agente mediante la API](#update-broker-type-api)

## Actualice el tamaño del bróker de clústeres de Amazon MSK mediante el Consola de administración de AWS
<a name="update-broker-type-console"></a>

Este proceso muestra cómo actualizar el tamaño del bróker de clústeres de Amazon MSK mediante 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\#/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/).

1. Elija el clúster de MSK para el cual quiere actualizar el tamaño del agente.

1. En la página de detalles del clúster, encuentre la sección **Resumen de agentes** y elija **Editar tamaño del agente**.

1. Elija el tamaño del agente que quiere de la lista.

1. Guarde los cambios.

## Actualice el tamaño del bróker de clústeres de Amazon MSK mediante el AWS CLI
<a name="update-broker-type-cli"></a>

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

1. {{Current-Cluster-Version}}Sustitúyalo por la versión actual del clúster y {{TargetType}} por el nuevo tamaño que desee que tengan los corredores. Para más información acerca de los tamaños del agente, consulte [Tipos de agentes de Amazon MSK](broker-instance-types.md).

   ```
   aws kafka update-broker-type --cluster-arn {{ClusterArn}} --current-version {{Current-Cluster-Version}} --target-instance-type {{TargetType}}
   ```

   A continuación, se muestra un ejemplo de cómo utilizar este comando.

   ```
   aws kafka update-broker-type --cluster-arn "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1" --current-version "K1X5R6FKA87" --target-instance-type kafka.m5.large 
   ```

   El resultado de este comando tendrá un aspecto similar al siguiente.

   ```
   {
       "ClusterArn": "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1",
       "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-type` operación, ejecute el siguiente comando y {{ClusterOperationArn}} reemplácelo por el ARN que obtuvo en el resultado del `update-broker-type` 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": "982168a3-939f-11e9-8a62-538df00285db",
       "ClusterArn": "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1",
       "CreationTime": "2021-01-09T02:24:22.198000+00:00",
       "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_BROKER_TYPE",
       "SourceClusterInfo": {
         "InstanceType": "t3.small"
       },
       "TargetClusterInfo": {
         "InstanceType": "m5.large"
       }
     }
   }
   ```

   Si `OperationState` tiene el valor `UPDATE_IN_PROGRESS`, espere un rato y vuelva a ejecutar el comando `describe-cluster-operation`. 

## Actualización del tamaño del agente mediante la API
<a name="update-broker-type-api"></a>

Para actualizar el tamaño del bróker mediante la API, consulte [UpdateBrokerType](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn-nodes-type.html#UpdateBrokerType).

Puede utilizar `UpdateBrokerType` para actualizar el tamaño del agente de clúster de M5 o T3 a M7g, o de M7g a M5.