# Aliyun Eci Openapi

> ECI OpenAPI/SDK 调用设计与故障定位。Use when 需要通过代码自动化创建、查询、更新、删除 ECI 资源（实例、镜像缓存、DataCache、虚拟节点等），并给出最小请求、鉴权（RAM/STS）与错误码排查路径。

- Skill: `misonl/aliyun-eci-openapi` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add misonl/aliyun-eci-openapi`
- Raw SKILL.md: https://api.skillmd.com/api/skills/misonl/aliyun-eci-openapi/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: misonl (https://skillmd.com/u/misonl)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/misonl/aliyun-eci-openapi

---


# 阿里云 ECI OpenAPI/SDK

## 快速工作流（按官方文档落地）

1) 先定位官方 API 文档页面
- 优先用 `$aliyun-eci-docs` 本地索引检索（更快、更稳）
  - `python3 ~/.codex/skills/aliyun-eci-docs/scripts/eci_docs.py search CreateContainerGroup`
  - `python3 ~/.codex/skills/aliyun-eci-docs/scripts/eci_docs.py search ExecContainerCommand`
- 命中后拉取并阅读关键段落（参数/示例/错误码/限制）
  - `python3 ~/.codex/skills/aliyun-eci-docs/scripts/eci_docs.py fetch <URL> --format md`

2) 明确鉴权与权限边界（RAM/STS）
- 确认调用方身份：主账号/子账号 RAM User/STS 临时凭证/实例 RAM 角色
- 按“最小权限”原则给出策略建议（具体 Action/Resource 以官方文档为准）

3) 形成“最小可用请求 + 可选增强项”
- 最小可用：只包含必填参数，确保能创建/查询成功
- 增强项：网络/存储/日志/安全/规格等按场景逐项加入
- 输出时必须带：参数解释、常见报错定位、依据链接（官方 URL）
- 输出结构优先按 `references/minimal_api_workflow_templates.md` 的模板组织

## 常见需求到 API 的映射（只作导航）

- 创建/删除/查询实例：`CreateContainerGroup` / `DeleteContainerGroup` / `DescribeContainerGroups`
- 查看事件/状态：`DescribeContainerGroupEvents` / `DescribeContainerGroupStatus`
- 进入容器执行命令：`ExecContainerCommand`
- 拉取容器日志：`DescribeContainerLog`
- 镜像缓存：`CreateImageCache` / `DescribeImageCaches` / `DeleteImageCache`
- DataCache：`CreateDataCache` / `DescribeDataCaches` / `DeleteDataCache`
- 虚拟节点：`CreateVirtualNode` / `DescribeVirtualNodes` / `DeleteVirtualNode`

## 输出模板（回答/交付时遵循）

- 结论：该场景需要调用哪些 API、建议的调用顺序
- 最小示例：请求参数清单（必填/选填分组），必要时给伪代码/请求体结构
- 参数解释：每个关键字段“从哪里来/如何获取/常见坑”
- 权限与鉴权：需要的 RAM 角色/策略方向（不直接臆造具体 Action 列表）
- 排障：常见错误码/现象 -> 定位路径 -> 可能原因
- 依据：列出官方文档 URL

## 参考资料（需要细节时再读）

- `references/openapi_cheatsheet.md`: 常见调用套路与排障导航
- `references/official_link_baseline.md`: OpenAPI 常用 Action 官方链接基线
- `references/minimal_api_workflow_templates.md`: 最小可用调用流程模板（含鉴权/排障结构）
- `references/full_scope_urls.md`: `aliyun-eci-openapi` 主路由文档全量清单（45 篇）
- `~/.codex/skills/aliyun-eci-docs/references/eci_full_skill_coverage.md`: 全量文档覆盖矩阵（先确认该问题属于 OpenAPI 路由）
- `~/.codex/skills/aliyun-eci-docs/references/eci_full_skill_routing.json`: URL -> 主技能路由明细（跨域问题先查）