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