翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon MQ ブローカーのメンテナンスウィンドウのスケジュール
<a name="maintaining-brokers"></a>

 Amazon MQ は、ハードウェア、オペレーティングシステム、またはメッセージブローカーのエンジンソフトウェアに対して、メンテナンスウィンドウ内で定期的にメンテナンスを実行します。例えば、ブローカーインスタンスタイプを変更した場合、Amazon MQ はスケジュールされた次回のメンテナンスウィンドウ内で変更を適用します。メンテナンスの所要時間は、メッセージブローカーにスケジュールされている操作に応じて最大 2 時間かかることがあります。複数のアベイラビリティーゾーン (AZ) にまたがる高可用性のブローカーデプロイモードを選択すると、メンテナンスウィンドウ中のダウンタイムを最小限に抑えることができます。

 Amazon MQ for ActiveMQ には、高可用性を実現する[アクティブ/スタンバイ](amazon-mq-broker-architecture.md#active-standby-broker-deployment)デプロイが用意されています。アクティブ/スタンバイモードでは、Amazon MQ はメンテナンス操作を一度に 1 インスタンスずつ実行するため、少なくとも 1 つのインスタンスは利用可能な状態に維持されます。さらに、メンテナンスウィンドウが 1 週間の異なる時点に設定された[ブローカーのネットワーク](network-of-brokers.md)を構成することもできます。Amazon MQ for RabbitMQ には、高可用性を実現する[クラスター](rabbitmq-broker-architecture.md#rabbitmq-broker-architecture-cluster)デプロイが用意されています。クラスターデプロイでは、Amazon MQ はメンテナンス操作を一度に 1 ノードずつ実行して、少なくとも 2 つのノードが常に稼働している状態を維持します。

 ブローカーを最初に作成するときは、メンテナンスウィンドウを週に 1 回、指定時刻に実行するようにスケジュールできます。ブローカーのメンテナンスウィンドウは、次にスケジュールされたメンテナンスウィンドウまで、最大 4 回しか調整できません。ブローカーのメンテナンスウィンドウが完了すると、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 (開始日)**] には、ドロップダウンリストから曜日を選択します ([**Sunday (日曜日)**] など)。

   1.  [**Start time (開始時刻)**] には、次回のブローカーメンテナンスウィンドウをスケジュールする時間と分を選択します (**12**:**00** など)。
**注記**  
 [**Start time**] (開始時刻) オプションは、UTC\$10 タイムゾーンで設定されます。

1. 次に、**[変更のスケジュール]** を選択します。**[次回の再起動後]** または **[即時]** を選択します。**[次回の再起動後]** を選択すると、ブローカーを再起動せずに、直ちにメンテナンスウィンドウが更新されます。**[即時]** を選択すると、ブローカーがすぐに再起動されます。

1. ブローカーの詳細ページにある [**Maintenance window (メンテナンスウィンドウ)**] で、希望する新しいスケジュールが表示されていることを確認します。

## 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 です。ID は、ブローカー ARN から解析できます。例えば、`arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9` という ARN の場合、ブローカー 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 エンドポイントの詳細については、「*AWS 全般のリファレンス*」の「[Amazon MQ エンドポイントとクォータ](https://docs.aws.amazon.com/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: 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
   ```