HCS VPC Subnets

通过 huaweicloudsdkvpc 的 ListSubnets 接口查询指定 region 的华为云 VPC 子网列表，可按 VPC ID 过滤，支持 JSON 与 Markdown 两种输出格式，并提供内置 mock 数据用于无凭证验证；真实查询需配置 AK/SK 环境变量。

yangaiwu

热度 8.57

最近更新 2026-08-20 03:57:56

分类：数据依赖：代码执行 / 第三方 API应用场景：API 集成 / 数据处理 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add hcs-vpc-subnets

Metadata

name: hcs-vpc-subnets
version: 1.0.0
description: 查询华为云 VPC 子网列表。通过 huaweicloudsdkvpc ListSubnets 接口拉取指定 region 的子网列表，可选按 VPC ID 过滤。支持 JSON / Markdown 双格式输出，内置 mock 数据用于无凭证验证。
triggers: ["查询华为云VPC子网","查询子网列表","列出VPC子网","华为云子网查询"]
tools: ["python3"]

hcs-vpc-subnets（华为云 VPC 子网查询）

概述

查询华为云账号下（region/project 范围）的 VPC 子网列表。

SDK：huaweicloudsdkvpc.v2 ListSubnets（GET /v1/{project_id}/subnets）
认证：环境变量 HWCLOUD_AK / HWCLOUD_SK
操作类型：只读查询类

前置条件

Python 3.8+
huaweicloudsdkvpc（pip install huaweicloudsdkvpc）
环境变量 HWCLOUD_AK / HWCLOUD_SK（真实验证时必填）
可选 HWCLOUD_PROJECT_ID（缺省由 AK/SK 解析默认项目）

工作流

读取 AK/SK 环境变量构建 VpcClient（--mock 模式跳过）
调用 ListSubnets 分页拉取子网列表（limit=2000/页）
可选按 --vpc-id 过滤
格式化输出 JSON 或 Markdown

核心命令

# mock 模式（无需凭证）
python3 scripts/hcs-vpc-subnets.py --mock --region cn-north-4

# 真实查询
python3 scripts/hcs-vpc-subnets.py --region cn-north-4

# 按 VPC 过滤 + Markdown 输出
python3 scripts/hcs-vpc-subnets.py --region cn-north-4 --vpc-id vpc-xxx --format md

# 指定 project-id
python3 scripts/hcs-vpc-subnets.py --region cn-north-4 --project-id <project_id>

参数确认

参数	必填	默认值	说明
--region	是	-	区域（如 cn-north-4）
--vpc-id	否	-	按 VPC ID 过滤子网
--project-id	否	自动解析	项目 ID
--format	否	json	输出格式 json / md
--mock	否	false	使用内置模拟数据

退出码

退出码	含义
0	成功
2	参数错误（缺少 --region）
3	缺少认证（未设置 HWCLOUD_AK/SK）
4	API 调用失败