1. 接口描述
接口请求域名： billing.tencentcloudapi.com 。
查询分账账单筛选条件
默认接口请求频率限制：20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：DescribeAllocationBillConditions。 |
| Version | 是 | String | 公共参数，本接口取值：2018-07-09。 |
| Region | 否 | String | 公共参数，此参数为可选参数。 |
| Month | 否 | String | 账单月份，格式为2024-02，不传默认当前月 示例值：2024-02 |
| TreeNodeUniqKeys.N | 否 | Array of String | 分账单元唯一标识，用作筛选 示例值：["909619400-hdngsfxtoqlh"] |
| BillDates.N | 否 | Array of String | 日期 示例值：["2022-10-01"] |
| BusinessCodes.N | 否 | Array of String | 产品编码 示例值：["p_cvm"] |
| OwnerUins.N | 否 | Array of String | 使用者UIN 示例值：["909619400"] |
| OperateUins.N | 否 | Array of String | 操作者UIN 示例值：["909619400"] |
| PayModes.N | 否 | Array of String | 计费模式编码 示例值：["postPay"] |
| ActionTypes.N | 否 | Array of String | 交易类型编码 示例值：["prepay_renew"] |
| ProductCodes.N | 否 | Array of String | 子产品编码 示例值：["sp_cvm_c4"] |
| RegionIds.N | 否 | Array of String | 地域ID 示例值：["0","1"] |
| ZoneIds.N | 否 | Array of String | 可用区ID 示例值：["100002","100003"] |
| InstanceTypes.N | 否 | Array of String | 实例类型编码 示例值：["ri"] |
| Tag.N | 否 | Array of String | 标签 示例值：["tagKey:tagValue"] |
| ComponentCodes.N | 否 | Array of String | 组件类型编码 示例值：["virtual_v_cvm_compute"] |
| ItemCodes.N | 否 | Array of String | 组件名称编码 示例值：["virtual_v_cvm_compute_c4"] |
| SearchKey | 否 | String | 模糊搜索条件 示例值：ins-yhtdg16 |
| ProjectIds.N | 否 | Array of Integer | 项目id 示例值：[0] |
| AllocationType.N | 否 | Array of Integer | 费用归集类型 枚举值：
示例值：[0,1] |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| Business | Array of BillBusiness | 产品筛选列表 |
| Product | Array of BillProduct | 子产品筛选列表 |
| Item | Array of BillItem | 组件名称筛选列表 |
| Region | Array of BillRegion | 地域筛选列表 |
| InstanceType | Array of BillInstanceType | 实例类型筛选列表 |
| PayMode | Array of BillPayMode | 计费模式筛选列表 |
| Project | Array of BillProject | 项目筛选列表 |
| Tag | Array of BillTag | 标签筛选列表 |
| OwnerUin | Array of BillOwnerUin | 使用者 UIN 筛选列表 |
| OperateUin | Array of BillOperateUin | 操作者 UIN 筛选列表 |
| BillDay | Array of BillDays | 日期筛选列表 |
| ActionType | Array of BillActionType | 交易类型筛选列表 |
| Component | Array of BillComponent | 组件类型筛选列表 |
| Zone | Array of BillZoneId | 可用区筛选列表 |
| AllocationTreeNode | Array of AllocationTreeNode | 分账单元筛选列表 |
| TagKey | Array of String | 分账标签键 示例值：["游戏项目组","部门","机房","云应用","运营状态"] |
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 查询分账报表结果所需筛选条件
输入示例
POST / HTTP/1.1
Host: billing.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeAllocationBillConditions
<公共请求参数>
{
"Month": "2022-11-01 00:00:00"
}输出示例
{
"Response": {
"OwnerUin": [
{
"OwnerUin": "700000384179"
}
],
"OperateUin": [
{
"OperateUin": "700000384179"
}
],
"BillDay": [
{
"BillDay": "2022-11-02"
}
],
"ActionType": [
{
"ActionType": "prepay_purchase",
"ActionTypeName": "包年包月新购"
},
{
"ActionType": "prepay_renew",
"ActionTypeName": "包年包月续费"
}
],
"Business": [
{
"BusinessCode": "p_redis",
"BusinessCodeName": "云数据库Redis"
},
{
"BusinessCode": "p_cdn",
"BusinessCodeName": "内容分发网络CDN"
},
{
"BusinessCode": "p_rav",
"BusinessCodeName": "实时音视频"
},
{
"BusinessCode": "p_cbs",
"BusinessCodeName": "云硬盘CBS"
},
{
"BusinessCode": "p_cos",
"BusinessCodeName": "COS 对象存储"
},
{
"BusinessCode": "p_ci",
"BusinessCodeName": "数据万象CI"
}
],
"Product": [
{
"ProductCode": "sp_rav_audio_video",
"ProductCodeName": "实时音视频-音视频通话"
},
{
"ProductCode": "sp_cbs_premium",
"ProductCodeName": "高性能云硬盘"
},
{
"ProductCode": "sp_cdn_cn_flux_package",
"ProductCodeName": "中国境内CDN流量包"
},
{
"ProductCode": "sp_ci_pkg_im_com",
"ProductCodeName": "CI 图片压缩资源包"
},
{
"ProductCode": "sp_redis_single",
"ProductCodeName": "云数据库Redis-社区版"
},
{
"ProductCode": "sp_cos_pkg_std_new",
"ProductCodeName": "COS 标准存储容量包 new"
}
],
"Component": [
{
"ComponentCode": "v_ci_pkg_im_com",
"ComponentCodeName": "图片压缩资源包"
},
{
"ComponentCode": "v_cbs_memspace",
"ComponentCodeName": "存储空间"
},
{
"ComponentCode": "v_rav_audio_video_assign",
"ComponentCodeName": "音视频通话-固定套餐包"
},
{
"ComponentCode": "v_redis_mem",
"ComponentCodeName": "内存"
},
{
"ComponentCode": "v_cos_pkg_std_new",
"ComponentCodeName": "标准存储容量包 new"
},
{
"ComponentCode": "v_cdn",
"ComponentCodeName": "CDN"
},
{
"ComponentCode": "v_rav_audio_video_custom",
"ComponentCodeName": "音视频通话-自定义套餐包"
}
],
"Zone": [
{
"ZoneId": 100002,
"ZoneName": "广州二区"
},
{
"ZoneId": 470002,
"ZoneName": "中国大陆通用"
},
{
"ZoneId": 100001,
"ZoneName": "广州一区"
},
{
"ZoneId": 0,
"ZoneName": "其他"
}
],
"Item": [
{
"ItemCode": "sv_cos_pkg_std_new_20",
"ItemCodeName": "COS 标准存储容量包 20GB new"
},
{
"ItemCode": "sv_redis_mem_single",
"ItemCodeName": "云数据库Redis-社区版-内存"
},
{
"ItemCode": "sv_rav_audio_video_custom_free",
"ItemCodeName": "音视频通话-赠送套餐包"
},
{
"ItemCode": "sv_cbs_memspace_premium",
"ItemCodeName": "高性能云硬盘-存储空间"
},
{
"ItemCode": "sv_cdn_cn_flux_package",
"ItemCodeName": "CDN流量包-流量"
},
{
"ItemCode": "sv_ci_pkg_im_com_10",
"ItemCodeName": "CI 图片压缩资源包 10万次"
},
{
"ItemCode": "sv_rav_audio_video_assign_formal",
"ItemCodeName": "实时音视频-音视频通话-固定套餐包"
}
],
"AllocationTreeNode": [
{
"TreeNodeUniqKey": "700000384179-63733abacc8b8",
"TreeNodeUniqKeyName": "计费临时项目"
},
{
"TreeNodeUniqKey": "700000384179-6376f0b3ada52",
"TreeNodeUniqKeyName": "HR产品"
},
{
"TreeNodeUniqKey": "700000384179-63733ac7e46ff",
"TreeNodeUniqKeyName": "中期调整项目"
}
],
"InstanceType": [
{
"InstanceType": "ri",
"InstanceTypeName": "预留实例"
},
{
"InstanceType": "svp",
"InstanceTypeName": "节省计划"
},
{
"InstanceType": "si",
"InstanceTypeName": "竞价实例"
},
{
"InstanceType": "rp",
"InstanceTypeName": "资源包"
},
{
"InstanceType": "capacityReserve",
"InstanceTypeName": "容量预留"
}
],
"Region": [
{
"RegionId": 0,
"RegionName": "其他"
},
{
"RegionId": 1,
"RegionName": "华南地区（广州）"
},
{
"RegionId": 3,
"RegionName": "华北地区（北京(北京一区 原天津)）"
},
{
"RegionId": 4,
"RegionName": "华东地区（上海）"
},
{
"RegionId": 5,
"RegionName": "港澳台地区（香港）"
},
{
"RegionId": 7,
"RegionName": "华东地区（上海金融）"
},
{
"RegionId": 8,
"RegionName": "华北地区（北京）"
},
{
"RegionId": 9,
"RegionName": "东南亚地区（新加坡）"
},
{
"RegionId": 11,
"RegionName": "华南地区（深圳金融）"
},
{
"RegionId": 12,
"RegionName": "华南地区（广州OPEN）"
},
{
"RegionId": 15,
"RegionName": "美西地区（美国硅谷）"
},
{
"RegionId": 16,
"RegionName": "西南地区（成都）"
},
{
"RegionId": 17,
"RegionName": "欧洲地区（法兰克福）"
},
{
"RegionId": 18,
"RegionName": "亚太地区（首尔）"
},
{
"RegionId": 19,
"RegionName": "西南地区（重庆）"
},
{
"RegionId": 21,
"RegionName": "亚太地区（印度）"
},
{
"RegionId": 22,
"RegionName": "美东地区（弗吉尼亚）"
},
{
"RegionId": 23,
"RegionName": "亚太地区（泰国）"
},
{
"RegionId": 24,
"RegionName": "欧洲地区（欧洲东北）"
},
{
"RegionId": 25,
"RegionName": "亚太地区（日本）"
},
{
"RegionId": 31,
"RegionName": "华东地区（济南）"
},
{
"RegionId": 32,
"RegionName": "华东地区（杭州）"
},
{
"RegionId": 33,
"RegionName": "华东地区（南京）"
},
{
"RegionId": 34,
"RegionName": "华东地区（福州）"
},
{
"RegionId": 35,
"RegionName": "华中地区（武汉）"
},
{
"RegionId": 36,
"RegionName": "华北地区（天津）"
},
{
"RegionId": 37,
"RegionName": "华南地区（深圳）"
},
{
"RegionId": 39,
"RegionName": "港澳台地区（台北）"
},
{
"RegionId": 41,
"RegionName": "中东地区（迪拜）"
},
{
"RegionId": 42,
"RegionName": "美国南部（洛杉矶）"
},
{
"RegionId": 43,
"RegionName": "南美地区（巴西圣保罗互联区）"
},
{
"RegionId": 44,
"RegionName": "澳洲地区（悉尼）"
},
{
"RegionId": 45,
"RegionName": "华中地区（长沙）"
},
{
"RegionId": 46,
"RegionName": "华北地区（北京金融）"
},
{
"RegionId": 47,
"RegionName": "其他地区（其他）"
},
{
"RegionId": 53,
"RegionName": "华北地区（石家庄）"
},
{
"RegionId": 54,
"RegionName": "华南地区（清远）"
},
{
"RegionId": 55,
"RegionName": "华东地区（合肥）"
},
{
"RegionId": 56,
"RegionName": "东北地区（沈阳）"
},
{
"RegionId": 57,
"RegionName": "西北地区（西安）"
},
{
"RegionId": 58,
"RegionName": "西北地区（西北）"
},
{
"RegionId": 71,
"RegionName": "华中地区（郑州）"
},
{
"RegionId": 72,
"RegionName": "亚太东南地区（雅加达）"
},
{
"RegionId": 73,
"RegionName": "华南地区（清远信安）"
},
{
"RegionId": 74,
"RegionName": "南美地区（圣保罗）"
},
{
"RegionId": 76,
"RegionName": "西南地区（贵阳）"
},
{
"RegionId": 77,
"RegionName": "华南地区（深圳深宇财付通）"
},
{
"RegionId": 78,
"RegionName": "华东地区（上海自动驾驶云）"
},
{
"RegionId": 79,
"RegionName": "华南地区（深圳金融专区(TCE)）"
},
{
"RegionId": 81,
"RegionName": "华东地区（上海金融专区(TCE)）"
},
{
"RegionId": 1001,
"RegionName": "亚太地区（亚太一区）"
},
{
"RegionId": 1002,
"RegionName": "亚太地区（亚太二区）"
},
{
"RegionId": 1003,
"RegionName": "亚太地区（亚太三区）"
},
{
"RegionId": 1004,
"RegionName": "中东地区（中东）"
},
{
"RegionId": 1005,
"RegionName": "欧洲地区（欧洲）"
},
{
"RegionId": 1006,
"RegionName": "北美地区（北美）"
},
{
"RegionId": 1007,
"RegionName": "南美地区（南美）"
},
{
"RegionId": 1008,
"RegionName": "非洲地区（非洲）"
},
{
"RegionId": 1009,
"RegionName": "中国大陆（中国大陆）"
},
{
"RegionId": 1010,
"RegionName": "自定义区（自定义区）"
},
{
"RegionId": 2009,
"RegionName": "境内地区（中国大陆通用）"
},
{
"RegionId": 2010,
"RegionName": "境外地区（中国港澳台与海外通用）"
}
],
"PayMode": [
{
"PayMode": "prePay",
"PayModeName": "包年包月"
},
{
"PayMode": "postPay",
"PayModeName": "按量计费"
},
{
"PayMode": "riPay",
"PayModeName": "预留实例"
}
],
"Project": [
{
"ProjectId": 0,
"ProjectName": "默认项目"
}
],
"Tag": [
{
"TagKey": "yzd_key2",
"TagValue": "yzd_value2"
},
{
"TagKey": "yzd_key1",
"TagValue": "yzd_value2"
}
],
"RequestId": "fb0d843d-5676-400c-b491-e60379d8af7e"
}
}5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| AuthFailure | CAM签名/鉴权错误。 |
| AuthFailure.UnauthorizedOperation | 没有权限。 |
| InternalError | 内部错误。 |
| InvalidParameter | 参数错误。 |
| InvalidParameterValue | 参数取值错误。 |
| MissingParameter | 缺少参数错误。 |
