huawei-cloud-css-list

Huawei Cloud CSS (Elasticsearch) List Skill

Overview

Query the list of Huawei Cloud CSS (Cloud Search Service) clusters — the managed Elasticsearch (ES) service — under the current account project and region.

This skill provides:

• List all ES clusters in the current project/region
• Optional filter by datastore engine type (elasticsearch / logstash / opensearch)
• Pagination (--limit / --offset) for account-wide inventory
• Key cluster attributes in the response: ID, name, status, endpoint, datastore (engine + version), instances, VPC/subnet/security group, enterprise project, tags
• CLI-first execution with Python SDK fallback

Architecture

Huawei Cloud CSS (Elasticsearch) Cluster List
└── ListClustersDetails  (GET /v1.0/{project_id}/clusters)
    ├── CLI:  hcloud CSS ListClustersDetails --cli-region= [--param=value...]
    └── SDK:  huaweicloudsdkcss.v1.CssClient.list_clusters_details(ListClustersDetailsRequest)

Prerequisites

Prerequisite check: Huawei Cloud CLI (hcloud / KooCLI) >= 3.2.0 required Check the CLI version (run hcloud with the version argument) and confirm a version string is printed. If not installed or too old, see references/cli-installation-guide.md.

Prerequisite check: Huawei Cloud credentials required Check the CLI profile (run hcloud with the configure list arguments) and confirm a profile with valid AK/SK exists. Credentials must be read from the configured CLI profile or environment variables. Never ask for or echo AK/SK values in the conversation.

Prerequisite check: CSS (Cloud Search Service) enabled for the account The CSS ListClustersDetails API is region-scoped. If the user has clusters in multiple regions, run the query for each region of interest.

IAM Permission Policies

The IAM user must be granted the CSS read permission. See references/iam-policies.md.

Minimum required permissions:

• css:cluster:list — List CSS clusters

Core Workflows

Task 1: List All ES Clusters

Query the full ES cluster list of the current project/region.

hcloud CSS ListClustersDetails --cli-region={region} --limit=100

Task 2: List Only Elasticsearch Clusters

Filter by datastore engine type (elasticsearch / logstash / opensearch).

hcloud CSS ListClustersDetails --cli-region={region} --datastoreType=elasticsearch --limit=100
hcloud CSS ListClustersDetails --cli-region={region} --datastoreType=opensearch --limit=100

Task 3: Paginated Listing

Walk through all pages of ES clusters.

# First page (limit 10, offset 1)
hcloud CSS ListClustersDetails --cli-region={region} --limit=10 --offset=1

# Next page
hcloud CSS ListClustersDetails --cli-region={region} --limit=10 --offset=11

# Full JSON output (for agent consumption / parsing)
hcloud CSS ListClustersDetails --cli-region={region} --limit=100 --cli-output=json

Core Commands

KooCLI parameter format: all parameters use the --param=value (equals-sign) format. Operation name: the CSS list operation is ListClustersDetails (not ListClusters). Response fields: totalSize = cluster count; clusters[] = array of cluster objects (id, name, status, endpoint, datastore, instances, created, updated, vpcId, subnetId, securityGroupId, enterpriseProjectId, tags, etc.). An empty clusters array is a valid result — it means no ES clusters exist in that project/region. Cluster status values: 100 = creating, 200 = available, 300 = unavailable, 303 = creation failed.

Parameter Confirmation

Before executing any task, confirm the following parameters with the user. Guessing is prohibited.

KooCLI Command Format Standard

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

All concrete commands must use the --param=value equals-sign format.

Verification Method

See references/verification-method.md for details.

Quick validation:

# Confirm CLI works (returns cluster list or empty array)
hcloud CSS ListClustersDetails --cli-region=cn-north-4 --limit=10

Reference Documents