Domain name for API request: billing.intl.tencentcloudapi.com.
This API is used to query the filter conditions of a cost allocation bill.
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: DescribeAllocationBillConditions. |
| Version | Yes | String | Common Params. The value used for this API: 2018-07-09. |
| Region | No | String | Common Params. This parameter is not required. |
| Month | No | String | Bill month, in the format of 2024-02, which is the current month by default if not provided |
| TreeNodeUniqKeys.N | No | Array of String | Unique identifier of a billing unit, used for filtering |
| BillDates.N | No | Array of String | Date |
| BusinessCodes.N | No | Array of String | Product code |
| OwnerUins.N | No | Array of String | User UIN |
| OperateUins.N | No | Array of String | Operator UIN |
| PayModes.N | No | Array of String | Billing mode code |
| ActionTypes.N | No | Array of String | Transaction type code |
| ProductCodes.N | No | Array of String | Subproduct code |
| RegionIds.N | No | Array of String | Region ID |
| ZoneIds.N | No | Array of String | AZ ID |
| InstanceTypes.N | No | Array of String | Instance type code |
| Tag.N | No | Array of String | Tag |
| ComponentCodes.N | No | Array of String | Component type code |
| ItemCodes.N | No | Array of String | Component name code |
| SearchKey | No | String | Fuzzy search criteria |
| ProjectIds.N | No | Array of Integer | Project ID |
| AllocationType.N | No | Array of Integer | Cost collection type |
| Parameter Name | Type | Description |
|---|---|---|
| Business | Array of BillBusiness | Product filter list |
| Product | Array of BillProduct | Subproduct filter list |
| Item | Array of BillItem | Component name filter list |
| Region | Array of BillRegion | Region filter list |
| InstanceType | Array of BillInstanceType | Instance type filter list |
| PayMode | Array of BillPayMode | Billing mode filter list |
| Project | Array of BillProject | Project filter list |
| Tag | Array of BillTag | Tag filter list |
| OwnerUin | Array of BillOwnerUin | User UIN filter list |
| OperateUin | Array of BillOperateUin | Operator UIN filter list |
| BillDay | Array of BillDays | Date filter list |
| ActionType | Array of BillActionType | Transaction type filter list |
| Component | Array of BillComponent | Component type filter list |
| Zone | Array of BillZoneId | Availability zone filter list |
| AllocationTreeNode | Array of AllocationTreeNode | Cost allocation unit filter list |
| TagKey | Array of String | Cost allocation tag key |
| 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: DescribeAllocationBillConditions
<Common request parameters>
{
"Month": "2022-11-01 00:00:00"
}
{
"Response": {
"OwnerUin": [
{
"OwnerUin": "100010445xxxx"
}
],
"OperateUin": [
{
"OperateUin": "100010445xxxx"
},
{
"OperateUin": "20004888xxxx"
}
],
"BillDay": [
{
"BillDay": "2026-06-02"
},
{
"BillDay": "2026-06-01"
}
],
"ActionType": [
{
"ActionType": "postpay_deduct_d",
"ActionTypeName": "Daily settlement"
},
{
"ActionType": "svp_hour_pay",
"ActionTypeName": "Hourly Savings Plan fee"
},
{
"ActionType": "pre_purchase",
"ActionTypeName": "New yearly/monthly subscription"
},
{
"ActionType": "postpay_deduct_h",
"ActionTypeName": "Hourly settlement"
}
],
"Business": [
{
"BusinessCode": "p_privatedns",
"BusinessCodeName": "Private DNS"
},
{
"BusinessCode": "p_cbs",
"BusinessCodeName": "cloud block storage"
}
],
"Product": [
{
"ProductCode": "sp_privatedns_zone",
"ProductCodeName": "Private DNS - Zone"
},
{
"ProductCode": "sp_cbs_bssd",
"ProductCodeName": "Balanced SSD cloud block storage"
}
],
"Component": [
{
"ComponentCode": "v_cvm_cpu",
"ComponentCodeName": "CPU"
},
{
"ComponentCode": "v_cos_std_maz_req",
"ComponentCodeName": "maz_standard storage request"
}
],
"Zone": [
{
"ZoneId": 800003,
"ZoneName": "Beijing Zone 3"
},
{
"ZoneId": 800006,
"ZoneName": "Beijing Zone 6"
}
],
"Item": [
{
"ItemCode": "sv_cos_std_req_w",
"ItemCodeName": "cos standard storage write request"
},
{
"ItemCode": "sv_cos_bw_internet",
"ItemCodeName": "cos public network downstream traffic"
}
],
"AllocationTreeNode": [
{
"TreeNodeUniqKey": "1000104xxxx-69e72dd9a913c",
"TreeNodeUniqKeyName": "Group-b-auto"
}
],
"InstanceType": [
{
"InstanceType": "ri",
"InstanceTypeName": "Standard RI"
},
{
"InstanceType": "svp",
"InstanceTypeName": "Savings Plan"
},
{
"InstanceType": "si",
"InstanceTypeName": "Spot Instances"
},
{
"InstanceType": "rp",
"InstanceTypeName": "Resource Pack"
},
{
"InstanceType": "periodicContractSale",
"InstanceTypeName": "Periodic Contract"
}
],
"Region": [
{
"RegionId": 0,
"RegionName": "other"
},
{
"RegionId": 1,
"RegionName": "South China (Guangzhou)"
}
],
"PayMode": [
{
"PayMode": "prePay",
"PayModeName": "Yearly/monthly subscription"
},
{
"PayMode": "postPay",
"PayModeName": "Pay-As-You-Go resources"
},
{
"PayMode": "riPay",
"PayModeName": "Standard RI"
}
],
"Project": [
{
"ProjectId": 0,
"ProjectName": "default"
}
],
"Tag": [
{
"TagKey": "Game Project",
"TagValue": "project3"
},
{
"TagKey": "game group",
"TagValue": "group3"
},
{
"TagKey": "",
"TagValue": ""
}
],
"TagKey": [
"Game Project",
"game group",
"business unit",
"Team",
"CloudappId",
"111"
],
"RequestId": "21626151-5371-4061-91e4-0f100d463797"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
| Error Code | Description |
|---|---|
| AuthFailure | CAM signature/authentication error. |
| AuthFailure.UnauthorizedOperation | No permission. |
| InternalError | Internal error. |
| InvalidParameter | Invalid parameter. |
| InvalidParameterValue | Invalid parameter value. |
| MissingParameter | Parameters are missing |
피드백