huawei-cloud-ecs-query

华为云 ECS 查询技能

概述

本技能用于查询华为云弹性云服务器（ECS）的信息，包括：

• 查询实例列表：列出所有ECS实例的基本信息
• 查询实例详情：获取单个ECS实例的详细配置信息
• 查询实例状态：查看ECS实例的运行状态

支持两种认证方式（AK/SK 签名认证 和 Token 认证），两种输出格式（表格 和 JSON），以及多区域查询。

前置条件

1. 安装 Python 依赖

pip install requests pyyaml

2. 获取认证凭证

方式一：AK/SK 认证（推荐）

• 登录华为云控制台 → 右上角用户名 → "我的凭证" → "访问密钥" → 新增访问密钥
• 保存 AK（Access Key ID）和 SK（Secret Access Key）
• 同时需要获取 Project ID（项目ID）：在"我的凭证"页面查看

方式二：Token 认证

• 需要华为云账号的用户名、密码
• 需要账号的 Domain ID（租户ID，在"我的凭证"页面查看）
• 需要Project ID

3. 配置文件

创建配置文件 ~/.huawei-ecs/config.yaml（或通过 --config 参数指定路径）：

# 认证方式：aksk 或 token
auth_method: aksk

# AK/SK 认证配置
ak: "your-access-key-id"
sk: "your-secret-access-key"
project_id: "your-project-id"

# Token 认证配置（当 auth_method 为 token 时使用）
# username: "your-username"
# password: "your-password"
# domain_id: "your-domain-id"

# 默认区域
region: "cn-north-4"

# 输出格式：table 或 json
output_format: "table"

工作流

当用户请求查询 ECS 信息时，按以下流程执行：

1. 识别查询类型：确定用户需要的是实例列表（list）、实例详情（show）还是实例状态（status）
2. 确认认证配置：检查 ~/.huawei-ecs/config.yaml 是否存在；若缺失，提示用户先完成配置（参考"前置条件"章节）
3. 执行查询：根据查询类型运行对应命令（参考"核心命令"章节）
   • 列表 → list-servers（可加 --status/--name 过滤）
   • 详情 → show-server
   • 状态 → server-status
4. 格式化输出：默认表格输出；用户要求 JSON 时用 --output json
5. 处理错误：API 请求失败时，根据错误信息提示用户检查网络、区域或权限（参考"注意事项"与 references/troubleshooting.md）

核心命令

hcloud CLI 等价命令（推荐）

本技能脚本通过华为云 API 直连实现查询。若环境中已安装 hcloud CLI（KooCLI）并完成 hcloud configure，可使用以下等价命令快速查询：

# 查询实例列表
hcloud ECS ListServersDetails --cli-region=cn-north-4 --limit=25

# 查询单个实例详情
hcloud ECS ShowServer --cli-region=cn-north-4 --server_id=<server_id>

# 查询实例状态（结合 --cli-query 过滤）
hcloud ECS ListServersDetails --cli-region=cn-north-4 --status=ACTIVE

CLI 安装与认证方式参考 references/cli-installation-guide.md。

脚本命令

查询实例列表

python scripts/ecs_query.py list-servers --config config.yaml

可选参数：

• --region：指定区域（如 cn-north-4, cn-east-3, ap-southeast-1）
• --output：输出格式（table 或 json）
• --limit：返回数量限制（默认25）
• --offset：页码偏移（默认1）
• --status：按状态过滤（ACTIVE, SHUTOFF, BUILD, ERROR 等）
• --name：按名称过滤
• --flavor：按规格ID过滤