华为云用户手册

命令结构 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命令设置执行权限。

下载命令行工具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） 文件操作工具详见OBS工具，可完成查看、上传、下载、复制、导入、引入、创建和删除桶中的数据。 镜像操作详见image-syncer工具，可完成对应容器镜像的迁移。 本页面命令行工具下载后，在使用时，需用到您注册华为账号并开通华为云时提供的用户名等信息，用于登录并操作AI科学计算服务控制台的空间、数据等资产。这些信息的处理将遵循您已接收的《华为云用户协议》及《隐私政策声明》约束。 下载地址中带有sha256后缀的链接，指的是对应软件包的校验文件。例如：Windows x64版本的下载链接是ai4s-windows-x86_64 ，它的校验文件下载链接则是ai4s-windows-x86_64.zip.sha256。

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

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 使用job-id导出作业 ai4s export job -i f17a3542-3f7c... # 返回结果如下 export job successfully! 使用job-id文件导出作业 ai4s export job -f /user/path/ids.zip # 返回结果如下 export job successfully!

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 ai4s delete job f17a3542-3f7c-11eb-868a-fa163e3ddba1 # 返回结果如下 delete job success! job id : f17a3542-3f7c-11eb-868a-fa163e3ddba1

命令示例 本节以Windows为例介绍ai4s-toolkit的使用过程，Linux、macOS和Windows环境使用方法基本相同，可参考此章节。 通过指定应用的ID或名称和版本删除应用。 ai4s delete app 550e8400-e29b-41d4-a716-446655440000 或 ai4s delete app app-name:version:srcproject # 返回结果如下 delete app success,app id : 550e8400-e29b-41d4-a716-446655440000