华为云用户手册

URI GET /v2/accounts/partner-accounts/balances 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 indirect_partner_id 否 String 最大长度：64 云经销商ID。 获取方法请参见查询云经销商列表。 华为云总经销商（一级经销商）查询云经销商（二级经销商）余额时，需要携带该参数；除此之外，此参数不做处理。否则只能查询自己的账户余额。

请求消息 请求参数 参数 是否必选 参数类型 取值范围 描述 indirect_partner_id 是 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。 amount 是 BigDecimal - 回收金额。 华为云总经销商回收的云经销商的账户金额。 说明： 回收金额不能大于云经销商的账户余额。 单位：元。取值大于0且精确到小数点后2位。 请求示例 POST https://bss.myhuaweicloud.com/v2/accounts/partner-accounts/indirect-partner-reclaim HTTP/1.1Content-Type: application/jsonX-Auth-Token：MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ{ "indirect_partner_id": "05bad7a90700d5bf0ff6c00ae40d0ca0", "amount": 0.01}

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

状态码 状态码4xx：由于明显的客户端错误（例如，格式错误的请求语法、参数错误等），华为云会返回4xx错误码，请及时检查请求消息的正确性，重新发起请求。 状态码5xx：由于华为云系统原因，导致无法完成明显有效请求的处理，可及时联系华为云客服处理。 HTTP状态码 错误码 错误描述 400 CBC.0100 参数错误。 403 CBC.0150 非法操作。 400 CBC.50000045 不能对同一个代金券额度进行频繁操作。上一次的代金券额度划拨正在进行中，不允许并行划拨，待结束后再进行下一次操作。 200 CBC.50010105 无法给退出中的云经销商发放代金券额度。 400 CBC.99000013 优惠券额度不足。 400 CBC.99000015 此状态的额度不支持发放。 400 CBC.99000017 额度未生效或者已过期。 400 CBC.99000037 您没有操作该云经销商的权限。 400 CBC.50000021 该代金券额度指定客户非云经销商子客户，不支持发放给云经销商。 403 CBC.0151 访问拒绝。 500 CBC.0999 其他错误。

URI GET /v2/partners/coupon-quotas/records 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 indirect_partner_id 否 String 最大长度：64 云经销商ID。获取方法请参见查询云经销商列表。 为空表示查询所有的代金券额度发放回收记录。 不为空表示仅查询与该云经销商相关的代金券额度发放回收记录。 默认查询所有云经销商的代金券额度发放回收记录。 quota_id 否 String 最大长度：64 云经销商的代金券额度ID。获取方法请参见查询优惠券额度。 即华为云总经销商给云经销商发放代金券额度时，产生的云经销商的代金券额度ID，或者从云经销商回收代金券额度时，云经销商的代金券额度ID。 此参数不携带或携带值为空时，不作为筛选条件。 operation_time_begin 否 String 最大长度：20 查询条件：操作起始时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。 此参数不携带或携带值为空时，不作为筛选条件。不支持携带值为空串。 operation_time_end 否 String 最大长度：20 查询条件：操作截止时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。 此参数不携带或携带值为空时，不作为筛选条件。不支持携带值为空串。 parent_quota_id 否 String 最大长度：64 父额度ID。 这即华为云总经销商给云经销商发放代金券额度时，华为云总经销商的额度ID，或者从云经销商回收代金券额度时，回收的华为云总经销商的额度ID。 此参数不携带或携带值为空时，不作为筛选条件。携带值为空串或携带值为null时，作为筛选条件。 operation_type 否 String 最大长度：8 操作类型。 10：发放额度 11：回收额度 此参数不携带或携带值为非枚举值时，不作为筛选条件。 limit 否 Integer [1-100] 每次查询的数目。默认值为10。 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。

包周期询价示例（通过价格计算器） 查询包年/包月产品价格接口的请求参数可通过价格计算器获取。 以“弹性云服务器”为例： 区域：华北-北京四 可用区：通用可用区 计费模式：包年包月 CPU架构：X86计算 规格 ：通用计算增强型 C6|2核|4GB 系统盘：通用型SSD 40G 购买时长：1个月 购买个数：1台 进入价格计算器页面，F12打开控制台。根据示例中的参数，在页面完成选择。 在控制台中进入Network选项，找到询价接口“resource”。点击“Payload”，查看接口请求参数。 根据步骤2获取到的请求参数拼接查询包年/包月产品价格接口请求参数。 如上图所示，查询包年/包月产品价格接口组合询价了一个弹性云服务器和一个云硬盘。所以产品信息列表product_infos需要两个结构体，最终结果如下所示： { "project_id": "84c5********fb2420", "product_infos": [ { "id": "1", "cloud_service_type": "hws.service.type.ec2", "resource_type": "hws.resource.type.vm", "resource_spec": "c6.large.2.linux", "region": "cn-north-4", "period_type": 2, "period_num": 1, "subscription_num": 1 }, { "id": "2", "cloud_service_type": "hws.service.type.ebs", "resource_type": "hws.resource.type.volume", "resource_spec": "GPSSD", "region": "cn-north-4", "resource_size": 40, "size_measure_id": 17, "period_type": 2, "period_num": 1, "subscription_num": 1 } ]} 【可选】登录APIExplorer，输入product_infos，询价得到的产品价格与价格计算器结果一致。 父主题： 询价接口指导

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调用方式

按需询价示例（通过价格计算器） 查询按需产品价格接口的请求参数可通过价格计算器获取。 以“弹性云服务器”为例： 区域：华北-北京四 可用区：通用可用区 计费模式：按需 CPU架构：X86计算 规格 ：通用计算增强型 C6|2核|4GB 系统盘：通用型SSD 40G 购买时长：1个月 购买个数：1台 进入价格计算器页面，F12打开控制台。根据示例中的参数，在页面完成选择。 在控制台中进入Network选项，找到询价接口“resource”。点击“Payload”，查看接口请求参数。 根据步骤2获取到的请求参数拼接查询包年/包月产品价格接口请求参数。 如上图所示，查询包年/包月产品价格接口组合询价了一个弹性云服务器和一个云硬盘。所以产品信息列表product_infos需要两个结构体，最终结果如下所示： { "project_id": "c4c24********599c2", "product_infos": [ { "id": "1", "cloud_service_type": "hws.service.type.ec2", "resource_type": "hws.resource.type.vm", "resource_spec": "c6.large.2.linux", "region": "cn-north-4", "usage_factor": "Duration", "usage_value": 1, "usage_measure_id": 4, "subscription_num": 1 }, { "id": "2", "cloud_service_type": "hws.service.type.ebs", "resource_type": "hws.resource.type.volume", "resource_spec": "GPSSD", "region": "cn-north-4", "resource_size": 40, "size_measure_id": 17, "usage_factor": "Duration", "usage_value": 1, "usage_measure_id": 4, "subscription_num": 1 } ]} 【可选】登录APIExplorer，输入product_infos，询价得到的产品价格与价格计算器结果一致。 父主题： 询价接口指导

支付使用折扣或优惠券说明 客户在调用“续订包年/包月资源”接口进行续订时，可以设置自动支付。 请求参数“isAutoPay”字段取值为“1”时表示自动支付，自动支付时支持使用折扣和券。 支付规则请参见自动续费规则说明中的相关规则说明。 请求参数未传“isAutoPay”字段，或者将该字段设置为“0”（以具体接口参数描述为准）时需要再调用“支付包年/包月产品订单”接口进行支付。 这种方法支付时可以在调用支付接口前，先调用“查询订单可用优惠券”接口查询可用的优惠券，再进行支付。使用优惠券支付将不能再享受折扣优惠。 父主题： 附录

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

操作流程 表1 操作流程 任务 说明 步骤一：创建健康检查 可选任务。 您可以创建健康检查，并在配置服务路由规则时为成员组选择健康检查。 您可以根据业务需要选择不同的健康检查协议，健康检查支持TCP/HTTP协议。 步骤二：创建成员组 必选任务。 创建成员组B，并将区域B的 云服务器ECS -B添加至成员组B。 成员组与成员的区域、成员类型保持一致。所以此时创建成员组B选择“区域B”，成员类型选择“云服务器”。 步骤三：创建服务 必选任务。 创建服务B，设置服务基本信息并配置路由规则，选择健康检查（可选），将成员组B添加至服务B。 步骤四：创建ANC 必选任务。 创建一个ANC。并将客户端E CS -A所在的VPC关联至ANC，将已创建的服务B关联至ANC。关联后，客户端ECS-A可以通过ANC访问服务B中的云服务器ECS-B。

ANC支持审计的关键操作 云审计 支持的ANC操作列表如表1所示。 表1 云审计服务支持的ANC操作列表 操作名称 资源类型 事件名称 创建VPC关联 clientAssociation createClientAssociation 删除VPC关联 clientAssociation deleteClientAssociation VPC关联开启IPv6 clientAssociation enableClientAssociationIpv6 批量创建VPC关联 clientAssociation batchCreateClientAssociation 批量删除VPC关联 clientAssociation batchDeleteClientAssociation 创建云原生应用网络 anc createAnc 删除云原生应用网络 anc deleteAnc 更新云原生应用网络 anc updateAnc 创建健康检查 healthmonitor createHealthmonitor 删除健康检查 healthmonitor deleteHealthmonitor 更新健康检查 healthmonitor updateHealthmonitor 创建成员组 memberGroup createMemberGroup 删除成员组 memberGroup deleteMemberGroup 更新成员组 memberGroup updateMemberGroup 成员组添加健康检查 memberGroup addMemberGroupsHealthmonitor 成员组移除健康检查 memberGroup removeMemberGroupsHealthmonitor 批量注册成员 memberGroup batchRegisterMembers 批量注销成员 memberGroup batchDeregisterMembers 创建服务关联 serviceAssociation createServiceAssociation 删除服务关联 serviceAssociation deleteServiceAssociation 批量创建服务关联 serviceAssociation batchCreateServiceAssociation 批量删除服务关联 serviceAssociation batchDeleteServiceAssociation 关联服务 serviceAssociation associateService 创建服务 service createService 删除服务 service deleteService 更新服务 service updateService 批量接受待审批服务关联 service acceptAssociateService 批量拒绝待审批服务关联 service rejectAssociateService

TCP健康检查 对于四层（TCP）和七层（HTTP/HTTPS）后端协议，您可以配置TCP健康检查，通过发起TCP三次握手来获取后端服务器的状态信息，如图1所示。 图1 TCP健康检查 TCP健康检查的机制如下： 服务节点根据健康检查配置，向成员（IP+健康检查端口）发送TCP SYN报文。 成员收到请求报文后，如果相应的端口已经被正常监听，则会返回SYN+ACK报文。 如果在超时时间内没有收到成员的SYN+ACK报文，则判定健康检查失败。随后发送RST报文给成员中断TCP连接。 如果在超时时间内收到了SYN+ACK报文，则判定健康检查成功，并进一步发送ACK报文给成员。随后发送RST报文给成员中断TCP连接。 正常的TCP三次握手后，会进行数据传输，但是在健康检查时会发送RST中断建立的TCP连接。该实现方式可能会导致成员中的应用认为TCP连接异常退出，并打印错误信息，如“Connection reset by peer”。解决方案如下： 采用HTTP健康检查。 成员忽略健康检查的连接错误。

HTTP健康检查 对于四层（TCP）和七层（HTTP）后端协议，您可以配置HTTP健康检查，通过HTTP GET请求来获取状态信息。检查原理如图2所示。 图2 HTTP健康检查 HTTP健康检查机制如下： 服务节点根据健康检查配置，向后端服务器（IP+端口+检查路径）发出HTTP GET请求（可以选择设置 域名 ）。 成员收到请求后，根据服务的情况返回相应的HTTP状态码。 如果服务节点在响应超时时间内收到了成员的响应，将HTTP状态码与预置的状态码进行对比，如果匹配则认为健康检查成功，成员运行正常。 如果服务节点在响应超时时间内没有收到成员的响应，则判定健康检查失败。 在HTTP健康检查请求中，User-Agent头字段主要用于标识此类请求为健康检查发出的探测请求。User-Agent的值可能随业务需求而动态调整，建议客户的成员请勿根据此header头做检验和判断。

健康检查时间窗 健康检查机制的引入，有效提高了业务服务的可用性。但是，为了避免频繁的健康检查失败引起的切换对系统可用性的冲击，健康检查只有连续多次检查成功或失败后，才会进行状态切换。 健康检查时间窗由表1中的因素决定： 表1 健康检查时间窗的影响因素 影响因素 说明 检查间隔 每隔多久进行一次健康检查。 超时时间 等待服务器返回健康检查的时间。 最大成功重试次数 判定健康检查结果正常时，所需的健康检查连续成功的次数。 最大失败重试次数 判定健康检查结果异常时，所需的健康检查连续失败的次数。 健康检查时间窗的计算方法如下： 健康检查成功时间窗 = 超时时间×最大成功重试次数 + 检查间隔×(最大成功重试次数-1) 健康检查失败时间窗 = 超时时间×最大失败重试次数 + 检查间隔×(最大失败重试次数-1) 如图3所示： 检查间隔：4s 超时时间：2s 健康检查异常阈值：3次 健康检查检测到成员从正常到失败状态，健康检查失败时间窗 = 超时时间×最大失败重试次数+检查间隔×(最大失败重试次数-1) = 2 x 3+4 x (3-1) = 14s。 图3 健康检查失败时间窗

操作场景 VPC关联指关联云原生应用网络（ANC） 与客户端所在的虚拟私有云（VPC）。与ANC关联的VPC内客户端（如ECS）可以与ANC关联的服务网络互通。您可以将不同区域的VPC关联至ANC。例如，将区域A的VPC1和区域B的VPC2关联至ANC。当VPC客户端不再需要访问ANC上的服务时，您可以删除VPC关联。 下面介绍如何在管理控制台关联ANC与客户端所在的VPC，以及如何删除VPC关联。

服务的组成 服务由成员、路由规则、健康检查（可选）等元素组成。 成员可以是云服务器实例、辅助弹性网卡或弹性负载均衡实例等。由一个或多个成员的逻辑集合组成成员组。 路由规则是服务默认组件，用于将请求转发多个成员组中的一个。每条规则由优先级和权重组成。路由规则决定由客户端请求所转发的目标成员组。 服务会定期向成员发送请求以测试其运行状态，这些测试称为健康检查。通过健康检查来判断成员是否可用。 服务按照添加的成员组区域不同，分为同区域服务和跨区域服务。 表1 服务说明 服务类型 说明 同区域 同一个服务可以添加相同区域的成员组。 在服务A中，添加区域A的路由规则，并添加区域A的多个成员组。 同一服务同一区域中，可添加1个路由规则。 跨区域 同一个服务可以添加不同区域的成员组。 在服务B中，添加区域A的路由规则和成员组。添加区域B的路由规则和成员组。

操作步骤二：路由规则 根据界面提示，添加路由规则，如表2所示。 表2 添加路由规则-参数说明 参数名称 参数说明 取值样例 区域 不同区域的资源之间内网不互通。请选择靠近您客户的区域，可以降低网络时延、提高访问速度。创建服务时所选择的区域即为服务的归属地。 华东-上海一 健康检查 可选参数。 选择健康检查，如果没有合适的健康检查，您可以创建健康检查。 health-check-001 成员组 必选参数。 单击“添加成员组”，可以依次增加多个相同或不同区域的成员组。 相同区域内根据设置的权重访问成员组。 member-group-001 路由规则添加完成后，单击“下一步”。 单个服务中，同一区域仅可以创建一个路由规则。 单个路由规则中可以添加多个成员组，同一个路由规则中，各成员组的区域、虚拟私有云和子网一致。

角色管理相关操作 在“角色管理”页面，您还可以进行如表2所示的操作。 表2 角色管理相关操作 操作 描述 编辑角色 在“角色管理”页面，单击待编辑角色记录“操作”列的“编辑”，根据实际情况修改角色对应参数取值。 删除角色 在“角色管理”页面，单击待删除角色记录“操作”列的“删除”，删除角色。 查询角色 在“角色管理”页面，在角色列表上方输入框输入“角色代码”或“角色名称”信息，再单击“查询”，查询角色。

单位类型相关操作 单位类型添加完成后，您还可以进行如表2所示的操作。 表2 单位类型相关操作 操作 描述 编辑单位类型 在“单位管理”页面，单击待编辑单位类型记录“操作”列的“编辑”，根据实际情况修改单位类型信息。 删除单位类型 在“单位管理”页面，勾选待删除单位类型记录前的，单击“删除”，删除单位类型。 查询单位类型 在“单位管理”页面，在单位类型列表上方输入框输入“中文名称”、“英文名称”、“中文描述”或“英文描述”信息，再单击“查询”，查询单位类型。

单位相关操作 单位添加完成后，您还可以进行如表4所示的操作。 表4 单位相关操作 操作 描述 失效单位 在“单位管理”页面，选择单位类型，勾选“生效”状态的单位记录前的，单击“失效”，失效单位。 失效单位成功后，对应单位的“状态”变为“失效”。 发布单位 在“单位管理”页面，选择单位类型，勾选“失效”状态的单位记录前的，单击“发布”，发布单位。 发布单位成功后，对应单位的“状态”变为“生效”。 编辑单位 在“单位管理”页面，选择单位类型，单击待编辑单位记录“操作”列的“编辑”，根据实际情况修改单位信息。 删除单位 在“单位管理”页面，选择单位类型，勾选待删除单位记录前的，单击“删除”，删除单位。 查询单位 在“单位管理”页面，选择单位类型，在单位列表上方输入框输入“中文名称”、“英文名称”、“中文描述”或“英文描述”信息，再单击“查询”，查询单位。

模块定义相关操作 在“模块定义”页面，您还可以进行如表2所示的操作。 表2 模块定义相关操作 操作 描述 编辑模块 在“模块定义”页面，在左侧模块结构树中选中记录，单击待编辑模块记录“操作”列的“编辑”，根据实际情况修改模块信息。 删除模块 在“模块定义”页面，在左侧模块结构树中选中记录： 单击待删除模块记录“操作”列的“删除”，删除模块。 勾选待删除模块记录前的，单击“删除”，删除模块。 查询模块 在“模块定义”页面，在模块结构树上方输入框输入“中文名称”信息，查询模块。

检验结果项模板相关操作 检验结果项模板添加完成后，您还可以进行如表2所示的操作。 表2 检验结果项模板相关操作 操作 描述 编辑检验结果项模板 在“检验结果项模板”页面，单击待编辑的检验结果项模板记录“操作”列的“编辑”，根据实际情况修改检验结果项名称、检验结果项描述、检验项结果值等参数信息。 删除检验结果项模板 在“检验结果项模板”页面，单击待删除的检验结果项模板记录“操作”列的“删除”，删除检验结果项模板。 查询检验结果项模板 在“检验结果项模板”页面，在检验结果项模板列表上方输入框输入“测试项的属性项的结果名称”信息，再单击“查询”，查询检验结果项模板。

标签模板相关操作 标签模板添加完成后，您还可以进行如表5所示的操作。 表5 标签模板相关操作 操作 描述 发布标签模板 在“标签模板定义”页面，勾选“草稿”或“锁定”状态的标签模板记录前的（不支持批量勾选），单击“发布”，发布标签模板。 “发布”状态的标签模板才能被其他功能模块引用。 发布操作后，“版本号”取值增加0.1。 先锁定再发布，系统生成一条“发布”状态的数据，原锁定数据不可再操作。 锁定标签模板 在“标签模板定义”页面，勾选“发布”状态的标签模板记录前的（不支持批量勾选），单击“锁定”，锁定标签模板。 “发布”状态的数据如果想要修改，需先锁定再编辑。此时，该数据仅支持锁定者进行修改、发布操作。 编辑标签模板 在“标签模板定义”页面，单击“草稿”或“锁定”状态待编辑的标签模板记录“操作”列的“编辑”，根据实际情况修改标签模板信息。 删除标签模板 在“标签模板定义”页面，单击“草稿”或“锁定”状态待删除的标签模板记录“操作”列的“删除”，删除标签模板。 复制标签模板 在“标签模板定义”页面，勾选“草稿”或“发布”状态的标签模板记录前的，单击“复制模板”，复制标签模板。 批量修改目录 在“标签模板定义”页面，勾选待修改目录的标签模板记录前的，单击“批量修改目录”，标签模板保存到新目录。 查看标签模板 在“标签模板定义”页面，单击待查看的标签模板记录“操作”列的“查看”，查看标签模板详情。 查询标签模板 在“标签模板定义”页面，在顶部输入框输入“模板代码”、“模板名称”或“创建人”信息，或者选择指定状态、创建时间，再单击“查询”，查询标签模板。 添加管理模板变量 在“标签模板定义”页面，单击“添加/管理模板变量”，系统弹出“打印参数维护”页面。 单击“新增”，新增标签模板参数信息，包括参数代码、参数名称、参数描述、系统函数、示例数值，取值长度均不超过1000个字符。 单击“操作”列的“编辑”，根据实际情况修改标签模板参数信息。 单击“操作”列的“删除”，删除标签模板参数信息。 在顶部输入框输入“参数代码”或“系统函数”信息，再单击“查询”，查询标签模板参数信息。

基本概念 数字化制造云平台（MBM Space）支持全局属性扩展和按业务数据分类扩展两种属性扩展方式，能满足用户90%以上的业务扩展场景。 全局属性扩展：即用户增加的扩展字段会对实体所有业务数据都会生效，对用户而言看到的是所有的扩展字段。 按业务数据分类扩展：即用户增加的扩展字段只对当前业务数据生效，不同的业务数据展示的扩展字段不同，起到扩展属性隔离的作用。 例如：用户可以针对电子产品（实体Electronics）所属的业务数据如手机（MobilePhone）增加扩展字段如打电话（Calling），拍照（TakePhotos）；针对电子产品（实体Electronics ）所属的业务数据如电脑（Computer）增加扩展字段如电脑型号（ComputerType），电脑品牌（ComputerBrand）；其中Calling、TakePhotos和ComputerType，ComputerBrand等扩展字段互不影响，对于用户而言在增加业务数据MobilePhone时感知不到业务数据Computer的扩展字段，起到字段隔离的作用。 两种扩展方式原理图如图1和图2所示。 图1 全局属性扩展 图2 按业务数据分类扩展

专属卡片介绍 使用“专属卡片”前您需要在“卡片管理”页面上传卡片包并应用，应用后“专属卡片”区域才会显示对应的卡片包。表1中仅介绍系统默认的专属卡片信息。 表1 专属卡片介绍 卡片名称 功能描述 备注 产品主数据资产卡片 展示产品主数据服务中，我的部件、我的文档相关信息。 需要开通产品主数据服务。 我的部件：展示当前登录用户所创建的部件信息。 我的文档：展示当前登录用户所创建的文档信息。 通用清单卡片模板 通用的数据清单类卡片模板，您可以通过该卡片展示数据清单类的数据信息。例如，产品主数据资产卡片就是已经定制好的通用数据清单类卡片。 通用清单卡片模板的使用，请参见添加通用清单卡片。 通用外部链接卡片模板 通用的外部链接类卡片模板，您可以通过该卡片展示需要嵌入到角色桌面中的外部链接页面。 通用外部链接卡片模板的使用，请参见添加通用外部链接卡片。 生命周期数据卡片模板 生命周期数据卡片模板，您可以通过该卡片展示需要查看的业务或项目的生命周期数据，如某个项目需要完成的需求总数、未开始数量、进行中数量、已完成数量及完成率等。 生命周期数据模板卡片的使用，请参见添加生命周期数据卡片。 表1中专属卡片支持用户自定义，并且可以根据用户实际需要新增其他自定义卡片。表格中关于专属卡片的卡片名称和功能描述可能和界面中实际展示不一致。 父主题： 添加专属卡片

查看 消息通知 进入IPDCenter基础服务登录页面，输入账号和密码，单击“登录”。 在角色桌面首页，查看右上角图标是否有未读消息。 若有未读消息，则右上角有红色数字提醒；若无未读消息，则右上角没有红色数字提醒。 单击图标，通知消息会通过时间降序进行排序，依次展示消息来源的图标logo、消息来源的应用名称、消息的标题、消息的正文以及消息产生的时间。 在消息通知处，已读的消息会置灰；默认显示消息的标题和摘要且只显示两行内容，超出内容显示为“...”，后方会显示“查看详情”，单击“查看详情”会展开消息内容，展开后的消息会置灰。 在消息通知处，单击“本页全部已读”，可以将消息通知处加载出来的消息全部置灰，再次打开则为空。 默认加载20条消息，滑动到底部后会继续加载20条消息。 在消息通知处，单击消息标题，如果标题设置了跳转链接，则可以直接跳转至对应界面。 在消息通知处，单击“查看全部消息”，可跳转至消息中心界面。

管理消息中心 在角色桌面首页，单击“消息中心”，进入到“消息中心”页面。 在页面左侧“消息中心”下方，会按照“全部消息”、“未读消息”和“已读消息”进行分类显示。 全部消息：显示当前收到的所有消息，包含已读和未读消息。默认显示“全部”消息。 未读消息：显示当前收到的消息中，未读的消息内容。未读消息前会显示未读状态，消息已读后，变为已读状态。 已读消息：显示当前收到的消息中，已读的消息内容。 筛选消息。 按照“审批信息”、“授权提醒”和“系统信息”进行显示。 支持按照“消息来源”进行筛选：在“消息来源”处进行选择不同来源。 支持按照时间段进行筛选：在“选择时间段”处进行时间段筛选。 支持关键字搜索：可以按照“标题”或者“文本”进行搜索，同时支持模糊搜索和精确搜索。 删除消息。 单条删除：在需要删除的消息对应的“操作”列单击“删除”，弹出“确认删除该消息？”弹窗。单击“确定”，删除该消息。 批量删除：勾选需要删除的消息，单击页面上方的“删除”，弹出“确认删除该消息？”弹窗。单击“确定”，删除所勾选的消息。 消息已读。 标记已读：勾选需要标记为已读的消息，单击页面上方的“标记为已读”，所勾选消息对应“状态”列显示为“已读”。 全部已读：单击页面上方的“全部已读”，当前页面显示的所有消息对应“状态”列显示为“已读”。

功能简介 编码发生器是一种用于生成一定长度的随机编码的工具。这些编码通常由数字、字母或符号组成，具有一定的随机性和唯一性，可以用于各种需要标识唯一性的场合，如订单号、会员号、优惠券码等。 编码发生器可以根据不同的需求和规则生成不同类型的编码，如固定长度、可变长度、指定字符集、不重复等。同时，编码发生器还可以支持批量生成和自定义前缀、后缀等功能，方便快捷地生成大量的编码。 在实际应用中，编码发生器通常与数据库或缓存系统结合使用，用于生成唯一的标识符，以便于管理和查询。

创建ID标识器 创建任务 进入“生成器配置”页签，单击。 在弹出的界面中设置如下信息： 生成器代码：由系统自动生成，系统唯一值。 生成器名称：生成器的名称，系统默认填充“生成器代码”的取值。 生成器分类：数据来源于生成器分类。 生成器标签：数据来源于生成器标签。 填写完成后，单击“确定”。 添加构件 将需要的“构件”从顶部的构件列表中拖入中间的画布区域。 其中“流水序列”构件为必选，没有流水序列，无法对外生成编码。 图1 添加构件 单击构件，设置构件属性。 表3 构件属性 构件 说明 ID生成器 生成器代码：系统自动生成，系统唯一值 生成器名称：生成器的名称，系统默认填充“生成器代码”的取值 生成器分类：自定义分类，数据来源于生成器分类 总目标长度：生成器条码总长度 流水分组规则：系统自动生成 格式预览：生成器条码内容 备注：填写自定义备注信息 固定字符 构件代码：由系统自动生成，系统唯一值 构件名称：默认为固定字符串，支持修改 固定值：编码中自定义的固定值，如ABC、001等 目标长度：固定值的长度 是否属于流水分组标识：是否开启编码生成的预览效果，默认开启 是否作为组装元素输出：是否使用该规则，默认开启 对象编码 业务属性取值 业务属性：数据来源于业务对象属性 属性初始值：数据来源于“业务对象属性”中的“默认值” 目标长度：根据预览值计算的长度 预览值：“属性初始值”经过数据处理后的最终数值 数据处理逻辑 数据处理方法：支持大小写转换、长度填补、顺序反转、字符串截取、增加前缀、增加后缀。（例如大小写转换，支持设置为“全转大写”，即编码中的小写字母全部转换成大写） 构件显示属性 构件名称：默认为对象编码，支持修改 构件代码：由系统自动生成，系统唯一值 是否属于流水分组标识：是否开启编码生成的预览效果，默认开启 是否作为组装元素输出：是否使用该规则，默认开启 日期代码 时间代码属性：设置日期样式，选项如下 时间年月日时分秒yyyMddHHmmss 时间年月日yyyyMdd 时间年月yyyyMM 时间时分秒HHmmss 自选定组合 日期格式：设置年份显示样式 预览值：选定日期后，自动生成预览值 目标长度：预览值长度 初始值：根据“时间代码属性”生成的值，例如202406 构件代码：由系统自动生成，系统唯一值 构件名称：默认为日期代码，支持修改 是否属于流水分组标识：是否开启编码生成的预览效果，默认开启 是否作为组装元素输出：是否使用该规则，默认开启 流水序列 流水码类别：当前仅支持数字流水 目标长度：数字流水值的长度，取值范围1-10 最小值：根据目标长度和进制规则确认最小值 最大值：根据目标长度和进制规则确认最大值 增减方式：目前仅支持增量 间隔量(十进制)：默认为1 进制规则：十进制、可配置字符进制，其中34进制字符集不勾选O和I 周期重置模式：可选值从不、每日、每周、每月、每年 预览值：最小值经过进制转换后的最终数值 构件代码：由系统自动生成，系统唯一值 构件名称：默认为流水序号，支持修改 是否作为组装元素输出：是否使用该规则，默认开启 说明： 流水序列递增规则： 如果纯数字，会从最小值递增到最大值，例如：最小值是1最大值是9999，则初始的第一个流水序列码是0001，然后往上递增加1，变为0002，0003。 如果是数字加字母形式，会从最小值递增到最大值，例如，最小值是1，最大值是ZZZZ，在同一个位数上，先是数字递增，然后再到字母递增。则初始的第一个流水序列码是0001，然后往上递增加1，变为0002，0003，到了0009的时候再递增是000A，000B，000C，到了000Z后再递增是0010。 设置完成后单击“操作”列表中的“发布”。 操作过程中您也可以进行重置、还原、复制等操作。