Billing / Client / create_billing_view

create_billing_view

Billing.Client.create_billing_view(**kwargs)

Creates a billing view with the specified billing view attributes.

See also: AWS API Documentation

Request Syntax

response = client.create_billing_view(
    name='string',
    description='string',
    sourceViews=[
        'string',
    ],
    dataFilterExpression={
        'dimensions': {
            'key': 'LINKED_ACCOUNT',
            'values': [
                'string',
            ]
        },
        'tags': {
            'key': 'string',
            'values': [
                'string',
            ]
        }
    },
    clientToken='string',
    resourceTags=[
        {
            'key': 'string',
            'value': 'string'
        },
    ]
)

Parameters:

• name (string) –

  [REQUIRED]

  The name of the billing view.

• description (string) – The description of the billing view.

• sourceViews (list) –

  [REQUIRED]

  A list of billing views used as the data source for the custom billing view.

  • (string) –

• dataFilterExpression (dict) –

  See Expression. Billing view only supports LINKED_ACCOUNT and Tags.

  • dimensions (dict) –

    The specific Dimension to use for Expression.

    • key (string) – [REQUIRED]

      The names of the metadata types that you can use to filter and group your results.

    • values (list) – [REQUIRED]

      The metadata values that you can use to filter and group your results.

      • (string) –

  • tags (dict) –

    The specific Tag to use for Expression.

    • key (string) – [REQUIRED]

      The key for the tag.

    • values (list) – [REQUIRED]

      The specific value of the tag.

      • (string) –

• clientToken (string) –

  A unique, case-sensitive identifier you specify to ensure idempotency of the request. Idempotency ensures that an API request completes no more than one time. If the original request completes successfully, any subsequent retries complete successfully without performing any further actions with an idempotent request.

  This field is autopopulated if not provided.

• resourceTags (list) –

  A list of key value map specifying tags associated to the billing view being created.

  • (dict) –

    The tag structure that contains a tag key and value.

    • key (string) – [REQUIRED]

      The key that’s associated with the tag.

    • value (string) –

      The value that’s associated with the tag.

Return type:

dict

Returns:

Response Syntax

{
    'arn': 'string',
    'createdAt': datetime(2015, 1, 1)
}

Response Structure

• (dict) –

  • arn (string) –

    The Amazon Resource Name (ARN) that can be used to uniquely identify the billing view.

  • createdAt (datetime) –

    The time when the billing view was created.

Exceptions

• Billing.Client.exceptions.ServiceQuotaExceededException

• Billing.Client.exceptions.ThrottlingException

• Billing.Client.exceptions.AccessDeniedException

• Billing.Client.exceptions.ConflictException

• Billing.Client.exceptions.ValidationException

• Billing.Client.exceptions.InternalServerException