本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 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)
+ MQTT over [WebSocket](http://activemq.apache.org/websockets.html)
+ [OpenWire](http://activemq.apache.org/openwire.html)
+ [STOMP](http://activemq.apache.org/stomp.html)
+ STOMP over WebSocket
### Attributes
ActiveMQ 代理程式具有多個屬性，例如：
+ 名稱 (`MyBroker`)
+ ID (`b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ Amazon 資源名稱 (ARN) (`arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9`)
+ ActiveMQ 網頁主控台 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：中介裝置](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-broker.html)
+ [REST 操作 ID：中介裝置](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-brokers.html)
+ [REST 操作 ID：中介裝置重新開機](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 文件中的以下章節：
+ [授權](http://activemq.apache.org/security.html#Security-Authorization)
+ [授權範例](http://activemq.apache.org/security.html#Security-AuthorizationExample)
如需建立、編輯和刪除 ActiveMQ 使用者的詳細資訊，請參閱以下各節：
+ [建立 ActiveMQ 代理程式使用者](amazon-mq-listing-managing-users.md)
+ [使用者](amazon-mq-limits.md#activemq-user-limits)
### 使用者屬性
如需使用者屬性的完整清單，請參閱 *Amazon MQ REST API 參考*中的以下各節：
+ [REST 操作 ID：使用者](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-user.html)
+ [REST 操作 ID：使用者](https://docs.aws.amazon.com/amazon-mq/latest/api-reference/rest-api-users.html)