# BatchUpdateWorkloadEstimateUsage 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 ``` { "usage": [ { "amount": number, "group": "string", "id": "string" } ], "workloadEstimateId": "string" } ``` ## Request Parameters 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) ** 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) ** 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 ``` { "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 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) ** 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) ** 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 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 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)