:doc:`MQ <../../mq>` / Client / create_configuration

********************
create_configuration
********************



.. py:method:: 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 <https://docs.aws.amazon.com/goto/WebAPI/mq-2017-11-27/CreateConfiguration>`_  


  **Request Syntax**
  ::

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

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

    

  
  :type EngineType: string
  :param EngineType: **[REQUIRED]** 

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

    

  
  :type EngineVersion: string
  :param EngineVersion: 

    The broker engine version. Defaults to the latest available version for the specified broker engine type. For more information, see the `ActiveMQ version management <https://docs.aws.amazon.com//amazon-mq/latest/developer-guide/activemq-version-management.html>`__ and the `RabbitMQ version management <https://docs.aws.amazon.com//amazon-mq/latest/developer-guide/rabbitmq-version-management.html>`__ sections in the Amazon MQ Developer Guide.

    

  
  :type Name: string
  :param Name: **[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.

    

  
  :type Tags: dict
  :param Tags: 

    Create tags when creating the configuration.

    

  
    - *(string) --* 

    
      - *(string) --* 

      


  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'Arn': 'string',
          'AuthenticationStrategy': 'SIMPLE'|'LDAP'|'CONFIG_MANAGED',
          '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**
  
  *   :py:class:`MQ.Client.exceptions.BadRequestException`

  
  *   :py:class:`MQ.Client.exceptions.InternalServerErrorException`

  
  *   :py:class:`MQ.Client.exceptions.ConflictException`

  
  *   :py:class:`MQ.Client.exceptions.ForbiddenException`

  