SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场huawei-cloud-storage-query

huawei-cloud-storage-query

部署与运维

查看项目

更新于 10-16 14:57

技能介绍

用途

huawei-cloud-storage-query 是一个独立的只读查询技能，使用本地 Python 脚本调用华为云 Python SDK，用于查询华为云存储资源、可用规格以及已有资源信息。根据资料，其适用场景包括：

  • 查询指定区域可用的云资源规格
  • 查询指定操作系统类型可用的镜像
  • 查询磁盘类型及已有磁盘信息
  • 查询已有资源及其关键属性
  • 查询并非通过 Terraform 或其他 IaC 工具创建的资源
  • 为自动化配置、资源核对或环境盘点准备真实参数
  • 获取可复用的信息，如资源 ID、名称、规格、镜像、网络、磁盘等

该技能不处理以下事项：创建资源、修改资源、删除资源、猜测或编造未查询到的信息。

主要能力

技能通过 scripts 目录下按类别组织的脚本提供查询能力，并通过 references 目录下按类别组织的指南提供使用说明。能力包括：

  • 查询资源列表
  • 查询单个资源详情
  • 查询可用规格、镜像、磁盘类型等选型信息
  • 查询已有资源的关键标识与依赖关系

查询结果以 JSON 格式输出，包含 total（匹配的资源总数）与 items（资源列表，每项包含 id、name、status 等关键字段；具体字段随资源类型而异）。

使用方式

前置准备

使用前必须运行环境检查脚本，一次性完成环境校验与依赖安装：

  • 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 时需要

不要输出上述环境变量的值。其他资源脚本所需的额外参数（可用区、企业项目等），请参考对应的 guide.md。

执行流程

调用该技能时，需按以下步骤执行，无需等待用户再次提示：

第一步：环境准备 运行环境检查脚本，确保依赖已安装、凭据已配置。若失败，按提示修复并重试直至通过。

第二步：识别并执行查询脚本 根据用户查询意图，阅读 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>

最后格式化结果并返回给用户。

要点：所有脚本与环境检查脚本都在技能包内，必须通过 skill action=exec 执行，不能直接在 shell 中运行；venv 由 check_env 脚本自动创建，Linux/macOS 下 Python 位于 .venv/bin/python3，Windows 下位于 .venv/Scripts/python3.exe；不要直接用 python3 执行脚本；不要阅读 scripts 目录下的脚本源码，只需按 guide.md 的说明操作；输出较大时进行缓存；--project_id 参数可选，未提供时根据 region 通过 IAM API 自动获取。

参数确认

执行查询脚本前确认以下参数：

  • region：必填，华为云区域，如 cn-north-4
  • --project_id：非必填，未提供时自动获取
  • --availability_zone：非必填，部分资源查询需要

其他脚本专属参数请参考 references/<service>/guide.md。

使用原则

  • 脚本路径均相对于技能目录（即 SKILL.md 所在目录）
  • 该技能只执行查询，不做写操作
  • 优先使用用户明确指定的 region、project、AZ、资源名、资源 ID 等
  • 查询结果必须基于实际 API 响应，而非凭经验推断
  • 返回结果优先保留可复用的关键字段
  • 结果集较大时，先按 region、name、id、status、tag 等条件缩小范围
  • 若当前资源类型没有对应脚本或指南，应明确说明不支持，不要返回不可靠结果
  • 若用户未提供必要的范围信息且环境中没有默认值，应先确认再执行查询
  • 按 guide.md 直接执行，不要阅读 scripts 目录下的脚本内容
  • 输出较大时进行缓存
  • 每次执行脚本前先运行 -h 查看用法
  • 不要编造脚本名，按 guide.md 中的脚本名执行；若某脚本名未出现在 guide.md 中，即表示不支持

适用场景

适用于对华为云存储类资源（EVS/OBS/SFS/CBR）进行只读清点、核对与选型信息获取，例如查询云硬盘（磁盘、快照、类型、配额、回收站）与 OBS 桶等信息，为自动化配置、资源验证或环境盘点提供真实参数。

限制

  • 仅提供只读查询能力，不执行任何写操作
  • 不得输出 HW_ACCESS_KEY、HW_SECRET_KEY 等环境变量的值
  • 所有脚本必须通过 skill action=exec 执行，不能直接在 shell 中运行
  • 不得猜测脚本名，须严格按 guide.md 中的名称执行
  • 查询前必须先运行环境检查脚本
  • 使用临时 AK/SK 时必须设置 HW_SECURITY_TOKEN
  • 不得使用 hcloud、openstack、curl IAM 或其他 CLI/API 方式，该技能不依赖这些工具
  • 具体支持的服务类别、脚本名与详细参数以技能内置 guide.md 为准，资料未提供更细的脚本清单与参数说明