华为云用户手册

流体仿真场景 流体仿真是一种利用计算机模拟流体在不同的条件下的流动和传热的技术，可以帮助工程师和科学家探索流体的复杂性和多样性，解决各种流体问题，促进产品的创新和发展。流体仿真主要的应用场景如下： 汽车：汽车风阻、汽车风噪、汽车热管理和座舱舒适性。 电子：单板散热、整机热仿真和功率模组冷却。 装备：风机设计、空调设计和齿轮箱润滑。 图5 汽车风阻分析 图6 无人机气动分析 图7 汽车座舱舒适性 图8 电子散热分析 图9 功率模组冷却分析 图10 汽车风噪分析 图11 油箱润滑仿真分析

系统管理 系统管理功能概览如表6所示。 表6 系统管理功能概览 功能名称 功能描述 发布区域 应用配置 定义系统的功能构架，支持的类型包括产品、应用、模块、微服务、前端Web及移动App。 支持查询系统中所有API信息。 按模块维护系统功能菜单栏目及菜单中的子页面及按钮对象，包括菜单、按钮需要的API权限。 维护数据字典。 定义参数配置。 华南-广州、华北-北京四 用户权限 管理用户信息，支持添加用户、重置密码等操作。 维护角色拥有的功能权限，管理角色权限对应的用户。 支持给用户授予角色，使其获得角色拥有的功能权限。 管理工厂所属员工信息。 华南-广州、华北-北京四 运维监控 支持记录登录日志、操作日志及文件日志。 华南-广州、华北-北京四 租户管理 支持管理业务租户（二级租户）。 华南-广州、华北-北京四

质量管理 质量管理功能概览如表4所示。 表4 质量管理功能概览 功能名称 功能描述 发布区域 质量计划 维护工单质检方案。 支持查询工单质检单信息以及质检项内容。 华南-广州、华北-北京四 质量检验 支持按质检单完成对产品的质检，记录质检信息，也支持对完成缺陷/故障维修的产品再次进行检验。 提供产品缺陷登记的能力。 提供产品故障现象登记的能力。 支持录入产品维修结果，以及查看产品缺陷故障记录、产品维修记录。 提供对维修失败的产品登记报废的能力。 华南-广州、华北-北京四 质量监控 支持对存在质量问题的物料或产品进行隔离操作。 支持查询物料和产品的隔离信息并解除隔离。 华南-广州、华北-北京四

产品架构 工业仿真云平台服务（SIM Space）脱胎于华为仿真研发最佳实践，面向工业制造领域的用户，提供软硬一体化的数字化仿真环境，并基于工业数字模型驱动引擎（iDME）和硬件工具链平台基础服务（IPDCenter-Base），面向生态伙伴开放，打造新一代工业仿真平台，使能生态构建面向各行各业的场景化仿真工具链解决方案，帮助企业实现从硬件资源到结构、流体、电磁等仿真专业工具的垂直整合，方便复杂仿真作业的协同开展，达成基于仿真的高效设计优化。产品结构如图1所示。 图1 工业仿真云平台服务（SIM Space）产品架构

制造数据模型管理 制造数据模型管理功能概览如表1所示。 表1 制造数据模型管理功能概览 功能名称 功能描述 发布区域 从这里开始 可参考向导制定一个通用的生产方案。 可参考向导制定一个高阶的生产方案。 华南-广州、华北-北京四 工厂模型 定义公司及公司下的工厂。 建立和维护工厂的虚拟模型，该虚拟模型可以反映出工厂、流水线、工厂地址等信息。 定义公司内部的一个或一组业务独立经营的部门。 管理供应商信息。 管理制造商信息。 管理客户信息。 定义部门信息以及管理部门人员。 管理仓库、车间班组的成员。 华南-广州、华北-北京四 产品模型 对产品、物料等规格信息建立规范的规格编码体系。 维护产品制造BOM信息，包括维护BOM行数据、维护BOM行物料的装配位置以及维护BOM行对应的生产工序及工位。 支持根据Part编码查询BOM多层级树结构。 华南-广州、华北-北京四 工艺模型 定义生产的工序，包括工序组及工序组下的工序。 支持通过图形化的方式定义产品的工艺路线。 维护加工产品的线体的生产能力信息，为生产排产提供参考信息。 管理生产工序的作业指导书。 审核作业指导书的发布请求。 华南-广州、华北-北京四 资源模型 维护指定产品的工艺路线中需要的资源信息，通过配置工序中的资源来定义使用的工治具。 维护资源实物信息。 维护产品在其生产过程中需要操作人员具备的技能。 维护公司级、工厂级、车间级、线体级的班次、通用事件，以及资源的日历信息。 维护资源规格（工治具）信息。 华南-广州、华北-北京四 配方模型 维护在生产工序中设备的参数信息。 维护在生产工序中需要从设备采集的数据。 华南-广州、华北-北京四 质检模型 维护各种故障现象、故障对象、测量方法、故障原因、缺陷及措施。 维护物料的追溯标准。 维护不同产品的质检方案、检验方案和抽样规则。 维护产品质检方案中检验项目的检验结果项。 维护产品质检方案中检验分组的累计规则。 华南-广州、华北-北京四 设备模型 维护设备规格信息。 维护设备实物关系。 华南-广州、华北-北京四 仓储模型 以工厂为维度按仓库-库区-货位的层级维护工厂下的仓库结构及相应的属性。 维护ERP子库与货位。 华南-广州、华北-北京四 建模工具 以图形化界面的方式灵活定义系统中的编码信息。 管理各类数据描述集合。 记录配置项相关信息。 以图形化界面的方式定义系统所需打印的标签信息。 配置动态属性扩展实体。 配置动态属性扩展属性。 管理系统中“单位”参数的取值范围。 华南-广州、华北-北京四

生产管理 生产管理功能概览如表3所示。 表3 生产管理功能概览 功能名称 功能描述 发布区域 生产准备 支持按照线体、工单号显示已派工到线体的工单清单，提供工单开工、打印工单派工信息功能。 支持按工单号、产品条码和标签模板定义打印标签，并记录打印信息。 支持对线体加工工单的批次物料、资源上载或卸载。 支持对已拆分生成的产品条码进行撤销拆分。 支持对生产工单按批量需求进行拆分生成产品条码。 支持对已拆分生成的产品条码进行再次拆分出新的小批料单。 支持导入和查询系统中用于生产消耗的物料信息。 华南-广州、华北-北京四 生产执行 支持执行产品在线体工位上的过站，完成批次物料扣减与序列物料采集绑定。 提供产品返工的能力，支持让产品重新回到已完成的工序步骤上重新过站。 支持对原产品条码所绑定的序列物料条码信息进行替换或者打散，支持对原产品条码所使用的批次物料条码信息进行替换或者删除。 华南-广州、华北-北京四 生产入库 提供对已完成生产的产品包装的能力，并提供对小包装进行组合包装的能力。 支持对已完成生产的产品进行入库状态的更新。 华南-广州、华北-北京四 生产看板 支持查看工单在各工序上的生产进度（如工序完成数量、在制数量、缺陷数量）。 支持查看产品过站记录和其他交易记录（如维修、故障、缺陷、报废）。 支持按工单或产品追溯所使用的批次物料与序列物料记录。 支持按物料条码反向追溯该物料的使用记录。 华南-广州、华北-北京四

计划管理 计划管理功能概览如表2所示。 表2 计划管理功能概览 功能名称 功能描述 发布区域 工单导入 提供手工导入（录入）、拆分工单、编辑以及查询ERP工单功能。 华南-广州、华北-北京四 工单方案 提供手工录入工单、批量录入工单、工单方案生成、工单方案实例化、工单取消、修改加工区域、查询工单、维护工单工程方案（工艺路线、料、机、人、法）功能。 华南-广州、华北-北京四 计划排产 提供排产保存、一键排产、导出待排产信息、排产调整、取消排产、导出排产结果信息、查询工单排产信息功能。 支持生成物料需求、查询工单物料需求信息。 支持生成生产工具需求、查询工单生产物料信息。 支持冻结工单、解除冻结工单、查询工单冻结信息。 华南-广州、华北-北京四

与其他服务的关系 数字化制造云平台（MBM Space）与周边服务的依赖关系如图1所示。 图1 MBM Space与其他服务的关系 表1 MBM Space其他云服务的关系 服务名称 MBM Space与其他服务的关系 主要交互功能 组织成员账号（OrgID） 通过OrgID服务，实现对MBM Space访问用户的身份认证。 MBM Space访问用户身份认证 云日志 服务（Log Tank Service，LTS） 记录MBM Space运行日志，方便用户查询进行问题定级定位。 日志收集记录 云审计 服务（Cloud Trace Service， CTS ） CTS记录MBM Space相关的操作事件，方便用户日后的查询、审计和回溯。 审计关键操作 应用性能管理 服务（Application Performance Management， APM ） 实时监控MBM Space组件运行状态、JVM状态、线程状态、API调用统计、Redis/RDS访问记录统计。 调用链管理，方便用户进行日常监控、问题定界定位。 调用链 调用指标统计 状态监控 应用运维管理 （Application Operations Management， AOM ） 统计与展示MBM Space运行环境状态指标，基于指标设置告警。 指标收集/展示 告警定义/发送告警 云容器引擎（Cloud Container Engine，CCE） 通过创建CCE集群及其上的主机组/主机，部署MBM的微服务。 创建CCE集群 创建节点 创建无状态负载（Deployment） 弹性云服务器（Elastic Cloud Server，E CS ） 通过创建CCE集群主机弹性云服务器，部署MBM Space Docker。 MBM Space Docker部署 容器镜像服务 （SoftWare Repository for Container，SWR） 通过SWR拉取执行集群中用于部署MBM Space的镜像软件。 上传镜像 下载镜像 关系型数据库（Relational Database Service，RDS） RDS for MySQL拥有稳定可靠、安全运行、弹性伸缩、轻松管理、经济实用等特点。 数据库连接 数据CRUD 对象存储服务 （Object Storage Service，OBS） 存储RDS的备份数据。 文件上传 文件下载 文件删除 NAT网关（NAT Gateway） 使用NAT网关能够为VPC内的容器实例提供 网络地址转换 服务，SNAT功能通过绑定弹性公网IP，实现私有IP向公有IP的转换，可实现VPC内的容器实例共享弹性公网IP访问Internet。 使用SNAT访问公网 弹性公网IP（Elastic IP） MBM Space通过EIP对外提供服务（DNS绑定改IP）。 请求转发 API网关（API Gateway，APIG） MBM Space内部和外部的API统一通过APIG进行调用。 API注册 API发布 API过载配置 弹性负载均衡（ Elastic Load Balance，ELB） ELB对接APIG和CCE集群，完成MBM Space请求的负载转发均衡。独享型负载均衡实例资源独享，实例的性能不受其它实例的影响。 创建独享型负载均衡器 虚拟私有云（Virtual Private Cloud，VPC） 实现MBM Space隔离的私有云空间。 创建虚拟私有云和子网 分布式消息服务RocketMQ版（Distributed Message Service for RocketMQ） 通过分布式消息服务RocketMQ版完成消息的生产与消费。 创建RocketMQ实例 创建Topic 分布式缓存服务（Distributed Cache Service，DCS） 通过DCS（Redis）服务将热点数据放入缓存，加快用户端的访问速度，提升用户体验。 热点数据加载、访问 主机安全服务（Host Security Service，HSS） 通过HSS构筑MBM Space主机级别安全。 主机安全防护 Web应用防火墙 （Web Application Firewall，WAF） 通过WAF构筑MBM Space Web应用安全。 Web安全防护 Anti-DDoS流量清洗服务（Anti-DDoS traffic cleaning service，Anti-DDoS） 通过Anti-DDoS构筑MBM Space防DDoS攻击安全。 DDoS攻击防护 父主题： 数字化制造云平台产品介绍

数据保护技术 数字化制造云平台（MBM Space）通过多种数据保护手段和特性，保障在MBM Space中存储和传输的数据安全可靠。 表1 MBM Space的数据保护手段和特性 数据保护手段 简要说明 详细介绍 传输加密（HTTPS） MBM Space支持HTTP和HTTPS两种传输协议，为保证数据传输的安全性，推荐您使用更加安全的HTTPS协议。 MBM Space传输敏感数据（包含密码）时使用TLS1.2版本的HTTPS协议，支持完整性和机密性保护。 服务端存储加密 服务端对于敏感数据采取加密存储机制，使用SCC加密机制。 RDS高安全性。 数据备份 使用公有云RDS提供的数据备份恢复机制。 RDS高可靠性。 敏感操作保护 MBM Space用户进行敏感操作时，会对操作用户进行风险提示，或者二次认证通过后进行操作。 敏感操作包含数据激活、数据删除等。 父主题： 安全

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

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

URI GET /v1.0/{domain_id}/customer/account-mgr/transfer-amount 参数说明请参见下表。 表1 路径参数 参数 是否必选 取值范围 描述 domain_id 是 最大长度：64 客户账号ID。获取方法请参见如何获取客户的customer_id/domain_id。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 balance_type 是 String 最大长度：64 账户类型。 BALANCE_TYPE_DEBIT：余额账户 BALANCE_TYPE_CREDIT：信用账户 offset 否 Integer [1-200000000] 页码（默认1）。只有信用账户有效。 当balance_type为信用账户时：此参数不携带或携带值为空或携带值为null时，取值为1；不支持携带值为空串。 当balance_type为余额账户时：此参数不携带或携带值为空或携带值为null时，参数无效；不支持携带值为空串。 limit 否 Integer [1-100] 每页记录数（默认10）。只有信用账户有效。 当balance_type为信用账户时：此参数不携带或携带值为空或携带值为null时，取值为1；不支持携带值为空串。 当balance_type为余额账户时：此参数不携带或携带值为空或携带值为null时，参数无效；不支持携带值为空串。

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

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/account-mgr/transfer-amount?balance_type=BALANCE_TYPE_DEBIT HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

请求消息 请求参数 无。 请求示例 GET https://bss.myhuaweicloud.com/v1.0/{domain_id}/customer/account-mgr/retrieve-amount?balance_type=BALANCE_TYPE_DEBIT&sub_customer_id=16*****e7e HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

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

URI GET /v1.0/{domain_id}/customer/account-mgr/retrieve-amount 参数说明请参见下表。 表1 路径参数 参数 是否必选 取值范围 描述 domain_id 是 最大长度：64 客户账号ID，只能使用企业主账号。 获取方法请参见如何获取客户的customer_id/domain_id。 表2 查询参数 参数 是否必选 参数类型 取值范围 描述 sub_customer_id 是 String 最大长度：64 企业子账户的账号ID。 balance_type 是 String 最大长度：64 账户类型： BALANCE_TYPE_DEBIT：余额账户（默认）； BALANCE_TYPE_CREDIT：信用账户。 offset 否 Integer [1-200000000] 页码（默认1）。只有信用账户有效。 当balance_type为信用账户时：此参数不携带或携带值为空或携带值为null时，取值为1；不支持携带值为空串。 当balance_type为余额账户时：此参数不携带或携带值为空或携带值为null时，参数无效；不支持携带值为空串。 limit 否 Integer [1-100] 每页记录数（默认10）。只有信用账户有效。 当balance_type为信用账户时：此参数不携带或携带值为空或携带值为null时，取值为1；不支持携带值为空串。 当balance_type为余额账户时：此参数不携带或携带值为空或携带值为null时，参数无效；不支持携带值为空串。

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/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.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 403 CBC.0151 访问拒绝。 400 CBC.99005003 余额不足。 500 CBC.99007461 您当前存在尚未完成的拨款或回收任务，请稍后再试。 500 CBC.7001 企业主账号与子账号不存在关联，不能直接向企业子账号拨款。 500 CBC.7004 发起的业务操作存在不满足的业务检查项。 500 CBC.7181 划拨或回收的信用额度的有效期已过期。 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：服务端按金额扣减。 totalTransferAmount 是 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/transfer HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ{ "balanceType": "BALANCE_TYPE_DEBIT", "subCustomerId": "165****e7e", "deductMode": "1", "totalTransferAmount":"2", "expireTime": "2018-12-31T15:59:59Z"}

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 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.1Content-Type: application/jsonX-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 访问拒绝。 403 CBC.0155 不允许执行当前请求。 500 CBC.0999 其他错误。

流控失败常见问题及处理 接口报错样例: {"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状态码并构建重试机制。重试机制应遵循指数回退计划，以在必要时减少请求量。用户还可以在退避时间表中建立一些随机性，以避免严重的羊群效应。

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：退款-包年/包月转按需 103：消费-按年付费 此参数不携带或携带值为空时，不作为筛选条件。 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和103时此处为订单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。

请求消息 请求参数 无。 请求示例 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.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 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.1Content-Type: application/jsonX-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 其他错误。