Alibabacloud Pai Dsw Manage — 阿里云 Pai DSW 管理
v0.0.2管理Alibaba Cloud PAI DSW(数据科学工作坊)实例的整个生命周期 — 创建、更新、查询、列出、启动、停止和查看ECS规格。 触发器:PAI DSW、DSW实例、创建实例、启动实例、停止实例、更新实例、查询实例、实例列表、ECS规格、CreateInstance、UpdateInstance、GetInstance、ListInstances、StartInstance、StopInstance、ListEcsSpecs
运行时依赖
安装命令
点击复制技能文档
PAI DSW 实例管理
管理整个 Alibaba Cloud PAI DSW(数据科学工作坊)实例生命周期 —— 从预配到配置更改、状态监控和启动/停止操作。同时支持查询可用的 ECS 计算规格。
架构:PAI Workspace + DSW 实例 + ECS 规格 + 镜像 + VPC + 数据集
API 版本:pai-dsw/2022-01-01
安装预检查:Aliyun CLI >= 3.3.3 必须
运行 aliyun version 验证 >= 3.3.3。如果未安装或版本过低,运行 curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash 更新,或者参考 references/cli-installation-guide.md 获取安装说明。
预检查:Aliyun CLI 插件更新必需
[MUST] 运行 aliyun configure set --auto-plugin-install true 启用自动插件安装。
[MUST] 运行 aliyun plugin update 确保现有的插件始终是最新的。
# macOS(推荐)
brew install aliyun-cli
# 验证版本(>= 3.3.3)
aliyun version
# 启用自动插件安装
aliyun configure set --auto-plugin-install true
# 更新现有的插件
aliyun plugin update
# 安装 pai-dsw 插件
aliyun plugin install --names pai-dsw
[MUST] CLI User-Agent —— 每个 aliyun CLI 命令调用必须包含:--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-dsw-manage
身份验证预检查:Alibaba Cloud 凭证必需
安全规则:
NEVER 读取、回显或打印 AK/SK 值(例如,echo $ALIBABA_CLOUD_ACCESS_KEY_ID 是禁止的)
NEVER 要求用户直接在对话或命令行中输入 AK/SK
NEVER 使用 aliyun configure set 配置字面凭证值
仅使用 aliyun configure list 检查凭证状态
aliyun configure list
检查输出以获取有效的配置文件(AK、STS 或 OAuth 身份)。如果没有有效的配置文件,停止这里。
从 Alibaba Cloud 控制台获取凭证
在此会话外配置凭证(通过 aliyun configure 在终端或 shell 配置文件中的环境变量)
返回并重试,直到 aliyun configure list 显示有效的配置文件
RAM 权限
参考 references/ram-policies.md 获取完整的权限列表和最小权限策略。
[MUST] 权限失败处理:当任何命令或 API 调用由于权限错误在执行过程中的任何时候失败时,按照以下过程:
阅读 references/ram-policies.md 获取所需的权限列表
使用 ram-permission-diagnose 技能指导用户请求必要的权限
暂停并等待用户确认已授予所需的权限
参数确认
重要:参数确认 —— 在执行任何命令或 API 调用之前,所有用户可自定义的参数(例如 RegionId、实例名称、CIDR 块、密码、域名、资源规格等)必须与用户确认。不要假设或在未经用户明确同意的情况下使用默认值。
参数 必需 描述 默认值
WorkspaceId 必需 PAI 工作空间 ID 没有 —— 用户必须提供
InstanceName 必需 实例名称(仅限字母、数字、下划线;最大 27 个字符) 没有 —— 用户必须提供
EcsSpec 必需(后付费)ECS 计算规格,例如 ecs.c6.large。通过 list-ecs-specs 查询 没有 —— 用户必须提供
ImageId 与 ImageUrl 互斥 PAI 控制台中的镜像 ID 没有
ImageUrl 与 ImageId 互斥 容器镜像 URL。参考 references/common-images.md 获取常见的官方镜像 没有
RegionId 必需 区域,例如 cn-hangzhou、cn-shanghai 没有 —— 用户必须确认
Accessibility 可选 可见性范围:PUBLIC(所有工作空间用户)或 PRIVATE PRIVATE
InstanceId 必需(更新/获取/启动/停止)实例 ID(dsw-xxxxx 格式) 没有
VpcId 可选 私有网络访问的 VPC ID 没有
VSwitchId 可选 VPC 内的 VSwitch ID 没有
SecurityGroupId 可选 安全组 ID 没有
AcceleratorType 必需(规格查询)加速器类型:CPU 或 GPU 没有 —— 用户必须确认
Datasets 可选 数据集挂载的 CLI 列表格式:DatasetId=< > MountPath=< > MountAccess=RO RW
--read-timeout 可选 CLI 读取超时时间(以秒为单位)(用于长时间运行的操作) 10
--connect-timeout 可选 CLI 连接超时时间(以秒为单位) 10
如何获取 WorkspaceId:
如果用户不知道自己的工作空间 ID,运行:
aliyun aiworkspace list-workspaces --region --user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-dsw-manage
这将返回用户可以访问的所有工作空间。根据 WorkspaceName 选择合适的工作空间或要求用户确认。
参考:创建和管理工作空间
核心工作流
完整的命令语法和参数详细信息:references/related-commands.md。
- 查询可用的 ECS 规格