:doc:`IoT <../../iot>` / Client / create_billing_group

********************
create_billing_group
********************



.. py:method:: IoT.Client.create_billing_group(**kwargs)

  

  Creates a billing group. If this call is made multiple times using the same billing group name and configuration, the call will succeed. If this call is made with the same billing group name but different configuration a ``ResourceAlreadyExistsException`` is thrown.

   

  Requires permission to access the `CreateBillingGroup <https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions>`__ action.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iot-2015-05-28/CreateBillingGroup>`_  


  **Request Syntax**
  ::

    response = client.create_billing_group(
        billingGroupName='string',
        billingGroupProperties={
            'billingGroupDescription': 'string'
        },
        tags=[
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    )
    
  :type billingGroupName: string
  :param billingGroupName: **[REQUIRED]** 

    The name you wish to give to the billing group.

    

  
  :type billingGroupProperties: dict
  :param billingGroupProperties: 

    The properties of the billing group.

    

  
    - **billingGroupDescription** *(string) --* 

      The description of the billing group.

      

    
  
  :type tags: list
  :param tags: 

    Metadata which can be used to manage the billing group.

    

  
    - *(dict) --* 

      A set of key/value pairs that are used to manage the resource.

      

    
      - **Key** *(string) --* **[REQUIRED]** 

        The tag's key.

        

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

        The tag's value.

        

      
    

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

    
    ::

      {
          'billingGroupName': 'string',
          'billingGroupArn': 'string',
          'billingGroupId': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **billingGroupName** *(string) --* 

        The name you gave to the billing group.

        
      

      - **billingGroupArn** *(string) --* 

        The ARN of the billing group.

        
      

      - **billingGroupId** *(string) --* 

        The ID of the billing group.

        
  
  **Exceptions**
  
  *   :py:class:`IoT.Client.exceptions.InvalidRequestException`

  
  *   :py:class:`IoT.Client.exceptions.ResourceAlreadyExistsException`

  
  *   :py:class:`IoT.Client.exceptions.ThrottlingException`

  
  *   :py:class:`IoT.Client.exceptions.InternalFailureException`

  