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

# Amazon MQ ブローカーエンジンバージョンのアップグレード
<a name="upgrading-brokers"></a>

 Amazon MQ は、サポートされているすべてのブローカーエンジンタイプに対して、新しいブローカーエンジンバージョンを定期的に提供します。新しいエンジンバージョンには、セキュリティパッチ、バグ修正、その他のブローカーエンジンの改善が含まれています。

 Amazon MQ は、`X.Y.Z` 形式のセマンティックバージョニングに従ってバージョン番号を分類します。Amazon MQ の実装では、`X` はメジャーバージョンを示し、`Y` はマイナーバージョンを表し、`Z` はパッチバージョン番号を示します。Amazon MQ は 2 種類のアップグレードをサポートしています。
+ **メジャーバージョンアップグレード** – メジャーエンジンバージョン番号が変更されたときに行われます。例えば、RabbitMQ バージョン **3**.13 からバージョン **4**.2 へのアップグレードは、メジャーバージョンのアップグレードと見なされます。
+ **マイナーバージョンアップグレード** – マイナーエンジンバージョン番号のみが変更されたときに行われます。たとえば、バージョン 3.**11** からバージョン 3.**12** へのアップグレードは、マイナーバージョンアップグレードと見なされます。

 ブローカーはいつでも、サポートされている次のメジャーバージョンまたはマイナーバージョンに手動でアップグレードできます。Amazon MQ は、スケジュールされた[メンテナンスウィンドウ](maintaining-brokers.md)中に、すべてのブローカーでサポートされている最新のパッチバージョンへのアップグレードを管理します。手動バージョンアップグレードと自動バージョンアップグレードは、スケジュールされたメンテナンスウィンドウ中、または[ブローカーを再起動](amazon-mq-rebooting-broker.md)した後に行われます。Amazon MQ は、現在のマイナーバージョンがサポート終了に達すると、ブローカーを次のマイナーバージョンにアップグレードします。

## エンジンバージョンの手動アップグレード
<a name="upgrading-brokers-manual-upgrades"></a>

ブローカーのエンジンバージョンは、 AWS マネジメントコンソール、、 AWS CLIまたは Amazon MQ API を使用してアップグレードできます。

### AWS マネジメントコンソール
<a name="upgrading-brokers-manual-upgrades-console"></a>

**を使用してブローカーのエンジンバージョンをアップグレードするには AWS マネジメントコンソール**

1.  ブローカーの詳細ページで [**Edit**] (編集) をクリックします。

1.  [**Specifications**] (仕様) の [**Broker engine version**] (ブローカーエンジンバージョン) で、ドロップダウンリストから新しいバージョン番号を選択します。

1. ページの最下部までスクロールして、[**Schedule modifications**] (変更をスケジュールする) をクリックします。

1.  [**Schedule broker modifications**] (ブローカー変更のスケジュール) ページの [**When to apply modifications**] (変更を適用するタイミング) で以下のいずれかを選択します。
   +  次にスケジュールされたメンテナンスウィンドウ中に Amazon MQ でバージョンアップグレードを完了する場合は、[**After the next reboot**] (次回の再起動後) を選択します。
   +  直ちにブローカーを再起動してエンジンバージョンをアップグレードする場合は、[**Immediately**] (即時) を選択します。
**重要**  
再起動中、シングルインスタンスブローカーはオフラインになります。クラスターブローカーの場合、ブローカーの再起動中にダウンするノードは 1 つだけです。

1.  [**Apply**] (適用) をクリックして、変更の適用を終了します。

### AWS CLI
<a name="upgrading-brokers-manual-upgrades-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` になります。
   +  `--engine-version` – ブローカーエンジンをアップグレードするエンジンバージョン番号です。

   ```
   aws mq update-broker --broker-id {{broker-id}} --engine-version {{version-number}}
   ```

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 がブローカーをアップグレードします。
**重要**  
再起動中、シングルインスタンスブローカーはオフラインになります。クラスターブローカーの場合、ブローカーの再起動中にダウンするノードは 1 つだけです。

### Amazon MQ API
<a name="upgrading-brokers-manual-upgrades-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: Mon, 7 June 2021 12:00:00 GMT
   x-amz-date: Mon, 7 June 2021 12:00:00 GMT
   Authorization: {{authorization-string}}
   ```

   リクエストペイロードで `engineVersion` を使用して、ブローカーをアップグレードするバージョン番号を指定します。

   ```
   {
       "engineVersion": "{{engine-version-number}}"
   }
   ```

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 がブローカーをアップグレードします。
**重要**  
再起動中、シングルインスタンスブローカーはオフラインになります。クラスターブローカーの場合、ブローカーの再起動中にダウンするノードは 1 つだけです。