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.

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