:doc:`Group <index>` / Action / create

******
create
******



.. py:method:: IAM.Group.create(**kwargs)

  

  Creates a new group.

   

  For information about the number of groups you can create, see `IAM and STS quotas <https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-quotas.html>`__ in the *IAM User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/CreateGroup>`_  


  **Request Syntax**
  ::

    group = group.create(
        Path='string',
        
    )
    
  :type Path: string
  :param Path: 

    The path to the group. For more information about paths, see `IAM identifiers <https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html>`__ in the *IAM User Guide*.

     

    This parameter is optional. If it is not included, it defaults to a slash (/).

     

    This parameter allows (through its `regex pattern <http://wikipedia.org/wiki/regex>`__) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! ( ``\u0021``) through the DEL character ( ``\u007F``), including most punctuation characters, digits, and upper and lowercased letters.

    

  
  
  :rtype: :py:class:`iam.Group`
  :returns: Group resource
  