华为云用户手册

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 200 CBC.0000 成功。 200 CBC.6001 资源ID或者预留实例ID为空。 500 CBC.0999 其他错误。 400 CBC.0100 参数错误。 403 CBC.0151 拒绝访问。

响应消息 响应参数 参数 参数类型 描述 error_code String 状态码。 具体请参见状态码。 error_msg String 错误描述信息。 ratingResult RatingResult 询价结果。 具体请参见表3 表3 RatingResult 参数 参数类型 取值范围 描述 productId String 最大长度：64 变更后的产品ID。 amount Double - 订单总额，即最终优惠后的订单金额。 discountAmount Double - 订单优惠额。 originalAmount Double - 订单原总额，即优惠前订单总额。 measureId Integer - 度量单位标识： 1：元 2：角 3：分 currency String 最大长度：10 货币单位代码（遵循ISO 4217标准）。 CNY：人民币 值为空代表人民币。 extendParams String 最大长度：1024 扩展参数。 响应示例: HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "error_code": "CBC.0000", "error_msg": "Success", "ratingResult": { "productId": "00301-279093-0--1", "amount": 60, "discountAmount": 0, "originalAmount": 60, "measureId": 1, "currency": null, "extendParams": null } }

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 productInfo 是 ProductInfo - 变更后的新的云服务产品信息。 具体请参见表2。 tenantId 否 String [1-128] 项目ID。 此参数预留。 可以调用“通过assume_role方式获取用户token”接口获取项目ID，参见如何获取合作伙伴ID（partner_id）进入“我的凭证”页面，在“项目列表”页签，可以查看不同所属区域对应的项目ID。 此参数不携带或携带值为null时，不作为筛选条件；不支持携带值为空串。 resourceId 是 String 最大长度：128 资源标识ID。 可以通过调用“查询客户包年/包月资源列表（旧）”接口获取。 inquiryTime 否 String 最大长度：40 询价时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。 为空的时候默认当前时间。 其中，HH范围是0～23，mm和ss范围是0～59。 此参数不携带或携带值为空串或携带值null时，默认当前时间。当inquiryTime不为空时用于匹配 定价 ，作为变更操作的生效时间来计算价格。 表2 ProductInfo 参数 是否必选 参数类型 取值范围 描述 cloudServiceType 是 String 最大长度：400 云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 resourceType 是 String 最大长度：400 资源类型编码，例如E CS 的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。 resourceSpecCode 是 String 最大长度：400 云服务产品的资源规格。如果是VM的资源规格，则需要在规格后面添加“.win”或“.linux”，例如“s2.small.1.linux”。 resourceSize 否 Integer [1-214783647] 资源容量大小，与“resouceSizeMeasureId”配合使用。 例如购买的卷大小或带宽大小。 询价线性产品时，此参数必填。 resouceSizeMeasureId 否 Integer [1-214783647] 资源容量度量标识，枚举值如下： 15：Mbps（购买带宽时使用） 17：GB（购买云硬盘时使用） extendParams 否 String 最大长度：10240 扩展参数，可空。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 请求示例 POST https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/product-mgr/query-change-rating HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "tenantId": "74610f3a5ad941998e91f076297ecf27", "resourceId": "49efc9fc53ad4015888035d6e65420a2", "productInfo": { "cloudServiceType": "hws.service.type.ebs", "resourceType": "hws.resource.type.volume", "resourceSpecCode": "SSD", "resourceSize": 200, "resouceSizeMeasureId": 17 }, "inquiryTime": "2017-08-23T08:00:00Z" }

URI GET /v2/systems/configs/cities 查询参数 参数 是否必选 参数类型 取值范围 描述 province_code 是 String 最大长度：40 省份编码。 offset 否 Integer [0-1000] 偏移量，从0开始。默认值为0。 此参数不携带或携带值为空或携带值为null时，取默认值0；不支持携带值为空串。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。 示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 limit 否 Integer [1-1000] 每次查询的数量，最大1000。 该参数不携带时，取默认值10。 该参数不支持携带值为空、不支持携带值为空串、不支持携带值为null。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.30000010 无效订单（可能是订单不存在），不能进行操作。 400 CBC.99003106 订单状态已发生变更，不能进行支付操作。 400 CBC.99003108 您选择的折扣不可用于该订单。 400 CBC.99003110 订单已经过了支付截止时间，请重新提交订单。 400 CBC.99003112 优惠券或储值卡已被使用。 400 CBC.99003116 选择的优惠券限制不能和折扣同时使用。 400 CBC.99003117 选择的优惠券配置了最小折扣比例，而选择的折扣小于这个折扣比例。 例如：优惠券配置的最小折扣比例为90%，而选择的折扣在所有订单行上都小于90%，则该折扣不可使用。 400 CBC.99003141 云服务配额或容量不足或规格发生变化。 400 CBC.99003147 代金券和折扣券不能同时使用。 400 CBC.99003155 企业项目资金配额不足/项目不可用。 400 CBC.99003156 云商店券和专用代金券不能同时使用。 400 CBC.99003162 支付时间超过设定的生效时间。 400 CBC.99003198 企业组织预算不足。 400 CBC.99005003 余额不足。 400 CBC.99006093 获取不到税率信息。 400 CBC.99008040 操作频繁。 500 CBC.0999 其他错误。 400 CBC.99000089 抱歉，当前订单号不能操作，请使用组合交易单号操作。 400 CBC.99008056 今日创建交易已达上限。

功能介绍 该接口即将下线，“支付包年/包月产品订单”新接口请参考支付包年/包月产品订单。 客户可以对待支付状态的包年/包月产品订单进行支付。 客户登录费用中心支付包年包月产品的待支付订单请单击这里。 余额支付包括现金账户和信用账户两种支付方式，如果两个账户都有余额，则优先现金账户支付。 同时使用订单折扣和优惠券的互斥规则如下： 如果优惠券的限制属性上存在simultaneousUseWithEmpowerDiscount字段，并且值为0，则优惠券和伙伴授予折扣不能同时使用。 如果优惠券的限制属性上存在simultaneousUseWithContractDiscount字段，并且值为0，则优惠券和商务授权折扣不能同时使用。 如果优惠券的限制属性上存在minConsumeDiscount字段，当折扣ID包含的所有订单项上的折扣率discount_ratio都小于minConsumeDiscount字段时，则折扣ID和优惠券不能同时使用。 如果优惠券的限制属性上存在simultaneousUseWithPromotionDiscount字段，并且值为0，则优惠券和促销折扣不能同时使用。 财务托管企业子调用该接口时，若企业主帐号存在订单可用的优惠券，则支付订单时会自动使用，无需在请求参数中携带优惠券ID。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.0100 参数错误。 200 CBC.99000000 无对该客户的操作权限。 400 CBC.99000012 额度不存在或者额度状态不正确。 200 CBC.99000013 优惠券额度不足。 400 CBC.99000017 额度未生效或者已过期。 400 CBC.99000018 券面值不得小于最小值。 400 CBC.99000019 券面值不得大于最大值。 200 CBC.99000020 券数量超过最大限制。 200 CBC.99000021 券总面值不允许超过总面值。 200 CBC.99000022 该券只能发给首次关联的子客户。 400 CBC.99000023 券的云服务限制、产品限制超出额度的限制。 200 CBC.99000035 非合作伙伴子客户。 400 CBC.99000037 您没有操作该云经销商的权限。 400 CBC.50000020 该代金券只适用于指定客户。 400 CBC.50000010 您已是伙伴用券模式，无法发放代金券。 400 CBC.50000054 产品不存在。 400 CBC.50000055 云服务类型不存在。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 400 CBC.99000035 非合作伙伴子客户。 400 CBC.99000099 客户实名认证时证件附件的文件大小超过最大配置值。 400 CBC.99000100 客户实名认证时证件附件的文件格式不正确。 400 CBC.99007004 发起的业务操作存在不满足的业务检查项。 400 CBC.99007188 该客户已经实名认证或者实名认证在审核中。 400 CBC.99007191 客户实名认证次数超过最大配置值。 400 CBC.70600026 抱歉，华为云暂无法审核您提交的实名认证信息，请联系您的客户经理协助。 400 CBC.70600032 操作失败，身份信息异常，存在违规风险，如有疑问请提工单咨询客服。 403 CBC.0151 访问拒绝。 500 CBC.0999 未知错误。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.0100 参数错误 400 CBC.99000000 无对该客户的操作权限。 400 CBC.99000035 非合作伙伴子客户。 400 CBC.99000037 您没有操作该云经销商的权限。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

URI GET /v2/bills/partner-bills/subcustomer-bills/monthly-sum 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 cycle 是 String 最大长度：10 消费时间。 格式固定为YYYY-MM。 示例：2018-08 charge_mode 是 String 最大长度：4 计费模式。 1：包年/包月 3：按需 11：节省计划 bill_type 否 String 最大长度：4 账单类型。 0：消费 1：退订 2：华为核销 此参数不携带或携带值为空时，不作为筛选条件。 indirect_partner_id 否 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。 如果需要查询云经销商伙伴的子客户的消费汇总账单，必须携带该字段。除此之外，此参数不做处理。 customer_id 否 String 最大长度：64 客户账号ID。您可以调用查询客户列表接口获取customer_id。 此参数不携带或携带值为空时，不作为筛选条件。 cloud_service_type 否 String 最大长度：256 云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空时，不作为筛选条件。 offset 否 Integer [0-最大整数] 偏移量，从0开始。默认值为0。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。 示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 limit 否 Integer [1-100] 每页个数。默认值为10。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/promotions/benefits/partner-coupons?coupon_id=CP190912081601OJDA&customer_id=CS19040119281JMYC&order_id=promotionPlanId5322584&coupon_type=1&status=2&create_time_begin=2017-12-17T10:32:02Z&create_time_end=2017-12-17T10:32:02Z&effective_time_begin=2017-12-17T10:32:02Z&effective_time_end=2017-12-17T10:32:02Z&expire_time_begin=2017-12-17T10:32:02Z&expire_time_end=2017-12-17T10:32:02Z&offset=0&limit=10&indirect_partner_id=5c2ec3bd80c9462aad432f5566e9feb1 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.0100 参数错误。 400 CBC.99000037 您没有操作该云经销商的权限。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

URI GET /v2/promotions/benefits/partner-coupons 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 coupon_id 否 String 最大长度：64 优惠券ID。 此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 customer_id 否 String 最大长度：64 客户账号ID。您可以调用查询客户列表接口获取customer_id。 此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 order_id 否 String 最大长度：64 订单ID。 此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 coupon_type 否 Integer - 优惠券类型。 1：代金券 4：现金券 此参数不携带或携带值为空或携带值为null时，不作为筛选条件。 status 否 Integer - 客户优惠券实例状态： 2：可使用 3：已使用 4：已过期 5：已回收 此参数不携带或携带值为空或携带值为null时，不作为筛选条件。 create_time_begin 否 String 最大长度：20 创建时间（开始）。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。 其中，HH范围是0～23，mm和ss范围是0～59。 输入这个条件，会查询出创建时间大于这个时间的记录。 此参数不携带或携带值为空时，不作为筛选条件。 create_time_end 否 String 最大长度：20 创建时间（结束）。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。 其中，HH范围是0～23，mm和ss范围是0～59。 输入这个条件，会查询出创建时间小于这个时间的记录。 此参数不携带或携带值为空时，不作为筛选条件。 effective_time_begin 否 String 最大长度：20 生效时间（开始）。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。 其中，HH范围是0～23，mm和ss范围是0～59。 输入这个条件，会查询出生效时间大于这个时间的记录。 此参数不携带或携带值为空时，不作为筛选条件。 effective_time_end 否 String 最大长度：20 生效时间（结束）。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。 其中，HH范围是0～23，mm和ss范围是0～59。 输入这个条件，会查询出生效时间小于这个时间的记录。 此参数不携带或携带值为空时，不作为筛选条件。 expire_time_begin 否 String 最大长度：20 失效时间（开始）。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。 其中，HH范围是0～23，mm和ss范围是0～59。 输入这个条件，会查询出失效时间大于这个时间的记录。 此参数不携带或携带值为空时，不作为筛选条件。 expire_time_end 否 String 最大长度：20 失效时间（结束）。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。 其中，HH范围是0～23，mm和ss范围是0～59。 输入这个条件，会查询出失效时间小于这个时间的记录。 此参数不携带或携带值为空时，不作为筛选条件。 offset 否 Integer [0-最大整数] 偏移量，从0开始。默认值为0。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。 示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 limit 否 Integer [1-100] 查询的每页数量。默认值为10。 indirect_partner_id 否 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。 华为云总经销商（一级经销商）查询云经销商发放给子客户的优惠券时，需要携带该参数；除此之外，此参数不做处理。否则只能查询发放给自己子客户的优惠券。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 请根据“请求消息”中请求参数的描述检查输入的参数是否满足条件。 400 CBC.0101 参数无效。 400 CBC.50010059 一级经销商不允许关联子客户。 400 CBC.50010065 该伙伴是云经销商，其关联的总经销商已经摘牌退出，无法拓客创建关联关系。 400 CBC.99000038 客户登录名已经存在。 400 CBC.99000029 客户手机号已经存在。 400 CBC.99000031 客户登录名格式不合法。 400 CBC.5017 客户手机号格式不合法。 400 CBC.99000039 xaccountId重复。 400 CBC.99000004 客户向伙伴授权时发生异常。 400 CBC.99000030 手机号注册数量超过上限。 400 CBC.99000036 客户密码格式不合法。 400 CBC.99000037 您没有操作该云经销商的权限。 500 CBC.99000050 伙伴和子客户关联结果查询超时，请使用查询客户列表确认最终关联结果。 400 CBC.99000051 该手机号/邮箱已被华为报备，无法创建客户。 400 CBC.99004008 有验证码，但是已经失效。 400 CBC.99004009 有验证码，但是校验失败次数已经大于3。 400 CBC.99004010 校验客户端输入的验证码错误。 400 CBC.99005035 测试伙伴账号不能使用该接口。 401 CBC.0154 token非法/过期。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。 400 CBC.50010085 该伙伴企业目前处于受限状态，无法拓客创建关联关系。 400 CBC.50010086 该伙伴是云经销商，其关联的总经销商企业目前处于受限状态，无法拓客创建关联关系。

功能介绍 在伙伴销售平台创建客户时同步创建华为云账号，并将客户在伙伴销售平台上的账号与华为云账号进行映射。同时，创建的华为云账号与伙伴账号关联绑定。 华为云总经销商（一级经销商）可以注册云经销商（二级经销商）的子客户。注册完成后，子客户可以自动和云经销商绑定。 调用该接口为客户创建华为云账号后，如果想从合作伙伴销售平台跳转至华为云官网，还需要进行SAML认证，具体请参见“Web UI方式”中的“SAML认证”。 如果创建的时候不输入手机号，那么客户将无法收到华为云发出的任何提醒短信，需要客户自己登录到华为云平台补充手机号。 调用“创建客户”接口时，华为云会同步创建华为云客户账号，将客户ID及账号名返回给伙伴平台，然后华为云异步完成客户与伙伴的关联。伙伴与客户的关联结果可通过“查询客户列表”查询。 默认会创建代售模式的客户。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 xaccount_id 是 String 最大长度：128 伙伴销售平台的用户唯一标识，该标识的具体值由伙伴分配。 xaccount_type 是 String 最大长度：64 华为分给合作伙伴的平台标识。 该标识的具体值由华为分配。获取方法请参见如何获取xaccountType的取值。 domain_name 否 String [5-32] 客户的华为云账号名。 如果为空，随机生成。 不能以“op_”或“shadow_”开头且不能全为数字。 校验长度（5到32位）和规则^([a-zA-Z_-]([a-zA-Z0-9_-])*)$。 此参数不携带或携带值为空串或携带值为null时，随机生成。 mobile_phone 否 String 最大长度：32 手机号。 目前系统只支持中国的手机号。 示例：13XXXXXXXXX 此参数不携带或携带值为null时，不被赋值；携带值为空串时，赋值为空串。 verification_code 否 String [6] 验证码。 请调用“发送验证码”接口获取。 如果手机号不存在，则不需要输入验证码。 此参数不携带或携带值为null时，不做处理；不支持携带值为空串。 password 否 String 长度：[8-32] 密码规则如下： 至少包含以下四种字符中的两种： 大写字母、小写字母、数字、特殊字符； 不能和账号名或倒序的账号名相同； 不能包含手机号。 如果为空，用户没有密码，则不能直接在华为云登录，只能通过伙伴系统SSO方式跳转到华为云。 此参数不携带或携带值为null时，密码随机生成；不支持携带值为空串。 is_close_market_ms 否 String 最大长度：10 是否关闭营销消息的发送。 true：关闭 false：不关闭（默认） 此参数不携带或携带值为空串或携带值为null时，赋值为false。 indirect_partner_id 否 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。 如果需要创建云经销商的子客户，必须携带该字段。除此之外，此参数不携带或携带值为空串或携带值为null，不做处理。 include_association_result 否 Boolean - 是否返回子客户的关联结果。 true：返回子客户和伙伴的关联结果 false：不返回子客户和伙伴的关联结果 默认值为false。 此参数不携带或携带值为空串或携带值为null时，赋值为false。 请求示例 POST https://bss.myhuaweicloud.com/v2/partners/sub-customers HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "domain_name": "test", "mobile_phone": "188****8888", "verification_code": "253***", "xaccount_id": "35rey****", "xaccount_type": "***_IDP", "password": "*******", "is_close_market_ms": "true", "indirect_partner_id": "a0d736********aab6502d1a828c1809", "include_association_result": "false" }

响应消息 响应参数 参数 参数类型 取值范围 描述 error_code String 最大长度：16 状态码。具体请参考状态码。只有失败才会返回这个参数。 error_msg String 最大长度：1024 错误描述信息。只有失败才会返回这个参数。 domain_id String 最大长度：64 客户ID。 只有成功或者错误码在CBC.99000050时才会返回。 domain_name String 最大长度：64 客户的华为云账号名。 若请求参数中传递了此参数值，此处返回的响应值与请求参数中取值一致。 若请求参数中未传递此参数值，此处返回的响应值为系统随机生成的32位字符串。 只有成功时或者错误码在CBC.99000050时才会返回。 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "domain_id": "06a7969058802f0c0f01c00b91846780", "domain_name": "a0d736359ada40aab6502d1a828c1809" }

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 region_code 否 String 最大长度：64 云服务区编码，例如：“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 order_id 否 String 最大长度：64 订单ID。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 product_id 否 String 最大长度：64 产品ID，即资源包ID。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 product_name 否 String 最大长度：256 产品名称，即资源包名称。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 enterprise_project_id 否 String 最大长度：64 企业项目ID。 如需查询企业项目下的资源列表，必须携带该参数； 若参数不携带或携带值为空串或携带值为null时，查询除企业项目外的其他所有资源列表。 status 否 Integer [0-4] 状态： 0：未生效 1：生效中 2：已用完 3：已失效 4：已退订 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 offset 否 Integer [0-9999] 页码，如果要查询第一页，请输入1，后面依次类推。 若此参数输入0，默认查询第一页。 此参数不携带或携带值为空串或携带值为null时，默认查询第一页；不支持携带值为空。 limit 否 Integer [1-1000] 每次查询的记录数，默认为10。 此参数不携带或携带值为空串或携带值为null时，取值为10；不支持携带值为空。 请求示例 POST https://bss.myhuaweicloud.com/v2/payments/free-resources/query HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "region_code": "cn-north-7", "order_id": "CS21043011259RWXXTA", "product_id": "90301-296014-0--0", "product_name": "华为云 WeLink ", "enterprise_project_id": null, "status": 1, "offset": 0, "limit": 10 }

URI GET /v2/products/service-resources 表1 Header参数 参数 是否必选 取值范围 描述 X-Language 否 最大长度：8 语言。 中文：zh_CN 英文：en_US 缺省为zh_CN。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 service_type_code 是 String 最大长度：64 云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 offset 否 Integer [0-10000000] 偏移量，从0开始。默认值为0。 此参数不携带或携带值为空或携带值为null时，取默认值0；不支持携带值为空串。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。 示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 limit 否 Integer [1-100] 每次查询的数量，默认值为10。 此参数不携带时，取默认值10；不支持携带值为空或携带值为空串或携带值为null。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/products/service-resources?service_type_code=hws.service.type.obs&limit=5&offset=0 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ X-Language: zh_CN

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

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/bills/partner-bills/subcustomer-bills/res-fee-records?customer_id=06a29ceaae80d2400fc0c01027684d40&cycle=2020-04&cloud_service_type=hws.service.type.ec2®ion=cn-north-1&charge_mode=1&bill_type=1&offset=0&limit=10&resource_id=f4a7ed17-dcbd-4554-b26b-248ea46c056a&include_zero_record=true&indirect_partner_id=c9e731c4663646988ef4cdb3122837b6 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

URI GET /v2/bills/partner-bills/subcustomer-bills/res-fee-records 参数说明请参见表1-1。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 customer_id 是 String 最大长度：64 客户账号ID。您可以调用查询客户列表接口获取customer_id。 cycle 是 String 最大长度：10 查询的客户消费记录所在账期，格式：YYYY-MM。 charge_mode 是 String 最大长度：4 计费模式。 1 : 包年/包月 3：按需 10: 预留实例 cloud_service_type 否 String 最大长度：64 云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空时，不作为筛选条件；携带值为空串时，作为筛选条件。 region 否 String 最大长度：64 云服务区编码，例如：“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 此参数不携带或携带值为空时，不作为筛选条件；携带值为空串时，作为筛选条件。 bill_type 否 Integer - 账单类型。 1：消费-新购 2：消费-续订 3：消费-变更 4：退款-退订 5：消费-使用 8：消费-自动续订 9：调账-补偿 14：消费-服务支持计划月末扣费 16：调账-扣费 18：消费-按月付费 20：退款-变更 此参数不携带或携带值为空时，不作为筛选条件；携带值为空串时，作为筛选条件。 offset 否 Integer [0-最大整数] 偏移量，从0开始。默认值为0。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。 示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 limit 否 Integer [1-1000] 每次查询的数量限制。默认值为10。 resource_id 否 String 最大长度：64 资源ID。 此参数不携带时，不作为筛选条件；携带值为空串或携带值为空时，作为筛选条件。 include_zero_record 否 Boolean - 返回是否包含应付金额为0的记录。 true：包含 false：不包含 此参数不携带或携带值为空时，不作为筛选条件；携带值为空串时，作为筛选条件。 indirect_partner_id 否 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。 如果华为云总经销商需要查询客户在云经销商关联期间的消费，需要携带该字段；除此之外，此参数不做处理。否则只能查询该客户在与自己关联期间的消费。 bill_date_begin 否 String 最大长度：10 查询的资源消费记录的开始日期，格式为YYYY-MM-DD。 此参数不携带或携带值为空或携带值为空串时，默认值取cycle月份的第一天。 说明： 必须和cycle（即资源的消费账期）在同一个月。 bill_date_end 否 String 最大长度：10 查询的资源消费记录的结束日期，格式为YYYY-MM-DD。 此参数不携带或携带值为空或携带值为空串时，默认值取cycle月份的最后一天。 说明： 必须和cycle（即资源的消费账期）在同一个月。 bill_date_begin和bill_date_end两个参数必须同时出现，否则仅按照cycle（即资源的消费账期）进行查询。

REST API 客户在伙伴销售平台完成包年/包月资源的续订。 该接口只允许使用客户AK/SK或者Token调用，不允许使用解决方案提供商或华为云总经销商（一级经销商）的AK/SK或者Token调用。因为目前解决方案提供商或华为云总经销商（一级经销商）不能自己买产品，所以没有自己的包年/包月产品。 调用接口后，如果某个主资源ID有对应的从资源ID，系统会将主资源ID和从资源ID一起续订，存在主从资源关系的资源为： 云主机为主资源，对应的从资源为云硬盘 共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP） 独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽 本接口支持自动支付，自动支付时支持使用折扣、优惠券。支付时使用折扣或优惠券的说明，请参见支付使用折扣或优惠券说明。

Web UI 资源即将到期时，已经购买包年/包月产品的客户，可以在费用中心执行续订操作。 进入“ 续费管理”页面。 如需对 域名 续费，可点击页面右上角“域名续费”快捷入口，进入控制台进行续费操作。请参见“如何域名续费”。 设置查询条件。 开通了企业项目管理的客户可以设置查询条件筛选该客户下各企业项目的名称，查询各企业项目待续费的资源。 单击“设置统一到期日”，可以设置资源的统一到期日，设置资源统一到期日的步骤请参见如何设置统一到期日。 可在“手动续费项”、“自动续费项”、“到期转按需项”“到期不续费项”页签查询全部待续费资源。 可对“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签的资源进行手动续费的操作。 所有需手动续费的资源都可归置到“手动续费项”页签。请参见如何恢复为手动续费。 单个续费与批量续费可使用不同的操作方式： 单个续费：在资源页面找到需要续费的资源，单击操作列的“续费”。 批量续费：在资源页面勾选需要续费的资源，单击列表左上角的“批量续费”。 进入续费管理页面，默认隐藏有待支付订单的资源，可取消勾选页面中间“隐藏有待支付订单的资源”展示出来。 若资源有续费待支付订单，对该资源进行续费时弹出提示：资源有待支付订单，完成支付或取消订单后才能续费订单。可点击提示框的订单号进入订单页面，完成支付或取消该订单后，该资源恢复可续费状态。 确认需要续费的资源信息，并设置续费时长，单击“去支付”。 选择优惠和支付方式，单击“确认付款”。 获取并输入手机验证码，单击“确认付款”。 操作成功即可完成续费。 如暂时不支付，可直接关闭支付页面。后续可以在左侧菜单中选择“我的订单”并单击“待支付”页签，支付刚才生成的续费订单，即可完成续费。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 receiver_type 是 Integer [1] 发送验证码的类型： 1：发送短信验证码 timeout 否 Integer [1-3000] 发送验证码的超时时间。 此参数不携带或携带值为null时，采用系统默认超时时间10分钟。 此参数值超过60时，取值固定为5分钟。 单位：分钟。 mobile_phone 是 String 最大长度：32 指定发送验证码的手机号。 目前系统只支持中国手机号。 示例：13XXXXXXXXX lang 否 String 最大长度：16 根据该参数的取值选择发送短信验证码的语言。 zh-cn：中文 en-us：英文 此参数不携带或携带值为空串或携带值为null时，取默认值zh-cn。 scene 否 Integer - 验证码使用的场景，目前支持如下场景： 29：注册场景 18：个人银行卡实名认证场景 此参数不携带或携带值为null时，默认值为“29”；不支持携带值为空串。 customer_id 否 String 最大长度：64 客户账号ID。您可以调用查询客户列表接口获取customer_id。 当scene=18时此参数必填；除此之外此参数非必填，不携带或携带值为空串或携带值为null时均不做处理。 请求示例 POST https://bss.myhuaweicloud.com/v2/bases/verificationcode/send HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "receiver_type":1, "timeout": 5, "mobile_phone":"188****8888", "lang":"en-us", "scene": 18, "customer_id": "a0d736359ada40aab6502d1a828c1809" }

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 400 CBC.99000035 非合作伙伴子客户。 400 CBC.99004002 生成验证码失败。 400 CBC.99004003 验证码生成成功但发送失败。 400 CBC.99004005 手机号为空/格式不合法。 400 CBC.99004015 发送验证码次数已达到上限（15次/小时，60次/天）。 401 CBC.0154 token非法/过期。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

响应消息 响应参数 参数 参数类型 取值范围 描述 error_code String 最大长度：16 状态码。具体请参考状态码。只有失败才会返回这个参数。 error_msg String 最大长度：1024 错误描述信息。只有失败才会返回这个参数。 响应示例 HTTP/1.1 204 No Content Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 account_name 否 String 最大长度：64 客户登录名称（如果客户创建了 IAM 用户，此处需要填写主账号登录名称。关于主账号和IAM用户的具体介绍请参见身份管理中“账号”和“IAM用户”的描述）。 支持模糊查询。仅支持前缀匹配、后缀匹配、中间匹配；不支持携带空格查询。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 customer 否 String 最大长度：64 客户的实名认证名称，支持模糊查询。仅支持前缀匹配、后缀匹配、中间匹配；不支持携带空格查询。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 offset 否 Integer [0-40000000] 偏移量，从0开始。默认值为0。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。 示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 limit 否 Integer 最大值：100 每次查询的客户数量。默认值为10。 label 否 String 最大长度：64 标签，支持模糊查找。仅支持前缀匹配、后缀匹配、中间匹配；不支持携带空格查询；不支持英文大小写模糊匹配查询。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 association_type 否 String 最大长度：2 关联类型： 1：顾问销售 2：代售 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 associated_on_begin 否 String 最大长度：20 关联时间区间段开始，UTC时间。 格式：YYYY-MM-DD'T'hh:mm:ss'Z'，例如“2019-05-06T08:05:01Z”。 此参数不携带或携带值为null时，不作为筛选条件，不支持携带值为空串。 associated_on_end 否 String 最大长度：20 关联时间区间段结束，UTC时间。 格式：YYYY-MM-DD'T'hh:mm:ss'Z'，例如“2019-05-06T08:05:01Z”。 此参数不携带或携带值为null时，不作为筛选条件，不支持携带值为空串。 customer_id 否 String 最大长度：64 客户账号ID。您可以调用查询客户列表接口获取customer_id，或者可以从创建客户接口的响应获取domain_id。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 indirect_partner_id 否 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。如果需要查询云经销商的子客户列表，必须携带该字段。除此之外，此参数不做处理。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.0100 参数错误。 400 CBC.99000037 您没有操作该云经销商的权限。 401 CBC.0154 token非法/过期。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。