华为云用户手册

响应示例 状态码： 200 OK { "count" : 1, "models" : [ { "id" : "56e0f1b0-ac10-46a5-8fa7-b26831d7d488", "name" : "demo_name", "description" : "description", "status" : "FINISHED", "create_time" : "2021-01-30T02:34:36Z", "finish_time" : "2021-01-30T02:53:26Z", "creator" : "demo-user", "shareable" : true, "data_quantity" : 1000, "type" : "binary", "file" : { "source" : "PRIVATE", "url" : "project:/file/data.csv" }, "losses" : [ 6.2, 1.2, 4.54 ], "metrics" : [ { "name" : "rmse", "value" : 0.3744 }, { "name" : "mae", "value" : 0.2844 }, { "name" : "pcc", "value" : 0.4871 } ], "base_model_id" : "pangu-drug-model", "base_model_name" : "pangu-drug-model" } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 models Array of ModelDto objects 模型列表。 count Integer 模型总数。 表5 ModelDto 参数 参数类型 描述 name String 模型名称。 id String 模型ID。 type String 模型类型。 create_time String 模型创建时间。 finish_time String 模型结束时间。 creator String 创建模型的用户名称。 status String 作业状态。 shareable Boolean 是否打开组织共享。 data_quantity Integer 模型数据量。 file ModelFile object 模型数据来源。 value_range ValueRange object 区间上下限，仅回归型存在。 description String 模型描述信息。 failed_message String 失败提示，当作业执行失败时会返回。 losses Array of floats 模型训练loss信息。 metrics Array of ModelMetric objects 模型评估指标。 base_model_id String 基模型id。 缺省值：pangu-drug-model base_model_name String 基模型名称。 缺省值：pangu-drug-model 表6 ModelFile 参数 参数类型 描述 source String 模型数据文件来源。 枚举值： public private url String 文件URL，用户私有数据中心为项目路径、公共数据场景为obs地址。 最小长度：1 最大长度：2000 eihealth_project_id String 模型文件所在项目id，仅文件为数据中心时填写。 最小长度：1 最大长度：128 表7 ValueRange 参数 参数类型 描述 lower Float 区间下限，仅回归型存在。 upper Float 区间上限，仅回归型存在。 表8 ModelMetric 参数 参数类型 描述 name String 评估指标的名称。 最小长度：1 最大长度：32 value Float 评估指标的评估结果。

URI GET /v1/{project_id}/drug-models 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 表2 Query参数 参数 是否必选 参数类型 描述 search_key 否 String 模糊搜索值。 最小长度：0 最大长度：1024 creator_list 否 Array 创建者列表。 最小长度：1 最大长度：128 数组长度：0 - 50 type_list 否 Array 模型类型列表。 数组长度：0 - 10 status_list 否 Array 模型状态列表。 数组长度：0 - 10 sort_key 否 String 排序规则 目前默认时间降序，支持根据create_time|finish_time|base_model_name。 sort_dir 否 String 排序规则 目前默认时间降序。 缺省值：DESC create_start_time 否 Long 最小创建时间。 最小值：1000000000000 最大值：9999999999999 create_end_time 否 Long 最大创建时间。 最小值：1000000000000 最大值：9999999999999 finish_start_time 否 Long 最小结束时间。 最小值：1000000000000 最大值：9999999999999 finish_end_time 否 Long 最大结束时间。 最小值：1000000000000 最大值：9999999999999 limit 否 Integer 限制量，单次查询总量，必须由数字组成，默认为100，取值范围[1,1000]。 最小值：1 最大值：1000 缺省值：100 offset 否 Integer 偏移量，查询起始偏移，必须由数字组成，默认为0，取值范围[0,100000000]。 最小值：0 最大值：100000000 缺省值：0 base_model_list 否 Array 基模型id列表。 最小长度：0 最大长度：128 数组长度：0 - 10

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 workflows Array of WorkflowListDto objects 所查询类型的流程总数 count Integer 当前页的流程列表 表5 WorkflowListDto 参数 参数类型 描述 id String 流程id name String 流程名称 version String 流程版本 summary String 简短描述信息 description String 描述信息 labels Array of strings 流程标签 create_time String 创建流程时间 update_time String 更新流程时间 user_name String 创建用户名称 source_project_name String 源项目名称 source_resource_id String 源资源id

响应示例 状态码： 200 OK { "workflows" : [ { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "name" : "demo-workflow", "version" : "1.0.0", "summary" : "summary", "description" : "description", "labels" : [ "labelA", "labelB" ], "create_time" : "2021-01-30T02:34:36Z", "update_time" : "2021-01-30T02:53:26Z", "user_name" : "gwj-test-01" } ], "count" : 1 }

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/workflows 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 平台项目ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 表2 Query参数 参数 是否必选 参数类型 描述 name 否 String 流程名称 最小长度：1 最大长度：56 version 否 String 流程版本 最小长度：1 最大长度：24

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限， 获取Token 接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 模型名称，取值范围：[5,32]，允许大小写字母、数字、下划线(_)、中划线(-)和空格,只能以字母开头。 最小长度：5 最大长度：32 description 否 String 模型描述信息。 最小长度：0 最大长度：1024 type 是 String 模型类型。 枚举值： binary numerical file 是 ModelFile object 模型数据来源。 shareable 否 Boolean 是否打开组织共享。 缺省值：false base_model_id 否 String 基模型id。 缺省值：pangu-drug-model 最小长度：1 最大长度：128 表4 ModelFile 参数 是否必选 参数类型 描述 source 是 String 模型数据文件来源。 枚举值： public private url 是 String 文件URL，用户私有数据中心为项目路径、公共数据场景为obs地址。 最小长度：1 最大长度：2000 eihealth_project_id 否 String 模型文件所在项目id，仅文件为数据中心时填写。 最小长度：1 最大长度：128

请求示例 创建模型，模型名称为model_name，类型为二分型，上传项目桶中file/test.csv的模型数据，打开共享开关。 https://{endpoint}/v1/{project_id}/drug-models { "name" : "model_name", "type" : "binary", "description" : "simple model", "file" : { "url" : "project:/file/test.csv", "source" : "private" }, "shareable" : true }

URI DELETE /v1/{project_id}/eihealth-projects/{eihealth_project_id}/workflows/{workflow_id} 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 平台项目ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 workflow_id 是 String 流程id 最小长度：1 最大长度：128

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 quotas Array of QuotaRsp objects 配额信息列表 count Integer 配额列表个数 表4 QuotaRsp 参数 参数类型 描述 name String 配额项名称，支持USER,PROJECT,USER_PROJECT,STORAGE,PROJECT_APP,PROJECT_NOTEBOOK,PROJECT_WORKFLOW,PROJECT_IMAGE total Integer 配额 unit String 配额项单位 usage Integer 配额使用量

基本概念 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。 用户 由账号在 IAM 中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 华为云的区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型 父主题： 使用前必读

请求示例 创建流程，流程的名称为demo-workflow，版本为1.0.0。 https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/workflows { "name" : "demo-workflow", "version" : "1.0.0", "summary" : "summary", "description" : "description", "labels" : [ "labelA", "labelB" ], "timeout" : 1440, "output_dir" : "/workflow", "tasks" : [ { "task_name" : "app1-1", "app_id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "display_name" : "步骤1", "output_dir" : "/task", "resources" : { "cpu_type" : "X86", "cpu" : "1C", "memory" : "1G", "gpu_type" : "GPU", "gpu" : 0 }, "location" : { "x" : 100, "y" : 100 }, "inputs" : [ { "name" : "dir-parameter", "values" : [ "/test" ] } ] } ] }

URI POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/workflows 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 平台项目ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128

提交训练作业常见问题 报错信息：Exception: You have attempted to create more buckets than allowed 原因分析：由于桶的数量多于限额，无法自动创建。 解决方法：用户可以删除一个桶，或者直接指定一个已存在的桶（修改变量obs_bucket的值）。 报错信息："errorMessage":"The number of namespaces exceeds the upper limit"或"namespace is invalid" 原因分析：SWR组织数限额，SWR组织默认最多只能创建5个组织。 解决方法：用户可以删除一个SWR组织，或者直接指定一个已存在的SWR组织（修改变量image_organization的值）。 报错信息：standard_init_linux.go:224: exec user process caused "exet format error" 原因分析：可能由于训练规格错误导致训练作业卡死。 解决方法：请参考说明查询资源规格。 报错信息：报错镜像失败，报错：401，'Unauthorized'，b'{errors":[{"errorCode":"SV CS TG.SWR.4010000",errorMessage":"Authenticate Error",……}] 原因分析：远程连接Notebook时需要输入鉴权信息。 解决方法：传入AK，SK信息。 1 2 3 4 5 6 # 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； # 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 __AK = os.environ["HUAWEICLOUD_SDK_AK"] __SK = os.environ["HUAWEICLOUD_SDK_SK"] # 如果进行了加密还需要进行解密操作 session = Session(access_key=__AK,secret_key=__SK, project_id='***', region_name='***')

训练输出保存结构说明 ModelArts训练作业的模型输出和日志信息会定时同步到指定的OBS中，本示例中模型输出路径和日志输出路径分别为f"{default_obs_dir}/mindspore_model/output/"和f"{default_obs_dir}/mindspore_model/logs/"，用户可以在OBS中查看训练输出信息。 本示例中训练输出保存在OBS的目录结构如下所示： ${your_bucket} └── intermidiate ├── dataset │ └── flower_photos │ └── flower_photos.zip └── mindspore_model ├── logs │ └── xxx-xxx-xxx--0.log ├── output │ └── 20220627-105226-resnet50-224 └── mindspore-image-models.zip

步骤5：使用SDK提交训练作业 本地调测完成后可以提交训练作业。因为数据在Notebook中，设置InputData中“is_local_source”的参数为“True”，会自动将本地数据同步上传到OBS中。 步骤如下： 在“/home/ma-user/work/models/official/cv/resnet/”下创建train_notebook.py， 复制代码至train_notebook.py， 运行train_notebook.py，进行训练作业提交。 # train_notebook.py # 导入ModelArts SDK的依赖，并初始化Session，此处的ak、sk、project_id、region_name请替换成用户自己的信息 from modelarts.train_params import TrainingFiles from modelarts.train_params import OutputData from modelarts.train_params import InputData from modelarts.estimatorV2 import Estimator from modelarts.session import Session # 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； # 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 __AK = os.environ["HUAWEICLOUD_SDK_AK"] __SK = os.environ["HUAWEICLOUD_SDK_SK"] # 如果进行了加密还需要进行解密操作 session = Session(access_key=__AK,secret_key=__SK, project_id='***', region_name='***') # 样例中为了方便默认创建一个OBS桶，推荐将调测所需要传输的文件统一放到`${default_bucket}/intermidiate`目录下，也可以按照注释代码自行指定 obs_bucket = session.obs.get_default_bucket() print("Default bucket name: ", obs_bucket) default_obs_dir = f"{obs_bucket}/intermidiate" #default_obs_dir = "obs://your-bucket-name/folder-name" # 本地的工程代码文件夹路径 code_dir_local = "/home/ma-user/work/models/official/cv/resnet/" #@param {type:"string"} # 代码的启动文件名称 boot_file = "train.py" #@param {type:"string"} train_file = TrainingFiles(code_dir=code_dir_local, boot_file=boot_file) # 本地数据集路径 local_data_path = "/home/ma-user/work/models/dataset/flower_photos" #@param {type:"string"} # 模型输出保存路径 output_local = "/home/ma-user/work/models/official/cv/resnet/output" #@param {type:"string"} # 模拟训练过程中模型输出回传至指定OBS的路径，需要以"/"结尾 obs_output_path = f"{default_obs_dir}/mindspore_model/output/" # 指定一个obs路径用于存储输出结果 output = [OutputData(local_path=output_local, obs_path=obs_output_path, name="output")] # 模拟训练过程中模训练日志回传至指定OBS的路径，需要以"/"结尾 log_obs_path = f"{default_obs_dir}/mindspore_model/logs/" # 训练所需的代码路径，代码会自动从本地上传至OBS code_obs_path = f"{default_obs_dir}/mindspore_model/" data_obs_path = f"{default_obs_dir}/dataset/flower_photos/" # sdk会将代码自动上传至OBS，并同步到训练环境 train_file = TrainingFiles(code_dir=code_dir_local, boot_file=boot_file, obs_path=code_obs_path) # 指定OBS中的数据集路径，会自动将local_path数据上传至obs_path，用户可以在代码中通过 --data_url接收这个数据集路径 input_data = InputData(local_path=local_data_path, obs_path=data_obs_path, is_local_source=True, name="data_url") from modelarts.service import SWRManagement image_organization = SWRManagement(session).get_default_namespace() # image_organization = "your-swr-namespace-name" print("Default image_organization:", image_organization) image_name = "mindspore-image-models-image" #@param {type:"string"} image_tag = "1.0.0" #@param {type:"string"} import os ENV_NAME=os.getenv('ENV_NAME') # 启动训练任务：使用user_command（shell命令）方式启动训练任务 # 注意：训练启动默认的工作路径为"/home/ma-user/modelarts/user-job-dir"，而代码上传路径为"./resnet/${code_dir}"下 # --enable_modelarts=True 该代码仓已适配ModelArts estimator = Estimator(session=session, training_files=train_file, outputs=output, user_image_url=f"{image_organization}/{image_name}:{image_tag}", # 自定义镜像 swr地址，由镜像仓库组织/镜像名称:镜像tag组成 user_command=f'cd /home/ma-user/modelarts/user-job-dir/ && /home/ma-user/anaconda3/envs/MindSpore/bin/python ./resnet/train.py --net_name=resnet50 --dataset=imagenet2012 --enable_modelarts=True --class_num=5 --config_path=./resnet/config/resnet50_imagenet2012_config.yaml --epoch_size=10 --device_target="Ascend" --enable_modelarts=True', # 执行训练命令 train_instance_type="modelarts.p3.large.public", # 虚拟资源规格，不同region的资源规格可能不同，请参考“Estimator参数说明”表下的说明查询修改 train_instance_count=1, # 节点数，适用于多机分布式训练，默认是1 #pool_id='若指定专属池，替换为页面上查到的poolId'，同时修改资源规格为专属池专用的虚拟子规格 log_url=log_obs_path ) # job_name是可选参数，可不填随机生成工作名 job_instance = estimator.fit(inputs=[input_data], job_name="modelarts_training_job_with_sdk_by_command_v01") 表1 Estimator参数说明 参数名称 参数说明 session modelarts session training_files 训练代码的路径和启动文件 user_image_url 自定义镜像swr地址，由镜像仓库组织/镜像名称:镜像tag组成 user_command 执行训练命令 train_instance_type 本地调测'local'或云端资源规格。每个region的资源规格可能是不同的，可以通过下述说明查询对应的资源规格信息。 train_instance_count 节点数 log_url 日志输出路径 job_name 作业名称，不可以重复 train_instance_type表示训练的资源规格，每个region的资源规格可能是不同的。通过如下方法查询资源规格： 公共资源池执行如下命令查询 from modelarts.session import Session from modelarts.estimatorV2 import Estimator from pprint import pprint # 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全； # 本示例以ak和sk保存在环境变量中来实现身份验证为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。 __AK = os.environ["HUAWEICLOUD_SDK_AK"] __SK = os.environ["HUAWEICLOUD_SDK_SK"] # 如果进行了加密还需要进行解密操作 session = Session(access_key=__AK,secret_key=__SK, project_id='***', region_name='***') info = Estimator.get_train_instance_types(session=session) pprint(info) 专属池规格 ModelArts专属资源池统一使用虚拟子规格，不区分GPU和Ascend。资源规格参考表2查询。 表2 专属资源池虚拟规格的说明 train_instance_type 说明 modelarts.pool.visual.xlarge 1卡 modelarts.pool.visual.2xlarge 2卡 modelarts.pool.visual.4xlarge 4卡 modelarts.pool.visual.8xlarge 8卡

创建rf_admin_trust委托（可选） 进入华为云官网，打开控制台管理界面，鼠标移动至个人账号处，打开“ 统一身份认证 ”菜单。 图1 控制台管理界面 图2 统一身份认证菜单 进入“委托”菜单，搜索“rf_admin_trust”委托。 图3 委托列表 如果委托存在，则不用执行接下来的创建委托的步骤 如果委托不存在时执行接下来的步骤创建委托 单击步骤2界面中的“创建委托”按钮，在委托名称中输入“rf_admin_trust”，委托类型选择“云服务”，选择“ RFS ”，单击“下一步”。 图4 创建委托 在搜索框中输入“Tenant Administrator”权限，并勾选搜索结果。 图5 选择策略 选择“所有资源”，并单击下一步完成配置。 图6 设置授权范围 “委托”列表中出现“rf_admin_trust”委托则创建成功。 图7 委托列表

修订记录 发布日期 修改记录 2024-07-12 第四次正式发布。 优化如下章节： MSSI服务计费概述 MSSI服务计费模式概述 包年/包月 按需计费 计费项 2024-04-24 第三次正式发布。 优化如下章节： MSSI服务计费模式概述 计费项 新增退订服务及其子章节。 2024-03-13 第二次正式发布。 修改如下章节： 包年/包月 计费项 手动续费 2023-11-16 第一次正式发布。

计费说明 MSSI服务根据购买的套餐包计费或按需计费。具体内容如表1所示。 如果您需要快速了解MSSI服务的具体价格，请参见MSSI价格详情。 APIG与Astro轻应用计费不在MSSI服务体现，需要单独去对应的服务订购。 公共连接器的计费，按第三方服务计费规则计费，MSSI侧不计费。 表1 MSSI计费项 计费项 计费项说明 适用的计费模式 计费公式 运行流实例 包括运行流实例数量及使用时长。 按需计费：支持 包年/包月：需要与其他计费项一起使用 按需计费：实例数量*实例单价 * 计费时长 包年/包月：详见套餐包价格 运行流实例单价及套餐包价格请参见MSSI价格详情。 模型数 包含表、视图、逻辑模型、资产元数据如连接器等。 按需计费：不支持 包年/包月：支持与其他计费项一起使用，也可单独计费 套餐包价格请参见MSSI价格详情。 采集任务 可以使用的采集任务的数量。 按需计费：不支持 包年/包月：需要与其他计费项一起使用 套餐包价格请参见MSSI价格详情。 可运行页面数 包含屏幕模板数、屏幕数。布局模板不受限制。 按需计费：不支持 包年/包月：需要与其他计费项一起使用 套餐包价格请参见MSSI价格详情。 卡片数 该套餐包中的卡片数。包含卡片模板数、卡片数。 按需计费：不支持 包年/包月：需要与其他计费项一起使用 套餐包价格请参见MSSI价格详情。

计费示例 以包年/包月套餐包计费模式为例，假设您在2023/10/17 10:49:04购买了时长为1个月的套餐规格为40的自动化流专业版，并在到期前手动续费1个月，则： 第一个计费周期为：2023/10/17 10:49:04 ~ 2023/11/17 23:59:59 第二个计费周期为：2023/11/17 23:59:59 ~ 2023/12/17 23:59:59 您需要为每个计费周期预先付费，计费公式如表2所示。 表2 计费公式 资源类型 计费公式 资源单价 自动化流专业版 套餐包单价 * 购买时长 请参见MSSI价格详情中的套餐包单价。 按需计费模式下，各计费项的计费示例请参见计费示例。

计费示例 假设您在2023/10/18 10:58:00开启了一条流，然后在2023/10/18 11:05:05将其删除，则： 第一个计费周期为10:00:00 ~ 11:00:00，在10:58:00 ~ 10:00:00间产生费用，该计费周期内的计费时长为120秒。 第二个计费周期为11:00:00 ~ 12:00:00，在11:00:00 ~ 11:05:05间产生费用，该计费周期内的计费时长为305秒。 您需要为每个计费周期付费，计费公式如表2所示。 表2 计费公式 资源类型 计费公式 资源单价 流运行实例 实例数量*实例单价 * 计费时长 请参见MSSI价格详情中的流运行实例单价。

资源和成本规划 该解决方案主要部署如下资源，每月花费如表1所示，具体请参考华为云官网价格详情，实际收费以账单为准： ECS实例费用需根据实际的迁移服务器规格参考。详细请见 华为云Flexus云服务器X实例计费说明。 弹性公网 EIP 流量费用¥0.82/GB/小时，费用需根据实际使用情况。 迁移服务本身不收费，但在迁移中会产生少量其他服务费用（云硬盘费用及流量费用）。 主机迁移服务 在迁移过程中会在目的端服务器临时创建并挂载一个容量为40 GB的磁盘，用于辅助迁移。有关云硬盘的收费标准，请参见云硬盘价格说明。详细请见 计费说明。 表1 资源和成本规划 华为云服务 配置示例 每月花费 华为云Flexus云服务器X实例 区域：华北-北京四 计费模式：按需计费 规格：X86计算 | Flexus云服务器X实例 | 性能模式（关闭）| 1vCPUs | 1GiB 镜像：CentOS 7.6 64bit 系统盘：超高IO | 40GB 购买量：1 100.80元 弹性公网IP EIP 区域：华北-北京四 计费模式：按流量计费 线路：全动态BGP 带宽大小：10 Mbit/s 购买量：1 0.82/GB/小时 主机迁移 服务 SMS 主机迁移服务本身不收费，但是在迁移过程中会产生少量其他服务费用，本方案采用弹性公网EIP按流量收费。其他服务收费详细请见 计费说明。 创建虚拟机配置模板 区域：华北-北京四 虚拟机规格：（用户输入） / 合计 - 100.80元+0.82/GB/小时

安全组规则修改（可选） 安全组实际是网络流量访问策略，包括网络流量入方向规则和出方向规则，通过这些规则为安全组内具有相同保护需求并且相互信任的云服务器、云容器、云数据库等实例提供安全保护。 如果您的实例关联的安全组策略无法满足使用需求，比如需要添加、修改、删除某个TCP端口，请参考以下内容进行修改。 添加安全组规则：根据业务使用需求需要开放某个TCP端口，请参考添加安全组规则添加入方向规则，打开指定的TCP端口。 修改安全组规则：安全组规则设置不当会造成严重的安全隐患。您可以参考修改安全组规则，来修改安全组中不合理的规则，保证云服务器等实例的网络安全。 删除安全组规则：当安全组规则入方向、出方向源地址/目的地址有变化时，或者不需要开放某个端口时，您可以参考删除安全组规则进行安全组规则删除。

约束与限制 该解决方案部署前，需 注册华为账号 并开通华为云，完成实名认证，且账号不能处于欠费或冻结状态。 源端服务器的 OS 类型需要包含在Linux兼容性列表中。 源端服务器绑定的EIP需保证能正常访问外网。 主机迁移过程中不可以释放/修改弹性公网 EIP。这是由于源端迁移Agent会记录迁移开始时的目的端EIP，并在迁移和同步过程中通过该EIP进行数据传输。在迁移/同步过程中，释放/修改目的端EIP，会造成迁移/同步任务失败。在迁移正常完成后，并且确认后续不再进行数据同步，才可以释放/修改目的端EIP。 主机迁移服务在迁移过程中会在目的端服务器临时创建并挂载一个容量为40 GB的磁盘，用于辅助迁移，该磁盘会在迁移结束后自动删除。迁移期间，请勿对该磁盘进行删除操作或将计费模式转为包周期操作，否则会导致迁移失败。 使用现有安全组进行迁移服务时，必须开放22端口，否则会导致迁移失败。选择新创建安全组，迁移完成后，如需更改安全组，请参照安全组规则修改（可选）。 其它详细约束限制请参考 主机迁移服务 SMS 使用须知。

快速部署 本章节主要指导用户如何自动化部署“Linux服务器迁移上云”解决方案。 表1 参数说明 参数名称 类型 是否可选 参数解释 默认值 template_name string 必填 模板名称，用于定义创建资源前缀，不支持重名。仅支持小写字母、数字、下划线（_）、中划线（-）、英文句号（.）。默认migrate-sms。 migrate-sms task_type string 必填 迁移任务类型，可用值是 MIGRATE_FILE（文件级迁移）和MIGRATE_BLOCK（块级迁移）。默认MIGRATE_FILE。 MIGRATE_FILE source_server_name string 必填 源端服务器名称，不允许重名。取值范围：1-64个字符组成，包括字母、数字、下划线 (_)、连字符 (-) 和点 (.) 空 target_vpc_name string 必填 目的服务器虚拟私有云名称，该模板新建VPC，命名方式为{target_vpc_name}_vpc，不允许重名。取值范围：1-60个字符，支持数字、字母、中文、_(下划线)、-（中划线）、.（点） 空 target_vpc_id string 必填 目的服务器的虚拟私有云ID，如果省略或设置为autoCreate，迁移过程中将自动创建一个新的VPC。默认autoCreate。 autoCreate target_subnet_id string 必填 目的服务器的子网ID，如果省略或设置为autoCreate，迁移过程中将自动创建一个新的子网。默认autoCreate。 autoCreate target_security_group_id string 必填 目的服务器的安全组ID，如果省略或设置为autoCreate，迁移过程中将自动创建一个新的安全组。默认autoCreate。 autoCreate target_volume_type string 必填 目的服务器的磁盘类型，需要与系统所提供的磁盘类型相匹配。目前支持“SSD”，“GPSSD”和“SAS”三种。默认SSD SSD target_flavor string 必填 目的服务器规格，其他规格请参考官网弹性云服务器规格清单。 x1.1u.1g target_server_name string 必填 目的服务器名称，不允许重名。取值范围：1-64个字符组成，包括字母、数字、下划线 (_)、连字符 (-) 和点 (.)。默认Test_target_server。 Test_target_server target_server_syncing bool 必填 指定是否在第一次复制后执行连续同步。默认值为false。 false target_vpc_cidr string 必填 子网的网段，取值范围：必须在vpc对应cidr范围内，约束：必须是cidr格式。掩码长度不能大于28。默认192.168.0.0/16。 192.168.0.0/16 use_public_ip bool 必填 指定是否使用公共 IP 地址进行迁移。默认值为true。 true bandwidth_size number 必填 用于迁移的公共 IP 地址的带宽大小，取值范围：1-300 Mbit/s，默认10Mbit/s。 10 登录华为云解决方案实践，选择“Linux服务器迁移上云”。数据中心下拉菜单可以选择需要部署的区域，单击“一键部署”，跳转至解决方案创建堆栈界面。 图1 解决方案实施库 在选择模板界面中，单击“下一步”。 图2 选择模板 在配置参数界面中，自定义填写堆栈名称，参考表1完成自定义参数填写，单击“下一步”。 图3 参数配置 在资源栈设置页面中，权限委托选择“rf_admin_trust”,单击“下一步”。 图4 资源栈设置 在配置确认页面中，单击“创建执行计划”。 图5 配置确认 单击“创建执行计划”，根据提示输入执行计划名称等，单击“确定”。 图6 创建执行计划 图7 执行计划创建成功 单击“部署”，弹出执行计划提示信息，单击“执行”确认执行。 图8 执行计划确认 等待解决方案自动部署。部署成功后，单击“事件”，回显结果如下: 图9 资源创建成功 图10 执行计划完成 父主题： 实施步骤

名词解释 基本概念、云服务简介、专有名词解释 弹性云服务器 ECS：是一种云上可随时自助获取、可弹性伸缩的计算服务，可帮助您打造安全、可靠、灵活、高效的应用环境。 虚拟私有云 VPC：是用户在华为云上申请的隔离的、私密的虚拟网络环境。用户可以基于VPC构建独立的云上网络空间，配合弹性公网IP、云连接、云专线等服务实现与Internet、云内私网、跨云私网互通，帮您打造可靠、稳定、高效的专属云上网络。 弹性公网 IP：提供独立的公网IP资源，包括公网IP地址与公网出口带宽服务。可以与弹性云服务器、裸金属服务器、虚拟IP、弹性负载均衡、NAT网关等资源灵活地绑定及解绑，提供访问公网和被公网访问能力。 主机迁移服务 SMS：主机迁移服务（Server Migration Service）是一种P2V/V2V迁移服务，可以帮您把X86物理服务器，或者私有云、公有云平台上的虚拟机迁移到华为云弹性云服务器（ECS），从而帮助您轻松地把服务器上应用和数据迁移到华为云。 华为云Flexus云服务器X实例：Flexus云服务器X实例是新一代面向中小企业和开发者打造的柔性算力云服务器。Flexus云服务器X实例功能接近ECS， 同时还具备独有特点，例如Flexus云服务器X实例具有更灵活的vCPU内存配比、支持热变配不中断业务变更规格、支持性能模式等。

创建rf_amdin_trust委托 进入华为云官网，打开控制台管理界面，鼠标移动至个人账号处，打开“统一身份认证”菜单。 图2 控制台管理界面 图3 统一身份认证菜单 进入“委托”菜单，搜索“rf_admin_trust”委托。 图4 委托列表 如果委托存在，则不用执行接下来的创建委托的步骤 如果委托不存在时执行接下来的步骤创建委托 单击步骤2界面中的“创建委托”按钮，在委托名称中输入“rf_admin_trust”，委托类型选择“云服务”，输入“RFS”，单击“下一步”。 图5 创建委托 在搜索框中输入“Tenant Administrator”权限，并勾选搜索结果，单击“下一步”。 图6 选择策略 选择“所有资源”，并单击“下一步“完成配置。 图7 设置授权范围 “委托”列表中出现“rf_admin_trust”委托则创建成功。 图8 委托列表

proc_part_policy_pgjob_to_pgtask() 该函数仅在时序表从8.1.1升级到8.1.3版本时使用，函数用于迁移本数据库所有8.1.1版本时序表的分区管理任务。本函数将遍历本数据库中所有时序表，并检查时序表的分区管理任务是否迁移，如果没有迁移，则调用ts_table_part_policy_pgjob_to_pgtask函数，迁移该时序表的分区管理任务。如果中途出现迁移失败，则整体回滚。 示例： CALL proc_part_policy_pgjob_to_pgtask(); NOTICE: find table, name is cpu1, namespace is public. WARNING: The job on pg_jobs is migrated to pg_task, and the original job is broken, the job what is call proc_drop_partition('public.cpu1', interval '7 d'); , the job interval is interval '1 day'. CONTEXT: SQL statement "call ts_table_part_policy_pgjob_to_pgtask('public', 'cpu1');" PL/pgSQL function proc_part_policy_pgjob_to_pgtask() line 17 at EXECUTE statement WARNING: The job on pg_jobs is migrated to pg_task, and the original job is broken, the job what is call proc_add_partition('public.cpu1', interval '1 d'); , the job interval is interval '1 day'. CONTEXT: SQL statement "call ts_table_part_policy_pgjob_to_pgtask('public', 'cpu1');" PL/pgSQL function proc_part_policy_pgjob_to_pgtask() line 17 at EXECUTE statement NOTICE: find table, name is cpu2, namespace is public. WARNING: The job on pg_jobs is migrated to pg_task, and the original job is broken, the job what is call proc_add_partition('public.cpu2', interval '1 d'); , the job interval is interval '1 day'. CONTEXT: SQL statement "call ts_table_part_policy_pgjob_to_pgtask('public', 'cpu2');" PL/pgSQL function proc_part_policy_pgjob_to_pgtask() line 17 at EXECUTE statement proc_part_policy_pgjob_to_pgtask -------------------------------------- (1 row)

print_sql_part_policy_pgjob_to_pgtask() 该函数仅在时序表从8.1.1升级到8.1.3版本时使用，该函数用于打印SQL语句，每条语句可用于迁移单个8.1.1版本时序表的分区管理任务。由于proc_part_policy_pgjob_to_pgtask函数的迁移粒度是数据库级别，因此引入本函数，使用者可以手动执行本函数的打印内容，以实现单个时序表的迁移粒度。 示例： CALL print_sql_part_policy_pgjob_to_pgtask(); call ts_table_part_policy_pgjob_to_pgtask('public', 'cpu1'); call ts_table_part_policy_pgjob_to_pgtask('public', 'cpu2'); print_sql_part_policy_pgjob_to_pgtask --------------------------------------- (1 row)

get_timeline_count(relname regclass) 函数用于获取时序表在各个DN节点上tag表的行数，只能在CN节点上使用。 参数名 类型 描述 Required/Option relname regclass 时序表的名称。 Required 示例： 建表和导入数据与get_timeline_count_internal函数实例相同，连接CN节点，执行该函数。 1 2 3 4 5 6 select get_timeline_count('cpu'); get_timeline_count -------------------- (dn_1,2) (dn_2,1) (2 rows)