# AWS Pricing Calculator
<a name="API_Operations_AWS_Billing_and_Cost_Management_Pricing_Calculator"></a>

The following actions are supported by AWS Pricing Calculator:
+  [BatchCreateBillScenarioCommitmentModification](API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification.md) 
+  [BatchCreateBillScenarioUsageModification](API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification.md) 
+  [BatchCreateWorkloadEstimateUsage](API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage.md) 
+  [BatchDeleteBillScenarioCommitmentModification](API_AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification.md) 
+  [BatchDeleteBillScenarioUsageModification](API_AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification.md) 
+  [BatchDeleteWorkloadEstimateUsage](API_AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage.md) 
+  [BatchUpdateBillScenarioCommitmentModification](API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification.md) 
+  [BatchUpdateBillScenarioUsageModification](API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification.md) 
+  [BatchUpdateWorkloadEstimateUsage](API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage.md) 
+  [CreateBillEstimate](API_AWSBCMPricingCalculator_CreateBillEstimate.md) 
+  [CreateBillScenario](API_AWSBCMPricingCalculator_CreateBillScenario.md) 
+  [CreateWorkloadEstimate](API_AWSBCMPricingCalculator_CreateWorkloadEstimate.md) 
+  [DeleteBillEstimate](API_AWSBCMPricingCalculator_DeleteBillEstimate.md) 
+  [DeleteBillScenario](API_AWSBCMPricingCalculator_DeleteBillScenario.md) 
+  [DeleteWorkloadEstimate](API_AWSBCMPricingCalculator_DeleteWorkloadEstimate.md) 
+  [GetBillEstimate](API_AWSBCMPricingCalculator_GetBillEstimate.md) 
+  [GetBillScenario](API_AWSBCMPricingCalculator_GetBillScenario.md) 
+  [GetPreferences](API_AWSBCMPricingCalculator_GetPreferences.md) 
+  [GetWorkloadEstimate](API_AWSBCMPricingCalculator_GetWorkloadEstimate.md) 
+  [ListBillEstimateCommitments](API_AWSBCMPricingCalculator_ListBillEstimateCommitments.md) 
+  [ListBillEstimateInputCommitmentModifications](API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications.md) 
+  [ListBillEstimateInputUsageModifications](API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications.md) 
+  [ListBillEstimateLineItems](API_AWSBCMPricingCalculator_ListBillEstimateLineItems.md) 
+  [ListBillEstimates](API_AWSBCMPricingCalculator_ListBillEstimates.md) 
+  [ListBillScenarioCommitmentModifications](API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications.md) 
+  [ListBillScenarios](API_AWSBCMPricingCalculator_ListBillScenarios.md) 
+  [ListBillScenarioUsageModifications](API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications.md) 
+  [ListTagsForResource](API_AWSBCMPricingCalculator_ListTagsForResource.md) 
+  [ListWorkloadEstimates](API_AWSBCMPricingCalculator_ListWorkloadEstimates.md) 
+  [ListWorkloadEstimateUsage](API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage.md) 
+  [TagResource](API_AWSBCMPricingCalculator_TagResource.md) 
+  [UntagResource](API_AWSBCMPricingCalculator_UntagResource.md) 
+  [UpdateBillEstimate](API_AWSBCMPricingCalculator_UpdateBillEstimate.md) 
+  [UpdateBillScenario](API_AWSBCMPricingCalculator_UpdateBillScenario.md) 
+  [UpdatePreferences](API_AWSBCMPricingCalculator_UpdatePreferences.md) 
+  [UpdateWorkloadEstimate](API_AWSBCMPricingCalculator_UpdateWorkloadEstimate.md) 

# BatchCreateBillScenarioCommitmentModification
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification"></a>

 Create Compute Savings Plans, EC2 Instance Savings Plans, or EC2 Reserved Instances commitments that you want to model in a Bill Scenario. 

**Note**  
The `BatchCreateBillScenarioCommitmentModification` operation doesn't have its own IAM permission. To authorize this operation for AWS principals, include the permission `bcm-pricing-calculator:CreateBillScenarioCommitmentModification` in your policies.

## Request Syntax
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification_RequestSyntax"></a>

```
{
   "billScenarioId": "string",
   "clientToken": "string",
   "commitmentModifications": [ 
      { 
         "commitmentAction": { ... },
         "group": "string",
         "key": "string",
         "usageAccountId": "string"
      }
   ]
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billScenarioId](#API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification-request-billScenarioId"></a>
 The ID of the Bill Scenario for which you want to create the modeled commitment.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [clientToken](#API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification-request-clientToken"></a>
 A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `[\u0021-\u007E]+`   
Required: No

 ** [commitmentModifications](#API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification-request-commitmentModifications"></a>
 List of commitments that you want to model in the Bill Scenario.   
Type: Array of [BatchCreateBillScenarioCommitmentModificationEntry](API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModificationEntry.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 25 items.  
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification_ResponseSyntax"></a>

```
{
   "errors": [ 
      { 
         "errorCode": "string",
         "errorMessage": "string",
         "key": "string"
      }
   ],
   "items": [ 
      { 
         "commitmentAction": { ... },
         "group": "string",
         "id": "string",
         "key": "string",
         "usageAccountId": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errors](#API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification-response-errors"></a>
 Returns the list of errors reason and the commitment item keys that cannot be created in the Bill Scenario.   
Type: Array of [BatchCreateBillScenarioCommitmentModificationError](API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModificationError.md) objects

 ** [items](#API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification-response-items"></a>
 Returns the list of successful commitment line items that were created for the Bill Scenario.   
Type: Array of [BatchCreateBillScenarioCommitmentModificationItem](API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModificationItem.md) objects

## Errors
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioCommitmentModification_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioCommitmentModification) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioCommitmentModification) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioCommitmentModification) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioCommitmentModification) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioCommitmentModification) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioCommitmentModification) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioCommitmentModification) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioCommitmentModification) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioCommitmentModification) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioCommitmentModification) 

# BatchCreateBillScenarioUsageModification
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification"></a>

 Create AWS service usage that you want to model in a Bill Scenario. 

**Note**  
The `BatchCreateBillScenarioUsageModification` operation doesn't have its own IAM permission. To authorize this operation for AWS principals, include the permission `bcm-pricing-calculator:CreateBillScenarioUsageModification` in your policies.

## Request Syntax
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification_RequestSyntax"></a>

```
{
   "billScenarioId": "string",
   "clientToken": "string",
   "usageModifications": [ 
      { 
         "amounts": [ 
            { 
               "amount": number,
               "startHour": number
            }
         ],
         "availabilityZone": "string",
         "group": "string",
         "historicalUsage": { 
            "billInterval": { 
               "end": number,
               "start": number
            },
            "filterExpression": { 
               "and": [ 
                  "Expression"
               ],
               "costCategories": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "dimensions": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "not": "Expression",
               "or": [ 
                  "Expression"
               ],
               "tags": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               }
            },
            "location": "string",
            "operation": "string",
            "serviceCode": "string",
            "usageAccountId": "string",
            "usageType": "string"
         },
         "key": "string",
         "operation": "string",
         "serviceCode": "string",
         "usageAccountId": "string",
         "usageType": "string"
      }
   ]
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billScenarioId](#API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification-request-billScenarioId"></a>
 The ID of the Bill Scenario for which you want to create the modeled usage.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [clientToken](#API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification-request-clientToken"></a>
 A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `[\u0021-\u007E]+`   
Required: No

 ** [usageModifications](#API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification-request-usageModifications"></a>
 List of usage that you want to model in the Bill Scenario.   
Type: Array of [BatchCreateBillScenarioUsageModificationEntry](API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModificationEntry.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 25 items.  
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification_ResponseSyntax"></a>

```
{
   "errors": [ 
      { 
         "errorCode": "string",
         "errorMessage": "string",
         "key": "string"
      }
   ],
   "items": [ 
      { 
         "availabilityZone": "string",
         "group": "string",
         "historicalUsage": { 
            "billInterval": { 
               "end": number,
               "start": number
            },
            "filterExpression": { 
               "and": [ 
                  "Expression"
               ],
               "costCategories": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "dimensions": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "not": "Expression",
               "or": [ 
                  "Expression"
               ],
               "tags": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               }
            },
            "location": "string",
            "operation": "string",
            "serviceCode": "string",
            "usageAccountId": "string",
            "usageType": "string"
         },
         "id": "string",
         "key": "string",
         "location": "string",
         "operation": "string",
         "quantities": [ 
            { 
               "amount": number,
               "startHour": number,
               "unit": "string"
            }
         ],
         "serviceCode": "string",
         "usageAccountId": "string",
         "usageType": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errors](#API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification-response-errors"></a>
 Returns the list of errors reason and the usage item keys that cannot be created in the Bill Scenario.   
Type: Array of [BatchCreateBillScenarioUsageModificationError](API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModificationError.md) objects

 ** [items](#API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification-response-items"></a>
 Returns the list of successful usage line items that were created for the Bill Scenario.   
Type: Array of [BatchCreateBillScenarioUsageModificationItem](API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModificationItem.md) objects

## Errors
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ServiceQuotaExceededException **   
 The request would cause you to exceed your service quota.     
 ** quotaCode **   
 The quota code that was exceeded.   
 ** resourceId **   
 The identifier of the resource that exceeded quota.   
 ** resourceType **   
 The type of the resource that exceeded quota.   
 ** serviceCode **   
 The service code that exceeded quota. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioUsageModification) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioUsageModification) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioUsageModification) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioUsageModification) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioUsageModification) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioUsageModification) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioUsageModification) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioUsageModification) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioUsageModification) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/BatchCreateBillScenarioUsageModification) 

# BatchCreateWorkloadEstimateUsage
<a name="API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage"></a>

 Create AWS service usage that you want to model in a Workload Estimate. 

**Note**  
The `BatchCreateWorkloadEstimateUsage` operation doesn't have its own IAM permission. To authorize this operation for AWS principals, include the permission `bcm-pricing-calculator:CreateWorkloadEstimateUsage` in your policies.

## Request Syntax
<a name="API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage_RequestSyntax"></a>

```
{
   "clientToken": "string",
   "usage": [ 
      { 
         "amount": number,
         "group": "string",
         "historicalUsage": { 
            "billInterval": { 
               "end": number,
               "start": number
            },
            "filterExpression": { 
               "and": [ 
                  "Expression"
               ],
               "costCategories": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "dimensions": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "not": "Expression",
               "or": [ 
                  "Expression"
               ],
               "tags": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               }
            },
            "location": "string",
            "operation": "string",
            "serviceCode": "string",
            "usageAccountId": "string",
            "usageType": "string"
         },
         "key": "string",
         "operation": "string",
         "serviceCode": "string",
         "usageAccountId": "string",
         "usageType": "string"
      }
   ],
   "workloadEstimateId": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [clientToken](#API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage-request-clientToken"></a>
 A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `[\u0021-\u007E]+`   
Required: No

 ** [usage](#API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage-request-usage"></a>
 List of usage that you want to model in the Workload estimate.   
Type: Array of [BatchCreateWorkloadEstimateUsageEntry](API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsageEntry.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 25 items.  
Required: Yes

 ** [workloadEstimateId](#API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage-request-workloadEstimateId"></a>
 The ID of the Workload estimate for which you want to create the modeled usage.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage_ResponseSyntax"></a>

```
{
   "errors": [ 
      { 
         "errorCode": "string",
         "errorMessage": "string",
         "key": "string"
      }
   ],
   "items": [ 
      { 
         "cost": number,
         "currency": "string",
         "group": "string",
         "historicalUsage": { 
            "billInterval": { 
               "end": number,
               "start": number
            },
            "filterExpression": { 
               "and": [ 
                  "Expression"
               ],
               "costCategories": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "dimensions": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "not": "Expression",
               "or": [ 
                  "Expression"
               ],
               "tags": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               }
            },
            "location": "string",
            "operation": "string",
            "serviceCode": "string",
            "usageAccountId": "string",
            "usageType": "string"
         },
         "id": "string",
         "key": "string",
         "location": "string",
         "operation": "string",
         "quantity": { 
            "amount": number,
            "unit": "string"
         },
         "serviceCode": "string",
         "status": "string",
         "usageAccountId": "string",
         "usageType": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errors](#API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage-response-errors"></a>
 Returns the list of errors reason and the usage item keys that cannot be created in the Workload estimate.   
Type: Array of [BatchCreateWorkloadEstimateUsageError](API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsageError.md) objects

 ** [items](#API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage-response-items"></a>
 Returns the list of successful usage line items that were created for the Workload estimate.   
Type: Array of [BatchCreateWorkloadEstimateUsageItem](API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsageItem.md) objects

## Errors
<a name="API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ServiceQuotaExceededException **   
 The request would cause you to exceed your service quota.     
 ** quotaCode **   
 The quota code that was exceeded.   
 ** resourceId **   
 The identifier of the resource that exceeded quota.   
 ** resourceType **   
 The type of the resource that exceeded quota.   
 ** serviceCode **   
 The service code that exceeded quota. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_BatchCreateWorkloadEstimateUsage_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/BatchCreateWorkloadEstimateUsage) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/BatchCreateWorkloadEstimateUsage) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/BatchCreateWorkloadEstimateUsage) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/BatchCreateWorkloadEstimateUsage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/BatchCreateWorkloadEstimateUsage) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/BatchCreateWorkloadEstimateUsage) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/BatchCreateWorkloadEstimateUsage) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/BatchCreateWorkloadEstimateUsage) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/BatchCreateWorkloadEstimateUsage) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/BatchCreateWorkloadEstimateUsage) 

# BatchDeleteBillScenarioCommitmentModification
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification"></a>

 Delete commitment that you have created in a Bill Scenario. You can only delete a commitment that you had added and cannot model deletion (or removal) of a existing commitment. If you want model deletion of an existing commitment, see the negate [ BillScenarioCommitmentModificationAction](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AWSBCMPricingCalculator_BillScenarioCommitmentModificationAction.html) of [ BatchCreateBillScenarioCommitmentModification](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AWSBCMPricingCalculator_BatchCreateBillScenarioUsageModification.html) operation. 

**Note**  
The `BatchDeleteBillScenarioCommitmentModification` operation doesn't have its own IAM permission. To authorize this operation for AWS principals, include the permission `bcm-pricing-calculator:DeleteBillScenarioCommitmentModification` in your policies.

## Request Syntax
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification_RequestSyntax"></a>

```
{
   "billScenarioId": "string",
   "ids": [ "string" ]
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billScenarioId](#API_AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification-request-billScenarioId"></a>
 The ID of the Bill Scenario for which you want to delete the modeled commitment.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [ids](#API_AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification-request-ids"></a>
 List of commitments that you want to delete from the Bill Scenario.   
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 25 items.  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification_ResponseSyntax"></a>

```
{
   "errors": [ 
      { 
         "errorCode": "string",
         "errorMessage": "string",
         "id": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errors](#API_AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification-response-errors"></a>
 Returns the list of errors reason and the commitment item keys that cannot be deleted from the Bill Scenario.   
Type: Array of [BatchDeleteBillScenarioCommitmentModificationError](API_AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModificationError.md) objects

## Errors
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioCommitmentModification_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioCommitmentModification) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioCommitmentModification) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioCommitmentModification) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioCommitmentModification) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioCommitmentModification) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioCommitmentModification) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioCommitmentModification) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioCommitmentModification) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioCommitmentModification) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioCommitmentModification) 

# BatchDeleteBillScenarioUsageModification
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification"></a>

 Delete usage that you have created in a Bill Scenario. You can only delete usage that you had added and cannot model deletion (or removal) of a existing usage. If you want model removal of an existing usage, see [ BatchUpdateBillScenarioUsageModification](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification.html). 

**Note**  
The `BatchDeleteBillScenarioUsageModification` operation doesn't have its own IAM permission. To authorize this operation for AWS principals, include the permission `bcm-pricing-calculator:DeleteBillScenarioUsageModification` in your policies.

## Request Syntax
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification_RequestSyntax"></a>

```
{
   "billScenarioId": "string",
   "ids": [ "string" ]
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billScenarioId](#API_AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification-request-billScenarioId"></a>
 The ID of the Bill Scenario for which you want to delete the modeled usage.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [ids](#API_AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification-request-ids"></a>
 List of usage that you want to delete from the Bill Scenario.   
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 25 items.  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification_ResponseSyntax"></a>

```
{
   "errors": [ 
      { 
         "errorCode": "string",
         "errorMessage": "string",
         "id": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errors](#API_AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification-response-errors"></a>
 Returns the list of errors reason and the usage item keys that cannot be deleted from the Bill Scenario.   
Type: Array of [BatchDeleteBillScenarioUsageModificationError](API_AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModificationError.md) objects

## Errors
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ServiceQuotaExceededException **   
 The request would cause you to exceed your service quota.     
 ** quotaCode **   
 The quota code that was exceeded.   
 ** resourceId **   
 The identifier of the resource that exceeded quota.   
 ** resourceType **   
 The type of the resource that exceeded quota.   
 ** serviceCode **   
 The service code that exceeded quota. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_BatchDeleteBillScenarioUsageModification_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioUsageModification) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioUsageModification) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioUsageModification) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioUsageModification) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioUsageModification) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioUsageModification) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioUsageModification) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioUsageModification) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioUsageModification) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/BatchDeleteBillScenarioUsageModification) 

# BatchDeleteWorkloadEstimateUsage
<a name="API_AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage"></a>

 Delete usage that you have created in a Workload estimate. You can only delete usage that you had added and cannot model deletion (or removal) of a existing usage. If you want model removal of an existing usage, see [ BatchUpdateWorkloadEstimateUsage](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage.html). 

**Note**  
The `BatchDeleteWorkloadEstimateUsage` operation doesn't have its own IAM permission. To authorize this operation for AWS principals, include the permission `bcm-pricing-calculator:DeleteWorkloadEstimateUsage` in your policies.

## Request Syntax
<a name="API_AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage_RequestSyntax"></a>

```
{
   "ids": [ "string" ],
   "workloadEstimateId": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [ids](#API_AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage-request-ids"></a>
 List of usage that you want to delete from the Workload estimate.   
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 25 items.  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [workloadEstimateId](#API_AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage-request-workloadEstimateId"></a>
 The ID of the Workload estimate for which you want to delete the modeled usage.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage_ResponseSyntax"></a>

```
{
   "errors": [ 
      { 
         "errorCode": "string",
         "errorMessage": "string",
         "id": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errors](#API_AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage-response-errors"></a>
 Returns the list of errors reason and the usage item keys that cannot be deleted from the Workload estimate.   
Type: Array of [BatchDeleteWorkloadEstimateUsageError](API_AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsageError.md) objects

## Errors
<a name="API_AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ServiceQuotaExceededException **   
 The request would cause you to exceed your service quota.     
 ** quotaCode **   
 The quota code that was exceeded.   
 ** resourceId **   
 The identifier of the resource that exceeded quota.   
 ** resourceType **   
 The type of the resource that exceeded quota.   
 ** serviceCode **   
 The service code that exceeded quota. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_BatchDeleteWorkloadEstimateUsage_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/BatchDeleteWorkloadEstimateUsage) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/BatchDeleteWorkloadEstimateUsage) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/BatchDeleteWorkloadEstimateUsage) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/BatchDeleteWorkloadEstimateUsage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/BatchDeleteWorkloadEstimateUsage) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/BatchDeleteWorkloadEstimateUsage) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/BatchDeleteWorkloadEstimateUsage) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/BatchDeleteWorkloadEstimateUsage) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/BatchDeleteWorkloadEstimateUsage) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/BatchDeleteWorkloadEstimateUsage) 

# BatchUpdateBillScenarioCommitmentModification
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification"></a>

 Update a newly added or existing commitment. You can update the commitment group based on a commitment ID and a Bill scenario ID. 

**Note**  
The `BatchUpdateBillScenarioCommitmentModification` operation doesn't have its own IAM permission. To authorize this operation for AWS principals, include the permission `bcm-pricing-calculator:UpdateBillScenarioCommitmentModification` in your policies.

## Request Syntax
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification_RequestSyntax"></a>

```
{
   "billScenarioId": "string",
   "commitmentModifications": [ 
      { 
         "group": "string",
         "id": "string"
      }
   ]
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billScenarioId](#API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification-request-billScenarioId"></a>
 The ID of the Bill Scenario for which you want to modify the commitment group of a modeled commitment.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [commitmentModifications](#API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification-request-commitmentModifications"></a>
 List of commitments that you want to update in a Bill Scenario.   
Type: Array of [BatchUpdateBillScenarioCommitmentModificationEntry](API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModificationEntry.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 25 items.  
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification_ResponseSyntax"></a>

```
{
   "errors": [ 
      { 
         "errorCode": "string",
         "errorMessage": "string",
         "id": "string"
      }
   ],
   "items": [ 
      { 
         "commitmentAction": { ... },
         "group": "string",
         "id": "string",
         "usageAccountId": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errors](#API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification-response-errors"></a>
 Returns the list of error reasons and commitment line item IDs that could not be updated for the Bill Scenario.   
Type: Array of [BatchUpdateBillScenarioCommitmentModificationError](API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModificationError.md) objects

 ** [items](#API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification-response-items"></a>
 Returns the list of successful commitment line items that were updated for a Bill Scenario.   
Type: Array of [BillScenarioCommitmentModificationItem](API_AWSBCMPricingCalculator_BillScenarioCommitmentModificationItem.md) objects

## Errors
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioCommitmentModification_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioCommitmentModification) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioCommitmentModification) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioCommitmentModification) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioCommitmentModification) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioCommitmentModification) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioCommitmentModification) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioCommitmentModification) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioCommitmentModification) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioCommitmentModification) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioCommitmentModification) 

# BatchUpdateBillScenarioUsageModification
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification"></a>

 Update a newly added or existing usage lines. You can update the usage amounts, usage hour, and usage group based on a usage ID and a Bill scenario ID. 

**Note**  
The `BatchUpdateBillScenarioUsageModification` operation doesn't have its own IAM permission. To authorize this operation for AWS principals, include the permission `bcm-pricing-calculator:UpdateBillScenarioUsageModification` in your policies.

## Request Syntax
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification_RequestSyntax"></a>

```
{
   "billScenarioId": "string",
   "usageModifications": [ 
      { 
         "amounts": [ 
            { 
               "amount": number,
               "startHour": number
            }
         ],
         "group": "string",
         "id": "string"
      }
   ]
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billScenarioId](#API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification-request-billScenarioId"></a>
 The ID of the Bill Scenario for which you want to modify the usage lines.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [usageModifications](#API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification-request-usageModifications"></a>
 List of usage lines that you want to update in a Bill Scenario identified by the usage ID.   
Type: Array of [BatchUpdateBillScenarioUsageModificationEntry](API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModificationEntry.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 25 items.  
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification_ResponseSyntax"></a>

```
{
   "errors": [ 
      { 
         "errorCode": "string",
         "errorMessage": "string",
         "id": "string"
      }
   ],
   "items": [ 
      { 
         "availabilityZone": "string",
         "group": "string",
         "historicalUsage": { 
            "billInterval": { 
               "end": number,
               "start": number
            },
            "filterExpression": { 
               "and": [ 
                  "Expression"
               ],
               "costCategories": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "dimensions": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "not": "Expression",
               "or": [ 
                  "Expression"
               ],
               "tags": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               }
            },
            "location": "string",
            "operation": "string",
            "serviceCode": "string",
            "usageAccountId": "string",
            "usageType": "string"
         },
         "id": "string",
         "location": "string",
         "operation": "string",
         "quantities": [ 
            { 
               "amount": number,
               "startHour": number,
               "unit": "string"
            }
         ],
         "serviceCode": "string",
         "usageAccountId": "string",
         "usageType": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errors](#API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification-response-errors"></a>
 Returns the list of error reasons and usage line item IDs that could not be updated for the Bill Scenario.   
Type: Array of [BatchUpdateBillScenarioUsageModificationError](API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModificationError.md) objects

 ** [items](#API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification-response-items"></a>
 Returns the list of successful usage line items that were updated for a Bill Scenario.   
Type: Array of [BillScenarioUsageModificationItem](API_AWSBCMPricingCalculator_BillScenarioUsageModificationItem.md) objects

## Errors
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ServiceQuotaExceededException **   
 The request would cause you to exceed your service quota.     
 ** quotaCode **   
 The quota code that was exceeded.   
 ** resourceId **   
 The identifier of the resource that exceeded quota.   
 ** resourceType **   
 The type of the resource that exceeded quota.   
 ** serviceCode **   
 The service code that exceeded quota. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) 

# BatchUpdateWorkloadEstimateUsage
<a name="API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage"></a>

 Update a newly added or existing usage lines. You can update the usage amounts and usage group based on a usage ID and a Workload estimate ID. 

**Note**  
The `BatchUpdateWorkloadEstimateUsage` operation doesn't have its own IAM permission. To authorize this operation for AWS principals, include the permission `bcm-pricing-calculator:UpdateWorkloadEstimateUsage` in your policies.

## Request Syntax
<a name="API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage_RequestSyntax"></a>

```
{
   "usage": [ 
      { 
         "amount": number,
         "group": "string",
         "id": "string"
      }
   ],
   "workloadEstimateId": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [usage](#API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage-request-usage"></a>
 List of usage line amounts and usage group that you want to update in a Workload estimate identified by the usage ID.   
Type: Array of [BatchUpdateWorkloadEstimateUsageEntry](API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsageEntry.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 25 items.  
Required: Yes

 ** [workloadEstimateId](#API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage-request-workloadEstimateId"></a>
 The ID of the Workload estimate for which you want to modify the usage lines.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage_ResponseSyntax"></a>

```
{
   "errors": [ 
      { 
         "errorCode": "string",
         "errorMessage": "string",
         "id": "string"
      }
   ],
   "items": [ 
      { 
         "cost": number,
         "currency": "string",
         "group": "string",
         "historicalUsage": { 
            "billInterval": { 
               "end": number,
               "start": number
            },
            "filterExpression": { 
               "and": [ 
                  "Expression"
               ],
               "costCategories": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "dimensions": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "not": "Expression",
               "or": [ 
                  "Expression"
               ],
               "tags": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               }
            },
            "location": "string",
            "operation": "string",
            "serviceCode": "string",
            "usageAccountId": "string",
            "usageType": "string"
         },
         "id": "string",
         "location": "string",
         "operation": "string",
         "quantity": { 
            "amount": number,
            "unit": "string"
         },
         "serviceCode": "string",
         "status": "string",
         "usageAccountId": "string",
         "usageType": "string"
      }
   ]
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [errors](#API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage-response-errors"></a>
 Returns the list of error reasons and usage line item IDs that could not be updated for the Workload estimate.   
Type: Array of [BatchUpdateWorkloadEstimateUsageError](API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsageError.md) objects

 ** [items](#API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage-response-items"></a>
 Returns the list of successful usage line items that were updated for a Workload estimate.   
Type: Array of [WorkloadEstimateUsageItem](API_AWSBCMPricingCalculator_WorkloadEstimateUsageItem.md) objects

## Errors
<a name="API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ServiceQuotaExceededException **   
 The request would cause you to exceed your service quota.     
 ** quotaCode **   
 The quota code that was exceeded.   
 ** resourceId **   
 The identifier of the resource that exceeded quota.   
 ** resourceType **   
 The type of the resource that exceeded quota.   
 ** serviceCode **   
 The service code that exceeded quota. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_BatchUpdateWorkloadEstimateUsage_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/BatchUpdateWorkloadEstimateUsage) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/BatchUpdateWorkloadEstimateUsage) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/BatchUpdateWorkloadEstimateUsage) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/BatchUpdateWorkloadEstimateUsage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/BatchUpdateWorkloadEstimateUsage) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/BatchUpdateWorkloadEstimateUsage) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/BatchUpdateWorkloadEstimateUsage) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/BatchUpdateWorkloadEstimateUsage) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/BatchUpdateWorkloadEstimateUsage) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/BatchUpdateWorkloadEstimateUsage) 

# CreateBillEstimate
<a name="API_AWSBCMPricingCalculator_CreateBillEstimate"></a>

 Create a Bill estimate from a Bill scenario. In the Bill scenario you can model usage addition, usage changes, and usage removal. You can also model commitment addition and commitment removal. After all changes in a Bill scenario is made satisfactorily, you can call this API with a Bill scenario ID to generate the Bill estimate. Bill estimate calculates the pre-tax cost for your consolidated billing family, incorporating all modeled usage and commitments alongside existing usage and commitments from your most recent completed anniversary bill, with any applicable discounts applied. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_CreateBillEstimate_RequestSyntax"></a>

```
{
   "billScenarioId": "string",
   "clientToken": "string",
   "name": "string",
   "tags": { 
      "string" : "string" 
   }
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_CreateBillEstimate_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billScenarioId](#API_AWSBCMPricingCalculator_CreateBillEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-request-billScenarioId"></a>
 The ID of the Bill Scenario for which you want to create a Bill estimate.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [clientToken](#API_AWSBCMPricingCalculator_CreateBillEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-request-clientToken"></a>
 A unique, case-sensitive identifier that you provide to ensure the idempotency of the request.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `[\u0021-\u007E]+`   
Required: No

 ** [name](#API_AWSBCMPricingCalculator_CreateBillEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-request-name"></a>
 The name of the Bill estimate that will be created. Names must be unique for an account.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+`   
Required: Yes

 ** [tags](#API_AWSBCMPricingCalculator_CreateBillEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-request-tags"></a>
 An optional list of tags to associate with the specified BillEstimate. You can use resource tags to control access to your BillEstimate using IAM policies. Each tag consists of a key and a value, and each key must be unique for the resource. The following restrictions apply to resource tags:   
+ Although the maximum number of array members is 200, you can assign a maximum of 50 user-tags to one resource. The remaining are reserved for AWS. 
+ The maximum length of a key is 128 characters.
+ The maximum length of a value is 256 characters.
+ Keys and values can only contain alphanumeric characters, spaces, and any of the following: `_.:/=+@-`.
+ Keys and values are case sensitive.
+ Keys and values are trimmed for any leading or trailing whitespaces.
+ Don't use `aws:` as a prefix for your keys. This prefix is reserved for AWS.
Type: String to string map  
Map Entries: Minimum number of 0 items. Maximum number of 200 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 128.  
Key Pattern: `[\w\s:+=@/-]+`   
Value Length Constraints: Minimum length of 0. Maximum length of 256.  
Value Pattern: `[\w\s:+=@/-]*`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseSyntax"></a>

```
{
   "billInterval": { 
      "end": number,
      "start": number
   },
   "costCategoryGroupSharingPreferenceArn": "string",
   "costCategoryGroupSharingPreferenceEffectiveDate": number,
   "costSummary": { 
      "serviceCostDifferences": { 
         "string" : { 
            "estimatedCost": { 
               "amount": number,
               "currency": "string"
            },
            "historicalCost": { 
               "amount": number,
               "currency": "string"
            }
         }
      },
      "totalCostDifference": { 
         "estimatedCost": { 
            "amount": number,
            "currency": "string"
         },
         "historicalCost": { 
            "amount": number,
            "currency": "string"
         }
      }
   },
   "createdAt": number,
   "expiresAt": number,
   "failureMessage": "string",
   "groupSharingPreference": "string",
   "id": "string",
   "name": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [billInterval](#API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-response-billInterval"></a>
 The bill month start and end timestamp that was used to create the Bill estimate. This is set to the last complete anniversary bill month start and end timestamp.   
Type: [BillInterval](API_AWSBCMPricingCalculator_BillInterval.md) object

 ** [costCategoryGroupSharingPreferenceArn](#API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-response-costCategoryGroupSharingPreferenceArn"></a>
The arn of the cost category used in the reserved and prioritized group sharing.  
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 2048.  
Pattern: `arn:aws[-a-z0-9]*:ce::[0-9]{12}:costcategory/[a-f0-9-]{36}` 

 ** [costCategoryGroupSharingPreferenceEffectiveDate](#API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-response-costCategoryGroupSharingPreferenceEffectiveDate"></a>
Timestamp of the effective date of the cost category used in the group sharing settings.  
Type: Timestamp

 ** [costSummary](#API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-response-costSummary"></a>
 Returns summary-level cost information once a Bill estimate is successfully generated. This summary includes: 1) the total cost difference, showing the pre-tax cost change for the consolidated billing family between the completed anniversary bill and the estimated bill, and 2) total cost differences per service, detailing the pre-tax cost of each service, comparing the completed anniversary bill to the estimated bill on a per-service basis.   
Type: [BillEstimateCostSummary](API_AWSBCMPricingCalculator_BillEstimateCostSummary.md) object

 ** [createdAt](#API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-response-createdAt"></a>
 The timestamp of when the Bill estimate create process was started (not when it successfully completed or failed).   
Type: Timestamp

 ** [expiresAt](#API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-response-expiresAt"></a>
 The timestamp of when the Bill estimate will expire. A Bill estimate becomes inaccessible after expiration.   
Type: Timestamp

 ** [failureMessage](#API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-response-failureMessage"></a>
 This attribute provides the reason if a Bill estimate result generation fails.   
Type: String

 ** [groupSharingPreference](#API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-response-groupSharingPreference"></a>
The setting for the reserved instance and savings plans group sharing used in this estimate.  
Type: String  
Valid Values: `OPEN | PRIORITIZED | RESTRICTED` 

 ** [id](#API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-response-id"></a>
 The unique identifier of your newly created Bill estimate.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 

 ** [name](#API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-response-name"></a>
 The name of your newly created Bill estimate.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+` 

 ** [status](#API_AWSBCMPricingCalculator_CreateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillEstimate-response-status"></a>
 The status of your newly created Bill estimate. Bill estimate creation can take anywhere between 8 to 12 hours. The status will allow you to identify when the Bill estimate is complete or has failed.   
Type: String  
Valid Values: `IN_PROGRESS | COMPLETE | FAILED` 

## Errors
<a name="API_AWSBCMPricingCalculator_CreateBillEstimate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_CreateBillEstimate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/CreateBillEstimate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/CreateBillEstimate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/CreateBillEstimate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/CreateBillEstimate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/CreateBillEstimate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/CreateBillEstimate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/CreateBillEstimate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/CreateBillEstimate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/CreateBillEstimate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/CreateBillEstimate) 

# CreateBillScenario
<a name="API_AWSBCMPricingCalculator_CreateBillScenario"></a>

 Creates a new bill scenario to model potential changes to AWS usage and costs. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_CreateBillScenario_RequestSyntax"></a>

```
{
   "clientToken": "string",
   "costCategoryGroupSharingPreferenceArn": "string",
   "groupSharingPreference": "string",
   "name": "string",
   "tags": { 
      "string" : "string" 
   }
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_CreateBillScenario_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [clientToken](#API_AWSBCMPricingCalculator_CreateBillScenario_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-request-clientToken"></a>
 A unique, case-sensitive identifier to ensure idempotency of the request.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `[\u0021-\u007E]+`   
Required: No

 ** [costCategoryGroupSharingPreferenceArn](#API_AWSBCMPricingCalculator_CreateBillScenario_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-request-costCategoryGroupSharingPreferenceArn"></a>
The arn of the cost category used in the reserved and prioritized group sharing.  
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 2048.  
Pattern: `arn:aws[-a-z0-9]*:ce::[0-9]{12}:costcategory/[a-f0-9-]{36}`   
Required: No

 ** [groupSharingPreference](#API_AWSBCMPricingCalculator_CreateBillScenario_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-request-groupSharingPreference"></a>
The setting for the reserved instance and savings plans group sharing used in this estimate.  
Type: String  
Valid Values: `OPEN | PRIORITIZED | RESTRICTED`   
Required: No

 ** [name](#API_AWSBCMPricingCalculator_CreateBillScenario_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-request-name"></a>
 A descriptive name for the bill scenario.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+`   
Required: Yes

 ** [tags](#API_AWSBCMPricingCalculator_CreateBillScenario_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-request-tags"></a>
 The tags to apply to the bill scenario.   
Type: String to string map  
Map Entries: Minimum number of 0 items. Maximum number of 200 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 128.  
Key Pattern: `[\w\s:+=@/-]+`   
Value Length Constraints: Minimum length of 0. Maximum length of 256.  
Value Pattern: `[\w\s:+=@/-]*`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_CreateBillScenario_ResponseSyntax"></a>

```
{
   "billInterval": { 
      "end": number,
      "start": number
   },
   "costCategoryGroupSharingPreferenceArn": "string",
   "createdAt": number,
   "expiresAt": number,
   "failureMessage": "string",
   "groupSharingPreference": "string",
   "id": "string",
   "name": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_CreateBillScenario_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [billInterval](#API_AWSBCMPricingCalculator_CreateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-response-billInterval"></a>
 The time period covered by the bill scenario.   
Type: [BillInterval](API_AWSBCMPricingCalculator_BillInterval.md) object

 ** [costCategoryGroupSharingPreferenceArn](#API_AWSBCMPricingCalculator_CreateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-response-costCategoryGroupSharingPreferenceArn"></a>
The arn of the cost category used in the reserved and prioritized group sharing.  
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 2048.  
Pattern: `arn:aws[-a-z0-9]*:ce::[0-9]{12}:costcategory/[a-f0-9-]{36}` 

 ** [createdAt](#API_AWSBCMPricingCalculator_CreateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-response-createdAt"></a>
 The timestamp when the bill scenario was created.   
Type: Timestamp

 ** [expiresAt](#API_AWSBCMPricingCalculator_CreateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-response-expiresAt"></a>
 The timestamp when the bill scenario will expire.   
Type: Timestamp

 ** [failureMessage](#API_AWSBCMPricingCalculator_CreateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-response-failureMessage"></a>
 An error message if the bill scenario creation failed.   
Type: String

 ** [groupSharingPreference](#API_AWSBCMPricingCalculator_CreateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-response-groupSharingPreference"></a>
The setting for the reserved instance and savings plans group sharing used in this estimate.  
Type: String  
Valid Values: `OPEN | PRIORITIZED | RESTRICTED` 

 ** [id](#API_AWSBCMPricingCalculator_CreateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-response-id"></a>
 The unique identifier for the created bill scenario.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 

 ** [name](#API_AWSBCMPricingCalculator_CreateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-response-name"></a>
 The name of the created bill scenario.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+` 

 ** [status](#API_AWSBCMPricingCalculator_CreateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateBillScenario-response-status"></a>
 The current status of the bill scenario.   
Type: String  
Valid Values: `READY | LOCKED | FAILED | STALE` 

## Errors
<a name="API_AWSBCMPricingCalculator_CreateBillScenario_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ServiceQuotaExceededException **   
 The request would cause you to exceed your service quota.     
 ** quotaCode **   
 The quota code that was exceeded.   
 ** resourceId **   
 The identifier of the resource that exceeded quota.   
 ** resourceType **   
 The type of the resource that exceeded quota.   
 ** serviceCode **   
 The service code that exceeded quota. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_CreateBillScenario_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/CreateBillScenario) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/CreateBillScenario) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/CreateBillScenario) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/CreateBillScenario) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/CreateBillScenario) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/CreateBillScenario) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/CreateBillScenario) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/CreateBillScenario) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/CreateBillScenario) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/CreateBillScenario) 

# CreateWorkloadEstimate
<a name="API_AWSBCMPricingCalculator_CreateWorkloadEstimate"></a>

 Creates a new workload estimate to model costs for a specific workload. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_CreateWorkloadEstimate_RequestSyntax"></a>

```
{
   "clientToken": "string",
   "name": "string",
   "rateType": "string",
   "tags": { 
      "string" : "string" 
   }
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_CreateWorkloadEstimate_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [clientToken](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-request-clientToken"></a>
 A unique, case-sensitive identifier to ensure idempotency of the request.   
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 64.  
Pattern: `[\u0021-\u007E]+`   
Required: No

 ** [name](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-request-name"></a>
 A descriptive name for the workload estimate.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+`   
Required: Yes

 ** [rateType](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-request-rateType"></a>
 The type of pricing rates to use for the estimate.   
Type: String  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS`   
Required: No

 ** [tags](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-request-tags"></a>
 The tags to apply to the workload estimate.   
Type: String to string map  
Map Entries: Minimum number of 0 items. Maximum number of 200 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 128.  
Key Pattern: `[\w\s:+=@/-]+`   
Value Length Constraints: Minimum length of 0. Maximum length of 256.  
Value Pattern: `[\w\s:+=@/-]*`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_CreateWorkloadEstimate_ResponseSyntax"></a>

```
{
   "costCurrency": "string",
   "createdAt": number,
   "expiresAt": number,
   "failureMessage": "string",
   "id": "string",
   "name": "string",
   "rateTimestamp": number,
   "rateType": "string",
   "status": "string",
   "totalCost": number
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_CreateWorkloadEstimate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [costCurrency](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-response-costCurrency"></a>
 The currency of the estimated cost.   
Type: String  
Valid Values: `USD` 

 ** [createdAt](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-response-createdAt"></a>
 The timestamp when the workload estimate was created.   
Type: Timestamp

 ** [expiresAt](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-response-expiresAt"></a>
 The timestamp when the workload estimate will expire.   
Type: Timestamp

 ** [failureMessage](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-response-failureMessage"></a>
 An error message if the workload estimate creation failed.   
Type: String

 ** [id](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-response-id"></a>
 The unique identifier for the created workload estimate.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 

 ** [name](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-response-name"></a>
 The name of the created workload estimate.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+` 

 ** [rateTimestamp](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-response-rateTimestamp"></a>
 The timestamp of the pricing rates used for the estimate.   
Type: Timestamp

 ** [rateType](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-response-rateType"></a>
 The type of pricing rates used for the estimate.   
Type: String  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS` 

 ** [status](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-response-status"></a>
 The current status of the workload estimate.   
Type: String  
Valid Values: `UPDATING | VALID | INVALID | ACTION_NEEDED` 

 ** [totalCost](#API_AWSBCMPricingCalculator_CreateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_CreateWorkloadEstimate-response-totalCost"></a>
 The total estimated cost for the workload.   
Type: Double

## Errors
<a name="API_AWSBCMPricingCalculator_CreateWorkloadEstimate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ServiceQuotaExceededException **   
 The request would cause you to exceed your service quota.     
 ** quotaCode **   
 The quota code that was exceeded.   
 ** resourceId **   
 The identifier of the resource that exceeded quota.   
 ** resourceType **   
 The type of the resource that exceeded quota.   
 ** serviceCode **   
 The service code that exceeded quota. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_CreateWorkloadEstimate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/CreateWorkloadEstimate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/CreateWorkloadEstimate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/CreateWorkloadEstimate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/CreateWorkloadEstimate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/CreateWorkloadEstimate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/CreateWorkloadEstimate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/CreateWorkloadEstimate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/CreateWorkloadEstimate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/CreateWorkloadEstimate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/CreateWorkloadEstimate) 

# DeleteBillEstimate
<a name="API_AWSBCMPricingCalculator_DeleteBillEstimate"></a>

 Deletes an existing bill estimate. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_DeleteBillEstimate_RequestSyntax"></a>

```
{
   "identifier": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_DeleteBillEstimate_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [identifier](#API_AWSBCMPricingCalculator_DeleteBillEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_DeleteBillEstimate-request-identifier"></a>
 The unique identifier of the bill estimate to delete.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

## Response Elements
<a name="API_AWSBCMPricingCalculator_DeleteBillEstimate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_AWSBCMPricingCalculator_DeleteBillEstimate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_DeleteBillEstimate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/DeleteBillEstimate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/DeleteBillEstimate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/DeleteBillEstimate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/DeleteBillEstimate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/DeleteBillEstimate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/DeleteBillEstimate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/DeleteBillEstimate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/DeleteBillEstimate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/DeleteBillEstimate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/DeleteBillEstimate) 

# DeleteBillScenario
<a name="API_AWSBCMPricingCalculator_DeleteBillScenario"></a>

 Deletes an existing bill scenario. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_DeleteBillScenario_RequestSyntax"></a>

```
{
   "identifier": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_DeleteBillScenario_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [identifier](#API_AWSBCMPricingCalculator_DeleteBillScenario_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_DeleteBillScenario-request-identifier"></a>
 The unique identifier of the bill scenario to delete.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

## Response Elements
<a name="API_AWSBCMPricingCalculator_DeleteBillScenario_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_AWSBCMPricingCalculator_DeleteBillScenario_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_DeleteBillScenario_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/DeleteBillScenario) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/DeleteBillScenario) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/DeleteBillScenario) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/DeleteBillScenario) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/DeleteBillScenario) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/DeleteBillScenario) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/DeleteBillScenario) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/DeleteBillScenario) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/DeleteBillScenario) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/DeleteBillScenario) 

# DeleteWorkloadEstimate
<a name="API_AWSBCMPricingCalculator_DeleteWorkloadEstimate"></a>

 Deletes an existing workload estimate. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_DeleteWorkloadEstimate_RequestSyntax"></a>

```
{
   "identifier": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_DeleteWorkloadEstimate_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [identifier](#API_AWSBCMPricingCalculator_DeleteWorkloadEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_DeleteWorkloadEstimate-request-identifier"></a>
 The unique identifier of the workload estimate to delete.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

## Response Elements
<a name="API_AWSBCMPricingCalculator_DeleteWorkloadEstimate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_AWSBCMPricingCalculator_DeleteWorkloadEstimate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_DeleteWorkloadEstimate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/DeleteWorkloadEstimate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/DeleteWorkloadEstimate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/DeleteWorkloadEstimate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/DeleteWorkloadEstimate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/DeleteWorkloadEstimate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/DeleteWorkloadEstimate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/DeleteWorkloadEstimate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/DeleteWorkloadEstimate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/DeleteWorkloadEstimate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/DeleteWorkloadEstimate) 

# GetBillEstimate
<a name="API_AWSBCMPricingCalculator_GetBillEstimate"></a>

 Retrieves details of a specific bill estimate. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_GetBillEstimate_RequestSyntax"></a>

```
{
   "identifier": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_GetBillEstimate_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [identifier](#API_AWSBCMPricingCalculator_GetBillEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillEstimate-request-identifier"></a>
 The unique identifier of the bill estimate to retrieve.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_GetBillEstimate_ResponseSyntax"></a>

```
{
   "billInterval": { 
      "end": number,
      "start": number
   },
   "costCategoryGroupSharingPreferenceArn": "string",
   "costCategoryGroupSharingPreferenceEffectiveDate": number,
   "costSummary": { 
      "serviceCostDifferences": { 
         "string" : { 
            "estimatedCost": { 
               "amount": number,
               "currency": "string"
            },
            "historicalCost": { 
               "amount": number,
               "currency": "string"
            }
         }
      },
      "totalCostDifference": { 
         "estimatedCost": { 
            "amount": number,
            "currency": "string"
         },
         "historicalCost": { 
            "amount": number,
            "currency": "string"
         }
      }
   },
   "createdAt": number,
   "expiresAt": number,
   "failureMessage": "string",
   "groupSharingPreference": "string",
   "id": "string",
   "name": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_GetBillEstimate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [billInterval](#API_AWSBCMPricingCalculator_GetBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillEstimate-response-billInterval"></a>
 The time period covered by the bill estimate.   
Type: [BillInterval](API_AWSBCMPricingCalculator_BillInterval.md) object

 ** [costCategoryGroupSharingPreferenceArn](#API_AWSBCMPricingCalculator_GetBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillEstimate-response-costCategoryGroupSharingPreferenceArn"></a>
The arn of the cost category used in the reserved and prioritized group sharing.  
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 2048.  
Pattern: `arn:aws[-a-z0-9]*:ce::[0-9]{12}:costcategory/[a-f0-9-]{36}` 

 ** [costCategoryGroupSharingPreferenceEffectiveDate](#API_AWSBCMPricingCalculator_GetBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillEstimate-response-costCategoryGroupSharingPreferenceEffectiveDate"></a>
Timestamp of the effective date of the cost category used in the group sharing settings.  
Type: Timestamp

 ** [costSummary](#API_AWSBCMPricingCalculator_GetBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillEstimate-response-costSummary"></a>
 A summary of the estimated costs.   
Type: [BillEstimateCostSummary](API_AWSBCMPricingCalculator_BillEstimateCostSummary.md) object

 ** [createdAt](#API_AWSBCMPricingCalculator_GetBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillEstimate-response-createdAt"></a>
 The timestamp when the bill estimate was created.   
Type: Timestamp

 ** [expiresAt](#API_AWSBCMPricingCalculator_GetBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillEstimate-response-expiresAt"></a>
 The timestamp when the bill estimate will expire.   
Type: Timestamp

 ** [failureMessage](#API_AWSBCMPricingCalculator_GetBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillEstimate-response-failureMessage"></a>
 An error message if the bill estimate retrieval failed.   
Type: String

 ** [groupSharingPreference](#API_AWSBCMPricingCalculator_GetBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillEstimate-response-groupSharingPreference"></a>
The setting for the reserved instance and savings plans group sharing used in this estimate.  
Type: String  
Valid Values: `OPEN | PRIORITIZED | RESTRICTED` 

 ** [id](#API_AWSBCMPricingCalculator_GetBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillEstimate-response-id"></a>
 The unique identifier of the retrieved bill estimate.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 

 ** [name](#API_AWSBCMPricingCalculator_GetBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillEstimate-response-name"></a>
 The name of the retrieved bill estimate.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+` 

 ** [status](#API_AWSBCMPricingCalculator_GetBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillEstimate-response-status"></a>
 The current status of the bill estimate.   
Type: String  
Valid Values: `IN_PROGRESS | COMPLETE | FAILED` 

## Errors
<a name="API_AWSBCMPricingCalculator_GetBillEstimate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_GetBillEstimate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/GetBillEstimate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/GetBillEstimate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/GetBillEstimate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/GetBillEstimate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/GetBillEstimate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/GetBillEstimate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/GetBillEstimate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/GetBillEstimate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/GetBillEstimate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/GetBillEstimate) 

# GetBillScenario
<a name="API_AWSBCMPricingCalculator_GetBillScenario"></a>

 Retrieves details of a specific bill scenario. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_GetBillScenario_RequestSyntax"></a>

```
{
   "identifier": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_GetBillScenario_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [identifier](#API_AWSBCMPricingCalculator_GetBillScenario_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillScenario-request-identifier"></a>
 The unique identifier of the bill scenario to retrieve.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_GetBillScenario_ResponseSyntax"></a>

```
{
   "billInterval": { 
      "end": number,
      "start": number
   },
   "costCategoryGroupSharingPreferenceArn": "string",
   "createdAt": number,
   "expiresAt": number,
   "failureMessage": "string",
   "groupSharingPreference": "string",
   "id": "string",
   "name": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_GetBillScenario_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [billInterval](#API_AWSBCMPricingCalculator_GetBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillScenario-response-billInterval"></a>
 The time period covered by the bill scenario.   
Type: [BillInterval](API_AWSBCMPricingCalculator_BillInterval.md) object

 ** [costCategoryGroupSharingPreferenceArn](#API_AWSBCMPricingCalculator_GetBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillScenario-response-costCategoryGroupSharingPreferenceArn"></a>
The arn of the cost category used in the reserved and prioritized group sharing.  
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 2048.  
Pattern: `arn:aws[-a-z0-9]*:ce::[0-9]{12}:costcategory/[a-f0-9-]{36}` 

 ** [createdAt](#API_AWSBCMPricingCalculator_GetBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillScenario-response-createdAt"></a>
 The timestamp when the bill scenario was created.   
Type: Timestamp

 ** [expiresAt](#API_AWSBCMPricingCalculator_GetBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillScenario-response-expiresAt"></a>
 The timestamp when the bill scenario will expire.   
Type: Timestamp

 ** [failureMessage](#API_AWSBCMPricingCalculator_GetBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillScenario-response-failureMessage"></a>
 An error message if the bill scenario retrieval failed.   
Type: String

 ** [groupSharingPreference](#API_AWSBCMPricingCalculator_GetBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillScenario-response-groupSharingPreference"></a>
The setting for the reserved instance and savings plans group sharing used in this estimate.  
Type: String  
Valid Values: `OPEN | PRIORITIZED | RESTRICTED` 

 ** [id](#API_AWSBCMPricingCalculator_GetBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillScenario-response-id"></a>
 The unique identifier of the retrieved bill scenario.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 

 ** [name](#API_AWSBCMPricingCalculator_GetBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillScenario-response-name"></a>
 The name of the retrieved bill scenario.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+` 

 ** [status](#API_AWSBCMPricingCalculator_GetBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetBillScenario-response-status"></a>
 The current status of the bill scenario.   
Type: String  
Valid Values: `READY | LOCKED | FAILED | STALE` 

## Errors
<a name="API_AWSBCMPricingCalculator_GetBillScenario_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_GetBillScenario_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/GetBillScenario) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/GetBillScenario) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/GetBillScenario) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/GetBillScenario) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/GetBillScenario) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/GetBillScenario) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/GetBillScenario) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/GetBillScenario) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/GetBillScenario) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/GetBillScenario) 

# GetPreferences
<a name="API_AWSBCMPricingCalculator_GetPreferences"></a>

 Retrieves the current preferences for AWS Pricing Calculator. 

## Response Syntax
<a name="API_AWSBCMPricingCalculator_GetPreferences_ResponseSyntax"></a>

```
{
   "managementAccountRateTypeSelections": [ "string" ],
   "memberAccountRateTypeSelections": [ "string" ],
   "standaloneAccountRateTypeSelections": [ "string" ]
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_GetPreferences_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [managementAccountRateTypeSelections](#API_AWSBCMPricingCalculator_GetPreferences_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetPreferences-response-managementAccountRateTypeSelections"></a>
 The preferred rate types for the management account.   
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 3 items.  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS` 

 ** [memberAccountRateTypeSelections](#API_AWSBCMPricingCalculator_GetPreferences_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetPreferences-response-memberAccountRateTypeSelections"></a>
 The preferred rate types for member accounts.   
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 3 items.  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS` 

 ** [standaloneAccountRateTypeSelections](#API_AWSBCMPricingCalculator_GetPreferences_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetPreferences-response-standaloneAccountRateTypeSelections"></a>
 The preferred rate types for a standalone account.   
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 3 items.  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS` 

## Errors
<a name="API_AWSBCMPricingCalculator_GetPreferences_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_GetPreferences_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/GetPreferences) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/GetPreferences) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/GetPreferences) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/GetPreferences) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/GetPreferences) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/GetPreferences) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/GetPreferences) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/GetPreferences) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/GetPreferences) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/GetPreferences) 

# GetWorkloadEstimate
<a name="API_AWSBCMPricingCalculator_GetWorkloadEstimate"></a>

 Retrieves details of a specific workload estimate. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_GetWorkloadEstimate_RequestSyntax"></a>

```
{
   "identifier": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_GetWorkloadEstimate_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [identifier](#API_AWSBCMPricingCalculator_GetWorkloadEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetWorkloadEstimate-request-identifier"></a>
 The unique identifier of the workload estimate to retrieve.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_GetWorkloadEstimate_ResponseSyntax"></a>

```
{
   "costCurrency": "string",
   "createdAt": number,
   "expiresAt": number,
   "failureMessage": "string",
   "id": "string",
   "name": "string",
   "rateTimestamp": number,
   "rateType": "string",
   "status": "string",
   "totalCost": number
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_GetWorkloadEstimate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [costCurrency](#API_AWSBCMPricingCalculator_GetWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetWorkloadEstimate-response-costCurrency"></a>
 The currency of the estimated cost.   
Type: String  
Valid Values: `USD` 

 ** [createdAt](#API_AWSBCMPricingCalculator_GetWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetWorkloadEstimate-response-createdAt"></a>
 The timestamp when the workload estimate was created.   
Type: Timestamp

 ** [expiresAt](#API_AWSBCMPricingCalculator_GetWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetWorkloadEstimate-response-expiresAt"></a>
 The timestamp when the workload estimate will expire.   
Type: Timestamp

 ** [failureMessage](#API_AWSBCMPricingCalculator_GetWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetWorkloadEstimate-response-failureMessage"></a>
 An error message if the workload estimate retrieval failed.   
Type: String

 ** [id](#API_AWSBCMPricingCalculator_GetWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetWorkloadEstimate-response-id"></a>
 The unique identifier of the retrieved workload estimate.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 

 ** [name](#API_AWSBCMPricingCalculator_GetWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetWorkloadEstimate-response-name"></a>
 The name of the retrieved workload estimate.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+` 

 ** [rateTimestamp](#API_AWSBCMPricingCalculator_GetWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetWorkloadEstimate-response-rateTimestamp"></a>
 The timestamp of the pricing rates used for the estimate.   
Type: Timestamp

 ** [rateType](#API_AWSBCMPricingCalculator_GetWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetWorkloadEstimate-response-rateType"></a>
 The type of pricing rates used for the estimate.   
Type: String  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS` 

 ** [status](#API_AWSBCMPricingCalculator_GetWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetWorkloadEstimate-response-status"></a>
 The current status of the workload estimate.   
Type: String  
Valid Values: `UPDATING | VALID | INVALID | ACTION_NEEDED` 

 ** [totalCost](#API_AWSBCMPricingCalculator_GetWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_GetWorkloadEstimate-response-totalCost"></a>
 The total estimated cost for the workload.   
Type: Double

## Errors
<a name="API_AWSBCMPricingCalculator_GetWorkloadEstimate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_GetWorkloadEstimate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/GetWorkloadEstimate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/GetWorkloadEstimate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/GetWorkloadEstimate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/GetWorkloadEstimate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/GetWorkloadEstimate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/GetWorkloadEstimate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/GetWorkloadEstimate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/GetWorkloadEstimate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/GetWorkloadEstimate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/GetWorkloadEstimate) 

# ListBillEstimateCommitments
<a name="API_AWSBCMPricingCalculator_ListBillEstimateCommitments"></a>

 Lists the commitments associated with a bill estimate. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_ListBillEstimateCommitments_RequestSyntax"></a>

```
{
   "billEstimateId": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_ListBillEstimateCommitments_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billEstimateId](#API_AWSBCMPricingCalculator_ListBillEstimateCommitments_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateCommitments-request-billEstimateId"></a>
 The unique identifier of the bill estimate to list commitments for.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [maxResults](#API_AWSBCMPricingCalculator_ListBillEstimateCommitments_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateCommitments-request-maxResults"></a>
 The maximum number of results to return per page.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 25.  
Required: No

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillEstimateCommitments_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateCommitments-request-nextToken"></a>
 A token to retrieve the next page of results.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_ListBillEstimateCommitments_ResponseSyntax"></a>

```
{
   "items": [ 
      { 
         "id": "string",
         "monthlyPayment": { 
            "amount": number,
            "currency": "string"
         },
         "offeringId": "string",
         "paymentOption": "string",
         "purchaseAgreementType": "string",
         "region": "string",
         "termLength": "string",
         "upfrontPayment": { 
            "amount": number,
            "currency": "string"
         },
         "usageAccountId": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_ListBillEstimateCommitments_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [items](#API_AWSBCMPricingCalculator_ListBillEstimateCommitments_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateCommitments-response-items"></a>
 The list of commitments associated with the bill estimate.   
Type: Array of [BillEstimateCommitmentSummary](API_AWSBCMPricingCalculator_BillEstimateCommitmentSummary.md) objects

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillEstimateCommitments_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateCommitments-response-nextToken"></a>
 A token to retrieve the next page of results, if any.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*` 

## Errors
<a name="API_AWSBCMPricingCalculator_ListBillEstimateCommitments_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_ListBillEstimateCommitments_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/ListBillEstimateCommitments) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/ListBillEstimateCommitments) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/ListBillEstimateCommitments) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/ListBillEstimateCommitments) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/ListBillEstimateCommitments) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/ListBillEstimateCommitments) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/ListBillEstimateCommitments) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/ListBillEstimateCommitments) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/ListBillEstimateCommitments) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/ListBillEstimateCommitments) 

# ListBillEstimateInputCommitmentModifications
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications"></a>

 Lists the input commitment modifications associated with a bill estimate. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications_RequestSyntax"></a>

```
{
   "billEstimateId": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billEstimateId](#API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications-request-billEstimateId"></a>
 The unique identifier of the bill estimate to list input commitment modifications for.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [maxResults](#API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications-request-maxResults"></a>
 The maximum number of results to return per page.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 25.  
Required: No

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications-request-nextToken"></a>
 A token to retrieve the next page of results.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications_ResponseSyntax"></a>

```
{
   "items": [ 
      { 
         "commitmentAction": { ... },
         "group": "string",
         "id": "string",
         "usageAccountId": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [items](#API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications-response-items"></a>
 The list of input commitment modifications associated with the bill estimate.   
Type: Array of [BillEstimateInputCommitmentModificationSummary](API_AWSBCMPricingCalculator_BillEstimateInputCommitmentModificationSummary.md) objects

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications-response-nextToken"></a>
 A token to retrieve the next page of results, if any.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*` 

## Errors
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputCommitmentModifications_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputCommitmentModifications) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputCommitmentModifications) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputCommitmentModifications) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputCommitmentModifications) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputCommitmentModifications) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputCommitmentModifications) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputCommitmentModifications) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputCommitmentModifications) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputCommitmentModifications) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputCommitmentModifications) 

# ListBillEstimateInputUsageModifications
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications"></a>

 Lists the input usage modifications associated with a bill estimate. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications_RequestSyntax"></a>

```
{
   "billEstimateId": "string",
   "filters": [ 
      { 
         "matchOption": "string",
         "name": "string",
         "values": [ "string" ]
      }
   ],
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billEstimateId](#API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications-request-billEstimateId"></a>
 The unique identifier of the bill estimate to list input usage modifications for.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [filters](#API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications-request-filters"></a>
 Filters to apply to the list of input usage modifications.   
Type: Array of [ListUsageFilter](API_AWSBCMPricingCalculator_ListUsageFilter.md) objects  
Required: No

 ** [maxResults](#API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications-request-maxResults"></a>
 The maximum number of results to return per page.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 25.  
Required: No

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications-request-nextToken"></a>
 A token to retrieve the next page of results.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications_ResponseSyntax"></a>

```
{
   "items": [ 
      { 
         "availabilityZone": "string",
         "group": "string",
         "historicalUsage": { 
            "billInterval": { 
               "end": number,
               "start": number
            },
            "filterExpression": { 
               "and": [ 
                  "Expression"
               ],
               "costCategories": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "dimensions": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "not": "Expression",
               "or": [ 
                  "Expression"
               ],
               "tags": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               }
            },
            "location": "string",
            "operation": "string",
            "serviceCode": "string",
            "usageAccountId": "string",
            "usageType": "string"
         },
         "id": "string",
         "location": "string",
         "operation": "string",
         "quantities": [ 
            { 
               "amount": number,
               "startHour": number,
               "unit": "string"
            }
         ],
         "serviceCode": "string",
         "usageAccountId": "string",
         "usageType": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [items](#API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications-response-items"></a>
 The list of input usage modifications associated with the bill estimate.   
Type: Array of [BillEstimateInputUsageModificationSummary](API_AWSBCMPricingCalculator_BillEstimateInputUsageModificationSummary.md) objects

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications-response-nextToken"></a>
 A token to retrieve the next page of results, if any.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*` 

## Errors
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_ListBillEstimateInputUsageModifications_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputUsageModifications) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputUsageModifications) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputUsageModifications) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputUsageModifications) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputUsageModifications) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputUsageModifications) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputUsageModifications) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputUsageModifications) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputUsageModifications) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/ListBillEstimateInputUsageModifications) 

# ListBillEstimateLineItems
<a name="API_AWSBCMPricingCalculator_ListBillEstimateLineItems"></a>

 Lists the line items associated with a bill estimate. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_ListBillEstimateLineItems_RequestSyntax"></a>

```
{
   "billEstimateId": "string",
   "filters": [ 
      { 
         "matchOption": "string",
         "name": "string",
         "values": [ "string" ]
      }
   ],
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_ListBillEstimateLineItems_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billEstimateId](#API_AWSBCMPricingCalculator_ListBillEstimateLineItems_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateLineItems-request-billEstimateId"></a>
 The unique identifier of the bill estimate to list line items for.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [filters](#API_AWSBCMPricingCalculator_ListBillEstimateLineItems_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateLineItems-request-filters"></a>
 Filters to apply to the list of line items.   
Type: Array of [ListBillEstimateLineItemsFilter](API_AWSBCMPricingCalculator_ListBillEstimateLineItemsFilter.md) objects  
Required: No

 ** [maxResults](#API_AWSBCMPricingCalculator_ListBillEstimateLineItems_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateLineItems-request-maxResults"></a>
 The maximum number of results to return per page.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 25.  
Required: No

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillEstimateLineItems_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateLineItems-request-nextToken"></a>
 A token to retrieve the next page of results.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_ListBillEstimateLineItems_ResponseSyntax"></a>

```
{
   "items": [ 
      { 
         "availabilityZone": "string",
         "estimatedCost": { 
            "amount": number,
            "currency": "string"
         },
         "estimatedUsageQuantity": { 
            "amount": number,
            "unit": "string"
         },
         "historicalCost": { 
            "amount": number,
            "currency": "string"
         },
         "historicalUsageQuantity": { 
            "amount": number,
            "unit": "string"
         },
         "id": "string",
         "lineItemId": "string",
         "lineItemType": "string",
         "location": "string",
         "operation": "string",
         "payerAccountId": "string",
         "savingsPlanArns": [ "string" ],
         "serviceCode": "string",
         "usageAccountId": "string",
         "usageType": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_ListBillEstimateLineItems_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [items](#API_AWSBCMPricingCalculator_ListBillEstimateLineItems_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateLineItems-response-items"></a>
 The list of line items associated with the bill estimate.   
Type: Array of [BillEstimateLineItemSummary](API_AWSBCMPricingCalculator_BillEstimateLineItemSummary.md) objects

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillEstimateLineItems_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimateLineItems-response-nextToken"></a>
 A token to retrieve the next page of results, if any.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*` 

## Errors
<a name="API_AWSBCMPricingCalculator_ListBillEstimateLineItems_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_ListBillEstimateLineItems_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/ListBillEstimateLineItems) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/ListBillEstimateLineItems) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/ListBillEstimateLineItems) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/ListBillEstimateLineItems) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/ListBillEstimateLineItems) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/ListBillEstimateLineItems) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/ListBillEstimateLineItems) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/ListBillEstimateLineItems) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/ListBillEstimateLineItems) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/ListBillEstimateLineItems) 

# ListBillEstimates
<a name="API_AWSBCMPricingCalculator_ListBillEstimates"></a>

 Lists all bill estimates for the account. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_ListBillEstimates_RequestSyntax"></a>

```
{
   "createdAtFilter": { 
      "afterTimestamp": number,
      "beforeTimestamp": number
   },
   "expiresAtFilter": { 
      "afterTimestamp": number,
      "beforeTimestamp": number
   },
   "filters": [ 
      { 
         "matchOption": "string",
         "name": "string",
         "values": [ "string" ]
      }
   ],
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_ListBillEstimates_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [createdAtFilter](#API_AWSBCMPricingCalculator_ListBillEstimates_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimates-request-createdAtFilter"></a>
 Filter bill estimates based on the creation date.   
Type: [FilterTimestamp](API_AWSBCMPricingCalculator_FilterTimestamp.md) object  
Required: No

 ** [expiresAtFilter](#API_AWSBCMPricingCalculator_ListBillEstimates_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimates-request-expiresAtFilter"></a>
 Filter bill estimates based on the expiration date.   
Type: [FilterTimestamp](API_AWSBCMPricingCalculator_FilterTimestamp.md) object  
Required: No

 ** [filters](#API_AWSBCMPricingCalculator_ListBillEstimates_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimates-request-filters"></a>
 Filters to apply to the list of bill estimates.   
Type: Array of [ListBillEstimatesFilter](API_AWSBCMPricingCalculator_ListBillEstimatesFilter.md) objects  
Required: No

 ** [maxResults](#API_AWSBCMPricingCalculator_ListBillEstimates_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimates-request-maxResults"></a>
 The maximum number of results to return per page.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 25.  
Required: No

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillEstimates_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimates-request-nextToken"></a>
 A token to retrieve the next page of results.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_ListBillEstimates_ResponseSyntax"></a>

```
{
   "items": [ 
      { 
         "billInterval": { 
            "end": number,
            "start": number
         },
         "createdAt": number,
         "expiresAt": number,
         "id": "string",
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_ListBillEstimates_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [items](#API_AWSBCMPricingCalculator_ListBillEstimates_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimates-response-items"></a>
 The list of bill estimates for the account.   
Type: Array of [BillEstimateSummary](API_AWSBCMPricingCalculator_BillEstimateSummary.md) objects

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillEstimates_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillEstimates-response-nextToken"></a>
 A token to retrieve the next page of results, if any.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*` 

## Errors
<a name="API_AWSBCMPricingCalculator_ListBillEstimates_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_ListBillEstimates_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/ListBillEstimates) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/ListBillEstimates) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/ListBillEstimates) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/ListBillEstimates) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/ListBillEstimates) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/ListBillEstimates) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/ListBillEstimates) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/ListBillEstimates) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/ListBillEstimates) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/ListBillEstimates) 

# ListBillScenarioCommitmentModifications
<a name="API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications"></a>

 Lists the commitment modifications associated with a bill scenario. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications_RequestSyntax"></a>

```
{
   "billScenarioId": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billScenarioId](#API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications-request-billScenarioId"></a>
 The unique identifier of the bill scenario to list commitment modifications for.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [maxResults](#API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications-request-maxResults"></a>
 The maximum number of results to return per page.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 25.  
Required: No

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications-request-nextToken"></a>
 A token to retrieve the next page of results.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications_ResponseSyntax"></a>

```
{
   "items": [ 
      { 
         "commitmentAction": { ... },
         "group": "string",
         "id": "string",
         "usageAccountId": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [items](#API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications-response-items"></a>
 The list of commitment modifications associated with the bill scenario.   
Type: Array of [BillScenarioCommitmentModificationItem](API_AWSBCMPricingCalculator_BillScenarioCommitmentModificationItem.md) objects

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications-response-nextToken"></a>
 A token to retrieve the next page of results, if any.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*` 

## Errors
<a name="API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_ListBillScenarioCommitmentModifications_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/ListBillScenarioCommitmentModifications) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/ListBillScenarioCommitmentModifications) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/ListBillScenarioCommitmentModifications) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/ListBillScenarioCommitmentModifications) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/ListBillScenarioCommitmentModifications) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/ListBillScenarioCommitmentModifications) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/ListBillScenarioCommitmentModifications) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/ListBillScenarioCommitmentModifications) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/ListBillScenarioCommitmentModifications) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/ListBillScenarioCommitmentModifications) 

# ListBillScenarios
<a name="API_AWSBCMPricingCalculator_ListBillScenarios"></a>

 Lists all bill scenarios for the account. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_ListBillScenarios_RequestSyntax"></a>

```
{
   "createdAtFilter": { 
      "afterTimestamp": number,
      "beforeTimestamp": number
   },
   "expiresAtFilter": { 
      "afterTimestamp": number,
      "beforeTimestamp": number
   },
   "filters": [ 
      { 
         "matchOption": "string",
         "name": "string",
         "values": [ "string" ]
      }
   ],
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_ListBillScenarios_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [createdAtFilter](#API_AWSBCMPricingCalculator_ListBillScenarios_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarios-request-createdAtFilter"></a>
 Filter bill scenarios based on the creation date.   
Type: [FilterTimestamp](API_AWSBCMPricingCalculator_FilterTimestamp.md) object  
Required: No

 ** [expiresAtFilter](#API_AWSBCMPricingCalculator_ListBillScenarios_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarios-request-expiresAtFilter"></a>
 Filter bill scenarios based on the expiration date.   
Type: [FilterTimestamp](API_AWSBCMPricingCalculator_FilterTimestamp.md) object  
Required: No

 ** [filters](#API_AWSBCMPricingCalculator_ListBillScenarios_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarios-request-filters"></a>
 Filters to apply to the list of bill scenarios.   
Type: Array of [ListBillScenariosFilter](API_AWSBCMPricingCalculator_ListBillScenariosFilter.md) objects  
Required: No

 ** [maxResults](#API_AWSBCMPricingCalculator_ListBillScenarios_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarios-request-maxResults"></a>
 The maximum number of results to return per page.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 25.  
Required: No

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillScenarios_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarios-request-nextToken"></a>
 A token to retrieve the next page of results.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_ListBillScenarios_ResponseSyntax"></a>

```
{
   "items": [ 
      { 
         "billInterval": { 
            "end": number,
            "start": number
         },
         "costCategoryGroupSharingPreferenceArn": "string",
         "createdAt": number,
         "expiresAt": number,
         "failureMessage": "string",
         "groupSharingPreference": "string",
         "id": "string",
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_ListBillScenarios_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [items](#API_AWSBCMPricingCalculator_ListBillScenarios_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarios-response-items"></a>
 The list of bill scenarios for the account.   
Type: Array of [BillScenarioSummary](API_AWSBCMPricingCalculator_BillScenarioSummary.md) objects

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillScenarios_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarios-response-nextToken"></a>
 A token to retrieve the next page of results, if any.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*` 

## Errors
<a name="API_AWSBCMPricingCalculator_ListBillScenarios_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_ListBillScenarios_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/ListBillScenarios) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/ListBillScenarios) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/ListBillScenarios) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/ListBillScenarios) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/ListBillScenarios) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/ListBillScenarios) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/ListBillScenarios) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/ListBillScenarios) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/ListBillScenarios) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/ListBillScenarios) 

# ListBillScenarioUsageModifications
<a name="API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications"></a>

 Lists the usage modifications associated with a bill scenario. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications_RequestSyntax"></a>

```
{
   "billScenarioId": "string",
   "filters": [ 
      { 
         "matchOption": "string",
         "name": "string",
         "values": [ "string" ]
      }
   ],
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [billScenarioId](#API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarioUsageModifications-request-billScenarioId"></a>
 The unique identifier of the bill scenario to list usage modifications for.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [filters](#API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarioUsageModifications-request-filters"></a>
 Filters to apply to the list of usage modifications.   
Type: Array of [ListUsageFilter](API_AWSBCMPricingCalculator_ListUsageFilter.md) objects  
Required: No

 ** [maxResults](#API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarioUsageModifications-request-maxResults"></a>
 The maximum number of results to return per page.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 25.  
Required: No

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarioUsageModifications-request-nextToken"></a>
 A token to retrieve the next page of results.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications_ResponseSyntax"></a>

```
{
   "items": [ 
      { 
         "availabilityZone": "string",
         "group": "string",
         "historicalUsage": { 
            "billInterval": { 
               "end": number,
               "start": number
            },
            "filterExpression": { 
               "and": [ 
                  "Expression"
               ],
               "costCategories": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "dimensions": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "not": "Expression",
               "or": [ 
                  "Expression"
               ],
               "tags": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               }
            },
            "location": "string",
            "operation": "string",
            "serviceCode": "string",
            "usageAccountId": "string",
            "usageType": "string"
         },
         "id": "string",
         "location": "string",
         "operation": "string",
         "quantities": [ 
            { 
               "amount": number,
               "startHour": number,
               "unit": "string"
            }
         ],
         "serviceCode": "string",
         "usageAccountId": "string",
         "usageType": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [items](#API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarioUsageModifications-response-items"></a>
 The list of usage modifications associated with the bill scenario.   
Type: Array of [BillScenarioUsageModificationItem](API_AWSBCMPricingCalculator_BillScenarioUsageModificationItem.md) objects

 ** [nextToken](#API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListBillScenarioUsageModifications-response-nextToken"></a>
 A token to retrieve the next page of results, if any.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*` 

## Errors
<a name="API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_ListBillScenarioUsageModifications_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/ListBillScenarioUsageModifications) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/ListBillScenarioUsageModifications) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/ListBillScenarioUsageModifications) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/ListBillScenarioUsageModifications) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/ListBillScenarioUsageModifications) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/ListBillScenarioUsageModifications) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/ListBillScenarioUsageModifications) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/ListBillScenarioUsageModifications) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/ListBillScenarioUsageModifications) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/ListBillScenarioUsageModifications) 

# ListTagsForResource
<a name="API_AWSBCMPricingCalculator_ListTagsForResource"></a>

 Lists all tags associated with a specified resource. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_ListTagsForResource_RequestSyntax"></a>

```
{
   "arn": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_ListTagsForResource_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [arn](#API_AWSBCMPricingCalculator_ListTagsForResource_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListTagsForResource-request-arn"></a>
 The Amazon Resource Name (ARN) of the resource to list tags for.   
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 2048.  
Pattern: `arn:aws[-a-z0-9]*:bcm-pricing-calculator:[-a-z0-9]*:[0-9]{12}:[-a-z0-9/:_]+`   
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_ListTagsForResource_ResponseSyntax"></a>

```
{
   "tags": { 
      "string" : "string" 
   }
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_ListTagsForResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [tags](#API_AWSBCMPricingCalculator_ListTagsForResource_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListTagsForResource-response-tags"></a>
 The list of tags associated with the specified resource.   
Type: String to string map  
Map Entries: Minimum number of 0 items. Maximum number of 200 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 128.  
Key Pattern: `[\w\s:+=@/-]+`   
Value Length Constraints: Minimum length of 0. Maximum length of 256.  
Value Pattern: `[\w\s:+=@/-]*` 

## Errors
<a name="API_AWSBCMPricingCalculator_ListTagsForResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_ListTagsForResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/ListTagsForResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/ListTagsForResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/ListTagsForResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/ListTagsForResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/ListTagsForResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/ListTagsForResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/ListTagsForResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/ListTagsForResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/ListTagsForResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/ListTagsForResource) 

# ListWorkloadEstimates
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimates"></a>

 Lists all workload estimates for the account. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimates_RequestSyntax"></a>

```
{
   "createdAtFilter": { 
      "afterTimestamp": number,
      "beforeTimestamp": number
   },
   "expiresAtFilter": { 
      "afterTimestamp": number,
      "beforeTimestamp": number
   },
   "filters": [ 
      { 
         "matchOption": "string",
         "name": "string",
         "values": [ "string" ]
      }
   ],
   "maxResults": number,
   "nextToken": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimates_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [createdAtFilter](#API_AWSBCMPricingCalculator_ListWorkloadEstimates_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimates-request-createdAtFilter"></a>
 Filter workload estimates based on the creation date.   
Type: [FilterTimestamp](API_AWSBCMPricingCalculator_FilterTimestamp.md) object  
Required: No

 ** [expiresAtFilter](#API_AWSBCMPricingCalculator_ListWorkloadEstimates_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimates-request-expiresAtFilter"></a>
 Filter workload estimates based on the expiration date.   
Type: [FilterTimestamp](API_AWSBCMPricingCalculator_FilterTimestamp.md) object  
Required: No

 ** [filters](#API_AWSBCMPricingCalculator_ListWorkloadEstimates_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimates-request-filters"></a>
 Filters to apply to the list of workload estimates.   
Type: Array of [ListWorkloadEstimatesFilter](API_AWSBCMPricingCalculator_ListWorkloadEstimatesFilter.md) objects  
Required: No

 ** [maxResults](#API_AWSBCMPricingCalculator_ListWorkloadEstimates_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimates-request-maxResults"></a>
 The maximum number of results to return per page.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 25.  
Required: No

 ** [nextToken](#API_AWSBCMPricingCalculator_ListWorkloadEstimates_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimates-request-nextToken"></a>
 A token to retrieve the next page of results.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimates_ResponseSyntax"></a>

```
{
   "items": [ 
      { 
         "costCurrency": "string",
         "createdAt": number,
         "expiresAt": number,
         "failureMessage": "string",
         "id": "string",
         "name": "string",
         "rateTimestamp": number,
         "rateType": "string",
         "status": "string",
         "totalCost": number
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimates_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [items](#API_AWSBCMPricingCalculator_ListWorkloadEstimates_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimates-response-items"></a>
 The list of workload estimates for the account.   
Type: Array of [WorkloadEstimateSummary](API_AWSBCMPricingCalculator_WorkloadEstimateSummary.md) objects

 ** [nextToken](#API_AWSBCMPricingCalculator_ListWorkloadEstimates_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimates-response-nextToken"></a>
 A token to retrieve the next page of results, if any.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*` 

## Errors
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimates_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimates_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimates) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimates) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimates) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimates) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimates) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimates) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimates) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimates) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimates) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimates) 

# ListWorkloadEstimateUsage
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage"></a>

 Lists the usage associated with a workload estimate. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage_RequestSyntax"></a>

```
{
   "filters": [ 
      { 
         "matchOption": "string",
         "name": "string",
         "values": [ "string" ]
      }
   ],
   "maxResults": number,
   "nextToken": "string",
   "workloadEstimateId": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [filters](#API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimateUsage-request-filters"></a>
 Filters to apply to the list of usage items.   
Type: Array of [ListUsageFilter](API_AWSBCMPricingCalculator_ListUsageFilter.md) objects  
Required: No

 ** [maxResults](#API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimateUsage-request-maxResults"></a>
 The maximum number of results to return per page.   
Type: Integer  
Valid Range: Minimum value of 1. Maximum value of 300.  
Required: No

 ** [nextToken](#API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimateUsage-request-nextToken"></a>
 A token to retrieve the next page of results.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*`   
Required: No

 ** [workloadEstimateId](#API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimateUsage-request-workloadEstimateId"></a>
 The unique identifier of the workload estimate to list usage for.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

## Response Syntax
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage_ResponseSyntax"></a>

```
{
   "items": [ 
      { 
         "cost": number,
         "currency": "string",
         "group": "string",
         "historicalUsage": { 
            "billInterval": { 
               "end": number,
               "start": number
            },
            "filterExpression": { 
               "and": [ 
                  "Expression"
               ],
               "costCategories": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "dimensions": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               },
               "not": "Expression",
               "or": [ 
                  "Expression"
               ],
               "tags": { 
                  "key": "string",
                  "matchOptions": [ "string" ],
                  "values": [ "string" ]
               }
            },
            "location": "string",
            "operation": "string",
            "serviceCode": "string",
            "usageAccountId": "string",
            "usageType": "string"
         },
         "id": "string",
         "location": "string",
         "operation": "string",
         "quantity": { 
            "amount": number,
            "unit": "string"
         },
         "serviceCode": "string",
         "status": "string",
         "usageAccountId": "string",
         "usageType": "string"
      }
   ],
   "nextToken": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [items](#API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimateUsage-response-items"></a>
 The list of usage items associated with the workload estimate.   
Type: Array of [WorkloadEstimateUsageItem](API_AWSBCMPricingCalculator_WorkloadEstimateUsageItem.md) objects

 ** [nextToken](#API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_ListWorkloadEstimateUsage-response-nextToken"></a>
 A token to retrieve the next page of results, if any.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 2048.  
Pattern: `[\S\s]*` 

## Errors
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_ListWorkloadEstimateUsage_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimateUsage) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimateUsage) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimateUsage) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimateUsage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimateUsage) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimateUsage) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimateUsage) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimateUsage) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimateUsage) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/ListWorkloadEstimateUsage) 

# TagResource
<a name="API_AWSBCMPricingCalculator_TagResource"></a>

 Adds one or more tags to a specified resource. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_TagResource_RequestSyntax"></a>

```
{
   "arn": "string",
   "tags": { 
      "string" : "string" 
   }
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_TagResource_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [arn](#API_AWSBCMPricingCalculator_TagResource_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_TagResource-request-arn"></a>
 The Amazon Resource Name (ARN) of the resource to add tags to.   
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 2048.  
Pattern: `arn:aws[-a-z0-9]*:bcm-pricing-calculator:[-a-z0-9]*:[0-9]{12}:[-a-z0-9/:_]+`   
Required: Yes

 ** [tags](#API_AWSBCMPricingCalculator_TagResource_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_TagResource-request-tags"></a>
 The tags to add to the resource.   
Type: String to string map  
Map Entries: Minimum number of 0 items. Maximum number of 200 items.  
Key Length Constraints: Minimum length of 1. Maximum length of 128.  
Key Pattern: `[\w\s:+=@/-]+`   
Value Length Constraints: Minimum length of 0. Maximum length of 256.  
Value Pattern: `[\w\s:+=@/-]*`   
Required: Yes

## Response Elements
<a name="API_AWSBCMPricingCalculator_TagResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_AWSBCMPricingCalculator_TagResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ServiceQuotaExceededException **   
 The request would cause you to exceed your service quota.     
 ** quotaCode **   
 The quota code that was exceeded.   
 ** resourceId **   
 The identifier of the resource that exceeded quota.   
 ** resourceType **   
 The type of the resource that exceeded quota.   
 ** serviceCode **   
 The service code that exceeded quota. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_TagResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/TagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/TagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/TagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/TagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/TagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/TagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/TagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/TagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/TagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/TagResource) 

# UntagResource
<a name="API_AWSBCMPricingCalculator_UntagResource"></a>

 Removes one or more tags from a specified resource. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_UntagResource_RequestSyntax"></a>

```
{
   "arn": "string",
   "tagKeys": [ "string" ]
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_UntagResource_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [arn](#API_AWSBCMPricingCalculator_UntagResource_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UntagResource-request-arn"></a>
 The Amazon Resource Name (ARN) of the resource to remove tags from.   
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 2048.  
Pattern: `arn:aws[-a-z0-9]*:bcm-pricing-calculator:[-a-z0-9]*:[0-9]{12}:[-a-z0-9/:_]+`   
Required: Yes

 ** [tagKeys](#API_AWSBCMPricingCalculator_UntagResource_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UntagResource-request-tagKeys"></a>
 The keys of the tags to remove from the resource.   
Type: Array of strings  
Array Members: Minimum number of 0 items. Maximum number of 200 items.  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `[\w\s:+=@/-]+`   
Required: Yes

## Response Elements
<a name="API_AWSBCMPricingCalculator_UntagResource_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

## Errors
<a name="API_AWSBCMPricingCalculator_UntagResource_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_UntagResource_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/UntagResource) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/UntagResource) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/UntagResource) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/UntagResource) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/UntagResource) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/UntagResource) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/UntagResource) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/UntagResource) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/UntagResource) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/UntagResource) 

# UpdateBillEstimate
<a name="API_AWSBCMPricingCalculator_UpdateBillEstimate"></a>

 Updates an existing bill estimate. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_UpdateBillEstimate_RequestSyntax"></a>

```
{
   "expiresAt": number,
   "identifier": "string",
   "name": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_UpdateBillEstimate_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [expiresAt](#API_AWSBCMPricingCalculator_UpdateBillEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-request-expiresAt"></a>
 The new expiration date for the bill estimate.   
Type: Timestamp  
Required: No

 ** [identifier](#API_AWSBCMPricingCalculator_UpdateBillEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-request-identifier"></a>
 The unique identifier of the bill estimate to update.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [name](#API_AWSBCMPricingCalculator_UpdateBillEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-request-name"></a>
 The new name for the bill estimate.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseSyntax"></a>

```
{
   "billInterval": { 
      "end": number,
      "start": number
   },
   "costCategoryGroupSharingPreferenceArn": "string",
   "costCategoryGroupSharingPreferenceEffectiveDate": number,
   "costSummary": { 
      "serviceCostDifferences": { 
         "string" : { 
            "estimatedCost": { 
               "amount": number,
               "currency": "string"
            },
            "historicalCost": { 
               "amount": number,
               "currency": "string"
            }
         }
      },
      "totalCostDifference": { 
         "estimatedCost": { 
            "amount": number,
            "currency": "string"
         },
         "historicalCost": { 
            "amount": number,
            "currency": "string"
         }
      }
   },
   "createdAt": number,
   "expiresAt": number,
   "failureMessage": "string",
   "groupSharingPreference": "string",
   "id": "string",
   "name": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [billInterval](#API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-response-billInterval"></a>
 The time period covered by the updated bill estimate.   
Type: [BillInterval](API_AWSBCMPricingCalculator_BillInterval.md) object

 ** [costCategoryGroupSharingPreferenceArn](#API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-response-costCategoryGroupSharingPreferenceArn"></a>
The arn of the cost category used in the reserved and prioritized group sharing.  
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 2048.  
Pattern: `arn:aws[-a-z0-9]*:ce::[0-9]{12}:costcategory/[a-f0-9-]{36}` 

 ** [costCategoryGroupSharingPreferenceEffectiveDate](#API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-response-costCategoryGroupSharingPreferenceEffectiveDate"></a>
Timestamp of the effective date of the cost category used in the group sharing settings.  
Type: Timestamp

 ** [costSummary](#API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-response-costSummary"></a>
 A summary of the updated estimated costs.   
Type: [BillEstimateCostSummary](API_AWSBCMPricingCalculator_BillEstimateCostSummary.md) object

 ** [createdAt](#API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-response-createdAt"></a>
 The timestamp when the bill estimate was originally created.   
Type: Timestamp

 ** [expiresAt](#API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-response-expiresAt"></a>
 The updated expiration timestamp for the bill estimate.   
Type: Timestamp

 ** [failureMessage](#API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-response-failureMessage"></a>
 An error message if the bill estimate update failed.   
Type: String

 ** [groupSharingPreference](#API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-response-groupSharingPreference"></a>
The setting for the reserved instance and savings plans group sharing used in this estimate.  
Type: String  
Valid Values: `OPEN | PRIORITIZED | RESTRICTED` 

 ** [id](#API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-response-id"></a>
 The unique identifier of the updated bill estimate.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 

 ** [name](#API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-response-name"></a>
 The updated name of the bill estimate.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+` 

 ** [status](#API_AWSBCMPricingCalculator_UpdateBillEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillEstimate-response-status"></a>
 The current status of the updated bill estimate.   
Type: String  
Valid Values: `IN_PROGRESS | COMPLETE | FAILED` 

## Errors
<a name="API_AWSBCMPricingCalculator_UpdateBillEstimate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_UpdateBillEstimate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/UpdateBillEstimate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/UpdateBillEstimate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/UpdateBillEstimate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/UpdateBillEstimate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/UpdateBillEstimate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/UpdateBillEstimate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/UpdateBillEstimate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/UpdateBillEstimate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/UpdateBillEstimate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/UpdateBillEstimate) 

# UpdateBillScenario
<a name="API_AWSBCMPricingCalculator_UpdateBillScenario"></a>

 Updates an existing bill scenario. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_UpdateBillScenario_RequestSyntax"></a>

```
{
   "costCategoryGroupSharingPreferenceArn": "string",
   "expiresAt": number,
   "groupSharingPreference": "string",
   "identifier": "string",
   "name": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_UpdateBillScenario_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [costCategoryGroupSharingPreferenceArn](#API_AWSBCMPricingCalculator_UpdateBillScenario_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-request-costCategoryGroupSharingPreferenceArn"></a>
The arn of the cost category used in the reserved and prioritized group sharing.  
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 2048.  
Pattern: `arn:aws[-a-z0-9]*:ce::[0-9]{12}:costcategory/[a-f0-9-]{36}`   
Required: No

 ** [expiresAt](#API_AWSBCMPricingCalculator_UpdateBillScenario_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-request-expiresAt"></a>
 The new expiration date for the bill scenario.   
Type: Timestamp  
Required: No

 ** [groupSharingPreference](#API_AWSBCMPricingCalculator_UpdateBillScenario_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-request-groupSharingPreference"></a>
The setting for the reserved instance and savings plans group sharing used in this estimate.  
Type: String  
Valid Values: `OPEN | PRIORITIZED | RESTRICTED`   
Required: No

 ** [identifier](#API_AWSBCMPricingCalculator_UpdateBillScenario_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-request-identifier"></a>
 The unique identifier of the bill scenario to update.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [name](#API_AWSBCMPricingCalculator_UpdateBillScenario_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-request-name"></a>
 The new name for the bill scenario.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_UpdateBillScenario_ResponseSyntax"></a>

```
{
   "billInterval": { 
      "end": number,
      "start": number
   },
   "costCategoryGroupSharingPreferenceArn": "string",
   "createdAt": number,
   "expiresAt": number,
   "failureMessage": "string",
   "groupSharingPreference": "string",
   "id": "string",
   "name": "string",
   "status": "string"
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_UpdateBillScenario_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [billInterval](#API_AWSBCMPricingCalculator_UpdateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-response-billInterval"></a>
 The time period covered by the updated bill scenario.   
Type: [BillInterval](API_AWSBCMPricingCalculator_BillInterval.md) object

 ** [costCategoryGroupSharingPreferenceArn](#API_AWSBCMPricingCalculator_UpdateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-response-costCategoryGroupSharingPreferenceArn"></a>
The arn of the cost category used in the reserved and prioritized group sharing.  
Type: String  
Length Constraints: Minimum length of 20. Maximum length of 2048.  
Pattern: `arn:aws[-a-z0-9]*:ce::[0-9]{12}:costcategory/[a-f0-9-]{36}` 

 ** [createdAt](#API_AWSBCMPricingCalculator_UpdateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-response-createdAt"></a>
 The timestamp when the bill scenario was originally created.   
Type: Timestamp

 ** [expiresAt](#API_AWSBCMPricingCalculator_UpdateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-response-expiresAt"></a>
 The updated expiration timestamp for the bill scenario.   
Type: Timestamp

 ** [failureMessage](#API_AWSBCMPricingCalculator_UpdateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-response-failureMessage"></a>
 An error message if the bill scenario update failed.   
Type: String

 ** [groupSharingPreference](#API_AWSBCMPricingCalculator_UpdateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-response-groupSharingPreference"></a>
The setting for the reserved instance and savings plans group sharing used in this estimate.  
Type: String  
Valid Values: `OPEN | PRIORITIZED | RESTRICTED` 

 ** [id](#API_AWSBCMPricingCalculator_UpdateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-response-id"></a>
 The unique identifier of the updated bill scenario.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 

 ** [name](#API_AWSBCMPricingCalculator_UpdateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-response-name"></a>
 The updated name of the bill scenario.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+` 

 ** [status](#API_AWSBCMPricingCalculator_UpdateBillScenario_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateBillScenario-response-status"></a>
 The current status of the updated bill scenario.   
Type: String  
Valid Values: `READY | LOCKED | FAILED | STALE` 

## Errors
<a name="API_AWSBCMPricingCalculator_UpdateBillScenario_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_UpdateBillScenario_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/UpdateBillScenario) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/UpdateBillScenario) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/UpdateBillScenario) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/UpdateBillScenario) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/UpdateBillScenario) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/UpdateBillScenario) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/UpdateBillScenario) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/UpdateBillScenario) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/UpdateBillScenario) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/UpdateBillScenario) 

# UpdatePreferences
<a name="API_AWSBCMPricingCalculator_UpdatePreferences"></a>

 Updates the preferences for AWS Pricing Calculator. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_UpdatePreferences_RequestSyntax"></a>

```
{
   "managementAccountRateTypeSelections": [ "string" ],
   "memberAccountRateTypeSelections": [ "string" ],
   "standaloneAccountRateTypeSelections": [ "string" ]
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_UpdatePreferences_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [managementAccountRateTypeSelections](#API_AWSBCMPricingCalculator_UpdatePreferences_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdatePreferences-request-managementAccountRateTypeSelections"></a>
 The updated preferred rate types for the management account.   
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 3 items.  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS`   
Required: No

 ** [memberAccountRateTypeSelections](#API_AWSBCMPricingCalculator_UpdatePreferences_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdatePreferences-request-memberAccountRateTypeSelections"></a>
 The updated preferred rate types for member accounts.   
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 3 items.  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS`   
Required: No

 ** [standaloneAccountRateTypeSelections](#API_AWSBCMPricingCalculator_UpdatePreferences_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdatePreferences-request-standaloneAccountRateTypeSelections"></a>
 The updated preferred rate types for a standalone account.   
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 3 items.  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_UpdatePreferences_ResponseSyntax"></a>

```
{
   "managementAccountRateTypeSelections": [ "string" ],
   "memberAccountRateTypeSelections": [ "string" ],
   "standaloneAccountRateTypeSelections": [ "string" ]
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_UpdatePreferences_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [managementAccountRateTypeSelections](#API_AWSBCMPricingCalculator_UpdatePreferences_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdatePreferences-response-managementAccountRateTypeSelections"></a>
 The updated preferred rate types for the management account.   
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 3 items.  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS` 

 ** [memberAccountRateTypeSelections](#API_AWSBCMPricingCalculator_UpdatePreferences_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdatePreferences-response-memberAccountRateTypeSelections"></a>
 The updated preferred rate types for member accounts.   
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 3 items.  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS` 

 ** [standaloneAccountRateTypeSelections](#API_AWSBCMPricingCalculator_UpdatePreferences_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdatePreferences-response-standaloneAccountRateTypeSelections"></a>
 The updated preferred rate types for a standalone account.   
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 3 items.  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS` 

## Errors
<a name="API_AWSBCMPricingCalculator_UpdatePreferences_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ServiceQuotaExceededException **   
 The request would cause you to exceed your service quota.     
 ** quotaCode **   
 The quota code that was exceeded.   
 ** resourceId **   
 The identifier of the resource that exceeded quota.   
 ** resourceType **   
 The type of the resource that exceeded quota.   
 ** serviceCode **   
 The service code that exceeded quota. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_UpdatePreferences_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/UpdatePreferences) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/UpdatePreferences) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/UpdatePreferences) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/UpdatePreferences) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/UpdatePreferences) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/UpdatePreferences) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/UpdatePreferences) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/UpdatePreferences) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/UpdatePreferences) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/UpdatePreferences) 

# UpdateWorkloadEstimate
<a name="API_AWSBCMPricingCalculator_UpdateWorkloadEstimate"></a>

 Updates an existing workload estimate. 

## Request Syntax
<a name="API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_RequestSyntax"></a>

```
{
   "expiresAt": number,
   "identifier": "string",
   "name": "string"
}
```

## Request Parameters
<a name="API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_RequestParameters"></a>

For information about the parameters that are common to all actions, see [Common Parameters](CommonParameters.md).

The request accepts the following data in JSON format.

 ** [expiresAt](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-request-expiresAt"></a>
 The new expiration date for the workload estimate.   
Type: Timestamp  
Required: No

 ** [identifier](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-request-identifier"></a>
 The unique identifier of the workload estimate to update.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}`   
Required: Yes

 ** [name](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_RequestSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-request-name"></a>
 The new name for the workload estimate.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+`   
Required: No

## Response Syntax
<a name="API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_ResponseSyntax"></a>

```
{
   "costCurrency": "string",
   "createdAt": number,
   "expiresAt": number,
   "failureMessage": "string",
   "id": "string",
   "name": "string",
   "rateTimestamp": number,
   "rateType": "string",
   "status": "string",
   "totalCost": number
}
```

## Response Elements
<a name="API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [costCurrency](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-response-costCurrency"></a>
 The currency of the updated estimated cost.   
Type: String  
Valid Values: `USD` 

 ** [createdAt](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-response-createdAt"></a>
 The timestamp when the workload estimate was originally created.   
Type: Timestamp

 ** [expiresAt](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-response-expiresAt"></a>
 The updated expiration timestamp for the workload estimate.   
Type: Timestamp

 ** [failureMessage](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-response-failureMessage"></a>
 An error message if the workload estimate update failed.   
Type: String

 ** [id](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-response-id"></a>
 The unique identifier of the updated workload estimate.   
Type: String  
Length Constraints: Fixed length of 36.  
Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` 

 ** [name](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-response-name"></a>
 The updated name of the workload estimate.   
Type: String  
Length Constraints: Minimum length of 0. Maximum length of 64.  
Pattern: `[a-zA-Z0-9-]+` 

 ** [rateTimestamp](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-response-rateTimestamp"></a>
 The timestamp of the pricing rates used for the updated estimate.   
Type: Timestamp

 ** [rateType](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-response-rateType"></a>
 The type of pricing rates used for the updated estimate.   
Type: String  
Valid Values: `BEFORE_DISCOUNTS | AFTER_DISCOUNTS | AFTER_DISCOUNTS_AND_COMMITMENTS` 

 ** [status](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-response-status"></a>
 The current status of the updated workload estimate.   
Type: String  
Valid Values: `UPDATING | VALID | INVALID | ACTION_NEEDED` 

 ** [totalCost](#API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_ResponseSyntax) **   <a name="awscostmanagement-AWSBCMPricingCalculator_UpdateWorkloadEstimate-response-totalCost"></a>
 The updated total estimated cost for the workload.   
Type: Double

## Errors
<a name="API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_Errors"></a>

For information about the errors that are common to all actions, see [Common Error Types](CommonErrors.md).

 ** AccessDeniedException **   
 You do not have sufficient access to perform this action.   
HTTP Status Code: 400

 ** ConflictException **   
 The request could not be processed because of conflict in the current state of the resource.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** DataUnavailableException **   
 The requested data is currently unavailable.   
HTTP Status Code: 400

 ** InternalServerException **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support.     
 ** retryAfterSeconds **   
 An internal error has occurred. Retry your request, but if the problem persists, contact AWS support. 
HTTP Status Code: 500

 ** ResourceNotFoundException **   
 The specified resource was not found.     
 ** resourceId **   
 The identifier of the resource that was not found.   
 ** resourceType **   
 The type of the resource that was not found. 
HTTP Status Code: 400

 ** ThrottlingException **   
 The request was denied due to request throttling.     
 ** quotaCode **   
The quota code that exceeded the throttling limit.  
 ** retryAfterSeconds **   
The service code that exceeded the throttling limit. Retry your request, but if the problem persists, contact AWS support.  
 ** serviceCode **   
The service code that exceeded the throttling limit.
HTTP Status Code: 400

 ** ValidationException **   
 The input provided fails to satisfy the constraints specified by an AWS service.     
 ** fieldList **   
 The list of fields that are invalid.   
 ** reason **   
 The reason for the validation exception. 
HTTP Status Code: 400

## See Also
<a name="API_AWSBCMPricingCalculator_UpdateWorkloadEstimate_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/bcm-pricing-calculator-2024-06-19/UpdateWorkloadEstimate) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/UpdateWorkloadEstimate) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/UpdateWorkloadEstimate) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/UpdateWorkloadEstimate) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/UpdateWorkloadEstimate) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/UpdateWorkloadEstimate) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/UpdateWorkloadEstimate) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/UpdateWorkloadEstimate) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/bcm-pricing-calculator-2024-06-19/UpdateWorkloadEstimate) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/UpdateWorkloadEstimate)