BillingConductor / Client / create_pricing_rule

create_pricing_rule#

BillingConductor.Client.create_pricing_rule(**kwargs)#

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

See also: AWS API Documentation

Request Syntax

response = 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
        }
    },
    UsageType='string',
    Operation='string'
)
Parameters:
  • ClientToken (string) –

    The token that’s needed to support idempotency. Idempotency isn’t currently supported, but will be implemented in a future update.

    This field is autopopulated if not provided.

  • Name (string) –

    [REQUIRED]

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

  • Description (string) – The pricing rule description.

  • Scope (string) –

    [REQUIRED]

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

  • Type (string) –

    [REQUIRED]

    The type of pricing rule.

  • ModifierPercentage (float) – A percentage modifier that’s applied on the public pricing rates.

  • Service (string) – If the Scope attribute is set to SERVICE or SKU , the attribute indicates which service the PricingRule is applicable for.

  • Tags (dict) –

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

    • (string) –

      • (string) –

  • 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) – [REQUIRED]

      The possible Amazon Web Services Free Tier configurations.

      • Activated (boolean) – [REQUIRED]

        Activate or deactivate Amazon Web Services Free 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. </p>

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

Return type:

dict

Returns:

Response Syntax

{
    'Arn': 'string'
}

Response Structure

  • (dict) –

    • Arn (string) –

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

Exceptions

  • BillingConductor.Client.exceptions.ThrottlingException

  • BillingConductor.Client.exceptions.ConflictException

  • BillingConductor.Client.exceptions.AccessDeniedException

  • BillingConductor.Client.exceptions.ValidationException

  • BillingConductor.Client.exceptions.ServiceLimitExceededException

  • BillingConductor.Client.exceptions.InternalServerException