Module mq

@pulumi/aws > mq

Index

mq/broker.ts mq/configuration.ts mq/getBroker.ts

class Broker

Provides an MQ Broker Resource. This resources also manages users for the broker.

For more information on Amazon MQ, see Amazon MQ documentation.

Changes to an MQ Broker can occur when you change a parameter, such as configuration or user, and are reflected in the next maintenance window. Because of this, Terraform may report a difference in its planning phase because a modification has not yet taken place. You can use the apply_immediately flag to instruct the service to apply the change immediately (see documentation below).

~> Note: using apply_immediately can result in a brief downtime as the broker reboots.

~> Note: All arguments including the username and password will be stored in the raw state as plain-text. Read more about sensitive data in state.

constructor

new Broker(name: string, args: BrokerArgs, opts?: pulumi.CustomResourceOptions)

Create a Broker resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: BrokerState): Broker

Get an existing Broker resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property applyImmediately

public applyImmediately: pulumi.Output<boolean | undefined>;

Specifies whether any broker modifications are applied immediately, or during the next maintenance window. Default is false.

property arn

public arn: pulumi.Output<string>;

The ARN of the broker.

property autoMinorVersionUpgrade

public autoMinorVersionUpgrade: pulumi.Output<boolean | undefined>;

Enables automatic upgrades to new minor versions for brokers, as Apache releases the versions.

property brokerName

public brokerName: pulumi.Output<string>;

The name of the broker.

property configuration

public configuration: pulumi.Output<{ ... }>;

Configuration of the broker. See below.

property deploymentMode

public deploymentMode: pulumi.Output<string | undefined>;

The deployment mode of the broker. Supported: SINGLE_INSTANCE and ACTIVE_STANDBY_MULTI_AZ. Defaults to SINGLE_INSTANCE.

property engineType

public engineType: pulumi.Output<string>;

The type of broker engine. Currently, Amazon MQ supports only ActiveMQ.

property engineVersion

public engineVersion: pulumi.Output<string>;

The version of the broker engine. Currently, Amazon MQ supports only 5.15.0 or 5.15.6.

property hostInstanceType

public hostInstanceType: pulumi.Output<string>;

The broker’s instance type. e.g. mq.t2.micro or mq.m4.large

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property instances

public instances: pulumi.Output<{ ... }[]>;

A list of information about allocated brokers (both active & standby).

  • instances.0.console_url - The URL of the broker’s ActiveMQ Web Console.
  • instances.0.ip_address - The IP Address of the broker.
  • instances.0.endpoints - The broker’s wire-level protocol endpoints in the following order & format referenceable e.g. as instances.0.endpoints.0 (SSL):
  • ssl://broker-id.mq.us-west-2.amazonaws.com:61617
  • amqp+ssl://broker-id.mq.us-west-2.amazonaws.com:5671
  • stomp+ssl://broker-id.mq.us-west-2.amazonaws.com:61614
  • mqtt+ssl://broker-id.mq.us-west-2.amazonaws.com:8883
  • wss://broker-id.mq.us-west-2.amazonaws.com:61619

property logs

public logs: pulumi.Output<{ ... } | undefined>;

Logging configuration of the broker. See below.

property maintenanceWindowStartTime

public maintenanceWindowStartTime: pulumi.Output<{ ... }>;

Maintenance window start time. See below.

property publiclyAccessible

public publiclyAccessible: pulumi.Output<boolean | undefined>;

Whether to enable connections from applications outside of the VPC that hosts the broker’s subnets.

property securityGroups

public securityGroups: pulumi.Output<string[]>;

The list of security group IDs assigned to the broker.

property subnetIds

public subnetIds: pulumi.Output<string[]>;

The list of subnet IDs in which to launch the broker. A SINGLE_INSTANCE deployment requires one subnet. An ACTIVE_STANDBY_MULTI_AZ deployment requires two subnets.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

property users

public users: pulumi.Output<{ ... }[]>;

The list of all ActiveMQ usernames for the specified broker. See below.

class Configuration

Provides an MQ Configuration Resource.

For more information on Amazon MQ, see Amazon MQ documentation.

constructor

new Configuration(name: string, args: ConfigurationArgs, opts?: pulumi.CustomResourceOptions)

Create a Configuration resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: ConfigurationState): Configuration

Get an existing Configuration resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

The ARN of the configuration.

property data

public data: pulumi.Output<string>;

The broker configuration in XML format. See official docs for supported parameters and format of the XML.

property description

public description: pulumi.Output<string | undefined>;

The description of the configuration.

property engineType

public engineType: pulumi.Output<string>;

The type of broker engine.

property engineVersion

public engineVersion: pulumi.Output<string>;

The version of the broker engine.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property latestRevision

public latestRevision: pulumi.Output<number>;

The latest revision of the configuration.

property name

public name: pulumi.Output<string>;

The name of the configuration

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

function getBroker

getBroker(args?: GetBrokerArgs, opts?: pulumi.InvokeOptions): Promise<GetBrokerResult>

Provides information about a MQ Broker.

interface BrokerArgs

The set of arguments for constructing a Broker resource.

property applyImmediately

applyImmediately?: pulumi.Input<boolean>;

Specifies whether any broker modifications are applied immediately, or during the next maintenance window. Default is false.

property autoMinorVersionUpgrade

autoMinorVersionUpgrade?: pulumi.Input<boolean>;

Enables automatic upgrades to new minor versions for brokers, as Apache releases the versions.

property brokerName

brokerName: pulumi.Input<string>;

The name of the broker.

property configuration

configuration?: pulumi.Input<{ ... }>;

Configuration of the broker. See below.

property deploymentMode

deploymentMode?: pulumi.Input<string>;

The deployment mode of the broker. Supported: SINGLE_INSTANCE and ACTIVE_STANDBY_MULTI_AZ. Defaults to SINGLE_INSTANCE.

property engineType

engineType: pulumi.Input<string>;

The type of broker engine. Currently, Amazon MQ supports only ActiveMQ.

property engineVersion

engineVersion: pulumi.Input<string>;

The version of the broker engine. Currently, Amazon MQ supports only 5.15.0 or 5.15.6.

property hostInstanceType

hostInstanceType: pulumi.Input<string>;

The broker’s instance type. e.g. mq.t2.micro or mq.m4.large

property logs

logs?: pulumi.Input<{ ... }>;

Logging configuration of the broker. See below.

property maintenanceWindowStartTime

maintenanceWindowStartTime?: pulumi.Input<{ ... }>;

Maintenance window start time. See below.

property publiclyAccessible

publiclyAccessible?: pulumi.Input<boolean>;

Whether to enable connections from applications outside of the VPC that hosts the broker’s subnets.

property securityGroups

securityGroups: pulumi.Input<pulumi.Input<string>[]>;

The list of security group IDs assigned to the broker.

property subnetIds

subnetIds?: pulumi.Input<pulumi.Input<string>[]>;

The list of subnet IDs in which to launch the broker. A SINGLE_INSTANCE deployment requires one subnet. An ACTIVE_STANDBY_MULTI_AZ deployment requires two subnets.

property users

users: pulumi.Input<pulumi.Input<{ ... }>[]>;

The list of all ActiveMQ usernames for the specified broker. See below.

interface BrokerState

Input properties used for looking up and filtering Broker resources.

property applyImmediately

applyImmediately?: pulumi.Input<boolean>;

Specifies whether any broker modifications are applied immediately, or during the next maintenance window. Default is false.

property arn

arn?: pulumi.Input<string>;

The ARN of the broker.

property autoMinorVersionUpgrade

autoMinorVersionUpgrade?: pulumi.Input<boolean>;

Enables automatic upgrades to new minor versions for brokers, as Apache releases the versions.

property brokerName

brokerName?: pulumi.Input<string>;

The name of the broker.

property configuration

configuration?: pulumi.Input<{ ... }>;

Configuration of the broker. See below.

property deploymentMode

deploymentMode?: pulumi.Input<string>;

The deployment mode of the broker. Supported: SINGLE_INSTANCE and ACTIVE_STANDBY_MULTI_AZ. Defaults to SINGLE_INSTANCE.

property engineType

engineType?: pulumi.Input<string>;

The type of broker engine. Currently, Amazon MQ supports only ActiveMQ.

property engineVersion

engineVersion?: pulumi.Input<string>;

The version of the broker engine. Currently, Amazon MQ supports only 5.15.0 or 5.15.6.

property hostInstanceType

hostInstanceType?: pulumi.Input<string>;

The broker’s instance type. e.g. mq.t2.micro or mq.m4.large

property instances

instances?: pulumi.Input<pulumi.Input<{ ... }>[]>;

A list of information about allocated brokers (both active & standby).

  • instances.0.console_url - The URL of the broker’s ActiveMQ Web Console.
  • instances.0.ip_address - The IP Address of the broker.
  • instances.0.endpoints - The broker’s wire-level protocol endpoints in the following order & format referenceable e.g. as instances.0.endpoints.0 (SSL):
  • ssl://broker-id.mq.us-west-2.amazonaws.com:61617
  • amqp+ssl://broker-id.mq.us-west-2.amazonaws.com:5671
  • stomp+ssl://broker-id.mq.us-west-2.amazonaws.com:61614
  • mqtt+ssl://broker-id.mq.us-west-2.amazonaws.com:8883
  • wss://broker-id.mq.us-west-2.amazonaws.com:61619

property logs

logs?: pulumi.Input<{ ... }>;

Logging configuration of the broker. See below.

property maintenanceWindowStartTime

maintenanceWindowStartTime?: pulumi.Input<{ ... }>;

Maintenance window start time. See below.

property publiclyAccessible

publiclyAccessible?: pulumi.Input<boolean>;

Whether to enable connections from applications outside of the VPC that hosts the broker’s subnets.

property securityGroups

securityGroups?: pulumi.Input<pulumi.Input<string>[]>;

The list of security group IDs assigned to the broker.

property subnetIds

subnetIds?: pulumi.Input<pulumi.Input<string>[]>;

The list of subnet IDs in which to launch the broker. A SINGLE_INSTANCE deployment requires one subnet. An ACTIVE_STANDBY_MULTI_AZ deployment requires two subnets.

property users

users?: pulumi.Input<pulumi.Input<{ ... }>[]>;

The list of all ActiveMQ usernames for the specified broker. See below.

interface ConfigurationArgs

The set of arguments for constructing a Configuration resource.

property data

data: pulumi.Input<string>;

The broker configuration in XML format. See official docs for supported parameters and format of the XML.

property description

description?: pulumi.Input<string>;

The description of the configuration.

property engineType

engineType: pulumi.Input<string>;

The type of broker engine.

property engineVersion

engineVersion: pulumi.Input<string>;

The version of the broker engine.

property name

name?: pulumi.Input<string>;

The name of the configuration

interface ConfigurationState

Input properties used for looking up and filtering Configuration resources.

property arn

arn?: pulumi.Input<string>;

The ARN of the configuration.

property data

data?: pulumi.Input<string>;

The broker configuration in XML format. See official docs for supported parameters and format of the XML.

property description

description?: pulumi.Input<string>;

The description of the configuration.

property engineType

engineType?: pulumi.Input<string>;

The type of broker engine.

property engineVersion

engineVersion?: pulumi.Input<string>;

The version of the broker engine.

property latestRevision

latestRevision?: pulumi.Input<number>;

The latest revision of the configuration.

property name

name?: pulumi.Input<string>;

The name of the configuration

interface GetBrokerArgs

A collection of arguments for invoking getBroker.

property brokerId

brokerId?: string;

The unique id of the mq broker.

property brokerName

brokerName?: string;

The unique name of the mq broker.

property logs

logs?: { ... };

interface GetBrokerResult

A collection of values returned by getBroker.

property arn

arn: string;

property autoMinorVersionUpgrade

autoMinorVersionUpgrade: boolean;

property brokerId

brokerId: string;

property brokerName

brokerName: string;

property configuration

configuration: { ... };

property deploymentMode

deploymentMode: string;

property engineType

engineType: string;

property engineVersion

engineVersion: string;

property hostInstanceType

hostInstanceType: string;

property id

id: string;

id is the provider-assigned unique ID for this managed resource.

property instances

instances: { ... }[];

property maintenanceWindowStartTime

maintenanceWindowStartTime: { ... };

property publiclyAccessible

publiclyAccessible: boolean;

property securityGroups

securityGroups: string[];

property subnetIds

subnetIds: string[];

property users

users: { ... }[];