Domain name for API request: billing.intl.tencentcloudapi.com.
Refresh budget information
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
| Parameter Name | Required | Type | Description |
|---|---|---|---|
| Action | Yes | String | Common Params. The value used for this API: ModifyBudget. |
| Version | Yes | String | Common Params. The value used for this API: 2018-07-09. |
| Region | No | String | Common Params. This parameter is not required for this API. |
| BudgetId | Yes | String | Budget project id |
| BudgetName | Yes | String | Budget Name |
| CycleType | Yes | String | DAY, MONTH, QUARTER, YEAR |
| PeriodBegin | Yes | String | Validity start time 2025-01-01 |
| PeriodEnd | Yes | String | Validity End Time 2025-12-01 |
| PlanType | Yes | String | FIX fixed value, CYCLE different value |
| BudgetQuota | Yes | String | Budget amount limit Set as a fixed value when the schedule type is fixed budget. When the schedule type is CYCLE (budget planning), pass [{"dateDesc":"2025-07","quota":"1000"},{"dateDesc":"2025-08","quota":"2000"}]. |
| BillType | Yes | String | BILL System bill, CONSUMPTION Consumption bill |
| FeeType | Yes | String | COST Original price, REAL_COST Actual fee, CASH Cash, INCENTIVE Free credit, VOUCHER Voucher, TRANSFER Allocated fees (royalty amount), TAX Tax, AMOUNT_BEFORE_TAX Cash payment (pre-tax) |
| WarnJson.N | Yes | Array of BudgetWarn | threshold alert |
| BudgetNote | No | String | Budget remark |
| DimensionsRange | No | BudgetConditionsForm | Budget dimension range condition |
| WaveThresholdJson.N | No | Array of WaveThresholdForm | fluctuation alert |
| Parameter Name | Type | Description |
|---|---|---|
| Data | BudgetInfoApiResponse | Refresh budget return information |
| Message | String | update success Note: This field may return null, indicating that no valid values can be obtained. |
| Code | Integer | Return code |
| RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
POST / HTTP/1.1
Host: billing.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action:ModifyBudget
{
"BudgetId": "1963509727611473921",
"BudgetName": "API creation budget plan"
"CycleType": "DAY",
"PeriodBegin": "2025-01-01",
"PeriodEnd": "2025-12-01",
"PlanType": "FIX",
"BudgetQuota": "1200",
"BillType": "BILL",
"FeeType": "COST",
"WarnJson": [
{
"WarnType": "ACTUAL",
"CalType": "PERCENTAGE",
"ThresholdValue": "100"
}
],
"BudgetNote": "Use api to create budget information"
"DimensionsRange": {
"Business": [
"p_cvm"
]
},
"WaveThresholdJson": [
{
"WarnType": "ACTUAL",
"Threshold": "100",
"MetaType": "chain",
"PeriodType": "day"
}
]
}
{
"Response": {
"Code": 0,
"Data": {
"BudgetId": "1963509727611473921",
"UpdateTime": "2025-09-04 15:59:14"
},
"Message": "update success",
"RequestId": "59e79af4-68cb-4bb3-9b18-194acf3952fe"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
There is no error code related to the API business logic. For other error codes, please see Common Error Codes.
Was this page helpful?
You can also Contact sales or Submit a Ticket for help.
Help us improve! Rate your documentation experience in 5 mins.
Feedback