Amazon MQ
Developer Guide


A broker is a message broker environment running on Amazon MQ. It is the basic building block of Amazon MQ. The combined description of the broker instance class (m5, t2) and size (large, micro) is a broker instance type (for example, mq.m5.large). For more information, see Broker Instance Types.

  • A single-instance broker is comprised of one broker in one Availability Zone. The broker communicates with your application and with an AWS storage location.

  • An active/standby broker is comprised of two brokers in two different Availability Zones, configured in a redundant pair. These brokers communicate synchronously with your application, and with a shared storage location.

For more information, see Amazon MQ Broker Architecture.

You can enable automatic minor version upgrades to new minor versions of the broker engine, as Apache releases new versions. Automatic upgrades occur during the maintenance window defined by the day of the week, the time of day (in 24-hour format), and the time zone (UTC by default).

For information about creating and managing brokers, see the following:


A broker has several attributes, for example:

  • A name (MyBroker)

  • An ID (b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9)

  • An Amazon Resource Name (ARN) (arn:aws:mq:us-east-2:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9)

  • An ActiveMQ Web Console URL (

    For more information, see Web Console in the Apache ActiveMQ documentation.


    If you specify an authorization map which doesn't include the activemq-webconsole group, you can't use the ActiveMQ Web Console because the group isn't authorized to send messages to, or receive messages from, the Amazon MQ broker.

  • Wire-level protocol endpoints:

    • amqp+ssl://

    • mqtt+ssl://

    • ssl://


      This is an OpenWire endpoint.

    • stomp+ssl://

    • wss://

    For more information, see Configuring Transports in the Apache ActiveMQ documentation.


For an active/standby broker, Amazon MQ provides two ActiveMQ Web Console URLs, but only one URL is active at a time. Likewise, Amazon MQ provides two endpoints for each wire-level protocol, but only one endpoint is active in each pair at a time. The -1 and -2 suffixes denote a redundant pair.

For a full list of broker attributes, see the following in the Amazon MQ REST API Reference:

Instance Types

The combined description of the broker instance class (m5, t2) and size (large, micro) is a broker instance type (for example, mq.m5.large). The following table lists the available Amazon MQ broker instance types.

Instance Type vCPU Memory (GiB) Network Performance Notes
mq.t2.micro 1 1 Low

Use the mq.t2.micro instance type for basic evaluation of Amazon MQ. This instance type (single-instance brokers only) qualifies for the AWS Free Tier.


Using the mq.t2.micro instance type is subject to CPU credits and baseline performance—with the ability to burst above the baseline level (for more information, see the CpuCreditBalance metric). If your application requires fixed performance, consider using an mq.m5.large instance type.

mq.m5.large 2 8 High

Use the mq.m5.large instance for regular development, testing, and production workloads.

mq.m5.xlarge 4 16 High

Use the mq.m5.xlarge, mq.m5.2xlarge, and mq.m5.4xlarge instance types for regular development, testing and production workloads that require high throughput.


When your system uses persistent messages, its throughput depends on how quickly messages are consumed.

If messages aren't consumed immediately, using larger instance types with persistent messages might not improve system throughput. In this case, we recommend setting the concurrentStoreAndDispatchQueues attribute to false. For more information, see Disable Concurrent Store and Dispatch for Queues with Slow Consumers.

mq.m5.2xlarge 8 32 High
mq.m5.4xlarge 16 64 High
mq.m4.large 2 8 Moderate Use the mq.m4.large instance type for compatibility with existing broker deployments. We recommend using an mq.m5.* instance for new brokers.

For more information about throughput considerations, see Choose the Correct Broker Instance Type for the Best Throughput.


A broker's current condition is indicated by a status. The following table lists the statuses of an Amazon MQ broker.

Console API Description
Creation failed CREATION_FAILED The broker couldn't be created.
Creation in progress CREATION_IN_PROGRESS The broker is currently being created.
Deletion in progress DELETION_IN_PROGRESS The broker is currently being deleted.
Reboot in progress REBOOT_IN_PROGRESS The broker is currently being rebooted.
Running RUNNING The broker is operational.