华为云用户手册

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 参数说明：用户Token。通过调用 IAM 服务 获取IAM用户Token接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见 Token认证。 Instance-Id 否 String 参数说明：实例ID。物理多租下各实例的唯一标识，建议携带该参数，在使用专业版时必须携带该参数。您可以在IoTDA管理控制台界面，选择左侧导航栏“总览”页签查看当前实例的ID，具体获取方式请参考查看实例详情 。

相关API列表 开放接口 接口定义链接 查询订单列表 https://support.huaweicloud.com/api-oce/api_order_00013.html 查询订单详情 https://support.huaweicloud.com/api-oce/api_order_00014.html 查询订单可用优惠券 https://support.huaweicloud.com/api-oce/api_order_00015.html 查询订单可用折扣 https://support.huaweicloud.com/api-oce/api_order_00025.html 支付包年/包月产品订单 https://support.huaweicloud.com/api-oce/api_order_00030.html 取消待支付订单 https://support.huaweicloud.com/api-oce/api_order_00017.html 查询退款订单的金额详情 https://support.huaweicloud.com/api-oce/api_order_00020.html

相关API列表 开放接口 接口定义链接 查询资源包列表 https://support.huaweicloud.com/api-oce/api_order_00027.html 查询资源包使用量 https://support.huaweicloud.com/api-oce/api_order_00028.html 查询资源包使用明细 https://support.huaweicloud.com/api-oce/api_order_00029.html

华为云环境地址 环境 说明 地址 IAM登录服务地址 IAM提供给合作伙伴的供合作伙伴销售平台在开通或关联华为云账号时进行页面跳转的地址，非IAM提供的API访问路径（Endpoint）。 https://auth.huaweicloud.com/ SP Metadata.xml文件的获取地址 合作伙伴需要将SP Metadata.xml上传到合作伙伴销售平台的IDP服务器上，使用SP Metadata.xml文件中的公钥验证从华为云收到的消息，建立与IAM的信任关系。 https://auth.huaweicloud.com/authui/saml/metadata.xml?unsigned=true 其中，unsigned参数为可选字段，表示是否对报文内容进行签名。签名校验可以防止Metadata内容被篡改。 带有unsigned参数且值为true时，获取到的metadata内容中没有签名信息。 不带有unsigned参数，或参数值不为true时，metadata内容中会包含签名信息，则可以进行签名校验。 说明： 地址打开可以直接看到metadata.xml的内容，按ctrl+s保存即可。 BSS请求地址 BSS提供的合作伙伴运营能力接口的访问路径（Endpoint）。 合作伙伴通过拼接该地址和具体接口的URI访问具体接口。 https://bss.myhuaweicloud.com 说明： 该Endpoint为全局Endpoint，中国站所有区域均可使用。 合作伙伴中心 华为云提供给合作伙伴的运营管理界面。 https://account.huaweicloud.com/obmgr/#/obmgr/index 账号中心 华为云提供给普通客户（非合作伙伴）查看账号基本信息、用户认证、首选项设置、查看我的特权与推荐的运营管理界面。 https://account.huaweicloud.com/usercenter/#/accountindex/accountInfo 费用中心 华为云提供给普通客户（非合作伙伴）充值、续费、查看订单、查看财务信息、查看优惠券与折扣、申请合同、开具发票、退订与变更的运营管理界面。 https://account.huaweicloud.com/usercenter 控制台 华为云普通客户（非合作伙伴）可以登录华为云管理控制台，对华为云各服务进行查看、购买、使用等操作。 https://console.huaweicloud.com/console/ 父主题： 附录

相关API列表 开放接口 接口定义链接 查询优惠券列表 http://support.huaweicloud.com/api-bpconsole/mp_02001.html 查询优惠券额度 https://support.huaweicloud.com/api-bpconsole/zh-cn_topic_0091566753.html 发放优惠券 http://support.huaweicloud.com/api-bpconsole/mp_02002.html 查询已发放的优惠券 http://support.huaweicloud.com/api-bpconsole/mp_02005.html 回收优惠券 http://support.huaweicloud.com/api-bpconsole/mp_02004.html 查询优惠券发放回收记录 http://support.huaweicloud.com/api-bpconsole/mp_02006.html

相关API列表 开放接口 接口定义链接 查询订单列表 https://support.huaweicloud.com/api-bpconsole/api_order_00013.html 查询订单详情 https://support.huaweicloud.com/api-bpconsole/api_order_00014.html 查询订单可用优惠券 支付包年/包月产品订单 https://support.huaweicloud.com/api-bpconsole/api_order_00030.html 取消待支付订单 https://support.huaweicloud.com/api-bpconsole/api_order_00017.html 查询退款订单的金额详情 https://support.huaweicloud.com/api-bpconsole/api_order_00020.html

相关API列表 开放接口 接口定义链接 查询资源包列表 https://support.huaweicloud.com/api-bpconsole/api_order_00027.html 查询资源包使用量 https://support.huaweicloud.com/api-bpconsole/api_order_00028.html 查询资源包使用明细 https://support.huaweicloud.com/api-bpconsole/api_order_00029.html

创建桶 如果合作伙伴的客户购买中国站的产品，需要实名认证，过程中需要把客户的实名认证附件上传给华为云审核，此时伙伴需创建桶用于存放伙伴上传的实名认证附件。 您可以通过OBS（Object Storage Service，即 对象存储服务 ）管理控制台创建桶。桶是OBS中存储对象的容器。您需要先创建一个桶，然后才能在OBS中存储数据。如何创建桶请参见创建桶。 因合作伙伴账号无法购买资源，创建桶时请使用普通华为云账号登录后创建桶。 如果伙伴想更换桶，需要先进入修改配置页面，关闭实名认证附件上传开关和取消所有文件订阅，然后再修改配置页面增加新桶的配置。 不同的伙伴不能共用同一个桶。 仅支持使用在华为云中国站点购买的OBS桶。 创建桶时请勿开启默认加密。若勾选开启，上传到桶中的对象都会被加密，KMS密钥会默认选中“obs/default”，桶内存储文件将无法下载。 父主题： 附录

Web UI 客户可在费用中心退订已购买的包年/包月资源。 进入“退订管理”页面。 开通了企业组织多级管理服务的客户可以在“退订管理”的下拉选项框中筛选该客户下各个子组织的名称，查询各子组织的可退订记录。 单击“创建成功资源退订”页签。 单个资源退订与批量退订可使用不同的操作方式： 退订单个资源：单击待退订资源所在行的“退订资源”。 批量退订：在退订列表中勾选需要退订的资源，单击列表左上角的“退订资源”。 查看退订信息，退订资源。 5天无理由全额退订：确认退订信息，单击“退订”。 非5天无理由退订：勾选“我已确认本次退订将收取手续费”后，单击“退订”。

REST API 客户在伙伴销售平台完成包年/包月资源的退订。 首先要成功支付包年/包月产品，产生一条开通成功的包年/包月资源，才能进行退订。 该接口只允许使用客户AK/SK或者Token调用，不允许使用合作伙伴AK/SK或者Token调用。因为目前合作伙伴不能自己买产品，所以没有自己的包年/包月产品。 调用接口后，如果某个主资源ID有对应的从资源ID，系统会将主资源ID和从资源ID一起退订，存在主从资源关系的资源为： 云主机为主资源，对应的从资源为云硬盘 共享带宽的情况下，带宽为主资源，对应的从资源为弹性IP（可能包含多个IP） 独享带宽的情况下，弹性IP为主资源，对应的从资源为带宽 调用该接口后，您还可以调用“查询退款订单的金额详情”接口查询退订订单对应的金额来自哪些订单。 该接口支持5天无理由全额退订，具体规则请参见“退订规则说明”。

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

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

响应消息 响应参数 参数 参数类型 描述 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 } }

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 500 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 抱歉，当前订单号不能操作，请使用组合交易单号操作。

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

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 描述 400 CBC.0100 参数错误。 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.99003652 软开云套餐不能退订。 400 CBC.99003654 存在带宽加油包，不允许退订续费周期。 400 CBC.99003656 已冻结，不能执行此操作。 400 CBC.99006066 查询费用信息错误。 403 CBC.0151 访问拒绝。 400 CBC.99003651 交易正在进行中，不可以退订。 500 CBC.0999 其他错误。

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

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

请求消息 请求参数 无。 请求示例 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 最大长度：20 查询的资源消费记录的开始日期，格式为YYYY-MM-DD。 此参数不携带或携带值为空或携带值为空串时，默认值取cycle月份的第一天。 说明： 必须和cycle（即资源的消费账期）在同一个月。 bill_date_end 否 String 最大长度：20 查询的资源消费记录的结束日期，格式为YYYY-MM-DD。 此参数不携带或携带值为空或携带值为空串时，默认值取cycle月份的最后一天。 说明： 必须和cycle（即资源的消费账期）在同一个月。 bill_date_begin和bill_date_end两个参数必须同时出现，否则仅按照cycle（即资源的消费账期）进行查询。

功能介绍 伙伴在销售平台按照条件查询按需产品的价格。 如果购买该产品的租户享受折扣，可以在查询结果中返回折扣金额以及扣除折扣后的最后成交价。 如果该租户享受多种折扣，系统会优先返回客户享受的商务折扣的折扣金额和最终成交价。 华为云根据云服务类型、资源类型、云服务区和资源规格四个条件来查询产品，查询时请确认这4个查询条件均输入正确，否则该接口会返回无法找到产品的错误。 如果只是临时查询产品价格，可以到价格计算器查询。 询价Api入参参数product_infos取值可以参考价格计算器查询入参，详情见按需询价示例。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 400 CBC.99006006 产品未发现。 400 CBC.99006050 使用量单位错误。 400 CBC.99006055 询价结果超过金额最大限制。 400 CBC.99006074 计费因子不存在。 403 CBC.0151 拒绝访问。 500 CBC.0999 其他错误。

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

URI GET /v2/promotions/benefits/coupons 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 coupon_id 否 String 最大长度：64 优惠券ID。 此参数不携带或携带值为空时，不作为筛选条件。 order_id 否 String 最大长度：64 订单ID。 此参数不携带或携带值为空时，不作为筛选条件。 promotion_plan_id 否 String 最大长度：64 促销计划ID。 此参数不携带或携带值为空时，不作为筛选条件。 coupon_type 否 Integer [1-4] 优惠券类型： 1：代金券 此参数不携带或携带值为空或携带值为null时，不作为筛选条件；不支持携带值为空串。 status 否 Integer [1-5] 客户优惠券实例状态： 1：未激活 2：待使用 3：已使用 4：已过期 5：已回收 此参数不携带或携带值为空时，不作为筛选条件。 说明： 已使用、已过期和已回收优惠券，只返回12个月以内的数据。 active_start_time 否 String 最大长度：64 激活时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。 此参数不携带或携带值为空时，不作为筛选条件；不支持携带值为空串或携带值为null。 active_end_time 否 String 最大长度：64 结束时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。 此参数不携带或携带值为空时，不作为筛选条件；不支持携带值为空串或携带值为null。 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。 source_id 否 String 最大长度：255 发券来源，如果是合作伙伴发送的券，此处为伙伴ID。 如果需要查询某个伙伴发放的券，可以在此处输入该伙伴ID。 此参数不携带或携带值为空或携带值为null时，不作为筛选条件；携带值为空串时，作为筛选条件。 indirect_partner_id 否 String 最大长度：64 云经销商（二级经销商）ID。 华为云总经销商（一级经销商）查询云经销商名下的优惠券时，需要携带该参数；除此之外，此参数不做处理。否则只能查询自己的优惠券列表。

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

请求消息 请求参数 无。 请求示例 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

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调用时接口不会报错，但查询不到数据。 该接口只能查询开通成功的资源。 成功调用本接口后，如果您需要对已生效状态的资源进行续订，您可以调用“查询包年/包月产品价格”接口对查询到的包年/包月资源进行续订询价，然后再调用“续订包年/包月资源（旧）”接口进行续订。 该接口即将下线，“查询客户包年/包月资源列表”接口请参考查询客户包年/包月资源列表。

请求消息头 可选的附加请求头字段，如指定的URI和HTTP方法所要求的字段。详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 bss.myhuaweicloud.com or bss.myhuaweicloud.com:443 Content-Type 发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。 是 application/json Content-Length 请求body长度，单位为Byte。 否 3495 X-Auth-Token 用户Token。 获取Token ，请参考Token认证。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段MIIPAgYJKoZIhvcNAQcCoIIO8zCCDu8CAQExDTALBglghkgBZQMEAgEwgg1QBgkqhkiG9w0BBwGggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于创建客户接口，添加消息头后的请求如下所示。 POST https://bss.myhuaweicloud.com/v2/partners/sub-customers Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于创建客户接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，请求参数的取值需要根据实际情况填写。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 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": "189xxxxxxxx", "verification_code": "253xxx", "xaccount_id": "35reyxxxx", "xaccount_type": "xxx_IDP", "password": "xxxxxxx", "is_close_market_ms": "true", "cooperation_type": "1", "indirect_partner_id": "a0d736359ada40aab6502d1a828c1809" } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。