# BatchUpdateBillScenarioUsageModification 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 Amazon principals, include the permission `bcm-pricing-calculator:UpdateBillScenarioUsageModification` in your policies. ## Request Syntax ``` { "billScenarioId": "string", "usageModifications": [ { "amounts": [ { "amount": number, "startHour": number } ], "group": "string", "id": "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. ** [billScenarioId](#API_AWSBCMPricingCalculator_BatchUpdateBillScenarioUsageModification_RequestSyntax) ** 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) ** 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 ``` { "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 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) ** 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) ** 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 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 Amazon support. ** retryAfterSeconds ** An internal error has occurred. Retry your request, but if the problem persists, contact Amazon 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 Amazon 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 Amazon 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 Amazon SDKs, see the following: + [Amazon Command Line Interface V2](https://docs.amazonaws.cn/goto/cli2/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) + [Amazon SDK for .NET V4](https://docs.amazonaws.cn/goto/DotNetSDKV4/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) + [Amazon SDK for C\$1\$1](https://docs.amazonaws.cn/goto/SdkForCpp/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) + [Amazon SDK for Go v2](https://docs.amazonaws.cn/goto/SdkForGoV2/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) + [Amazon SDK for Java V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) + [Amazon SDK for JavaScript V3](https://docs.amazonaws.cn/goto/SdkForJavaScriptV3/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) + [Amazon SDK for Kotlin](https://docs.amazonaws.cn/goto/SdkForKotlin/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) + [Amazon SDK for PHP V3](https://docs.amazonaws.cn/goto/SdkForPHPV3/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) + [Amazon SDK for Python](https://docs.amazonaws.cn/goto/boto3/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification) + [Amazon SDK for Ruby V3](https://docs.amazonaws.cn/goto/SdkForRubyV3/bcm-pricing-calculator-2024-06-19/BatchUpdateBillScenarioUsageModification)