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