本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 擴展 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>

此程序說明如何使用 增加 Amazon MSK 叢集中的代理程式數量 AWS 管理主控台。

1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/msk/home 開啟 Amazon MSK 主控台？region=us-east-1\#/home/](https://console.aws.amazon.com/msk/home?region=us-east-1#/home/)。

1. 選擇要增加其代理程式數量的 MSK 叢集。

1. 從**動作**下拉式清單中，選擇**編輯代理程式數量**。

1. 輸入想要叢集在每個可用區域擁有的代理程式數量，然後選擇**儲存變更**。

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

此程序說明如何使用 增加 Amazon MSK 叢集中的代理程式數量 AWS CLI。

1. 執行下列命令，使用您在建立叢集時獲得的 Amazon Resource Name (ARN) 取代 {{ClusterArn}}。若您沒有叢集的 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) 操作或 [describe-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html) AWS CLI 命令。範例版本為`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` 操作的結果，請執行下列命令，使用您在 `update-broker-count` 命令輸出中取得的 ARN 取代 {{ClusterOperationArn}}。

   ```
   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)。