Huawei Cloud VPC List Skill

Overview

This skill queries the list of VPCs (Virtual Private Clouds) under the current Huawei Cloud tenant / project and returns their key attributes (ID, name, CIDR, status, description, enterprise project). It uses the huaweicloudsdkvpc Python SDK to call the VPC v3 API (ListVpcs), and automatically aggregates all paginated results to ensure the returned VPC count matches the actual total.

Architecture

Agent → scripts/list_vpcs.py (Python SDK) → Huawei Cloud VPC v3 API

API version

Applicable Scenarios

• Network inventory: "list all VPCs of this tenant" — returns correct total count
• VPC planning: verify existing CIDR ranges before creating new subnets/VPCs
• Troubleshooting: locate a VPC by name/id and inspect its status
• Enterprise-project audit: list VPCs of one enterprise project or all projects

能力边界（Capability Boundary）： 本 Skill 仅查询 VPC 列表。不创建/删除/修改 VPC，也不查询子网、安全组、 路由表等其它资源（那些属于 VPC 的其它查询能力或专用 Skill）。 若用户询问"查询子网/安全组/路由表"等，请明确告知本 Skill 不提供该能力。

Prerequisites

1. Python 3.8+ with huaweicloudsdkvpc package installed:

   pip install huaweicloudsdkvpc
   

2. IAM permissions — vpc:vpcs:list (read-only) is required to list VPCs. See references/iam-policies.md.

3. AK/SK credentials — set via environment variables:

   • HUAWEI_ACCESS_KEY / HUAWEI_SECRET_KEY, or
   • HW_AK / HW_SK, or
   • other HUAWEI*_AK / HUAWEI*_SK pattern variables

4. Region and Project ID — specify via --region and --project_id.

Workflow

1. Confirm parameters — ask the user for the target region (default cn-north-4), project ID, and any optional filters
2. Verify prerequisites — check list_vpcs.py --help for syntax validity, and confirm AK/SK environment variables are set
3. Run the query — execute python3 scripts/list_vpcs.py --project_id=... with the desired filters and pagination options
4. Aggregate all pages — the script automatically loops through all paginated results using the next_marker from each response, ensuring every VPC is counted
5. Return results — the script outputs the full VPC list (id, name, cidr, status, description, enterprise project id) along with the correct total count aggregated across all pages
6. Handle errors — on auth/region errors, verify credentials and region; on permission errors, report the missing IAM permission

Core Commands

Query All VPCs (with full page aggregation)

python3 scripts/list_vpcs.py --project_id={project_id} --region={region}

Query with a Custom Limit Per Page

python3 scripts/list_vpcs.py --project_id={project_id} --region={region} --limit=100

Filter by Enterprise Project

python3 scripts/list_vpcs.py --project_id={project_id} --region={region} --enterprise_project_id={id}

Filter by VPC Name

python3 scripts/list_vpcs.py --project_id={project_id} --region={region} --name my-vpc

Filter by VPC ID

python3 scripts/list_vpcs.py --project_id={project_id} --region={region} --id {vpc_id}

Filter by CIDR

python3 scripts/list_vpcs.py --project_id={project_id} --region={region} --cidr 192.168.0.0/16

Local Pagination (after full aggregation)

# Full aggregation returns all VPCs
python3 scripts/list_vpcs.py --project_id={project_id} --region={region}

# Use marker to start from a specific VPC
python3 scripts/list_vpcs.py --project_id={project_id} --region={region} --marker={vpc_id}

Output as Text Table

python3 scripts/list_vpcs.py --project_id={project_id} --region={region} --output=text

Parameter Confirmation

Reference Documents

• CLI Installation Guide
• IAM Policies
• Verification Method
• Data Flow Diagram
• Acceptance Criteria