本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 扩展 Amazon MSK 集群中的代理数量
<a name="msk-update-broker-count"></a>

如果要增加 MSK 集群中的代理数量，请使用此 Amazon MSK 操作。要扩展集群，请确保集群处于 `ACTIVE` 状态。

**重要**  
如果要扩展 MSK 集群，请确保使用此 Amazon MSK 操作。切勿尝试在未使用此操作的情况下向集群添加代理。

有关在将代理添加到集群后如何重新平衡分区的信息，请参阅[重新分配分区](bestpractices.md#bestpractices-balance-cluster)。

## 使用扩展 Amazon MSK 集群 AWS 管理控制台
<a name="expand-cluster-console"></a>

此过程介绍如何使用 AWS 管理控制台增加 Amazon MSK 集群中的代理数量。

1. 登录并在[https://console.aws.amazon.com/msk/家中打开 Amazon MSK 控制台？ AWS 管理控制台 region=us](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/)-east-1\#/home/。

1. 选择要增加代理数量的 MSK 集群。

1. 从**操作**下拉菜单中，选择**编辑代理数**。

1. 输入您希望集群在每个可用区具有的代理数量，然后选择**保存更改**。

## 使用扩展 Amazon MSK 集群 AWS CLI
<a name="expand-cluster-cli"></a>

此过程介绍如何使用 AWS CLI增加 Amazon MSK 集群中的代理数量。

1. 运行以下命令，并将 {{ClusterArn}} 替换为创建集群时所获取的 Amazon 资源名称（ARN）。如果您没有该集群的 ARN，可以通过列出所有集群来找到它。有关更多信息，请参阅 [列出 Amazon MSK 集群](msk-list-clusters.md)。

   将 {{Current-Cluster-Version}} 替换为集群的当前版本。
**重要**  
集群版本不是简单的整数。要查找集群的当前版本，请使用[DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster)操作或 desc [ribe-](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html) AWS CLI cluster 命令。示例版本是 `KTVPDKIKX0DER`。

   该{{Target-Number-of-Brokers}}参数表示此操作成功完成后您希望集群拥有的代理节点总数。您指定的值{{Target-Number-of-Brokers}}必须是大于集群中当前代理数量的整数。它还必须是可用区数目的倍数。

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

   该 `update-broker-count` 操作的输出如以下 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. 要获得`update-broker-count`操作结果，请运行以下命令，{{ClusterOperationArn}}替换为在命令输出中获得的 ARN。`update-broker-count`

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

   该 `describe-cluster-operation` 命令的输出如以下 JSON 示例所示。

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

   在此输出中， `OperationType` 是 `INCREASE_BROKER_COUNT`。如果 `OperationState` 的值为 `UPDATE_IN_PROGRESS`，请等待一段时间，然后再次运行 `describe-cluster-operation` 命令。

## 使用 API 扩展 Amazon MSK 集群
<a name="expand-cluster-api"></a>

要使用 API 增加集群中代理的数量，请参阅[UpdateBrokerCount](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-nodes-count.html#UpdateBrokerCount)。