huawei-cloud-evs-detail
华为云 EVS(弹性卷服务)详情查询 Skill,支持查询当前账号 cn-north-4 下所有云硬盘列表及监控指标(IOPS/吞吐量/延迟)。
安全硬约束
- 凭据管理:AK/SK 通过 hcloud CLI 的
configure命令管理,或通过环境变量动态加载,禁止硬编码在任何脚本或配置文件中。 - 只读操作:本 Skill 仅执行只读查询(ListVolumes / ShowMetricData),不执行任何创建、修改、删除操作。
- 超时控制:所有 CLI 调用均设 30 秒超时。
- 错误处理:CLI 调用失败时需输出明确错误信息(含错误码和错误消息),不静默崩溃。
- 日志安全:凭据信息不得写入日志或输出。
概述
本 Skill 封装了华为云 EVS 和 CES(Cloud Eye)服务的只读 CLI 命令,提供两组核心功能:
- 磁盘列表查询:列出当前账号 cn-north-4 下所有 EVS 云硬盘,包含 ID、名称、状态、容量、挂载信息
- 监控指标查询:查询指定 EVS 磁盘的 IOPS(读写)、吞吐量(读写)、延迟(I/O服务时间)等监控指标
前置条件
1. hcloud CLI 安装与配置
需要安装华为云 KooCLI(hcloud)并配置 AK/SK 凭证。详细安装指南见 references/cli-installation-guide.md。
2. Python 环境
Python 3.6+(用于包装脚本)
3. IAM 权限
需要以下 IAM 权限策略:
- evs:volumes:list
- ces:metrics:list
- ces:metricData:list
详见 references/iam-policies.md。
工作流
- 解析用户输入 -> 识别意图(list 或 metrics)
- 执行 CLI 命令
- 格式化输出
- 错误处理
核心命令
列出所有 EVS 磁盘
python3 scripts/huawei_cloud_evs_detail.py list
查询监控指标
python3 scripts/huawei_cloud_evs_detail.py metrics
查看能力列表
python3 scripts/huawei_cloud_evs_detail.py capability-list
Koo CLI Command Format
| 操作 | 命令 |
|---|---|
| 列出 EVS 磁盘 | hcloud EVS ListVolumes --cli-region=cn-north-4 [--limit=N] |
| 查监控指标 | hcloud CES ShowMetricData --cli-region=cn-north-4 --namespace=SYS.EVS --metric_name=X --dim.0=instance_id, --filter=average --period=3600 --from=T --to=T |
EVS 监控指标映射
| 指标名 | 说明 | 单位 |
|---|---|---|
| disk_device_read_requests_rate | 读 IOPS | count/s |
| disk_device_write_requests_rate | 写 IOPS | count/s |
| disk_device_read_bytes_rate | 读吞吐量 | bytes/s |
| disk_device_write_bytes_rate | 写吞吐量 | bytes/s |
| disk_device_service_time | I/O 服务时间(延迟) | ms |
KooCLI Command Format Standard
本 Skill 使用 CLI 模式,通过 hcloud 命令直接调用华为云 API:
| 操作 | 命令 |
|---|---|
| 列出 EVS 磁盘 | hcloud EVS ListVolumes --cli-region=cn-north-4 [--limit=N] |
| 查监控指标 | hcloud CES ShowMetricData --cli-region=cn-north-4 --namespace=SYS.EVS --metric_name=X --dim.0=instance_id,<id> --filter=average --period=3600 --from=T --to=T |
参数确认
| 参数 | 说明 | 默认值 | 是否可配置 |
|---|---|---|---|
region |
华为云区域 | cn-north-4 |
是(通过 --region 覆写) |
--timeout |
CLI 调用超时秒数 | 30 |
是 |
--period |
监控数据粒度(秒) | 3600 |
是 |
参考文档
- references/iam-policies.md
- references/cli-installation-guide.md
- references/verification-method.md
- references/acceptance-criteria.md
- references/dataflow-diagram.md
