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

# 為 Amazon MSK 叢集中的標準代理程式佈建儲存輸送量
<a name="msk-provision-throughput"></a>

Amazon MSK 代理程式會將資料保留在儲存磁碟區上。當生產者寫入叢集、代理程式之間複寫資料，以及在取用者讀取不在記憶體中的資料時，就會取用儲存空間 I/O。磁碟區儲存輸送量是指將資料寫入儲存磁碟區和從儲存磁碟區讀取資料的速率。佈建儲存輸送量功能可在叢集中指定代理程式的速率。

對於代理程式大小`kafka.m5.4xlarge`或更大的叢集，以及儲存磁碟區大小為 10 GiB 或更高的叢集，您可以指定每秒 MiB 的佈建輸送量速率。 GiB 您可以在建立叢集期間指定佈建輸送量。您也可以針對處於 `ACTIVE` 狀態的叢集啟用或停用佈建輸送量。

如需管理輸送量的資訊，請參閱 [管理 Amazon MSK 叢集中標準代理程式的儲存輸送量](msk-provision-throughput-management.md)。

**Topics**
+ [使用 佈建 Amazon MSK 叢集儲存輸送量 AWS 管理主控台](#provisioned-throughput-console)
+ [使用 佈建 Amazon MSK 叢集儲存輸送量 AWS CLI](#provisioned-throughput-cli)
+ [使用 API 建立 Amazon MSK 叢集時佈建儲存輸送量](#provisioned-throughput-api)

## 使用 佈建 Amazon MSK 叢集儲存輸送量 AWS 管理主控台
<a name="provisioned-throughput-console"></a>

此程序顯示如何使用 AWS 管理主控台 建立已啟用佈建輸送量的 Amazon MSK 叢集的範例。

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

1. 選擇 **Create Cluster** (建立叢集)。

1. 選擇**自訂建立**。

1. 指定叢集的名稱。

1. 在**儲存**區段中，選擇**啟用**。

1. 選擇每個代理程式的儲存輸送量值。

1. 選擇 VPC、區域、子網路和安全群組。

1. 選擇**下一步**。

1. 在**安全**步驟的底部，選擇**下一步**。

1. 在**監控和標籤**步驟的底部，選擇**下一步**。

1. 檢閱叢集設定，然後選擇**建立叢集**。

## 使用 佈建 Amazon MSK 叢集儲存輸送量 AWS CLI
<a name="provisioned-throughput-cli"></a>

此程序顯示如何使用 AWS CLI 建立已啟用佈建輸送量的叢集的範例。

1. 複製下方的 JSON 並貼到檔案中。以帳戶中的值取代子網路 ID 和安全群組 ID 預留位置。將檔案命名為 `cluster-creation.json` 並儲存。

   ```
   {
       "Provisioned": {
           "BrokerNodeGroupInfo":{
               "InstanceType":"kafka.m5.4xlarge",
               "ClientSubnets":[
                   "Subnet-1-ID",
                   "Subnet-2-ID"
               ],
               "SecurityGroups":[
                   "Security-Group-ID"
               ],
               "StorageInfo": {
                   "EbsStorageInfo": {
                       "VolumeSize": 10,
                       "ProvisionedThroughput": {
                           "Enabled": true,
                           "VolumeThroughput": 250
                       }
                   }
               }
           },
           "EncryptionInfo": {
               "EncryptionInTransit": {
                   "InCluster": false,
                   "ClientBroker": "PLAINTEXT"
               }
           },
           "KafkaVersion":"2.8.1",
           "NumberOfBrokerNodes": 2
       },
       "ClusterName": "provisioned-throughput-example"
   }
   ```

1. 從您在上一個步驟中儲存 JSON 檔案的目錄執行下列 AWS CLI 命令。

   ```
   aws kafka create-cluster-v2 --cli-input-json file://cluster-creation.json
   ```

## 使用 API 建立 Amazon MSK 叢集時佈建儲存輸送量
<a name="provisioned-throughput-api"></a>

若要在建立叢集時設定佈建儲存輸送量，請使用 [CreateClusterV2](https://docs.aws.amazon.com/MSK/2.0/APIReference/v2-clusters.html#CreateClusterV2)。