请求消息 请求参数 无 请求示例 GET https://bss.myhuaweicloud.com/v2/promotions/benefits/account-change-records?balance_type=BALANCE_TYPE_COUPON&trade_id=4511415621224&trade_type=RECHARGE&trade_time_begin=2020-10-20&trade_time_end=2021-10-20&offset=0&limit=10 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.0100 参数错误。 400 CBC.99000084 不支持伙伴的转售类客户查询优惠券收支明细。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

授权信息 账号具备所有API的调用权限，如果使用账号下的 IAM 用户调用当前API，该IAM用户需具备调用API所需的权限。 如果使用角色与策略授权，具体权限要求请参见策略授权参考。 如果使用身份策略授权，需具备如下身份策略权限。 授权项 描述 访问级别 资源类型（*为必须） 条件键 别名 billing:balance:view 授予查看收支明细，付款历史记录，消费配额，调账记录，欠费查询的权限 list - - -

支持的授权项 策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下： 权限：允许或拒绝某项操作。 对应API接口：自定义策略实际调用的API接口。 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。 IAM项目(Project)/企业项目(Enterprise Project)：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。管理员可以在授权项列表中查看授权项是否支持IAM项目或企业项目，“√”表示支持，“×”表示暂不支持。关于IAM项目与企业项目的区别，详情请参见：IAM与企业管理的区别。 BSS 的支持自定义策略授权项如下所示： 未在表中列出的接口无需进行细粒度权限校验，所有客户账号均可调用。 bss:discount:view授权项仅影响响应中折扣信息返回。即使没有该权限，接口仍可正常访问，但响应中将不返回折扣信息。 不支持系统角色权限鉴权，仅支持策略鉴权。配置指导请参考：创建用户组并授权。

华为云环境地址 环境 说明 地址 BSS请求地址 BSS提供的客户运营能力接口的访问路径（Endpoint）。 客户通过拼接该地址和具体接口的URI访问具体接口。 https://bss.myhuaweicloud.com 说明： 该Endpoint为全局Endpoint，中国站所有区域均可使用。 账号中心 华为云提供给普通客户查看账号基本信息、用户认证、首选项设置、查看我的特权与推荐的运营管理界面。 https://account.huaweicloud.com/usercenter/#/accountindex/accountInfo 费用中心 华为云提供给普通客户充值、续费、查看订单、查看财务信息、查看优惠券与折扣、申请合同、开具发票、退订与变更的运营管理界面。 https://account.huaweicloud.com/usercenter 控制台 华为云普通客户可以登录华为云管理控制台，对华为云各服务进行查看、购买、使用等操作。 https://console.huaweicloud.com/console/ 我的凭证 我的凭证是将客户的安全凭证信息进行集中展示与管理的服务。通过我的凭证，用户可以查询所需的项目ID、账号名称，可以修改已验证手机、邮箱、密码，还可以管理访问密钥（AK/SK）等。 https://console.huaweicloud.com/iam/#/myCredential 父主题： 附录

相关API列表 开放接口 接口定义链接 查询资源包列表 https://support.huaweicloud.com/api-oce/api_order_00027.html 查询资源包使用量 https://support.huaweicloud.com/api-oce/api_order_00028.html 查询资源包使用明细 https://support.huaweicloud.com/api-oce/api_order_00029.html

开发建议及注意事项 本场景的前提是客户已购买包年/包月的云服务资源，然后根据订单列表中的订单ID完成查询包年/包月资源。 续订或退订包年/包月资源和设置或取消包年/包月自动续费操作是按照资源的维度进行，故需先通过查询包年/包月资源列表接口获取资源ID。 续订或退订包年/包月资源时，如果某个主资源ID有对应的从资源ID，系统会将主资源ID和从资源ID一起续订/退订。存在主从资源关系的资源为：云主机为主资源，对应的从资源为云硬盘、虚拟私有云、弹性公网IP和带宽。 自动续费将于产品到期前7天的凌晨3:00开始扣款。若由于账户中余额不足等原因导致第一次未扣费成功，系统将在保留产品资源到期之前，每天凌晨3:00再次尝试进行扣款，直到扣款成功。

相关API列表 开放接口 接口定义链接 查询客户包年/包月资源列表 https://support.huaweicloud.com/api-oce/api_order_00021.html 续订包年/包月资源 https://support.huaweicloud.com/api-oce/api_order_00018.html 退订包年/包月资源 https://support.huaweicloud.com/api-oce/api_order_00019.html 设置包年/包月资源自动续费 https://support.huaweicloud.com/api-oce/api_order_00022.html 取消包年/包月资源自动续费 https://support.huaweicloud.com/api-oce/api_order_00023.html 设置或取消包年/包月资源到期转按需 https://support.huaweicloud.com/api-oce/api_order_00024.html 设置包年/包月资源自动续费扣款日和续费后资源统一到期日 https://support.huaweicloud.com/api-oce/api_order_00031.html

相关API列表 开放接口 接口定义链接 查询订单列表 https://support.huaweicloud.com/api-oce/api_order_00013.html 查询订单详情 https://support.huaweicloud.com/api-oce/api_order_00014.html 查询订单可用优惠券 https://support.huaweicloud.com/api-oce/api_order_00015.html 查询订单可用折扣 https://support.huaweicloud.com/api-oce/api_order_00025.html 支付包年/包月产品订单 https://support.huaweicloud.com/api-oce/api_order_00030.html 取消待支付订单 https://support.huaweicloud.com/api-oce/api_order_00017.html 查询退款订单的金额详情 https://support.huaweicloud.com/api-oce/api_order_00020.html

相关API列表 开放接口 接口定义链接 查询省份信息 https://support.huaweicloud.com/api-oce/mpf_02001.html 查询城市列表 https://support.huaweicloud.com/api-oce/mpf_02002.html 查询区县列表 https://support.huaweicloud.com/api-oce/mpf_02003.html

相关API列表 开放接口 接口定义链接 查询企业组织结构 https://support.huaweicloud.com/api-oce/ep_00020.html 创建企业子账号 https://support.huaweicloud.com/api-oce/ep_00023.html 查询企业子账号列表 https://support.huaweicloud.com/api-oce/ep_00021.html 查询企业主账号可拨款余额 https://support.huaweicloud.com/api-oce/ep_00018.html 查询企业子账号可回收余额 https://support.huaweicloud.com/api-oce/ep_00019.html 企业主账号向企业子账号拨款 https://support.huaweicloud.com/api-oce/ep_00016.html 企业主账号从企业子账号回收拨款 https://support.huaweicloud.com/api-oce/ep_00017.html 发送短信验证码 https://support.huaweicloud.com/api-oce/ep_00014.html

相关API列表 开放接口 接口定义链接 查询云服务类型列表 https://support.huaweicloud.com/api-oce/zh-cn_topic_0000001256679455.html 查询资源类型列表 https://support.huaweicloud.com/api-oce/zh-cn_topic_0000001256519451.html 根据云服务类型查询资源列表 https://support.huaweicloud.com/api-oce/qct_00003.html 查询使用量类型列表 https://support.huaweicloud.com/api-oce/qct_00004.html 查询度量单位列表 https://support.huaweicloud.com/api-oce/qct_00006.html 查询度量单位进制 https://support.huaweicloud.com/api-oce/qct_00007.html

相关API列表 开放接口 接口定义链接 查询汇总账单 https://support.huaweicloud.com/api-oce/mbc_00008.html 查询资源详单 https://support.huaweicloud.com/api-oce/mbc_00003.html 查询资源消费记录 https://support.huaweicloud.com/api-oce/mbc_00004.html

场景描述 客户可以查询消费汇总账单，此账单按月汇总消费数据，可以用于对账。消费汇总数据仅包含前一天24点前的数据。 客户可以查询自己的资源详单，用于反映各类资源的消耗情况。资源详单数据有延迟，最大延迟24小时。 由于资源消费呈现的是资源维度的8位小数原始消费金额，实际从账户扣费时按2位小数进行扣费（即扣到分），会存在精度差异，所以，不推荐消费汇总和资源消费直接对账。 客户可以查询每个资源的消费明细数据。

文档修订记录 修订记录 发布日期 第二十九次正式发布： 本次变更说明如下： 管理优惠券新增查询优惠券收支明细接口。 2025-11-27 第二十八次正式发布： 本次变更说明如下： 管理包年/包月资源新增设置包年/包月资源自动续费扣款日和续费后资源统一到期日接口。 2025-05-26 第二十七次正式发布。 本次变更说明如下： 查询邮寄地址、新增邮寄地址、修改邮寄地址、删除邮寄地址接口均已下线，下线管理邮寄地址章节。 2023-10-27 第二十六次正式发布。 本次变更说明如下： 新增支持 云审计 的关键操作章节。 新增如何查看审计日志章节。 2023-05-16 第二十五次正式发布。 本次变更说明如下： 下线“查询硬件库存”接口。 2021-12-10 第二十四次正式发布。 本次变更说明如下： 新增管理资源包章节。 2021-06-10 第二十三次正式发布。 本次变更说明如下： 修改管理包年/包月订单，新增查询订单可用折扣接口。 2021-04-22 第二十二次正式发布。 本次变更说明如下： 修改管理包年/包月订单，“相关API列表”新增查询订单可用折扣接口。 2021-01-22 第二十一次正式发布。 本次变更说明如下： 修改查询产品信息，“相关API列表”新增查询度量单位列表、查询度量单位进制接口。 2020-12-25 第二十次正式发布。 本次变更说明如下： 修改查询产品信息，“相关API列表”新增查询使用量类型列表接口。 修改管理包年/包月资源，“相关API列表”新增设置或取消包年/包月资源到期转按需接口。 2020-11-13 第十九次正式发布。 本次变更说明如下： 新增查询产品信息，“相关API列表”新增如下接口： 查询云服务类型列表 查询资源类型列表 根据云服务类型查询资源列表 2020-10-30 第十八次正式发布。 本次变更说明如下： 修改查询商品信息，“相关API列表”下线“查询订单的资源开通详情”接口。 修改管理企业多账号，“相关API列表”更新查询企业组织结构和查询企业子账号列表接口。 2020-10-16 第十七次正式发布。 本次变更说明如下： 修改19.1-管理邮寄地址，“相关API列表”更新查询邮寄地址接口。 修改管理企业项目，“相关API列表”更新开通客户企业项目权限接口。 修改管理企业多账号，“相关API列表”更新查询企业主账号可拨款余额和查询企业子账号可回收余额接口。 2020-08-28 第十六次正式发布。 本次变更说明如下： 修改管理账户，“相关API列表”更新查询账户余额接口。 修改管理账单，“相关API列表”更新查询消费汇总接口。 2020-08-07 第十五次正式发布。 本次变更说明如下： 修改管理包年/包月资源，“相关API列表”更新查询退款订单的金额详情、查询客户包年/包月资源列表、设置包年/包月资源自动续费、取消包年/包月资源自动续费接口。 2020-06-23 第十四次正式发布。 本次变更说明如下： 修改管理包年/包月订单，“相关API列表”更新查询订单列表、查询订单详情、查询订单可用优惠券、支付包年/包月产品订单、取消待支付订单、续订包年/包月资源和退订包年/包月资源接口。 2020-06-12管理包年/包月订单 第十三次正式发布。 本次变更说明如下： 修改管理企业多账号，“相关API列表”更新企业主账号向企业子账号拨款、企业主账号从企业子账号回收拨款接口。 2020-05-29 第十二次正式发布。 本次变更说明如下： 术语“包周期”修改为“包年/包月”。 2020-05-15 第十一次正式发布。 本次变更说明如下： 修改管理账单，更新查询资源消费记录接口。 2020-04-17 第十次正式发布。 本次变更说明如下： 新增管理优惠券，增加查询优惠券列表接口。 2020-04-10 第九次正式发布。 本次变更说明如下： 修改管理企业多账号，“相关API列表”新增“发送短信验证码”接口。 2020-03-27 第八次正式发布。 本次变更说明如下： 修改查询商品信息，“相关API列表”新增查询按需产品价格、查询包年/包月产品价格、查询硬件库存接口。 下线“根据产品规格查询价格”接口。 2020-03-20 第七次正式发布。 本次变更说明如下： 修改19.1-管理邮寄地址，“相关API列表”增加新增邮寄地址、修改邮寄地址和删除邮寄地址。 2020-03-20 第六次正式发布。 本次变更说明如下： 修改管理账单，更新“查询资源详单”接口的链接。 2020-02-28 第五次正式发布。 本次变更说明如下： 修改管理交易，“相关API列表”新增查询套餐内使用量。 2020-01-17 第四次正式发布。 本次变更说明如下： 新增管理配置信息。 2020-01-10 第三次正式发布。 本次变更说明如下： 管理包年/包月订单新增“查询订单列表”和“查询订单详情”的场景描述、API列表和调用流程。 2019-09-12 第二次正式发布。 本次变更说明如下： 管理账单新增“查询资源消费记录”的场景描述、API列表和调用流程。 2019-08-30 第一次正式发布。 2019-08-23