华为云用户手册

包年/包月资源 对于包年/包月计费模式的MAS实例，用户在购买时会一次性付费，服务将在到期后自动停止使用。 如果在计费周期内不再使用包年/包月资源，您可以执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订规则概览。 如果您已开启“自动续费”功能，为避免继续产生费用，请在自动续费扣款日（默认为到期前7日）之前关闭自动续费。

计费示例 假设您在2023/10/16 9:30:00创建成功了一个按需计费的MAS实例，然后在2023/10/16 11:00:00将其删除，则： 第一个计费周期为9:00:00 ~ 10:00:00，在9:30:00 ~ 10:00:00间产生费用，该计费周期内的计费时长为0.5小时。 第二个计费周期为10:00:00 ~ 11:00:00，在10:00:00 ~ 11:00:00间产生费用，该计费周期内的计费时长为1小时。 您需要为每个计费周期付费，计费公式如实例规格单价 * 计费时长。MAS实例每小时价格请参考价格详情。 假设该规格的实例按需价格为20 元/小时，在两个计费周期的总费用为20 * (0.5+1) =30（元）。 该示例中的价格仅供参考，实际计算请以MAS价格详情中的价格为准。

同城多活功能模块与节点计费公式说明 功能模块系数：1 + 0.8 * (n - 1)，n为功能模块个数。 同城多活功能模块价格：100 * 功能模块系数。 比如购买10个功能模块，模块系数为1 + 0.8 * (10 - 1) = 8.2，价格：100 * 8.2 = 820 元/天。 同城多活节点数价格：0.4 * 节点数 * 功能模块系数，10节点(包含)以内免费，超过10个节点，只收取超过节点费用。 比如购买10个节点，10节点(包含)以内免费，节点价格为0。 比如购买15个节点，2个功能模块，则功能模块系数为1 + 0.8 * (2 - 1) = 1.8，节点价格为 0.4 * (15 - 10) * 1.8 = 3.6 元/天。

异地多活功能模块与节点计费公式说明 功能模块系数：1 + 0.8 * (n - 1)，n为功能模块个数。 异地多活功能模块价格：600 * 功能模块系数。 比如购买10个功能模块，模块系数为1 + 0.8 * (10 - 1) = 8.2，价格：600 * 8.2 = 4920 元/天。 异地多活节点数价格：1 * 节点数 * 功能模块系数，10节点(包含)以内免费，超过10个节点，只收取超过节点费用。 比如购买10个节点，10节点(包含)以内免费，节点价格为0。 比如购买15个节点，2个功能模块，则功能模块系数为1 + 0.8 * (2 - 1) = 1.8，节点价格为 1 * (15 - 10) * 1.8 = 9 元/天。

计费模式概述 MAS提供按需计费、包年/包月两种计费模式。 包年/包月：一种预付费模式，即先付费再使用，按照实例订单的购买周期进行结算。购买周期越长，享受的折扣越大。一般适用于设备需求量长期稳定的成熟业务。 按需计费：一种后付费模式，即先使用再付费，按照MAS计费项的数量与实际使用时长计费。按需计费模式允许您根据实际业务需求灵活地调整资源使用，无需提前预置资源，从而降低预置过多或不足的风险。一般适用于电商抢购等设备需求量瞬间大幅波动的场景。 表1列出了两种种计费模式的区别。 表1 计费模式 计费模式 包年/包月 按需计费 付费方式 预付费 按照订单的购买周期结算。 后付费 按照多活管理中心、功能模块、节点的数量与实际使用时长计费。 计费周期 按订单的购买周期计费。 多活管理中心按小时结算，功能模块、节点按天结算。 变更计费模式 不支持变更。 不支持变更。 变更规格 不支持变更。 不支持变更。 适用计费项 多活管理中心、混沌工程。 多活管理中心、功能模块、节点。 适用场景 适用于可预估资源使用周期的场景，价格比按需计费模式更优惠。对于长期使用者，推荐该方式。 适用于资源需求波动的场景，可以随时开通，随时删除。 父主题： 计费模式

适用场景 包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景： 稳定业务需求：对于长期运行且资源需求相对稳定的业务，如企业官网、在线商城、博客等，包年/包月计费模式能提供较高的成本效益。 长期项目：对于周期较长的项目，如科研项目、大型活动策划等，包年/包月计费模式可以确保在整个项目周期内资源的稳定使用。 业务高峰预测：如果能预测到业务高峰期，如电商促销季、节假日等，可提前购买包年/包月资源以应对高峰期的需求，避免资源紧张。 数据安全要求高：对于对数据安全性要求较高的业务，包年/包月计费模式可确保资源的持续使用，降低因资源欠费而导致的数据安全风险。

到期后影响 图1描述了包年/包月MAS实例各个阶段的状态。购买后，在计费周期内实例正常运行，此阶段为有效期；实例到期而未续费时，将陆续进入宽限期和保留期。 图1 包年/包月MAS实例生命周期 到期预警 包年/包月MAS实例在到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为账号的创建者。 到期后影响 当您的包年/包月MAS实例到期未续费，首先会进入宽限期，资源状态变为“已过期”。宽限期内您可以正常访问实例。 如果您在宽限期内仍未续费包年/包月MAS实例，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期的包年/包月资源执行任何操作。 保留期到期后，若包年/包月MAS实例仍未续费，那么MAS实例将被释放，数据无法恢复。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 关于续费的详细介绍请参见续费概述。

计费示例 假设您在2023/10/16 15:50:04购买了一个包年/包月MAS实例。购买时长为一个月，并在到期前手动续费1个月，则： 第一个计费周期为：2023/10/16 15:50:04 ~ 2023/11/16 23:59:59 第二个计费周期为：2023/11/16 23:59:59 ~ 2023/12/16 23:59:59 您需要为每个计费周期预先付费，计费公式为实例规格单价 * 购买时长。 例如该实例包月的价格为13000 元/月，则上述两个计费周期的总费用为13000 * 2=26000（元）。

欠费影响 包年/包月 对于包年/包月MAS实例，用户已经预先支付了资源费用，因此在账户出现欠费的情况下，已有的包年/包月MAS实例仍可正常使用。然而，对于涉及费用的操作，如变更实例规格、续费订单等，用户将无法正常进行。 按需计费 当您的账号因按需MAS资源自动扣费导致欠费后，账号将变成欠费状态。欠费后，按需资源不会立即停止服务，资源进入宽限期。您需支付按需资源在宽限期内产生的费用，相关费用可在管理控制台“费用中心 ＞ 总览 ＞ 欠费金额”查看，华为云将在您充值时自动扣取欠费金额。 如果您在宽限期内仍未支付欠款，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期的按需计费资源执行任何操作。 保留期到期后，若您仍未支付账户欠款，那么实例将被释放，数据无法恢复。 图1 按需计费MAS资源生命周期 华为云根据客户等级定义了不同客户的宽限期和保留期时长。

计费说明 多活高可用服务的计费项为多活管理中心、功能模块、节点以及混沌工程。具体内容如表1所示。 具体收费介绍，请参考价格详情。 表1 多活高可用服务计费项 计费项 计费项说明 适用的计费模式 多活管理中心 根据多活管理中心规格、购买时长以及购买的实例数量进行计费。 包年/包月、按需计费 功能模块 根据功能模块版本、功能点数量以及开通时长进行计费。 按需计费 节点 根据多活管理中心关联的节点数以及购买时长进行计费。 按需计费 混沌工程 根据混沌工程产品规格以及开通时长进行计费。 包年/包月

公告说明 自2024年9月起，当用户使用以下API的自定义策略授权时，用户需创建或更新自定义策略才可访问。 权限描述 对应的API 新增授权项 依赖授权项 IAM 项目（Project） 企业项目（Enterprise Project） 获取SSL证书列表 GET /v2/{project_id}/apigw/certificates apig:certificate:list - √ √ 创建SSL证书 POST /v2/{project_id}/apigw/certificates apig:certificate:create apig:instances:get √ 请求参数中携带instance_id时支持，否则不支持 删除SSL证书 DELETE /v2/{project_id}/apigw/certificates/{certificate_id} apig:certificate:delete - √ × 查看证书详情 GET /v2/{project_id}/apigw/certificates/{certificate_id} apig:certificate:get - √ × 修改SSL证书 PUT /v2/{project_id}/apigw/certificates/{certificate_id} apig:certificate:update apig:instances:get √ 请求参数中携带instance_id时支持，否则不支持 获取SSL证书已绑定 域名 列表 GET /v2/{project_id}/apigw/certificates/{certificate_id}/attached-domains apig:certificate:listBoundDomain - √ × SSL证书绑定域名 POST /v2/{project_id}/apigw/certificates/{certificate_id}/domains/attach apig:certificate:batchBindDomain apig:certificate:get apig:groups:get √ × SSL证书解绑域名 POST /v2/{project_id}/apigw/certificates/{certificate_id}/domains/detach apig:certificate:batchUnbindDomain apig:certificate:get apig:groups:get √ × 查询实例终端节点连接列表 GET /v2/{project_id}/apigw/instances/{instance_id}/vpc-endpoint/connections apig:instance:listVpcEndpoint apig:instances:get √ √ 接受或拒绝终端节点连接 POST /v2/{project_id}/apigw/instances/{instance_id}/vpc-endpoint/connections/action apig:instance:acceptOrRejectVpcEndpointConnection apig:instances:get √ √ 查询实例的终端节点服务的白名单列表 GET /v2/{project_id}/apigw/instances/{instance_id}/vpc-endpoint/permissions apig:instance:listVpcEndpointPermission apig:instances:get √ √ 批量添加实例终端节点连接白名单 POST/v2/{project_id}/apigw/instances/{instance_id}/vpc-endpoint/permissions/batch-add apig:instance:batchAddVpcEndpointPermission apig:instances:get √ √ 批量删除实例终端节点连接白名单 POST/v2/{project_id}/apigw/instances/{instance_id}/vpc-endpoint/permissions/batch-delete apig:instance:batchDeleteVpcEndpointPermission apig:instances:get √ √ 创建参数编排规则 POST /v2/{project_id}/apigw/instances/{instance_id}/orchestration apig:orchestration:create apig:instances:get √ √ 查看编排规则列表 GET /v2/{project_id}/apigw/instances/{instance_id}/orchestration apig:orchestration:list apig:instances:get √ √ 查询编排规则详情 GET /v2/{project_id}/apigw/instances/{instance_id}/orchestrations/{orchestration_id} apig:orchestration:get apig:instances:get √ √ 更新编排规则 PUT /v2/{project_id}/apigw/instances/{instance_id}/orchestrations/{orchestration_id} apig:orchestration:update apig:instances:get √ √ 删除编排规则 DELETE /v2/{project_id}/apigw/instances/{instance_id}/orchestrations/{orchestration_id} apig:orchestration:delete apig:instances:get √ √ 查询编排规则绑定的API GET /v2/{project_id}/apigw/instances/{instance_id}/orchestrations/{orchestration_id}/attached-apis apig:orchestration:listBoundApis apig:instances:get √ √

前提条件 已开通数字化制造云平台（MBM Space），并根据开通区域确定调用API的Endpoint，详细信息请参见地区与终端节点。 假设数字化制造云平台的访问网址为https://ipdcenter.cn-north-4.myhuaweicloud.com/mbm_app/xxxxxx#/xxxxxx，则调用数字化制造云平台的API的Endpoint为访问网址中的ipdcenter.cn-north-4.myhuaweicloud.com/mbm_app/xxxxxx，即“https://”后至“#”前的内容。 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。Token认证，具体操作请参考认证鉴权。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。

操作步骤 获取接口相关信息。 URI格式：GET /wom/openapi/v1/wos/wo-part-info 详情请参见获取工单产品信息。 在Request Header中增加“X-Auth-Token”。 发送“GET https://{MBM Endpoint}/wom/openapi/v1/wos/wo-part-info”。 查看请求响应结果。 请求成功时，响应参数如下： { "status" : "200", "message" : "success", "data" : { "wo_info" : { "wo_id" : "1417639245421830258", "wo_order" : "WOP123456", "erp_wo_id" : "1457698771257845", "erp_wo_order" : "QWERTYUI", "parent_wo_id" : "1478932452572618", "parent_wo_order" : "WOP147369", "wo_type" : "10", "part_id" : "1564789221484123", "part_no" : "TEST2023", "part_desc" : "MODEL测试", "part_revision" : "1", "lot_unit" : 1, "wo_qty" : 100, "site_id" : "22DF4572394G485KF502", "site_no" : "TEST210213", "completed_qty" : 1, "wo_status" : "10", "hold_flag" : "0", "split_flag" : "1", "solution_flag" : "2", "sn_generate_flag" : "0", "erp_plan_start_date" : "2023-08-14 00:00:00", "erp_plan_end_date" : "2023-08-14 00:00:00", "data_source" : "MANUAL", "actual_wo_start_date" : "2023-08-14 00:00:00", "actual_wo_complete_date" : "2023-08-14 00:00:00", "org_id" : "1" }, "part_info" : { "part_id" : "147258369159753246", "part_no" : "012254736", "part_desc_en" : "MODEL测试", "part_desc" : "MODEL测试", "part_desc_ext" : "MODEL测试001", "part_desc_ext_en" : "MODEL测试001", "status" : 20, "part_status" : 1, "bulk_picked_flag" : "N", "model" : "HK537RX60", "ext_model" : "Default", "ext_model_4print" : "Default", "part_template_type" : "AI", "product_name" : "VIP888", "product_family_name" : "WIFI001", "product_line" : "网络", "default_workstep_info_id" : "157489325467962165", "container_part_flag" : "N", "container_capacity" : 0, "revision_control_flag" : "Y", "setup_flag" : "Y", "sn_type" : 0, "part_check_flag" : "Y", "preform_type" : 0, "unit" : "P CS ", "inventory_item_id" : "1", "planning_make_buy_code" : "1", "part_grp_id" : "9179546248489855254588", "part_grp_no" : "0728", "category_code" : "0302", "category_name" : "制成板", "product_flag" : "1" } }} 请求异常时，错误码请参见错误码。

操作步骤 获取接口相关信息。 URI格式：POST /wom/openapi/v1/wos/wo-info 详情请参见按工单获取工单相关信息。 在Request Header中增加“X-Auth-Token”。 发送“POST https://{MBM Endpoint}/wom/openapi/v1/wos/wo-info”。 Body [ { "wo_id" : "1574698325467510369", "wo_order" : "WOP123456"} ] 查看请求响应结果。 请求成功时，响应参数如下： { "status" : "200", "message" : "success", "data" : [ { "wo_id" : "1574698325467510369", "wo_order" : "WOP123456", "erp_wo_id" : "1457698771257845", "erp_wo_order" : "QWERTYUI", "parent_wo_id" : "1478932452572618", "parent_wo_order" : "WOP147369", "wo_type" : "10", "part_id" : "1564789221484123", "part_no" : "TEST2023", "part_desc" : "MODEL测试", "part_revision" : "1", "lot_unit" : 1, "wo_qty" : 100, "site_id" : "22DF4572394G485KF502", "site_no" : "TEST210213", "completed_qty" : 1, "wo_status" : "10", "hold_flag" : "0", "split_flag" : "1", "solution_flag" : "2", "sn_generate_flag" : "0", "erp_plan_start_date" : "2023-08-14 00:00:00", "erp_plan_end_date" : "2023-08-14 00:00:00", "data_source" : "MANUAL", "actual_wo_start_date" : "2023-08-14 00:00:00", "actual_wo_complete_date" : "2023-08-14 00:00:00", "org_id" : "1" } ]} 请求异常时，错误码请参见错误码。

前提条件 已开通数字化制造云平台（MBM Space），并根据开通区域确定调用API的Endpoint，详细信息请参见地区与终端节点。 假设数字化制造云平台的访问网址为https://ipdcenter.cn-north-4.myhuaweicloud.com/mbm_app/xxxxxx#/xxxxxx，则调用数字化制造云平台的API的Endpoint为访问网址中的ipdcenter.cn-north-4.myhuaweicloud.com/mbm_app/xxxxxx，即“https://”后至“#”前的内容。 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。Token认证，具体操作请参考认证鉴权。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。

响应示例 状态码： 200 请求成功 { "status" : "200", "message" : "success", "i18n" : null, "data" : 1} 状态码： 400 参数校验异常 { "error_code" : " IDT .06031001", "error_msg" : "{0} is required and cannot be empty."} 状态码： 500 API执行异常 { "status" : "500", "message" : "API执行异常", "i18n" : "", "data" : null}

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 响应状态 message String 响应信息 data Object 返回结果 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误代码 error_msg String 错误信息 状态码： 500 表4 响应Body参数 参数 参数类型 描述 status String 响应状态 message String 响应信息 data Object 返回结果

响应参数 状态码： 200 表2 响应Body参数 参数 参数类型 描述 status String 响应状态 message String 响应信息 data Object 返回结果 状态码： 400 表3 响应Body参数 参数 参数类型 描述 error_code String 错误代码 error_msg String 错误信息 状态码： 500 表4 响应Body参数 参数 参数类型 描述 status String 响应状态 message String 响应信息 data Object 返回结果

响应示例 状态码： 200 请求成功 { "status" : "200", "message" : "success", "i18n" : null, "data" : 1} 状态码： 400 参数校验异常 { "error_code" : "IDT.06031001", "error_msg" : "{0} is required and cannot be empty."} 状态码： 500 API执行异常 { "status" : "500", "message" : "API执行异常", "i18n" : "", "data" : null}

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String JWTToken 表2 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 团队角色名称 name_en 是 String 团队角色英文名称 description 否 String 团队角色描述 description_en 否 String 团队角色英文描述

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code String 异常编码 message String 异常信息 total_count String 数据总条数 datas Array of TeamRoleData objects 数据集 表4 TeamRoleData 参数 参数类型 描述 name String 团队角色名称 description String 团队角色描述 team_id String 团队角色id name_en String 团队角色英文名称 description_en String 团队角色英文描述 状态码： 400 表5 响应Body参数 参数 参数类型 描述 reserve String 保留字段 error_code String 错误编码 error_msg String 错误信息

响应示例 状态码： 200 成功 { "code" : "IPDC.01040000", "message" : "success", "datas" : { "name" : "团队角色名称", "description" : "描述", "team_role_id" : "631441571161579520", "name_en" : "Team Role English Name", "description_en" : "desc of team role" }, "total_count" : null} 状态码： 400 认证失败 { "reserve" : null, "error_code" : "AUTH-600001", "error_msg" : ""}

响应示例 状态码： 200 成功 { "code" : "IPDC.01040000", "message" : "success", "datas" : [ { "user_id" : "1212249303258779552", "basic_user_id" : "1008600000107709411", "account" : "zwx11945415", "full_name" : "xxx110@ipdcenter203.huaweiapaas.com 1008600000107709411", "name" : "xxx", "team_id" : "632154065161166848", "team_name" : "团队1", "team_name_en" : "Team1", "team_role_id" : "632155102374797312", "team_role_name" : "团队角色1", "team_role_name_en" : "Team Role1" } ], "total_count" : 1} 状态码： 400 认证失败 { "reserve" : null, "error_code" : "AUTH-600001", "error_msg" : ""}

请求示例 示例一：/basic/lightweight/public/api/v1/drawing/lightweight/download?lightweight_file_path=1804036975960895488/Configurations.json 示例二：/basic/lightweight/public/api/v1/drawing/lightweight/download?lightweight_file_path=1804036975960895488/0/model.js

功能介绍 下载轻量化文件 文件轻量化完成后，会以目录文件夹的形式存储在系统中，通过查询轻量化任务状态能够获取到轻量化文件的存储目录，即属性lightweight_file_path的值。该目录下会存在大量的轻量化文件，这些文件信息会存储在该目录下的Configurations.json文件中，所以下载轻量化文件前必须先请求获取该文件，通过解析该文件再下载其他的轻量化文件信息，通过前端引擎渲染即能在web端展示轻量化后的图纸模型。请求下载Configurations.json文件的参数值为${lightweight_file_path}/Configurations.json，其中${lightweight_file_path}为轻量化后的文件目录。下载其他轻量化文件依次拼接该文件在该目录中的路径即可。

响应示例 状态码： 200 二进制文件流 状态码： 400 错误响应 示例一：{ "error_code" : "01090001", "error_msg" : "系统错误，请联系管理员！"}示例二：{ "error_code" : "01099901", "error_msg" : "请求参数无效！"}示例二：{ "error_code" : "01099902", "error_msg" : "认证失败！"}

响应示例 状态码： 200 成功 { "code" : "IPDC.01040000", "message" : "success", "datas" : [ { "name" : "团队角色名称", "description" : "描述", "team_role_id" : "631441571161579520", "name_en" : "Team Role English Name", "description_en" : "desc of team role" } ], "total_count" : 1} 状态码： 400 认证失败 { "reserve" : null, "error_code" : "AUTH-600001", "error_msg" : ""}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 code String 异常编码 message String 异常信息 total_count String 数据总条数 datas Array of TeamOrRoleUserData objects 数据集 表4 TeamOrRoleUserData 参数 参数类型 描述 account String 账号 name String 名称 user_id String 用户id basic_user_id String 基础服务用户id full_name String 名称全称 team_id String 团队id team_name String 团队名称 team_name_en String 团队英文名称 team_role_id String 团队角色id team_role_name String 团队角色名称 team_role_name_en String 团队角色英文名称 状态码： 400 表5 响应Body参数 参数 参数类型 描述 reserve String 保留字段 error_code String 错误编码 error_msg String 错误信息

URI GET /unidata/public/api/v1/team-role/user/list 表1 Query参数 参数 是否必选 参数类型 描述 team_role_id 是 String 团队角色id limit 是 String 分页大小，每页显示的条目数量 缺省值：10 最小长度：1 offset 是 String 偏移量，表示从此偏移量开始查询，offset大于等于0 缺省值：0 最小长度：0 最大长度：50000

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String JWTToken 表2 请求Body参数 参数 是否必选 参数类型 描述 limit 否 Integer 分页大小，每页显示的条目数量 最小值：1 缺省值：10 offset 否 Integer 偏移量，表示从此偏移量开始查询，offset大于等于0 最小值：0 最大值：50000 缺省值：0 team_role_id 否 String 团队角色id name 否 String 团队角色名称 name_en 否 String 团队角色英文名称