AWS API Changes

2026/09/14 - AWSBillingConductor - 3 updated api methods

Changes This release adds support for custom volume tiering. You can now define custom tiers on a pricing rule's tiering configuration, where each tier specifies a usage range and the rate applied to usage in that range.

CreatePricingRule (updated)

Link ¶
Changes (request)

{'Tiering': {'CustomTiers': [{'BeginRangeInclusive': 'double',
                              'EndRangeExclusive': 'double',
                              'RateValue': 'double'}]}}

Creates a pricing rule can be associated to a pricing plan, or a set of pricing plans.

See also: AWS API Documentation

Request Syntax

client.create_pricing_rule(
    ClientToken='string',
    Name='string',
    Description='string',
    Scope='GLOBAL'|'SERVICE'|'BILLING_ENTITY'|'SKU',
    Type='MARKUP'|'DISCOUNT'|'TIERING',
    ModifierPercentage=123.0,
    Service='string',
    Tags={
        'string': 'string'
    },
    BillingEntity='string',
    Tiering={
        'FreeTier': {
            'Activated': True|False
        },
        'CustomTiers': [
            {
                'BeginRangeInclusive': 123.0,
                'EndRangeExclusive': 123.0,
                'RateValue': 123.0
            },
        ]
    },
    UsageType='string',
    Operation='string'
)

type ClientToken:

string

param ClientToken:

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

This field is autopopulated if not provided.

type Name:

string

param Name:

[REQUIRED]

The pricing rule name. The names must be unique to each pricing rule.

type Description:

string

param Description:

The pricing rule description.

type Scope:

string

param Scope:

[REQUIRED]

The scope of pricing rule that indicates if it's globally applicable, or it's service-specific.

type Type:

string

param Type:

[REQUIRED]

The type of pricing rule.

type ModifierPercentage:

float

param ModifierPercentage:

A percentage modifier that's applied on the public pricing rates. Your entry will be rounded to the nearest 2 decimal places.

type Service:

string

param Service:

If the Scope attribute is set to SERVICE or SKU, the attribute indicates which service the PricingRule is applicable for.

type Tags:

dict

param Tags:

A map that contains tag keys and tag values that are attached to a pricing rule.

(string) --
- (string) --

type BillingEntity:

string

param BillingEntity:

The seller of services provided by Amazon Web Services, their affiliates, or third-party providers selling services via Amazon Web Services Marketplace.

type Tiering:

dict

param Tiering:

The set of tiering configurations for the pricing rule.

FreeTier (dict) --

The possible Amazon Web Services Free Tier configurations.
- Activated (boolean) -- [REQUIRED]
  
  Activate or deactivate Amazon Web Services Free Tier.
CustomTiers (list) --

The set of custom tiers for the pricing rule.
- (dict) --
  
  A custom tier for the pricing rule. Each custom tier applies a rate to the usage that falls within the tier's range.
  - BeginRangeInclusive (float) -- [REQUIRED]
    
    The inclusive start of the usage range that this tier applies to.
  - EndRangeExclusive (float) --
    
    The exclusive end of the usage range that this tier applies to. If you don't specify a value, this tier applies to all usage that is greater than or equal to BeginRangeInclusive.
  - RateValue (float) -- [REQUIRED]
    
    The rate that's applied to the usage that falls within this tier.

type UsageType:

string

param UsageType:

Usage type is the unit that each service uses to measure the usage of a specific type of resource.

If the Scope attribute is set to SKU, this attribute indicates which usage type the PricingRule is modifying. For example, USW2-BoxUsage:m2.2xlarge describes an `` M2 High Memory Double Extra Large`` instance in the US West (Oregon) Region.

type Operation:

string

param Operation:

Operation is the specific Amazon Web Services action covered by this line item. This describes the specific usage of the line item.

If the Scope attribute is set to SKU, this attribute indicates which operation the PricingRule is modifying. For example, a value of RunInstances:0202 indicates the operation of running an Amazon EC2 instance.

rtype:

dict

returns:

Response Syntax

{
    'Arn': 'string'
}

Response Structure

(dict) --
- Arn (string) --
  
  The Amazon Resource Name (ARN) of the created pricing rule.

ListPricingRules (updated)

Link ¶
Changes (response)

{'PricingRules': {'Tiering': {'CustomTiers': [{'BeginRangeInclusive': 'double',
                                               'EndRangeExclusive': 'double',
                                               'RateValue': 'double'}]}}}

Describes a pricing rule that can be associated to a pricing plan, or set of pricing plans.

See also: AWS API Documentation

Request Syntax

client.list_pricing_rules(
    BillingPeriod='string',
    Filters={
        'Arns': [
            'string',
        ]
    },
    MaxResults=123,
    NextToken='string'
)

type BillingPeriod:

string

param BillingPeriod:

The preferred billing period to get the pricing plan.

type Filters:

dict

param Filters:

A DescribePricingRuleFilter that specifies the Amazon Resource Name (ARNs) of pricing rules to retrieve pricing rules information.

Arns (list) --

A list containing the pricing rule Amazon Resource Names (ARNs) to include in the API response.
- (string) --

type MaxResults:

integer

param MaxResults:

The maximum number of pricing rules to retrieve.

type NextToken:

string

param NextToken:

The pagination token that's used on subsequent call to get pricing rules.

rtype:

dict

returns:

Response Syntax

{
    'BillingPeriod': 'string',
    'PricingRules': [
        {
            'Name': 'string',
            'Arn': 'string',
            'Description': 'string',
            'Scope': 'GLOBAL'|'SERVICE'|'BILLING_ENTITY'|'SKU',
            'Type': 'MARKUP'|'DISCOUNT'|'TIERING',
            'ModifierPercentage': 123.0,
            'Service': 'string',
            'AssociatedPricingPlanCount': 123,
            'CreationTime': 123,
            'LastModifiedTime': 123,
            'BillingEntity': 'string',
            'Tiering': {
                'FreeTier': {
                    'Activated': True|False
                },
                'CustomTiers': [
                    {
                        'BeginRangeInclusive': 123.0,
                        'EndRangeExclusive': 123.0,
                        'RateValue': 123.0
                    },
                ]
            },
            'UsageType': 'string',
            'Operation': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) --
- BillingPeriod (string) --
  
  The billing period for which the described pricing rules are applicable.
- PricingRules (list) --
  
  A list containing the described pricing rules.
  - (dict) --
    
    A representation of a pricing rule.
    - Name (string) --
      
      The name of a pricing rule.
    - Arn (string) --
      
      The Amazon Resource Name (ARN) used to uniquely identify a pricing rule.
    - Description (string) --
      
      The pricing rule description.
    - Scope (string) --
      
      The scope of pricing rule that indicates if it is globally applicable, or if it is service-specific.
    - Type (string) --
      
      The type of pricing rule.
    - ModifierPercentage (float) --
      
      A percentage modifier applied on the public pricing rates.
    - Service (string) --
      
      If the Scope attribute is SERVICE, this attribute indicates which service the PricingRule is applicable for.
    - AssociatedPricingPlanCount (integer) --
      
      The pricing plans count that this pricing rule is associated with.
    - CreationTime (integer) --
      
      The time when the pricing rule was created.
    - LastModifiedTime (integer) --
      
      The most recent time when the pricing rule was modified.
    - BillingEntity (string) --
      
      The seller of services provided by Amazon Web Services, their affiliates, or third-party providers selling services via Amazon Web Services Marketplace.
    - Tiering (dict) --
      
      The set of tiering configurations for the pricing rule.
      - FreeTier (dict) --
        
        The possible Amazon Web Services Free Tier configurations.
        
        Activated (boolean) --
        
        Activate or deactivate Amazon Web Services Free Tier application.
      - CustomTiers (list) --
        
        The set of custom tiers for the pricing rule.
        
        (dict) --
        
        A custom tier for the pricing rule. Each custom tier applies a rate to the usage that falls within the tier's range.
        
        BeginRangeInclusive (float) --
        
        The inclusive start of the usage range that this tier applies to.
        
        EndRangeExclusive (float) --
        
        The exclusive end of the usage range that this tier applies to. If you don't specify a value, this tier applies to all usage that is greater than or equal to BeginRangeInclusive.
        
        RateValue (float) --
        
        The rate that's applied to the usage that falls within this tier.
    - UsageType (string) --
      
      Usage type is the unit that each service uses to measure the usage of a specific type of resource.
      
      If the Scope attribute is set to SKU, this attribute indicates which usage type the PricingRule is modifying. For example, USW2-BoxUsage:m2.2xlarge describes an `` M2 High Memory Double Extra Large`` instance in the US West (Oregon) Region.
    - Operation (string) --
      
      Operation is the specific Amazon Web Services action covered by this line item. This describes the specific usage of the line item.
      
      If the Scope attribute is set to SKU, this attribute indicates which operation the PricingRule is modifying. For example, a value of RunInstances:0202 indicates the operation of running an Amazon EC2 instance.
- NextToken (string) --
  
  The pagination token that's used on subsequent calls to get pricing rules.

UpdatePricingRule (updated)

Link ¶
Changes (both)

{'Tiering': {'CustomTiers': [{'BeginRangeInclusive': 'double',
                              'EndRangeExclusive': 'double',
                              'RateValue': 'double'}]}}

Updates an existing pricing rule.

See also: AWS API Documentation

Request Syntax

client.update_pricing_rule(
    Arn='string',
    Name='string',
    Description='string',
    Type='MARKUP'|'DISCOUNT'|'TIERING',
    ModifierPercentage=123.0,
    Tiering={
        'FreeTier': {
            'Activated': True|False
        },
        'CustomTiers': [
            {
                'BeginRangeInclusive': 123.0,
                'EndRangeExclusive': 123.0,
                'RateValue': 123.0
            },
        ]
    }
)

type Arn:

string

param Arn:

[REQUIRED]

The Amazon Resource Name (ARN) of the pricing rule to update.

type Name:

string

param Name:

The new name of the pricing rule. The name must be unique to each pricing rule.

type Description:

string

param Description:

The new description for the pricing rule.

type Type:

string

param Type:

The new pricing rule type.

type ModifierPercentage:

float

param ModifierPercentage:

The new modifier to show pricing plan rates as a percentage. Your entry will be rounded to the nearest 2 decimal places.

type Tiering:

dict

param Tiering:

The set of tiering configurations for the pricing rule.

FreeTier (dict) --

The possible Amazon Web Services Free Tier configurations.
- Activated (boolean) -- [REQUIRED]
  
  Activate or deactivate application of Amazon Web Services Free Tier.
CustomTiers (list) --

The set of custom tiers for the pricing rule.
- (dict) --
  
  A custom tier for the pricing rule. Each custom tier applies a rate to the usage that falls within the tier's range.
  - BeginRangeInclusive (float) -- [REQUIRED]
    
    The inclusive start of the usage range that this tier applies to.
  - EndRangeExclusive (float) --
    
    The exclusive end of the usage range that this tier applies to. If you don't specify a value, this tier applies to all usage that is greater than or equal to BeginRangeInclusive.
  - RateValue (float) -- [REQUIRED]
    
    The rate that's applied to the usage that falls within this tier.

rtype:

dict

returns:

Response Syntax

{
    'Arn': 'string',
    'Name': 'string',
    'Description': 'string',
    'Scope': 'GLOBAL'|'SERVICE'|'BILLING_ENTITY'|'SKU',
    'Type': 'MARKUP'|'DISCOUNT'|'TIERING',
    'ModifierPercentage': 123.0,
    'Service': 'string',
    'AssociatedPricingPlanCount': 123,
    'LastModifiedTime': 123,
    'BillingEntity': 'string',
    'Tiering': {
        'FreeTier': {
            'Activated': True|False
        },
        'CustomTiers': [
            {
                'BeginRangeInclusive': 123.0,
                'EndRangeExclusive': 123.0,
                'RateValue': 123.0
            },
        ]
    },
    'UsageType': 'string',
    'Operation': 'string'
}

Response Structure

(dict) --
- Arn (string) --
  
  The Amazon Resource Name (ARN) of the successfully updated pricing rule.
- Name (string) --
  
  The new name of the pricing rule. The name must be unique to each pricing rule.
- Description (string) --
  
  The new description for the pricing rule.
- Scope (string) --
  
  The scope of pricing rule that indicates if it's globally applicable, or it's service-specific.
- Type (string) --
  
  The new pricing rule type.
- ModifierPercentage (float) --
  
  The new modifier to show pricing plan rates as a percentage.
- Service (string) --
  
  If the Scope attribute is set to SERVICE, the attribute indicates which service the PricingRule is applicable for.
- AssociatedPricingPlanCount (integer) --
  
  The pricing plans count that this pricing rule is associated with.
- LastModifiedTime (integer) --
  
  The most recent time the pricing rule was modified.
- BillingEntity (string) --
  
  The seller of services provided by Amazon Web Services, their affiliates, or third-party providers selling services via Amazon Web Services Marketplace.
- Tiering (dict) --
  
  The set of tiering configurations for the pricing rule.
  - FreeTier (dict) --
    
    The possible Amazon Web Services Free Tier configurations.
    - Activated (boolean) --
      
      Activate or deactivate application of Amazon Web Services Free Tier.
  - CustomTiers (list) --
    
    The set of custom tiers for the pricing rule.
    - (dict) --
      
      A custom tier for the pricing rule. Each custom tier applies a rate to the usage that falls within the tier's range.
      - BeginRangeInclusive (float) --
        
        The inclusive start of the usage range that this tier applies to.
      - EndRangeExclusive (float) --
        
        The exclusive end of the usage range that this tier applies to. If you don't specify a value, this tier applies to all usage that is greater than or equal to BeginRangeInclusive.
      - RateValue (float) --
        
        The rate that's applied to the usage that falls within this tier.
- UsageType (string) --
  
  Usage type is the unit that each service uses to measure the usage of a specific type of resource.
  
  If the Scope attribute is set to SKU, this attribute indicates which usage type the PricingRule is modifying. For example, USW2-BoxUsage:m2.2xlarge describes an M2 High Memory Double Extra Large instance in the US West (Oregon) Region.
- Operation (string) --
  
  Operation refers to the specific Amazon Web Services covered by this line item. This describes the specific usage of the line item.
  
  If the Scope attribute is set to SKU, this attribute indicates which operation the PricingRule is modifying. For example, a value of RunInstances:0202 indicates the operation of running an Amazon EC2 instance.