华为云网络资源查询是一个独立的只读查询技能,通过本地 Python 脚本调用华为云 Python SDK,用于查询华为云上的网络类资源、可用规格以及已有资源信息。
用途 该技能适用于查询特定区域的可用云资源规格、查询某操作系统可用的镜像、查询云硬盘类型与已有云硬盘信息、查询已有资源及其关键属性、查询并非通过 Terraform 或其他 IaC 工具创建的资源,以及为自动化配置、资源核验或环境盘点准备真实参数,获取资源 ID、名称、规格、镜像、网络、磁盘等可复用信息。它不负责创建资源、修改资源、删除资源,也不猜测或编造未经查询的信息。
主要能力 技能通过 scripts 目录下按资源类别划分的脚本提供查询能力,并通过 references 目录下的分类指南提供使用说明。能力包括:查询资源列表、查询单个资源详情、查询可用规格/镜像/磁盘类型等选型信息、查询已有资源的关键标识与依赖关系。查询结果以 JSON 格式输出,包含 total(匹配资源总数)与 items(资源列表,每个资源含 id、name、status 等关键字段)等通用字段,具体字段随资源类型不同而不同,详见各 guide.md。
使用方式 技能要求通过 skill action=exec 执行脚本,脚本路径均为技能目录下的相对路径。禁止使用 hcloud、openstack 或其他 CLI 工具,也禁止直接 API 调用,技能不依赖这些工具。执行流程为:第一步运行环境检查脚本,完成依赖安装与凭证校验,若失败需按提示修复后重跑,直至通过;第二步根据查询意图阅读 references/<service>/guide.md,确定脚本路径与参数,先运行 -h 查看用法,再组装参数执行脚本,最后格式化结果返回。
环境检查脚本: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 下不要使用 && 拼接命令,如需先切换目录可用分号。脚本会依次检查 Python >= 3.6、安装依赖、校验 SDK、校验凭证、校验服务可用性。
创建虚拟环境后,Linux / macOS 的 Python 位于 .venv/bin/python3,Windows 位于 .venv/Scripts/python3.exe,不可直接用 python3 执行脚本。
环境变量:HW_ACCESS_KEY 必填(华为云 AK)、HW_SECRET_KEY 必填(华为云 SK)、HW_REGION_NAME 可选(默认 cn-north-4)、HW_PROJECT_ID 可选(未设置时通过 IAM API 自动获取)、HW_SECURITY_TOKEN 可选(使用临时 AK/SK 时必填)。不要输出上述环境变量的值。
参数确认:region 必填(如 cn-north-4);--project_id 可选,未提供时自动获取;--availability_zone 可选,部分资源查询需要。脚本专属参数见 references/<service>/guide.md。
适用场景 查询区域内的可用资源规格;查询操作系统可用镜像;查询云盘类型与已有云盘;查询已有资源及其关键属性;查询非 IaC 创建的资源;为自动化配置、资源核验或环境盘点准备真实参数;获取可复用的资源 ID、名称、规格、镜像、网络与磁盘信息。
限制与注意事项 技能仅提供只读查询,不执行任何写操作。查询结果必须基于实际 API 响应,不得凭经验推断。结果集较大时应先按 region、name、id、status、tag 等条件缩小范围,并可将输出缓存到本地以避免重复请求。若某资源类型没有对应脚本或指南,应明确说明不支持,不返回不可靠结果。用户未提供必要范围信息且环境无默认值时,应先与用户确认再执行。执行前必须运行 -h 查看用法,不要臆造脚本名,guide.md 中不存在的脚本名即表示不支持。不要读取 scripts 目录下的脚本源码,按 guide.md 执行即可。不要输出 HW_ACCESS_KEY、HW_SECRET_KEY 等环境变量的值。使用临时 AK/SK 时需设置 HW_SECURITY_TOKEN。脚本执行失败时,先检查环境变量与网络连通性。核对结果可通过对已知资源执行查询并与控制台数据比对,检查返回的 total 是否合理。多种资源信息需要查询时,按依赖顺序查询,例如先查 VPC 再查子网。