pai dsw instance — 交互式建模

参数

类型

默认值

说明

--name

string

—

实例名称 必填

--image

string

—

镜像 ID（与 --image-url 二选一）

--image-url

string

—

镜像仓库地址（与 --image 二选一）

--image-auth

string

—

私有镜像 Base64 认证信息

--ecs-spec

string

—

按量付费：ECS 实例规格，如 ecs.gn7i-c8g1.2xlarge

--resource-id

string

—

包年包月：资源配额 ID

--cpu

string

—

包年包月：CPU 核数

--memory

string

—

包年包月：内存大小（如 8GB）

--gpu

int

—

包年包月：GPU 卡数

--gpu-type

string

—

包年包月：GPU 卡型（如 V100、A100、T4）

--shared-memory

string

—

包年包月：共享内存大小（如 8GB）

--priority

int

—

包年包月：调度优先级，1（最低）至 9（最高）

--oversold-type

string

—

超卖策略 ForceQuotaOverSold AcceptQuotaOverSold ForbiddenQuotaOverSold

--workspace-id

string

config

工作空间 ID

--dataset

stringArray

—

数据集挂载，格式 id:mount_path[:version]，可重复指定

--datasets

string

—

数据集 JSON 数组（API 字段格式）

--cloud-disk-size

string

—

云盘容量（如 100Gi），与 --cloud-disks 互斥

--cloud-disks

string

—

云盘配置 JSON 数组

--env

stringArray

—

环境变量 KEY=VALUE，可重复指定

--label

stringArray

—

实例标签 KEY=VALUE，可重复指定

--tag

stringArray

—

实例标记 KEY=VALUE，可重复指定

--startup-script

string

—

每次启动时执行的脚本命令

--user-command

string

—

UserCommand JSON（与 --startup-script 互斥）

--idle-timeout

int

—

空闲自动关机时间（分钟）

--driver

string

—

NVIDIA 驱动版本（如 535.230.02）

--accessibility

string

—

可见性 PRIVATE PUBLIC

--ssh-public-key

string

—

SSH 公钥，设置后开启 SSH 访问

--ssh-access-type

string

—

SSH 访问方式，逗号分隔：intranet, internet

--ssh-port

string

22

SSH 监听端口

--ssh-external-port

string

自动

SSH 公网映射端口

--ssh-eip-id

string

—

弹性公网 IP 分配 ID（配合 NAT 网关使用）

--ssh-nat-gateway-id

string

—

NAT 网关 ID

--ssh-nlb-gateway-id

string

—

NLB 网关 ID（与 NAT/EIP 互斥）

--user-vpc

string

—

VPC 网络配置 JSON

--spot-spec

string

—

按量付费：抢占式实例配置 JSON

--service

stringArray

—

自定义服务/端口转发配置，可重复指定

--affinity

string

—

调度亲和性配置 JSON

--assign-node-spec

string

—

节点调度配置 JSON

--credential-config

string

—

实例凭证配置 JSON

--docker-config

string

—

Docker 配置 JSON

--dynamic-mount

string

—

动态挂载配置 JSON

--migration-options

string

—

实例迁移选项（灵骏 + 持久化存储场景）

--workspace-source

string

—

工作目录存储来源

--dry-run

bool

false

打印组装好的请求体（PascalCase，与 API 拼写一致）而不创建，可检查后配合 --body-json 复用

--body-json

string

—

完整请求体 JSON（覆盖以上所有选项）

--generate-skeleton

bool

false

输出 JSON 请求模板后退出，用于生成 --body-json 模板

--override / --override-string / --override-unset

stringArray

—

提交前修改请求体字段，详见--override 请求体编辑

参数

类型

默认值

说明

--workspace-id

string

config

工作空间 ID

--status

string

—

按状态过滤（如 Running、Stopped、Creating）

--name

string

—

按实例名称过滤

--resource-id

string

ALL

资源组 ID。ALL 表示全部，空值表示仅按量付费实例

--sort-by

string

—

排序字段 GmtCreateTime GmtModifiedTime

--order

string

—

排序方向 ASC DESC

--page

int

1

页码

--page-size

int

20

每页条数

--columns

string

—

自定义输出列，逗号分隔。默认：instance_id, instance_name, status, payment_type, ecs_spec, image_id, workspace_id, gmt_create_time, gmt_modified_time

参数

类型

默认值

说明

--all

bool

false

table 视图显示全部字段（json/yaml 输出本就包含全部字段）

--show-secrets

bool

false

显示服务密码与镜像仓库认证明文。默认只显示 (set)/(not set)

--raw

bool

false

输出未加工的原始 API 响应：凭证原样输出、含 HTTP 信封、API 未设置的字段直接省略（而非显示 null）

参数

类型

默认值

说明

--name, --image, --image-url, --ecs-spec, --priority, --driver, --startup-script, --accessibility

—

不修改

替换对应字段（含义同 create）

--dataset / --datasets / --env

stringArray

不修改

替换整组配置（非增量合并）

--remove-datasets, --remove-env, --remove-vpc, --remove-driver, --remove-spot, --remove-credential, --remove-user-command, --remove-forward-infos, --remove-assign-node, --remove-migration-options

bool

false

删除对应配置，需确认（或加 -y）

--body-json

string

—

完整 UpdateInstance 请求体（PascalCase），支持 @file / @-；同时传入的 flag 覆盖其字段

--override / --override-string / --override-unset

stringArray

—

提交前修改请求体字段，详见 --override 请求体编辑

--dry-run

bool

false

仅打印请求体，不发送

-y, --yes

bool

false

跳过 --remove-* 的确认提示

参数

类型

默认值

说明

--out（save）

string

stdout

写入文件；已存在时拒绝覆盖，需配合 --force

--format（save）

string

yaml

导出格式 yaml json

-f, --file（render/apply）

string

—

实例配置文件（JSON/YAML），- 表示标准输入 必填

--instance-id（apply）

string

按名称查找

直接指定目标实例，跳过查找；覆盖文件中的 InstanceId

--dry-run（apply）

bool

false

对比在线实例，显示将创建或变更的内容；无差异时输出 unchanged

--prune（apply）

bool

false

删除文件中未声明且可删除的配置（数据集、环境变量、VPC、驱动等），需确认

--override 家族（render/apply）

stringArray

—

应用前修改配置字段，详见--override 请求体编辑

参数

类型

默认值

说明

-y, --yes

bool

false

跳过确认提示（脚本/自动化场景必须指定）

--dry-run

bool

false

仅预览操作，不实际执行

参数

类型

默认值

说明

--dry-run

bool

false

仅预览操作，不实际执行

参数

类型

默认值

说明

--for

string

—

目标状态 必填 Running Stopped Failed Deleted

--interval

int

5

轮询间隔（秒）

--timeout

int

300

最大等待时间（秒）

参数

类型

默认值

说明

--code

string

—

执行 Python 代码片段

--file

string

—

上传本地文件到实例并执行

--remote-path

string

/tmp/dsw_exec_<name>

远程上传目标路径（以 / 结尾表示目录）

--cwd

string

—

远程工作目录

--timeout

int

120

命令执行超时时间（秒）

--via

string

gateway

数据面通道 gateway vpc internet

参数

类型

默认值

说明

--instance

string

当前上下文

目标实例 ID（未设置上下文时需指定）

--via

string

gateway

数据面通道 gateway vpc internet

--dry-run

bool

false

仅预览操作，不实际执行

参数

类型

默认值

说明

--follow

bool

false

持续跟踪事件流（类似 tail -f）

--since

string

—

仅显示指定时间之后的事件（如 30m、2h、3d）

--max-events

int

2000

最大返回事件数

参数

类型

默认值

说明

--metric

string

—

CloudMonitor 指标名 必填（或用 --list-metrics 查看目录）

--list-metrics

bool

false

打印指标目录后退出

--start / --end

string

-1h / now

时间窗口：RFC3339 或相对偏移（如 -90m、-6h、-2d）

--period

string

60

采样间隔（秒），仅支持 60 300

--length

int

1440

每页最大数据点数（API 上限 1440）

--next-token

string

—

翻页令牌（从 -o json 结果的 next_token 字段获取；table 视图只提示存在下一页）

--dimensions

string

自动构建

覆盖 CloudMonitor 维度 JSON，如加 "gpu" 维度限定 CARD_* 指标的单张卡；常规使用无需传

--namespace

string

acs_pai_dsw

CloudMonitor 命名空间，一般无需修改

参数

类型

默认值

说明

--type

string

ssh

检查类型，已知：ssh；其他值原样透传给 API

--async

bool

false

创建任务后立即返回任务 ID，不等待结果

--task-id

string

—

读取已有任务的结果（与 --async 互斥）

--verbose

bool

false

返回逐检查点详情（不传时仅返回问题列表）

--interval / --timeout

int

5 / 300

轮询间隔与最大等待时间（秒）

参数

类型

默认值

说明

--via

string

gateway

设置默认数据面通道

--force

bool

false

使用 vpc/internet 通道时，即使不可达也设置上下文

参数

类型

默认值

说明

--accelerator-type

string

—

加速器类型 必填 CPU GPU

--sort-by

string

—

排序字段

--order

string

—

排序方向 ASC DESC

--page

int

1

页码

--page-size

int

100

每页条数

--columns

string

—

自定义输出列。默认：instance_type, accelerator_type, cpu, memory, gpu, gpu_type, gpu_memory_size, is_available

参数

类型

默认值

说明

--path

string

/

分析的起始路径

-d, --depth

int

2

目录展示深度

--exclude

stringArray

—

额外排除的路径，可重复指定

--show-excludes

bool

true

在输出中显示排除路径列表

--interval

int

5

扫描轮询间隔（秒）

--timeout

int

300

最大等待时间（秒）

--via

string

gateway

数据面通道 gateway vpc internet

参数

类型

默认值

说明

--via

string

internet

使用的服务地址类型 internet vpc

参数

类型

默认值

说明

--port（start）

int

9806

本地监听端口

-d, --background（start）

bool

false

后台运行代理进程

--all（stop）

bool

false

停止所有运行中的代理