huawei-cloud-cce-query

Huawei Cloud CCE Query Skill

Overview

This skill provides read-only query capabilities for Huawei Cloud CCE (Cloud Container Engine, the managed Kubernetes service). It lists all clusters in a project with their names, IDs, status, version and flavor, shows a single cluster's detail, and lists nodes for a given cluster. It is designed for inventory reporting, daily inspection, and quick name lookups.

Architecture:

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

Applicable Scenarios:

• Inventory all CCE clusters and collect their names in a region
• Check cluster health/status (Available, Creating, Upgrading, Deleting, etc.)
• Retrieve a specific cluster's detail by ID or name
• List the nodes inside a cluster for capacity/usage review

Prerequisites

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

Workflow

1. Identify query scope — Decide whether to list all clusters, show one cluster detail, or list nodes of a cluster
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 cluster names, IDs, statuses and node counts in a readable form

Core Commands

Cluster Queries

Node Queries

Name-Only Lookup (jq)

To extract just the cluster names:

hcloud CCE ListClusters --cli-region={region} | jq -r '.items[].metadata.name'

SDK Fallback Examples

When the CLI is unavailable, use the Python SDK:

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkcce.v3.region.cce_region import CceRegion
from huaweicloudsdkcce.v3 import CceClient, ListClustersRequest

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

client = CceClient.new_builder() \
    .with_credentials(credentials) \
    .with_region(CceRegion.value_of("{region}")) \
    .build()

request = ListClustersRequest()
response = client.list_clusters(request)
for cluster in response.items:
    print(cluster.metadata.name, cluster.status.phase)

Parameter Confirmation

Reference Documents

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

KooCLI Command Format Standard

hcloud CCE  --cli-region= [--key=value ...]