华为云用户手册

API调用授权（客户） 客户账号调用API需要经过授权，可通过用户中心 统一身份认证 修改权限进行授权。接口对应的权限项如下表，只要有其中一条权限项为无权限即不可调用。 未在表里的接口不需要做细粒度权限校验，客户账号均可调用。 不支持系统角色权限鉴权，仅支持策略鉴权。配置指导请参考：创建用户组并授权 bss:discount:view权限码只影响响应中折扣信息返回，不影响接口调用，当无权限时，接口可正常访问，但不返回折扣信息。 官网参考资料链接： 客户运营能力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:renewal:view bss:order:view（待下线） 查看订单信息。 续订包年/包月资源 POST /v2/orders/subscriptions/resources/renew bss:renewal:update 续费、设置自动续费、设置到期策略、按需转包年/包月、释放资源。 退订包年/包月资源 POST /v2/orders/subscriptions/resources/unsubscribe bss:unsubscribe:update bss:order:update（待下线） 查看可退订资源，退订资源，取消发货，硬件退换货。 设置包年/包月资源自动续费 POST /v2/orders/subscriptions/resources/autorenew/{resource_id} 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 续费、设置自动续费、设置到期策略、按需转包年/包月、释放资源。 设置包年/包月资源自动续费扣款日和续费后资源统一到期日 POST /v2/orders/subscriptions/resources/renew/config bss:renewal:update 续费、设置自动续费、设置到期策略、按需转包年/包月、释放资源。 管理资源包 查询资源包列表V3 POST/v3/payments/free-resources/query bss:bill:view 查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。 查询资源包使用明细 GET /v2/bills/customer-bills/free-resources-usage-records bss:bill:view 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:billDetail:view bss:bill:view（待下线） 查看账单、月度成本、用量明细、成本管理、收支以及总览页面的费用走势。 查询流水账单 GET /v2/bills/customer-bills/fee-records bss:billDetail:view 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

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 403 CBC.0151 访问拒绝。 403 CBC.0155 不允许执行当前请求。 500 CBC.0999 其他错误。 400 CBC.99000086 不存在正常的企业主子关系，需企业主子同一法人且企业子财务独立模式。

URI GET /v2/enterprises/multi-accounts/retrieve-coupons 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 sub_customer_id 是 String [1-64] 企业子账户的账号ID。 offset 否 Integer [0-2147483647] 偏移量，默认值为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。 此参数不携带或携带值为空或携带值为null时，取默认值0；不支持携带值为空串。

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

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 400 CBC.70900002 您的账号需要通过华为云HIS平台创建企业子账号。 400 CBC.99007490 您的账号关联的是退出中的云经销商，禁止创建企业子。 500 CBC.7004 发起的业务操作存在不满足的业务检查项。 400 CBC.99000026 验证码错误。 400 CBC.99000027 验证码过期。 400 CBC.99000029 手机号码已存在。 400 CBC.99000030 手机号码超出限制。 400 CBC.99000031 DomainName无效。 400 CBC.99000036 客户密码格式不合法。 400 CBC.99000051 该手机号/邮箱已被华为报备，无法创建客户。 400 CBC.99007173 该显示名称与其他子账号显示名重复。 400 CBC.99007197 您的IP已经被限流。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

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

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/sub-customers?offset=0&limit=10&sub_customer_account_name=d_2035&sub_customer_display_name=m&fuzzy_query=1&org_id=65419 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

URI GET /v2/enterprises/multi-accounts/sub-customers 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 sub_customer_account_name 否 String 最大长度：64 企业子账号的账号名。 根据fuzzy_query取值决定是否按模糊查询。仅支持前缀匹配、后缀匹配、中间匹配；不支持携带空格查询。 此参数不携带或携带值为空时，不作为筛选条件；携带值为空串时，作为筛选条件。 sub_customer_display_name 否 String 最大长度：64 企业子账号的显示名称。 根据fuzzy_query取值决定是否按模糊查询。仅支持前缀匹配、后缀匹配、中间匹配；不支持携带空格查询。 说明： 如果包含中文或者特殊字符，请使用encodeURIComponent进行编码处理。 此参数不携带或携带值为空时，不作为筛选条件；携带值为空串时，作为筛选条件。 fuzzy_query 否 Integer - 企业子账号的显示名称、用户名是否按模糊查询。默认值为“0：不按模糊查询”。 0：不按模糊查询 1：按模糊查询 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。 org_id 否 String 最大长度：20 子账号归属的组织单元ID。 此参数不携带或携带值为空时，不作为筛选条件。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/enterprise-organizations?recursive_query=1&parent_id=392 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

URI GET /v2/enterprises/multi-accounts/enterprise-organizations 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 recursive_query 否 Integer - 是否递归查询。 0：不递归（默认） 1：递归 如果不递归，只返回起始节点的直接子节点。 此参数不携带或携带值为空时，不作为筛选条件。 parent_id 否 String 最大长度：20 指定的节点ID。为空则从根节点查起。 此参数不携带或携带值为空时，不作为筛选条件。 说明： 此参数须由纯数字组成。

URI GET /v2/enterprises/multi-accounts/retrieve-amount 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 sub_customer_id 是 String 最大长度：64 企业子账户的账号ID。 balance_type 是 String 最大长度：64 账户类型： BALANCE_TYPE_DEBIT：余额账户（默认） BALANCE_TYPE_CREDIT：信用账户 offset 否 Integer [0-2147483647] 偏移量，默认值为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/enterprises/multi-accounts/retrieve-amount?sub_customer_id=0970cf58ff80d4f60fbac0192a9e2bc0&balance_type=BALANCE_TYPE_DEBIT HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

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

URI GET /v2/enterprises/multi-accounts/transfer-amount 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 balance_type 是 String 最大长度：64 账户类型： BALANCE_TYPE_DEBIT：余额账户 BALANCE_TYPE_CREDIT：信用账户 offset 否 Integer [0-2147483647] 偏移量，默认值为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 参数错误。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。 400 CBC.99000047 账户不存在。

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/transfer-amount?balance_type=BALANCE_TYPE_DEBIT&offset=0&limit=10 HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 customer_id 是 String 最大长度：64 企业子账号的客户ID。您可以调用查询企业子账号列表接口，获取响应参数“id”的返回值。 amount 是 String 最大长度：32 总回收金额。 金额单位为货币标准单位，如人民币则单位为元。取值大于0且精确到小数点后2位。 trans_id 否 String 最大长度：32 交易序列号，用于防止重复提交。 如果接口调用方不传，则企业管理微服务后台生成 如果接口调用方传入，则请采用UUID保证全局唯一 此参数不携带或携带值为null或携带值为空串时，由系统自动生成。 balance_type 否 String 最大长度：64 账户类型： BALANCE_TYPE_DEBIT：余额账户（默认） BALANCE_TYPE_CREDIT：信用账户 此参数不携带或携带值为null时，默认为余额账户；不支持携带值为空串。 expire_time 否 String 最大长度：20 账户到期时间，UTC时间，格式为：2016-03-28T14:45:38Z。 暂只对信用账户有效，用于限制针对有效期到期时间等于该时间的信用账户余额进行回收。如果查询信用账户可回收余额的查询结果没有失效时间，表示永久有效，对于这种账本回收的情况无需填写。 当信用账户存在过期时间，该字段必须携带，不支持携带值为空串或携带值为null，否则回收失败； 当信用账户不存在过期时间，该字段无需携带，不支持携带值为空串，否则回收失败。 请求示例 POST https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/retrieve-amount HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "customer_id": "e8a*****b9c", "amount": "10", "trans_id": "333333", "balance_type": "BALANCE_TYPE_DEBIT", "expire_time": "2020-12-31T15:59:59Z" }

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

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

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 customer_id 是 String 最大长度：64 企业子账号的客户ID。您可以调用查询企业子账号列表接口，获取响应参数“id”的返回值。 amount 是 String 最大长度：32 现金账户总划拨金额。 单位：元。取值大于0且精确到小数点后2位。 trans_id 否 String 最大长度：32 交易序列号，用于防止重复提交。 如果接口调用方不传此参数的值，则系统自动生成。 如果接口调用方传入此参数的值，请采用UUID保证全局唯一。 此参数不携带或携带值为null或携带值为空串时，由系统自动生成。 balance_type 否 String 最大长度：64 账户类型： BALANCE_TYPE_DEBIT：余额账户（默认） BALANCE_TYPE_CREDIT：信用账户 此参数不携带或携带值为null时，默认为余额账户；不支持携带值为空串。 expire_time 否 String 最大长度：20 账户到期时间，UTC时间，格式为：2016-03-28T14:45:38Z。 只对信用账户有效，用于限制针对有效期到期时间等于该时间的信用账户余额进行拨款，精确到秒。如果查询信用账户可拨款余额的查询结果没有失效时间，表示永久有效，对于这种账本拨款的情况无需填写。 当信用账户存在过期时间，该字段必须携带，不支持携带值为空串或携带值为null，否则拨款失败； 当信用账户不存在过期时间，该字段无需携带，不支持携带值为空串，否则拨款失败。 请求示例 POST https://bss.myhuaweicloud.com/v2/enterprises/multi-accounts/transfer-amount HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "customer_id": "06a29c********400fc0c01027684d40", "amount": "100", "trans_id": "2020042401", "balance_type": "BALANCE_TYPE_DEBIT", "expire_time": "2020-05-28T14:45:38Z" }

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

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 400 CBC.70300008 非企业主不能发送短信验证码。 400 CBC.99000082 客户发送验证码次数超出限制。 400 CBC.99004003 验证码生成成功但发送失败。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 transId 否 String 最大长度：64 交易序列号，用于防止重复提交。 如果接口调用方不传，则企业管理微服务后台生成。 如果接口调用方传入，则请采用UUID保证全局唯一。 此参数不携带或携带值为null或携带值为空串时，由系统自动生成。 balanceType 否 String 最大长度：64 账户类型： BALANCE_TYPE_DEBIT：余额账户（默认）； BALANCE_TYPE_CREDIT：信用账户。 此参数不携带或携带值为null时，默认为余额账户；不支持携带值为空串。 subCustomerId 是 String 最大长度：64 企业子账号的客户ID。 deductMode 是 String 最大长度：10 资金扣减模式。 1：服务端按金额扣减。 totalRetrieveAmout 是 String 最大长度：32 总回收金额。 单位：元。取值大于0且精确到小数点后2位。 expireTime 否 String 最大长度：20 账户到期时间，UTC时间，格式为：2016-03-28T14:45:38Z。 暂只对信用账户有效，用于限制针对有效期到期时间等于该时间的信用账户余额进行回收。如果查询信用账户可回收余额的查询结果没有失效时间，表示永久有效，对于这种账本的回收的时候不用填写。 当信用账户存在过期时间，该字段必须携带，不支持携带值为空串或携带值为null，否则回收失败； 当信用账户不存在过期时间，该字段无需携带，不支持携带值为空串，否则回收失败。 请求示例 POST https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/account-mgr/retrieve HTTP/1.1 Content-Type: application/json X-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ { "transId": "33", "balanceType": "BALANCE_TYPE_DEBIT", "subCustomerId": "e8a*****b9c", "deductMode": "1", "totalRetrieveAmout": "1.00", "expireTime": "2018-12-31T15:59:59Z" }

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 403 CBC.0151 访问拒绝。 400 CBC.99000047 账户不存在。 400 CBC.99005003 余额不足。 400 CBC.99007004 发起的业务操作存在不满足的业务检查项。 400 CBC.99007461 您当前存在尚未完成的拨款或回收任务，请稍后再试。 500 CBC.7181 划拨或回收的信用额度的有效期已过期。 500 CBC.0999 其他错误。