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

# 排程 Amazon MQ 代理程式的維護時段
<a name="maintaining-brokers"></a>

 Amazon MQ 會在維護時段期間定期對訊息中介裝置的硬體、作業系統或引擎軟體執行維護。例如，如果您變更代理程式執行個體類型，Amazon MQ 會在下一個排定的維護時段套用您的變更。視您訊息代理程式排定的操作而定，維護的持續時間最多可持續兩小時。您可以透過選取跨多個可用區域 (AZ) 高可用性的代理程式部署模式，將維護時段期間的停機時間降至最低。

 Amazon MQ for ActiveMQ 提供[主動/待命](amazon-mq-broker-architecture.md#active-standby-broker-deployment)部署，以實現高可用性。在作用中/待命模式中，Amazon MQ 一次執行一個執行個體的維護操作，且至少有一個執行個體仍然可用。此外，您可以設定[代理程式網路](network-of-brokers.md)，維護時段在一週內會有所不同。Amazon MQ for RabbitMQ 提供高可用性的[叢集](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-cluster)部署。在叢集部署中，Amazon MQ 透過隨時保持至少兩個執行中的節點，一次執行一個節點的維護操作。

 第一次建立代理程式時，您可以將維護時段排定在指定時間每週執行一次。您只能將代理程式的維護時段調整為在下一個排定的維護時段前最多四次。代理程式維護時段完成後，Amazon MQ 會重設限制，您可以在下一個維護時段發生之前再次調整排程。調整代理程式維護時段時，代理程式可用性不會受到影響。

 若要調整代理程式維護時段，您可以使用 AWS 管理主控台 AWS CLI、 或 Amazon MQ API。

## 使用 排程代理程式維護時段 AWS 管理主控台
<a name="maintaining-brokers-adjusting-maintenance-window-console"></a>

**使用 調整中介裝置維護時段 AWS 管理主控台**

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

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

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

1. 在 **Maintenance (維護)** 之下，執行下列動作。

   1.  針對 **Start day** (開始日)，從下拉式清單中選擇星期幾，例如**週日**。

   1.  針對 **Start time** (開始時間)，選擇您想排定下一個代理程式維護時段的一天中的小時和分鐘，例如 **12**:**00**。
**注意**  
 **Start time (開始時間)** 選項設定於 UTC\$10 時區。

1. 接著，選取**排程修改**。然後選擇**下次重新開機後**或**立即**。選擇**下次重新啟動後**， 會立即更新維護時段，而不會重新啟動代理程式。選擇**立即**將立即重新啟動代理程式。

1. 在代理程式詳細資訊頁面的 **Maintenance widnow** (維護時段) 下，確認已顯示新的偏好排程。

## 使用 排程代理程式維護時段 AWS CLI
<a name="maintaining-brokers-adjusting-maintenance-window-cli"></a>

**使用 調整中介裝置維護時段 AWS CLI**

1.  使用 [update-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/update-broker.html) CLI 命令並指定下列參數，如範例所示。
   +  `--broker-id` – Amazon MQ 針對代理程式產生的唯一 ID。您可以從代理程式 ARN 解析 ID。例如，假定是以下 ARN `arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`，代理程式 ID 會是 `b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`。
   +  `--maintenance-window-start-time` – 決定下列結構中提供的每週維護時段開始時間的參數。
     + `DayOfWeek` – 星期幾，使用下列語法：`MONDAY| TUESDAY | WEDNESDAY | THURSDAY | FRIDAY | SATURDAY | SUNDAY`
     + `TimeOfDay` – 24 小時制的時間。
     + `TimeZone` – (選用) 國家/城市或 UTC 位移格式的時區。預設為 UTC 。

   ```
   aws mq update-broker --broker-id broker-id \
   --maintenance-window-start-time DayOfWeek=SUNDAY,TimeOfDay=13:00,TimeZone=America/Los_Angeles
   ```

1.  (選用) 使用 [describe-broker](https://docs.aws.amazon.com/cli/latest/reference/mq/reboot-broker.html) CLI 命令，以確認已成功更新維護時段。

   ```
   aws mq describe-broker --broker-id broker-id
   ```

## 使用 Amazon MQ API 排程代理程式維護時段
<a name="maintaining-brokers-adjusting-maintenance-window-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: Wed, 7 July 2021 12:00:00 GMT
   x-amz-date: Wed, 7 July 2021 12:00:00 GMT
   Authorization: authorization-string
   ```

   在請求承載中使用 `maintenanceWindowStartTime` 參數和 [https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-model-weeklystarttime](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-model-weeklystarttime) 資源類型。

   ```
   {
   "maintenanceWindowStartTime": {
       "dayOfWeek": "SUNDAY",
       "timeZone": "America/Los_Angeles",
       "timeOfDay": "13:00"
     }
   }
   ```

1.  (選用) 使用 [DescribeBroker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/brokers-broker-id.html#brokers-broker-id-http-methods) API 操作，以確認已成功更新維護時段。`broker-id` 被指定為路徑參數。

   ```
   GET /v1/brokers/broker-id HTTP/1.1
   Host: mq.us-west-2.amazonaws.com
   Date: Wed, 7 July 2021 12:00:00 GMT
   x-amz-date: Wed, 7 July 2021 12:00:00 GMT
   Authorization: authorization-string
   ```