华为云用户手册

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

状态码 状态码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 今日创建交易已达上限。

功能介绍 客户购买包年/包月资源后，支持客户退订包年/包月实例。退订资源实例包括资源续费部分和当前正在使用的部分，退订后资源将无法使用。 客户在费用中心退订已购买的包年包月资源请参见这里。 首先要成功支付包年/包月产品，产生一条开通成功的包年/包月资源，才能进行退订。 调用接口后，如果某个主资源有对应的从资源，系统会将主资源和从资源一起退订，主资源的从资源信息可以通过调用查询客户包年/包月资源列表接口获取。 注意：如E CS 主机挂载新购的云硬盘，但此硬盘不是该ECS主资源的从资源，主从资源信息必须以调用查询客户包年/包月资源列表接口获取的信息为准。 调用该接口后，您还可以调用“查询退款订单的金额详情”接口查询退订订单对应的金额来自哪些订单。 该接口支持5天无理由全额退订，具体规则请参见“退订规则说明”。 您正在退订使用中的资源，请仔细确认资源信息和退款信息。未放入回收站的资源退订后无法恢复，若您要保留资源，仅退订未使用的续费周期，请退订续费周期。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.0100 参数错误。 400 CBC.30000053 资源计费模式是节省计划，不支持退订。 400 CBC.30000067 资源已被删除或者资源未被纳管，不支持退订。 400 CBC.99003012 资源ID不存在。 400 CBC.99003100 当前操作的资源中，有资源包含在您的待支付的订单，不能进行当前操作。 400 CBC.99003128 资源无已续费周期或续费周期已生效，不支持退订续费周期。 400 CBC.99003185 云服务必须整体操作。 400 CBC.99003643 已开发票的云服务不允许退订 400 CBC.99003647 该按需套餐包不支持退订。 400 CBC.99003649 试用云服务不支持退订。 400 CBC.99003650 云商店中的该云服务不能退订。 400 CBC.99003652 软开云套餐不能退订。 400 CBC.99003654 存在带宽加油包，不允许退订续费周期。 400 CBC.99003656 已冻结，不能执行此操作。 400 CBC.99006066 查询费用信息错误。 403 CBC.0151 访问拒绝。 400 CBC.99003651 交易正在进行中，不可以退订。 500 CBC.0999 其他错误。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 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 }

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

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

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 200 CBC.0000 成功。 400 CBC.0100 参数错误。 403 CBC.0151 访问拒绝。 500 CBC.5002 合作伙伴的客户不存在。 500 CBC.0999 未知错误。

URI GET /v1.0/{partner_id}/partner/customer-mgr/realname-auth/result 参数说明请参见下表。 表1 路径参数 参数 是否必选 取值范围 描述 partner_id 是 最大长度：64 合作伙伴ID（华为分配）。 获取方法请参见如何获取合作伙伴ID（partner_id）。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 customerId 是 String 最大长度：64 客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v1.0/{partner_id}/partner/customer-mgr/realname-auth/result?customerId=45******122 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

响应消息 响应参数 参数 是否必选 参数类型 取值范围 描述 error_code 否 String 最大长度：16 状态码。具体请参考状态码。只有失败才会返回这个参数。 error_msg 否 String 最大长度：1024 错误描述信息。只有失败才会返回这个参数。 reviewResult 否 Integer [0-2] 实名认证审核结果，只有状态码为200并且已经提交过实名认证请求才返回： 0：审核中 1：不通过 2：通过 opinion 否 String 最大长度：256 审批意见，只有状态码为200并且审核不通过才返回。 响应示例 HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: length Date: response time { "reviewResult": 2, "opinion": null }

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

URI GET /v1.0/{domain_id}/common/order-mgr/resources/detail 参数说明请参见下表。 表1 路径参数 参数 是否必选 取值范围 描述 domain_id 是 最大长度：64 客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 resource_ids 否 String 最大长度： 4096 资源ID列表。 查询指定资源ID的资源（当only_main_resource=0时，查询指定资源及其附属资源）。最大支持50个ID同时作为条件查询，多个ID以英文逗号分隔。 此参数不携带、携带空时不参与过滤；携带值为空串、null参与过滤。 说明： 资源ID是指开通资源以后，云服务针对该资源分配的标志，譬如云主机ECS的server_id。 order_id 否 String 最大长度：64 订单号。 查询指定订单下的资源。 此参数不携带、携带为空时不参与过滤；携带值为空串、携带为null参与过滤。 only_main_resource 否 Integer [0|1] 是否只查询主资源，该参数对于请求参数是子资源ID的时候无效，如果resource_ids是子资源ID，只能查询自己。 0：查询主资源及附属资源。 1：只查询主资源。 默认值为0。 此参数不携带、携带值为空、携带为null取默认值0；不支持携带为空串。 说明： 主资源是指有关联的几个资源中，处于主导位置的资源。 对于ECS而言，虚拟机VM是主资源，磁盘EVS是辅资源。 对于VPC而言，共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP）；独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽。 status_list 否 String - 资源状态。 查询指定状态的资源。多个状态以英文逗号分隔。 2：使用中 4：已冻结 5：已过期 此参数不携带、携带为空时返回所有状态的资源数据；不支持携带值为空串、携带为null。 page_no 否 Integer 大于等于1的整数 页码。 默认值是1。 此参数不携带、携带值为空、携带为null时取默认值1；不支持携带值为空串。 page_size 否 Integer [1-500] 每页条数。 默认值是10。最大值是500。 此参数不携带、携带值为空、携带为null时取默认值10；不支持携带值为空串。

功能介绍 客户在伙伴销售平台查询某个或所有的包年/包月资源。 注意事项： 该接口允许使用客户AK/SK或者Token调用；使用合作伙伴AK/SK或者Token调用时接口不会报错，但查询不到数据。 该接口只能查询开通成功的资源。 成功调用本接口后，如果您需要对已生效状态的资源进行续订，您可以调用“查询包年/包月产品价格”接口对查询到的包年/包月资源进行续订询价，然后再调用“续订包年/包月资源（旧）”接口进行续订。 该接口即将下线，“查询客户包年/包月资源列表”新接口请参考查询客户包年/包月资源列表。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/common/order-mgr/resources/detail?resource_ids=b38*****62e,249*****c07&only_main_resource=1&page_no=1&page_size=100 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/orders/customer-orders/order-coupons?order_id=CS170926155954NO7 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

Web UI 客户可以在费用中心“我的订单”页面查看订单详情。 进入“我的订单”页面。 查看云服务订单，选中“云服务”页签；查看硬件订单，选中“硬件商城”页签；查看按需订单，选中“按需”页签。 可根据创建时间或输入订单号、商品名称筛选订单；硬件订单也可通过订单类型、订单状态进行过滤。 在订单页面找到待查看的订单，单击“详情”。 订单状态为“处理中”时，表示资源创建中；表示该订单下有资源开通失败。 当云服务订单状态为“待支付”时，订单详情页面客户可支付订单或取消订单。 当云服务订单中有资源开通失败时，系统会自动退订开通失败的资源。 若订单是客户经理在合同内进行代客下单的，客户可在订单详情页面查看合同信息，点击合同名称进入合同详情页面。 当新购硬件订单为“待支付”时，订单详情页面用户可以支付订单、申请修改地址或取消订单。 当新购硬件订单为“待发货”时，订单详情页面用户可以申请取消发货，申请修改地址。 当新购硬件订单为“已完成”时，订单详情页面用户可以退货、换货或查看售后记录。 当硬件退货/换货订单处于待审核状态或待快递上门取货状态时，在订单详情页面用户可以取消订单。

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

状态码 状态码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.99000088 抱歉，支付处理中，请勿重复操作。 400 CBC.99000089 抱歉，当前订单号不能操作，请使用组合交易单号操作。 400 CBC.99008056 今日创建交易已达上限。

API调用授权（伙伴） 伙伴操作员账号调用API需要经过授权，可通过伙伴中心对操作员赋予有权限项的角色来进行授权，如何为角色授权请参见为组织人员分配权限。接口对应的权限项如下表，只要有权限项中的一条即可以调用。 未在表里的接口不需要做细粒度权限校验，操作员账号均可调用。 官网参考资料链接： 合作伙伴中心API参考（中国站） 表1 场景 子场景 接口名称 接口URL 权限项 权限项名称 管理产品 查询产品信息 查询产品的折扣和激励策略 GET /v2/products/incentive-discount-policies BPC_ITEM_SALES_040100 销售-激励-产品激励策略-产品折扣与激励策略查看 管理客户 注册客户 校验客户注册信息 POST /v2/partners/sub-customers/users/check-identity BPC_ITEM_SUBCUSTSERV_010118 销售-客户-客户管理-客户列表-创建伙伴子客户（能力开放） 发送验证码 POST /v2/bases/verificationcode/send BPC_ITEM_SUBCUSTSERV_010118 销售-客户-客户管理-客户列表-创建伙伴子客户（能力开放） 创建客户 POST /v2/partners/sub-customers BPC_ITEM_SUBCUSTSERV_010118 销售-客户-客户管理-客户列表-创建伙伴子客户（能力开放） 实名认证 申请个人实名认证 POST /v2/customers/realname-auths/individual BPC_ITEM_SUBCUSTSERV_010119 销售-客户-客户管理-客户列表-实名认证同步（能力开放） 申请企业实名认证 POST /v2/customers/realname-auths/enterprise BPC_ITEM_SUBCUSTSERV_010119 销售-客户-客户管理-客户列表-实名认证同步（能力开放） 申请实名认证变更 PUT /v2/customers/realname-auths/enterprise BPC_ITEM_SUBCUSTSERV_010119 销售-客户-客户管理-客户列表-实名认证同步（能力开放） 查询实名认证审核结果 GET /v2/customers/realname-auths/result BPC_ITEM_SUBCUSTSERV_010119 销售-客户-客户管理-客户列表-实名认证同步（能力开放） 管理客户 查询客户列表 POST /v2/partners/sub-customers/query BPC_ITEM_SUBCUSTSERV_010100|BPC_ITEM_SUBCUSTSERV_010500 销售-客户-客户管理-客户列表-查看列表 销售-客户-客户管理-二级经销商子客户-查看客户信息 查询客户的新客标签 POST /v2/partners/sub-customers/new-customers-tags/batch-query BPC_ITEM_SUBCUSTSERV_010100 销售-云经销商-云经销商管理-我的二级分销商列表-查看历史客户经理 管理云经销商 查询云经销商 查询云经销商列表 POST /v2/partners/indirect-partners/query BPC_ITEM_SALES_020100 销售-云经销商-云经销商管理-我的二级分销商列表-查询二级分销商列表 管理云经销商账户 向云经销商账户拨款 POST /v2/accounts/partner-accounts/indirect-partner-adjust BPC_ITEM_SALES_020104 销售-云经销商-云经销商管理-我的二级分销商列表-拨款 回收云经销商账户拨款 POST /v2/accounts/partner-accounts/indirect-partner-reclaim BPC_ITEM_SALES_020105 销售-云经销商-云经销商管理-我的二级分销商列表-回收 管理云经销商优惠券 查询已发放的代金券额度 GET /v2/partners/issued-coupon-quotas BPC_ITEM_SUBCUSTSERV_030600 销售-客户-券管理-已发放代金券-查询已发放列表 向云经销商发放代金券额度 POST /v2/partners/coupon-quotas/indirect-partner-adjust BPC_ITEM_SALES_020106|BPC_ITEM_SUBCUSTSERV_030104 销售-云经销商-云经销商管理-我的二级经销商列表-发放代金券额度 销售-客户-券管理-代金券额度-发放额度 回收代金券额度 POST /v2/partners/coupon-quotas/indirect-partner-reclaim BPC_ITEM_SUBCUSTSERV_030601|BPC_ITEM_SUBCUSTSERV_030602 销售-客户-券管理-已发放代金券额度-批量回收代金券额度 销售-客户-券管理-已发放代金券额度-回收代金券额度 查询代金券额度的发放回收记录 GET /v2/partners/coupon-quotas/records BPC_ITEM_SUBCUSTSERV_030102 销售-客户-券管理-代金券额度-查看操作记录 管理交易 管理客户账户 向客户账户拨款 POST /v2/accounts/partner-accounts/adjust-amount BPC_ITEM_SUBCUSTSERV_010103 销售-客户-客户管理-客户列表-拨款 查询客户账户余额 POST /v2/accounts/customer-accounts/balances/batch-query BPC_ITEM_SUBCUSTSERV_010103|BPC_ITEM_SUBCUSTSERV_010104|BPC_ITEM_SUBCUSTSERV_010100 销售-客户-客户管理-客户列表-拨款 销售-客户-客户管理-客户列表-回收 销售-客户-客户管理-客户列表-查看列表 回收客户账户余额 POST /v2/accounts/partner-accounts/reclaim BPC_ITEM_SUBCUSTSERV_010104 销售-客户-客户管理-客户列表-回收 查询收支明细 GET /v2/accounts/partner-accounts/account-change-records BPC_ITEM_FINANCE_030100 销售-账务-资金管理-收支明细-查看收支明细 查询调账记录 GET /v3/accounts/partner-accounts/adjust-records BPC_ITEM_FINANCE_040100 销售-客户-客户管理-调账记录-查看调账记录 查询伙伴/云经销商账户余额 GET /v2/accounts/partner-accounts/balances BPC_ITEM_VIEW_010100|BPC_ITEM_SUBCUSTSERV_010103|BPC_ITEM_SUBCUSTSERV_010104|BPC_ITEM_SALES_020104|BPC_ITEM_SALES_020105 主页-账号 销售-客户-客户管理-客户列表-拨款 销售-客户-客户管理-客户列表-回收 销售-云经销商-云经销商管理-我的二级分销商列表-拨款 销售-云经销商-云经销商管理-我的二级分销商列表-回收 管理优惠券 查询优惠券列表 GET /v2/promotions/benefits/coupons BPC_MENU_FINANCE_100100|BPC_ITEM_SUBCUSTSERV_050101 销售-客户-券管理-代金券额度-查看代金券列表 销售-客户-客户订单-订单支付-支付订单 查询优惠券额度 POST /rest/cbc/openapi/v2/partners/coupon-quotas/query BPC_ITEM_SUBCUSTSERV_030100 销售-客户-券管理-代金券额度-查看代金券列表 发放优惠券 POST /v2/promotions/benefits/partner-coupons BPC_ITEM_SUBCUSTSERV_030102|BPC_ITEM_SUBCUSTSERV_030103 销售-客户-券管理-代金券额度-发放代金券 销售-客户-券管理-现金券额度-查看操作记录 回收优惠券 POST /v2/promotions/benefits/partner-coupons/reclaim BPC_ITEM_SUBCUSTSERV_030201 销售-客户-券管理-已发放代金券-回收代金券 查询优惠券的发放回收记录 GET /v2/promotions/benefits/partner-coupons/records/query BPC_ITEM_SUBCUSTSERV_030102 销售-客户-券管理-代金券额度-查看操作记录 管理包年/包月订单 查询订单列表 GET /v2/orders/customer-orders BPC_ITEM_SUBCUSTSERV_060100|BPC_ITEM_SUBCUSTSERV_060200 销售-客户-客户订单-客户订单-查看列表 销售-客户-客户订单-二级经销商的客户-查看列表 查询订单详情 GET /v2/orders/customer-orders/details/{order_id} BPC_ITEM_SUBCUSTSERV_060100|BPC_ITEM_SUBCUSTSERV_060200 销售-客户-客户订单-客户订单-查看列表 销售-客户-客户订单-二级经销商的客户-查看列表 管理按需资源 查询客户按需资源列表 POST /v2/partners/sub-customers/on-demand-resources/query BPC_ITEM_SUBCUSTSERV_010105 销售-客户-客户管理-客户列表-查看客户资源 管理账单 - 查询客户月度消费账单 GET /v2/bills/partner-bills/subcustomer-bills/monthly-sum BPC_ITEM_FINANCE_090100 销售-账务-伙伴账单-查看伙伴账单 管理客户消费 查询伙伴消费子客户列表 POST /v2/bills/subcustomer-bills/res-fee-records/sub-customers/query BPC_ITEM_FINANCE_020100 销售-客户-客户消费-消费记录-查看列表 查询伙伴子客户消费记录 GET /v2/bills/subcustomer-bills/res-fee-records BPC_ITEM_FINANCE_020101 销售-客户-客户消费-消费记录-查看详情 父主题： API调用方式

请求消息 请求参数 无 请求示例 GET https://bss.myhuaweicloud.com/v2/bases/resource-types?resource_type_code=hws.resource.type.workplace.basic 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 其他错误。

URI GET /v2/bases/resource-types 表1 Header参数 参数 是否必选 取值范围 描述 X-Language 否 最大长度：8 语言。 zh_CN：中文 en_US：英文 缺省为zh_CN。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 resource_type_code 否 String 最大长度：64 资源类型编码。例如ECS的VM为“hws.resource.type.vm”。 该参数不携带或携带值为空时，不作为筛选条件；携带值为空串或携带值为null时，作为筛选条件。

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

请求消息 请求参数 无 请求示例 GET https://bss.myhuaweicloud.com/v2/bases/service-types?service_type_code=hws.service.type.workplace HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ X-Language: zh_CN

URI GET /v2/bases/service-types 表1 Header参数 参数 是否必选 取值范围 描述 X-Language 否 最大长度：8 语言。 zh_CN：中文 en_US：英文 缺省为zh_CN。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 service_type_code 否 String 最大长度：64 云服务类型编码。例如OBS的云服务类型编码为“hws.service.type.obs”。 该参数不携带或携带值为空时，不作为筛选条件；携带值为空串或携带值为null时，作为筛选条件。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 200 CBC.0000 成功。 400 CBC.0100 参数错误。 403 CBC.0151 拒绝访问。 200 CBC.6006 找不到您询价的产品。 如果报此错误，请检查请求参数中的“productInfos”中 “cloudServiceType”、“resourceType”、“resourceSpecCode”及其他参数是否填写正确。 200 CBC.6055 询价结果超过金额最大限制。 500 CBC.0999 其他错误。

URI POST /v1.0/{domain_id}/customer/product-mgr/query-rating 参数说明请参见表1。 表1 URI参数说明 参数 是否必选 取值范围 描述 domain_id 是 最大长度：64 如果使用合作伙伴AK/SK或者Token，此处为合作伙伴ID，获取方法请参见如何获取合作伙伴ID（partner_id）。 如果使用客户AK/SK或者Token，此处为客户账号ID，您可以调用查询客户列表接口获取customer_id。

账单内容说明 表1 资源消费记录参数说明-包周期Resource_Expenditures(Period)_YYYYMMDD 字段名称 类型 字段描述 消费时间 String 产品的消费时间。包周期产品，消费时间为产品的支付时间。 资源ID String 云服务资源的唯一标识ID。 资源名称 String 云服务资源的名称。 资源标签 String 用户给云服务资源设置的标签。 供应商 String 当前产品的供应商： 华为云 分销商 计费模式 String 计费模式： 包周期 按需 预留实例 节省计划-订购 节省计划-按时计费 产品类型 String 主要指云服务的分类。 资源类型 String 主要指云服务所使用到的资源分类。 产品 String 云服务的名称。 产品规格 String 用于描述云服务所需资源的特征信息，一组属性和属性值域的集合，同一个资源类型的资源规格所包含的属性相同，但属性取值不同。 云服务区 String 指能独立提供公有云服务资源、并服务于一个较大地理范围的云服务区域。 订单号 String 包年包月计费模式时的订单唯一标识号。 原订单号 String 包年包月计费模式时的退订订单所对应的原订单唯一标识号。 企业项目ID String 开通企业项目的客户，所在的企业项目ID。如果客户购买产品时未选择企业项目，则企业项目ID为0。 企业项目名称 String 开通企业项目的客户，所在的企业项目名称。如果客户购买产品时未选择企业项目，则企业项目名称为default。 订单类型 String 包周期产品的订单类型： 新购 续费 退订 变更：升配或降配的订单。正常情况下，消费金额为正数，表示升配；消费金额为负数，表示降配。 购买时长 String 订单购买时长。 官网价总金额 BigDecimal 选择购买的产品和周期后，华为云官网显示的价格。 折扣优惠 BigDecimal 用户使用云服务享受折扣优惠如商务折扣以及促销优惠等减免的金额。基于官网价的优惠金额。 消费金额 BigDecimal 用户使用云服务享受折扣优惠后需要支付的费用金额。折扣包含：促销产品折扣、促销折扣券、商务折扣等各种折扣。 交易时间 String 某条消费记录对应的扣费时间。 表2 资源消费记录参数说明-按需Resource_Expenditures(Pay-per-Use)_YYYYMMDD 字段名称 类型 字段描述 消费时间 String 产品的消费时间。按需产品，消费时间为云服务生失效时间段。 账期 String 与用户约定的一个时间范围，这样对账时才能确定对账范围。该时间范围可根据华为云的营销策略来决定，通常是一个自然月。当一个账期结束时，系统计算出用户在该账期内需要支付的全部费用，并生成账单。 资源ID String 云服务资源的唯一标识ID。 资源名称 String 云服务资源的名称。 资源标签 String 用户给云服务资源设置的标签。 供应商 String 当前产品的供应商： 华为云 分销商 计费模式 String 计费模式： 包周期 按需 预留实例 节省计划-订购 节省计划-按时计费 产品类型 String 主要指云服务的分类。 资源类型 String 主要指云服务所使用到的资源分类。 产品 String 云服务的名称。 产品规格 String 用于描述云服务所需资源的特征信息，一组属性和属性值域的集合，同一个资源类型的资源规格所包含的属性相同，但属性取值不同。 云服务区 String 指能独立提供公有云服务资源、并服务于一个较大地理范围的云服务区域。 企业项目ID String 开通企业项目的客户，所在的企业项目ID。如果客户购买产品时未选择企业项目，则企业项目ID为0。 企业项目名称 String 开通企业项目的客户，所在的企业项目名称。如果客户购买产品时未选择企业项目，则企业项目名称为default。 使用量类型 String 按需使用云服务时进行计费的方式，如：时长、容量、上行流量等。 使用量 BigDecimal 一定时间范围内产品、资源的使用情况。如使用时长、使用容量、使用次数、使用流量等。 套餐内使用量/预留实例内使用量 String 一定时间范围内某些产品、资源归属于套餐内资源包使用量或者预留实例内资源包使用量，此部分用量没有超出资源包时不再单独收费。 使用量单位 String 产品使用量的度量单位。 官网价总金额 BigDecimal 选择购买的产品和周期后，华为云官网显示的价格。 折扣优惠 BigDecimal 用户使用云服务享受折扣优惠如商务折扣以及促销优惠等减免的金额。基于官网价的优惠金额。 消费金额 BigDecimal 用户使用云服务享受折扣优惠后需要支付的费用金额。折扣包含：促销产品折扣、促销折扣券、商务折扣等各种折扣。 交易时间 String 某条消费记录对应的扣费时间。 表3 资源消费记录参数说明-节省计划Resource_Expenditures(Savings Plans)_YYYYMMDD 字段名称 类型 字段描述 消费时间 String 节省计划产品，计费模式为：节省计划-订购，消费时间为产品的支付时间。 节省计划产品，计费模式为：节省计划-按时计费，消费时间为云服务使用的起止时间段。 资源ID String 云服务资源的唯一标识ID。 资源名称 String 云服务资源的名称。 资源标签 String 用户给云服务资源设置的标签。 供应商 String 当前产品的供应商： 华为云 分销商 计费模式 String 计费模式： 包周期 按需 预留实例 节省计划-订购 节省计划-按时计费 产品类型 String 主要指云服务的分类。 资源类型 String 主要指云服务所使用到的资源分类。 产品 String 云服务的名称。 产品规格 String 用于描述云服务所需资源的特征信息，一组属性和属性值域的集合，同一个资源类型的资源规格所包含的属性相同，但属性取值不同。 云服务区 String 指能独立提供公有云服务资源、并服务于一个较大地理范围的云服务区域。 订单号 String 节省计划计费模式时的订单唯一标识号。 原订单号 String 节省计划计费模式时的退订订单所对应的原订单唯一标识号。 企业项目ID String 开通企业项目的客户，所在的企业项目ID。如果客户购买产品时未选择企业项目，则企业项目ID为0。 企业项目名称 String 开通企业项目的客户，所在的企业项目名称。如果客户购买产品时未选择企业项目，则企业项目名称为default。 订单类型 String 节省计划产品的订单类型： 新购 续费 退订 变更：升配或降配的订单。正常情况下，消费金额为正数，表示升配；消费金额为负数，表示降配。 注：计费模式为“节省计划-按时计费”时，该参数无取值。 购买时长 String 订单购买时长。 计费模式为：节省计划-订购时有值，单位为年。 示例：1 使用量 BigDecimal 一定时间范围内产品、资源的使用情况。如使用时长、使用容量、使用次数、使用流量等。 计费模式为：节省计划-按时计费时有值。 示例：1 使用量单位 String 产品使用量的度量单位。 计费模式为：节省计划-按时计费时有值。 示例：小时 官网价总金额 BigDecimal 选择购买的产品和周期后，华为云官网显示的价格。 折扣优惠 BigDecimal 用户使用云服务享受折扣优惠如商务折扣以及促销优惠等减免的金额。基于官网价的优惠金额。 消费金额 BigDecimal 用户使用云服务享受折扣优惠后需要支付的费用金额。折扣包含：促销产品折扣、促销折扣券、商务折扣等各种折扣。 交易时间 String 某条消费记录对应的扣费时间。

账单内容说明 表1 对账单参数说明-包周期ReconciliationList(Period)_YYYYMM 字段名称 类型 字段描述 账期 String 与用户约定的一个时间范围，这样对账时才能确定对账范围。该时间范围可根据华为云的营销策略来决定，通常是一个自然月。当一个账期结束时，系统计算出用户在该账期内需要支付的全部费用，并生成账单。 消费/退订时间 String 产品的消费或退订时间。包周期产品，消费时间为产品的支付时间。 订单号 String 包年包月计费模式时的订单唯一标识号。 订单类型 String 包周期产品的订单类型： 新购 续费 退订 变更：升配或降配的订单。正常情况下，消费金额为正数，表示升配；消费金额为负数，表示降配。 原订单号 String 包年包月计费模式时的退订订单所对应的原订单唯一标识号。 产品类型 String 主要指云服务的分类。 云服务区 String 指能独立提供公有云服务资源、并服务于一个较大地理范围的云服务区域。 产品 String 云服务的名称。 产品规格 String 用于描述云服务所需资源的特征信息，一组属性和属性值域的集合，同一个资源类型的资源规格所包含的属性相同，但属性取值不同。 计费模式 String 计费模式： 包周期-包天 包周期-包月 包周期-包年 按需 预留实例-零预付 预留实例-全预付 预留实例-部分预付 节省计划-订购 节省计划-按时计费 购买数量 Integer 购买资源的数量。 时长 BigDecimal 包周期产品的购买数量。示例：计费模式为包月，购买数量取值为3，表示购买3个月。 官网价总金额 BigDecimal 选择购买的产品和周期后，华为云官网显示的价格。 消费金额 BigDecimal 用户使用云服务享受折扣优惠后需要支付的费用金额。折扣包含：促销产品折扣、促销折扣券、商务折扣等各种折扣。 现金支付 BigDecimal 通过现金支付费用的金额。 信用额度支付 BigDecimal 通过信用额度支付费用的金额，出账后信用额度支付计入应还款金额。 代金券抵扣 BigDecimal 通过代金券抵扣费用。 备注 String 补充信息。 表2 对账单参数说明-按需ReconciliationList(Pay-per-Use)_YYYYMM 字段名称 类型 字段描述 账期 String 与用户约定的一个时间范围，这样对账时才能确定对账范围。该时间范围可根据华为云的营销策略来决定，通常是一个自然月。当一个账期结束时，系统计算出用户在该账期内需要支付的全部费用，并生成账单。 产品类型 String 主要指云服务的分类。 云服务区 String 指能独立提供公有云服务资源、并服务于一个较大地理范围的云服务区域。 产品 String 云服务的名称。 产品规格 String 用于描述云服务所需资源的特征信息，一组属性和属性值域的集合，同一个资源类型的资源规格所包含的属性相同，但属性取值不同。 计费模式 String 计费模式： 包周期-包天 包周期-包月 包周期-包年 按需 预留实例-零预付 预留实例-全预付 预留实例-半预付 节省计划-订购 节省计划-按时计费 使用量类型 String 按需使用云服务时进行计费的方式，如：时长、容量、上行流量等。 使用量 BigDecimal 一定时间范围内产品、资源的使用情况。如使用时长、使用容量、使用次数、使用流量等。 使用量单位 String 产品使用量的度量单位。 官网价总金额 BigDecimal 选择购买的产品和周期后，华为云官网显示的价格。 消费金额 BigDecimal 用户使用云服务享受折扣优惠后需要支付的费用金额。折扣包含：促销产品折扣、促销折扣券、商务折扣等各种折扣。 现金支付 BigDecimal 通过现金支付费用的金额。 信用额度支付 BigDecimal 通过信用额度支付费用的金额，出账后信用额度支付计入应还款金额。 代金券抵扣 BigDecimal 通过代金券抵扣费用。 备注 String 补充信息。 表3 对账单参数说明-节省计划ReconciliationList(Savings Plans)_YYYYMM 字段名称 类型 字段描述 账期 String 与用户约定的一个时间范围，这样对账时才能确定对账范围。该时间范围可根据华为云的营销策略来决定，通常是一个自然月。当一个账期结束时，系统计算出用户在该账期内需要支付的全部费用，并生成账单。 消费/退订时间 String 产品的消费或退订时间。 节省计划产品，计费模式为：节省计划-订购，消费时间为产品的支付时间。 节省计划产品，计费模式为：节省计划-按时计费，消费时间为云服务使用的起止时间段。 订单号 String 节省计划计费模式时的订单唯一标识号。 订单类型 String 节省计划产品的订单类型： 新购 续费 退订 变更：升配或降配的订单。正常情况下，消费金额为正数，表示升配；消费金额为负数，表示降配。 注：计费模式为：节省计划-按时计费时该参数无取值。 原订单号 String 节省计划计费模式时的退订订单所对应的原订单唯一标识号。 产品类型 String 主要指云服务的分类。 云服务区 String 指能独立提供公有云服务资源、并服务于一个较大地理范围的云服务区域。 产品 String 云服务的名称。 产品规格 String 用于描述云服务所需资源的特征信息，一组属性和属性值域的集合，同一个资源类型的资源规格所包含的属性相同，但属性取值不同。 计费模式 String 计费模式，： 包周期-包天 包周期-包月 包周期-包年 按需 预留实例-零预付 预留实例-全预付 预留实例-半预付 节省计划-订购 节省计划-按时计费 购买数量 Integer 购买资源的数量。 时长 BigDecimal 订单购买时长。 计费模式为：节省计划-订购时有值，单位为年。 示例：1。 使用量 BigDecimal 一定时间范围内产品、资源的使用情况。如使用时长、使用容量、使用次数、使用流量等。 计费模式为：节省计划-按时计费时有值。 示例：1 使用量单位 String 产品使用量的度量单位。 计费模式为：节省计划-按时计费时有值。 示例：小时 官网价总金额 BigDecimal 选择购买的产品和周期后，华为云官网显示的价格。 消费金额 BigDecimal 用户使用云服务享受折扣优惠后需要支付的费用金额。折扣包含：促销产品折扣、促销折扣券、商务折扣等各种折扣。 现金支付 BigDecimal 通过现金支付费用的金额。 信用额度支付 BigDecimal 通过信用额度支付费用的金额，出账后信用额度支付计入应还款金额。 代金券抵扣 BigDecimal 通过代金券抵扣费用。 备注 String 补充信息。