huawei-cloud-eip-list

Huawei Cloud EIP List Skill

Overview

This skill lists all Huawei Cloud EIP (Elastic IP, 弹性公网IP) resources owned by the authenticated account in the specified region. It is a read-only inventory skill: it never creates, modifies, deletes EIPs, or changes any bandwidth or association.

Architecture:

Agent → hcloud CLI (KooCLI EIP, primary) → Huawei Cloud EIP API
       ↘ huaweicloudsdkeip Python SDK (fallback)  ↗

Applicable Scenarios:

• EIP inventory and resource discovery (which public IPs exist, their status and bandwidth)
• Network cost review (EIP count, bandwidth size and billing mode per region)
• Troubleshooting connectivity (checking whether an EIP exists and is bound to an instance)
• Compliance reporting (enumerating all EIPs per project/region)

Prerequisites

1. hcloud CLI (KooCLI) installed and authenticated — See references/cli-installation-guide.md
2. IAM permissions — vpc:publicIps:list (list) and vpc:publicIps:get (show detail) — See references/eip-policies.md
3. Python 3.6+ with huaweicloudsdkeip package (SDK fallback) — pip install huaweicloudsdkeip

Credentials. KooCLI reads credentials from hcloud configure (AK/SK) or environment variables. The EIP API is region-scoped: the same account credentials used for other Huawei Cloud services work here, and --cli-region selects the region whose EIPs are queried. Never ask the user to paste AK/SK into the conversation.

Workflow

1. Verify prerequisites — hcloud version, then run the list command (below)
2. Run the query — hcloud EIP ListPublicips --cli-region= (CLI primary) with desired options
3. Handle results — Parse EIP IDs, public IP addresses, statuses, bandwidths, and associated instances; report the total EIP count
4. Fallback — If the CLI is unavailable, use the Python SDK example below

Core Commands

List All EIPs

hcloud EIP ListPublicips --cli-region=cn-north-4

List EIPs (JSON Output)

hcloud EIP ListPublicips --cli-region=cn-north-4 --cli-output=json

Note: ListPublicips is a multi-version API — hcloud prints a version hint line (ListPublicips is a multi-version API, where the version (v3) is default...) to stdout before the JSON body. When piping to jq/python3 -c json.load, skip the first line (e.g. tail -n +2) or use the SDK fallback path below.

Filter by EIP ID

hcloud EIP ListPublicips --cli-region=cn-north-4 --id.1=

Filter by Public IP Address

hcloud EIP ListPublicips --cli-region=cn-north-4 --public_ip_address.1=

Filter by IP Version

hcloud EIP ListPublicips --cli-region=cn-north-4 --ip_version.1=4

Filter by Enterprise Project

hcloud EIP ListPublicips --cli-region=cn-north-4 --enterprise_project_id.1=0

Pagination (limit + marker, v2 API)

hcloud EIP ListPublicips/v2 --cli-region=cn-north-4 --limit=10 --marker=

Show EIP Detail

hcloud EIP ShowPublicip/v3 --cli-region=cn-north-4 --publicip_id=

SDK Fallback Example

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkeip.v2 import EipClient
from huaweicloudsdkeip.v2.model import ListPublicipsRequest
from huaweicloudsdkeip.v2.region.eip_region import EipRegion

credentials = BasicCredentials(
    os.environ["HUAWEI_CLOUD_ACCESS_KEY"],
    os.environ["HUAWEI_CLOUD_SECRET_KEY"],
)
client = EipClient.new_builder() \
    .with_credentials(credentials) \
    .with_region(EipRegion.value_of("cn-north-4")) \
    .build()

response = client.list_publicips(ListPublicipsRequest())
eips = response.publicips or []
for eip in eips:
    print(eip.id, eip.public_ip_address, eip.status, eip.bandwidth)
print("EIP number:", len(eips))

Parameter Confirmation

Reference Documents

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

KooCLI Command Format Standard

The hcloud EIP module maps directly to the Huawei Cloud EIP API operations.