Huawei Cloud VPCEP Name List Skill

Overview

This skill provides read-only name-query capabilities for Huawei Cloud VPCEP (VPC Endpoint Service). It lists all VPC Endpoints in a region, supports fuzzy name matching via the endpoint_service_name parameter, and paginated queries with limit/offset. It is designed for quick name lookups, inventory reporting, and daily endpoint inspection.

Architecture

Agent → hcloud CLI (primary) → Huawei Cloud VPCEP API
       ↘ Python SDK (fallback) ↗

Applicable Scenarios

• List all VPCEP endpoint names in a region for inventory
• Find VPCEP endpoints by name keyword (fuzzy match via endpoint_service_name)
• Paginated browsing of VPCEP endpoint list
• Check endpoint status, VPC, IP and creation time

Prerequisites

1. hcloud CLI installed and authenticated — See references/cli-installation-guide.md
2. Python 3.8+ with huaweicloudsdkvpcep package (SDK fallback)
3. Huawei Cloud AK/SK configured via environment variables or hcloud configure set
4. IAM permissions — VPCEP ReadOnlyAccess or finer-grained policy — See references/iam-policies.md

Workflow

1. Identify query scope — Decide whether to list all VPCEP endpoints, filter by name keyword, or paginate
2. Select execution mode — Use the hcloud CLI by default; fall back to the Python SDK if the CLI is unavailable
3. Execute the query — Run the appropriate command and capture the response
4. Present results — Summarize endpoint names, IDs, statuses, VPC, IP and creation time in a readable form

Note on fuzzy matching: The VPCEP ListEndpoints API supports fuzzy name matching via the endpoint_service_name parameter. This parameter matches endpoint names that contain the given keyword string, not an exact or prefix match.

Core Commands

Endpoint Name Queries

Name-Only Lookup (jq)

To extract just the endpoint names:

hcloud VPCEP ListEndpoints --cli-region={region} --limit={limit} | jq -r '.endpoints[].endpoint_service_name'

To list endpoint names with status, VPC and IP:

hcloud VPCEP ListEndpoints --cli-region={region} --limit={limit} | jq -r '.endpoints[] | "\(.endpoint_service_name)\t\(.status)\t\(.vpc_id)\t\(.ip)"'

To show total count and paginated summary:

hcloud VPCEP ListEndpoints --cli-region={region} --limit={limit} | jq '{total_count, endpoints: [.endpoints[] | {name: .endpoint_service_name, id, status, vpc_id, ip, created_at}]}'

SDK Fallback Examples

When the CLI is unavailable, use the Python SDK:

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkvpcep.v1.region.vpcep_region import VpcepRegion
from huaweicloudsdkvpcep.v1 import vpcep_client
from huaweicloudsdkvpcep.v1.model import ListEndpointsRequest

credentials = BasicCredentials() \
    .with_ak(os.getenv("HUAWEI_ACCESS_KEY") or os.getenv("HUAWEICLOUD_SDK_AK")) \
    .with_sk(os.getenv("HUAWEI_SECRET_KEY") or os.getenv("HUAWEICLOUD_SDK_SK")) \
    .with_project_id("{project_id}")

client = vpcep_client.VpcepClient.new_builder() \
    .with_credentials(credentials) \
    .with_region(VpcepRegion.value_of("{region}")) \
    .build()

request = ListEndpointsRequest()
request.limit = 100
response = client.list_endpoints(request)
print(f"Total: {response.total_count}")
for ep in response.endpoints:
    print(ep.endpoint_service_name, ep.status, ep.vpc_id, ep.ip, ep.created_at)

Parameter Confirmation

Reference Documents

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

KooCLI Command Format Standard

hcloud VPCEP <Operation> --cli-region=<region> [--key=value ...]