翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 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`) にアップグレードすることをお勧めします。インスタンスタイプをアップグレードするには、AWS マネジメントコンソール、AWS CLI、または Amazon MQ API を使用できます。
## AWS マネジメントコンソール
**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 つだけです。
1. [**Apply**] (適用) をクリックして、変更の適用を終了します。
## AWS CLI
**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 がブローカーをアップグレードします。
**重要**
再起動中、シングルインスタンスブローカーはオフラインになります。クラスターブローカーの場合、ブローカーの再起動中にダウンするノードは 1 つだけです。
## Amazon MQ API
**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}}
```
リクエストペイロードで `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 がブローカーをアップグレードします。
**重要**
再起動中、シングルインスタンスブローカーはオフラインになります。クラスターブローカーの場合、ブローカーの再起動中にダウンするノードは 1 つだけです。