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

# 標準代理程式的手動擴展
<a name="manually-expand-storage"></a>

若要增加儲存空間，請等待叢集處於 `ACTIVE` 狀態。儲存擴展事件之間至少需要間隔六個小時的冷卻期間。即使此操作會立即提供額外的儲存，但服務仍會在叢集上執行最佳化，最長可能需要 24 小時或更長時間。這些最佳化的持續時間與您的儲存大小成正比。

## 使用 擴展代理程式儲存 AWS 管理主控台
<a name="update-storage-console"></a>

1. 開啟位於 [https://console.aws.amazon.com/msk/](https://console.aws.amazon.com/msk/) 的 Amazon MSK 主控台。

1. 選擇您要為其更新代理程式儲存的 MSK 叢集。

1. 在**儲存**區段中，選擇**編輯**。

1. 指定您想要的儲存磁碟區。您只能增加儲存空間，無法將其減少。

1. 選擇**儲存變更**。

## 使用 擴展代理程式儲存 AWS CLI
<a name="update-storage-cli"></a>

執行下列命令，使用您在建立叢集時獲得的 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-Volume-in-GiB* 參數表示您希望每個代理程式具有的儲存空間大小。只能夠更新所有代理程式的儲存空間。您無法指定個別代理程式來更新其儲存空間。您指定的 *Target-Volume-in-GiB* 的值必須是大於 100 GiB 的整數。更新操作後每個代理程式的儲存空間不能超過 16384 GiB。

```
aws kafka update-broker-storage --cluster-arn ClusterArn --current-version Current-Cluster-Version --target-broker-ebs-volume-info '{"KafkaBrokerNodeId": "All", "VolumeSizeGB": Target-Volume-in-GiB}' 
```

## 使用 API 縱向擴展代理程式儲存
<a name="update-storage-api"></a>

若要使用 API 來更新代理程式儲存空間，請參閱 [UpdateBrokerStorage](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-nodes-storage.html#UpdateBrokerStorage)。