文档修订记录

第一百三十九次正式发布。

本次变更说明如下：

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

2024-11-21

第一百三十八次正式发布。

本次变更说明如下：

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

2024-10-24

第一百三十七次正式发布。

本次变更说明如下：

• 查询资源详单V2接口请求参数statistic_type增加枚举值请求参数statistic_type增加枚举值3：按明细；新增响应参数effective_time和expire_time；请求参数query_type描述变更：仅当statistic_type=2或3时，支持传递query_type=DAILY。
• 查询订单可用优惠券 响应参数used_by_order_id新增说明：该字段只有在订单占用折扣券的时候才有值。

2024-9-24

第一百三十六次正式发布。

本次变更说明如下：

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

2024-8-22

第一百三十五次正式发布。

本次变更说明如下：

创建企业子账号V2接口新增接口约束说明：合作伙伴销售平台创建客户的页面必须体现华为云用户协议和隐私政策声明。

2024-7-25

第一百三十四次正式发布。

本次变更说明如下：

• 查询成本数据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-27

第一百三十三次正式发布。

本次变更说明如下：

华为云从2024/06/01（北京时间）起，根据华为云用户协议对账单账期归属计算规则进行优化。优化后客户获取的账期将与消费时间关联。

具体规则参见：费用中心5月最新动态（4-账单账期归属计算规则优化调整）

2024-5-30

第一百三十二次正式发布。

本次变更说明如下：

• 查询包年/包月资源的续订金额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 ：统计类型。

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

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

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

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

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

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

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

2024-5-23

第一百三十一次正式发布。

本次变更说明如下：

• 退订包年/包月资源 V2接口删除错误码“ CBC.99003645-该类型的云服务不支持退订。"
• 续订包年/包月资源 V2接口删除错误码 “CBC.99003631-退订中/删除中/释放中的资源不能续费。”
• 查询按需产品价格 V2接口删除错误码 "CBC.99006073项目不存在。"
• 查询订单列表 V2 & V1接口订单创建时间和订单支付时间修改：开始与结束时间间隔不能超过1年。
• 查询月度成本 V2接口 新增错误码：“CBC.18000048 -您名下的财务独立子，超过系统可支持查询的数量，请指定企业子账号查询。”说明：企业主调用查询所有企业子时，最大支持1000个财务独立企业子数量查询，超出需要指定企业子账号查询。
• 查询成本数据 V4 接口 新增错误码：“CBC.18000048 -您名下的财务独立子，超过系统可支持查询的数量，请指定企业子账号查询。”

2024-4-25

第一百三十次正式发布。

本次变更说明如下：

• 企业主账号向企业子账号拨款V2&V1接口新增检查项：

PRI_PAID_BP_SUB_CUST_NOT_TRANS_DEBIT —— 企业主账号是分销商代售模式的子客户，不允许给子账号划拨余额。

PRI_RESALE_BP_SUB_CUST_NOT_TRANS_DEBIT —— 企业主账号是分销商转售模式的子客户，不允许给子账号划拨余额。

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

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

2024-3-28

第一百二十九次正式发布。

本次变更说明如下：

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

2024-2-23

第一百二十八次正式发布。

本次变更说明如下：

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

2024-1-25

第一百二十七次正式发布。

• 创建企业子账号V2接口企业主账号创建企业子账号新增检查项“MAX_SUB_INDEPENDENT_NUM -超过最大财务独立子账号数量。”
• 支付包年/包月产品订单（旧）v1接口下线。

2023-12-22

第一百二十六次正式发布。

本次变更说明:

• 发送短信验证码接口新增错误码“CBC.70300009 ：财务托管企业子不能发送短信验证码 ”。

2023-11-24

第一百二十五次正式发布。

本次变更说明：

• 创建企业子账号接口新增返回错误码“CBC.70900002-您的账号需要通过华为云HIS平台创建企业子账号”。
• 查询企业子账号列表接口 sub_customer_display_name字段增加资料说明：“如果包含中文或者特殊字符，请使用encodeURIComponent进行编码处理。”

2023-11-09

第一百二十四次正式发布。

本次变更说明：

• 查询邮寄地址v2接口下线。
• 新增邮寄地址v2接口下线。
• 修改邮寄地址v2接口下线。
• 删除邮寄地址v2接口下线。

2023-10-27

第一百二十三次正式发布。

本次变更说明如下：

管理配置信息>管理邮寄地址移至：待下线接口。

2023-10-12

第八十一次正式发布。

本次变更说明如下：

企业主账号从企业子账号回收优惠券接口新增错误码“CBC.99000087：抱歉，当前操作出现异常，请稍后再试。”

支付包年/包月产品订单接口新增错误码“CBC.99000088：抱歉，支付处理中，请勿重复操作。”

2023-06-26

第八十次正式发布。

本次变更说明如下：

• 新增查询企业主账号可拨款优惠券列表接口，企业主账号在自建平台查询自己的可拨款优惠券列表。
• 新增查询企业子账号可回收优惠券列表接口，企业主账号在自建平台查询企业子账号的可回收优惠券。
• 新增企业主账号向企业子账号拨款优惠券接口，企业主账号在自建平台向企业子账号拨款优惠券。。
• 新增企业主账号从企业子账号回收优惠券接口，企业主账号在自建平台回收给企业子账号的拨款优惠券。

2023-5-25

第七十九次正式发布。

本次变更说明如下：

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

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

2023-4-13

第七十八次正式发布。

本次变更说明如下：

• 查询95计费资源用量汇总和查询95计费资源用量明细接口的查询参数service_type_code新增枚举值“hws.service.type.iec：智能边缘云”、查询参数resource_type_code新增枚举值“hws.resource.type.edgebandwidth：边缘固定带宽”和查询参数usage_type新增枚举值“95peak_plus：增强型95峰值”。
• 创建企业子账号接口新增错误码“CBC.99007490：您的账号关联的是退出中的云经销商，禁止创建企业子。”
• 新增查询包年/包月资源的续订金额接口，客户可以按照条件查询包年/包月资源续订时候的续订金额。

2023-3-23

第七十七次正式发布。

本次变更说明如下：

查询95计费资源用量汇总和查询95计费资源用量明细接口的查询参数service_type_code新增枚举值“hws.service.type.vpc：虚拟私有云”和查询参数resource_type_code新增枚举值“hws.resource.type.bandwidth：固定带宽”

2023-3-9

第七十六次正式发布。

本次变更说明如下：

新增查询收支明细接口，客户可以查询自身的收支明细情况。

2023-2-23

第七十五次正式发布。

本次变更说明如下：

• 续订包年/包月资源和退订包年/包月资源接口新增响应参数“fail_resource_infos”，用于查询失败的资源信息。
• 开通客户企业项目权限v1接口下线。

2023-1-31

第七十四次正式发布。

本次变更说明如下：

• 修改企业主账号向企业子账号拨款接口新增企业主账号向子账号拨款或回收检查项。
• 修改企业主账号从企业子账号回收拨款接口新增企业主账号向子账号拨款或回收检查项。

2023-1-5

第七十三次正式发布。

本次变更说明如下：

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

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

2022-12-26

第七十二次正式发布。

本次变更说明如下：

查询资源消费记录接口新增返回响应参数“formula”。

2022-11-29

第七十一次正式发布。

本次变更说明如下：

• 查询成本数据接口修改请求参数“groupby”的取值范围为：“最大个数：2”。
• 查询月度成本接口新增返回响应参数："sub_service_type_code"、"sub_service_type_name"、"sub_resource_type_code"、"sub_resource_type_name"、"sub_resource_id"和"sub_resource_name"。

2022-11-24

第七十次正式发布。

本次变更说明如下：

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

2022-11-15

第六十九次正式发布。

本次变更说明如下：

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

2022-09-27

第六十八次正式发布。

本次变更说明如下：

下线“查询邮寄地址”V1接口。

2022-09-22

第六十七次正式发布。

本次变更说明如下：

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

2022-09-08

第六十六次正式发布。

本次变更说明如下：

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

2022-08-25

第六十五次正式发布。

本次变更说明如下：

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

2022-08-11

第六十四次正式发布。

本次变更说明如下：

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

2022-08-10

第六十三次正式发布。

本次变更说明如下：

创建企业子账号V2接口请求参数“password”的取值范围修改为：“长度[8-32]”。

2022-07-28

第六十二次正式发布。

本次变更说明如下：

• 查询月度成本接口新增返回响应参数“effective_tag_pairs”和“cost_unit_pairs”，用于支持查询成本单元和成本标签。
• 退订包年/包月资源接口新增返回错误码“CBC.30010035”。

2022-07-14

第六十一次正式发布。

本次变更说明如下：

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

2022-06-30

第六十次正式发布。

本次变更说明如下：

• 查询资源详单接口新增返回响应参数“period_type”，用于支持查看资源的详细周期类型。
• 查询流水账单接口请求参数新增“bill_date_begin”和“bill_date_end”，用于支持查询按天统计的流水账单。
• 新增查询储值卡列表接口，调用该接口可查询已购买的储值卡列表。
• 新增查询云服务类型列表接口，查询云服务类型列表（旧）接口移至待下线接口。
• 新增查询资源类型列表接口，查询资源类型列表（旧）接口移至待下线接口。
• 查询使用量类型列表、支付包年/包月产品订单、查询退款订单的金额详情、查询客户包年/包月资源列表、查询汇总账单、查询流水账单、查询月度成本接口新增返回响应参数“service_type_name”和“resource_type_name”，用于返回云服务类型名称和资源类型名称。
• 查询资源详单、查询资源消费记录接口新增返回响应参数“cloud_service_type_name”和“resource_type_name”，用于返回云服务类型名称和资源类型名称。
• 查询订单详情、查询资源包列表接口新增返回响应参数“service_type_name”，用于返回云服务类型名称。
• 下线“回收优惠券V1”、“查询订单可用优惠券”、“查询企业组织结构（旧）”和“创建企业子账号（旧）”接口。

2022-04-07

第五十九次正式发布。

本次变更说明如下：

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

2022-03-25

第五十八次正式发布。

本次变更说明如下：

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

2022-03-10

第五十七次正式发布。

本次变更说明如下：

• 查询资源详单接口参数“bill_type”新增枚举值“18：消费-按月付费”和“20：退款-变更”。
• 查询流水账单接口参数“bill_type”新增枚举值“18：消费-按月付费”和“20：退款-变更”。
• 查询月度成本接口参数“bill_type”新增枚举值“18：消费-按月付费”和“20：退款-变更”。
• 查询包年/包月产品价格接口请求参数新增“fee_installment_mode”，同步新增返回对应的响应参数。

2022-02-10

第五十六次正式发布。

本次变更说明如下：

• 续订包年/包月资源接口新增返回错误码“CBC.30010036”。
• 设置包年/包月资源自动续费接口新增返回错误码“CBC.99003602”。
• 企业主账号向企业子账号拨款接口新增业务规则检查项“SUB_CUSTOMER_OVERDUE_BILL”。
• 企业主账号向企业子账号拨款（旧）接口新增业务规则检查项“SUB_CUSTOMER_OVERDUE_BILL”。
• 查询资源消费记录（旧）接口响应参数“feeSourceOperation”新增枚举值“19：变更-增配”和“20：变更-减配”。

2022-01-25

第五十五次正式发布。

本次变更说明如下：

• 查询订单可用优惠券V2接口新增返回响应参数“coupon_max_use_quantity”和“coupon_group”，用于返回优惠券的最大数量，包含优惠券类型、优惠券分组和优惠券使用数量。
• 查询订单可用优惠券V1接口新增返回响应参数“coupon_max_use_quantity”和“coupon_group”，用于返回优惠券的最大数量，包含优惠券类型、优惠券分组和优惠券使用数量。
• 查询包年/包月产品价格接口新增返回错误码“CBC.0250”。
• 续订包年/包月资源接口新增返回错误码“CBC.30050006”。
• 支付包年/包月产品订单V2接口新增返回错误码“CBC.99003115”。
• 支付包年/包月产品订单V2接口新增返回错误码“CBC.99003156”。
• 支付包年/包月产品订单V1接口新增返回错误码“CBC.99003156”。
• 新增查询月度成本接口，调用该接口可查询指定月份的月度摊销成本。

2022-01-10

第五十四次正式发布。

本次变更说明如下：

• 企业主账号向企业子账号拨款接口新增错误码“CBC.99007461”。
• 企业主账号从企业子账号回收拨款接口新增错误码“CBC.99007461”。
• 企业主账号向企业子账号拨款（旧）接口新增错误码“CBC.99007461”。
• 企业主账号从企业子账号回收拨款（旧）接口新增错误码“CBC.99007461”。

2021-12-25

第五十三次正式发布。

本次变更说明如下：

• 创建企业子账号接口新增错误码“CBC.99000051”。
• 创建企业子账号（旧）接口新增错误码“CBC.99000051”。
• 下线“查询硬件库存”接口。

2021-12-10

第五十二次正式发布。

本次变更说明如下：

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

2021-11-25

第五十一次正式发布。

本次变更说明如下：

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

2021-10-25

第五十次正式发布。

本次变更说明如下：

查询硬件库存移至待下线接口。

2021-10-14

第四十九次正式发布。

本次变更说明如下：

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

2021-09-26

第四十八次正式发布。

本次变更说明如下：

• 新增查询资源用量汇总接口，调用该接口可查询客户的资源使用量汇总。

2021-09-09

第四十七次正式发布。

本次变更说明如下：

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

2021-08-26

第四十六次正式发布。

本次变更说明如下：

• 查询套餐内使用量（旧）移至待下线接口。
• 下线“查询月度成本”接口。

2021-08-10

第四十五次正式发布。

本次变更说明如下：

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

2021-07-08

第四十四次正式发布。

本次变更说明如下：

下线“退订开通或变更失败的包年/包月产品”接口。

2021-07-06

第四十三次正式发布。

本次变更说明如下：

查询企业主账号可拨款余额（旧）接口新增错误码“CBC.99005003”。

2021-06-24

第四十二次正式发布。

本次变更说明如下：

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

2021-06-10

第四十一次正式发布。

本次变更说明如下：

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

2021-04-23

第四十次正式发布。

本次变更说明如下：

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

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

2021-01-08

第三十九次正式发布。

本次变更说明如下：

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

• 修改“查询资源消费记录” V2接口：查询参数charge_mode由必选改为可选。

2020-12-25

第三十八次正式发布。

本次变更说明如下：

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

2020-12-11

第三十七次正式发布。

本次变更说明如下：

• 新增查询使用量类型列表接口，用于查询使用量类型。
• 新增设置或取消包年/包月资源到期转按需接口，用于查询资源类型。
• 查询订单列表、查询订单详情接口及待下线接口中查询订单列表（旧）、查询订单详情（旧）和查询汇总账单（旧）接口的响应参数“discount_type”新增枚举值“610：免单金额”。
• 企业主账号向企业子账号拨款接口中，表1新增检查项“ADVANCE _PAY_PRI_SUB_MUST_SAME_LEGAL”，表示伙伴代售场景下，仅允许企业客户将代售资金划拨给相同法人的子账号。

2020-11-13

第三十六次正式发布。

本次变更说明如下：

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

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

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

2020-10-30

第三十五次正式发布。

本次变更说明如下：

• 新增查询流水账单接口。
• 新增查询企业组织结构 V2接口，查询企业组织结构（旧） V1接口移至待下线接口。
• 新增查询企业子账号列表 V2接口，查询企业子账号列表（旧） V1接口移至待下线接口。
• 查询订单的资源开通详情（旧）移至待下线接口。
• 查询资源消费记录接口新增请求及响应参数“trade_id”，用以标识交易ID或订单ID。

2020-10-16

第三十四次正式发布。

本次变更说明如下：

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

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

2020-09-25

第三十三次正式发布。

本次变更说明如下：

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

2020-09-11

第三十二次正式发布。

本次变更说明如下：

• 新增开通客户企业项目权限 V2接口，开通客户企业项目权限 V1接口移至待下线接口。
• 新增查询企业主账号可拨款余额 V2接口，查询企业主账号可拨款余额（旧） V1接口移至待下线接口。
• 新增查询企业子账号可回收余额 V2接口，查询企业子账号可回收余额（旧） V1接口移至待下线接口。
• 新增查询邮寄地址 V2接口，查询邮寄地址（已废弃） V1接口移至待下线接口。
• 修改查询资源消费记录接口，响应消息中表3新增参数“enterprise_project_name”和“product_spec_desc”。
• 查询按需产品价格和查询包年/包月产品价格接口新增错误码CBC.99006006、CBC.99006055、CBC.99006074。

2020-08-28

第三十一次正式发布。

本次变更说明如下：

• 新增查询账户余额 V2接口，查询账户余额（旧） V1接口移至待下线接口。
• 新增查询汇总账单 V2接口，查询汇总账单（旧） V1接口移至待下线接口。

2020-08-07

第三十次正式发布。

本次变更说明如下：

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

2020-06-23

第二十九次正式发布。

本次变更说明如下：

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

2020-06-12

第二十八次正式发布。

本次变更说明如下：

• 新增企业主账号向企业子账号拨款 V2接口，企业主账号向企业子账号拨款（旧） V1接口移至待下线接口。
• 新增企业主账号从企业子账号回收拨款 V2接口，企业主账号从企业子账号回收拨款（旧） V1接口移至待下线接口。

2020-06-03

第二十七次正式发布。

本次变更说明如下：

术语“包周期”修改为“包年/包月”。

2020-05-15

第二十六次正式发布。

本次变更说明如下：

新增查询资源消费记录 V2接口，查询资源消费记录（旧） V1接口移至待下线接口。

2020-04-17

第二十五次正式发布。

本次变更说明如下：

修改管理优惠券中的查询优惠券列表接口。

2020-04-10

第二十四次正式发布。

本次变更说明如下：

• 新增查询国家省市信息。
• 修改管理企业多账号，新增发送短信验证码，上线创建企业子账号v2接口。

2020-03-27

第二十三次正式发布。

本次变更说明如下：

• 新增查询硬件库存。
• 新增查询按需产品价格和查询包年/包月产品价格接口。
• 根据产品规格查询价格（旧） V1接口移至待下线接口。

2020-03-20

第二十二次正式发布。

本次变更说明如下：

• 修改管理配置信息，增加新增邮寄地址、修改邮寄地址和删除邮寄地址接口。
• 新增API调用方式章节。

2020-03-13

第二十一次正式发布。

本次变更说明如下：

新增查询资源详单 V2接口，查询资源详单（旧） V1接口移至待下线接口。

2020-02-28

第二十次正式发布。

本次变更说明如下：

新增查询套餐内使用量（旧）。

2020-01-17

第十九次正式发布。

本次变更说明如下：

新增管理配置信息。

2020-01-10

第十八次正式发布。

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

2019-12-20

第十七次正式发布。

本次变更说明如下：

续订包年/包月资源新增错误码“CBC.3016”，该错误码表示存在过期资源。

2019-11-15

第十六次正式发布。

本次变更说明如下：

• 新增查询订单列表。
• 新增查询订单详情。

2019-09-12

第十五次正式发布。

本次变更说明如下：

新增查询资源消费记录（旧）。

2019-08-30

第十四次正式发布。

本次变更说明如下：

客户运营能力API简介按照不同场景进行调整，并将各个API接口调整至不同场景章节中。

2019-08-23

第十三次正式发布。

本次变更说明如下：

• 查询账户余额接口新增“debtAmount”、“measureId”、“currency”三个响应参数；当账户欠费时，响应消息返回欠费的金额。
• 企业主账号向企业子账号拨款（旧）新增“CBC.7001”错误码。

2019-07-26

第十二次正式发布。

本次变更说明如下：

新增查询资源详单（旧）。

2019-07-19

第十一次正式发布。

本次变更说明如下：

新增开通客户企业项目权限。

2019-05-24

第十次正式发布。

本次变更说明如下：

创建企业子账号的请求参数新增“usePriMobilePhone”和“password”两个参数，另“email”、“mobilePhone”、“countryCode”三个参数变为可选。

2019-03-27

第九次正式发布。

本次变更说明如下：

更新云服务类型和资源类型。

2019-03-21

第八次正式发布。

本次变更说明如下：

• 新增查询企业组织结构
• 新增创建企业子账号

2019-02-27

第七次正式发布。

本次变更说明如下：

• 新增查询企业子账号列表
• 新增查询企业主账号可拨款余额
• 新增查询企业子账号可回收余额
• 新增企业主账号向企业子账号拨款（旧）
• 新增企业主账号从企业子账号回收拨款（旧）

2019-01-11

第六次正式发布。

本次变更说明如下：

• 将原“接口使用方法”章节标题改为“接口调用方法”。
• 将原“接口使用方法 > 获取请求认证”章节内容合并，调整到“接口调用方法”章节前面。
• 将原“接口使用方法”章节下“使用方法”、“接口调用流程”、“构造请求方法”、“发起请求”、“解析响应消息”小节的内容以及原“公共参数”章节的内容合并到“REST API介绍”并做了部分优化。
• 将原“接口使用方法 > 状态码”小节调整到“附录 > 状态码”中。
• 新增“接口调用方法 > 示例”。

2018-12-07

第五次正式发布。

本次变更说明如下：

• 查询客户月度消费账单的请求参数和响应参数中分别增加“enterpriseProjectId”参数，响应参数“account_details”中的“balance_type_id”增加账户类型“BALANCE_TYPE_STORED_VALUE_CARD：储值卡消费”。

2018-11-16

第四次正式发布。

本次变更说明如下：

• 续订包年/包月资源的请求参数新增“isAutoPay”参数，表示是否设置自动支付。
• 查询客户月度消费账单的功能介绍中增加请求参数是否传递“cloud_service_type_code”的两种场景说明。

2018-10-23

第三次正式发布。

本次变更说明如下：

新增查询订单的资源开通详情

2018-09-30

第二次正式发布。

本次变更说明如下：

• 新增Token认证的说明。
• 新增查询订单可用优惠券
• 新增支付包年/包月产品订单
• 新增退订开通或变更失败的包年/包月产品
• 新增查询客户包年/包月资源列表
• 新增续订包年/包月资源
• 新增退订包年/包月资源
• 新增设置包年/包月资源自动续费
• 新增取消包年/包月资源自动续费

2018-07-25

第一次正式发布。

• 新增查询账户余额
• 新增查询客户月度消费账单
• 新增根据产品规格查询价格

2018-05-25