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

# Amazon MQ for ActiveMQ ブローカー設定の作成
<a name="amazon-mq-creating-applying-configurations"></a>

*設定*には、ActiveMQ ブローカーのすべての設定が XML 形式で含まれています (ActiveMQ の `activemq.xml` ファイルに似ています)。設定は、ブローカーを作成する前に作成することができます。作成後、設定を 1 つ、または複数のブローカーに適用できます。設定は直ちに適用する、または*メンテナンスウィンドウ*中に適用することができます。

以下の例では、 AWS マネジメントコンソールを使用して Amazon MQ ブローカーの設定を作成し、適用する方法を説明します。

**重要**  
設定は `DeleteConfiguration` API を使用してのみ**削除**できます。詳細については、「*Amazon MQ API リファレンス*」の「[設定](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/configurations-configuration-id.html)」を参照してください。

## 新しい設定の作成
<a name="creating-configuration-from-scratch-console"></a>

新しいブローカー設定を作成するには、まず新しい設定を作成します。

1. [Amazon MQ コンソール](https://console.aws.amazon.com/amazon-mq/)にサインインします。

1. 左側のナビゲーションパネルを展開し、[**設定**] を選択します。  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/ja_jp/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. [**設定**] ページで、[**Create configuration (設定の作成)**] を選択します。

1. **[設定の作成]** ページの **[詳細]** セクションで **[設定名]** (`MyConfiguration` など) を入力し、**[ブローカーエンジン]** のバージョンを選択します。
**注記**  
Amazon MQ for ActiveMQ がサポートする ActiveMQ エンジンバージョンの詳細については、「[Amazon MQ for ActiveMQ エンジンバージョンの管理](activemq-version-management.md)」を参照してください。

1. [**Create configuration**] (設定の作成) をクリックします。

## 新しい設定リビジョンの作成
<a name="creating-new-configuration-revision-console"></a>

ブローカー設定を作成したら、設定リビジョンを使用して設定を編集する必要があります。

1. 設定リストから、[***MyConfiguration***] を選択します。
**注記**  
設定の最初のリビジョンは常に、Amazon MQ が設定を作成するときに作成されます。

   **[*MyConfiguration*]** ページに、新しい設定リビジョンで使用されるブローカーのエンジンタイプとバージョン (**Apache ActiveMQ 5.15.16** など) が表示されます。

1. [**Configuration details**] タブに、設定リビジョン番号、説明、およびブローカー設定が XML 形式で表示されます。
**注記**  
現在の設定を編集すると、設定の新しいリビジョンが作成されます。  
![\[XML configuration snippet for ActiveMQ broker with explanatory comment.\]](http://docs.aws.amazon.com/ja_jp/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. [**Edit configuration**] (設定の編集) をクリックして、XML 設定を変更します。

1. [**Save**] (保存) をクリックします。

   [**Save revision**] (リビジョンの保存) ダイアログボックスが表示されます。

1. (オプション) `A description of the changes in this revision` を入力します。

1. **[保存]** を選択します。

   設定の新しいリビジョンが保存されます。
**重要**  
Amazon MQ コンソールは、スキーマに従って、無効および禁止されている設定パラメータを自動的にサニタイズします。許可されている XML パラメータの詳細および完全なリストについては、「[Amazon MQ for ActiveMQ ブローカーの設定](amazon-mq-broker-configuration-parameters.md)」を参照してください。

## 設定リビジョンをブローカーに適用する
<a name="apply-configuration-revision-creating-console"></a>

設定を変更したら、設定リビジョンをブローカーに適用できます。

1. 左側のナビゲーションパネルを展開し、[**Brokers (ブローカー)**] を選択します。  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/ja_jp/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. ブローカーリストからブローカーを選択して (**MyBroker** など)、[**Edit**] (編集) をクリックします。

1. [**Edit *MyBroker***] (MyBroker の編集) ページの [**Configuration**] (設定) セクションで [**Configuration**] (設定) と [**Revision**] (リビジョン) を選択してから、[**Schedule Modifications**] (変更をスケジュールする) をクリックします。

1. [**ブローカー変更のスケジュール**] セクションで、変更を [**次回のスケジュールされたメンテナンスウィンドウ中**] に適用するか、[**即時**] 適用するかを選択します。
**重要**  
再起動中、シングルインスタンスブローカーはオフラインになります。クラスターブローカーの場合、ブローカーの再起動中にダウンするノードは 1 つだけです。

1. [**Apply**] (適用) をクリックします。

   設定リビジョンが指定された時刻にブローカーに適用されます。