华为云用户手册

快照方式制作镜像 如果后续镜像没有变化，可通过快照方式制作镜像。 快照方式制作镜像示例： 本示例中使用华为云弹性云服务器服务（E CS ）创建一台云服务器，并使用快照方式制作bwa镜像。 购买弹性云服务器。 云服务器创建成功后，在图1页，选中待登录的弹性云服务器。单击“远程登录”，输入ECS初始账号，登录ECS。 图1 云服务器列表 安装容器引擎。 例如，在Linux操作系统下，可以使用如下命令快速安装容器引擎。 curl -fsSL get.docker.com -o get-docker.sh sh get-docker.sh 启动一个空白的基础容器，并进入容器。 例如，启动一个CentOS容器。 docker run -it centos 安装依赖包。 yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm yum -y install git yum -y install gcc automake autoconf libtool make yum install -y zlib zlib-devel 安装bwa软件，在github上下载bwa的源代码，并使用make编译。 yum install bwa git clone https://github.com/lh3/bwa.git cd bwa;make 请预先安装好Git，并检查本机是否有ssh key设置。 输入exit退出容器。 查询容器id。 docker ps -a 制作快照。 docker commit -m "xx" -a "tsj" container-id tsj/image:tag 例如：docker commit -m "test" -a "username" adb1127979a1 bwa:v0.7 -a：提交的镜像作者，例如tsj。 container-id：容器id。 -m：提交时的说明文字，例如xx。 tsj/image:tag：仓库名/镜像名:TAG名，名称可自定义。 执行docker images查看制作完成的Docker镜像。

实名认证类型介绍 表1 实名认证详细介绍 账号类型 认证类型（任选一种类型） 详细操作指导 个人账号 推荐扫码认证（即时完成认证） 请参见如何进行扫码认证。 银行卡认证（即时完成认证） 请参见如何进行银行卡认证。 证件认证（1-3个工作日） 请参见如何进行证件认证。 企业账号 推荐银行对公账户认证（最快30分钟） 请参见如何进行企业银行对公账户打款认证。 企业证件认证（0-3个工作日） 请参见如何进行企业证件认证。

OBS存储类型的Notebook 在创建Notebook时，如果“存储配置”选择的是“OBS”。Notebook列表的所有文件读写操作是基于所选择的OBS路径下的内容操作，即Notebook中的数据和OBS中的数据是同步的。在OBS路径中创建文件夹、上传数据，会同步到Notebook中，Notebook中的操作也会同步到OBS中，如图2所示。 图2 通过OBS同步数据 图3 Notebook中的文件 “Upload”上传数据大小受限时，您可以通过以下多种方式将文件上传到OBS中，通过OBS与Notebook进行数据同步。 表1 上传数据方法 上传方法 说明 “数据”页面上传 通过“数据”页面上传数据，支持上传最大为1GB的单个文件。 使用obsutil工具上传 您可以使用obsutil工具对OBS进行常用的配置管理操作，如创建桶、上传文件/文件夹、下载文件/文件夹、删除文件/文件夹等。

为什么下载的部分靶点文件，显示不完整 由于molstar插件自身问题，部分靶点文件中存在REMARK行，会导致受体展示不完整。可通过手动删除文件中REMARK行来解决该问题。 如下所示： 分子优化靶点设置界面，受体展示正常。 但是下载该靶点文件后，使用通用工具Mol 3D Viewer打开，会出现蛋白显示不完整的情况，如下图所示。 此时可将受体文件中的REMARK行进行删除，即可解决该问题。 父主题： 小分子药物设计类

在Terminal中安装 例如，通过terminal在“TensorFlow-1.8”的环境中使用pip安装Shapely。 打开一个Notebook实例。 在Jupyter控制面板中，选择“New”（新建）然后选择“Terminal”。 在代码输入栏输入以下命令，获取激活TensorFlow-1.8的命令并激活环境。 cat /home/ma-user/README source /home/ma-user/anaconda3/bin/activate TensorFlow-1.8 如果使用其他引擎，请将命令中“TensorFlow-1.8”替换为其他引擎的名称及其版本号。 图1 激活环境 在代码输入栏输入以下命令安装Shapely。 pip install Shapely

操作步骤 登录华为云管理控制台，鼠标指向页面右上角的用户名，在下拉列表中单击“我的凭证”。 图1 我的凭证入口 在“我的凭证”页面中选择“访问密钥”页签。单击“新增访问密钥”，按操作指引获取认证账账号的AK/SK，请妥善保管AK/SK信息。 图2 访问密钥 每个用户仅允许新增两个访问密钥。 为保证访问密钥的安全，访问密钥仅在初次生成时自动下载，后续不可再次通过管理控制台页面获取。请在生成后妥善保管。

步骤2：制作镜像 方法1：直接下载官方的FastQC镜像。 执行如下命令下载FastQC镜像。 docker pull biocontainers/fastqc:v0.11.5 方法2：通过Dockerfile制作FastQC镜像。 执行vi Dockerfile命令，进入Dockerfile文件中，编写文件。 FROM ubuntu:16.04 # FastQC依赖java运行，需安装java环境。安装执行下载、解压缩的软件包 RUN apt-get update && apt-get upgrade -y \ && apt-get install -y default-jre perl wget zip # 下载FastQC，解压缩，设置FastQC可执行权限 RUN wget https://www.bioinformatics.babraham.ac.uk/projects/fastqc/fastqc_v0.11.5.zip \ && unzip fastqc_v0.11.5.zip \ && rm fastqc_v0.11.5.zip \ && chmod +x /FastQC/fastqc # 将FastQC添加到环境变量中 ENV PATH "/FastQC:$PATH 按Esc键，并执行:wq退出Dockerfile。 制作镜像。 docker build -t fastqc:v0.11.5 . 详细的Dockerfile指令请参见Dockerfile参考。

步骤4：创建应用 在“我的空间”页面“应用”页签中，单击“创建应用”。 填写应用的基本信息。 “名称”填写fastqc，“版本”填写v0.11.5.2。“短描述”、“图标”、“长描述”、“标签”可选填。 图2 填写基本信息 选择镜像。 单击“选择镜像”，在镜像列表中选择fastqc镜像和镜像版本。 依据FastQC命令说明填写镜像启动命令。 镜像启动命令需要引用输入、输出参数中的变量，并以大括号扩起，以$符号进行引用。 fastqc软件输入参数填写为input-file、threads，输出参数为output-dir，则镜像启动命令如下所示。 使用-t命令，指定运行所需的线程数量。-o命令，指定存放输出结果的文件夹。输入文件夹已在填写参数时指定。 fastqc -t ${threads} -o ${output-dir} ${input-file} 选择“X86”CPU架构，CPU需求建议0.2起。GPU类型选择“无”。 按需填写内存大小，单位为GB。FastQC运行中所需内存大小依赖于输入数据大小，建议至少1GB。 图3 CPU、内存、GPU 填写参数。 通过阅读FastQC命令说明，了解命令。 图4 FastQC命令 填写所需的输入参数。 图5 输入参数 填写所需的输出参数。 因镜像启动命令中指定了输出参数，设置输出参数时，需勾选“必传”，并填写“默认值”。例如，输出结果默认存放在fastqc_output文件夹中。 图6 输出参数 单击“立即创建”，完成fastqc应用的创建。 创建完成后的应用，将显示在应用列表中，您可以使用该应用创建分析作业。

步骤1：搭建Docker环境 搭建Docker环境，您可以任选以下两种方式搭建Docker环境。 使用自己的电脑搭建Docker环境。 使用华为云弹性 云服务器ECS 搭建Docker环境。 本示例中使用华为云弹性服务器ECS，并通过ECS搭建Docker环境。在创建ECS时，可以选择ECS的操作系统。例如，在Linux操作系统下，可以使用如下命令快速安装容器引擎。 curl -fsSL get.docker.com -o get-docker.sh sh get-docker.sh 检查安装结果。 执行docker --version命令，如果显示如下类似信息，表示Docker安装成功。 图1 Docker安装成功

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux和macOS环境使用方法基本相同，可参考。 ai4s get label # 执行成功返回结果如下 Id Label Creator Created Updated Description d242057-46af-11ed drug-screening lmx 2021-02-01 11:11:27 2021-02-01 11:11:27 药物筛选 8942046-46af-11ed eiflow hpw 2021-02-01 11:11:27 2021-02-01 11:11:27 流程编排 2642052-46af-11ed project lmx 2021-02-01 11:11:27 2021-02-01 11:11:27 project manage

命令结构 执行ai4s config add命令进行初始化配置。 ai4s config add [flags] 表1 参数说明 参数 简写 是否必选 说明 --domain-name -d 是 与管理员（购买平台的账户）的账号名一致。 --user-name -u 是 子用户的用户名。 管理员（购买平台的账户）登录时，user-name和domain-name一致。 --password -w 是 密码。 --ak -a 是 AK(Access Key ID)：访问密钥ID。 --sk -s 是 SK(Secret Access Key)：与访问密钥ID结合使用的密钥。 --region -r 是 服务区 域名 称。依据购买服务所在的区域进行选择，可选cn-north-4、cn-east-3、cn-south-1。 --platform-id -i 是 项目ID，获取方法请参见获取认证信息。 --iam-endpoint -m 否 IAM 终端节点名称，请在地区与终端节点中获取。 --ai4s-endpoint -e 否 AI4S终端节点名称，请在地区与终端节点中获取。 --log-path -l 否 日志路径，不填写时默认为命令行工具当前路径下ai4s.log文件。 路径设置格式： Windows系统为“路径\文件名”。 Linux系统格式为“路径/文件名”。 --http-proxy -p 否 HTTP代理配置，格式为“http://username:password@your-proxy:your-port”。

命令示例 初始化配置 ai4s config add -d xxx -u xxx -w xxx -i xxx -r cn-north-4 -o obs.cn-north-4.myhuaweicloud.com -a xxx -s xxx -D https://xxx -q xxx –f -m xxx -e xxx -t xxx # 执行成功返回结果如下 add ak successfully! add sk successfully! add region successfully! add platform-id successfully! add user-name successfully! add password successfully! add domain-name successfully! add iam-endpoint successfully! add ai4s-endpoint successfully! 初始化配置并设置日志存储路径 ai4s config add -d xxx -u xxx -w xxx -i xxx -r cn-north-4 -o obs.cn-north-4.myhuaweicloud.com -a xxx -s xxx -D https://xxx -q xxx --log-path D:\log\ai4s.log –f -m xxx -e xxx -t xxx # 执行成功返回结果如下 add ak successfully! add sk successfully! add region successfully! add platform-id successfully! add user-name successfully! add password successfully! add domain-name successfully! add obs-endpoint successfully! add log-path successfully! add iam-endpoint successfully! add ai4s-endpoint successfully! add swr-endpoint successfully! 初始化配置并设置日志存储路径 ai4s config add -d xxx -u xxx -w xxx -i xxx -r cn-north-4 -a xxx -s xxx -D https://xxx -q xxx --log-path D:\log\ai4s.log # 执行成功返回结果如下 add ak successfully! add sk successfully! add region successfully! add platform-id successfully! add user-name successfully! add password successfully! add domain-name successfully! add log-path successfully! 清空配置请执行ai4s config clear命令 在Notebook中使用命令行工具 在AI科学计算服务控制台开发环境Notebook中使用命令行工具时，请依据以下步骤配置代理。 打开Notebook，并选择Terminal，打开Notebook的命令行界面。 执行以下命令下载命令行工具，并获取配置Notebook代理所需的域名和端口信息。 示例中下载的版本为Linux ARM 64位。 wget https://eihealth-cli.obs.cn-north-4.myhuaweicloud.com/current/ai4s-linux-aarch64.tar 初始化配置时，添加--http-proxy命令，用于配置代理。 ai4s config add --http-proxy http://域名:端口号 执行以上命令，会在系统所在的用户目录下自动生成“.ai4s”文件夹，文件夹中包含config.ini配置文件，用于存储任务执行所涉及到的配置，如密钥、区域、当前空间等信息。 生成的配置文件不建议直接修改，如需改动请使用命令行工具修改。 配置文件中保存有用户的AK、SK信息，为了避免密钥泄露，会对文件中的SK进行加密以保护密钥安全。 初始化配置时，如果命令同时填写了AK/SK和密码，默认AK/SK方式登录。 初始化配置命令会在history中暴露ak、sk，建议使用set +o history命令关闭history再执行。执行后可使用set -o history命令恢复。

清理命令记录 为防止配置文件中的敏感信息泄露，建议使用ai4s config clear命令定时清除本地配置文件。 对于执行的历史命令，可通过以下方法清除。 Linux：执行history -c命令清除历史记录，重新登录命令行工具后，记录可恢复。执行rm -f $HOME/.bash_history命令，可删除记录文件，清空历史。 macOS系统：执行ps -p $$命令检查shell类型。 类型为bash：操作与Linux系统相同。 类型为zsh：执行history -p命令清除历史记录，重新登录命令行工具后，记录可恢复。执行rm -rf ~/.zsh_history命令，退出终端后再次执行history -p命令可删除记录文件，清空历史。 windows系统：对于当前执行的命令，可通过关闭cmd窗口实现历史命令的清理。

命令示例 ai4s docker pull demo-project/demo-image:v1.0 # 执行成功返回结果如下 6be353e4af51: Pull complete Digest: sha256:8c00710a899746ec54677db64fd3284d2f880bd6265eb0347be1e0cb1cce6530 Status: Downloaded newer image for demo-project/demo-image:v1.0

命令示例 Linux ./ai4s docker update lmx-project-01/demo-image --type APP --description 'this is a demo' Windows ai4s docker update lmx-project-01/demo-image --type APP --description "this is a demo" 不填写空间名时，若当前所在空间是lmx-test-01，则执行如下命令后会更新当前空间中源空间为lmx-test-01的镜像demo-image的类型。 ai4s docker update demo-image --type APP --chip ARM # 执行成功返回结果如下 update image successfully!

命令结构 ai4s get app ID [flags] 表1 参数说明 参数 简写 是否必选 说明 ID 无 否 不选此参数时，列出当前所在空间的所有应用信息。 指定app-id或app-name:version:srcproject，列出具体应用的信息，srcproject为源空间名称，可选。不指定srcproject时，默认为当前空间。例如GATK:4.0:projectname。 --sample -s 否 获取应用模板，模板为yaml格式。 --downloadPath -d 否 获取应用详情时，将内容下载到的指定文件夹路径（文件夹需要存在）。 --project 无 否 指定空间名。未填写则使用配置文件中的空间名。 --label -l 否 根据label标签搜索应用。

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 ai4s update member demo-user --project demo-project --role Viewer # 执行成功返回结果如下 modify the role of member demo-user to Viewer successfully!

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 使用ai4s get job -s命令获取模板，详细的模板介绍和使用请参见获取作业模板。 获取作业详情，以模板方式展示。 ai4s get job 000c6057-cc6c-11ed-bbec-fa163ef30f89 job: id: 000c6057-cc6c-11ed-bbec-fa163ef30f89 name: job-7402 description: "" priority: 0 timeout: 1440 output_dir: /job-7402-de91a3e0-076c-4327-a41c-8e88c7aec6ae workflow_id: f1af14bb-cc69-11ed-bbec-fa163ef30f89 io_acc_id: "" node_labels: [] tasks: - task_name: task-1-test-echo inputs: [] resources: cpu: 0.1C memory: 0.1G gpu: "0" tool_type: workflow tool_id: f1af14bb-cc69-11ed-bbec-fa163ef30f89 labels: [] 获取作业详情，以json方式展示。 ai4s get job f17a3542-3f7c-11eb-868a-fa163e3ddba1 --detail { "jobs": [{ "id": "2", "name": "zx-1030-mkdir", "description": "测试文件创建", "priority": 0, "timeout": 1440, "output_dir": "", "status": "SUCCEEDED", "create_time": "2021-01-20T03:38:14Z", "finish_time": "2021-01-20T03:43:23Z", "tool_info": { "tool_id": "", "tool_name": "", "tool_version": "", "tool_type": "" }, "tasks": [{ "task_name": "task0", "display_name": "", "output_dir": "", "whole_output_dir": "", "resources": { "cpu": "0.1C", "memory": "0.1G", "gpu_type": "", "gpu": "0" }, "inputs": [{ "name": "in-dir", "values": [ "ei_eihealth_xxxx_02:/zx-1030/" ] }, { "name": "in-str", "values": [ "mkdir1030" ] } ], "app_info": { "app_id": "2", "app_name": "zx-1030-mkdir", "app_version": "1.0.0", "app_src_project_name": "", "app_labels": [], "app_summary": "", "app_description": "", "app_image": "ei_eihealth_xxxx_02/modelarts-base-cpu-py3:custom-2.0.2", "app_commands": [ "mkdir ${in-dir}${in-str}" ], "app_input_parameters": [{ "name": "in-dir", "pattern": "", "type": "DIRECTORY", "required": true, "description": "" }, { "name": "in-str", "pattern": "", "type": "STRING", "required": true, "description": "" } ], "app_output_parameters": [] } }], "task_runtime_info": [{ "task_name": "task0", "status": "SUCCEEDED", "create_time": "2021-01-20 11:38:22", "finish_time": "2021-01-20 11:43:22", "run_time": "5m0s" }], "dag": { "task0": {} }, "io_acc_expected_usage": 10, "io_acc_info": { "id": "35673038-d57b-4dab-942a-72cf3e11e7df", "type": "IO_PERFORMANCE_BANDW IDT H", "space": 500, "free_space": 500.0 } }], "count": 1 } 获取作业列表。 ai4s get job #不带任何参数默认获取100条 job_id job_name tool_name tool_version tool_type status user_name create_time finish_time labels 4b682e15-ab92-11ee-a057-fa163ef319da cli-demo-job cp-test 2.0.0 workflow PENDING wwx-test-admin 2024-01-05 14:18:51 -- e7e55c6e-aaf6-11ee-a057-fa163ef319da cli-demo-job-import cli-demo-workflow 4.0.0 workflow FAILED wwx-test-admin 2024-01-04 19:46:32 2024-01-04 19:47:50 aee9e91a-aaf6-11ee-a057-fa163ef319da job-6685 cli-demo-workflow 4.0.0 workflow FAILED wwx-test-admin 2024-01-04 19:44:56 2024-01-04 19:45:50 58a8f13b-aaf3-11ee-a057-fa163ef319da job cp-test 2.0.0 workflow FAILED wwx-test-admin 2024-01-04 19:21:03 2024-01-04 19:23:54 35ff73b3-aaf3-11ee-a057-fa163ef319da job cp-test 2.0.0 workflow SUCCEEDED wwx-test-admin 2024-01-04 19:20:05 2024-01-04 19:24:52 24b72eee-aaf3-11ee-a057-fa163ef319da job cp-test 2.0.0 workflow SUCCEEDED wwx-test-admin 2024-01-04 19:19:36 2024-01-04 19:25:10 4ccef1fb-aaf2-11ee-a057-fa163ef319da job cp-test 2.0.0 workflow SUCCEEDED wwx-test-admin 2024-01-04 19:13:34 2024-01-04 19:17:34 ai4s get job -j cli-demo-job job_id job_name tool_name tool_version tool_type status user_name create_time finish_time labels 70f1baa8-ab96-11ee-a057-fa163ef319da cli-demo-job cp-test 2.0.0 workflow SUCCEEDED wwx-test-admin 2024-01-05 14:48:32 2024-01-05 14:55:13 6c6098f0-ab96-11ee-a057-fa163ef319da cli-demo-job cp-test 2.0.0 workflow SUCCEEDED wwx-test-admin 2024-01-05 14:48:24 2024-01-05 14:54:25 ai4s get job -l 3 同 ai4s get job -l 3 -o 0 #列出当前project的job的基本信息 #表示取3条数据，也就是取1-3 条数据 ai4s get job -o 10 同 ai4s get job -l 100 -o 10 #列出当前project的job的基本信息 #表示取100条数据，也就是取11-110 100 条数据 ai4s get job -l 10 -o 3 #列出当前project的job的基本信息 #表示跳过3条数据,从第4条数据开始取，取10条数据，也就是取4-13 10条数据 获取作业事件。 ai4s get job 550e8400-e29b-41d4-a716-446655440000 --event ------------------------------------------------------------------------------------------------------------------------ 成功关联执行器 2024-01-05 14:18:51 ------------------------------------------------------------------------------------------------------------------------ 执行 create， 共计 1 个子任务 2024-01-05 14:18:51 ------------------------------------------------------------------------------------------------------------------------ 执行 create， 共计 1 个子任务 2024-01-05 14:18:51 ------------------------------------------------------------------------------------------------------------------------ 创建k8s Job对象 task-3-two-cp-0-bd5e1f7dac10005f 成功. 2024-01-05 14:18:51 ------------------------------------------------------------------------------------------------------------------------ 等待任务 task-3-two-cp-0-bd5e1f7dac10005f 执行完成 2024-01-05 14:18:56 ------------------------------------------------------------------------------------------------------------------------ 元素(task-3-two-cp-0)第1次重试执行(create)，当前异常:Failed to wait the Job(task-3-two-cp-0-bd5e1f7dac10005f) has desiredReplicas: the pod list of job:task-3-two-cp-0-bd5e1f7dac10005f is empty . 2024-01-05 14:18:51 ------------------------------------------------------------------------------------------------------------------------ 创建k8s Job对象 task-2-cp-dir-0-bd5e1f7dac10005f 成功. 2024-01-05 14:18:56 ------------------------------------------------------------------------------------------------------------------------ 获取作业某一task事件。 ai4s get job 550e8400-e29b-41d4-a716-446655440000 --event --task task-lmx-job-1 Task event list: Status Times Type Details First Report Time Last Report Time SuccessfulCreate 1 Normal Created pod: task-1-rename-0-1b840133ac100049-hkppv 2022-05-24 18:04:55 2022-05-24 18:04:55 JobIsComplete 1 Normal Pod exits with success, the job is complete 2022-05-24 18:07:09 2022-05-24 18:07:09 Task instances list: Name Status PodIP Node RestartCount Request/Limit(CPU) Request/Limit(Memory) CreateTime task-1-rename-0-1b840133ac100049-hkppv Succeeded 172.16.1.20 192.168.125.40 0 / / 2022-05-24T10:04:55Z 获取并发task的实例事件。 ai4s get job c5b3d272-f398-11ec-845a-fa163ef3fac0 --task task-1-test-bingfasmial;1 --event Task event list: Status Times Type Details First Report Time Last Report Time SuccessfulCreate 1 Normal Created pod: task-1-test-bingfasmial-1-59620029ac100038-jkdpt 2022-06-24 16:37:20 2022-06-24 16:37:20 JobIsComplete 1 Normal Pod exits with success, the job is complete 2022-06-24 16:37:23 2022-06-24 16:37:23 Task instances list: Name PodIP Node RestartCount Request/Limit(CPU) Request/Limit(Memory) CreateTime task-1-test-bingfasmial-1-59620029ac100038-jkdpt 172.16.3.37 192.168.54.255 0 1/1 1G/1G 2022-06-24 16:37:20 获取作业某一task日志。 ai4s get job 550e8400-e29b-41d4-a716-446655440000 --log ./test/demo.log --task task-xxx-job-1 download the log of task task-lmx-job-1 successfully! 获取作业列表。 ai4s get job --status Failed --user-name ei_eihealth --create-from-time "2022-12-15 00:40:11" --create-to-time "2022-12-17 00:40:11" --finish-from-time "2022-12-14 17:05:09" --finish-to-time "2022-12-19 23:04:07" --labels "label1,lab_el-A" --job-name h-err-1 --workflow-name herr --limit 1 --offset 1 job_id job_name tool_name tool_version tool_type status user_name create_time finish_time labels 8a6078d9-c307-11ed-a824-fa163e504fdd job-4127-01 new-01 wewe workflow FAILED ei_eihealth_h00541446_01 2023-03-15 16:01:07 2023-03-15 16:02:51 label1,lab_el-A

命令结构 ai4s get job ID [flags] 表1 参数说明 参数 简写 是否必选 说明 ID 无 否 不选此参数时，列出当前所在空间的所有作业信息。 指定job-id时，列出具体作业的信息。可以同时指定多个job-id。 不带--detail参数，以yaml格式展示作业基本信息。 带--detail参数，以json格式展示作业基本信息。 --detail -d 否 配合ID使用，返回作业的详细信息。 --sample -s 否 获取作业模板，模板为yaml格式。 --limit -l 否 代表当次请求获取的最大查询条数（默认为10）。 --offset -o 否 偏移量，从第几条数据开始查询，默认为0。 --event -e 否 获取作业事件或者作业某一task事件，单独使用表示获取作业事件；与--task一起使用表示获取某一个task事件，并同时输出task实例列表。 --log -g 否 本地存放task日志的路径，必须与--task一起使用以获取作业某一task的日志。 --task -a 否 task名称。如果是并发的task，那么默认获取索引号为0的task实例，如果要查看别的实例，格式： --task task名称;实例索引，如--task task-1;1。 --finish-from-time -x 否 查询任务完成起始时间。例如，2006-01-02 15:04:05。 --finish-to-time -y 否 查询任务完成结束时间。例如，2006-01-02 15:04:05。 --create-from-time -c 否 询任务创建起始时间，例子：--create-from-time="2006-01-02 15:04:05"。 --create-to-time -m 否 询任务创建结束时间，例子：--create-to-time="2006-01-02 15:04:05"。 --labels -k 否 作业标签列表。以","分隔，如："a,b"。 --status -q 否 作业状态(用于获取作业列表)，取值：Succeeded、Running、Pending、Failed、Cancelling、Cancelled、Unknown。 --workflow-name -t 否 流程名。 --user-name -u 否 用户名。 --job-name -j 否 任务名。

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 ai4s delete member demo-user --project demo-project # 执行成功返回结果如下delete member demo-user of project demo-project successfully!

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 创建SYSTEM镜像类型的notebook ai4s create notebook lmx-notebook-system -i PY3 -f 1:0:2 -s lmx-test-01:/path1/;lmx-test-02:/path2/ # 返回结果如下 create notebook successfully! notebook id is xxx 创建CUSTOMER镜像类型的notebook ai4s create notebook lmx-notebook-customer -i lmx-test-01/image1:tag1 -f 1:0:2 -s lmx-test-02:/path1/ # 返回结果如下 create notebook successfully! notebook id is xxx

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 从源空间lmx-project导入流程，并重命名流程。 ai4s import workflow lmx-wf:v1:lmx-project --rename XXX 或 ai4s import workflow 1467490-2-hfddff:lmx-project --rename XXX # 返回结果如下 import workflow successfully!

命令示例 Windows ai4s docker push demo-image:v1.0 -d "this is a desc" -t APP Linux ./ai4s docker push demo-image:v1.0 -d 'this is a desc' -t APP 上传成功返回值 fe4c16cbf7a4: Pushed v1.0: digest: sha256:eb7e3bbd8e3040efa71d9c2cacfa12a8e39c6b2ccd15eac12bdc49e0b66cee63 size: 948 上传失败可能原因 镜像命名不规范 镜像版本不存在 上传镜像数量超出配额 待上传空间不存在 对于--description 参数，当描述中带有空格时，需要添加引号来获取完整的描述信息。

命令示例 查询当前所在空间demo-project下面的类型为APP的镜像。 ai4s docker images -t APP # 执行成功返回结果如下 Name Source Project Type Chip Type Created Updated autodruglikeness demo-project APP -- 2021-05-12 10:18:32 2021-05-12 10:18:32 Total images of project demo-project is: 1 查询当前空间下面的镜像名为demo-image的所有tag信息。 ai4s docker images -n demo-image # 执行成功返回结果如下 Name Version Size Created Updated demo-image-1 1.0 3.44M 2021-02-01 11:11:27 2021-02-01 11:11:27 demo-image-2 1.1 9.12M 2021-02-01 11:11:27 2021-02-01 11:11:27 demo-image-3 1.1 100M 2021-02-01 11:11:27 2021-02-01 11:11:27

命令示例 假设当前所在空间为lmx-project-01，命令及返回结果示例： 删除其他空间lmx-project-02的导入镜像tag。 ai4s docker rmi lmx-project-02/demo-image:v1.1 # 执行成功返回结果如下 untagged:lmx-project-02/demo-image:v1.1 删除资产市场订阅的镜像tag。 ai4s docker rmi [AssetMarket]/demo-image:v1.1 # 执行成功返回结果如下 untagged:[AssetMarket]/demo-image:v1.1 删除本空间的私有镜像tag，可不填源空间名。 ai4s docker rmi demo-image:v1.1 或 ai4s docker rmi lmx-project-01/demo-image:v1.1 # 执行成功返回结果如下 untagged:lmx-project-01/demo-image:v1.1

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 通过指定“workflow-id”修改流程。 ai4s edit workflow 65b7a404-3f4f-11eb-868a-fa163e3ddba1 -y D:\template.yaml # 返回结果如下 edit workflow succeed! 通过指定“workflow-name:version:srcproject”修改流程，并修改描述信息、输出路径、超时时间、标签。 ai4s edit workflow workflow-name:version:srcproject -d "详细描述" -s "简要描述" -o "/data/output" -t 2000 -l "labelA;labelB" # 返回结果如下 edit workflow succeed!

命令结构 ai4s edit workflow ID [flags] # edit和update作用相同 ai4s update workflow ID [flags] 表1 参数说明 参数 简写 是否必选 说明 ID 无 是 可选： 流程的ID（workflow-id），使用命令行工具创建流程时生成。示例请参见创建流程命令示例。 流程的名称、版本、所在空间名称（workflow-name:version:srcproject），srcproject为源空间名称，可选。不指定srcproject时，默认为当前空间。例如ngs:1.0:srcproject。 --yaml -y 否 本地的流程模板路径。 --summary -s 否 流程的简要描述。 --description -d 否 流程的详细描述。 --output_dir -o 否 输出路径。不指定时，以当前空间的根目录为工作路径。 --timeout -t 否 超时时间。运行时间超过设置时间时，认为超时，默认1440分钟，最大可设置为144000分钟。 --labels -l 否 标签。多个标签使用;符号分隔开。 --project 无 否 指定空间名。未填写则使用配置文件中的空间名。 对于可选参数，如果命令中包含了特殊字符，Windows系统下需使用""括起来，Linux系统下需使用''括起来。

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 获取性能加速资源列表 ai4s 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 XXX.storage.ioacc.spec.ioacc xxx 0.00GB 0.00% 100GB 1 ACTIVE / Schedulable 2023-01-19 21:57:51 0

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 执行如下命令，创建空间。 ai4s create project demo-project -d description -c -n demo # 执行成功返回结果如下 create project successfully! project id is xxx.

命令结构 ai4s get workflow ID [flags] 表1 参数说明 参数 简写 是否必选 说明 ID 无 否 不选此参数时，列出当前所在空间的所有流程信息。 指定workflow-id或workflow-name:version:srcproject，列出具体应用的信息，srcproject为源空间名称，可选。不指定srcproject时，默认为当前空间。 --sample -s 否 获取流程模板，模板为yaml格式。 --downloadPath -d 否 获取workflow详情时，将内容下载到的指定文件夹路径（文件夹需要存在）。 --project 无 否 指定空间名。未填写则使用配置文件中的空间名。 --label -l 否 根据label标签搜索workflow。