Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Augmenter le nombre de courtiers dans un cluster Amazon MSK
Utilisez cette opération Amazon MSK lorsque vous souhaitez augmenter le nombre d'agents dans votre cluster MSK. Pour développer un cluster, assurez-vous que son état soit `ACTIVE`.
**Important**
Si vous voulez étendre un cluster MSK, veillez à utiliser cette opération Amazon MSK. N'essayez pas d'ajouter d'agents à un cluster sans utiliser cette opération.
Pour de plus amples informations sur le rééquilibrage des partitions après avoir ajouté des agents à un cluster, veuillez consulter [Réaffecter les partitions](bestpractices.md#bestpractices-balance-cluster).
## Développez un cluster Amazon MSK à l'aide du AWS Management Console
Ce processus décrit comment augmenter le nombre de courtiers dans un cluster Amazon MSK à l'aide du AWS Management Console.
1. Connectez-vous à la AWS Management Console console Amazon MSK et ouvrez-la [https://console.aws.amazon.com/msk/chez vous ? region=us-east-1\$1/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/).
1. Choisissez le cluster MSK pour lequel vous souhaitez augmenter le nombre d'agents.
1. Dans le menu déroulant **Actions**, sélectionnez **Modifier le nombre de courtiers**.
1. Entrez le nombre d'agents dont le cluster doit disposer par zone de disponibilité, puis choisissez **Enregistrer les modifications**.
## Développez un cluster Amazon MSK à l'aide du AWS CLI
Ce processus décrit comment augmenter le nombre de courtiers dans un cluster Amazon MSK à l'aide du AWS CLI.
1. Exécutez la commande suivante, en la *ClusterArn* remplaçant par le Amazon Resource Name (ARN) que vous avez obtenu lors de la création de votre cluster. Si vous n'avez pas l'ARN pour votre cluster, vous pouvez le trouver en listant tous les clusters. Pour de plus amples informations, veuillez consulter [Répertorier les clusters Amazon MSK](msk-list-clusters.md).
Remplacez *Current-Cluster-Version* par la version actuelle du cluster.
**Important**
Les versions de cluster ne sont pas des entiers simples. Pour trouver la version actuelle du cluster, utilisez l'[DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster)opération ou la commande [describe-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html) AWS CLI . Voici un exemple de version : `KTVPDKIKX0DER`.
Le *Target-Number-of-Brokers* paramètre représente le nombre total de nœuds de courtage que vous souhaitez que le cluster possède une fois cette opération terminée avec succès. La valeur que vous spécifiez *Target-Number-of-Brokers* doit être un nombre entier supérieur au nombre actuel de courtiers dans le cluster. Il doit également être un multiple du nombre de zones de disponibilité.
```
aws kafka update-broker-count --cluster-arn ClusterArn --current-version Current-Cluster-Version --target-number-of-broker-nodes Target-Number-of-Brokers
```
La sortie de cette opération `update-broker-count` ressemble au JSON suivant.
```
{
"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. Pour obtenir le résultat de l'`update-broker-count`opération, exécutez la commande suivante en la *ClusterOperationArn* remplaçant par l'ARN que vous avez obtenu dans le résultat de la `update-broker-count` commande.
```
aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn
```
La sortie de cette commande `describe-cluster-operation` ressemble à l'exemple JSON suivant.
```
{
"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
}
}
}
```
Dans cette sortie, `OperationType` est `INCREASE_BROKER_COUNT`. Si `OperationState` a la valeur `UPDATE_IN_PROGRESS`, attendez un moment, puis exécutez à nouveau la commande `describe-cluster-operation`.
## Développez un cluster Amazon MSK à l'aide de l'API
Pour augmenter le nombre de courtiers dans un cluster à l'aide de l'API, consultez [UpdateBrokerCount](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-nodes-count.html#UpdateBrokerCount).