IoT / Client / create_billing_group

create_billing_group

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 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