华为云用户手册

URI GET /v2/systems/configs/provinces 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 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。

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：代金券 2：折扣券 4：现金券 此参数不携带或携带值为空或携带值为null时，不作为筛选条件；不支持携带值为空串。 status 否 Integer [1-5] 客户优惠券实例状态： 2：待使用 3：已使用 4：已过期 5：已回收 此参数不携带或携带值为空时，不作为筛选条件。 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时，不作为筛选条件；携带值为空串时，作为筛选条件。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 400 CBC.18000014 未开通成本中心。 403 CBC.0151 访问拒绝。 500 CBC.0999 未知错误。 400 CBC.18000048 您名下的财务独立子，超过系统可支持查询的数量，请指定企业子账号查询。 说明： 企业主调用查询所有企业子时，最大支持1000个财务独立企业子数量查询，超出需要指定企业子账号查询。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/costs/cost-analysed-bills/monthly-breakdown?shared_month=2020-02&charging_mode=1&service_type_code=hws.service.type.ec2&resource_type_code=hws.resource.type.vm®ion_code=cn-east-2&bill_type=2&offset=0&limit=10&resource_id=c8d5f0c83&resource_name=_node_core_UfqMv&enterprise_project_id=430A093D231C423BBD215DCDD6842319&method=all&sub_customer_id=07fe2821e4802f8d0f26c0129657a4a0 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

URI GET /v2/costs/cost-analysed-bills/monthly-breakdown URL参数说明请参见下表。 表1 消息头参数 参数 是否必选 参数类型 取值范围 描述 X-Language 否 String 最大长度：10 语言。 zh_CN：中文 en_US：英文 缺省为zh_CN。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 shared_month 是 String 最大长度：10 查询分摊成本的月份，东八区时间，格式：YYYY-MM。 charging_mode 否 Integer [1-11] 计费模式。 1：包年/包月 3：按需 10：预留实例 11：节省计划 此参数不携带或携带值为空时，不作为筛选条件。 service_type_code 否 String 最大长度：64 云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空时，不作为筛选条件；携带值为空串时，作为筛选条件。 resource_type_code 否 String 最大长度：64 资源类型编码，例如E CS 的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。 此参数不携带或携带值为空时，不作为筛选条件；携带值为空串时，作为筛选条件。 region_code 否 String 最大长度：64 云服务区编码，例如：“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 此参数不携带或携带值为空时，不作为筛选条件。 bill_type 否 Integer - 账单类型。 1：消费-新购 2：消费-续订 3：消费-变更 4：退款-退订 5：消费-使用 8：消费-自动续订 9：调账-补偿 14：消费-服务支持计划月末扣费 16：调账-扣费 18：消费-按月付费 20：退款-变更 23：消费-节省计划抵扣 24：退款-包年/包月转按需 此参数不携带或携带值为空时，不作为筛选条件。 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 最大长度：256 资源ID。 此参数不携带或携带值为空时，不作为筛选条件。 resource_name 否 String 最大长度：256 资源名称。 此参数不携带或携带值为空时，不作为筛选条件。 enterprise_project_id 否 String 最大长度：64 企业项目标识（企业项目ID）。 default项目对应ID：0 未归集（表示该云服务不支持企业项目管理能力）项目对应ID：-1或null 其余项目对应ID获取方法请参见如何获取企业项目ID。 此参数不携带或携带值为空时，不作为筛选条件。 method 否 String 最大长度：64 查询资源消费记录的方式。 oneself：客户自己 sub_customer：企业子客户 all：客户自己和企业子客户 默认为all，如果没有企业子客户，取值为all时查询的是客户自己的资源消费记录。 此参数不携带，不作为筛选条件。 sub_customer_id 否 String 最大长度：64 企业子账号ID。 此参数不携带或携带值为空或携带值为空串时，不作为筛选条件。 说明： 如果method取值不为sub_customer，则该参数无效。 如果method取值为sub_customer，则该参数不能为空。

URI GET /v2/bills/customer-bills/monthly-sum 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 bill_cycle 是 String 最大长度：8 查询消费汇总数据所在的账期，东八区时间，格式为YYYY-MM。 service_type_code 否 String 最大长度：64 云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空时，不作为筛选条件。 enterprise_project_id 否 String 最大长度：64 企业项目标识（企业项目ID）。 default项目对应ID：0 未归集（表示该云服务不支持企业项目管理能力）项目对应ID：-1 其余项目对应ID获取方法请参见如何获取企业项目ID。 此参数不携带或携带值为空时，不作为筛选条件。携带值为null时，作为筛选条件。不支持携带值为空串。 method 否 String 最大长度：64 查询方式。 oneself：自身 sub_customer：企业子客户 all：自己和企业子客户 此参数不携带或携带值为空时，默认值为“all”，如果没有企业子客户，all的时候也是查询客户自己的数据。 说明： 若需要查询财务独立企业子的账单信息，前提是子账号已经接受了企业主账号的“允许查看子账号消费信息”的申请。申请方法见“变更子账号权限”。 sub_customer_id 否 String 最大长度：64 企业子客户的账号ID。 说明： 如果method取值不为sub_customer，则该参数无效。 如果method取值为sub_customer，则该参数不能为空。 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。

请求消息 请求参数 无 请求示例 GET https://bss.myhuaweicloud.com/v2/bills/customer-bills/fee-records?bill_cycle=2020-08&offset=0&limit=10&provider_type=1&service_type_code=hws.service.type.obs&resource_type_code=hws.resource.type.obs®ion_code=cn-north-1&charging_mode=3&bill_type=1&trade_id=CS1908201442ZLEPW476&enterprise_project_id=0&include_zero_record=true&status=1&method=oneself&bill_date_begin=2020-09-01&bill_date_end=2020-09-30 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

URI GET /v2/bills/customer-bills/fee-records 表1 消息头参数 参数 是否必选 参数类型 取值范围 描述 X-Language 否 String 最大长度：10 语言。 en_US：英文 zh_CN：中文 默认为zh_CN：中文。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 bill_cycle 是 String 最大长度：8 查询的流水账单所在账期，东八区时间，格式为YYYY-MM。 provider_type 否 Integer [1-2] 服务商。 1：华为云 2：云商店 为空时查询包含华为云和云商店在内的全部服务商。 此参数不携带或携带值为空时，不作为筛选条件。 service_type_code 否 String 最大长度：64 云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空时，不作为筛选条件。 resource_type_code 否 String 最大长度：64 资源类型编码，例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。 此参数不携带或携带值为空时，不作为筛选条件。 region_code 否 String 最大长度：64 云服务区编码，例如：“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 此参数不携带或携带值为空时，不作为筛选条件。 charging_mode 否 Integer - 计费模式： 1 : 包年/包月 3：按需 10：预留实例 11：节省计划 此参数不携带或携带值为空时，不作为筛选条件。 bill_type 否 Integer - 账单类型： 1：消费-新购 2：消费-续订 3：消费-变更 4：退款-退订 5：消费-使用 8：消费-自动续订 9：调账-补偿 14：消费-服务支持计划月末扣费 16：调账-扣费 18：消费-按月付费 20：退款-变更 23：消费-节省计划抵扣 24：退款-包年/包月转按需 此参数不携带或携带值为空时，不作为筛选条件。 trade_id 否 String 最大长度：64 订单ID或交易ID。 账单类型为1、2、3、4和8时此处为订单ID。 账单类型为其它场景时此处为交易ID，为扣费维度的唯一标识。 例如非月末扣费时为应收ID；月末扣费时为账单ID。 此参数不携带或携带值为空时，不作为筛选条件。 enterprise_project_id 否 String 最大长度：64 企业项目标识（企业项目ID）。 default项目对应ID：0 未归集（表示该云服务不支持企业项目管理能力）项目对应ID：-1 其余项目对应ID获取方法请参见如何获取企业项目ID。 此参数不携带或携带值为空或携带值为null时，不作为筛选条件；不支持携带值为空串。 include_zero_record 否 Boolean - 返回是否包含应付金额为0的记录。 true：包含 false：不包含 默认为true：包含。 此参数不携带或携带值为空时，不作为筛选条件。 status 否 Integer - 支付状态。 1：已支付 2：未结清 3：未出账 此参数不携带或携带值为空时，不作为筛选条件。 method 否 String 最大长度：64 查询流水账单的方式。 oneself：客户自己 sub_customer：企业子客户 all：客户自己和企业子客户 此参数不携带或携带值为空时，默认值为“all”，如果没有企业子客户，取值为all时查询的是客户自己的流水账单。 说明： 若需要查询财务独立企业子的账单信息，前提是子账号已经接受了企业主账号的“允许查看子账号消费信息”的申请。申请方法见“变更子账号权限”。 sub_customer_id 否 String 最大长度：64 企业子账号ID。 说明： 如果method取值不为sub_customer，则该参数无效。 如果method取值为sub_customer，则该参数不能为空。 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。 bill_date_begin 否 String 最大长度：20 查询的流水账单的开始日期，东八区时间，格式为YYYY-MM-DD。 此参数不携带或携带值为空时，不作为筛选条件。 说明： 必须和bill_cycle（即流水账单的所在账期）在同一个月。 bill_date_begin和bill_date_end两个参数必须同时出现，否则仅按照bill_cycle（即流水账单的所在账期）进行查询。 bill_date_end 否 String 最大长度：20 查询的流水账单的结束日期，东八区时间，格式为YYYY-MM-DD。 此参数不携带或携带值为空时，不作为筛选条件。 说明： 必须和bill_cycle（即流水账单的所在账期）在同一个月。 bill_date_begin和bill_date_end两个参数必须同时出现，否则仅按照bill_cycle（即流水账单的所在账期）进行查询。

URI GET /v1.0/{domain_id}/customer/account-mgr/bill/res-records URL参数说明请参见下表。 表1 路径参数 参数 是否必选 取值范围 描述 domain_id 是 最大长度：64 客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 cycle 是 String 最大长度：8 消费月份，格式为YYYY-MM。 例如2020-01。 cloudServiceTypeCode 否 String 最大长度：64 云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 resourceTypeCode 否 String 最大长度：64 资源类型编码，例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。 此参数不携带或携带值为空，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 regionCode 否 String 最大长度：64 云服务区编码，例如：“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 此参数不携带或携带值为空，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 resInstanceId 否 String 最大长度：256 资源实例ID。 此参数不携带或携带值为空，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 payMethod 是 String 最大长度：4 支付方式： 0：包年/包月 1：按需 10：预留实例 enterpriseProjectId 否 String 最大长度：64 企业项目标识（企业项目ID）。 default项目对应ID：0 未归集（表示该云服务不支持企业项目管理能力）项目对应ID：-1 其余项目对应ID获取方法请参见如何获取企业项目ID。 此参数不携带或携带值为空，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 offset 是 Integer [1-最大整数] 页码。 limit 是 Integer [1-1000] 页面大小。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/account-mgr/bill/res-records?cycle=2019-06&payMethod=0&offset=1&limit=10 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

功能介绍 客户在自建平台查询自己的资源详单，用于反映各类资源的消耗情况。 注意事项： 该接口只允许使用客户AK/SK或者Token调用。 由于资源消费呈现的是资源维度的8位小数原始消费金额，实际从账户扣费时按2位小数进行扣费（即扣到分），会存在精度差异，所以，不推荐消费汇总和资源消费直接对账。 该接口即将下线，“查询资源详单”新接口请参考查询资源详单。 客户账号切换成为财务托管子之后，调用API查询到的账单，包含切换为财务托管子后产生的账单和切换财务托管子之前的账单。 支持查看近3年内的数据。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/bills/customer-bills/res-fee-records?cycle=2020-09&charge_mode=1&method=sub_customer&sub_customer_id=05b5fef62300d2ad0f98c00befba72c0&trade_id= CS1908201442ZLEPW476&bill_date_begin=2020-09-01&bill_date_end=2020-09-30&statistic_type=1 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

URI GET /v2/bills/customer-bills/res-fee-records URL参数说明请参见下表。 表1 消息头参数 参数 是否必选 参数类型 取值范围 描述 X-Language 否 String 最大长度：10 语言。 en_US：英文 zh_CN：中文 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 cycle 是 String 最大长度：10 查询的资源消费记录所在账期，东八区时间，格式：YYYY-MM。 charge_mode 否 String 最大长度：4 计费模式。 1：包年/包月 3：按需 10：预留实例 11：节省计划 此参数不携带时，不作为筛选条件；不支持携带值为空或携带值为空串或携带值为null。 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：调账-补偿 12：消费-按时计费 13：消费-退订手续费 14：消费-服务支持计划月末扣费 16：调账-扣费 18：消费-按月付费 20：退款-变更 23：消费-节省计划抵扣 24：退款-包年/包月转按需 此参数不携带或携带值为空时，不作为筛选条件。 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。 此参数不携带时，不作为筛选条件；携带值为空或携带值为空串时，作为筛选条件。 enterprise_project_id 否 String 最大长度：64 企业项目标识（企业项目ID）。 default项目对应ID：0 未归集（表示该云服务不支持企业项目管理能力）项目对应ID：-1 其余项目对应ID获取方法请参见如何获取企业项目ID。 此参数不携带或携带值为空或携带值为空串或携带值为null时，不作为筛选条件。 include_zero_record 否 Boolean - 返回是否包含应付金额为0的记录。 true：包含 false：不包含 此参数不携带或携带值为空时，不作为筛选条件。 method 否 String 最大长度：64 查询资源消费记录的方式。 oneself：客户自己 sub_customer：企业子客户 all：客户自己和企业子客户 此参数不携带或携带值为空时，默认值为“all”，如果没有企业子客户，取值为all时查询的是客户自己的资源消费记录。 说明： 若需要查询财务独立企业子的账单信息，前提是子账号已经接受了企业主账号的“允许查看子账号消费信息”的申请。申请方法见“变更子账号权限”。 sub_customer_id 否 String 最大长度：64 企业子账号ID。 此参数携带值为空串时，不作为筛选条件。 说明： 如果method取值不为sub_customer，则该参数无效。 如果method取值为sub_customer，则该参数不能为空。 trade_id 否 String 最大长度：64 订单ID或交易ID。 账单类型为1、2、3、4和8时此处为订单ID。 账单类型为其它场景时此处为交易ID，为扣费维度的唯一标识。 例如非月末扣费时为应收ID；月末扣费时为账单ID。 此参数不携带时，不作为筛选条件；携带值为空或携带值为空串时，作为筛选条件。 说明： 按账期类型统计时字段不生效。 bill_date_begin 否 String 最大长度：10 查询的资源消费记录的开始日期，东八区时间，格式为YYYY-MM-DD。 此参数不携带或携带值为空或携带值为空串时，默认值取cycle月份的第一天。 说明： 必须和cycle（即资源的消费账期）在同一个月。 bill_date_begin和bill_date_end两个参数必须同时出现，否则仅按照cycle（即资源的消费账期）进行查询。 按账期类型统计时字段不生效。 bill_date_end 否 String 最大长度：10 查询的资源消费记录的结束日期，东八区时间，格式为YYYY-MM-DD。 此参数不携带或携带值为空或携带值为空串时，默认值取cycle月份的最后一天。 说明： 必须和cycle（即资源的消费账期）在同一个月。 bill_date_begin和bill_date_end两个参数必须同时出现，否则仅按照cycle（即资源的消费账期）进行查询。 按账期类型统计时字段不生效。 statistic_type 否 Integer - 统计类型。默认值为3。 1：按账期 3：按明细 该参数不携带或携带值为空时，取默认值3。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 cycle 是 String 最大长度：8 查询的资源详单所在账期，东八区时间，格式为YYYY-MM。 示例：2019-01。 cloud_service_type 否 String 最大长度：64 云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 resource_type 否 String 最大长度：64 资源类型编码，例如ECS的VM为“hws.resource.type.vm”。您可以调用查询资源类型列表接口获取。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 region 否 String 最大长度：64 云服务区编码，例如：“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 res_instance_id 否 String 最大长度：64 资源实例ID。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 charge_mode 否 Integer - 计费模式。 1 : 包年/包月 3：按需 10：预留实例 11：节省计划 此参数不携带或者携带值为null时，返回所有计费模式的资源详单数据记录。 bill_type 否 Integer - 账单类型： 1：消费-新购 2：消费-续订 3：消费-变更 4：退款-退订 5：消费-使用 8：消费-自动续订 9：调账-补偿 14：消费-服务支持计划月末扣费 16：调账-扣费 18：消费-按月付费 20：退款-变更 23：消费-节省计划抵扣 24：退款-包年/包月转按需 此参数不携带或者携带值为null时，返回所有账单类型的资源详单数据记录。 enterprise_project_id 否 String 最大长度：64 企业项目标识（企业项目ID）。 default项目对应ID：0 未归集（表示该云服务不支持企业项目管理能力）项目对应ID：-1 其余项目对应ID获取方法请参见如何获取企业项目ID。 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 include_zero_record 否 Boolean - 返回是否包含应付金额为0的记录。 true: 包含 false: 不包含 此参数不携带或携带值为空串或携带值为null时，不作为筛选条件。 method 否 String 最大长度：64 查询方式。 oneself：客户自己 sub_customer：企业子客户 all：客户自己和企业子客户 此参数不携带或携带值为空串或携带值为null时，默认值为“all”，如果没有企业子客户，all的时候也是查询客户自己的数据。 说明： 若需要查询财务独立企业子的账单信息，前提是子账号已经接受了企业主账号的“允许查看子账号消费信息”的申请。申请方法见“变更子账号权限”。 sub_customer_id 否 String 最大长度：64 企业子账号ID。 说明： 如果method取值不为sub_customer，则此参数无效。 如果method取值为sub_customer，则此参数不能为空。 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。 statistic_type 否 Integer [1-3] 统计类型。默认值为1。 1：按账期 2：按天 3：按明细 该参数不携带或携带值为null时，取默认值1；不支持携带为空串。 query_type 否 String [0-9] 查询类型。默认值为BILLCYCLE。 BILLCYCLE：按账期 DAILY：按天 仅当statistic_type=2或3时，支持传递query_type=DAILY。 该参数不携带或携带值为null或携带为空串时，取默认值BILLCYCLE。 bill_cycle_begin 否 String [0-10] 账期开始时间。格式为YYYY-MM-DD。 仅当query_type=DAILY时，必须传递账期开始时间。 该参数不携带或携带值为null或携带为空串时，不作为筛选条件。 说明： 如果query_type取值不为DAILY，则该参数无效。 如果query_type取值为DAILY，则该参数不能为空，必须和cycle（即资源详单所在账期）在同一个月。 bill_cycle_end 否 String [0-10] 账期结束时间。格式为YYYY-MM-DD。 仅当query_type=DAILY时，必须传递账期结束时间。 该参数不携带或携带值为null或携带为空串时，不作为筛选条件。 说明： 如果query_type取值不为DAILY，则该参数无效。 如果query_type取值为DAILY，则该参数不能为空，必须和cycle（即资源详单所在账期）在同一个月。 payer_account_id 否 String [1-64] 支付账号ID。 该参数不携带或携带值为null时，不作为筛选条件，同时该参数不支持为空串。 说明： 普通客户、财务独立企业子客户查询消费记录，只能查询到客户自己的消费记录，该参数不携带或携带为自身ID时，查询的都只是自身的消费记录； 企业主客户查询消费记录，不携带时，查询的是自身的、财务托管企业子、财务独立企业子的消费记录；入参自身ID时，查询的是自身的、财务托管企业子的消费记录；也可入参其名下财务独立企业子的客户ID，只查询该财务独立企业子的消费记录； 财务托管企业子查询消费记录，入参自身ID时，查询的是未与企业主关联时的消费记录；入参企业主客户ID时，查询的是与企业主关联后的消费记录；不携带时查询以上全部消费记录。 请求示例 POST https://bss.myhuaweicloud.com/v2/bills/customer-bills/res-records/query HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ X-Language:zh_CN { "cycle": "2018-12", "cloud_service_type": "hws.service.type.ec2", "resource_type": "hws.resource.type.vm", "region": "cn-north-1", "res_instance_id": "76*****7f", "charge_mode": 1, "bill_type": 1, "enterprise_project_id": "6***f3-3**4-4**2-9a3e-a****c24", "include_zero_record": "true", "method": "sub_customer", "sub_customer_id": "05b5fef62300d2ad0f98c00befba72c0", "offset": 1, "limit": 10 }

功能介绍 客户在自建平台查询自己的资源详单，用于反映各类资源的消耗情况。 客户登录费用中心查询资源详单请参见这里。 由于资源消费呈现的是资源维度的8位小数原始消费金额，实际从账户扣费时按2位小数进行扣费（即扣到分），会存在精度差异，所以，不推荐消费汇总和资源消费直接对账。 若需要查询财务独立企业子的账单信息，前提是子账号已经接受了企业主账号的“允许查看子账号消费信息”的申请。申请方法见“变更子账号权限”。 客户账号切换成为财务托管子之后，调用API查询到的账单，包含切换为财务托管子后产生的账单和切换财务托管子之前的账单。 支持查看近3年的数据。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/account-mgr/bill/res-fee-records?startTime=2019-08-01&endTime=2019-08-31&payMethod=0&cloudServiceTypeCode=hws.service.type.ebs®ionCode=cn-north-1&orderId=orderId&offset=1&limit=10&resourceId=hws.service.type.ebs&enterpriseProjectId=pjzV4N9Uq1LWMUgh3fYAhJqUbtd6Ad8yALoRJeDoYGl0jWdZoS8UHbcGBqEin1Ia HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

URI GET /v1.0/{domain_id}/customer/account-mgr/bill/res-fee-records URL参数说明请参见下表。 表1 路径参数 参数 是否必选 取值范围 描述 domain_id 是 最大长度：64 客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 startTime 是 String 最大长度：10 开始时间，格式：yyyy-MM-dd。 说明： 开始时间和结束时间只能在同一月份内，不支持跨月份查询资源消费记录。 endTime 是 String 最大长度：10 结束时间，格式：yyyy-MM-dd。 说明： 开始时间和结束时间只能在同一月份内，不支持跨月份查询资源消费记录。 cloudServiceTypeCode 否 String 最大长度：256 云服务类型编码，例如OBS的云服务类型编码为“hws.service.type.obs”。您可以调用查询云服务类型列表接口获取。 此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 regionCode 否 String 最大长度：64 云服务区编码，例如：“cn-north-1”。具体请参见地区和终端节点对应云服务的“区域”列的值。 此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 orderId 否 String 最大长度：64 订单ID。 此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 payMethod 是 String 最大长度：4 支付方式： 0：包年/包月； 1：按需。 offset 否 Integer [1-最大整数] 页码。 此参数不携带时，取值为1；不支持携带值为空或携带值为空串或携带值为null。 limit 否 Integer [1-100] 每页条目数。 此参数不携带时，取值为10；不支持携带值为空或携带值为空串或携带值为null。 resourceId 否 String 最大长度：256 资源ID。 此参数不携带或携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。 enterpriseProjectId 否 String 最大长度：64 企业项目标识（企业项目ID）。 default项目对应ID：0 未归集（表示该云服务不支持企业项目管理能力）项目对应ID：-1 其余项目对应ID获取方法请参见如何获取企业项目ID。 此参数不携带时，不作为筛选条件；携带值为null时，作为筛选条件；不支持携带值为空串。

请求消息 请求参数 无 请求示例 GET https://bss.myhuaweicloud.com/v2/accounts/customer-accounts/account-change-records?balance_type=BALANCE_TYPE_DEBIT&trade_type=RECHARGE&trade_time_begin=2020-10-20&trade_time_end=2021-10-20&offset=0&limit=10 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

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

URI GET /v2/accounts/customer-accounts/account-change-records 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 balance_type 是 String [BALANCE_TYPE_DEBIT|BALANCE_TYPE_CREDIT] 账户类型。 BALANCE_TYPE_DEBIT：现金账户 BALANCE_TYPE_CREDIT：信用账户 revenue_expense_type 否 String [REVENUE|EXPENSE] 收支类型。 REVENUE：收入 EXPENSE：支出 此参数不携带时，不作为筛选条件；此参数携带值不允许为空、null、空串，有枚举值校验。 trade_type 否 String 最大长度：20 交易类型。 RECHARGE：充值 DEDEUCT：消费 REFUND：退款 RFROZEN：冻结 TRANS：转账，余额和保证金互换（老商务模式，当前已无保证金账户） ADJUST：调账（华为核销等） BEUNBIND：解绑/关联模式切换导致的回收 EXPIRED：过期清零 BONUSCONVERT：奖励金转换（老商务模式，当前已无奖励金账户） TRADE_MODE_TRANSFER：交易模式变更 DEPOSIT：保证金 此参数不携带、携带值为空时，不作为筛选条件；此参数携带值为null，作为筛选条件过滤；此参数不允许为空串，有正则校验。 trade_time_begin 否 String 最大长度：10 查询收支明细的开始日期。 说明： 东八区时间，格式为YYYY-MM-DD，如“2017-10-21”。 默认值为一年前的当天日期。 此参数不携带、携带值为空时，不作为筛选条件；此参数不允许携带值为空串或值为null，有参数校验。 trade_time_end 否 String 最大长度：10 查询收支明细的结束日期。 说明： 东八区时间，格式为YYYY-MM-DD，如“2017-12-21”。 默认值为当前日期。 此参数不携带、携带值为空时，不作为筛选条件；此参数不允许携带值为空串或值为null，有参数校验。 trade_id 否 String 最大长度：128 交易ID/订单ID。 此参数不携带、携带值为空时，不作为筛选条件；携带值为null时，作为筛选条件；此参数不允许为空串，有正则校验。 payment_channel_id 否 String 最大长度：64 交易渠道。可以一次查询多个，用逗号分隔。 0：无交易渠道 1：支付宝 2：银行转账 4：支付宝/网银 5：微信支付 6：提现 7：激励返点 10：交易模式变更 11：调账 317：银联（统一支付平台） 319：Huawei Pay 320：华为支付 此参数不携带、携带值为空时，不作为筛选条件；此参数携带值为空串或为null时，作为筛选条件过滤。 payment_channel_no 否 String 最大长度：64 交易渠道流水号。 此参数不携带、携带值为空时，不作为筛选条件；此参数携带值为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。 此参数不携带、为null或携带值为空时，默认传参为0；此参数不允许为空串，有参数校验。 limit 否 Integer [1-100] 每次查询的数量，默认值为10。 此参数不携带时，默认传参为10；此参数不允许为空、空串或为null，有参数校验。

请求消息 请求参数 无 请求示例 GET https://bss.myhuaweicloud.com/v2/promotions/benefits/stored-value-cards?status=1&card_id=userSVCId2148682091&offset=0&limit=100 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

URI GET /v2/promotions/benefits/stored-value-cards 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 status 是 Integer [1-2] 状态： 1：可使用 2：已用完 card_id 否 String 最大长度：64 储值卡ID。 此参数不携带或携带值为空时，不作为筛选条件。 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。

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

API调用授权（客户） 客户账号调用API需要经过授权，可通过用户中心 统一身份认证 修改权限进行授权。接口对应的权限项如下表，只要有其中一条权限项为无权限即不可调用。 未在表里的接口不需要做细粒度权限校验，客户账号均可调用。 不支持系统角色权限鉴权，仅支持策略鉴权。配置指导请参考：创建用户组并授权 官网参考资料链接： 客户运营能力API参考（中国站） 场景 子场景 接口名称 接口URL 权限码 权限项名称 管理产品 查询商品价格 查询按需产品价格 POST /v2/bills/ratings/on-demand-resources bss:discount:view 查看折扣、价格信息。 查询包年/包月产品价格 POST /v2/bills/ratings/period-resources/subscribe-rate bss:discount:view 查看折扣、价格信息 查询待续订包年/包月资源的续订金额 POST /v2/bills/ratings/period-resources/renew-rate bss:discount:view 查看折扣、价格信息。 管理账户 管理账户 查询账户余额 GET/v2/accounts/customer-accounts/balances bss:balance:view 查看账户信息。 查询储值卡列表 GET /v2/promotions/benefits/stored-value-cards bss:coupon:view 查看优惠券、现金券、代金券。 查询收支明细 GET /v2/accounts/customer-accounts/account-change-records bss:balance:view 查看账户信息。 管理交易 管理优惠券 查询优惠券列表 GET /v2/promotions/benefits/coupons bss:coupon:view 查看优惠券、现金券、代金券。 管理包年/包月订单 查询订单列表 GET /v2/orders/customer-orders bss:order:view 查看订单信息。 查询订单详情 GET /v2/orders/customer-orders/details/{order_id} bss:order:view 查看订单信息。 取消待支付订单 PUT /v2/orders/customer-orders/cancel bss:order:update 下单、取消订单、修改收货地址。 支付包周期订单 POST /v2/orders/customer-orders/pay bss:order:pay 订单支付。 查询订单可用优惠券 GET /v2/orders/customer-orders/order-coupons bss:order:view 查看订单信息。 查询订单可用折扣 GET /v2/orders/customer-orders/order-discounts bss:discount:view 查看折扣、价格信息。 支付包年/包月产品订单 POST /v3/orders/customer-orders/pay bss:order:pay 订单支付。 查询退款订单的金额详情 GET /v2/orders/customer-orders/refund-orders bss:order:view 查看订单信息。 管理包年/包月资源 查询客户包年/包月资源列表 POST /v2/orders/suscriptions/resources/query bss:order:view 查看订单信息。 续订包年/包月资源 POST /v2/orders/subscriptions/resources/renew bss:renewal:update 下单、取消订单、修改收货地址。 退订包年/包月资源 POST /v2/orders/subscriptions/resources/unsubscribe bss:order:update 下单、取消订单、修改收货地址。 设置包年/包月资源自动续费 POST /v2/orders/subscriptions/resources/autorenew/** bss:renewal:update 下单、取消订单、修改收货地址。 取消包年/包月资源自动续费 DELETE /v2/orders/subscriptions/resources/autorenew/{resource_id} bss:renewal:update 下单、取消订单、修改收货地址。 设置或者取消包年/包月资源到期转按需 POST /v2/orders/subscriptions/resources/to-on-demand bss:renewal:update 下单、取消订单、修改收货地址。 管理资源包 查询资源包列表V3 POST/v3/payments/free-resources/query bss:bill:view 查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。 查询资源包使用明细 GET /v2/bills/customer-bills/free-resources-usage-records bss:billDetail:view 查看消费明细、资源消费、账单分析、付款历史记录。 查询资源包使用量 POST /v2/payments/free-resources/usages/details/query bss:bill:view 查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。 管理账单 管理账单 查询资源详单 POST /v2/bills/customer-bills/res-records/query bss:billDetail:view 查看消费明细、资源消费、账单分析、付款历史记录。 查询汇总账单 GET /v2/bills/customer-bills/monthly-sum bss:bill:view 查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。 查询资源消费记录 GET /v2/bills/customer-bills/res-fee-records bss:bill:view 查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。 查询流水账单 GET /v2/bills/customer-bills/fee-records bss:bill:view 查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。 查询95计费资源用量 查询95计费资源用量明细 GET/v2/bills/customer-bills/resources/usage/details bss:billDetail:view 查看消费明细、资源消费、账单分析、付款历史记录。 查询95计费资源用量汇总 GET/v2/bills/customer-bills/resources/usage/summary bss:bill:view 查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。 管理成本 管理成本 查询月度成本 GET /v2/costs/cost-analysed-bills/monthly-breakdown bss:costanalysis:view 查看成本分析。 查询成本数据 POST /v4/costs/cost-analysed-bills/query bss:costanalysis:view 查看成本分析。 管理企业 管理企业项目 开通客户企业项目权限 POST /v2/enterprises/enterprise-projects/authority bss:enterpriseProjectFunction:update 开通企业项目功能。 管理企业多账号 查询企业子账号列表 GET /v2/enterprises/multi-accounts/sub-customers bss:enterpriseOrganization:view 企业中心组织与账号查看权限。 查询企业组织结构 GET /v2/enterprises/multi-accounts/enterprise-organizations bss:enterpriseOrganization:view 企业中心组织与账号查看权限。 查询企业主的可拨款余额 GET /v2/enterprises/multi-accounts/transfer-amount bss:enterpriseFinance:view 查看企业组织财务信息。 查询企业子账号可回收余额 GET /v2/enterprises/multi-accounts/retrieve-amount bss:enterpriseFinance:view 查看企业组织财务信息。 创建企业子账号 POST /v2/enterprises/multi-accounts/sub-customers bss:enterpriseOrganization:update 修改企业组织与子账号 企业主账号向企业子账号拨款 POST /v2/enterprises/multi-accounts/transfer-amount bss:enterpriseFinance:update 修改企业组织财务信息。 企业主回收给企业子的拨款 POST /v2/enterprises/multi-accounts/retrieve-amount bss:enterpriseFinance:update 修改企业组织财务信息。 查询企业主账号可拨款优惠券列表 GET /rest/cbc/openapi/v2/enterprises/multi-accounts/transfer-coupons bss:enterpriseFinance:view 查看企业组织财务信息 查询企业子账号可回收优惠券列表 GET /rest/cbc/openapi/v2/enterprises/multi-accounts/retrieve-coupons bss:enterpriseFinance:view 查看企业组织财务信息 企业主账号向企业子账号拨款优惠券 POST /rest/cbc/openapi/v2/enterprises/multi-accounts/transfer-coupon bss:enterpriseFinance:update 修改企业组织财务信息 企业主账号从企业子账号回收优惠券 POST /rest/cbc/openapi/v2/enterprises/multi-accounts/retrieve-coupon bss:enterpriseFinance:update 修改企业组织财务信息 父主题： API调用方式

流控失败常见问题及处理 接口报错样例: {"status_code":429,"request_id":"7e6c1***********c610","error_code":"APIGW.0308","error_message":"The throttling threshold has been reached: policy user over ratelimit,limit:10,time:1 second","encoded_authorization_message":""} 处理方式: 华为云为客户运营能力API均提供默认的流量配额，用户可根据自己实际业务场景对额度进行升级。用户可以监视429状态码并构建重试机制。重试机制应遵循指数回退计划，以在必要时减少请求量。用户还可以在退避时间表中建立一些随机性，以避免严重的羊群效应。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 customer_id 是 String [1-64] 企业子账号的客户ID。您可以调用查询企业子账号列表接口，获取响应参数“id”的返回值。 coupon_id 是 String [1-64] 优惠券ID。您可以调用查询企业子账号可回收优惠券列表接口，获取响应参数“coupon_id”的返回值。 sub_coupon_id 是 String [1-64] 子优惠券ID。您可以调用查询企业子账号可回收优惠券列表接口，获取响应参数“sub_coupon_id”的返回值。 trans_id 否 String [0-32] 交易序列号，用于防止重复提交。 如果接口调用方不传，则企业管理微服务后台生成 如果接口调用方传入，则请采用UUID保证全局唯一 此参数不携带或携带值为null或携带值为空串时，由系统自动生成。 请求示例 POST https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/retrieve-coupon HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "customer_id": "e8a*****b9c", "coupon_id": "CP19092406014086E2", "sub_coupon_id": "CP19092406014086E1", "trans_id": "333333" }

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 400 CBC.99000043 企业主账号向企业子账号拨款/回收失败。 400 CBC.99007004 发起的业务操作存在不满足的业务检查项。 400 CBC.99007009 交易事务ID重复。 400 CBC.99000087 抱歉，当前操作出现异常，请稍后再试。 403 CBC.0151 访问拒绝。 403 CBC.0155 不允许执行当前请求。 500 CBC.0999 其他错误。

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 400 CBC.99000043 企业主账号向企业子账号拨款/回收失败。 400 CBC.99007004 发起的业务操作存在不满足的业务检查项。 400 CBC.99007009 交易事务ID重复。 403 CBC.0151 访问拒绝。 403 CBC.0155 不允许执行当前请求。 500 CBC.0999 其他错误。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 customer_id 是 String [1-64] 企业子账号的客户ID。您可以调用查询企业子账号列表接口，获取响应参数“id”的返回值。 amount 是 String [1-32] 总划拨金额。单位为元。 单位：元。取值大于0且精确到小数点后2位。 coupon_id 是 String [1-64] 优惠券ID。您可以调用查询企业主账号可拨款优惠券列表接口，获取响应参数“coupon_id”的返回值。 trans_id 否 String [0-32] 交易序列号，用于防止重复提交。 如果接口调用方不传此参数的值，则系统自动生成。 如果接口调用方传入此参数的值，请采用UUID保证全局唯一。 此参数不携带或携带值为null或携带值为空串时，由系统自动生成。 请求示例 POST https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/transfer-coupon HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "customer_id": "06a29c********400fc0c01027684d40", "amount": "100.00", "trans_id": "2020042401", "coupon_id": "CP19092406014086E3" }

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/retrieve-coupons?sub_customer_id=0970cf********60fbac0192a9e2bc0 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ