本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Amazon MQ for ActiveMQ 代理
## 什么是 Amazon MQ for ActiveMQ 代理？
*代理* 是运行在 Amazon MQ 上的消息代理环境。它是 Amazon MQ 的基本构建块。代理实例*类* (`m5`) 和*大小* (`large`, `medium`) 的组合描述称为*代理实例类型*（例如，`mq.m5.large`）。有关更多信息，请参阅 [Amazon MQ for ActiveMQ 代理实例类型](broker-instance-types.md)。
+ *单实例代理*由一个可用区中的一个代理组成。代理与您的应用程序以及 Amazon EBS 或 Amazon EFS 存储卷进行通信。
+ *主动/备用代理*由两个不同可用区中的两个代理组成，配置为*冗余对*。这些代理与您的应用程序以及 Amazon EFS 进行同步通信。
有关更多信息，请参阅 [Amazon MQ for ActiveMQ 代理的部署选项](amazon-mq-broker-architecture.md)。
您可以启用*自动次要版本升级*以在 Apache 发布代理引擎的新次要版本时自动升级到新次要版本。自动升级在*维护时段*内发生，该维护时段使用星期几、几点（24 小时格式）和时区（默认为 UTC）定义。
有关创建和管理代理的信息，请参阅以下内容：
+ [入门：创建并连接 ActiveMQ 代理](getting-started-activemq.md)
+ [代理](amazon-mq-limits.md#broker-limits)
+ [Amazon MQ 代理状态](broker-statuses.md)
### 支持的线级协议
您可以访问您的代理，方法是使用 [ActiveMQ 支持的任何编程语言](http://activemq.apache.org/cross-language-clients.html)并通过为以下协议明确启用 TLS：
+ [AMQP](http://activemq.apache.org/amqp.html)
+ [MQTT](http://activemq.apache.org/mqtt.html)
+ 基于 [WebSocket](http://activemq.apache.org/websockets.html) 的 MQTT
+ [OpenWire](http://activemq.apache.org/openwire.html)
+ [STOMP](http://activemq.apache.org/stomp.html)
+ 基于 WebSocket 的 STOMP
### 属性
ActiveMQ 代理具有几个属性，例如：
+ 名称 (`MyBroker`)
+ ID (`b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ Amazon Resource Name（ARN）(`arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ ActiveMQ Web 控制台 URL (`https://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:8162`)
有关更多信息，请参阅 Apache ActiveMQ 文档中的 [Web 控制台](http://activemq.apache.org/web-console.html)。
**重要**
如果您指定的授权映射不包含在 `activemq-webconsole` 组中，您无法使用 ActiveMQ Web 控制台，因为该组未获得授权向 Amazon MQ 代理发送消息或接收来自该代理的消息。
+ 线级协议终端节点:
+ `amqp+ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:5671`
+ `mqtt+ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:8883`
+ `ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617`
**注意**
这是一个 OpenWire 终端节点。
+ `stomp+ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61614`
+ `wss://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61619`
有关更多信息，请参阅 Apache ActiveMQ 文档中的[配置传输](http://activemq.apache.org/configuring-transports.html)。
**注意**
对于主动/备用代理，Amazon MQ 提供两个 ActiveMQ Web 控制台 URL，但每次只有一个 URL 处于活动状态。同样，Amazon MQ 为每个线级协议提供两个终端节点，但每次每对中只有一个终端节点处于活动状态。`-1` 和 `-2` 后缀表示冗余对。
有关代理属性的完整列表，请参阅《Amazon MQ REST API 参考》**中的以下内容：
+ [REST 操作 ID：Broker](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-broker.html)
+ [REST 操作 ID：Brokers](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-brokers.html)
+ [REST 操作 ID：Broker Reboot](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-broker-reboot.html)
## 代理用户
ActiveMQ *用户*是能够访问 ActiveMQ 代理的队列和主题的人或应用程序。您可以将用户配置为具有特定权限。例如，您可以允许某些用户访问 [ActiveMQ Web 控制台](http://activemq.apache.org/web-console.html)。
*组*是一个语义标签。您可以为用户分配组，并为组配置发送、接收和管理特定队列和主题的权限。
**重要**
对用户进行更改*不会*立即将更改应用于用户。要应用更改，必须等待下一维护时段或者[重启代理](amazon-mq-rebooting-broker.md)。
有关用户和组的信息，请参阅 Apache ActiveMQ 文档中的以下部分：
+ [Authorization](http://activemq.apache.org/security.html#Security-Authorization)\$1
+ [授权示例](http://activemq.apache.org/security.html#Security-AuthorizationExample)
有关创建、编辑和删除 ActiveMQ 用户的信息，请参阅以下内容：
+ [创建 ActiveMQ 代理用户](amazon-mq-listing-managing-users.md)
+ [Users](amazon-mq-limits.md#activemq-user-limits)
### 用户属性
有关用户属性的完整列表，请参阅《Amazon MQ REST API 参考》**中的以下内容：
+ [REST 操作 ID：User](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-user.html)
+ [REST 操作 ID：Users](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-users.html)