本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 创建 Amazon MQ for ActiveMQ 代理配置
<a name="amazon-mq-creating-applying-configurations"></a>

*配置*中包含您的 ActiveMQ 代理的所有设置（采用 XML 格式，类似于 ActiveMQ 的 `activemq.xml` 文件）。您可以先创建配置，然后创建代理。之后，您可以将配置应用于一个或多个代理。您可以立即应用或在*维护时段*内应用配置。

以下示例演示如何使用 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. 在左侧，展开导航面板，然后选择 **Configurations (配置)**。  
![\[Amazon MQ navigation panel showing Brokers and Configurations options.\]](http://docs.aws.amazon.com/zh_cn/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-create-configuration.png)

1. 在 **Configurations (配置)** 页面上，选择 **Create configuration (创建配置)**。

1. 在**创建配置**页面的**详细信息**部分，输入**配置名称**（例如 `MyConfiguration`）并选择**代理引擎**版本。
**注意**  
要了解有关 Amazon MQ for ActiveMQ 支持的 ActiveMQ 引擎版本的更多信息，请参阅[管理 Amazon MQ for ActiveMQ 引擎版本](activemq-version-management.md)。

1. 选择**创建配置**。

## 创建新的配置修订
<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/zh_cn/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-edit-configuration.png)

1. 选择 **Edit configuration (编辑配置)** 并对 XML 配置进行更改。

1. 选择**保存**。

   **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/zh_cn/amazon-mq/latest/developer-guide/images/amazon-mq-tutorials-apply-configuration.png)

1. 从经纪人列表中，选择您的经纪商（例如 **MyBroker**），然后选择**编辑**。

1. 在 **“编辑 *MyBroker***” 页面的 “**配置**” 部分，选择**配置**和**修订版**，然后选择 “**计划修改**”。

1. 在 **Schedule broker modifications (计划代理修改)** 部分中，选择是在 **During the next scheduled maintenance window (下一个计划维护时段期间)** 还是 **Immediately (立即)** 应用修改。
**重要**  
单实例代理在重启期间处于离线状态。对于集群代理，在代理重启期间，每次只有一个节点宕机。

1. 选择**应用**。

   您的配置修订将在指定的时间应用到您的代理。