Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1432226181.3 KB

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

post/create-pricing-rule

Headers

X-Amzn-Client-Tokenstring

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.

Request body

Namestring password required

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

Descriptionstring password

The pricing rule description.

Scope'GLOBAL' | 'SERVICE' | 'BILLING_ENTITY' | 'SKU' required

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

Type'MARKUP' | 'DISCOUNT' | 'TIERING' required

The type of pricing rule.

ModifierPercentagenumber double

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

Servicestring

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

Tagsobject

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

BillingEntitystring

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

UsageTypestring
<p> Usage type is the unit that each service uses to measure the usage of a specific type of resource.</p> <p>If the <code>Scope</code> attribute is set to <code>SKU</code>, this attribute indicates which usage type the <code>PricingRule</code> is modifying. For example, <code>USW2-BoxUsage:m2.2xlarge</code> describes an<code> M2 High Memory Double Extra Large</code> instance in the US West (Oregon) Region. </p>
Operationstring
<p> Operation is the specific Amazon Web Services action covered by this line item. This describes the specific usage of the line item.</p> <p> If the <code>Scope</code> attribute is set to <code>SKU</code>, this attribute indicates which operation the <code>PricingRule</code> is modifying. For example, a value of <code>RunInstances:0202</code> indicates the operation of running an Amazon EC2 instance.</p>

Response

Success

Arnstring

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