list_pricing_rules

list_pricing_rules(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response = client.list_pricing_rules(
    BillingPeriod='string',
    Filters={
        'Arns': [
            'string',
        ]
    },
    MaxResults=123,
    NextToken='string'
)
Parameters
  • BillingPeriod (string) -- The preferred billing period to get the pricing plan.
  • Filters (dict) --

    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) --
  • MaxResults (integer) -- The maximum number of pricing rules to retrieve.
  • NextToken (string) -- The pagination token that's used on subsequent call to get pricing rules.
Return type

dict

Returns

Response Syntax

{
    'BillingPeriod': 'string',
    'PricingRules': [
        {
            'Name': 'string',
            'Arn': 'string',
            'Description': 'string',
            'Scope': 'GLOBAL'|'SERVICE'|'BILLING_ENTITY',
            'Type': 'MARKUP'|'DISCOUNT'|'TIERING',
            'ModifierPercentage': 123.0,
            'Service': 'string',
            'AssociatedPricingPlanCount': 123,
            'CreationTime': 123,
            'LastModifiedTime': 123,
            'BillingEntity': 'string',
            'Tiering': {
                'FreeTier': {
                    'Activated': True|False
                }
            }
        },
    ],
    '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.

    • NextToken (string) --

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

Exceptions

  • BillingConductor.Client.exceptions.ThrottlingException
  • BillingConductor.Client.exceptions.AccessDeniedException
  • BillingConductor.Client.exceptions.ValidationException
  • BillingConductor.Client.exceptions.InternalServerException