核心用法
本技能提供阿里云PAI DSW（Data Science Workshop）实例的完整生命周期管理能力，涵盖七大核心工作流：
1. 规格查询（list-ecs-specs）
按加速器类型（CPU/GPU）查询可用ECS计算规格，返回实例类型、可用性状态、硬件配置及小时价格。支持按地域过滤，需特别注意IsAvailable与SpotStockStatus的双重校验逻辑。
2. 实例创建（create-instance）
采用"先检查后创建"的幂等模式：先调用list-instances验证名称唯一性，再执行创建。必填参数包括工作空间ID、实例名称、ECS规格、地域及镜像配置。创建后非阻塞返回，实例启动耗时2-5分钟。
3. 实例管理（list/get/update/start/stop）
支持分页查询、详情获取、配置更新（名称/规格/镜像/可见性/数据集挂载）及启停控制。更新前自动比对当前配置，避免冗余操作。
4. 数据集挂载
可选挂载PAI数据集至指定路径，支持只读（RO）或读写（RW）权限。
显著优点
权威性与可靠性
- 来源阿里云SDK团队（T1级可信度），MIT-0宽松许可证
- 纯文档型技能，无可执行代码，仅输出标准化Aliyun CLI命令
- 所有API调用均强制附加
--user-agent AlibabaCloud-Agent-Skills/alibabacloud-pai-dsw-manage标识
安全设计完善
- 凭证保护：明确禁止读取/打印AK/SK，禁止对话中直接输入凭证，强制使用环境变量或配置文件
- 最小权限：提供完整RAM权限清单及最小权限策略模板
- 参数确认：所有用户自定义参数（地域、实例名、CIDR、密码等）强制人工确认，无默认值假设
- 合规性：通过GDPR数据最小化、CCPA用户知情权等六项合规检查
运维友好性
- 非阻塞工作流设计，长时操作立即返回控制权
- 完善的检查-执行模式防止重复创建
- 智能规格匹配（GPU镜像→GPU规格，CPU镜像→CPU规格）
- 详细的超时控制与轮询限制（最大60轮/30分钟）
潜在缺点与局限性
功能边界
- 不支持实例删除：作为不可逆操作，删除需通过阿里云控制台手动执行
- 无自动伸缩能力：不支持基于负载的自动扩缩容
- 地域限制：规格可用性随地域变化，需逐地域查询确认
使用复杂度
- 强依赖Aliyun CLI（>=3.3.3）及pai-dsw插件，需预装配置
- 多参数强校验：WorkspaceId、RegionId等无默认值，新手需配合
list-workspaces等辅助查询 - GPU/CPU规格与镜像类型需严格匹配，误配将导致启动失败
成本考量
- PAI DSW为按量计费资源，停止实例仅停止计算费用，存储费用可能持续产生
- Spot实例库存状态独立变化，需额外关注
SpotStockStatus字段
适合的目标群体
核心用户
- 机器学习工程师/数据科学家：需快速启停GPU开发环境进行模型训练与实验
- MLOps工程师：负责团队开发环境的标准化部署与权限管理
- 云架构师：设计基于PAI的企业级机器学习平台架构
场景匹配
- 大模型训练环境按需创建（配合GPU规格）
- 数据分析轻量任务（配合CPU规格）
- 多团队协作场景（PUBLIC/PRIVATE可见性控制）
- 自定义镜像与数据集的标准化挂载
常规使用风险
配置风险
- 地域参数未确认可能导致规格查询失败或创建到非预期地域
- 实例名称27字符限制及命名规则（仅字母、数字、下划线）未遵守将导致API报错
- VPC/VSwitch/安全组配置错误可能导致网络隔离或访问受阻
性能与依赖
- CLI插件版本滞后可能引发API兼容性问题，需定期执行
aliyun plugin update - 长轮询操作（等待Running状态）默认10秒间隔，高频调用可能触发API限流
- 数据集挂载路径冲突或权限不足将导致实例启动失败
成本与安全
- 实例停止后未及时清理可能导致持续存储费用累积
- Workspace级别权限配置不当可能导致PUBLIC实例被误操作
- STS Token过期未刷新将导致API调用中断