后端与接口
在需要查询华为云计算资源(ECS/BMS/IMS/AS)信息…
当需要查询华为云 ECS/BMS/IMS/AS 资源详情、可用规格、镜像、伸缩组与策略状态等只读信息时使用
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
在需要查询华为云计算资源(ECS/BMS特定
解决思路
- 通过本地 Python 脚本执行查询,禁止使用 hcloud、openstack 等 CLI 工具或直接调用 API
- 查询脚本位于技能目录 scripts/<service_category>/ 下(如 scripts/as/list_scaling_groups.py)
- 所有脚本和环境检查脚本都在技能包内,必须使用 skill action=exec 执行,不要在 shell 中直接运行
- 脚本路径与参数参见 references/<service>/guide.md
- 所有路径相对于技能目录(即包含 SKILL.md 的目录)
- 使用前先运行环境检查脚本完成环境验证与依赖安装:Linux/macOS 执行 skill action=exec: bash skill://scripts/check_env.sh;Windows 执行 skill action=exec: powershell -ExecutionPolicy Bypass -File skill://scripts/check_env.ps1
- Windows 上不要用 && 连接命令(PowerShell 5.x 不支持),如需先切换目录请用分号
- 环境检查脚本按顺序检查:Python >= 3.6 → 安装依赖 → 验证 SDK → 验证凭证 → 验证服务可用性;检查失败需先修复再继续
- 配置环境变量:HW_ACCESS_KEY(必填,华为云 AK)、HW_SECRET_KEY(必填,华为云 SK)、HW_REGION_NAME(可选,默认 cn-north-4)、HW_PROJECT_ID(可选,未设置时通过 IAM API 自动获取)、HW_SECURITY_TOKEN(可选,临时 AK/SK 时需要)
- 不要输出上述环境变量的值
- 根据用户查询意图读取 references/<service>/guide.md 确定脚本路径与参数
- 执行每个脚本前先用 -h 查看用法:Linux/macOS 执行 skill action=exec: skill://.venv/bin/python3 skill://scripts/<service>/<script>.py -h;Windows 执行 skill action=exec: skill://.venv/Scripts/python3.exe skill://scripts/<service>/<script>.py -h
- 根据用户需求组装参数并执行脚本:Linux/macOS 执行 skill action=exec: skill://.venv/bin/python3 skill://scripts/<service>/<script>.py <parameters>;Windows 执行 skill action=exec: skill://.venv/Scripts/python3.exe skill://scripts/<service>/<script>.py <parameters>
- 将结果格式化后返回给用户
- venv 由 check_env 脚本自动创建,Linux/macOS 的 Python 位于 .venv/bin/python3,Windows 位于 .venv/Scripts/python3.exe
- 不要直接用 python3 执行脚本
- 不要读取 scripts 目录下的脚本源码,按 guide.md 的说明执行
- 输出较大时缓存结果
- --project_id 参数可选,未提供时根据 region 通过 IAM API 自动获取
- 优先使用用户明确指定的信息,如 region、project、AZ、资源名、资源 ID
- 查询结果必须基于实际 API 响应,不要凭经验推测
- 返回结果保留关键字段以便后续复用
- 结果集较大时优先按 region、name、id、status、tag 等条件缩小范围
- 若当前资源类型没有对应脚本或 guide,明确说明不支持,不要返回不可靠结果
- 若用户未提供必要范围信息且环境中无默认值,先确认信息再执行查询
- 按 guide.md 直接执行,不要读取 scripts 目录中的脚本内容
- 执行查询前确认参数:region(必填,如 cn-north-4)、--project_id(可选,未提供则自动获取)、--availability_zone(可选,部分资源查询需要)
- 查询结果以 JSON 格式输出,包含 total(匹配资源总数)和 items(资源列表,每项含 id、name、status 等关键字段)
- 验证方法:执行环境检查脚本确认依赖与凭证可用;用 -h 确认参数正确;对已知资源执行查询并与控制台数据比对;检查返回的 total 是否合理
- 最佳实践:先缩小查询范围(指定 region、AZ 等)避免返回过多数据;用 --help 查看脚本支持的完整参数;结果较大时本地缓存避免重复请求;需要多个资源信息时按依赖顺序查询(如先查 VPC 再查 subnet);脚本执行失败时先检查环境变量与网络连通性
- 使用临时 AK/SK 时需设置 HW_SECURITY_TOKEN
适用边界 · 注意事项
- 不处理创建、修改、删除资源等写操作
- 不猜测或编造未查询到的信息
- 不适用于没有对应脚本或 guide 的资源类型查询