华为云 ECS 实例列表查询

该 Skill 通过 Python 脚本调用华为云 ECS 只读接口，按配置的 Region 查询账号下的弹性云服务器，输出精简的名称与 ID 清单；AK/SK 从本地 config.json 读取，支持自动解析 project_id，并区分配置缺失、认证失败与接口异常等错误。

yangaiwu

热度 15.62

最近更新 2026-08-31 01:37:18

分类：自动化依赖：代码执行 / 第三方 API / 读写文件应用场景：DevOps / 工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add huaweicloud-ecs-list

Metadata

name: huaweicloud-ecs-list
version: 1.0.0
description: 查询华为云账号下指定 Region 的弹性云服务器（ECS）实例列表，输出精简的实例名称 + ID 清单。适合用于云资源盘点、运维巡检、自动化脚本前置查询。
tags: ["huaweicloud","ecs","资源查询","云运维"]
tools: ["python3"]

华为云 ECS 实例列表查询 Skill

能力

查询华为云账号下指定 Region 的 ECS 实例列表
输出精简结果：仅包含实例名称（name）与 ID（id）
默认查询北京4（cn-north-4）Region，Region 可在配置中修改
认证方式：AK/SK 从配置文件（config.json）读取，支持自动解析 project_id

前置条件

本机已安装 Python 3.8+（仅使用标准库，无需安装第三方依赖）
已创建配置文件 config.json（在 skill 目录内，已由 .gitignore 排除）：
- 复制 config.example.json 为 config.json
- 填入华为云 AK/SK（密钥不落盘到仓库，仅保存在本地 config.json）

{
  "ak": "你的华为云 Access Key ID",
  "sk": "你的华为云 Secret Access Key",
  "region": "cn-north-4",
  "project_id": ""
}

region：可选，默认 cn-north-4（北京4）；如需其他 Region 修改此字段
project_id：可选，留空时脚本通过 IAM 接口按 region 自动解析

权限说明

本 Skill 仅发起只读查询请求，所需 IAM 权限见 references/iam-policies.md。

运行方式

# 默认读取 skill 目录下 config.json
python3 list_ecs.py

# 指定配置文件
python3 list_ecs.py -c /path/to/config.json

# 临时覆盖 Region（不改配置文件）
python3 list_ecs.py -r cn-south-1

输出约定

成功时输出 Region 下的 ECS 实例名称 + ID 精简列表：

Region cn-north-4 的 ECS 实例列表（共 2 个）：
- my-ecs-01  7b9b0c8a-xxxx-xxxx-xxxx-xxxxxxxxxxxx
- my-ecs-02  8c0d1e2f-xxxx-xxxx-xxxx-xxxxxxxxxxxx

无实例时输出：Region cn-north-4 下暂无 ECS 实例。

错误处理

场景	行为
配置文件缺失	明确提示复制 config.example.json 为 config.json
配置缺少 AK/SK	明确提示在 config.json 中填写 AK/SK
AK/SK 无效或无权限（HTTP 401/403）	明确提示认证失败并检查配置
接口/网络异常	输出可读的接口错误信息（HTTP 状态码与详情）
无实例	返回空提示，不报错

脚本以退出码 0（成功/无实例）或 1（配置/认证/接口错误）结束。

边界

仅支持查询（ListServersDetails），不支持实例的创建/删除/修改
单次仅查询一个 Region
凭证只从本地 config.json 读取，绝不写入仓库或日志

测试

python3 -m unittest discover -s tests -v