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

***********
create_user
***********



.. py:method:: MQ.Client.create_user(**kwargs)

  

  Creates an ActiveMQ user.

   

  .. warning::

    

    Do not add personally identifiable information (PII) or other confidential or sensitive information in broker usernames. Broker usernames are accessible to other Amazon Web Services services, including CloudWatch Logs. Broker usernames are not intended to be used for private or sensitive data.

    

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/mq-2017-11-27/CreateUser>`_  


  **Request Syntax**
  ::

    response = client.create_user(
        BrokerId='string',
        ConsoleAccess=True|False,
        Groups=[
            'string',
        ],
        Password='string',
        Username='string',
        ReplicationUser=True|False
    )
    
  :type BrokerId: string
  :param BrokerId: **[REQUIRED]** 

    The unique ID that Amazon MQ generates for the broker.

    

  
  :type ConsoleAccess: boolean
  :param ConsoleAccess: 

    Enables access to the ActiveMQ Web Console for the ActiveMQ user.

    

  
  :type Groups: list
  :param Groups: 

    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.

    

  
    - *(string) --* 

    

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

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

    

  
  :type ReplicationUser: boolean
  :param ReplicationUser: 

    Defines if this user is intended for CRDR replication purposes.

    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 

      HTTP Status Code 200: OK.

      
  
  **Exceptions**
  
  *   :py:class:`MQ.Client.exceptions.NotFoundException`

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

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

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

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

  