Amazon MQ
REST API Reference


Welcome to the Amazon MQ REST API reference. In this guide, you can find descriptions of REST resources, example requests, HTTP methods, schemas, parameters, and the errors that the service returns.

Amazon MQ is a managed message broker service for Apache ActiveMQ that makes it easy to set up and operate message brokers in the cloud. Amazon MQ works with your existing applications and services without the need to manage, operate, or maintain your own messaging system.

You can access your brokers using any programming language that ActiveMQ supports and the following protocols with SSL enabled:

Additional Information

Last documentation update: February 15, 2018

Example REST Request

The following is an example of an Amazon MQ REST request (and its headers) which creates a new broker:

POST /v1/brokers HTTP/1.1 Content-Type: application/json X-Amz-Date: 20171123T214525Z Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20171128/us-east-1/mq/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-date, Signature=a12bc34567defg89h0ij1234kl56m789no01p2q345r6s789tu01v2w3x4567890 Host: Cache-Control: no-cache
{ "brokerName": "MyBroker", "hostInstanceType": "mq.m4.large", "engineType": "ActiveMQ", "engineVersion": "5.15.0", "deploymentMode": "ACTIVE_STANDBY_MULTI_AZ", "publiclyAccessible": true, "subnetIds": [ "subnet-12a3b45c", "subnet-67d8e90f" ], "securityGroups": [ "sg-a1b234cd", "sg-e5f678gh" ], "autoMinorVersionUpgrade": true, "users": [{ "password": "MyPassword456", "groups": [ "admins" ], "consoleAccess": true, "username": "jane.doe" }] }

Example REST Response

The following is an example of an Amazon MQ REST response (and its headers) which acknowledges the creation of the new broker:

HTTP/1.1 200 OK Content-Type: application/json Content-Length: 250 Connection: keep-alive Date: Wed, 28 Nov 2017 12:00:00 GMT X-Amzn-RequestId: a12bc345-67de-89f0-g12h-345ij6k7l89m X-Amzn-Trace-Id: sampled=1;root=1-2345a67b-c8defg901hijk2lf3m4nopqr X-Cache: Miss from cloudfront Via: 1.1 (CloudFront) X-Amz-Cf-Id: ABCa1D6b2-EcF3dG7e456_fGIgh7JKLMijNO_PQ8RSTUVWX-Y9k0ZA==
{ "brokerId" : "b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9", "brokerArn": "arn:aws:mq:us-east-1:123456789012:broker:MyBroker:b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9" }