编程

华为云 ECS 实例列表查询

试用

查询华为云账号下指定 Region 的弹性云服务器(ECS)实例列表,输出精简的实例名称 + ID 清单。 适合用于云资源盘点、运维巡检、自动化脚本前置查询。

它能做什么

查询华为云账号下指定 Region 的弹性云服务器(ECS)实例列表,输出精简的实例名称 + ID 清单。 适合用于云资源盘点、运维巡检、自动化脚本前置查询。

技能文档

华为云 ECS 实例列表查询 Skill

能力

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

前置条件

  1. 本机已安装 Python 3.8+(仅使用标准库,无需安装第三方依赖)
  2. 已创建配置文件 config.json(在 skill 目录内,已由 .gitignore 排除):
    • 复制 config.example.jsonconfig.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

相关技能

Queries Huawei Cloud ECS (Elastic Cloud Server) resources in read-only mode. Covers ECS instances, flavors, keypairs, quotas, server groups, block devices, NICs, VNC console, launch templates, recycle bin, scheduled events, and tags. No write operations. Use this skill when the user needs to query ECS instance details, list flavors, check server status, view block devices, or inspect ECS resource attributes. Triggers include: 查询ECS, ECS实例查询, 云服务器查询, 弹性云服务器, ECS规格, ECS配额, 云服务器列表, ECS详情, query ECS, list ECS servers, show server details, ECS flavors, ECS quotas, ECS keypairs, server groups, block devices, ECS inventory, cloud server list, ecs list, ecs query, ecs show.

查询华为云账号下指定 Region 的关系型数据库服务(RDS)实例列表,输出精简的 实例名称 + ID + 状态 + 引擎类型 + 规格清单。 适合用于数据库资源盘点、运维巡检、故障排查与自动化脚本前置查询。

查询华为云账号下指定 Region 的 VPC 列表,输出精简的 VPC 名称 + ID 清单。 | 适合用于网络资源盘点、运维巡检、自动化脚本前置查询。

通过本地 Python 脚本只读查询华为云 ECS、BMS、IMS、AS 资源。

作者 huaweicloud-skills-team2 次安装

Query Huawei Cloud DCS (Distributed Cache Service) instance names and list all managed Redis/Memcached instances across a region. Provides read-only name lookup, name filtering, status-based filtering, and instance ID lookup for inventory reporting and daily inspection. Triggers include: DCS list, list DCS instances, query DCS names, DCS instance name, find DCS instance, DCS name lookup, DCS instance list, Redis instance names, cache instance names, DCS inventory, 查询DCS名称, DCS实例名称, 缓存实例名称, DCS列表, DCS实例列表, 查询缓存实例名称.

Query the list of Huawei Cloud CSS (Cloud Search Service) Elasticsearch (ES) clusters under the current project/region. Lists all ES clusters with their ID, name, status, endpoint, datastore engine/version, instance configuration, VPC/subnet/security-group, tags and enterprise project. Supports optional filtering by datastore engine type and pagination (limit/offset) for account-wide cluster inventory. Use when the user wants to: (1) list all Huawei Cloud ES clusters / 查询华为云ES列表, (2) check how many Elasticsearch clusters exist in the account or region, (3) inspect ES cluster status, endpoint, version, or node configuration for daily inspection or troubleshooting, (4) filter ES clusters by engine type (elasticsearch/logstash/opensearch) or page through results. Triggers include: "ES列表", "华为云ES列表", "查询ES列表", "ES集群列表", "elasticsearch列表", "list ES clusters", "ES cluster list", "云搜索服务列表", "CSS列表", "css list", "ListClusters", "ES集群查询", "查看ES集群"