Table Of Contents

Feedback

User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . mq ]

create-broker

Description

Creates a broker. Note: This API is asynchronous.

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.

Synopsis

  create-broker
[--auto-minor-version-upgrade | --no-auto-minor-version-upgrade]
[--broker-name <value>]
[--configuration <value>]
[--creator-request-id <value>]
[--deployment-mode <value>]
[--engine-type <value>]
[--engine-version <value>]
[--host-instance-type <value>]
[--logs <value>]
[--maintenance-window-start-time <value>]
[--publicly-accessible | --no-publicly-accessible]
[--security-groups <value>]
[--subnet-ids <value>]
[--users <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]

Options

--auto-minor-version-upgrade | --no-auto-minor-version-upgrade (boolean) Required. Enables automatic upgrades to new minor versions for brokers, as Apache releases the versions. The automatic upgrades occur during the maintenance window of the broker or after a manual broker reboot.

--broker-name (string) Required. The name of the broker. This value must be unique in your AWS account, 1-50 characters long, must contain only letters, numbers, dashes, and underscores, and must not contain whitespaces, brackets, wildcard characters, or special characters.

--configuration (structure) A list of information about the configuration.

Shorthand Syntax:

Id=string,Revision=integer

JSON Syntax:

{
  "Id": "string",
  "Revision": integer
}

--creator-request-id (string) The unique ID that the requester receives for the created broker. Amazon MQ passes your ID with the API action. Note: We recommend using a Universally Unique Identifier (UUID) for the creatorRequestId. You may omit the creatorRequestId if your application doesn't require idempotency.

--deployment-mode (string) Required. The deployment mode of the broker.

Possible values:

  • SINGLE_INSTANCE
  • ACTIVE_STANDBY_MULTI_AZ

--engine-type (string) Required. The type of broker engine. Note: Currently, Amazon MQ supports only ACTIVEMQ.

Possible values:

  • ACTIVEMQ

--engine-version (string) Required. The version of the broker engine. Note: Currently, Amazon MQ supports only 5.15.6 and 5.15.0.

--host-instance-type (string) Required. The broker's instance type.

--logs (structure) Enables Amazon CloudWatch logging for brokers.

Shorthand Syntax:

Audit=boolean,General=boolean

JSON Syntax:

{
  "Audit": true|false,
  "General": true|false
}

--maintenance-window-start-time (structure) The parameters that determine the WeeklyStartTime.

Shorthand Syntax:

DayOfWeek=string,TimeOfDay=string,TimeZone=string

JSON Syntax:

{
  "DayOfWeek": "MONDAY"|"TUESDAY"|"WEDNESDAY"|"THURSDAY"|"FRIDAY"|"SATURDAY"|"SUNDAY",
  "TimeOfDay": "string",
  "TimeZone": "string"
}

--publicly-accessible | --no-publicly-accessible (boolean) Required. Enables connections from applications outside of the VPC that hosts the broker's subnets.

--security-groups (list) The list of rules (1 minimum, 125 maximum) that authorize connections to brokers.

Syntax:

"string" "string" ...

--subnet-ids (list) The list of groups (2 maximum) that define which subnets and IP ranges the broker can use from different Availability Zones. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ deployment requires two subnets.

Syntax:

"string" "string" ...

--users (list) Required. The list of ActiveMQ users (persons or applications) who can access queues and topics. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.

Shorthand Syntax:

ConsoleAccess=boolean,Groups=string,string,Password=string,Username=string ...

JSON Syntax:

[
  {
    "ConsoleAccess": true|false,
    "Groups": ["string", ...],
    "Password": "string",
    "Username": "string"
  }
  ...
]

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.

Output

BrokerArn -> (string)

The Amazon Resource Name (ARN) of the broker.

BrokerId -> (string)

The unique ID that Amazon MQ generates for the broker.