用途:查询华为云弹性云服务器(ECS)信息,包括实例列表、单个实例详情和实例运行状态,仅用于查询,不含创建、删除、规格变更等写操作。
主要能力:支持 AK/SK 签名认证与 Token 认证两种方式;支持表格和 JSON 两种输出格式;支持多区域查询;实例列表可按状态、名称、规格 ID 过滤,并提供数量限制与分页偏移。默认使用华为云 API 直连,环境中已安装并配置 hcloud CLI(KooCLI)时也可使用等价命令。
必要用法:先安装依赖 pip install requests pyyaml,并获取认证凭证(AK/SK 认证需 AK、SK、Project ID;Token 认证需用户名、密码、Domain ID、Project ID)。随后创建配置文件 ~/.huawei-ecs/config.yaml,填写 auth_method、ak、sk、project_id、region、output_format 等。查询示例:python scripts/ecs_query.py list-servers --config config.yaml;python scripts/ecs_query.py show-server --server-id <server_id> --config config.yaml;python scripts/ecs_query.py server-status --server-id <server_id> --config config.yaml。hcloud CLI 等价命令如 hcloud ECS ListServersDetails --cli-region=cn-north-4 --limit=25。若不知道实例 ID,可先运行 list-servers 获取。
适用场景:查看 ECS 实例清单、核对实例配置与状态、按区域或状态筛选实例。
限制:需要能访问华为云 API 端点 ecs.{region}.myhuaweicloud.com;账号或 IAM 用户需具备 ECS 只读权限(ECS ReadOnlyAccess);配置文件含敏感凭证,应妥善保管且不要提交到版本控制。更详细的 API 说明、CLI 安装、IAM 策略与排障指引见资料中提到的 references 文件,本次资料未提供其具体内容。