文档修订记录

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

本次变更说明如下：

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

2024-11-21

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

本次变更说明如下：

• 查询优惠券列表查询参数status删除枚举值：未激活；查询参数status删除说明：已使用、已过期和已回收优惠券，只返回12个月以内的数据；新增说明：不返回已失效超一年时间的代金券/折扣券信息。当券的失效时间小于当前时间时，券将不再有效，此时券的状态称之为已失效。

• 查询已发放的优惠券删除说明：只可查到失效时间在12个月内的代金/折扣劵；新增说明：不返回已失效超两年时间（含当天）的代金券/折扣券信息。当券的失效时间小于当前时间时，券将不再有效，此时券的状态称之为已失效。
• 申请个人实名认证、申请企业实名认证和申请实名认证变更新增错误码CBC.99000099：客户实名认证时证件附件的文件大小超过最大配置值；CBC.99000100：客户实名认证时证件附件的文件格式不正确。
• 查询订单列表新增响应字段enterprise_projects：客户订单企业项目详情信息。

2024-10-24

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

本次变更说明如下：

创建客户不再支持为客户创建委托授权。

2024-10-14

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

本次变更说明如下：

查询订单可用优惠券 响应参数used_by_order_id新增说明：该字段只有在订单占用折扣券的时候才有值。

2024-9-24

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

本次变更说明如下：

• 发放优惠券V2接口新增错误码CBC.50000054 产品不存在。CBC.50000055 云服务类型不存在。
• 向客户账户拨款（旧）下线。

2024-8-22

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

本次变更说明如下：

• 退订包年/包月资源V2&V1接口删除错误码CBC.30010035：资源已被删除；新增错误码CBC.30000067：资源已被删除或者资源未被纳管，不支持退订。
• 查询按需产品价格V2接口新增说明：如果只是临时查询产品价格，可以到价格计算器查询。询价Api入参参数product_infos取值可以参考价格计算器查询入参，详情见按需询价示例。
• 查询包年/包月产品价格V2接口新增说明：如果只是临时查询产品价格，可以到价格计算器查询。询价Api入参参数product_infos取值可以参考价格计算器查询入参，详情见包周期询价示例。
• 查询优惠券列表V2接口请求参数status增加枚举值5：已回收。
• 查询客户包年/包月资源列表V2接口请求参数status_list增加枚举值3：已关闭。
• 查询客户月度消费账单 V1接口下线。
• 校验客户注册信息（旧）V1接口下线。

2024-6-27

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

本次变更说明如下：

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

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

2024-5-30

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

• 查询包年/包月资源的续订金额V2接口新增请求参数include_relative_resources ： 是否包含关联资源一起续费询价。响应RenewInquiryResultInfo.resource_id增加说明：请求携带“include_relative_resources”字段，会返回关联资源的主资源ID。

  响应RenewInquiryResultInfo.amount增加说明：请求携带“include_relative_resources”字段，会返回关联资源的主资源的续订金额。

• 查询客户包年/包月资源列表V2接口新增请求参数service_type_code：云服务类型编码。
• 续订包年/包月资源V2接口新增错误码CBC.30010069 ：不存在的续费周期。
• 续订包年/包月资源V1接口新增错误码CBC.99003154：资源已购买时长加本次续费时长后已超过最大值，请重新选择续费时长。
• 查询资源包列表V3接口新增请求参数service_type_code_list：云服务类型编码列表，大小写不敏感。

2024-5-23

第一百三十次正式发布。

本次变更说明如下：

• 查询调账记录 V2接口下线
• 查询优惠券的发放回收记录 V1接口下线
• 创建客户（旧）V1接口下线
• 查询客户消费记录（旧）V1接口下线
• 退订包年/包月资源 V2接口删除错误码“CBC.99003645-该类型的云服务不支持退订。”
• 续订包年/包月资源 V2接口删除错误码 “CBC.99003631-退订中/删除中/释放中的资源不能续费。”
• 查询按需产品价格 V2接口删除错误码 "CBC.99006073项目不存在。"
• 查询订单列表 V2 & V1接口订单创建时间和订单支付时间修改：开始与结束时间间隔不能超过1年。
• 查询伙伴子客户消费记录 V2接口新增说明：如您的顾问销售子客户同时是财务托管模式企业子账号，解绑前当月账期消费数据体现在企业子账号，解绑后当月消费数据体现在企业主账号。详情请见“如何查询财务托管模式企业子账号解绑当月账期的消费数据”

2024-4-25

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

本次变更说明如下：

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

2024-2-23

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

本次变更说明如下：

• 续订包年/包月资源 V2接口新增错误码“CBC.99000092 - 订购周期校验失败。”
• 取消待支付订单V1接口下线。
• 查询客户账户余额 V1接口下线。
• 查询客户月度消费账单（旧）V1接口下线。

2024-1-25

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

• 支付包年/包月产品订单（旧）v1接口下线。
• 查询退款订单的金额详情 v1接口下线。
• 发送验证码（旧）v1接口下线。
• 查询客户调账记录（旧）v1接口下线。
• 查询客户按需资源列表v1接口下线。

2023-12-22

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

• 查询客户消费记录（旧）V1接口新增说明：” 此接口只能查询伙伴子自己的消费记录，无法查询其下财82010002务托管子账号（包含资源账号或云账号）的消费记录。如果需要查询，请切换到相应接口查询伙伴子客户消费记录。“
• 查询客户月度消费账单（旧）V1接口新增说明：” 此接口只能查询伙伴子自己的月度消费账单，无法查询其名下财务托管子账号（包含资源账号或云账号）的月度消费账单。如果需要查询，请切换到相应接口查询客户月度消费账单。“
• 向云经销商发放代金券额度 V2接口新增错误码“CBC.50000045 -不能对同一个代金券额度进行频繁操作。上一次的代金券额度划拨正在进行中，不允许并行划拨，待结束后再进行下一次操作。”

2023-12-13

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

本次变更说明：

API调用授权（伙伴） 章节已新增权限项列。

2023-11-10

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

本次变更说明如下：

• 查询邮寄地址v2接口下线。
• 新增邮寄地址v2接口下线。
• 修改邮寄地址v2接口下线。
• 删除邮寄地址v2接口下线。
• 回收客户账户余额v1接口下线。
• 查询优惠券列表v1接口下线。
• 查询订单列表（旧）v1接口下线。
• 查询已发放的优惠券v1接口下线。

2023-10-27

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

本次变更说明如下：

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

2023-10-12

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

本次变更说明如下：

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

2023-06-26

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

本次变更说明如下：

• 回收客户账户余额接口新增错误码“CBC.0160：请求的资源没有找到”。

2023-05-25

第一百二十次正式发布。

本次变更说明如下：

• 查询包年/包月资源的续订金额接口新增错误码“CBC.30050013：该产品不支持续费”。
• 同步客户实名认证信息v1接口下线。
• 查询优惠券额度v1接口下线。

2023-04-13

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

本次变更说明如下：

新增API调用授权（伙伴）的章节，伙伴操作员账号调用API需要经过授权，可通过伙伴中心对操作员赋予有权限项的角色来进行授权。

2023-04-07

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

本次变更说明如下：

• 新增查询包年/包月资源的续订金额接口，客户可以按照条件查询包年/包月资源续订时候的续订金额。
• 向云经销商发放代金券额度接口新增错误码“CBC.50010105：无法给退出中的云经销商发放代金券额度”。

2023-03-23

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

本次变更说明如下：

删除申请个人实名认证接口的“verified_type”字段的枚举值7：海外驾照。

2023-02-23

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

本次变更说明如下：

• 续订包年/包月资源和退订包年/包月资源接口新增响应参数“fail_resource_infos”，用于查询失败的资源信息。
• 发放优惠券v1接口和设置伙伴折扣v1接口下线。

2023-01-31

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

本次变更说明如下：

发放优惠卷接口新增返回错误码“CBC.50000034-无法给财务托管企业子发券”。

2022-12-26

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

本次变更说明如下：

• 创建客户V2接口和创建客户V1接口新增返回错误码“CBC.50010085-该伙伴企业目前处于受限状态，无法拓客创建关联关系。”和“CBC.50010086-该伙伴是云经销商，其关联的总经销商企业目前处于受限状态，无法拓客创建关联关系。”。
• 申请个人实名认证、申请企业实名认证和申请实名认证变更接口新增返回错误码“CBC.70600026-抱歉，华为云暂无法审核您提交的实名认证信息，请联系您的客户经理协助。”。

2022-12-08

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

本次变更说明如下：

• 查询伙伴子客户消费记录接口新增返回响应参数："sub_service_type_code"、"sub_service_type_name"、"sub_resource_type_code"、"sub_resource_type_name"、"sub_resource_id"和"sub_resource_name"。
• 查询客户消费记录接口新增返回响应参数："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

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

本次变更说明如下：

• 生成订单号V1接口下线；
• 设置自动续费V1接口下线；
• 取消自动续费V1接口下线。

2022-10-28

第一百一十次正式发布。

本次变更说明如下：

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

2022-09-27

第一百零九次正式发布。

本次变更说明如下：

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

2022-09-22

第一百零八次正式发布。

本次变更说明如下：

• 创建客户V1接口新增返回错误码“CBC.50010065”。
• 创建客户V2接口新增返回错误码“CBC.50010065”。

2022-08-25

第一百零七次正式发布。

本次变更说明如下：

修改“伙伴能力中心”为“总经销商”；修改“精英服务商”为“云经销商”；修改“经销商伙伴”为“解决方案提供商”；修改“云市场”为“云商店”。

2022-08-10

第一百零六次正式发布。

本次变更说明如下：

• 创建客户V1接口请求参数“password”的取值范围修改为：“长度[8-32]”。
• 创建客户V2接口请求参数“password”的取值范围修改为：“长度[8-32]”。

2022-07-28

第一百零五次正式发布。

本次变更说明如下：

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

2022-07-14

第一百零四次正式发布。

本次变更说明如下：

下线“设置伙伴折扣”、“查询伙伴折扣”、“设置伙伴折扣（旧）”和“查询伙伴折扣（旧）”接口。

2022-07-08

第一百零三次正式发布。

本次变更说明如下：

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

2022-06-30

第一百零二次正式发布。

本次变更说明如下：

查询客户列表接口响应参数“is_frozen”新增枚举值“2：客户账号和资源冻结”，枚举值“1：是”修改为“1：客户账号冻结”。

2022-06-21

第一百零一次正式发布。

本次变更说明如下：

新增查询伙伴消费子客户列表接口，调用该接口可查询消费账期内的子客户列表。

2022-04-21

第一百次正式发布。

本次变更说明如下：

• 新增查询云服务类型列表接口，查询云服务类型列表（旧）接口移至待下线接口。
• 新增查询资源类型列表接口，查询资源类型列表（旧）接口移至待下线接口。
• 查询使用量类型列表、支付包年/包月产品订单、查询退款订单的金额详情、查询客户包年/包月资源列表、查询客户按需资源列表、查询客户消费记录接口新增返回响应参数“service_type_name”和“resource_type_name”，用于返回云服务类型名称和资源类型名称。
• 查询客户月度消费账单接口新增返回响应参数“cloud_service_type_name”和“resource_type_name”，用于返回云服务类型名称和资源类型名称。
• 查询产品的折扣和激励策略、查询订单详情、查询资源包列表接口新增返回响应参数“service_type_name”，用于返回云服务类型名称。
• 下线“回收优惠券V1”和“查询订单可用优惠券”接口。

2022-04-07

第九十九次正式发布。

本次变更说明如下：

合作伙伴生态交易模式名称变更，“推荐”模式更名为“顾问销售”模式，“垫付”模式更名为“代售”模式。

2022-03-25

第九十八次正式发布。

本次变更说明如下：

• 查询精英服务商列表接口响应参数“account_manager_id”描述改为“客户经理登录账户名”。
• 取消包年/包月资源自动续费V2接口新增返回错误码“CBC.99003605”。
• 取消自动续费接口新增返回错误码“CBC.3605”。

2022-03-10

第九十七次正式发布。

本次变更说明如下：

• 查询客户按需资源列表接口请求参数“status”新增枚举值“2：宽限期”。
• 下线“查询订购关系列表”接口。

2022-02-25

第九十六次正式发布。

本次变更说明如下：

• 查询客户消费记录接口参数“bill_detail_type”新增枚举值“18：消费-按月付费”。
• 查询包年/包月产品价格接口请求参数新增“fee_installment_mode”，同步新增返回对应的响应参数。

2022-02-10

第九十五次正式发布。

本次变更说明如下：

• 续订包年/包月资源接口新增返回错误码“CBC.30010036”。
• 设置包年/包月资源自动续费接口新增返回错误码“CBC.99003602”。
• 查询客户消费记录接口参数“bill_detail_type”新增枚举值“20：退款-变更”。
• 附录新增如何订阅文件章节，伙伴可以在华为云伙伴中心订阅文件。

2022-01-25

第九十四次正式发布。

本次变更说明如下：

• 查询订单可用优惠券V2接口新增返回响应参数“coupon_max_use_quantity”和“coupon_group”，用于返回优惠券的最大数量，包含优惠券类型、优惠券分组和优惠券使用数量。
• 查询订单可用优惠券V1接口新增返回响应参数“coupon_max_use_quantity”和“coupon_group”，用于返回优惠券的最大数量，包含优惠券类型、优惠券分组和优惠券使用数量。
• 查询包年/包月产品价格接口新增返回错误码“CBC.0250”。
• 查询伙伴折扣接口新增返回错误码“CBC.0250”。
• 续订包年/包月资源接口新增返回错误码“CBC.30050006”。
• 支付包年/包月产品订单V2接口新增返回错误码“CBC.99003115”。
• 支付包年/包月产品订单V2接口新增返回错误码“CBC.99003156”。
• 支付包年/包月产品订单V1接口新增返回错误码“CBC.99003156”。
• 设置伙伴折扣移至待下线接口。
• 查询伙伴折扣移至待下线接口。
• 下线“查询订购关系列表（旧）”接口。

2022-01-10

第九十三次正式发布。

本次变更说明如下：

• 创建客户接口错误码“CBC.99000051”描述修改为“该手机号/邮箱已被华为报备，无法创建客户”。
• 创建客户（旧）接口新增错误码“CBC.99000051”。
• 下线“查询硬件库存”接口。

2021-12-10

第九十二次正式发布。

本次变更说明如下：

• 发放优惠券接口新增错误码“CBC.50000020”。
• 向精英服务商发放代金券额度接口新增错误码“CBC.50000021”。
• 续订包年/包月资源接口删除错误码“CBC.99003001”。

2021-11-25

第九十一次正式发布。

本次变更说明如下：

• 新增查询产品的折扣和激励策略接口，调用该接口可查询产品的折扣和激励策略。
• 新增查询收支明细接口，调用该接口可查询伙伴的收支明细情况。
• 申请个人实名认证接口错误码“CBC.99005030”描述修改为“伙伴未开通实名认证功能或者桶鉴权失败”。

2021-11-12

第九十次正式发布。

本次变更说明如下：

• 续订包年/包月资源接口错误码“CBC.99003016”描述修改为“资源已过期删除或不存在”。
• 查询精英服务商列表接口新增响应参数“account_manager_id”和“account_manager_name”，用于支持查询云经销商对应的客户经理信息。

2021-10-25

第八十九次正式发布。

本次变更说明如下：

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

2021-10-14

第八十八次正式发布。

本次变更说明如下：

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

2021-09-26

第八十七次正式发布。

本次变更说明如下：

• 新增查询客户消费记录接口，调用该接口可查询子客户的消费记录。
• 查询客户消费记录移至待下线接口。

2021-09-09

第八十六次正式发布。

本次变更说明如下：

支付包年/包月产品订单接口新增错误码“CBC.30000010”。

2021-08-26

第八十五次正式发布。

本次变更说明如下：

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

2021-07-08

第八十四次正式发布。

本次变更说明如下：

下线“申请个人实名认证（旧）”、“申请企业实名认证（旧）”、“申请实名认证变更（旧）”、“变更包年/包月产品规格”和“退订开通或变更失败的包年/包月产品”接口。

2021-07-06

第八十三次正式发布。

本次变更说明如下：

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

2021-06-10

第八十二次正式发布。

本次变更说明如下：

修改查询客户消费记录（旧）：

• 请求参数新增“bill_date_begin”和“bill_date_end”，支持伙伴按天查询客户的消费记录。
• 响应参数表2中“discount_amount”参数目前返回官网价和成交价的差值，“spec_size_measure_id”目前当参数“spec_size”返回为null时，该参数返回为null。

2021-05-14

第八十一次正式发布。

本次变更说明如下：

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

2021-04-23

第八十次正式发布。

本次变更说明如下：

创建客户接口新增错误码“CBC.99005035”。

2021-02-05

第七十九次正式发布。

本次变更说明如下：

修改查询客户列表响应参数新增“xaccount_id”和“xaccount_type”，用于返回伙伴销售平台的用户标识和合作伙伴销售平台的平台标识；新增“customer_level”，用于返回客户等级。

2021-01-22

第七十八次正式发布。

本次变更说明如下：

修改查询客户消费记录（旧）响应参数新增“region_name”，用于调用接口时响应消息中返回云服务区名称。

2021-01-08

第七十七次正式发布。

本次变更说明如下：

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

2020-12-25

第七十六次正式发布。

本次变更说明如下：

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

2020-12-11

第七十五次正式发布。

本次变更说明如下：

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

2020-11-13

第七十四次正式发布。

本次变更说明如下：

• 新增查询云服务类型列表（旧）接口，用于查询云服务类型。
• 新增查询资源类型列表（旧）接口，用于查询资源类型。
• 新增根据云服务类型查询资源列表接口，可以根据云服务类型查询对应的资源列表。
• 修改查询客户消费记录（旧）接口，响应参数增加“product_spec_desc”，用于返回产品规格描述。

2020-10-30

第七十三次正式发布。

本次变更说明如下：

• 创建客户接口新增请求参数“include_association_result”，调用时可返回子客户的关联结果。
• 查询订单的资源开通详情（旧）移至待下线接口。

2020-10-16

第七十二次正式发布。

本次变更说明如下：

查询客户按需资源列表接口新增查询参数表1，支持按语种查询；响应参数新增“product_spec_desc”，调用时可返回产品的规格描述。

2020-09-25

第七十一次正式发布。

本次变更说明如下：

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

2020-09-11

第七十次正式发布。

本次变更说明如下：

• 新增查询邮寄地址 V2接口，查询邮寄地址（已废弃） V1接口移至待下线接口。
• 查询按需产品价格和查询包年/包月产品价格接口新增错误码CBC.99006006、CBC.99006055、CBC.99006074。

2020-08-28

第六十九次正式发布。

本次变更说明如下：

• 管理云经销商新增回收云经销商账户拨款接口。
• 回收优惠券接口新增错误码“CBC.99000048 该券已经过期或者已经被回收。”

2020-07-24

第六十八次正式发布。

本次变更说明如下：

• 管理云经销商新增查询云经销商账户余额接口、向云经销商发放代金券额度接口、查询调账记录接口、回收云经销商的代金券额度接口、查询已发放的代金券额度接口、查询代金券额度的发放回收记录接口。
• 新增查询优惠券额度 V2接口，查询优惠券额度（已废弃） V1接口移至待下线接口；新增回收客户账户余额 V2接口，回收客户账户余额 V1接口移至待下线接口。
• 管理客户账户新增查询调账记录 V2接口，查询客户调账记录（旧） V1接口移至待下线接口。

2020-07-10

第六十七次正式发布。

本次变更说明如下：

• 新增回收优惠券 V2接口，回收优惠券 V1接口移至待下线接口。
• 新增查询已发放的优惠券 V2接口，查询已发放的优惠券 V1接口移至待下线接口。
• 新增查询优惠券的发放回收记录 V2接口，查询优惠券发放回收记录 V1接口移至待下线接口。
• 新增查询退款订单的金额详情 V2接口，查询退款订单的金额详情 V1接口移至待下线接口。
• 新增查询客户包年/包月资源列表 V2接口，查询客户包年/包月资源列表（旧） V1接口移至待下线接口。
• 新增设置包年/包月资源自动续费 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-05-29

第六十四次正式发布。

本次变更说明如下：

• 新增查询云经销商列表接口。
• 新增19.1.4.3.2-查询伙伴折扣 V2接口，查询伙伴折扣（旧）V1接口移至待下线接口。
• 新增查询客户消费记录（旧） V2接口，查询客户消费记录（旧） V1接口移至待下线接口。
• 新增查询客户月度消费账单 V2接口，查询客户月度消费账单（旧） V1接口移至待下线接口。

2020-05-25

第六十三次正式发布。

本次变更说明如下：

• 新增申请个人实名认证 V2接口，申请个人实名认证（旧） V1接口移至待下线接口。
• 新增申请企业实名认证 V2接口，申请企业实名认证（旧） V1接口移至待下线接口。
• 新增申请实名认证变更 V2接口，申请实名认证变更（旧） V1接口移至待下线接口。
• 新增查询实名认证审核结果 V2接口，查询实名认证审核结果（旧） V1接口移至待下线接口。
• 新增查询客户列表 V2接口，请求参数新增indirect_partner_id字段，响应参数新增account_managers，查询实名认证审核结果（旧） V1接口移至待下线接口。
• 术语“包周期”修改为“包年/包月”。

2020-05-15

第六十二次正式发布。

本次变更说明如下：

新增管理云经销商。

2020-04-24

第六十一次正式发布。

本次变更说明如下：

新增创建客户 V2接口，创建客户（旧） V1接口移至待下线接口。

2020-04-17

第六十次正式发布。

本次变更说明如下：

• 修改20.1.4.3-管理伙伴折扣中的19.1.4.3.1-设置伙伴折扣接口。
• 修改查询优惠券列表和发放优惠券接口。
• 修改管理客户账户中的查询伙伴账户余额、批量查询子客户账户余额和向客户账户拨款接口。

2020-04-10

第五十九次正式发布。

本次变更说明如下：

新增查询国家省市信息。

2020-03-27

第五十八次正式发布。

本次变更说明如下：

• 新增查询硬件库存。
• 新增查询按需产品价格和查询包年/包月产品价格接口。

2020-03-20

第五十七次正式发布。

本次变更说明如下：

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

2020-03-13

第五十六次正式发布。

本次变更说明如下：

新增管理配置信息。

2020-01-10

第五十五次正式发布。

本次变更说明如下：

创建客户（旧）请求参数新增cooperationType字段。

发送验证码（旧）的状态码修改CBC.4004和CBC.4005的描述。

2019-12-13

第五十四次正式发布。

本次变更说明如下：

申请企业实名认证（旧）和申请实名认证变更（旧）的响应参数的errorItems列表新增MILITARY_ENTERPRISE和ENTERPRISE_LOGOUT_REVOKE参数。

2019-11-22

第五十三次正式发布。

本次变更说明如下：

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

2019-11-15

第五十二次正式发布。

本次变更说明如下：

查询客户列表（旧）新增响应参数“isFrozen”，用来标识客户是否处于冻结状态。

2019-10-18

第五十一次正式发布。

本次变更说明如下：

• 校验客户注册信息（旧）新增响应参数“uplimit”，该参数用来标识发送验证码次数是否达到上限。
• 新增 申请实名认证变更（旧）。

2019-09-12

第五十次正式发布。

本次变更说明如下：

• 新增 申请个人实名认证（旧）。
• 新增 申请企业实名认证（旧）。
• 新增 查询实名认证审核结果（旧）。
• 同步客户实名认证信息（已废弃）接口移至待下线接口。

2019-09-02

第四十九次正式发布。

本次变更说明如下：

查询客户列表（旧）新增响应参数“customerType”，该参数用来标示客户类型。

2019-08-30

第四十八次正式发布。

本次变更说明如下：

• “发送注册验证码”接口名称变更为发送验证码（旧），且请求消息新增“scene”“customerId”两个参数。
• 合作伙伴运营能力API简介（代售交易模式）按照不同场景进行调整，并将各个API接口调整至不同场景章节中。

2019-08-23

第四十七次正式发布。

本次变更说明如下：

将查询订购关系列表、设置自动续费（已废弃）、取消自动续费（已废弃）接口移至待下线接口，对应的新接口请查看以上接口的详情页面。

2019-08-16

第四十六次正式发布。

本次变更说明如下：

新增查询订单的资源开通详情（旧）接口。

2019-08-09

第四十五次正式发布。

本次变更说明如下：

• 查询客户包年/包月资源列表新增“CBC.0100”错误码。
• 将查询客户列表（旧）接口移至待下线接口，对应的新接口请参见查询客户列表（旧）。

2019-07-19

第四十四次正式发布。

本次变更说明如下：

• 将20.1.4.5.1-生成订单号、20.1.4.6.8-订购包年/包月产品（已废弃）、查询客户月度消费账单（旧）、查询订单列表（旧）、查询订购关系列表（旧）接口移至待下线接口，对应的新接口请查看以上接口的详情页面。

2019-07-12

第四十三次正式发布。

本次变更说明如下：

• 查询订单详情的响应参数表5新增“categoryCode”参数。

2019-07-04

第四十二次正式发布。

本次变更说明如下：

• 查询订单列表：
  • 响应参数表2新增“currencyOfficial”，“amountInfo”，“serviceType”参数；
  • 响应参数新增表3和表4；
  • 状态码新增“CBC.0100”，“CBC.0101”，“CBC.0151”，“CBC.0155”。
• 查询订单详情：
  • 表1新增“offset”，“limit”参数；
  • 响应参数新增“count”，“orderlineItems”参数；
  • 响应参数表4新增“currencyOfficial”，“amountInfo”，“currencyType”，“serviceType”参数；
  • 响应参数新增表5，表7和表8。
  • 状态码新增“CBC.0100”，“CBC.0101”，“CBC.0151”，“CBC.0155”。

2019-06-21

第四十一次正式发布。

本次变更说明如下：

• 创建客户（旧）的请求参数新增“isCloseMarketMs”参数。

2019-06-14

第四十次正式发布。

本次变更说明如下：

• 根据产品规格查询价格（旧）的响应参数“productRatingResult”修改为“ratingResult”。
• 创建客户（旧）功能介绍的注意事项增加说明：合作伙伴调用该接口创建的客户为合作伙伴的代售类客户。
• “查询账户余额”的接口名称修改为查询伙伴账户余额，“批量查询客户账户余额”的接口名称修改为查询客户账户余额。
• 原“云服务”相关接口下线，云服务相关接口请参考华为云API。

2019-04-23

第三十九次正式发布。

本次变更说明如下：

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

2019-03-21

第三十八次正式发布。

本次变更说明如下：

创建客户（旧）的请求参数“mobilePhone”、“countryCode”、“verificationCode”变更为非必选请求参数；并增加“password”参数。

2019-03-13

第三十七次正式发布。

本次变更说明如下：

查询客户包年/包月资源列表的响应参数“ResourceInstance”表中“next_operation_policy”参数的类型修改为“Integer”。

2019-01-04

第三十六次正式发布。

本次变更说明如下：

• 9.1.1-创建云服务器的请求参数“nics字段数据结构说明”表格中增加参数“ipv6_enable”和“ipv6_bandwidth”。
• 9.1.7-变更包年/包月带宽的状态码“2xx”修改为“200”。

2018-12-28

第三十五次正式发布。

本次变更说明如下：

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

2018-12-07

第三十四次正式发布。

本次变更说明如下：

• 查询客户列表的请求参数新增“label”、“cooperationType”、“cooperationTimeStart”和“cooperationTimeEnd”参数，响应参数新增“label”、“telephone”、“verifiedStatus”和“countryCode”。
• 9.1.4-创建其他云服务新增RDS的“创建实例（v3）”API参考链接。

2018-11-27

第三十三次正式发布。

本次变更说明如下：

• 查询客户月度消费账单的响应参数“accountDetails”中的“balanceTypeId”增加账户类型“BALANCE_TYPE_STORED_VALUE_CARD：储值卡消费”。
• 9.1.1-创建云服务器的请求参数“创建云服务器的extendparam字段数据结构说明”表格中增加竞价实例参数“marketType”和“spotPrice”。

2018-11-16

第三十二次正式发布。

本次变更说明如下：

• 支付包年/包月产品订单的响应参数“quotaInfos”中的“authResult”增加资源规格发生变化时报错相关枚举值，新增错误码CBC.3162。
• 续订包年/包月资源新增错误码CBC.3638。
• 退订包年/包月资源新增错误码CBC.3640。

2018-11-01

第三十一次正式发布。

本次变更说明如下：

新增9.1.4-创建其他云服务。

2018-10-27

第三十次正式发布。

本次变更说明如下：

续订包年/包月资源的请求参数新增“isAutoPay”参数，表示是否设置自动支付。

2018-10-23

第二十九次正式发布。

本次变更说明如下：

• 将URI中的{customer_id}和{tenant_id}改成{domain_id}（“9-云服务”章节URI中的{tenant_id}除外），并优化描述。
• 设置自动续费的“功能介绍”中增加自动续费生效时间说明。
• 新增支付使用折扣或优惠券说明。

2018-09-26

第二十八次正式发布。

本次变更说明如下：

支付包年/包月产品订单的响应参数新增“enterpriseProjectAuthResult”参数。

2018-08-31

第二十七次正式发布。

本次变更说明如下：

新增管理工单。

2018-08-17

第二十六次正式发布。

本次变更说明如下：

• 支付包年/包月产品订单的响应参数“quotaInfos”增加容量不足时返回的参数“resourceSpecCode”和“availableZoneId”，同时“authResult”增加容量不足时的枚举值。
• 退订包年/包月资源支持5天无理由全额退订，修改“功能介绍”中的相关描述。

2018-08-10

第二十五次正式发布。

本次变更说明如下：

• 新增发送注册验证码。
• 新增创建客户。

2018-07-27

第二十四次正式发布。

本次变更说明如下：

查询客户包年/包月资源列表的响应参数中增加“next_operation_policy”参数。

2018-07-13

第二十三次正式发布。

本次变更说明如下：

• 9-云服务目录下所有接口的“功能介绍”中增加本接口与其他接口的配合说明。
• 部分参数描述优化。

2018-07-06

第二十二次正式发布。

本次变更说明如下：

• 查询订单列表和查询订单列表（旧）的请求参数中增加“payment_time_begin”和“payment_time_end”两个参数。
• 新增查询退款订单的金额详情。

2018-06-22

第二十一次正式发布。

本次变更说明如下：

• 9.1.1-创建云服务器中请求参数的内容更新如下：
  • 增加“server_tags”参数。
  • “eip字段数据结构说明”中增加“extendparam”参数。
  • “bandwidth字段数据结构说明”中增加“id”参数。
  • “创建磁盘的extendparam字段数据结构说明”中增加“snapshotId”参数。
  • 请求样例新增“创建包年包月的弹性云服务器和按需计费的弹性IP”和“创建包年包月的弹性云服务器和共享带宽的弹性IP”。
• 在查询订单列表、查询订单列表（旧）和查询订单详情的功能介绍中增加如果想查询某条订单下的资源信息，调用查询客户包年/包月资源列表的说明。
• 优化查询客户按需资源列表的请求示例和响应示例，请求示例中增加“resourceIds”参数示例。
• 优化查询客户包年/包月资源列表的请求参数“resource_ids”的描述以及请求示例和响应示例，请求示例中增加“resource_ids”参数示例。

2018-06-15

第二十次正式发布。

本次变更说明如下：

支付包年/包月产品订单的响应参数中增加“quotaInfos”字段。

2018-05-25

第十九次正式发布。

本次变更说明如下：

• 向客户账户拨款和回收客户账户余额的响应参数中增加“trans_id”字段。
• 查询客户调账记录的请求参数和响应参数中分别增加“trans_id”字段。

2018-05-18

第十八次正式发布。

本次变更说明如下：

• 同步客户实名认证信息的请求参数“name”描述列增加约束条件。
• 查询客户消费明细的请求参数“endTime”描述列增加约束条件。
• 9.1.1-创建云服务器的“[8] bandwidth字段数据结构说明”中“chargemode”字段说明列增加约束条件。

2018-05-13

第十七次正式发布。

本次变更说明如下：

• “接口使用方法 > 使用方法”中的“Endpoint”描述增加“该Endpoint为全局Endpoint，中国站所有区域均可使用”的说明。
• 对接口分类、接口名称和接口呈现顺序进行调整。接口名称调整前后对比如表1所示。
• 优化9.1.1-创建云服务器请求示例。

2018-03-30

第十六次正式发布。

本次变更说明如下：

• 发放优惠券的请求参数中增加“cloud_service_types”和“product_ids”两个参数。
• 新增云服务类型。
• 查询客户包年/包月资源列表的响应参数中增加“valid_time”和“expire_time”两个参数。
• “接口使用方法 > 获取请求认证 > AK/SK认证 > 示例代码”中对serviceName进行说明。
• 在订购包年/包月产品和变更包年/包月产品规格的功能介绍中增加说明。
• 新增9.1.1-创建云服务器
• 新增9.1.2-创建云硬盘
• 新增9.1.3-申请弹性公网IP
• 新增9.1.5-变更云服务器规格
• 新增9.1.6-扩容云硬盘
• 新增9.1.7-变更包年/包月带宽

2018-03-02

第十五次正式发布。

本次变更说明如下：

• 新增退订开通或变更失败的包年/包月产品
• 发放优惠券和回收优惠券的“状态码”中增加错误码CBC.5024。

2018-02-09

第十四次正式发布。

本次变更说明如下：

• 支付包年/包月产品订单的请求参数增加“couponIds”。
• 新增查询订单可用优惠券。
• 向客户账户拨款和回收客户账户余额的“状态码”中增加错误码CBC.5021。

2018-02-02

第十三次正式发布。

本次变更说明如下：

• 新增设置伙伴折扣
• 新增查询伙伴折扣
• 新增查询优惠券额度
• 新增发放优惠券
• 新增回收优惠券
• 新增查询优惠券发放回收记录
• 新增查询已发放的优惠券
• 查询客户列表的响应参数“customer_info_list”中增加参数“cooperation_type”。
• 支付包年/包月产品订单的请求参数“payAccountType”改为可选。

2018-01-26

第十二次正式发布。

本次变更说明如下：

• 修改“接口使用方法 > 使用方法”中表1的Endpoint。
• 修改“公共参数 > 公共请求消息头参数”中“Host”的示例。

2018-01-19

第十一次正式发布。

本次变更说明如下：

• 新增批量查询客户账户余额
• 新增查询客户优惠券列表
• 优化订购包年/包月产品中请求参数说明和请求示例

2018-01-06

第十次正式发布。

本次变更说明如下：

新增续订包年/包月资源

2017-12-22

第九次正式发布。

本次变更说明如下：

• 新增退订包年/包月资源
• 新增查询客户包年/包月资源列表

2017-12-15

第八次正式发布。

本次变更说明如下：

• 新增校验客户注册信息
• 新增查询订购关系列表
• 新增查询订单列表

2017-12-08

第七次正式发布。

本次变更说明如下：

• 新增回收客户账户余额
• 新增查询客户按需资源列表

2017-11-24

第六次正式发布。

本次变更说明如下：

新增查询客户消费明细

2017-11-17

第五次正式发布。

本次变更说明如下：

• 新增生成订单号
• 订购包年/包月产品和变更包年/包月产品规格的请求参数中增加“orderId”。

2017-11-11

第四次正式发布。

本次变更说明如下：

新增取消订单

2017-11-06

第三次正式发布。

本次变更说明如下：

• 新增查询客户月度消费账单
• 新增配额管理
• 新增错误码说明

2017-11-03

第二次正式发布。

本次变更说明如下：

• 新增订购包年/包月产品
• 新增支付包年/包月产品订单
• 新增变更包年/包月产品规格

2017-10-27

第一次正式发布。

2017-09-28

客户管理

校验客户注册信息

检查用户登录名或者邮箱或者手机号是否重复

POST /v1.0/{partner_id}/partner/customer-mgr/check-user

同步客户实名认证信息

同步子客户实名认证信息

PUT /v1.0/{partner_id}/partner/customer-mgr/verified-info

查询客户列表

查询子客户信息列表

GET /v1.0/{partner_id}/partner/customer-mgr/detail

账务管理

向客户账户拨款

授予子客户消费额度

POST /v1.0/{partner_id}/partner/account-mgr/adjust-amount

回收客户账户余额

回收授予的子客户消费额度

POST /v1.0/{partner_id}/partner/account-mgr/retrive-amount

查询客户调账记录

查询子客户消费额度授予记录

POST /v1.0/{partner_id}/partner/account-mgr/query-adjust-records

批量查询客户账户余额

批量查询账户余额

POST /v1.0/{partner_id}/partner/account-mgr/customer-balances

查询客户月度消费账单

查询子客户消费按月汇总账单

GET /v1.0/{partner_id}/partner/account-mgr/bill/detail

查询客户消费明细

查询子客户详细账单

POST /v1.0/{partner_id}/partner/account-mgr/bill/query-fee-records

订购管理

查询订单可用优惠券

查询订单可用的促销券列表

GET /v1.0/{domain_id}/common/order-mgr/orders/order-coupons

查询订单列表

查询订单列表（通用）

GET /v1.0/{domain_id}/common/order-mgr/orders/detail

查询订单列表（旧）

查询订单列表

GET /v1.0/{partner_id}/partner/order-mgr/orders/detail

查询订购关系列表

查询订购关系列表（通用）

GET /v1.0/{domain_id}/common/order-mgr/subscriptions/detail

查询订购关系列表（旧）

查询包年/包月产品订购关系列表

GET /v1.0/{partner_id}/partner/order-mgr/subscriptions/detail

设置自动续费

开通自动续费

POST /v1.0/{domain_id}/customer/order-mgr/subscriptions/{subscription_id}/actions?action_id=autorenew

查询客户包年/包月资源列表

查询用户的包年/包月资源列表

GET /v1.0/{domain_id}/common/order-mgr/resources/detail

根据变更产品规格查询价格

根据产品规格变更查询价格

POST /v1.0/{domain_id}/customer/product-mgr/query-change-rating

变更包年/包月产品规格

变更包年/包月产品

POST /v1.0/{partner_id}/partner/order-mgr/orders/update

续订包年/包月资源

根据资源ID续订包年/包月产品

POST /v1.0/{domain_id}/common/order-mgr/resources/renew

退订包年/包月资源

根据资源ID退订包年/包月产品

POST /v1.0/{domain_id}/common/order-mgr/resources/delete

促销管理

查询客户优惠券列表

查询促销券列表

GET /v1.0/{domain_id}/common/promotion-mgr/coupons

查询优惠券额度

查询伙伴的促销券发放额度

GET /v1.0/{partner_id}/partner/promotion-mgr/partner-coupons/quato

发放优惠券

发放伙伴促销券

POST /v1.0/{partner_id}/partner/promotion-mgr/partner-coupons

回收优惠券

回收伙伴促销券

POST /v1.0/{partner_id}/partner/promotion-mgr/recycle-partner-coupons

查询已发放的优惠券

查询伙伴发放的促销券列表

GET /v1.0/{partner_id}/partner/promotion-mgr/partner-coupons

查询优惠券发放回收记录

查询促销券发放回收记录

GET /v1.0/{partner_id}/partner/promotion-mgr/partner-coupons/records

云服务

创建云服务器

创建云服务器（v1.1版本）

POST /v1.1/{tenant_id}/cloudservers

创建云硬盘

创建云硬盘（按需或包年/包月）

POST /v2.1/{tenant_id}/cloudvolumes

申请弹性IP

申请包年/包月弹性IP

POST /v2.0/{tenant_id}/publicips

变更云服务器规格

变更云服务器规格（v1.1版本）

POST /v1.1/{tenant_id}/cloudservers/{server_id}/resize

扩容云硬盘

扩容云硬盘（按需或包年/包月）

POST /v2.1/{tenant_id}/cloudvolumes/{volume_id}/action

变更包年/包月带宽

更新包年/包月带宽

PUT /v2.0/{tenant_id}/bandwidths/{bandwidth_id}