openapi: 3.0.0
info:
version: 2017-11-27
x-release: v4
title: AmazonMQ Broker Engine Types Brokers API
description: Amazon MQ is a managed message broker service for Apache ActiveMQ and RabbitMQ that makes it easy to set up and operate message brokers in the cloud. A message broker allows software applications and components to communicate using various programming languages, operating systems, and formal messaging protocols.
x-logo:
url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png
backgroundColor: '#FFFFFF'
termsOfService: https://aws.amazon.com/service-terms/
contact:
name: Mike Ralphson
email: mike.ralphson@gmail.com
url: https://github.com/mermade/aws2openapi
x-twitter: PermittedSoc
license:
name: Apache 2.0 License
url: http://www.apache.org/licenses/
x-providerName: amazonaws.com
x-serviceName: mq
x-aws-signingName: mq
x-origin:
- contentType: application/json
url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/mq-2017-11-27.normal.json
converter:
url: https://github.com/mermade/aws2openapi
version: 1.0.0
x-apisguru-driver: external
x-apiClientRegistration:
url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct
x-apisguru-categories:
- cloud
x-preferred: true
servers:
- url: http://mq.{region}.amazonaws.com
variables:
region:
description: The AWS region
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- us-gov-west-1
- us-gov-east-1
- ca-central-1
- eu-north-1
- eu-west-1
- eu-west-2
- eu-west-3
- eu-central-1
- eu-south-1
- af-south-1
- ap-northeast-1
- ap-northeast-2
- ap-northeast-3
- ap-southeast-1
- ap-southeast-2
- ap-east-1
- ap-south-1
- sa-east-1
- me-south-1
default: us-east-1
description: The AmazonMQ multi-region endpoint
- url: https://mq.{region}.amazonaws.com
variables:
region:
description: The AWS region
enum:
- us-east-1
- us-east-2
- us-west-1
- us-west-2
- us-gov-west-1
- us-gov-east-1
- ca-central-1
- eu-north-1
- eu-west-1
- eu-west-2
- eu-west-3
- eu-central-1
- eu-south-1
- af-south-1
- ap-northeast-1
- ap-northeast-2
- ap-northeast-3
- ap-southeast-1
- ap-southeast-2
- ap-east-1
- ap-south-1
- sa-east-1
- me-south-1
default: us-east-1
description: The AmazonMQ multi-region endpoint
- url: http://mq.{region}.amazonaws.com.cn
variables:
region:
description: The AWS region
enum:
- cn-north-1
- cn-northwest-1
default: cn-north-1
description: The AmazonMQ endpoint for China (Beijing) and China (Ningxia)
- url: https://mq.{region}.amazonaws.com.cn
variables:
region:
description: The AWS region
enum:
- cn-north-1
- cn-northwest-1
default: cn-north-1
description: The AmazonMQ endpoint for China (Beijing) and China (Ningxia)
security:
- hmac: []
tags:
- name: Brokers
paths:
/v1/brokers:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
post:
operationId: CreateBroker
description: '
Creates a broker. Note: This API is asynchronous.
To create a broker, you must either use the AmazonMQFullAccess IAM policy or include the following EC2 permissions in your IAM policy.
ec2:CreateNetworkInterface
This permission is required to allow Amazon MQ to create an elastic network interface (ENI) on behalf of your account.
ec2:CreateNetworkInterfacePermission
This permission is required to attach the ENI to the broker instance.
ec2:DeleteNetworkInterface
ec2:DeleteNetworkInterfacePermission
ec2:DetachNetworkInterface
ec2:DescribeInternetGateways
ec2:DescribeNetworkInterfaces
ec2:DescribeNetworkInterfacePermissions
ec2:DescribeRouteTables
ec2:DescribeSecurityGroups
ec2:DescribeSubnets
ec2:DescribeVpcs
For more information, see Create an IAM User and Get Your AWS Credentials and Never Modify or Delete the Amazon MQ Elastic Network Interface in the Amazon MQ Developer Guide.
'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/CreateBrokerResponse'
examples:
CreateBroker200Example:
summary: Default CreateBroker 200 response
x-microcks-default: true
value:
BrokerArn: arn:aws:service:us-east-1:123456789012:resource/example
BrokerId: id-abc123
'480':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
examples:
CreateBroker480Example:
summary: Default CreateBroker 480 response
x-microcks-default: true
value: {}
'481':
description: UnauthorizedException
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedException'
examples:
CreateBroker481Example:
summary: Default CreateBroker 481 response
x-microcks-default: true
value: {}
'482':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
examples:
CreateBroker482Example:
summary: Default CreateBroker 482 response
x-microcks-default: true
value: {}
'483':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
examples:
CreateBroker483Example:
summary: Default CreateBroker 483 response
x-microcks-default: true
value: {}
'484':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
examples:
CreateBroker484Example:
summary: Default CreateBroker 484 response
x-microcks-default: true
value: {}
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- autoMinorVersionUpgrade
- brokerName
- deploymentMode
- engineType
- engineVersion
- hostInstanceType
- publiclyAccessible
- users
properties:
authenticationStrategy:
description: Optional. The authentication strategy used to secure the broker. The default is SIMPLE.
type: string
enum:
- SIMPLE
- LDAP
autoMinorVersionUpgrade:
description: Enables automatic upgrades to new minor versions for brokers, as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window of the broker or after a manual broker reboot. Set to true by default, if no value is specified.
type: boolean
brokerName:
description: Required. The broker's name. 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 white spaces, brackets, wildcard characters, or special characters.
type: string
configuration:
description: A list of information about the configuration.
Does not apply to RabbitMQ brokers.
type: object
properties:
Id:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: id
description: Required. The unique ID that Amazon MQ generates for the configuration.
Revision:
allOf:
- $ref: '#/components/schemas/__integer'
- xml:
name: revision
description: The revision number of the configuration.
creatorRequestId:
description: '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.'
type: string
deploymentMode:
description: The broker's deployment mode.
type: string
enum:
- SINGLE_INSTANCE
- ACTIVE_STANDBY_MULTI_AZ
- CLUSTER_MULTI_AZ
encryptionOptions:
description: Does not apply to RabbitMQ brokers.
Encryption options for the broker.
type: object
properties:
KmsKeyId:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: kmsKeyId
description: The customer master key (CMK) to use for the AWS Key Management Service (KMS). This key is used to encrypt your data at rest. If not provided, Amazon MQ will use a default CMK to encrypt your data.
UseAwsOwnedKey:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: useAwsOwnedKey
description: Enables the use of an AWS owned CMK using AWS Key Management Service (KMS). Set to true by default, if no value is provided, for example, for RabbitMQ brokers.
engineType:
description: The type of broker engine. Amazon MQ supports ActiveMQ and RabbitMQ.
type: string
enum:
- ACTIVEMQ
- RABBITMQ
engineVersion:
description: Required. The broker engine's version. For a list of supported engine versions, see Supported engines.
type: string
hostInstanceType:
description: Required. The broker's instance type.
type: string
ldapServerMetadata:
description: Optional. The metadata of the LDAP server used to authenticate and authorize connections to the broker.
Does not apply to RabbitMQ brokers.
type: object
properties:
Hosts:
allOf:
- $ref: '#/components/schemas/__listOf__string'
- xml:
name: hosts
description: Specifies the location of the LDAP server such as AWS Directory Service for Microsoft Active Directory . Optional failover server.
RoleBase:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: roleBase
description: "The distinguished name of the node in the directory information tree (DIT) to search for roles or groups. For example, ou=group, ou=corp, dc=corp,\n dc=example, dc=com."
RoleName:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: roleName
description: Specifies the LDAP attribute that identifies the group name attribute in the object returned from the group membership query.
RoleSearchMatching:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: roleSearchMatching
description: The LDAP search filter used to find roles within the roleBase. The distinguished name of the user matched by userSearchMatching is substituted into the {0} placeholder in the search filter. The client's username is substituted into the {1} placeholder. For example, if you set this option to (member=uid={1})for the user janedoe, the search filter becomes (member=uid=janedoe) after string substitution. It matches all role entries that have a member attribute equal to uid=janedoe under the subtree selected by the roleBase.
RoleSearchSubtree:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: roleSearchSubtree
description: The directory search scope for the role. If set to true, scope is to search the entire subtree.
ServiceAccountPassword:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: serviceAccountPassword
description: "Service account password. A service account is an account in your LDAP server that has access to initiate a connection. For example, cn=admin,dc=corp, dc=example,\n dc=com."
ServiceAccountUsername:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: serviceAccountUsername
description: "Service account username. A service account is an account in your LDAP server that has access to initiate a connection. For example, cn=admin,dc=corp, dc=example,\n dc=com."
UserBase:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: userBase
description: "Select a particular subtree of the directory information tree (DIT) to search for user entries. The subtree is specified by a DN, which specifies the base node of the subtree. For example, by setting this option to ou=Users,ou=corp, dc=corp,\n dc=example, dc=com, the search for user entries is restricted to the subtree beneath ou=Users, ou=corp, dc=corp, dc=example, dc=com."
UserRoleName:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: userRoleName
description: Specifies the name of the LDAP attribute for the user group membership.
UserSearchMatching:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: userSearchMatching
description: "The LDAP search filter used to find users within the userBase. The client's username is substituted into the {0} placeholder in the search filter. For example, if this option is set to (uid={0}) and the received username is janedoe, the search filter becomes (uid=janedoe) after string substitution. It will result in matching an entry like uid=janedoe, ou=Users,ou=corp, dc=corp, dc=example,\n dc=com."
UserSearchSubtree:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: userSearchSubtree
description: The directory search scope for the user. If set to true, scope is to search the entire subtree.
logs:
description: The list of information about logs to be enabled for the specified broker.
type: object
properties:
Audit:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: audit
description: Enables audit logging. Every user management action made using JMX or the ActiveMQ Web Console is logged. Does not apply to RabbitMQ brokers.
General:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: general
description: Enables general logging.
maintenanceWindowStartTime:
description: The scheduled time period relative to UTC during which Amazon MQ begins to apply pending updates or patches to the broker.
type: object
properties:
DayOfWeek:
allOf:
- $ref: '#/components/schemas/DayOfWeek'
- xml:
name: dayOfWeek
description: Required. The day of the week.
TimeOfDay:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: timeOfDay
description: Required. The time, in 24-hour format.
TimeZone:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: timeZone
description: The time zone, UTC by default, in either the Country/City format, or the UTC offset format.
publiclyAccessible:
description: Enables connections from applications outside of the VPC that hosts the broker's subnets. Set to false by default, if no value is provided.
type: boolean
securityGroups:
description: The list of rules (1 minimum, 125 maximum) that authorize connections to brokers.
type: array
items:
$ref: '#/components/schemas/__string'
storageType:
description: The broker's storage type.
EFS is not supported for RabbitMQ engine type.
type: string
enum:
- EBS
- EFS
subnetIds:
description: The list of groups that define which subnets and IP ranges the broker can use from different Availability Zones. If you specify more than one subnet, the subnets must be in different Availability Zones. Amazon MQ will not be able to create VPC endpoints for your broker with multiple subnets in the same Availability Zone. A SINGLE_INSTANCE deployment requires one subnet (for example, the default subnet). An ACTIVE_STANDBY_MULTI_AZ Amazon MQ for ActiveMQ deployment requires two subnets. A CLUSTER_MULTI_AZ Amazon MQ for RabbitMQ deployment has no subnet requirements when deployed with public accessibility. Deployment without public accessibility requires at least one subnet.
If you specify subnets in a shared VPC for a RabbitMQ broker, the associated VPC to which the specified subnets belong must be owned by your AWS account. Amazon MQ will not be able to create VPC endpoints in VPCs that are not owned by your AWS account.
type: array
items:
$ref: '#/components/schemas/__string'
tags:
description: Create tags when creating the broker.
type: object
additionalProperties:
$ref: '#/components/schemas/__string'
users:
description: Required. The list of broker 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.
Amazon MQ for RabbitMQ When you create an Amazon MQ for RabbitMQ broker, one and only one administrative user is accepted and created when a broker is first provisioned. All subsequent broker users are created by making RabbitMQ API calls directly to brokers or via the RabbitMQ web console.
type: array
items:
$ref: '#/components/schemas/User'
summary: Amazon MQ Create Broker
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Brokers
get:
operationId: ListBrokers
description: Returns a list of all brokers.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListBrokersResponse'
examples:
ListBrokers200Example:
summary: Default ListBrokers 200 response
x-microcks-default: true
value:
BrokerSummaries: example-value
NextToken: example-value
'480':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
examples:
ListBrokers480Example:
summary: Default ListBrokers 480 response
x-microcks-default: true
value: {}
'481':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
examples:
ListBrokers481Example:
summary: Default ListBrokers 481 response
x-microcks-default: true
value: {}
'482':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
examples:
ListBrokers482Example:
summary: Default ListBrokers 482 response
x-microcks-default: true
value: {}
parameters:
- name: maxResults
in: query
required: false
description: The maximum number of brokers that Amazon MQ can return per page (20 by default). This value must be an integer from 5 to 100.
schema:
type: integer
minimum: 1
maximum: 100
- name: nextToken
in: query
required: false
description: The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty.
schema:
type: string
- name: MaxResults
in: query
schema:
type: string
description: Pagination limit
required: false
- name: NextToken
in: query
schema:
type: string
description: Pagination token
required: false
summary: Amazon MQ List Brokers
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Brokers
/v1/brokers/{broker-id}/users/{username}:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
post:
operationId: CreateUser
description: Creates an ActiveMQ user.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/CreateUserResponse'
examples:
CreateUser200Example:
summary: Default CreateUser 200 response
x-microcks-default: true
value: {}
'480':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
examples:
CreateUser480Example:
summary: Default CreateUser 480 response
x-microcks-default: true
value: {}
'481':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
examples:
CreateUser481Example:
summary: Default CreateUser 481 response
x-microcks-default: true
value: {}
'482':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
examples:
CreateUser482Example:
summary: Default CreateUser 482 response
x-microcks-default: true
value: {}
'483':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
examples:
CreateUser483Example:
summary: Default CreateUser 483 response
x-microcks-default: true
value: {}
'484':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
examples:
CreateUser484Example:
summary: Default CreateUser 484 response
x-microcks-default: true
value: {}
parameters:
- name: broker-id
in: path
required: true
description: The unique ID that Amazon MQ generates for the broker.
schema:
type: string
- name: username
in: path
required: true
description: The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- password
properties:
consoleAccess:
description: Enables access to the ActiveMQ Web Console for the ActiveMQ user.
type: boolean
groups:
description: The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.
type: array
items:
$ref: '#/components/schemas/__string'
password:
description: Required. The password of the user. This value must be at least 12 characters long, must contain at least 4 unique characters, and must not contain commas, colons, or equal signs (,:=).
type: string
summary: Amazon MQ Create User
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Brokers
delete:
operationId: DeleteUser
description: Deletes an ActiveMQ user.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteUserResponse'
examples:
DeleteUser200Example:
summary: Default DeleteUser 200 response
x-microcks-default: true
value: {}
'480':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
examples:
DeleteUser480Example:
summary: Default DeleteUser 480 response
x-microcks-default: true
value: {}
'481':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
examples:
DeleteUser481Example:
summary: Default DeleteUser 481 response
x-microcks-default: true
value: {}
'482':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
examples:
DeleteUser482Example:
summary: Default DeleteUser 482 response
x-microcks-default: true
value: {}
'483':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
examples:
DeleteUser483Example:
summary: Default DeleteUser 483 response
x-microcks-default: true
value: {}
parameters:
- name: broker-id
in: path
required: true
description: The unique ID that Amazon MQ generates for the broker.
schema:
type: string
- name: username
in: path
required: true
description: The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.
schema:
type: string
summary: Amazon MQ Delete User
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Brokers
get:
operationId: DescribeUser
description: Returns information about an ActiveMQ user.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DescribeUserResponse'
examples:
DescribeUser200Example:
summary: Default DescribeUser 200 response
x-microcks-default: true
value:
BrokerId: id-abc123
ConsoleAccess: example-value
Groups: example-value
Pending: example-value
Username: example-resource
'480':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
examples:
DescribeUser480Example:
summary: Default DescribeUser 480 response
x-microcks-default: true
value: {}
'481':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
examples:
DescribeUser481Example:
summary: Default DescribeUser 481 response
x-microcks-default: true
value: {}
'482':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
examples:
DescribeUser482Example:
summary: Default DescribeUser 482 response
x-microcks-default: true
value: {}
'483':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
examples:
DescribeUser483Example:
summary: Default DescribeUser 483 response
x-microcks-default: true
value: {}
parameters:
- name: broker-id
in: path
required: true
description: The unique ID that Amazon MQ generates for the broker.
schema:
type: string
- name: username
in: path
required: true
description: The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.
schema:
type: string
summary: Amazon MQ Describe User
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Brokers
put:
operationId: UpdateUser
description: Updates the information for an ActiveMQ user.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateUserResponse'
examples:
UpdateUser200Example:
summary: Default UpdateUser 200 response
x-microcks-default: true
value: {}
'480':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
examples:
UpdateUser480Example:
summary: Default UpdateUser 480 response
x-microcks-default: true
value: {}
'481':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
examples:
UpdateUser481Example:
summary: Default UpdateUser 481 response
x-microcks-default: true
value: {}
'482':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
examples:
UpdateUser482Example:
summary: Default UpdateUser 482 response
x-microcks-default: true
value: {}
'483':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
examples:
UpdateUser483Example:
summary: Default UpdateUser 483 response
x-microcks-default: true
value: {}
'484':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
examples:
UpdateUser484Example:
summary: Default UpdateUser 484 response
x-microcks-default: true
value: {}
parameters:
- name: broker-id
in: path
required: true
description: The unique ID that Amazon MQ generates for the broker.
schema:
type: string
- name: username
in: path
required: true
description: The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
consoleAccess:
description: Enables access to the the ActiveMQ Web Console for the ActiveMQ user.
type: boolean
groups:
description: The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.
type: array
items:
$ref: '#/components/schemas/__string'
password:
description: The password of the user. This value must be at least 12 characters long, must contain at least 4 unique characters, and must not contain commas, colons, or equal signs (,:=).
type: string
summary: Amazon MQ Update User
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Brokers
/v1/brokers/{broker-id}:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
delete:
operationId: DeleteBroker
description: 'Deletes a broker. Note: This API is asynchronous.'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteBrokerResponse'
examples:
DeleteBroker200Example:
summary: Default DeleteBroker 200 response
x-microcks-default: true
value:
BrokerId: id-abc123
'480':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
examples:
DeleteBroker480Example:
summary: Default DeleteBroker 480 response
x-microcks-default: true
value: {}
'481':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
examples:
DeleteBroker481Example:
summary: Default DeleteBroker 481 response
x-microcks-default: true
value: {}
'482':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
examples:
DeleteBroker482Example:
summary: Default DeleteBroker 482 response
x-microcks-default: true
value: {}
'483':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
examples:
DeleteBroker483Example:
summary: Default DeleteBroker 483 response
x-microcks-default: true
value: {}
parameters:
- name: broker-id
in: path
required: true
description: The unique ID that Amazon MQ generates for the broker.
schema:
type: string
summary: Amazon MQ Delete Broker
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Brokers
get:
operationId: DescribeBroker
description: Returns information about the specified broker.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DescribeBrokerResponse'
examples:
DescribeBroker200Example:
summary: Default DescribeBroker 200 response
x-microcks-default: true
value:
ActionsRequired: example-value
AuthenticationStrategy: example-value
AutoMinorVersionUpgrade: example-value
BrokerArn: arn:aws:service:us-east-1:123456789012:resource/example
BrokerId: id-abc123
'480':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
examples:
DescribeBroker480Example:
summary: Default DescribeBroker 480 response
x-microcks-default: true
value: {}
'481':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
examples:
DescribeBroker481Example:
summary: Default DescribeBroker 481 response
x-microcks-default: true
value: {}
'482':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
examples:
DescribeBroker482Example:
summary: Default DescribeBroker 482 response
x-microcks-default: true
value: {}
'483':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
examples:
DescribeBroker483Example:
summary: Default DescribeBroker 483 response
x-microcks-default: true
value: {}
parameters:
- name: broker-id
in: path
required: true
description: The unique ID that Amazon MQ generates for the broker.
schema:
type: string
summary: Amazon MQ Describe Broker
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Brokers
put:
operationId: UpdateBroker
description: Adds a pending configuration change to a broker.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateBrokerResponse'
examples:
UpdateBroker200Example:
summary: Default UpdateBroker 200 response
x-microcks-default: true
value:
AuthenticationStrategy: example-value
AutoMinorVersionUpgrade: example-value
BrokerId: id-abc123
Configuration: example-value
EngineVersion: example-value
'480':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
examples:
UpdateBroker480Example:
summary: Default UpdateBroker 480 response
x-microcks-default: true
value: {}
'481':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
examples:
UpdateBroker481Example:
summary: Default UpdateBroker 481 response
x-microcks-default: true
value: {}
'482':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
examples:
UpdateBroker482Example:
summary: Default UpdateBroker 482 response
x-microcks-default: true
value: {}
'483':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
examples:
UpdateBroker483Example:
summary: Default UpdateBroker 483 response
x-microcks-default: true
value: {}
'484':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
examples:
UpdateBroker484Example:
summary: Default UpdateBroker 484 response
x-microcks-default: true
value: {}
parameters:
- name: broker-id
in: path
required: true
description: The unique ID that Amazon MQ generates for the broker.
schema:
type: string
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
authenticationStrategy:
description: Optional. The authentication strategy used to secure the broker. The default is SIMPLE.
type: string
enum:
- SIMPLE
- LDAP
autoMinorVersionUpgrade:
description: Enables automatic upgrades to new minor versions for brokers, as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window of the broker or after a manual broker reboot.
type: boolean
configuration:
description: A list of information about the configuration.
Does not apply to RabbitMQ brokers.
type: object
properties:
Id:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: id
description: Required. The unique ID that Amazon MQ generates for the configuration.
Revision:
allOf:
- $ref: '#/components/schemas/__integer'
- xml:
name: revision
description: The revision number of the configuration.
engineVersion:
description: The broker engine version. For a list of supported engine versions, see Supported engines.
type: string
hostInstanceType:
description: The broker's host instance type to upgrade to. For a list of supported instance types, see Broker instance types.
type: string
ldapServerMetadata:
description: Optional. The metadata of the LDAP server used to authenticate and authorize connections to the broker.
Does not apply to RabbitMQ brokers.
type: object
properties:
Hosts:
allOf:
- $ref: '#/components/schemas/__listOf__string'
- xml:
name: hosts
description: Specifies the location of the LDAP server such as AWS Directory Service for Microsoft Active Directory . Optional failover server.
RoleBase:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: roleBase
description: "The distinguished name of the node in the directory information tree (DIT) to search for roles or groups. For example, ou=group, ou=corp, dc=corp,\n dc=example, dc=com."
RoleName:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: roleName
description: Specifies the LDAP attribute that identifies the group name attribute in the object returned from the group membership query.
RoleSearchMatching:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: roleSearchMatching
description: The LDAP search filter used to find roles within the roleBase. The distinguished name of the user matched by userSearchMatching is substituted into the {0} placeholder in the search filter. The client's username is substituted into the {1} placeholder. For example, if you set this option to (member=uid={1})for the user janedoe, the search filter becomes (member=uid=janedoe) after string substitution. It matches all role entries that have a member attribute equal to uid=janedoe under the subtree selected by the roleBase.
RoleSearchSubtree:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: roleSearchSubtree
description: The directory search scope for the role. If set to true, scope is to search the entire subtree.
ServiceAccountPassword:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: serviceAccountPassword
description: "Service account password. A service account is an account in your LDAP server that has access to initiate a connection. For example, cn=admin,dc=corp, dc=example,\n dc=com."
ServiceAccountUsername:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: serviceAccountUsername
description: "Service account username. A service account is an account in your LDAP server that has access to initiate a connection. For example, cn=admin,dc=corp, dc=example,\n dc=com."
UserBase:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: userBase
description: "Select a particular subtree of the directory information tree (DIT) to search for user entries. The subtree is specified by a DN, which specifies the base node of the subtree. For example, by setting this option to ou=Users,ou=corp, dc=corp,\n dc=example, dc=com, the search for user entries is restricted to the subtree beneath ou=Users, ou=corp, dc=corp, dc=example, dc=com."
UserRoleName:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: userRoleName
description: Specifies the name of the LDAP attribute for the user group membership.
UserSearchMatching:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: userSearchMatching
description: "The LDAP search filter used to find users within the userBase. The client's username is substituted into the {0} placeholder in the search filter. For example, if this option is set to (uid={0}) and the received username is janedoe, the search filter becomes (uid=janedoe) after string substitution. It will result in matching an entry like uid=janedoe, ou=Users,ou=corp, dc=corp, dc=example,\n dc=com."
UserSearchSubtree:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: userSearchSubtree
description: The directory search scope for the user. If set to true, scope is to search the entire subtree.
logs:
description: The list of information about logs to be enabled for the specified broker.
type: object
properties:
Audit:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: audit
description: Enables audit logging. Every user management action made using JMX or the ActiveMQ Web Console is logged. Does not apply to RabbitMQ brokers.
General:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: general
description: Enables general logging.
maintenanceWindowStartTime:
description: The scheduled time period relative to UTC during which Amazon MQ begins to apply pending updates or patches to the broker.
type: object
properties:
DayOfWeek:
allOf:
- $ref: '#/components/schemas/DayOfWeek'
- xml:
name: dayOfWeek
description: Required. The day of the week.
TimeOfDay:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: timeOfDay
description: Required. The time, in 24-hour format.
TimeZone:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: timeZone
description: The time zone, UTC by default, in either the Country/City format, or the UTC offset format.
securityGroups:
description: The list of security groups (1 minimum, 5 maximum) that authorizes connections to brokers.
type: array
items:
$ref: '#/components/schemas/__string'
summary: Amazon MQ Update Broker
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Brokers
/v1/brokers/{broker-id}/users:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
get:
operationId: ListUsers
description: Returns a list of all ActiveMQ users.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListUsersResponse'
examples:
ListUsers200Example:
summary: Default ListUsers 200 response
x-microcks-default: true
value:
BrokerId: id-abc123
MaxResults: example-value
NextToken: example-value
Users: example-value
'480':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
examples:
ListUsers480Example:
summary: Default ListUsers 480 response
x-microcks-default: true
value: {}
'481':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
examples:
ListUsers481Example:
summary: Default ListUsers 481 response
x-microcks-default: true
value: {}
'482':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
examples:
ListUsers482Example:
summary: Default ListUsers 482 response
x-microcks-default: true
value: {}
'483':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
examples:
ListUsers483Example:
summary: Default ListUsers 483 response
x-microcks-default: true
value: {}
parameters:
- name: broker-id
in: path
required: true
description: The unique ID that Amazon MQ generates for the broker.
schema:
type: string
- name: maxResults
in: query
required: false
description: The maximum number of brokers that Amazon MQ can return per page (20 by default). This value must be an integer from 5 to 100.
schema:
type: integer
minimum: 1
maximum: 100
- name: nextToken
in: query
required: false
description: The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty.
schema:
type: string
summary: Amazon MQ List Users
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Brokers
/v1/brokers/{broker-id}/reboot:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
post:
operationId: RebootBroker
description: 'Reboots a broker. Note: This API is asynchronous.'
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/RebootBrokerResponse'
examples:
RebootBroker200Example:
summary: Default RebootBroker 200 response
x-microcks-default: true
value: {}
'480':
description: NotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundException'
examples:
RebootBroker480Example:
summary: Default RebootBroker 480 response
x-microcks-default: true
value: {}
'481':
description: BadRequestException
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestException'
examples:
RebootBroker481Example:
summary: Default RebootBroker 481 response
x-microcks-default: true
value: {}
'482':
description: InternalServerErrorException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerErrorException'
examples:
RebootBroker482Example:
summary: Default RebootBroker 482 response
x-microcks-default: true
value: {}
'483':
description: ForbiddenException
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenException'
examples:
RebootBroker483Example:
summary: Default RebootBroker 483 response
x-microcks-default: true
value: {}
parameters:
- name: broker-id
in: path
required: true
description: The unique ID that Amazon MQ generates for the broker.
schema:
type: string
summary: Amazon MQ Reboot Broker
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Brokers
components:
schemas:
__string:
type: string
Configurations:
type: object
properties:
Current:
allOf:
- $ref: '#/components/schemas/ConfigurationId'
- xml:
name: current
description: The broker's current configuration.
History:
allOf:
- $ref: '#/components/schemas/__listOfConfigurationId'
- xml:
name: history
description: The history of configurations applied to the broker.
Pending:
allOf:
- $ref: '#/components/schemas/ConfigurationId'
- xml:
name: pending
description: The broker's pending configuration.
description: Broker configuration information
__listOfUserSummary:
type: array
items:
$ref: '#/components/schemas/UserSummary'
__timestampIso8601:
type: string
format: date-time
DeleteBrokerResponse:
type: object
properties:
BrokerId:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: brokerId
description: The unique ID that Amazon MQ generates for the broker.
ConfigurationId:
type: object
required:
- Id
properties:
Id:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: id
description: Required. The unique ID that Amazon MQ generates for the configuration.
Revision:
allOf:
- $ref: '#/components/schemas/__integer'
- xml:
name: revision
description: The revision number of the configuration.
description: A list of information about the configuration.
Does not apply to RabbitMQ brokers.
__integerMin5Max100:
type: integer
minimum: 5
maximum: 100
BadRequestException: {}
UpdateUserResponse:
type: object
properties: {}
__listOfActionRequired:
type: array
items:
$ref: '#/components/schemas/ActionRequired'
PendingLogs:
type: object
properties:
Audit:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: audit
description: Enables audit logging. Every user management action made using JMX or the ActiveMQ Web Console is logged.
General:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: general
description: Enables general logging.
description: The list of information about logs to be enabled for the specified broker.
UserSummary:
type: object
required:
- Username
properties:
PendingChange:
allOf:
- $ref: '#/components/schemas/ChangeType'
- xml:
name: pendingChange
description: The type of change pending for the broker user.
Username:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: username
description: Required. The username of the broker user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.
description: Returns a list of all broker users. Does not apply to RabbitMQ brokers.
DeploymentMode:
type: string
enum:
- SINGLE_INSTANCE
- ACTIVE_STANDBY_MULTI_AZ
- CLUSTER_MULTI_AZ
description: The broker's deployment mode.
RebootBrokerResponse:
type: object
properties: {}
NotFoundException: {}
__listOfBrokerInstance:
type: array
items:
$ref: '#/components/schemas/BrokerInstance'
BrokerInstance:
type: object
properties:
ConsoleURL:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: consoleURL
description: The brokers web console URL.
Endpoints:
allOf:
- $ref: '#/components/schemas/__listOf__string'
- xml:
name: endpoints
description: The broker's wire-level protocol endpoints.
IpAddress:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: ipAddress
description: The IP address of the Elastic Network Interface (ENI) attached to the broker. Does not apply to RabbitMQ brokers.
description: Returns information about all brokers.
__listOfConfigurationId:
type: array
items:
$ref: '#/components/schemas/ConfigurationId'
LdapServerMetadataOutput:
type: object
required:
- Hosts
- UserSearchMatching
- UserBase
- RoleSearchMatching
- ServiceAccountUsername
- RoleBase
properties:
Hosts:
allOf:
- $ref: '#/components/schemas/__listOf__string'
- xml:
name: hosts
description: Specifies the location of the LDAP server such as AWS Directory Service for Microsoft Active Directory . Optional failover server.
RoleBase:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: roleBase
description: "The distinguished name of the node in the directory information tree (DIT) to search for roles or groups. For example, ou=group, ou=corp, dc=corp,\n dc=example, dc=com."
RoleName:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: roleName
description: Specifies the LDAP attribute that identifies the group name attribute in the object returned from the group membership query.
RoleSearchMatching:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: roleSearchMatching
description: The LDAP search filter used to find roles within the roleBase. The distinguished name of the user matched by userSearchMatching is substituted into the {0} placeholder in the search filter. The client's username is substituted into the {1} placeholder. For example, if you set this option to (member=uid={1})for the user janedoe, the search filter becomes (member=uid=janedoe) after string substitution. It matches all role entries that have a member attribute equal to uid=janedoe under the subtree selected by the roleBase.
RoleSearchSubtree:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: roleSearchSubtree
description: The directory search scope for the role. If set to true, scope is to search the entire subtree.
ServiceAccountUsername:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: serviceAccountUsername
description: "Service account username. A service account is an account in your LDAP server that has access to initiate a connection. For example, cn=admin,dc=corp, dc=example,\n dc=com."
UserBase:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: userBase
description: "Select a particular subtree of the directory information tree (DIT) to search for user entries. The subtree is specified by a DN, which specifies the base node of the subtree. For example, by setting this option to ou=Users,ou=corp, dc=corp,\n dc=example, dc=com, the search for user entries is restricted to the subtree beneath ou=Users, ou=corp, dc=corp, dc=example, dc=com."
UserRoleName:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: userRoleName
description: Specifies the name of the LDAP attribute for the user group membership.
UserSearchMatching:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: userSearchMatching
description: "The LDAP search filter used to find users within the userBase. The client's username is substituted into the {0} placeholder in the search filter. For example, if this option is set to (uid={0}) and the received username is janedoe, the search filter becomes (uid=janedoe) after string substitution. It will result in matching an entry like uid=janedoe, ou=Users,ou=corp, dc=corp, dc=example,\n dc=com."
UserSearchSubtree:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: userSearchSubtree
description: The directory search scope for the user. If set to true, scope is to search the entire subtree.
description: Optional. The metadata of the LDAP server used to authenticate and authorize connections to the broker.
CreateUserResponse:
type: object
properties: {}
__mapOf__string:
type: object
additionalProperties:
$ref: '#/components/schemas/__string'
ActionRequired:
type: object
properties:
ActionRequiredCode:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: actionRequiredCode
description: The code you can use to resolve your broker issue when the broker is in a CRITICAL_ACTION_REQUIRED state. You can find instructions by choosing the link for your code from the list of action required codes in Amazon MQ action required codes. Each code references a topic with detailed information, instructions, and recommendations for how to resolve the issue and prevent future occurrences.
ActionRequiredInfo:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: actionRequiredInfo
description: Information about the action required to resolve your broker issue when the broker is in a CRITICAL_ACTION_REQUIRED state.
description: The action required to resolve a broker issue when the broker is in a CRITICAL_ACTION_REQUIRED state.
EncryptionOptions:
type: object
required:
- UseAwsOwnedKey
properties:
KmsKeyId:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: kmsKeyId
description: The customer master key (CMK) to use for the AWS Key Management Service (KMS). This key is used to encrypt your data at rest. If not provided, Amazon MQ will use a default CMK to encrypt your data.
UseAwsOwnedKey:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: useAwsOwnedKey
description: Enables the use of an AWS owned CMK using AWS Key Management Service (KMS). Set to true by default, if no value is provided, for example, for RabbitMQ brokers.
description: Does not apply to RabbitMQ brokers.
Encryption options for the broker.
UpdateBrokerResponse:
type: object
properties:
AuthenticationStrategy:
allOf:
- $ref: '#/components/schemas/AuthenticationStrategy'
- xml:
name: authenticationStrategy
description: Optional. The authentication strategy used to secure the broker. The default is SIMPLE.
AutoMinorVersionUpgrade:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: autoMinorVersionUpgrade
description: The new boolean value that specifies whether broker engines automatically upgrade to new minor versions as new versions are released and supported by Amazon MQ.
BrokerId:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: brokerId
description: Required. The unique ID that Amazon MQ generates for the broker.
Configuration:
allOf:
- $ref: '#/components/schemas/ConfigurationId'
- xml:
name: configuration
description: The ID of the updated configuration.
EngineVersion:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: engineVersion
description: The broker engine version to upgrade to. For a list of supported engine versions, see Supported engines.
HostInstanceType:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: hostInstanceType
description: The broker's host instance type to upgrade to. For a list of supported instance types, see Broker instance types.
LdapServerMetadata:
allOf:
- $ref: '#/components/schemas/LdapServerMetadataOutput'
- xml:
name: ldapServerMetadata
description: Optional. The metadata of the LDAP server used to authenticate and authorize connections to the broker. Does not apply to RabbitMQ brokers.
Logs:
allOf:
- $ref: '#/components/schemas/Logs'
- xml:
name: logs
description: The list of information about logs to be enabled for the specified broker.
MaintenanceWindowStartTime:
allOf:
- $ref: '#/components/schemas/WeeklyStartTime'
- xml:
name: maintenanceWindowStartTime
description: The parameters that determine the WeeklyStartTime.
SecurityGroups:
allOf:
- $ref: '#/components/schemas/__listOf__string'
- xml:
name: securityGroups
description: The list of security groups (1 minimum, 5 maximum) that authorizes connections to brokers.
DeleteUserResponse:
type: object
properties: {}
UnauthorizedException: {}
UserPendingChanges:
type: object
required:
- PendingChange
properties:
ConsoleAccess:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: consoleAccess
description: Enables access to the the ActiveMQ Web Console for the ActiveMQ user.
Groups:
allOf:
- $ref: '#/components/schemas/__listOf__string'
- xml:
name: groups
description: The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.
PendingChange:
allOf:
- $ref: '#/components/schemas/ChangeType'
- xml:
name: pendingChange
description: Required. The type of change pending for the ActiveMQ user.
description: Returns information about the status of the changes pending for the ActiveMQ user.
__listOfBrokerSummary:
type: array
items:
$ref: '#/components/schemas/BrokerSummary'
DescribeBrokerResponse:
type: object
properties:
ActionsRequired:
allOf:
- $ref: '#/components/schemas/__listOfActionRequired'
- xml:
name: actionsRequired
description: A list of actions required for a broker.
AuthenticationStrategy:
allOf:
- $ref: '#/components/schemas/AuthenticationStrategy'
- xml:
name: authenticationStrategy
description: The authentication strategy used to secure the broker. The default is SIMPLE.
AutoMinorVersionUpgrade:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: autoMinorVersionUpgrade
description: Enables automatic upgrades to new minor versions for brokers, as new versions are released and supported by Amazon MQ. Automatic upgrades occur during the scheduled maintenance window of the broker or after a manual broker reboot.
BrokerArn:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: brokerArn
description: The broker's Amazon Resource Name (ARN).
BrokerId:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: brokerId
description: The unique ID that Amazon MQ generates for the broker.
BrokerInstances:
allOf:
- $ref: '#/components/schemas/__listOfBrokerInstance'
- xml:
name: brokerInstances
description: A list of information about allocated brokers.
BrokerName:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: brokerName
description: The broker's name. 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 white spaces, brackets, wildcard characters, or special characters.
BrokerState:
allOf:
- $ref: '#/components/schemas/BrokerState'
- xml:
name: brokerState
description: The broker's status.
Configurations:
allOf:
- $ref: '#/components/schemas/Configurations'
- xml:
name: configurations
description: The list of all revisions for the specified configuration.
Created:
allOf:
- $ref: '#/components/schemas/__timestampIso8601'
- xml:
name: created
description: The time when the broker was created.
DeploymentMode:
allOf:
- $ref: '#/components/schemas/DeploymentMode'
- xml:
name: deploymentMode
description: The broker's deployment mode.
EncryptionOptions:
allOf:
- $ref: '#/components/schemas/EncryptionOptions'
- xml:
name: encryptionOptions
description: Encryption options for the broker. Does not apply to RabbitMQ brokers.
EngineType:
allOf:
- $ref: '#/components/schemas/EngineType'
- xml:
name: engineType
description: The type of broker engine. Currently, Amazon MQ supports ACTIVEMQ and RABBITMQ.
EngineVersion:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: engineVersion
description: The broker engine's version. For a list of supported engine versions, see Supported engines.
HostInstanceType:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: hostInstanceType
description: The broker's instance type.
LdapServerMetadata:
allOf:
- $ref: '#/components/schemas/LdapServerMetadataOutput'
- xml:
name: ldapServerMetadata
description: The metadata of the LDAP server used to authenticate and authorize connections to the broker.
Logs:
allOf:
- $ref: '#/components/schemas/LogsSummary'
- xml:
name: logs
description: The list of information about logs currently enabled and pending to be deployed for the specified broker.
MaintenanceWindowStartTime:
allOf:
- $ref: '#/components/schemas/WeeklyStartTime'
- xml:
name: maintenanceWindowStartTime
description: The parameters that determine the WeeklyStartTime.
PendingAuthenticationStrategy:
allOf:
- $ref: '#/components/schemas/AuthenticationStrategy'
- xml:
name: pendingAuthenticationStrategy
description: The authentication strategy that will be applied when the broker is rebooted. The default is SIMPLE.
PendingEngineVersion:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: pendingEngineVersion
description: The broker engine version to upgrade to. For a list of supported engine versions, see Supported engines.
PendingHostInstanceType:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: pendingHostInstanceType
description: The broker's host instance type to upgrade to. For a list of supported instance types, see Broker instance types.
PendingLdapServerMetadata:
allOf:
- $ref: '#/components/schemas/LdapServerMetadataOutput'
- xml:
name: pendingLdapServerMetadata
description: The metadata of the LDAP server that will be used to authenticate and authorize connections to the broker after it is rebooted.
PendingSecurityGroups:
allOf:
- $ref: '#/components/schemas/__listOf__string'
- xml:
name: pendingSecurityGroups
description: The list of pending security groups to authorize connections to brokers.
PubliclyAccessible:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: publiclyAccessible
description: Enables connections from applications outside of the VPC that hosts the broker's subnets.
SecurityGroups:
allOf:
- $ref: '#/components/schemas/__listOf__string'
- xml:
name: securityGroups
description: The list of rules (1 minimum, 125 maximum) that authorize connections to brokers.
StorageType:
allOf:
- $ref: '#/components/schemas/BrokerStorageType'
- xml:
name: storageType
description: The broker's storage type.
SubnetIds:
allOf:
- $ref: '#/components/schemas/__listOf__string'
- xml:
name: subnetIds
description: The list of groups that define which subnets and IP ranges the broker can use from different Availability Zones.
Tags:
allOf:
- $ref: '#/components/schemas/__mapOf__string'
- xml:
name: tags
description: The list of all tags associated with this broker.
Users:
allOf:
- $ref: '#/components/schemas/__listOfUserSummary'
- xml:
name: users
description: The list of all broker usernames for the specified broker.
__listOf__string:
type: array
items:
$ref: '#/components/schemas/__string'
CreateBrokerResponse:
type: object
properties:
BrokerArn:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: brokerArn
description: The broker's Amazon Resource Name (ARN).
BrokerId:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: brokerId
description: The unique ID that Amazon MQ generates for the broker.
ForbiddenException: {}
InternalServerErrorException: {}
BrokerState:
type: string
enum:
- CREATION_IN_PROGRESS
- CREATION_FAILED
- DELETION_IN_PROGRESS
- RUNNING
- REBOOT_IN_PROGRESS
- CRITICAL_ACTION_REQUIRED
description: The broker's status.
BrokerStorageType:
type: string
enum:
- EBS
- EFS
description: The broker's storage type.
EFS is not supported for RabbitMQ engine type.
Logs:
type: object
properties:
Audit:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: audit
description: Enables audit logging. Every user management action made using JMX or the ActiveMQ Web Console is logged. Does not apply to RabbitMQ brokers.
General:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: general
description: Enables general logging.
description: The list of information about logs to be enabled for the specified broker.
LogsSummary:
type: object
required:
- GeneralLogGroup
- General
properties:
Audit:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: audit
description: Enables audit logging. Every user management action made using JMX or the ActiveMQ Web Console is logged.
AuditLogGroup:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: auditLogGroup
description: The location of the CloudWatch Logs log group where audit logs are sent.
General:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: general
description: Enables general logging.
GeneralLogGroup:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: generalLogGroup
description: The location of the CloudWatch Logs log group where general logs are sent.
Pending:
allOf:
- $ref: '#/components/schemas/PendingLogs'
- xml:
name: pending
description: The list of information about logs pending to be deployed for the specified broker.
description: The list of information about logs currently enabled and pending to be deployed for the specified broker.
__boolean:
type: boolean
ConflictException: {}
WeeklyStartTime:
type: object
required:
- TimeOfDay
- DayOfWeek
properties:
DayOfWeek:
allOf:
- $ref: '#/components/schemas/DayOfWeek'
- xml:
name: dayOfWeek
description: Required. The day of the week.
TimeOfDay:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: timeOfDay
description: Required. The time, in 24-hour format.
TimeZone:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: timeZone
description: The time zone, UTC by default, in either the Country/City format, or the UTC offset format.
description: The scheduled time period relative to UTC during which Amazon MQ begins to apply pending updates or patches to the broker.
__integer:
type: integer
User:
type: object
required:
- Username
- Password
properties:
ConsoleAccess:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: consoleAccess
description: Enables access to the ActiveMQ Web Console for the ActiveMQ user. Does not apply to RabbitMQ brokers.
Groups:
allOf:
- $ref: '#/components/schemas/__listOf__string'
- xml:
name: groups
description: The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long. Does not apply to RabbitMQ brokers.
Password:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: password
description: Required. The password of the user. This value must be at least 12 characters long, must contain at least 4 unique characters, and must not contain commas, colons, or equal signs (,:=).
Username:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: username
description: important>
Amazon MQ for ActiveMQ For ActiveMQ brokers, this value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long./important> Amazon MQ for RabbitMQ For RabbitMQ brokers, this value can contain only alphanumeric characters, dashes, periods, underscores (- . _). This value must not contain a tilde (~) character. Amazon MQ prohibts using guest as a valid usename. This value must be 2-100 characters long.
description: A user associated with the broker. For RabbitMQ brokers, one and only one administrative user is accepted and created when a broker is first provisioned. All subsequent broker users are created by making RabbitMQ API calls directly to brokers or via the RabbitMQ web console.
ChangeType:
type: string
enum:
- CREATE
- UPDATE
- DELETE
description: The type of change pending for the ActiveMQ user.
ListUsersResponse:
type: object
properties:
BrokerId:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: brokerId
description: Required. The unique ID that Amazon MQ generates for the broker.
MaxResults:
allOf:
- $ref: '#/components/schemas/__integerMin5Max100'
- xml:
name: maxResults
description: Required. The maximum number of ActiveMQ users that can be returned per page (20 by default). This value must be an integer from 5 to 100.
NextToken:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: nextToken
description: The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty.
Users:
allOf:
- $ref: '#/components/schemas/__listOfUserSummary'
- xml:
name: users
description: Required. The list of all ActiveMQ usernames for the specified broker. Does not apply to RabbitMQ brokers.
BrokerSummary:
type: object
required:
- DeploymentMode
- EngineType
properties:
BrokerArn:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: brokerArn
description: The broker's Amazon Resource Name (ARN).
BrokerId:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: brokerId
description: The unique ID that Amazon MQ generates for the broker.
BrokerName:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: brokerName
description: The broker's name. This value is unique in your AWS account, 1-50 characters long, and containing only letters, numbers, dashes, and underscores, and must not contain white spaces, brackets, wildcard characters, or special characters.
BrokerState:
allOf:
- $ref: '#/components/schemas/BrokerState'
- xml:
name: brokerState
description: The broker's status.
Created:
allOf:
- $ref: '#/components/schemas/__timestampIso8601'
- xml:
name: created
description: The time when the broker was created.
DeploymentMode:
allOf:
- $ref: '#/components/schemas/DeploymentMode'
- xml:
name: deploymentMode
description: The broker's deployment mode.
EngineType:
allOf:
- $ref: '#/components/schemas/EngineType'
- xml:
name: engineType
description: The type of broker engine.
HostInstanceType:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: hostInstanceType
description: The broker's instance type.
description: Returns information about all brokers.
DayOfWeek:
type: string
enum:
- MONDAY
- TUESDAY
- WEDNESDAY
- THURSDAY
- FRIDAY
- SATURDAY
- SUNDAY
ListBrokersResponse:
type: object
properties:
BrokerSummaries:
allOf:
- $ref: '#/components/schemas/__listOfBrokerSummary'
- xml:
name: brokerSummaries
description: A list of information about all brokers.
NextToken:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: nextToken
description: The token that specifies the next page of results Amazon MQ should return. To request the first page, leave nextToken empty.
EngineType:
type: string
enum:
- ACTIVEMQ
- RABBITMQ
description: The type of broker engine. Amazon MQ supports ActiveMQ and RabbitMQ.
AuthenticationStrategy:
type: string
enum:
- SIMPLE
- LDAP
description: Optional. The authentication strategy used to secure the broker. The default is SIMPLE.
DescribeUserResponse:
type: object
properties:
BrokerId:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: brokerId
description: Required. The unique ID that Amazon MQ generates for the broker.
ConsoleAccess:
allOf:
- $ref: '#/components/schemas/__boolean'
- xml:
name: consoleAccess
description: Enables access to the the ActiveMQ Web Console for the ActiveMQ user.
Groups:
allOf:
- $ref: '#/components/schemas/__listOf__string'
- xml:
name: groups
description: The list of groups (20 maximum) to which the ActiveMQ user belongs. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.
Pending:
allOf:
- $ref: '#/components/schemas/UserPendingChanges'
- xml:
name: pending
description: The status of the changes pending for the ActiveMQ user.
Username:
allOf:
- $ref: '#/components/schemas/__string'
- xml:
name: username
description: Required. The username of the ActiveMQ user. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 2-100 characters long.
parameters:
X-Amz-Content-Sha256:
name: X-Amz-Content-Sha256
in: header
schema:
type: string
required: false
X-Amz-Algorithm:
name: X-Amz-Algorithm
in: header
schema:
type: string
required: false
X-Amz-Credential:
name: X-Amz-Credential
in: header
schema:
type: string
required: false
X-Amz-Security-Token:
name: X-Amz-Security-Token
in: header
schema:
type: string
required: false
X-Amz-Signature:
name: X-Amz-Signature
in: header
schema:
type: string
required: false
X-Amz-Date:
name: X-Amz-Date
in: header
schema:
type: string
required: false
X-Amz-SignedHeaders:
name: X-Amz-SignedHeaders
in: header
schema:
type: string
required: false
securitySchemes:
hmac:
type: apiKey
name: Authorization
in: header
description: Amazon Signature authorization v4
x-amazon-apigateway-authtype: awsSigv4
externalDocs:
description: Amazon Web Services documentation
url: https://docs.aws.amazon.com/mq/
x-hasEquivalentPaths: true