IoT / Client / create_billing_group

create_billing_group#

IoT.Client.create_billing_group(**kwargs)#

Creates a billing group.

Requires permission to access the CreateBillingGroup action.

See also: AWS API Documentation

Request Syntax

response = client.create_billing_group(
    billingGroupName='string',
    billingGroupProperties={
        'billingGroupDescription': 'string'
    },
    tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
Parameters:
  • billingGroupName (string) –

    [REQUIRED]

    The name you wish to give to the billing group.

  • billingGroupProperties (dict) –

    The properties of the billing group.

    • billingGroupDescription (string) –

      The description of the billing group.

  • tags (list) –

    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.

Return type:

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

  • IoT.Client.exceptions.InvalidRequestException

  • IoT.Client.exceptions.ResourceAlreadyExistsException

  • IoT.Client.exceptions.ThrottlingException

  • IoT.Client.exceptions.InternalFailureException