v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1436232180.1 KB

Creates a new bill scenario to model potential changes to Amazon Web Services usage and costs.

post/#X-Amz-Target=AWSBCMPricingCalculator.CreateBillScenario

Headers

X-Amz-Target'AWSBCMPricingCalculator.CreateBillScenario' required

Request body

namestring required

A descriptive name for the bill scenario.

clientTokenstring

A unique, case-sensitive identifier to ensure idempotency of the request.

tagsobject

The tags to apply to the bill scenario.

groupSharingPreference'OPEN' | 'PRIORITIZED' | 'RESTRICTED'

The setting for the reserved instance and savings plan group sharing used in this estimate.

costCategoryGroupSharingPreferenceArnstring

The arn of the cost category used in the reserved and prioritized group sharing.

Response

Success

idstring required

The unique identifier for the created bill scenario.

namestring

The name of the created bill scenario.

status'READY' | 'LOCKED' | 'FAILED' | 'STALE'

The current status of the bill scenario.

createdAtstring date-time

The timestamp when the bill scenario was created.

expiresAtstring date-time

The timestamp when the bill scenario will expire.

failureMessagestring

An error message if the bill scenario creation failed.

groupSharingPreference'OPEN' | 'PRIORITIZED' | 'RESTRICTED'

The setting for the reserved instance and savings plan group sharing used in this estimate.

costCategoryGroupSharingPreferenceArnstring

The arn of the cost category used in the reserved and prioritized group sharing.