Huawei Cloud CCE Cluster List for Openclaw

A read-only Openclaw Skills integration for inventorying Huawei Cloud CCE clusters by name, ID, status, version, and flavor.

erickeyhu-hug
v1.0.1
Aug 5, 2026
0
220
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install huawei-cloud-cce-list

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install huawei-cloud-cce-list using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Huawei Cloud CCE Cluster List?

Huawei Cloud CCE Cluster List queries Cloud Container Engine clusters in the current Huawei Cloud tenant and project, returning each cluster's name, ID, lifecycle status, Kubernetes version, and flavor. It is designed for reliable cluster inventory, daily inspection, cost review, and fast retrieval of exact CCE cluster names.

This Openclaw Skills integration uses the KooCLI hcloud CCE ListClusters command against the Huawei Cloud CCE v3 API as its primary method, with the huaweicloudsdkcce Python SDK available as a fallback. It is strictly read-only and never creates, modifies, or deletes clusters, nodes, or related resources.

Huawei Cloud CCE Cluster List Use Cases

  • Build an inventory of every CCE cluster in a Huawei Cloud region or project.
  • Retrieve a pure list of CCE cluster names for follow-up automation.
  • Review cluster availability, lifecycle state, Kubernetes version, and flavor during daily operations.
  • Filter clusters by status such as Available, Creating, ScalingUp, or Upgrading.
  • Filter clusters by type, including VirtualMachine or ARM64 Kunpeng clusters.
  • Support cost reviews by enumerating cluster flavors and identifying unused or oversized environments.
  • Answer requests such as list CCE clusters, query CCE cluster names, CCE cluster inventory, or how many CCE clusters exist.
  • Explain that cluster creation, deletion, resizing, node inspection, node-pool queries, addon operations, kubeconfig retrieval, and single-cluster detail lookups are outside this skill's scope.

How Huawei Cloud CCE Cluster List Works

  1. Identify the user's intent and confirm that the request is to list CCE clusters, optionally with status, type, or name-only output.
  2. Confirm the Huawei Cloud region, using cn-north-4 by default when no region is provided.
  3. Run hcloud CCE ListClusters --cli-region=<region> with JSON output and any requested filters.
  4. Parse the v3 API response and map metadata.name to the cluster name, metadata.uid to the ID, status.phase to status, and spec.version to the Kubernetes version.
  5. Present complete cluster records with name, ID, status, version, and flavor, or return only names when a name-list response is requested.
  6. If KooCLI fails because of credentials, permissions, or network issues, retry or verify the request with the huaweicloudsdkcce Python SDK fallback.
  7. Preserve the read-only boundary: the workflow performs no cluster, node, node-pool, or addon changes.

The underlying CCE v3 operation is GET /api/v3/projects/{project_id}/clusters.

Huawei Cloud CCE Cluster List Setup

Prerequisites

  1. Install and authenticate the Huawei Cloud KooCLI hcloud command-line tool.
  2. Use Python 3.8 or later if the SDK fallback is required.
  3. Ensure the IAM identity has cce:cluster:list permission or the CCE ReadOnlyAccess system policy.
  4. Choose a region where the tenant owns CCE clusters.
  5. Install jq for name-only and compact field extraction.

Primary CLI setup and queries

hcloud CCE ListClusters --cli-region=cn-north-4 --cli-output=json
hcloud CCE ListClusters --cli-region=cn-north-4 --cli-output=json | jq -r '.items[].metadata.name'
hcloud CCE ListClusters --cli-region=cn-north-4 --cli-output=json \
  | jq -r '.items[] | [.metadata.name, .metadata.uid, .status.phase, .spec.version] | @tsv'

Optional filters

hcloud CCE ListClusters --cli-region=cn-north-4 --status=Available --cli-output=json
hcloud CCE ListClusters --cli-region=cn-north-4 --type=VirtualMachine --cli-output=json

SDK fallback

Install the CCE SDK when the CLI is unavailable or needs verification:

python3 -m pip install huaweicloudsdkcce

Replace cn-north-4 with the target region and provide valid Huawei Cloud authentication credentials before running queries.

Huawei Cloud CCE Cluster List Data Schema & Taxonomy

The skill consumes the CCE v3 list response and organizes cluster records around the following fields:

Output concept API field Description
Cluster name metadata.name Canonical CCE cluster name; metadata.alias is usually the same value
Cluster ID metadata.uid Unique cluster identifier
Status status.phase Lifecycle state such as Available, Creating, or Upgrading
Kubernetes version spec.version Kubernetes version deployed by the cluster
Flavor Cluster flavor fields in the response Compute or service sizing information used for inventory and cost review
Cluster type Request filter type VirtualMachine for standard CCE or ARM64 for Kunpeng clusters

Request parameters

  • region: Required CLI region, for example cn-north-4.
  • status: Optional lifecycle filter, such as Available.
  • type: Optional cluster type filter, such as VirtualMachine.
  • detail: Optional CLI parameter supported by the list command, although this skill remains limited to cluster-list inspection.

Response organization

  • The API returns cluster records in the .items[] collection.
  • Name-only output extracts .items[].metadata.name.
  • Compact tab-separated output combines name, ID, status, and version.
  • No files or persistent state are generated by the read-only query itself; results are returned directly to the agent or command-line session.
  • Reference metadata is maintained through IAM policy, CLI installation, verification, dataflow, and acceptance-criteria documentation.

Huawei Cloud CCE Cluster List Advanced Features

  • Uses KooCLI hcloud CCE ListClusters as the primary execution path with the Huawei Cloud CCE v3 API.
  • Provides a Python huaweicloudsdkcce fallback for CLI failures, validation, and independent verification.
  • Supports status filtering across Available, Unavailable, ScalingUp, ScalingDown, Creating, Deleting, Upgrading, Resizing, RollingBack, RollbackFailed, and Empty.
  • Supports cluster-type filtering for VirtualMachine and ARM64 Kunpeng clusters.
  • Produces either structured JSON, a pure cluster-name list, or compact tab-separated fields for downstream shell automation.
  • Uses explicit region selection through --cli-region=<region> to avoid querying the wrong Huawei Cloud location.
  • Enforces least-privilege, read-only IAM usage through cce:cluster:list or CCE ReadOnlyAccess.
  • Includes verification and acceptance-test guidance through dedicated reference documents.
  • Clearly separates cluster inventory from unsupported operations such as provisioning, deletion, scaling, node inspection, addon management, and kubeconfig retrieval.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*