Huawei Cloud DCS List Skill

Overview

This skill provides read-only name-query capabilities for Huawei Cloud DCS (Distributed Cache Service, i.e. managed Redis / Memcached). It lists all DCS instances in a region, extracts instance names, and supports filtering by name and status, and instance ID lookup. It is designed for quick name lookups, inventory reporting, and daily instance inspection.

Architecture:

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

Applicable Scenarios:

• List all DCS instance names in a region for inventory
• Find a DCS instance by name (fuzzy or exact match)
• Check which instances are in a given status (RUNNING, etc.)
• Look up a specific instance by ID for cross-reference

Prerequisites

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

Workflow

1. Identify query scope — Decide whether to list all DCS instances, filter by name, status, or instance ID
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 DCS instance names, IDs and statuses in a readable form

Note on exact name matching: The DCS ListInstances API documents a name_equal query parameter for exact-match filtering. In current deployments it can return empty results even for existing names, so the fuzzy --name filter is the reliable way to look up an instance by name; use the returned instance_id with ShowInstance for precise detail.

Core Commands

Instance Name Queries

Name-Only Lookup (jq)

To extract just the instance names:

hcloud DCS ListInstances --cli-region={region} --limit={limit} | jq -r '.instances[].name'

To list instance names with status:

hcloud DCS ListInstances --cli-region={region} --limit={limit} | jq -r '.instances[] | "\(.name)\t\(.status)\t\(.instance_id)"'

SDK Fallback Examples

When the CLI is unavailable, use the Python SDK:

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkdcs.v2.region.dcs_region import DcsRegion
from huaweicloudsdkdcs.v2 import dcs_client
from huaweicloudsdkdcs.v2.model import ListInstancesRequest

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

client = dcs_client.DcsClient.new_builder() \
    .with_credentials(credentials) \
    .with_region(DcsRegion.value_of("{region}")) \
    .build()

request = ListInstancesRequest()
request.limit = 100
response = client.list_instances(request)
for instance in response.instances:
    print(instance.name, instance.status, instance.instance_id)

Parameter Confirmation

Reference Documents

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

KooCLI Command Format Standard

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