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": "700000384179"
}
],
"OperateUin": [
{
"OperateUin": "700000384179"
}
],
"BillDay": [
{
"BillDay": "2022-11-02"
}
],
"ActionType": [
{
"ActionType": "prepay_purchase",
"ActionTypeName": "Monthly Subscription New Purchase"
},
{
"ActionType": "prepay_renew",
"ActionTypeName": "Monthly Subscription Renewal"
}
],
"Business": [
{
"BusinessCode": "p_redis",
"BusinessCodeName": " TencentDB for Redis "
},
{
"BusinessCode": "p_cdn",
"BusinessCodeName": "Content Delivery Network (CDN)"
},
{
"BusinessCode": "p_rav",
"BusinessCodeName": " Tencent Real-Time Communication (TRTC) "
},
{
"BusinessCode": "p_cbs",
"BusinessCodeName": " Cloud Block Storage (CBS)"
},
{
"BusinessCode": "p_cos",
"BusinessCodeName": "Cloud Object Storage (COS)"
},
{
"BusinessCode": "p_ci",
"BusinessCodeName": "Cloud Infinite (CI)"
}
],
"Product": [
{
"ProductCode": "sp_rav_audio_video",
"ProductCodeName": "Tencent Real-Time Communication (TRTC) - Audio/Video Call"
},
{
"ProductCode": "sp_cbs_premium",
“ProductCodeName": "High-performance CBS"
},
{
"ProductCode": "sp_cdn_cn_flux_package",
"ProductCodeName": "Content Delivery Network (CDN) Traffic Package for China"
},
{
"ProductCode": "sp_ci_pkg_im_com",
"ProductCodeName": "CI Image Compression Resource Package"
},
{
"ProductCode": "sp_redis_single",
"ProductCodeName": "TencentDB for Redis - Community Edition"
},
{
"ProductCode": "sp_cos_pkg_std_new",
"ProductCodeName": "Cloud Object Storage (COS) Standard Storage Capacity Package new"
}
],
"Component": [
{
"ComponentCode": "v_ci_pkg_im_com",
"ComponentCodeName": "Image Compression Resource Package"
},
{
"ComponentCode": "v_cbs_memspace",
"ComponentCodeName": "Storage Space"
},
{
"ComponentCode": "v_rav_audio_video_assign",
"ComponentCodeName": "Audio/Video Call - Fixed Package"
},
{
"ComponentCode": "v_redis_mem",
"ComponentCodeName": "Memory"
},
{
"ComponentCode": "v_cos_pkg_std_new",
"ComponentCodeName": "Standard Storage Capacity Package new"
},
{
"ComponentCode": "v_cdn",
"ComponentCodeName": "CDN"
},
{
"ComponentCode": "v_rav_audio_video_custom",
"ComponentCodeName": "Audio/Video Call - Customized Package"
}
],
"Zone": [
{
"ZoneId": 100002,
"ZoneName": "Guangzhou Zone 2"
},
{
"ZoneId": 470002,
"ZoneName": "Universal in the Chinese Mainland"
},
{
"ZoneId": 100001,
"ZoneName": "Guangzhou Zone 1"
},
{
"ZoneId": 0,
"ZoneName": "Other"
}
],
"Item": [
{
"ItemCode": "sv_cos_pkg_std_new_20",
"ItemCodeName": "COS Standard Storage Capacity Package 20GB new"
},
{
"ItemCode": "sv_redis_mem_single",
"ItemCodeName": "TencentDB for Redis - Community Edition - Memory"
},
{
"ItemCode": "sv_rav_audio_video_custom_free",
"ItemCodeName": "Audio/Video Call - Complimentary Package"
},
{
"ItemCode": "sv_cbs_memspace_premium",
"ItemCodeName": "High-performance CBS - Storage Space"
},
{
"ItemCode": "sv_cdn_cn_flux_package",
"ItemCodeName": "Content Delivery Network (CDN) Traffic Package - Traffic"
},
{
"ItemCode": "sv_ci_pkg_im_com_10",
"ItemCodeName": "CI Image Compression Resource Package 100,000 times"
},
{
"ItemCode": "sv_rav_audio_video_assign_formal",
"ItemCodeName": "TRTC - Audio/Video Call - Fixed Package"
}
],
"AllocationTreeNode": [
{
"TreeNodeUniqKey": "700000384179-63733abacc8b8",
"TreeNodeUniqKeyName": "Temporary Billing Items"
},
{
"TreeNodeUniqKey": "700000384179-6376f0b3ada52",
"TreeNodeUniqKeyName": "HR Products"
},
{
"TreeNodeUniqKey": "700000384179-63733ac7e46ff",
"TreeNodeUniqKeyName": "Mid-Term Adjustment Project"
}
],
"InstanceType": [
{
"InstanceType": "ri",
"InstanceTypeName": "Reserved Instances"
},
{
"InstanceType": "svp",
"InstanceTypeName": "Savings Plan"
},
{
"InstanceType": "si",
"InstanceTypeName": "Spot Instances"
},
{
"InstanceType": "rp",
"InstanceTypeName": "Resource Package"
},
{
"InstanceType": "capacityReserve",
"InstanceTypeName": "Capacity Reservation"
}
],
"Region": [
{
"RegionId": 0,
"RegionName": "Other"
},
{
"RegionId": 1,
"RegionName": "South China (Guangzhou)"
},
{
"RegionId": 3,
"RegionName": "North China (Beijing (Beijing Zone 1, formerly Tianjin))"
},
{
"RegionId": 4,
"RegionName": "East China (Shanghai)"
},
{
"RegionId": 5,
"RegionName": "Hong Kong (China), Macao (China), and Taiwan (China) (Hong Kong (China))"
},
{
"RegionId": 7,
"RegionName": "East China (Shanghai Finance)"
},
{
"RegionId": 8,
"RegionName": "North China (Beijing)"
},
{
"RegionId": 9,
"RegionName": "Southeast Asia (Singapore)"
},
{
"RegionId": 11,
"RegionName": "South China (Shenzhen Finance)"
},
{
"RegionId": 12,
"RegionName": "South China (Guangzhou OPEN)"
},
{
"RegionId": 15,
"RegionName": "Western United States (Silicon Valley, USA)"
},
{
"RegionId": 16,
"RegionName": "Southwest China (Chengdu)"
},
{
"RegionId": 17,
"RegionName": "Europe (Frankfurt)"
},
{
"RegionId": 18,
"RegionName": "Asia Pacific (Seoul)"
},
{
"RegionId": 19,
"RegionName": "Southwest China (Chongqing)"
},
{
"RegionId": 21,
"RegionName": "Asia Pacific (India)"
},
{
"RegionId": 22,
"RegionName": "Eastern United States (Virginia)"
},
{
"RegionId": 23,
"RegionName": "Asia Pacific (Thailand)"
},
{
"RegionId": 24,
"RegionName": "Europe (Northeastern Europe)"
},
{
"RegionId": 25,
"RegionName": "Asia Pacific (Japan)"
},
{
"RegionId": 31,
"RegionName": "East China (Jinan)"
},
{
"RegionId": 32,
"RegionName": "East China (Hangzhou)"
},
{
"RegionId": 33,
"RegionName": "East China (Nanjing)"
},
{
"RegionId": 34,
"RegionName": "East China (Fuzhou)"
},
{
"RegionId": 35,
"RegionName": "Central China (Wuhan)"
},
{
"RegionId": 36,
"RegionName": "North China (Tianjin)"
},
{
"RegionId": 37,
"RegionName": "South China (Shenzhen)"
},
{
"RegionId": 39,
"RegionName": "Hong Kong (China), Macao (China), and Taiwan (China) (Taipei (China))"
},
{
"RegionId": 41,
"RegionName": "Middle East (Dubai)"
},
{
"RegionId": 42,
"RegionName": "Southern United States (Los Angeles)"
},
{
"RegionId": 43,
"RegionName": "South America (São Paulo Interconnection Zone, Brazil)"
},
{
"RegionId": 44,
"RegionName": "Australia (Sydney)"
},
{
"RegionId": 45,
"RegionName": "Central China (Changsha)"
},
{
"RegionId": 46,
"RegionName": "North China (Beijing Finance)"
},
{
"RegionId": 47,
"RegionName": "Other Regions (Other)"
},
{
"RegionId": 53,
"RegionName": "North China (Shijiazhuang)"
},
{
"RegionId": 54,
"RegionName": "South China (Qingyuan)"
},
{
"RegionId": 55,
"RegionName": "East China (Hefei)"
},
{
"RegionId": 56,
"RegionName": "Northeast China (Shenyang)"
},
{
"RegionId": 57,
"RegionName": "Northwest China (Xi'an)"
},
{
"RegionId": 58,
"RegionName": "Northwest China (Northwest)"
},
{
"RegionId": 71,
"RegionName": "Central China (Zhengzhou)"
},
{
"RegionId": 72,
"RegionName": "Southeast Asia (Jakarta)"
},
{
"RegionId": 73,
"RegionName": "South China (Qingyuan Xinan)"
},
{
"RegionId": 74,
"RegionName": "South America (São Paulo)"
},
{
"RegionId": 76,
"RegionName": "Southwest China (Guiyang)"
},
{
"RegionId": 77,
"RegionName": "South China (Shenzhen Shenyu Tenpay)"
},
{
"RegionId": 78,
"RegionName": "East China (Shanghai Autonomous Driving Cloud)"
},
{
"RegionId": 79,
"RegionName": "South China (Shenzhen Financial Zone (TCE))"
},
{
"RegionId": 81,
"RegionName": "East China (Shanghai Financial Zone (TCE))"
},
{
"RegionId": 1001,
"RegionName": "Asia Pacific (Asia Pacific Zone 1)"
},
{
"RegionId": 1002,
"RegionName": "Asia Pacific (Asia Pacific Zone 2)"
},
{
"RegionId": 1003,
"RegionName": "Asia Pacific (Asia Pacific Zone 3)"
},
{
"RegionId": 1004,
"RegionName": "Middle East (Middle East)"
},
{
"RegionId": 1005,
"RegionName": "Europe (Europe)"
},
{
"RegionId": 1006,
"RegionName": "North America (North America)"
},
{
"RegionId": 1007,
"RegionName": "South America (South America)"
},
{
"RegionId": 1008,
"RegionName": "Africa (Africa)"
},
{
"RegionId": 1009,
"RegionName": "Chinese Mainland (Chinese Mainland)"
},
{
"RegionId": 1010,
"RegionName": "Custom Zone (Custom Zone)"
},
{
"RegionId": 2009,
"RegionName": "Domestic (Universal in the Chinese Mainland)"
},
{
"RegionId": 2010,
"RegionName": "Overseas (Universal for Hong Kong (China), Macao (China) Taiwan (China), and Overseas)"
}
],
"PayMode": [
{
"PayMode": "prePay",
"PayModeName": "Monthly Subscription"
},
{
"PayMode": "postPay",
"PayModeName": "Pay-as-you-go"
},
{
"PayMode": "riPay",
"PayModeName": "Reserved Instances"
}
],
"Project": [
{
"ProjectId": 0,
"ProjectName": "Default Project"
}
],
"Tag": [
{
"TagKey": "yzd_key2",
"TagValue": "yzd_value2"
},
{
"TagKey": "yzd_key1",
"TagValue": "yzd_value2"
}
],
"RequestId": "fb0d843d-5676-400c-b491-e60379d8af7e"
}
}
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 |
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