AWS API Changes

2026/01/12 - AWS Billing - 3 updated api methods

Changes Cost Categories filtering support to BillingView data filter expressions through the new costCategories parameter, enabling users to filter billing views by AWS Cost Categories for more granular cost management and allocation.

CreateBillingView (updated)

Link ¶
Changes (request)

{'dataFilterExpression': {'costCategories': {'key': 'string',
                                             'values': ['string']}}}

Creates a billing view with the specified billing view attributes.

See also: AWS API Documentation

Request Syntax

client.create_billing_view(
    name='string',
    description='string',
    sourceViews=[
        'string',
    ],
    dataFilterExpression={
        'dimensions': {
            'key': 'LINKED_ACCOUNT',
            'values': [
                'string',
            ]
        },
        'tags': {
            'key': 'string',
            'values': [
                'string',
            ]
        },
        'costCategories': {
            'key': 'string',
            'values': [
                'string',
            ]
        },
        'timeRange': {
            'beginDateInclusive': datetime(2015, 1, 1),
            'endDateInclusive': datetime(2015, 1, 1)
        }
    },
    clientToken='string',
    resourceTags=[
        {
            'key': 'string',
            'value': 'string'
        },
    ]
)

type name:

string

param name:

[REQUIRED]

The name of the billing view.

type description:

string

param description:

The description of the billing view.

type sourceViews:

list

param sourceViews:

[REQUIRED]

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

(string) --

type dataFilterExpression:

dict

param dataFilterExpression:

See Expression. Billing view only supports LINKED_ACCOUNT, Tags, and CostCategories.

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) --
costCategories (dict) --

The filter that's based on CostCategory values.
- key (string) -- [REQUIRED]
  
  The unique name of the Cost Category.
- values (list) -- [REQUIRED]
  
  The specific value of the Cost Category.
  - (string) --
timeRange (dict) --

Specifies a time range filter for the billing view data.
- beginDateInclusive (datetime) --
  
  The inclusive start date of the time range.
- endDateInclusive (datetime) --
  
  The inclusive end date of the time range.

type clientToken:

string

param clientToken:

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.

type resourceTags:

list

param resourceTags:

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.

rtype:

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.

GetBillingView (updated)

Link ¶
Changes (response)

{'billingView': {'dataFilterExpression': {'costCategories': {'key': 'string',
                                                             'values': ['string']}}}}

Returns the metadata associated to the specified billing view ARN.

See also: AWS API Documentation

Request Syntax

client.get_billing_view(
    arn='string'
)

type arn:

string

param arn:

[REQUIRED]

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

rtype:

dict

returns:

Response Syntax

{
    'billingView': {
        'arn': 'string',
        'name': 'string',
        'description': 'string',
        'billingViewType': 'PRIMARY'|'BILLING_GROUP'|'CUSTOM'|'BILLING_TRANSFER'|'BILLING_TRANSFER_SHOWBACK',
        'ownerAccountId': 'string',
        'sourceAccountId': 'string',
        'dataFilterExpression': {
            'dimensions': {
                'key': 'LINKED_ACCOUNT',
                'values': [
                    'string',
                ]
            },
            'tags': {
                'key': 'string',
                'values': [
                    'string',
                ]
            },
            'costCategories': {
                'key': 'string',
                'values': [
                    'string',
                ]
            },
            'timeRange': {
                'beginDateInclusive': datetime(2015, 1, 1),
                'endDateInclusive': datetime(2015, 1, 1)
            }
        },
        'createdAt': datetime(2015, 1, 1),
        'updatedAt': datetime(2015, 1, 1),
        'derivedViewCount': 123,
        'sourceViewCount': 123,
        'viewDefinitionLastUpdatedAt': datetime(2015, 1, 1),
        'healthStatus': {
            'statusCode': 'HEALTHY'|'UNHEALTHY'|'CREATING'|'UPDATING',
            'statusReasons': [
                'SOURCE_VIEW_UNHEALTHY'|'SOURCE_VIEW_UPDATING'|'SOURCE_VIEW_ACCESS_DENIED'|'SOURCE_VIEW_NOT_FOUND'|'CYCLIC_DEPENDENCY'|'SOURCE_VIEW_DEPTH_EXCEEDED'|'AGGREGATE_SOURCE'|'VIEW_OWNER_NOT_MANAGEMENT_ACCOUNT',
            ]
        }
    }
}

Response Structure

(dict) --
- billingView (dict) --
  
  The billing view element associated with the specified ARN.
  - arn (string) --
    
    The Amazon Resource Name (ARN) that can be used to uniquely identify the billing view.
  - name (string) --
    
    The account name of the billing view.
  - description (string) --
    
    The description of the billing view.
  - billingViewType (string) --
    
    The type of billing group.
  - ownerAccountId (string) --
    
    The account owner of the billing view.
  - sourceAccountId (string) --
    
    The Amazon Web Services account ID that owns the source billing view, if this is a derived billing view.
  - dataFilterExpression (dict) --
    
    See Expression. Billing view only supports LINKED_ACCOUNT, Tags, and CostCategories.
    - dimensions (dict) --
      
      The specific Dimension to use for Expression.
      - key (string) --
        
        The names of the metadata types that you can use to filter and group your results.
      - values (list) --
        
        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) --
        
        The key for the tag.
      - values (list) --
        
        The specific value of the tag.
        
        (string) --
    - costCategories (dict) --
      
      The filter that's based on CostCategory values.
      - key (string) --
        
        The unique name of the Cost Category.
      - values (list) --
        
        The specific value of the Cost Category.
        
        (string) --
    - timeRange (dict) --
      
      Specifies a time range filter for the billing view data.
      - beginDateInclusive (datetime) --
        
        The inclusive start date of the time range.
      - endDateInclusive (datetime) --
        
        The inclusive end date of the time range.
  - createdAt (datetime) --
    
    The time when the billing view was created.
  - updatedAt (datetime) --
    
    The time when the billing view was last updated.
  - derivedViewCount (integer) --
    
    The number of billing views that use this billing view as a source.
  - sourceViewCount (integer) --
    
    The number of source views associated with this billing view.
  - viewDefinitionLastUpdatedAt (datetime) --
    
    The timestamp of when the billing view definition was last updated.
  - healthStatus (dict) --
    
    The current health status of the billing view.
    - statusCode (string) --
      
      The current health status code of the billing view.
    - statusReasons (list) --
      
      A list of reasons explaining the current health status, if applicable.
      - (string) --

UpdateBillingView (updated)

Link ¶
Changes (request)

{'dataFilterExpression': {'costCategories': {'key': 'string',
                                             'values': ['string']}}}

An API to update the attributes of the billing view.

See also: AWS API Documentation

Request Syntax

client.update_billing_view(
    arn='string',
    name='string',
    description='string',
    dataFilterExpression={
        'dimensions': {
            'key': 'LINKED_ACCOUNT',
            'values': [
                'string',
            ]
        },
        'tags': {
            'key': 'string',
            'values': [
                'string',
            ]
        },
        'costCategories': {
            'key': 'string',
            'values': [
                'string',
            ]
        },
        'timeRange': {
            'beginDateInclusive': datetime(2015, 1, 1),
            'endDateInclusive': datetime(2015, 1, 1)
        }
    }
)

type arn:

string

param arn:

[REQUIRED]

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

type name:

string

param name:

The name of the billing view.

type description:

string

param description:

The description of the billing view.

type dataFilterExpression:

dict

param dataFilterExpression:

See Expression. Billing view only supports LINKED_ACCOUNT, Tags, and CostCategories.

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) --
costCategories (dict) --

The filter that's based on CostCategory values.
- key (string) -- [REQUIRED]
  
  The unique name of the Cost Category.
- values (list) -- [REQUIRED]
  
  The specific value of the Cost Category.
  - (string) --
timeRange (dict) --

Specifies a time range filter for the billing view data.
- beginDateInclusive (datetime) --
  
  The inclusive start date of the time range.
- endDateInclusive (datetime) --
  
  The inclusive end date of the time range.

rtype:

dict

returns:

Response Syntax

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

Response Structure

(dict) --
- arn (string) --
  
  The Amazon Resource Name (ARN) that can be used to uniquely identify the billing view.
- updatedAt (datetime) --
  
  The time when the billing view was last updated.