华为云用户手册

命令示例 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。

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 使用ai4s get workflow -s命令获取模板，详细的模板介绍和使用请参见获取流程模板。 使用ai4s get workflow命令查询指定的流程信息。 ai4s get workflow 550e8400-e29b-41d4-a716-446655440000 ai4s get workflow workflow-name:version workflow: id: 3a7fa782-5bcb-11eb-9fef-fa163ef9b34d name: lk-workflow-0121 version: 1.0.0 summary: SDFDSF description: SDFDSFDSF labels: - SDFSDF timeout: 1440 output_dir: /lk-workflow-0121 tasks: - task_name: task-1-lk-app-0121 app_id: f165b7a6-5bc9-11eb-9fef-fa163ef9b34d name: "" resources: cpu: 0.1C memory: 0.1G gpu_type: "" gpu: "0" inputs: - name: input1 values: - ${task-2-lk-app-0121.output1} output_dir: /sdsd - task_name: task-2-lk-app-0121 app_id: f165b7a6-5bc9-11eb-9fef-fa163ef9b34d name: "" resources: cpu: 0.1C memory: 0.1G gpu_type: "" gpu: "0" inputs: - name: input1 values: - ei_eihealth_xxxx_02:/yexihao/ output_dir: /asdsd - task_name: task-4-lk-app-0121 app_id: f165b7a6-5bc9-11eb-9fef-fa163ef9b34d name: "" resources: cpu: 0.1C memory: 0.1G gpu_type: "" gpu: "0" inputs: - name: input1 values: - ei_eihealth_xxxx_02:/yexihao/ - name: input2 values: [] output_dir: /sd - task_name: task-5-zx-2id-2od app_id: "5" name: "" resources: cpu: 0.1C memory: 0.1G gpu_type: "" gpu: "0" inputs: - name: indir-01 values: - ${task-1-lk-app-0121.output1} - name: indir-02 values: - ${task-4-lk-app-0121.output1} output_dir: /sadsd license: BSD ai4s get workflow -s 获取workflow yaml模板文件，以yaml格式打印到控制台 workflow: # 处理规则同app id: xxxx # 可选 # 流程唯一标识，由系统随机分配 # 处理规则同app name: xxxx # 必选 # workflow名称 version: xxxx # 必选 # workflow版本，workflow名称+workflow版本在一个空间内保持唯一 summary: xxx # 可选 # 短描述 description: 'description' # 可选 # 完整描述文本 labels: # 可选 # 标签 - labelA - labelB timeout: 1440 # 可选 # 流程超时时间，取值范围[1,144000]，单位分钟，默认1440 output_dir: # 可选 # workflow的当前工作目录，默认为根目录，用户可显示指定 tasks: # 必选 # 任务列表 - task_name: app1-1 # 任务名称 # 唯一标识处理规则如下： # 1. 特殊id，采用{app_name}::{app_version}::{src_project_name}格式，用于手动创建场景 # src_project_name在使用导入or订阅的资源是需要填写，为空表示本空间 # 2. 其他场景，app_id为系统分配的唯一标识 app_id: xxx # 必选 app唯一标识 name: # task展示名称 resources: cpu: 2C # 'CPU数量' memory: 4G # '内存大小' gpu_type: # 'GPU类型' gpu: # 'GPU数量' output_dir: # task输出子目录，默认为空时，自动生成task-name子目录，允许在workflow中配置 inputs: # 输入参数配置，默认覆盖workflow、app中同名配置 - name: 'input_name1' # 参数名 values: # 参数值，覆盖基础配置 - xxx - task_name: app2-1 # 任务名称 app_id: xxx # app唯一标识 name: # task展示名称 resources: cpu: 2C # 'CPU数量' memory: 4G # '内存大小' gpu_type: # 'GPU类型' gpu: # 'GPU数量' output_dir: # task输出子目录，默认为空时，自动生成task-name子目录，允许在workflow中配置 inputs: # 输入参数配置，默认覆盖workflow、app中同名配置 - name: 'input_name2' # 参数名 values: # 参数值，覆盖基础配置 - xxx license: xxx # workflow的许可证 # 下载workflow详情到a文件夹 ai4s get workflow 3df8c00e-0291-11ed-973f-fa163e507c84 -d ./a download workflow detail successfully! # 根据label标签搜索workflow ai4s get workflow -l labelA id name version label source_eihealth_project_name user_name create_time update_time 501c20c9-aaf8-11ee-a057-fa163ef319da cli-demo-workflow 1.0.0 labelA,labelB test-project-new-permissions-700wwx-test-admin 2024-01-04 19:56:36 2024-01-04 19:56:36 4dd32f12-aaf7-11ee-a057-fa163ef319da cli-demo-workflow 2.0.0 labelA,labelB test-project-new-permissions-700wwx-test-admin 2024-01-04 19:49:23 2024-01-04 19:49:23

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 设置供应商名称 ai4s edit vendor-config --name xxx1 --log /root/demo/logo.png # 执行成功返回结果如下 set vendor name to xxx1 successfully! 设置供应商图标 ai4s edit vendor-config --log /root/demo/logo.png # 执行成功返回结果如下 set vendor logo successfully!

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 从源空间lmx-project-01导入应用，并重命名应用。 ai4s import app ae81debc-c209-11eb-8a0d-fa163e3ddba1:lmx-project-01 --rename lmx-test-import-app 或 ai4s import app testapp:testversion:lmx-project-01 --rename lmx-test-import-app # 返回结果如下 import app finished! result is: [ { "source_app_id": "93a4f757-f5b9-11eb-9fef-fa163ef9b34d", "destination_app_id": "0c13b198-f5c9-11eb-9fef-fa163ef9b34d", "destination_app_name": "lmx-test-import-app", "version": "1.0.0", "status": "IMPORT_SUC CES S" } ]

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 使用本地已填写好的流程模板workflow.yaml创建流程。 ai4s create workflow D:\workflow.yaml 或 ai4s create workflow -y D:\workflow.yaml # 返回结果如下 create workflow succeed! workflow id : 65b7a404-3f4f-11eb-868a-fa163e3ddba1

命令结构 ai4s delete workflow ID [flags] 表1 参数说明 参数 简写 是否必选 说明 ID 无 是 流程的ID（workflow-id）或流程的名称、版本、所在空间名称（workflow-name:version:srcproject），srcproject为源空间名称，可选。不指定srcproject时，默认为当前空间。 --project 无 否 指定空间名。未填写则使用配置文件中的空间名。

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 通过指定流程的ID或名称和版本删除流程。 ai4s delete workflow 4f712af9-3f51-11eb-868a-fa163e3ddba1 或 ai4s delete workflow workflow-name:version:srcproject # 返回结果如下 delete workflow success,workflow id : 4f712af9-3f51-11eb-868a-fa163e3ddba1

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

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 不指定参数。 执行ai4s get project命令获取当前用户有权限访问的空间列表。 ai4s get project # 执行成功返回结果如下 Project Name Project Id Owner Role Status Size Created Modified maomaochong XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ei_eihealth_lxxx_01 Administrator ACTIVE 23.76GB 2025-04-24 10:35:29 2025-04-30 10:20:03 test-project-0421 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ei_eihealth_lxxx_01 Administrator ACTIVE 21.95MB 2025-04-21 11:24:06 2025-04-22 14:41:39 liuyuwei XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX test-liuyw Administrator ACTIVE 704.16MB 2025-04-07 04:20:58 2025-04-18 06:17:32 eihealth_api_project_002 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX eihealth_api_001 Administrator ACTIVE 37.52GB 2025-04-03 09:44:50 2025-04-03 10:05:15 test-whh XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX test-wwx-0331 Owner ACTIVE 308.52GB 2025-04-01 05:08:06 2025-04-01 05:08:07 test-hxy XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ei_eihealth_lxxx_01 Uploader ACTIVE 163.22GB 2025-03-31 12:01:17 2025-03-31 12:01:17 eihealth_api_project_006 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX eihealth_api_002 Administrator ACTIVE 11.10GB 2025-03-31 05:38:22 2025-04-03 09:39:37 eihealth_api_project_004 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX eihealth_api_002 Administrator ACTIVE 37.52GB 2025-03-31 05:37:55 2025-04-03 09:39:26 eihealth_api_project_001 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX eihealth_api_001 Administrator ACTIVE 62.13GB 2025-03-31 05:34:21 2025-04-03 09:39:44 test-bjl XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX ei_eihealth_lxxx_01 Administrator ACTIVE 352.66GB 2025-03-31 05:26:06 2025-03-31 05:26:07 指定“project-name”参数。 例如查看名为“test-zh-0507”空间信息，执行ai4s get project test-bjl命令。 ai4s get project test-bjl # 执行成功返回结果如下 { "id": "XXXXX", "name": "test-bjl", "creator": "xxx", "role": "Administrator", "roles": [ { "role_type": "Owner", "users": [ { "id": "XXXX", "name": "XXXX" } ] }, { "role_type": "XXXX", "users": [ { "id": "XXXX", "name": "user007" }, { "id": "XXXXX", "name": "cpp-test" }, { "id": "XXXXX", "name": "test-bjl13" }, { "id": "XXXXX", "name": "yjn-test" } ] } ], "size": XXXX, "status": "ACTIVE", "description": "", "create_time": "2025-03-31T02:26:06Z", "update_time": "2025-03-31T02:26:07Z", "is_core": false, "storage_quota": -1, "storage_tenant": "TERMINATE" } 指定“--current”和“--policy”参数。 先执行ai4s switch project test-bjl，切换到“test-bjl”空间，再执行ai4s get project --current --policy命令，查询当前所在空间的详细信息、数据权限策略。 ai4s get project test-bjl --current --policy # 执行成功返回结果如下 { "id": "XXXXX", "name": "test-bjl", "creator": "xxx", "role": "Administrator", "roles": [ { "role_type": "Owner", "users": [ { "id": "XXXXX", "name": "xxx" } ] }, { "role_type": "Administrator", "users": [ { "id": "XXXXX", "name": "user007" }, { "id": "XXXXX", "name": "cpp-test" }, { "id": "XXXXX", "name": "test-bjl13" } ] } ], "size": XXXXX, "status": "ACTIVE", "description": "", "create_time": "2025-03-31T02:26:06Z", "update_time": "2025-03-31T02:26:07Z", "is_core": false, "storage_quota": -1, "storage_tenant": "TERMINATE" }

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 获取notebook列表 ai4s get notebook # 返回结果如下 Name ID Status Container Image Created Updated notebook-01 xxx Running mul-kernel-cpu-cp27 2021-02-01 11:11:27 2021-02-01 11:11:27 notebook-02 xxx Failed mul-kernel-cpu-cp27 2021-02-01 11:11:27 2021-02-01 11:11:27 notebook-03 xxx Succeed mul-kernel-cpu-cp27 2021-02-01 11:11:27 2021-02-01 11:11:27 获取notebook详情 ai4s get notebook xxxx # 返回结果如下 { "id": "439274bd-be09-4300...", "name": "a", "creator": "ei_eihealth_02", "url": "https://x.x.x.x/v1/0xxx/notebooks/xxx/services/notebook", "flavor": { "cpu_type": "ARM", "cpu": 1.0, "gpu": 0.0, "gpu_type": "Snt9", "memory": 2.0 }, "status": "Creating", "image": { "image_type": "SYSTEM", "image_info": { "source_project_name": "", "image_name": "eihealth-notebook", "image_tag": "cuda11.0-custom-v1.0.6", "profile": "PY3" } }, "storages": [ { "path": "/home/ai4s-user/work/wyq-test" } ], "create_time": "2022-06-30T11:25:43Z", "update_time": "2022-06-30T11:25:53Z", "failed_message": "pod failed for:Unschedulable, message:0/2 nodes are available: 2 Insufficient cpu.", "events": [ { "type": "Warning", "count": 3, "reason": "FailedScheduling", "message": "0/2 nodes are available: 2 Insufficient cpu.", "first_timestamp": "2022-06-30T11:25:43Z", "last_timestamp": "2022-06-30T11:25:46Z" } ] } 获取打开notebook的地址信息 ai4s get notebook xxxx --url # 返回结果如下https://x.x.x.x/v1/0xxx/notebooks/xxx/services/notebook?token=xxxx

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

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 使用本地已填写好的应用模板app.yaml创建应用。 ai4s create app D:\app.yaml 或 ai4s create app -y D:\app.yaml # 返回结果如下 create app succeed! app id : 84ffe6f7-3f4a-11eb-868a-fa163e3ddba1

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

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