华为云用户手册

导入流程 本节以外部镜像文件格式为zvhd2和raw以外的场景为例，介绍完整的导入流程。 转换镜像格式时，可以使用qemu-img-hw，也可以使用开源工具qemu-img。qemu-img-hw仅适用于Linux操作系统，因此本节提供了基于Linux和Windows操作系统环境的导入指导。 快速导入工具中包含两个子工具，分别实现两项功能：qemu-img-hw（镜像格式转换）、CreateMF.jar（生成位表文件）。 基于Linux操作系统环境 推荐使用云平台的EulerOS云服务器作为操作的环境，流程如图1所示。 图1 导入流程（基于Linux操作系统环境） 详细操作请参见快速导入镜像文件（基于Linux环境）。 基于Windows操作系统环境 推荐使用Windows系统本地PC作为操作的环境，流程如图2所示。 开源镜像转换工具qemu-img不支持将镜像文件转换为zvhd2格式，因此需要转换为raw格式，再使用CreateMF.jar生成位表文件。 图2 导入流程（基于Windows操作系统环境） 详细操作请参见快速导入镜像文件（基于Windows环境）。

创建过程 通过ISO文件创建Windows系统盘镜像的流程如图1所示。 图1 创建过程（Windows系统盘镜像） 步骤说明如下： 为原始ISO文件集成virtio驱动 由于Windows操作系统采用ide磁盘和virtio网卡，因此需要在注册为云平台的镜像前，先在Windows操作系统的ISO文件中集成virtio驱动。详情请参考为原始ISO文件集成virtio驱动。 将ISO文件注册为ISO镜像 在管理控制台上将已集成virtio驱动的ISO文件注册为镜像。该镜像为ISO镜像，不能直接用于发放云服务器。详情请参考将ISO文件注册为镜像（Windows）。 使用ISO镜像创建临时云服务器 使用注册成功的ISO镜像创建一个临时云服务器，该云服务器为空云服务器，即没有操作系统，也未安装任何驱动。详情请参考使用ISO镜像创建Windows云服务器。 为临时云服务器安装操作系统和驱动，并完成相关配置 包含如下操作：安装操作系统、安装virtio驱动、安装PV driver、配置网卡属性等。详情请参考安装Windows操作系统和virtio驱动和配置云服务器并创建Windows系统盘镜像中的步骤1。 将临时云服务器创建为系统盘镜像 在管理控制台上将已完成安装和配置的临时云服务器创建为系统盘镜像。镜像创建成功后，删除临时云服务器避免继续产生费用。详情请参考通过云服务器创建Windows系统盘镜像。

后续操作 数据盘镜像创建成功后，您可能需要创建新的数据盘并挂载到目标云服务器上，有两种方法供您参考： 在创建好的数据盘镜像所在行，单击“申请数据盘”创建新的数据盘（支持批量创建），然后挂载至目标云服务器。 在创建弹性云服务器向导页面，为云服务器添加数据盘时，单击“用数据盘镜像创建磁盘”，然后选择一个数据盘镜像。 此方式下，每个数据盘镜像只可以用来创建一个数据盘，不能重复选择。例如，为云服务器添加了一块数据盘，这个数据盘来源是数据盘镜像data_disk_image，如果想再添加一块数据盘，则不能使用数据盘镜像data_disk_image来创建。 图3 添加数据盘

流程说明 通过外部镜像文件创建数据盘镜像的过程如下： 图1 创建过程 准备符合格式要求的外部镜像文件。当前支持vhd、vmdk、qcow2、raw、vhdx、qcow、vdi、qed、zvhd或zvhd2格式，其他镜像文件，需要转换格式后再导入。 镜像格式转换可参考“通过qemu-img工具转换镜像格式”或“通过qemu-img-hw工具转换镜像格式”。 上传外部镜像文件到OBS个人桶中，注意OBS桶和镜像文件的存储类别必须是标准存储。具体操作可参考上传镜像文件（Linux）。 创建数据盘镜像，具体操作请参见操作步骤。 使用数据盘镜像创建新的数据盘，具体操作请参见后续操作。

背景知识 通过云服务器创建系统盘镜像的过程如下：从现有镜像开始，创建一个云服务器实例，自定义该实例，从该实例创建新的镜像，并最终创建新的实例，如图1所示。 图1 系统盘镜像使用流程 创建系统盘镜像常见于应用扩容场景。也可用于混合云部署场景，为了实现云上及线下资源同步，可以借助镜像导入导出功能，实现过程如下： 基于云服务器制作系统盘镜像 此处的云服务器必须为私有镜像所创建，否则基于该云服务器制作的系统盘镜像不支持导出。 将镜像导出到OBS桶，详情可参阅导出镜像。 下载OBS桶中的镜像文件 无需关闭云服务器即可创建镜像。 创建过程中，对云服务器正在运行的业务没有影响。 创建过程中，请勿改变云服务器状态，不要关闭、开启或者重启云服务器，避免创建失败。 镜像创建时间取决于云服务器系统盘的大小，也与网络状态、并发任务数有关。 云服务器及通过云服务器创建的系统盘镜像属于同一个区域。例如，云服务器所在区域为“华北-北京四”，则通过云服务器创建的系统盘镜像也位于“华北-北京四”。如需在其他区域使用该镜像，请先复制镜像到目标区域，详情可参阅跨区域复制镜像。 如果云服务器已到期或释放，使用您提前创建的系统盘镜像创建新的云服务器，可找回原云服务器中的数据。

前提条件 创建私有镜像前，请您务必执行以下操作： 请将云服务器中的敏感数据删除后再创建私有镜像，避免数据安全隐患。 确保云服务器处于运行中或关机状态。 检查云服务器的网络配置，确保网卡属性为DHCP方式，按需开启远程桌面连接功能。详情请参见设置网卡属性为DHCP（Windows）和开启远程桌面连接功能。 有些云服务器正常运行或者高级功能依赖某些驱动，例如：GPU加速型云服务器依赖Tesla驱动和GRID/vGPU驱动。因此，需要提前安装特殊驱动。详情请参见安装Windows特殊驱动。 检查云服务器中是否已安装一键式重置密码插件，保证镜像创建的新云服务器可以使用控制台的“重置密码”功能进行密码重置。详情请参见安装一键式重置密码插件（Windows）。 检查云服务器中是否已安装Cloudbase-Init工具，保证镜像创建的新云服务器可以使用控制台的“用户数据注入”功能注入初始化自定义信息（例如为云服务器设置登录密码）。详情请参见安装并配置Cloudbase-Init工具。 检查并安装virtio驱动，确保镜像创建的新云服务器支持KVM虚拟化，并且可以提升云服务器网络性能。 详细操作请参见优化过程（Windows）中的步骤2~步骤4。 执行Sysprep操作，确保镜像创建的新云服务器加入域后SID唯一。对于集群部署场景，SID需要保持唯一。详情请参见执行Sysprep。 用于创建系统盘镜像的系统盘，磁盘容量需≤1TB。 系统盘容量大于1TB时，不支持创建系统盘镜像，此时请选择创建整机镜像。 如果待创建私有镜像的云服务器使用的是公共镜像，那么默认已安装一键式重置密码插件和Cloudbase-Init工具，指导中均提供了验证是否安装的方法，您可以参考相应内容确认。

前提条件 用户已经将运行作业所需的程序包和数据文件上传至OBS系统或HDFS中。 本章节示例中使用的jar样例程序为“{集群客户端安装目录}/Spark2x/spark/examples/jars/spark-examples_*.jar”（部分版本集群中Spark2x文件夹名称为Spark，请以实际为准）。 可登录客户端节点执行如下命令，将待运行的jar包样例上传至HDFS中，请参考使用HDFS客户端。 例如上传至HDFS的“/tmp”中： hdfs dfs -put {客户端安装目录}/Spark2x/spark/examples/jars/spark-examples_*.jar /tmp

准备环境 执行以下命令，检查是否已安装Go。 go version 返回如下回显时，说明Go已经安装。 [root@ecs-test confluent-kafka-go]# go version go version go1.16.5 linux/amd64 如果未安装Go，请下载并安装。 执行以下命令，获取demo需要的代码库。 go get github.com/confluentinc/confluent-kafka-go/kafka

离线开发的插件通过了工具检测，上传到平台后，设备日志提示异常？ 问题描述 离线开发的插件包已经通过了编解码插件检测工具检测后，上传平台后，设备日志提示异常。 图5 设备日志错误提示 可能原因 该异常是运行插件代码抛出的异常，一般是相关依赖没有引入或者代码逻辑有误，可根据日志中的Java异常提示进行处理。 解决方法 在离线插件关键代码处（例如decode函数入口处，出口处等）打印日志，并联系 物联网平台 支撑人员在后台获取日志，辅助定位问题。 图6 打印日志样例

设备开发资源 物联网平台支持设备通过MQTT协议、LWM2M/CoAP协议和HTTPS协议进行接入，也可以通过IoTEdge将Modbus、OPC-UA、OPC-DA这些协议的设备接入。设备可以通过调用接口或者集成SDK的方式接入到物联网平台。 资源包名 描述 下载路径 IoT Device SDK(Java) 设备可以通过集成IoT Device SDK(Java)接入物联网平台, Demo提供了调用SDK接口的样例代码。使用指导请参考 IoT Device SDK使用指南（Java）。 IoT Device SDK(Java) IoT Device SDK(C) 设备可以通过集成IoT Device SDK(C)接入物联网平台, Demo提供了调用SDK接口的样例代码。使用指导请参考 IoT Device SDK(C)使用指南。 IoT Device SDK(C) IoT Device SDK(C#) 设备可以通过集成IoT Device SDK(C#)接入物联网平台, Demo提供了调用SDK接口的样例代码。使用指导请参考 IoT Device SDK(C#)使用指南。 IoT Device SDK(C#) IoT Device SDK(Android) 设备可以通过集成IoT Device SDK(Android)接入物联网平台, Demo提供了调用SDK接口的样例代码。使用指导请参考 IoT Device SDK(Android)使用指南。 IoT Device SDK(Android) IoT Device SDK(Go) 设备可以通过集成IoT Device SDK(Go)接入物联网平台, Demo提供了调用SDK接口的样例代码。使用指导请参考 IoT Device SDK(Go)使用指南。 IoT Device SDK(Go) IoT Device SDK(Python) 设备可以通过集成IoT Device SDK(Python)接入物联网平台, Demo提供了调用SDK接口的样例代码。使用指导请参考 IoT Device SDK(Python)使用指南。 IoT Device SDK(Python) IoT Device SDK Tiny (C) 设备可以通过集成IoT Device SDK Tiny (C)接入物联网平台, Demo提供了调用SDK接口的样例代码。使用指导请参考 IoT Device Tiny SDK(C)使用指南 IoT Device SDK Tiny (C) 原生MQTT/MQ TTS 协议接入示例 设备侧可以通过原生MQTT/MQTTS协议接入到物联网平台，Demo提供了SSL加密建链和TCP不加密建链、数据上报、订阅Topic的样例代码。 接入示例参考：Java版、Python版、Android版、C版、C#、NodeJS。 quickStart(Java) quickStart(Android) quickStart(Python) quickStart(C) quickStart(C#) quickStart(Node.js) 产品模型模板 产品模型模板中包含了典型场景的产品模型样例，开发者可以在模板基础进行修改，定义自己需要的产品模型。 使用指导可以参考离线开发产品模型。 产品模型开发示例 编解码插件样例 编解码插件的代码样例工程，开发者可以基于该样例工程进行二次开发。 编解码插件开发样例 编解码插件检测工具 用于检测离线开发的编解码插件的编解码能力是否正常。 编解码插件检测工具 NB-IoT设备模拟器 用于模拟以CoAP/LWM2M协议接入物联网平台的NB设备，实现数据上报和命令下发功能。 使用指导可以参考基于控制台开发产品。 NB-IoT设备模拟器 IoT Link Studio（原名为IoT Studio） IoT Link Studio是针对IoT物联网端侧开发（IoT Device SDK Tiny）的IDE环境，提供了编译、烧录、调试等一站式开发体验，支持 C、 C++、汇编等多种开发语言，让您快速、高效地进行物联网开发。 使用指导可以参考基于NB-IoT小熊派开发智慧路灯。 IoT Link Studio

设备接入方式 华为物联网平台支持多种接入方式，满足各类设备和接入场景要求。请根据设备类型，选择合适的开发模式。 开发模式 特点 适用场景 难度系数 认证MCU开发模式 IoT Device SDK Tiny已经预集成在MCU（Main Control Unit）中，可以直接调用方法连接华为云IoT。 设备商用时间短，研发成本低，无需管理子设备的直连设备。 认证模组开发模式 IoT Device SDK Tiny已经预集成在模组中，通过调用AT指令连接华为云IoT。 需要节省MCU资源，无需管理子设备的直连设备。详细接入方式请参考通过华为认证模组接入。 LiteOS开发模式 设备运行在LiteOS中，通过LiteOS对MCU进行资源管理，同时liteOS内置了IoT Device SDK Tiny，可以通过调用函数连接华为云IoT。LiteOS开发模式的设备开发耗时更短，开发难度也低。 无操作系统，无需管理子设备的直连设备 常规开发模式 集成IoT Device SDK Tiny到MCU中，调用SDK中的函数连接华为云IoT，相比API接入更便捷。 设备商用时间充足，MCU的Flash与 RAM 资源满足IoT Device SDK Tiny集成条件的场景。 Open CPU开发模式 节省一个MCU，使用公用模组中的MCU能力，将设备的应用程序编译运行在OpenCPU上。 安全要求高，体积较小，商用时间短的设备 网关设备开发模式 IoT Device SDK预置到CPU（Central Processing Unit）或者MPU（Main Processing Unit）中，通过调用函数连接到华为云IoT。 管理子设备的网关设备。

接口介绍 API分组 应用场景 产品管理 产品模型定义了该产品下所有设备具备的能力或特征，产品管理为应用服务器提供对已导入物联网平台中产品模型的操作管理功能。 设备管理 设备管理为应用服务器提供对设备的操作管理功能，包括对设备基本信息和设备数据的操作。 设备消息 设备消息为应用服务器提供向设备透传消息的功能。 设备命令 设备的产品模型中定义了物联网平台可向设备下发的命令，设备命令为应用服务器提供向设备下发命令的功能，实现对设备的控制操作。 设备属性 设备的产品模型中定义了物联网平台可向设备下发的属性，设备属性为应用服务器提供向设备下发属性的功能。 AMQP队列管理 AMQP队列管理为客户创建、删除、查看队列。AMQP队列可通过规则订阅后通过AMQP客户端接收消息数据。 接入凭证管理 接入凭证是用于AMQP、MQTTS等协议建立长链接时认证使用。 数据转发、设备联动 规则管理为应用服务器提供物联网平台的规则引擎功能，通过设置规则实现业务的联动变化或将数据转发至其他华为云服务。包含设备联动和数据转发两种类型。 设备联动：包含触发条件和执行动作两部分。当满足设置的触发条件后，触发相应动作，如“下发命令”、“发送通知”、“上报告警”、“恢复告警”。 数据转发：包含设置转发数据、设置转发目标和启动规则三部分。支持转发至“ 数据接入服务 DIS”、“分布式消息服务 Kafka”、“ 对象存储服务 OBS”、“应用与 数据集成平台 ROMA Connect”、“第三方应用服务（HTTP推送）”、“AMQP推送消息队列”、、、。 订阅管理 订阅管理为应用服务器提供对物联网平台资源的订阅功能，若订阅的资源发生变化，平台会通知应用服务器。 设备影子 设备影子是一个用于存储和检索设备当前状态信息的文件，设备影子为应用服务器提供对设备影子的操作管理功能。 每个设备有且只有一个设备影子，由设备ID唯一标识。 设备影子仅保存最近一次设备的上报数据和用户设置的预期数据。 无论该设备是否在线，都可以通过该影子查询和设置设备的状态。 设备组管理 设备组管理为应用服务器提供对设备组的管理操作功能，包括对设备组信息和设备组设备的操作。 标签管理 标签可用于对资源进行分类，标签管理为应用服务器提供对各类资源绑定和解绑标签功能。 当前仅设备支持标签。 资源空间管理 资源空间管理为应用服务器提供对资源空间的管理能力，包括资源空间的增删改查。 批量任务 批量任务为应用服务器提供批量处理功能，对接入物联网平台的设备进行批量操作。 目前提供批量软、固件升级，批量创建/删除/更新设备，批量冻结/解冻设备，批量创建同步/异步命令，批量创建消息和批量配置设备影子的能力。 当前单用户单一任务类型的未完成的任务最大为10，超过则无法创建新的任务。 设备CA证书管理 设备CA证书管理为应用服务器提供对设备CA证书进行操作管理功能，包括对设备CA证书进行上传、验证、查询等操作。物联网平台支持使用证书进行设备接入认证。 OTA升级包管理 OTA升级包管理为应用服务器提供对升级包进行操作管理功能，包括对升级包的创建、查询、删除等操作。 广播消息 广播消息为应用服务器向订阅了指定Topic的所有在线设备发布消息。 设备隧道管理 设备隧道可用于应用服务器与设备进行数据传输。 数据流转积压策略管理 数据流转积压策略管理为应用服务器提供了对积压策略的管理操作功能，包括对数据流转积压策略的创建，查询，修改删除等操作功能。 数据流转流控策略管理 数据流转流控策略管理为应用服务器提供了对流控策略的管理操作功能，包括对数据流转流控策略的创建，查询，修改删除等操作功能。

应用开发资源 为了降低应用的开发难度、提升开发效率，物联网平台开放了应用侧API。应用通过调用物联网平台的API，实现安全接入、设备管理、数据采集、命令下发等业务场景。 资源包名 描述 下载 应用侧开发 API Java Demo 物联网平台为应用服务器提供了应用侧API，能够让开发者快速验证API开放的能力，体验业务功能，熟悉业务流程。 API Java Demo 应用侧开发 Java SDK Java SDK提供Java方法调用应用侧API与平台通信。使用指南可以参考Java SDK使用指南。 Java SDK 应用侧开发 C# SDK C# SDK提供C#方法调用应用侧API与平台通信。使用指南可以参考C# SDK使用指南。 C# SDK 应用侧开发 Python SDK Python SDK提供Python方法调用应用侧API与平台通信。使用指南可以参考Python SDK使用指南。 Python SDK 应用侧开发 Go SDK Go SDK提供Go方法调用应用侧API与平台通信。使用指南可以参考Go SDK使用指南。 Go SDK 应用侧开发 Node.js SDK Node.js SDK提供Node.js方法调用应用侧API与平台通信。使用指南可以参考Node.js SDK使用指南。 Node.js SDK 应用侧开发 PHP SDK PHP SDK提供PHP方法调用应用侧API与平台通信。使用指南可以参考PHP SDK使用指南。 PHP SDK

消息结构 字段名 字段类型 描述和要求 起始标识 WORD 起始标识，固定为0XFFFE。 版本号 BYTE 高四位预留；低四位表示协议版本号，当前为1。 消息码 BYTE 标识物联网平台与设备之间的请求消息类型，应答消息的消息码和请求消息相同。消息码的定义为： 0-18：预留消息码，暂未使用。 19：查询设备版本。 20：下载新版本软件包通知。 21：请求下载升级包。 22：上报升级包下载结果。 23：执行软件升级。 24：上报升级结果。 25-127：预留消息码，暂未使用。 校验码 WORD 从起始标识到数据区的最后一个字节的CRC16校验值，计算前先把校验码字段置为0，计算完成后把结果写到校验码字段。 说明： CRC16算法：CRC16/CCITT x16+x12+x5+1 数据区长度 WORD 数据区的长度。 数据区 BYTE[n] 可变长度，具体由各个指令定义，可参考下面介绍的各个指令对应的请求消息和应答消息定义。

PCP消息识别 由于PCP协议消息和设备业务消息共用一个端口和URL通讯，平台收到设备的消息时，按照如下步骤判断是PCP协议消息还是业务消息： 检查设备是否支持软件升级（根据设备profile的omCapability.upgradeCapability定义），如果不支持，则认为是业务消息。 检查设备软件升级协议是否是PCP，如果不是，则认为是业务消息。 检查消息前两个字节是否为0XFFFE，如果不是，则认为是业务消息。 检查版本号是否合法，如果不合法，则认为是业务消息。 检查消息码是否合法，如果不合法，则认为是业务消息。 检查校验码是否正确，如果不正确，则认为是业务消息。 检查数据区长度是否正确，如果不正确，则认为是业务消息。 如果以上检查都通过，认为是PCP协议消息。 对设备的要求：需要设备保证业务消息的起始字节不是0XFFFE。

响应消息 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 interfaceAttachments Array of objects 云服务器网卡信息列表，详情请参见表3。 attachableQuantity Object 云服务器可挂载网卡数，详情请参见表4 表3 interfaceAttachments字段数据结构说明 参数 参数类型 描述 port_state String 网卡端口状态。 fixed_ips Array of objects 网卡私网IP信息列表，详情请参见表5。 net_id String 网卡端口所属网络ID（network_id）。 port_id String 网卡端口ID。 mac_addr String 网卡Mac地址信息。 delete_on_termination Boolean 卸载网卡时，是否删除网卡。 true: 删除； false: 不删除 driver_mode String 网卡的驱动类型，预留字段，默认取值为virtio。 min_rate Integer 网卡带宽下限。 multiqueue_num Integer 队列个数。 取值范围为 1, 2, 4, 8, 16，28。 pci_address String 弹性网卡在Linux GuestOS里的BDF号。 说明： 网卡不支持时，返回为空。 表4 attachableQuantity字段数据结构说明 参数 参数类型 描述 free_nic Integer 云服务器剩余可挂载网卡数量。 表5 fixed_ips字段数据结构说明 参数 参数类型 描述 subnet_id String 网卡私网IP对应子网信息。 ip_address String 网卡私网IP信息。

响应示例 { "interfaceAttachments": [ { "port_state": "ACTIVE", "fixed_ips": [ { "subnet_id": "ba31e1f5-fa76-4530-862c-5176fad033cf", "ip_address": "192.168.0.33" } ], "net_id": "610a4af2-1d90-4d2b-8057-dc238b26febf", "port_id": "04819c0a-6a07-44b6-945e-fb932071888e", "mac_addr": "fa:16:3e:45:65:c4" } ] }

请求示例 变更专属主机上的云服务器的规格为“s3.large.2”，自动支付且支持开机状态下变更规格。 POST https://{endpoint}/v1.1/{project_id}/cloudservers/{server_id}/resize { "resize": { "flavorRef": "s3.large.2", "dedicated_host_id": "459a2b9d-804a-4745-ab19-a113bb1b4ddc", "extendparam":{ "isAutoPay": "true" }, "mode": "withStopServer" } }

响应示例 { "job_id": "ff80808288d41e1b018990260955686a" } 或 { "order_id": " CS 1711152257C60TL", "job_id": "ff80808288d41e1b018990260955686a" } 或 { "error": { "message": "XXXX", "code": "XXX" } }

请求消息 表2 参数说明 名称 是否必选 参数类型 描述 resize 是 Object 标记为云服务器变更规格操作，详情参见 表3。 dry_run 否 Boolean 是否只预检此次请求。 true：发送检查请求，不会变更云服务器规格。检查项包括是否填写了必需参数、请求格式等。 如果检查不通过，则返回对应错误。 如果检查通过，则返回202状态码。 false：发送正常请求，通过检查后并且执行变更云服务器规格请求。 表3 resize数据结构说明 名称 是否必选 参数类型 描述 flavorRef 是 String 变更后的云服务器规格ID。 可以通过 查询云服务器规格变更支持列表 接口查询允许变更的规格列表。 说明： 不支持变更至同一规格。 dedicated_host_id 否 String 新专属主机ID。 仅对于部署在专属主机上的弹性云服务器，该参数必选。 extendparam 否 Object 变更云服务器扩展信息，详情参见 表4。 mode 否 String 取值为withStopServer ，支持开机状态下变更规格。 mode取值为withStopServer时，对开机状态的云服务器执行变更规格操作，系统自动对云服务器先执行关机，再变更规格，变更成功后再执行开机。 cpu_options 否 Object 自定义CPU选项。 详情请参见表5。 表4 extendparam数据结构说明 名称 是否必选 参数类型 描述 isAutoPay 否 String 下单订购后，是否自动从客户的账户中支付，而不需要客户手动去进行支付。 “true”：是（自动支付） “false”：否（需要客户手动支付） 说明： 当弹性云服务器是按包年包月计费时生效，该值为空时默认为客户手动支付。 表5 cpu_options数据结构说明 参数 是否必选 参数类型 描述 hw:cpu_threads 否 integer 用于控制CPU是否开启超线程。 取值范围：1，2。 1: 关闭超线程。 2: 打开超线程。 需要同时满足如下条件，才能设置为“关闭超线程”： 只能在实例创建或者resize时指定。 只有目标flavor的extra_specs参数： 存在“hw:cpu_policy”并取值为“dedicated”。 存在“hw:cpu_threads”并取值为“2”。

步骤4：查看与执行操作命令 本节以Windows为例介绍eihealth-toolkit的使用过程，Linux和macOS环境使用方法基本相同，可参考。配置信息导入后，即可查询命令行工具支持的操作，并执行相关命令，使用 EIHealth 平台。 详细的操作命令请参见其他章节。 查询操作命令列表。 执行health --help查询支持的操作命令。Linux系统下，需添加./指定当前路径。 执行操作命令，获取项目信息。 执行health get project命令查询当前账号下所拥有的项目和项目信息。Linux系统下，需添加./指定当前路径。 使用数据、应用、流程、作业命令时，需先使用switch命令进入待操作的项目中。使用逻辑与EIHealth平台一致，进入项目，再对项目内的数据等内容进行操作。 命令行的参数缩写支持合并使用，例如，-r -s 可以写成-rs。 父主题： 获取并使用命令行工具eihealth-toolkit

获取AK/SK AK/SK（Access Key ID/Secret Access Key）即访问密钥，包含访问密钥ID（AK）和秘密访问密钥（SK）两部分，华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。 登录华为云管理控制台，鼠标指向页面右上角的用户名，在下拉列表中单击“我的凭证”。 图1 我的凭证入口 在“我的凭证”页面中选择“访问密钥”页签。单击“新增访问密钥”，按操作指引获取认证账号的AK/SK，请妥善保管AK/SK信息。 图2 访问密钥 每个用户仅允许新增两个访问密钥。 为保证访问密钥的安全，访问密钥仅在初次生成时自动下载，后续不可再次通过管理控制台页面获取。请在生成后妥善保管。

安装eihealth-toolkit 本示例中以Windows系统为例，介绍安装命令行工具的方法。 获取Windows版本的命令行工具，得到health.exe文件，health文件无需安装，放置在任一文件夹中即可。 图1 下载命令行工具 使用win键+R，输入cmd打开windows的cmd窗口。进入工具所在的目录，输入health命令，即可使用。 如果cmd窗口显示目录不是health文件所在目录，请使用cd命令切换路径。例如，切换至D盘： cd /d d: 图2 客户端 本示例中以Linux系统为例，介绍安装命令行工具的方法。 获取Linux版本的命令行工具，得到health文件，health文件无需安装，放置在任一文件夹中即可。 假设health存放在/home/user-name/test/client目录，请使用cd命令进入health所在目录。 cd /home/user-name/test/client/ 图3 客户端 使用Linux版本命令行工具时，您需要在本地搭建Linux环境，并将下载的health文件放至所需的目录下。macOS执行命令和linux一致， 如果当前目录为health所在目录，可以使用./health命令使用命令行工具。 如果当前目录不是health所在目录，需要使用绝对路径。如当前目录为/opt，假设health存放在/root/health-toolkit/下，需要指定/root/health-toolkit/health路径进行使用。 如果无法运行，提示Permission denied，使用chmod 755 health命令设置执行权限。

下载命令行工具eihealth-toolkit 针对不同操作系统，eihealth-toolkit下载地址如下所示。 表1 下载列表 支持平台 下载地址 Windows 64位 health-windows-x86_64.zip、health-windows-x86_64.zip.sha256 Linux ARM 64位 health-linux-aarch64.tar、health-linux-aarch64.tar.sha256 Linux AMD 64位 health-linux-x86_64.tar、health-linux-x86_64.tar.sha256 macOS health-macOS-x86_64.tar、health-macOS-x86_64.tar.sha256 本页面命令行工具下载后，在使用时，需用到您 注册华为账号 并开通华为云时提供的用户名等信息，用于登录并操作EIHealth平台的项目、数据等资产。这些信息的处理将遵循您已接收的《华为云用户协议》及《隐私政策声明》约束。 下载地址中带有sha256后缀的链接，指的是对应软件包的校验文件。例如：Windows x64版本的下载链接是health-windows-x86_64 ，它的校验文件下载链接则是health-windows-x86_64.zip.sha256。

命令结构 health edit compute-resources [flags] 表1 参数说明 参数 简写 是否必选 描述 --force -f 否 是否强制操作。 --labels -l 否 需要添加或删除的标签列表。json数组格式。如：-l "[\"h1\",\"h2\"]" --node -n 是 计算资源节点id --operation-type -t 是 对计算资源的操作：[add-labels \| delete-labels \| stop \| reboot \| start \| schedulable \| non-schedule]。add-labels：添加计算节点标签。delete-labels：删除计算节点标签。stop：停止节点。reboot：重启节点。start：启动节点。schedulable：设置节点可被调度。non-schedule：设置节点不可被调度

命令示例 删除计算节点标签 health edit compute-resources -t delete-labels -l "[\"h1\",\"h2\"]" -n 9b1727a3-2102-4d92-95b9-7eaa86b398ac edit compute resources using the delete-labels mode is successful 添加计算节点标签 health edit compute-resources -t add-labels -l "[\"h1\",\"h2\"]" -n 9b1727a3-2102-4d92-95b9-7eaa86b398ac the edit compute-resources using add-labels mode is successful 设置节点可调度 health edit compute-resources -t schedulable -n 9b1727a3-2102-4d92-95b9-7eaa86b398ac the edit compute-resources using schedulable mode is successful 停止计算节点 health edit compute-resources -t stop -n 9b1727a3-2102-4d92-95b9-7eaa86b398ac The stop operation is started successfully...

下载命令行工具eihealth-toolkit 针对不同操作系统，eihealth-toolkit下载地址如下所示。 表1 下载列表 支持平台 下载地址 Windows 64位 health-windows-x86_64.zip、health-windows-x86_64.zip.sha256 Linux ARM 64位 health-linux-aarch64.tar、health-linux-aarch64.tar.sha256 Linux AMD 64位 health-linux-x86_64.tar、health-linux-x86_64.tar.sha256 macOS health-macOS-x86_64.tar、health-macOS-x86_64.tar.sha256 本页面命令行工具下载后，在使用时，需用到您注册华为账号并开通华为云时提供的用户名等信息，用于登录并操作EIHealth平台的项目、数据等资产。这些信息的处理将遵循您已接收的《华为云用户协议》及《隐私政策声明》约束。 下载地址中带有sha256后缀的链接，指的是对应软件包的校验文件。例如：Windows x64版本的下载链接是health-windows-x86_64 ，它的校验文件下载链接则是health-windows-x86_64.zip.sha256。

产品功能 eihealth-toolkit提供了以下功能： 系统设置 您可以使用该工具获取系统标签、系统资源、系统配额信息、消息列表，查询和修改消息及完成作业保留配置，也可以获取和修改供应商logo、名称设置。 项目管理 您可以使用该工具获取、切换、创建、更新、删除和转移项目，也可以添加、修改、移除项目成员角色。 数据管理 您可以使用该工具查看、上传、下载、复制、导入、引入、创建和删除项目中的数据，创建、获取、删除、恢复归档数据，也可以对数据作业执行获取、删除、重试、取消操作。 数据库管理 您可以使用该工具创建、获取、删除和导入数据库模板，创建、获取和删除数据库实例，也可以引用数据库。 镜像管理 您可以使用该工具对镜像执行标记、上传、下载、查询、导入、更新和删除标签等操作。 应用管理 应用是生物信息学软件和运行该软件所依赖的运行环境的镜像封装。 您可以使用该工具创建应用，并进行修改、删除、查询、导入操作。 流程管理 流程包含分析过程中所需应用的执行信息和数据的输入、输出等参数定义，流程至少由一个应用组成。 您可以使用该工具创建流程，并进行修改、删除、查询、导入操作。对于由多个应用构成的流程，可通过设置不同应用的输入、输出关系搭建为流程。 作业管理 您可以使用该工具启动分析作业，并进行查询、删除、重试、取消操作。 notebook 您可以使用该工具创建notebook，并进行查询、编辑、删除和启停等操作。

命令示例 本节以Windows为例介绍eihealth-toolkit的使用过程，Linux和macOS环境使用方法基本相同，可参考。 获取计算资源列表 health get resource -t computing # 执行成功返回结果如下 Id Name Specifications Billing Mode Data Disk Status Purchased Schedulable 8a178a22-38ca-4707-bab3-e12324cdc96d health-ef0ec0fb-4022-46c9-898e-fbd440b44c09 eihealth.cpu.spec.cpu4.4xlarge.2 Pay-per-use SAS|200GB ACTIVE 2024-01-02 17:30:28 true 获取性能加速资源列表 health get resource -t performance # 执行成功返回结果如下 ID Name Specifications Billing Mode Used Capacity Used Capacity Percent Max.Capacity Job Quota Status Purchased Running Jobs 01c24e2f-2038-4718-acb0-a0c388a2f93c sfs-turbo-218766ac-5855-4ad4-a5fd-67130951afdd eihealth.storage.ioacc.spec.ioacc xxx 0.00GB 0.00% 100GB 1 ACTIVE / Schedulable 2023-01-19 21:57:51 0 获取数据库资源列表 health get resource -t database # 执行成功返回结果如下 Name Specifications Billing Mode Usage Data Disk Status Purchased 医疗智能体 数据库标准版 200 GB eihealth.dbm.spec.standard.200g(4vCPUS|8GB) Pay-per-use 2.36GB 40GB NORMAL 2023-12-27 16:07:12 获取存储资源列表 health get resource -t storage # 执行成功返回结果如下 Name Specifications Billing Mode Usage Purchased EIHealthSingleAZStoragePackage eihealth.storage.spec.singleaz xxx 4.06TB 2021-09-10 20:58:03 获取计算资源节点标签 health get resource -t computing -a get-labels -n 9b1727a3-2102-4d92-95b9-7eaa86b398ac 1 111 123 copy-in 获取计算资源规格列表 health get resource -t computing -a flavors -z cn-north-7c Flavor Name vCPUs | Memory Assured/Maximum Bandwidth Packets per Second(PPS) Sold Out eihealth.cpu.spec.cpu1.8xlarge.2 32vCPUS/64GB 8/15 Gbit/s 2600000 pps true eihealth.cpu.spec.cpu1.8xlarge.4 32vCPUS/128GB 8/15 Gbit/s 2600000 pps true eihealth.cpu.spec.cpu1.15xlarge.2 60vCPUS/128GB 16/16 Gbit/s 5000000 pps true eihealth.cpu.spec.cpu1.15xlarge.4 60vCPUS/256GB 16/16 Gbit/s 5000000 pps true eihealth.cpu.spec.cpu3.xlarge.2 4vCPUS/8GB 2.4/8 Gbit/s 800000 pps false eihealth.cpu.spec.cpu3.2xlarge.2 8vCPUS/16GB 4.5/15 Gbit/s 1500000 pps false eihealth.cpu.spec.cpu3.4xlarge.2 16vCPUS/32GB 9/20 Gbit/s 2800000 pps true eihealth.cpu.spec.cpu3.8xlarge.2 32vCPUS/64GB 18/30 Gbit/s 5500000 pps true eihealth.cpu.spec.cpu3.8xlarge.4 32vCPUS/128GB 18/30 Gbit/s 5500000 pps true

命令结构 health get resource [flags] 表1 参数说明 参数 简写 是否必选 说明 --type -t 是 名称，支持computing、performance、database、storage，分别代表计算资源、性能加速资源、数据库资源和存储资源。 --action -a 否 查询计算节点方式。 取值范围： get-labels：获取计算资源标签列表。get-labels要和--node一起组合使用。 list：获取计算资源列表。 flavors：获取可用区下的计算节点规格列表。 默认值：list。 --node -n 否 计算节点id。设置了--label后使用，获取某个计算资源节点下的标签列表。 --zone -z 否 可用区id。如：cn-north-7c。