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

# 升级 Amazon MQ 代理实例类型
升级实例类型

**重要**  
 `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`）。要升级您的实例类型，您可以使用 Amazon Web Services 管理控制台、Amazon CLI 或 Amazon MQ API。

## Amazon Web Services 管理控制台


**要使用 Amazon Web Services 管理控制台 升级到更大的实例类型，请执行以下操作：**

1. 登录 [Amazon MQ 控制台](https://console.amazonaws.cn/amazon-mq/)。

1. 在左侧导航窗格中，选择 **Brokers (代理)**，然后从列表中选择您要升级的代理。

1.  在代理详细信息页上，选择 **Edit (编辑)**。

1.  在**规格**下，对于**代理实例类型**，从下拉列表中选择新的实例类型。

1. 在页面底部，选择**计划修改**。

1.  在 **Schedule broker modifications (计划代理修改)** 页面上，对于 **When to apply modifications (何时应用修改)** 下，选择以下选项之一。
   +  选择**下次重启后**，如果您希望 Amazon MQ 在下一个计划维护窗口中完成升级。
   +  选择**立即**，如果您希望立即重启代理并升级实例类型。
**重要**  
单实例代理在重启期间处于离线状态。对于集群代理，在代理重启期间，每次只有一个节点宕机。

1.  选择 **Apply (应用)** 以完成应用更改。

## Amazon CLI


**要使用 Amazon CLI 升级代理的实例类型**

1.  使用 [modify-broker](https://docs.amazonaws.cn/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.amazonaws.cn/cli/latest/reference/mq/reboot-broker.html) CLI 命令重启代理。

   ```
   aws mq reboot-broker --broker-id broker-id
   ```

   如果您不想重新启动代理和立即应用更改，Amazon MQ 将在下一个计划维护时段内升级代理。
**重要**  
单实例代理在重启期间处于离线状态。对于集群代理，在代理重启期间，每次只有一个节点宕机。

## Amazon MQ API


**要使用 Amazon MQ API 升级代理的实例类型**

1.  使用 [UpdateBroker](https://docs.amazonaws.cn/amazon-mq/latest/api-reference/brokers-broker-id.html#UpdateBroker) API 操作。指定 `broker-id` 作为路径参数。以下示例假定代理在 `us-west-2` 区域中。有关可用 Amazon MQ 端点的更多信息，请参阅 *Amazon Web Services 一般参考* 中的 [Amazon MQ 端点和配额](https://docs.amazonaws.cn/general/latest/gr/amazon-mq.html#amazon-mq_region)。

   ```
   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.amazonaws.cn/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 将在下一个计划维护时段内升级代理。
**重要**  
单实例代理在重启期间处于离线状态。对于集群代理，在代理重启期间，每次只有一个节点宕机。