MQ / Client / create_configuration

create_configuration#

MQ.Client.create_configuration(**kwargs)#

Creates a new configuration for the specified configuration name. Amazon MQ uses the default configuration (the engine type and version).

See also: AWS API Documentation

Request Syntax

response = client.create_configuration(
    AuthenticationStrategy='SIMPLE'|'LDAP',
    EngineType='ACTIVEMQ'|'RABBITMQ',
    EngineVersion='string',
    Name='string',
    Tags={
        'string': 'string'
    }
)
Parameters:

  • AuthenticationStrategy (string) – Optional. The authentication strategy associated with the configuration. The default is SIMPLE.

  • EngineType (string) –

    [REQUIRED]

    Required. The type of broker engine. Currently, Amazon MQ supports ACTIVEMQ and RABBITMQ.

  • EngineVersion (string) –

    [REQUIRED]

    Required. The broker engine’s version. For a list of supported engine versions, see Supported engines.

  • Name (string) –

    [REQUIRED]

    Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long.

  • Tags (dict) –

    Create tags when creating the configuration.

    • (string) –

      • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'Arn': 'string',
    'AuthenticationStrategy': 'SIMPLE'|'LDAP',
    'Created': datetime(2015, 1, 1),
    'Id': 'string',
    'LatestRevision': {
        'Created': datetime(2015, 1, 1),
        'Description': 'string',
        'Revision': 123
    },
    'Name': 'string'
}

Response Structure

  • (dict) –

    HTTP Status Code 200: OK.

    • Arn (string) –

      Required. The Amazon Resource Name (ARN) of the configuration.

    • AuthenticationStrategy (string) –

      Optional. The authentication strategy associated with the configuration. The default is SIMPLE.

    • Created (datetime) –

      Required. The date and time of the configuration.

    • Id (string) –

      Required. The unique ID that Amazon MQ generates for the configuration.

    • LatestRevision (dict) –

      The latest revision of the configuration.

      • Created (datetime) –

        Required. The date and time of the configuration revision.

      • Description (string) –

        The description of the configuration revision.

      • Revision (integer) –

        Required. The revision number of the configuration.

    • Name (string) –

      Required. The name of the configuration. This value can contain only alphanumeric characters, dashes, periods, underscores, and tildes (- . _ ~). This value must be 1-150 characters long.

Exceptions

  • MQ.Client.exceptions.BadRequestException

  • MQ.Client.exceptions.InternalServerErrorException

  • MQ.Client.exceptions.ConflictException

  • MQ.Client.exceptions.ForbiddenException