文档修订记录

第六十二次正式发布。

本次变更说明如下：

• 查询资源详单V2新增响应字段extend_params：资源关系信息。该字段为预留字段。
• 新增查询企业子账号列表接口，企业主账号在自建平台查询企业子账号信息列表。

2025-02-24

第六十一次正式发布。

本次变更说明如下：

• 查询资源消费记录V2新增响应字段relative_order_id：客户订单关联的订单ID。
• 查询资源详单V2新增响应字段be_id：华为云运营实体ID。
• 查询客户包年/包月资源列表权限项修改为：bss:renewal:view|bss:order:view（待下线）;退订包年/包月资源权限项修改为bss:unsubscribe:update|

  bss:order:update（待下线）;查询资源包使用明细权限项修改为bss:bill:view|

  bss:billDetail:view（待下线）；查询资源消费记录权限项修改为bss:bill:view|

  bss:billDetail:view（待下线）。更多权限项请参见：API调用授权（客户）

• 查询订单列表V2响应字段order_infos字段新增sub_order_infos字段：客户订单下属的订单详情信息。
• 查询订单详情V2响应字段order_infos字段新增sub_order_infos字段：客户订单下属的订单详情信息。响应字段order_line_items新增order_id字段：订单ID。

2025-01-20

第六十次正式发布。

本次变更说明如下：

• 查询客户包年/包月资源列表V2新增响应字段update_time：资源更新时间；enterprise_project：客户资源企业项目详情信息。
• 查询资源消费记录V2新增响应字段consume_time：消费时间。
• 查询资源详单V2新增响应字段consume_time：消费时间。

2024-12-23

第五十九次正式发布。

本次变更说明如下：

• 查询客户包年/包月资源列表V2新增响应参数product_spec_desc：产品的规格描述；spec_size：产品的实例大小；spec_size_measure_id：产品实例大小的单位。
• 查询订单详情V2新增响应参数pending_payment_end_time：订单待付款截止时间 ；base_product_info：变更前订单行产品信息。

2024-11-26

第五十八次正式发布。

本次变更说明如下：

• 查询优惠券列表查询参数status删除枚举值：未激活；查询参数status删除说明：已使用、已过期和已回收优惠券，只返回12个月以内的数据。
• 查询订单列表新增响应字段enterprise_projects：客户订单企业项目详情信息。
• 查询资源消费记录（旧）和查询资源详单（旧）响应参数resourceTag字段最大长度变更为8192。
• 查询资源消费记录、查询资源详单响应参数resource_tag字段最大长度变更为8192。
• 查询资源详单流量配额由10/1(s)变更为30/1(s)。

2024-10-29

第五十七次正式发布。

本次变更说明如下：

查询资源详单V2接口请求参数statistic_type增加枚举值请求参数statistic_type增加枚举值3：按明细；新增响应参数

effective_time和expire_time；请求参数query_type描述变更：仅当statistic_type=2或3时，支持传递query_type=DAILY。

2024-9-26

第五十六次正式发布。

本次变更说明如下：

华为云从2024/09/01 00:00:00 GMT+08:00 起，根据华为云用户协议对账单账期归属计算规则进行优化。优化后客户获取的账期将与消费时间关联。

详见：华为云如何计算账期

2024-8-29

第五十五次正式发布。

本次变更说明如下：

• 查询资源消费记录参数resource_name、sub_resource_name新增说明：该参数返回值为用户在下单资源时手动填写的内容，不支持国际化。enterprise_project_name新增说明：该参数返回值为用户手动填写的内容，不支持国际化。
• 查询资源详单V2接口新增请求和响应字段payer_account_id：支付账号ID。

2024-8-29

第五十四次正式发布。

本次变更说明如下：

• 查询成本数据V4接口新增错误码CBC.18000053：权限不足，请联系您的企业主。
• 退订包年/包月资源V2&V1接口删除错误码CBC.30010035：资源已被删除；新增错误码CBC.30000067：资源已被删除或者资源未被纳管，不支持退订。
• 查询按需产品价格V2接口新增说明：如果只是临时查询产品价格，可以到价格计算器查询。询价Api入参参数product_infos取值可以参考价格计算器查询入参，详情见按需询价示例。
• 查询包年/包月产品价格V2接口新增说明：如果只是临时查询产品价格，可以到价格计算器查询。询价Api入参参数product_infos取值可以参考价格计算器查询入参，详情见包周期询价示例。
• 查询优惠券列表V2接口请求参数status增加枚举值5：已回收。
• 查询客户包年/包月资源列表V2接口请求参数status_list增加枚举值3：已关闭。

2024-6-28

第五十三次正式发布。

本次变更说明如下：

• 查询包年/包月资源的续订金额V2接口新增请求参数include_relative_resources ： 是否包含关联资源一起续费询价。响应RenewInquiryResultInfo.resource_id增加说明：请求携带“include_relative_resources”字段，会返回关联资源的主资源ID和续订金额。
• 查询客户包年/包月资源列表V2接口新增请求参数service_type_code：云服务类型编码。
• 续订包年/包月资源V2接口新增错误码CBC.30010069 ：不存在的续费周期。
• 续订包年/包月资源V1接口新增错误码CBC.99003154：资源已购买时长加本次续费时长后已超过最大值，请重新选择续费时长。
• 查询资源包列表V3接口新增请求参数service_type_code_list：云服务类型编码列表，大小写不敏感。
• 查询资源消费记录V2新增查询参数statistic_type ：统计类型。

  bill_date_begin&bill_date_end新增说明：按账期类型统计时字段不生效。

  id新增说明：按账期类型统计时不返回唯一标识。

  usage新增说明：查询包周期资源，不返回资源的使用量。

  usage_measure_id新增说明：查询包周期资源，不返回资源使用量的度量单位。

  unit新增说明：当statistic_type入参为1，按账期，查询包周期产品时，不返回单价单位。

  formula新增说明：按账期类型查询时不返回计算公式。

• 查询资源详单V2新增header参数X-Language：语言。

2024-5-28

第五十二次正式发布。

本次变更说明如下：

• 退订包年/包月资源 V2接口删除错误码“ CBC.99003645-该类型的云服务不支持退订。"
• 续订包年/包月资源 V2接口删除错误码 “CBC.99003631-退订中/删除中/释放中的资源不能续费。”
• 查询按需产品价格 V2接口删除错误码 "400 CBC.99006073项目不存在。"

• 开通客户企业项目权限 V2接口上线
• 查询订单列表 V2 & V1接口订单创建时间和订单支付时间修改：开始与结束时间间隔不能超过1年。
• 查询成本数据 V4 接口 新增错误码：“CBC.18000048 -您名下的财务独立子，超过系统可支持查询的数量，请指定企业子账号查询。”

2024-4-28

第五十一次正式发布。

本次变更说明如下：

查询成本数据V4接口维度分组条件新增分拆项：“SPLIT_ITEM_NAME：分拆项”；

成本类型为“ORIGINAL_COST：原始成本”时，不支持按“SPLIT_ITEM_NAME：分拆项”维度查询。

2024-3-29

第五十次正式发布。

本次变更说明如下：

退订包年/包月资源V2接口新增错误码 “CBC.99003647 -该按需套餐包不支持退订。"

2024-2-23

第四十九次正式发布。

本次变更说明如下：

• 续订包年/包月资源 V2接口新增错误码“CBC.99000092 - 订购周期校验失败。”
• 取消待支付订单V1接口下线。

2024-1-25

第四十八次正式发布。

支付包年/包月产品订单（旧）v1接口下线。

2023-12-26

第四十七次正式发布。

本次变更说明：

根据产品规格查询价格（旧）v1接口下线。

2023-10-25

第四十六次正式发布。

本次变更说明如下：”

• 支付包年/包月产品订单接口新增错误码“CBC.99000088：抱歉，支付处理中，请勿重复操作。”。
• 查询资源消费记录和查询资源详单接口，请求和响应参数“charge_mode”新增枚举“11：节省计划”，请求和响应参数“bill_type”新增枚举“23：消费-节省计划抵扣”。
• 查询汇总账单接口响应参数“promotion_type”新增枚举“611：节省计划”。
• 查询优惠券列表接口响应参数“cycleType”新增枚举“11：节省计划”。

2023-06-29

第四十五次正式发布。

本次变更说明如下：

• 查询资源详单接口新增响应参数“pre_order_id”、“az_code_infos“和“az_code“，用于查询原订单ID、可用区信息列表和可用区编码。

• 新增API调用授权（客户）的章节，客户账号调用API需要经过授权，可通过用户中心统一身份认证修改权限进行授权。
• 查询包年/包月资源的续订金额接口新增错误码“CBC.30050013：该产品不支持续费”。

2023-4-18

第四十四次正式发布。

本次变更说明如下：

新增查询包年/包月资源的续订金额接口，客户可以按照条件查询包年/包月资源续订时候的续订金额。

2023-3-30

第四十三次正式发布。

本次变更说明如下：

续订包年/包月资源和退订包年/包月资源接口新增响应参数“fail_resource_infos”，用于查询失败的资源信息。

2023-2-9

第四十二次正式发布。

本次变更说明如下：

• 新增查询资源包使用明细接口，可查询客户的资源包使用明细。
• 查询资源详单和查询资源消费记录接口新增返回响应参数：

  "sub_service_type_code"、"sub_service_type_name"、"sub_resource_type_code"、"sub_resource_type_name"、"sub_resource_id"和"sub_resource_name"。

2022-12-27

第四十一次正式发布。

本次变更说明如下：

• 查询成本数据接口修改请求参数“groupby”的取值范围为：“最大个数：2”。
• 查询资源消费记录接口新增返回响应参数“formula”。

2022-11-29

第四十次正式发布。

本次变更说明如下：

• 设置包年/包月资源自动续费V1接口下线。
• 取消包年/包月资源自动续费V1接口下线。

2022-11-17

第三十九次正式发布。

本次变更说明如下：

新增支付包年/包月产品订单V3接口，支付包年/包月产品订单 V2接口移至待下线接口。

2022-09-27

第三十八次正式发布。

本次变更说明如下：

查询资源详单接口新增响应参数“root_resource_id”、“parent_resource_id”、“trade_id”和“product_spec_desc”。

2022-09-13

第三十七次正式发布。

本次变更说明如下：

查询资源消费记录接口响应参数“feeSourceOperation”修改枚举值描述为“20：退款-变更(整机)”和新增枚举值“21： 退款-变更(降配)”。

2022-08-30

第三十六次正式发布。

本次变更说明如下：

新增查询成本数据接口，调用该接口客户可在自建平台查询成本分析数据。

2022-08-16

第三十五次正式发布。

本次变更说明如下：

修改“云市场”为“云商店”。

2022-08-10

第三十四次正式发布。

本次变更说明如下：

• 退订包年/包月资源接口新增返回错误码“CBC.30010035”。

2022-07-19

第三十三次正式发布。

本次变更说明如下：

退订包年/包月资源接口新增说明“您正在退订使用中的资源，请仔细确认资源信息和退款信息。未放入回收站的资源退订后无法恢复，若您要保留资源，仅退订未使用的续费周期，请退订续费周期。”

2022-07-05

第三十二次正式发布。

本次变更说明如下：

• 查询资源详单接口新增返回响应参数“period_type”，用于支持查看资源的详细周期类型。
• 新增查询云服务类型列表接口，查询云服务类型列表（旧）接口移至待下线接口。
• 新增查询资源类型列表接口，查询资源类型列表（旧）接口移至待下线接口。
• 查询使用量类型列表、支付包年/包月产品订单、查询退款订单的金额详情、查询客户包年/包月资源列表、查询汇总账单接口新增返回响应参数“service_type_name”和“resource_type_name”，用于返回云服务类型名称和资源类型名称。
• 查询资源详单、查询资源消费记录接口新增返回响应参数“cloud_service_type_name”和“resource_type_name”，用于返回云服务类型名称和资源类型名称。
• 查询订单详情、查询资源包列表接口新增返回响应参数“service_type_name”，用于返回云服务类型名称。

2022-04-12

第三十一次正式发布。

本次变更说明如下：

• 合作伙伴生态交易模式名称变更，“推荐”模式更名为“顾问销售”模式。
• 查询账户余额V2接口响应参数“account_type”新增枚举值“7：保证金”。

2022-03-25

第三十次正式发布。

本次变更说明如下：

取消包年/包月资源自动续费V2接口新增返回错误码“CBC.99003605”。

2022-03-15

第二十九次正式发布。

本次变更说明如下：

查询资源详单接口参数“bill_type”新增枚举值“20：退款-变更”。

2022-02-15

第二十八次正式发布。

本次变更说明如下：

• 续订包年/包月资源接口新增返回错误码“CBC.30010036”。
• 设置包年/包月资源自动续费接口新增返回错误码“CBC.99003602”。
• 查询资源消费记录（旧）接口响应参数“feeSourceOperation”新增枚举值“19：变更-增配”和“20：变更-减配”。

2022-01-25

第二十七次正式发布。

本次变更说明如下：

• 查询包年/包月产品价格接口新增返回错误码“CBC.0250”。
• 续订包年/包月资源接口新增返回错误码“CBC.30050006”。
• 支付包年/包月产品订单V2接口新增返回错误码“CBC.99003115”。
• 支付包年/包月产品订单V2接口新增返回错误码“CBC.99003156”。
• 支付包年/包月产品订单V1接口新增返回错误码“CBC.99003156”。

2022-01-11

第二十六次正式发布。

本次变更说明如下：

• 查询资源详单接口新增请求参数“statistic_type”和响应参数“bill_date”，用于支持查询按天统计的资源详单。
• 续订包年/包月资源接口删除错误码“CBC.99003001”。

2021-11-30

第二十五次正式发布。

本次变更说明如下：

续订包年/包月资源接口错误码“CBC.99003016”描述修改为“资源已过期删除或不存在”。

2021-11-02

第二十四次正式发布。

本次变更说明如下：

• 新增查询资源包列表 V3接口，查询资源包列表 V2接口移至待下线接口。
• 查询客户包年/包月资源列表接口新增请求参数“expire_time_begin”和“expire_time_end”，用于支持查询指定时间段内失效的资源列表。

2021-09-28

第二十三次正式发布。

本次变更说明如下：

• 支付包年/包月产品订单接口新增错误码“CBC.30000010”。
• 查询资源消费记录接口的响应参数“unit”新增说明，用以区分线性产品和非线性产品的单价单位。

2021-08-31

第二十二次正式发布。

本次变更说明如下：

查询套餐内使用量（旧）移至待下线接口。

2021-08-10

第二十一次正式发布。

本次变更说明如下：

查询订单详情接口新增响应参数“user_name”，用于查询订单详情时返回订单创建者名称。

2021-07-13

第二十次正式发布。

本次变更说明如下：

• 新增查询资源包列表（旧）接口，调用该接口可查询客户的资源包列表。
• 新增查询资源包使用量接口，调用该接口可查询客户的资源包使用量。

2021-06-15

第十九次正式发布。

本次变更说明如下：

新增查询订单可用折扣接口，调用该接口可在支付订单时查看可使用的折扣。

2021-04-28

第十八次正式发布。

本次变更说明如下：

• 修改查询资源详单，新增“sku_code”和“region_name 字段”，用于调用接口时响应消息中返回产品的SKU属性和云服务区名称。

• 修改查询资源消费记录 ，请求参数新增“bill_date_begin”和“bill_date_end” 用于调用接口时可以在账期内自定义查询消费记录的具体日期；响应参数新增“region_name”用以返回返回云服务区名称。

2021-01-13

第十七次正式发布。

本次变更说明如下：

• 新增查询度量单位列表和查询度量单位进制接口。

• 修改“查询资源消费记录” V2接口：查询参数charge_mode由必选改为可选；请求与响应参数bill_type新增枚举“17：消费-保底差额”。

2020-12-25

第十六次正式发布。

本次变更说明如下：

修改支付包年/包月产品订单接口，新增请求参数“discount_infos”及表 DiscountSimpleInfo，用于支付包年包月订单时查询可使用的折扣。

2020-12-16

第十五次正式发布。

本次变更说明如下：

• 新增查询使用量类型列表接口，用于查询使用量类型。
• 新增设置或取消包年/包月资源到期转按需接口，用于查询资源类型。
• 查询订单列表、查询订单详情和查询汇总账单接口及待下线接口中查询订单列表（旧）、查询订单详情（旧）接口的响应参数“discount_type”新增枚举值“610：免单金额”。

2020-11-18

第十四次正式发布。

本次变更说明如下：

新增查询云服务类型列表（旧）接口，用于查询云服务类型。

新增查询资源类型列表（旧）接口，用于查询资源类型。

新增根据云服务类型查询资源列表接口，可以根据云服务类型查询对应的资源列表。

2020-11-04

第十三次正式发布。

本次变更说明如下：

查询资源消费记录接口新增请求及响应参数“trade_id”，用以标识交易ID或订单ID。

2020-10-21

第十二次正式发布。

本次变更说明如下：

• 查询资源消费记录接口新增查询参数“method”和“sub_customer_id”。
• 查询资源详单接口新增查询参数“method”和“sub_customer_id”，响应参数新增“customer_id”。

新增以上参数，支持查询账单时只查询客户自己或某企业子客户的数据。

2020-09-28

第十一次正式发布。

本次变更说明如下：

• 查询订单详情接口新增响应参数“product_owner_service”和“commercial_resource”。
• 以下接口中“measure_id”参数的默认值由“分”修改为“元”，涉及金额的字段值将同步换算单位为“元”，调用时请确认金额的单位。
  • 查询订单列表
  • 查询订单详情
  • 查询退款订单的金额详情
  • 查询资源详单
  • 查询资源消费记录
  • 查询账户余额

2020-09-16

第十次正式发布。

本次变更说明如下：

• 修改查询资源消费记录接口，响应消息中表3新增参数“enterprise_project_name”和“product_spec_desc”。
• 查询按需产品价格和查询包年/包月产品价格接口新增错误码CBC.99006006、CBC.99006055、CBC.99006074。

2020-09-02

第九次正式发布。

本次变更说明如下：

新增查询账户余额 V2接口。

2020-08-12

第八次正式发布。

本次变更说明如下：

• 新增查询退款订单的金额详情 V2接口。
• 新增查询客户包年/包月资源列表 V2接口，查询客户包年/包月资源列表（旧） V1接口移至待下线接口。
• 新增设置包年/包月资源自动续费 V2接口，设置包年/包月资源自动续费（已废弃） V1接口移至待下线接口。
• 新增取消包年/包月资源自动续费 V2接口，取消包年/包月资源自动续费（已废弃） V1接口移至待下线接口。

2020-06-30

第七次正式发布。

本次变更说明如下：

• 新增查询订单列表 V2接口，查询订单列表（旧） V1接口移至待下线接口。
• 新增查询订单详情 V2接口，查询订单详情（旧） V1接口移至待下线接口。
• 新增支付包年/包月产品订单 V2接口，支付包年/包月产品订单（旧） V1接口移至待下线接口。
• 新增取消待支付订单 V2接口，取消待支付订单 V1接口移至待下线接口。
• 新增续订包年/包月资源 V2接口，续订包年/包月资源（旧） V1接口移至待下线接口。
• 新增退订包年/包月资源 V2接口，退订包年/包月资源（旧） V1接口移至待下线接口。

2020-06-17

第六次正式发布。

本次变更说明如下：

• 上线查询资源消费记录 V2接口，下线查询资源消费记录（旧）接口。
• 上线查询资源详单 V2接口，下线查询资源详单（旧）接口。

2020-04-22

第五次正式发布。

本次变更说明如下：

新增查询按需产品价格和查询包年/包月产品价格接口。

2020-03-25

第四次正式发布。

本次变更说明如下：

新增查询套餐内使用量。

2020-01-17

第三次正式发布。

本次变更说明如下：

新增查询发票列表。

2020-01-15

第二次正式发布。

本次变更说明如下：

查询汇总账单的响应参数新增total_amount、debt_amount、coupon_amount、cashcoupon_amount、storedcard_amount、debit_amount、credit_amount、measure_id。

2019-12-25

第一次正式发布。

2019-09-17