:doc:`MemoryDB <../../memorydb>` / Client / create_acl

**********
create_acl
**********



.. py:method:: MemoryDB.Client.create_acl(**kwargs)

  

  Creates an Access Control List. For more information, see `Authenticating users with Access Contol Lists (ACLs) <https://docs.aws.amazon.com/MemoryDB/latest/devguide/clusters.acls.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/memorydb-2021-01-01/CreateACL>`_  


  **Request Syntax**
  ::

    response = client.create_acl(
        ACLName='string',
        UserNames=[
            'string',
        ],
        Tags=[
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    )
    
  :type ACLName: string
  :param ACLName: **[REQUIRED]** 

    The name of the Access Control List.

    

  
  :type UserNames: list
  :param UserNames: 

    The list of users that belong to the Access Control List.

    

  
    - *(string) --* 

    

  :type Tags: list
  :param Tags: 

    A list of tags to be added to this resource. A tag is a key-value pair. A tag key must be accompanied by a tag value, although null is accepted.

    

  
    - *(dict) --* 

      A tag that can be added to an MemoryDB resource. Tags are composed of a Key/Value pair. You can use tags to categorize and track all your MemoryDB resources. When you add or remove tags on clusters, those actions will be replicated to all nodes in the cluster. A tag with a null Value is permitted. For more information, see `Tagging your MemoryDB resources <https://docs.aws.amazon.com/MemoryDB/latest/devguide/tagging-resources.html>`__

      

    
      - **Key** *(string) --* 

        The key for the tag. May not be null.

        

      
      - **Value** *(string) --* 

        The tag's value. May be null.

        

      
    

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

    
    ::

      {
          'ACL': {
              'Name': 'string',
              'Status': 'string',
              'UserNames': [
                  'string',
              ],
              'MinimumEngineVersion': 'string',
              'PendingChanges': {
                  'UserNamesToRemove': [
                      'string',
                  ],
                  'UserNamesToAdd': [
                      'string',
                  ]
              },
              'Clusters': [
                  'string',
              ],
              'ARN': 'string'
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ACL** *(dict) --* 

        The newly-created Access Control List.

        
        

        - **Name** *(string) --* 

          The name of the Access Control List

          
        

        - **Status** *(string) --* 

          Indicates ACL status. Can be "creating", "active", "modifying", "deleting".

          
        

        - **UserNames** *(list) --* 

          The list of user names that belong to the ACL.

          
          

          - *(string) --* 
      
        

        - **MinimumEngineVersion** *(string) --* 

          The minimum engine version supported for the ACL

          
        

        - **PendingChanges** *(dict) --* 

          A list of updates being applied to the ACL.

          
          

          - **UserNamesToRemove** *(list) --* 

            A list of user names being removed from the ACL

            
            

            - *(string) --* 
        
          

          - **UserNamesToAdd** *(list) --* 

            A list of users being added to the ACL

            
            

            - *(string) --* 
        
      
        

        - **Clusters** *(list) --* 

          A list of clusters associated with the ACL.

          
          

          - *(string) --* 
      
        

        - **ARN** *(string) --* 

          The Amazon Resource Name (ARN) of the ACL

          
    
  
  **Exceptions**
  
  *   :py:class:`MemoryDB.Client.exceptions.UserNotFoundFault`

  
  *   :py:class:`MemoryDB.Client.exceptions.DuplicateUserNameFault`

  
  *   :py:class:`MemoryDB.Client.exceptions.ACLAlreadyExistsFault`

  
  *   :py:class:`MemoryDB.Client.exceptions.DefaultUserRequired`

  
  *   :py:class:`MemoryDB.Client.exceptions.ACLQuotaExceededFault`

  
  *   :py:class:`MemoryDB.Client.exceptions.InvalidParameterValueException`

  
  *   :py:class:`MemoryDB.Client.exceptions.TagQuotaPerResourceExceeded`

  