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

# 升級 Amazon MQ 代理程式執行個體類型
<a name="upgrading-instance-type"></a>

**重要**  
 `mq.m7g.x` 執行個體僅適用於 Amazon MQ for RabbitMQ 代理程式。Amazon MQ for ActiveMQ 代理程式僅使用`mq.m5.x`執行個體。

 中介裝置執行個體類別 (`m7g`) 和大小 (`large`) 的合併描述稱為中介裝置執行個體類型 （例如 `mq.m7g.large`)。選擇執行個體類型時，請務必考量會影響代理程式效能的因素：
+  用戶端和佇列的數量 
+  傳送的訊息量 
+  訊息保留在記憶體中 
+  備援訊息 

 建議僅將較小的中介裝置執行個體類型 (`mq.m7g.medium`) 用於測試應用程式效能。對於用戶端和佇列的生產層級、高輸送量、記憶體中的訊息和備援訊息，我們建議使用較大的中介裝置執行個體類型 (`mq.m7g.large ` 和更高版本）。

 如果您遇到效能問題，或是要從測試轉移到生產環境，建議您升級至較大的執行個體類型 （即從 `micro` 升級至 `large`)。若要升級執行個體類型，您可以使用 AWS 管理主控台 AWS CLI、 或 Amazon MQ API。

## AWS 管理主控台
<a name="upgrading-instance-type-console"></a>

**若要使用 升級到較大的執行個體類型 AWS 管理主控台，請執行下列動作：**

1. 登入 [Amazon MQ 主控台](https://console.aws.amazon.com/amazon-mq/)。

1. 在左側導覽窗格中，選擇 **Brokers (代理程式)**，然後從清單中選擇您要升級的代理程式。

1.  在代理程式詳細資訊頁面上，選擇 **Edit (編輯)**。

1.  在**規格**下，針對**中介裝置執行個體類型**，從下拉式清單中選擇新的執行個體類型。

1. 在頁面底部，選擇**排程修改**。

1.  在 **Schedule broker modifications (排定代理程式修改)** 頁面上，針對 **When to apply modifications (套用修改的時機)**，選擇下列其中一項。
   +  選擇**下次重新開機後**，如果您希望 Amazon MQ 在下一個排定的維護時段完成升級。
   +  如果您想要重新啟動代理程式並立即升級執行個體類型，請選擇**立即**。
**重要**  
重新啟動時，單一執行個體代理程式處於離線狀態。對於叢集代理程式，代理程式重新啟動時一次只會關閉一個節點。

1.  選擇 **Apply (套用)** 以完成變更套用。

## AWS CLI
<a name="upgrading-instance-type-cli"></a>

**使用 升級代理程式的執行個體類型 AWS CLI**

1.  使用 [modify-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) CLI 命令並指定下列參數，如範例所示。
   +  `--broker-id` – Amazon MQ 針對代理程式產生的唯一 ID。
   +  `--host-instance-type` – 要升級至的代理程式引擎版本號碼。

   ```
   aws mq modify-broker --broker-id {{broker-id}} --host-instance-type {{instance-type}}
   ```

1.  （選用） 如果您想要立即升級執行個體類型，請使用 [reboot-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) CLI 命令重新啟動代理程式。

   ```
   aws mq reboot-broker --broker-id {{broker-id}}
   ```

   如果您不想立即重新啟動代理程式並套用變更，Amazon MQ 會在下一個排定的維護時段期間升級代理程式。
**重要**  
重新啟動時，單一執行個體代理程式處於離線狀態。對於叢集代理程式，代理程式重新啟動時一次只會關閉一個節點。

## Amazon MQ API
<a name="upgrading-instance-type-api"></a>

**使用 Amazon MQ API 升級代理程式的執行個體類型**

1.  使用 [UpdateBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#UpdateBroker) API 操作。指定 `broker-id` 作為路徑參數。下列範例假設 `us-west-2` 地區中的代理程式。如需可用 Amazon MQ 端點的詳細資訊，請參閱[《》中的 Amazon MQ 端點和配額](https://docs.aws.amazon.com/general/latest/gr/amazon-mq.html#amazon-mq_region)*AWS 一般參考*。

   ```
   PUT /v1/brokers/{{broker-id}} HTTP/1.1
   Host: mq.us-west-2.amazonaws.com
   Date: Mon, 7 June 2021 12:00:00 GMT
   x-amz-date: Mon, 7 June 2021 12:00:00 GMT
   Authorization: {{authorization-string}}
   ```

   在請求承載`host-instance-type`中使用 來指定要升級的代理程式執行個體類型。

   ```
   {
       "host-instance-type": "{{host-instance-type}}"
   }
   ```

1.  (選用) 如果您想立即升級引擎版本，請使用 [RebootBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id-reboot.html#RebootBroker) API 操作重新啟動代理程式。`broker-id` 被指定為路徑參數。

   ```
   POST /v1/brokers/{{broker-id}}/reboot-broker HTTP/1.1
   Host: mq.us-west-2.amazonaws.com
   Date: Mon, 7 June 2021 12:00:00 GMT
   x-amz-date: Mon, 7 June 2021 12:00:00 GMT
   Authorization: {{authorization-string}}
   ```

   如果您不想立即重新啟動代理程式並套用變更，Amazon MQ 會在下一個排定的維護時段期間升級代理程式。
**重要**  
重新啟動時，單一執行個體代理程式處於離線狀態。對於叢集代理程式，代理程式重新啟動時一次只會關閉一個節點。