360 Secure SkillHub
360 安全技能中心

HCS VPC Details

通过华为云 VPC Python SDK 的 ShowVpc 接口按 VPC ID 查询单个 VPC 详情，包括 id、名称、CIDR、状态、路由、企业项目与创建时间等字段；支持 JSON 与 Markdown 两种输出，认证信息由环境变量动态扫描获取。

yangaiwu
yangaiwu
热度 11.17
最近更新 2026-08-20 19:35:52
分类：数据依赖：代码执行 / 第三方 API应用场景：DevOps / 报告撰写 / 数据处理

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add hcs-vpc-details
Metadata
name
hcs-vpc-details
version
1.0.0
description
查询华为云 VPC（虚拟私有云）详情。通过 huaweicloudsdkvpc ShowVpc 接口按 VPC ID 查询单个 VPC 的详细信息，输出 id/name/cidr/status/routes/企业项目/创建时间等字段，支持 JSON / Markdown 双格式输出。
triggers
["查询华为云VPC详情","查询VPC信息","华为云VPC查询","VPC详情查询"]
tags
["huawei-cloud","vpc","query"]

hcs-vpc-details（华为云 VPC 详情查询）

查询华为云账号下指定 VPC（虚拟私有云）的详细信息。

  • SDK：huaweicloudsdkvpc.v2 ShowVpc（GET /v1/{project_id}/vpcs/{vpc_id}）
  • 操作类型：只读查询类

环境变量（认证）

脚本通过 _load_credentials() 动态扫描环境变量获取 AK/SK，不依赖固定变量名。支持以下前缀和匹配规则：

前缀 AK 匹配 SK 匹配
HUAWEI* 含 ACCESS_KEY / 以 _AK 结尾 / AK 含 SECRET_KEY / 以 _SK 结尾 / SK
HW* 同上 同上
HWC* 同上 同上

常见变量名示例：HWCLOUD_AK、HUAWEI_AK、HW_ACCESS_KEY、HWC_SECRET_KEY 等，均可被自动识别。

项目 ID 为可选（缺省由 AK/SK 解析默认项目），同样支持动态扫描。

使用

# 查询指定 VPC 详情
python3 scripts/hcs-vpc-details.py --region cn-north-4 --vpc-id vpc-0aaa1111bbbb2222cccc

# Markdown 格式输出
python3 scripts/hcs-vpc-details.py --region cn-north-4 --vpc-id vpc-0aaa1111bbbb2222cccc --format md

# 指定项目 ID
python3 scripts/hcs-vpc-details.py --region cn-north-4 --vpc-id vpc-xxx --project-id <project-id>

输出

默认 JSON，字段：

{
  "capability": "show",
  "region": "cn-north-4",
  "project_id": "xxx",
  "vpc_id": "vpc-0aaa1111bbbb2222cccc",
  "vpc": {
    "id": "vpc-0aaa1111bbbb2222cccc",
    "name": "vpc-prod-001",
    "cidr": "192.168.0.0/16",
    "description": "生产环境 VPC",
    "status": "OK",
    "routes": [
      {"destination": "10.0.0.0/8", "nexthop": "1.1.1.1"}
    ],
    "enterprise_project_id": "0",
    "tenant_id": "xxx",
    "created_at": "2024-01-15T08:30:00",
    "updated_at": "2024-06-01T12:00:00",
    "block_service_endpoint_states": "off",
    "enable_network_address_usage_metrics": false
  }
}

--format md 输出 Markdown 表格（VPC 属性表 + 路由信息表）。

参数确认

参数 必填 默认值 说明
--region 是 - 区域（如 cn-north-4）
--vpc-id 是 - VPC ID
--project-id 否 自动解析 项目 ID
--format 否 json 输出格式 json / md

退出码

码 含义
0 成功
2 参数错误（缺少 --region 或 --vpc-id）
3 缺少认证（环境变量中未找到 AK/SK）
4 API 调用失败

依赖

  • Python 3.8+
  • huaweicloudsdkvpc（pip install huaweicloudsdkvpc）
  • huaweicloudsdkcore

实现说明

使用华为云 VPC Python SDK (huaweicloudsdkvpc V2) 的 ShowVpcRequest 查询单个 VPC 详情：

  • API 端点：GET /v1/{project_id}/vpcs/{vpc_id}（已通过 SDK _http_info 确认）
  • 请求参数：vpc_id（路径参数）
  • 响应：ShowVpcResponse.vpc（Vpc 对象）

VPC 详情关键字段映射（SDK 属性 → JSON key）：

SDK 属性 JSON key 说明
id id VPC ID
name name VPC 名称
cidr cidr CIDR 网段
description description 描述
status status 状态（CREATING/OK）
routes routes 路由列表（destination + nexthop）
enterprise_project_id enterprise_project_id 企业项目 ID
tenant_id tenant_id 租户 ID
created_at created_at 创建时间
updated_at updated_at 更新时间
block_service_endpoint_states block_service_endpoint_states 服务终结点阻断状态
enable_network_address_usage_metrics enable_network_address_usage_metrics 网络地址用量监控

参考文档