Huawei Cloud SWR Repository List Skill

Overview

Query the list of Huawei Cloud SWR (Software Repository for Container) image repositories under the current account project and region.

This skill provides:

• List all image repositories in the current project/region
• Optional filter by namespace (--namespace), repository name fuzzy match (--name), or category (--category)
• Pagination (--limit / --offset) and sorting (--order_column / --order_type) for account-wide inventory
• Key repository attributes in the response: name, namespace, category, visibility, image/tag count, size, download count, full path, tags, timestamps
• CLI-first execution with Python SDK fallback

Architecture

Huawei Cloud SWR Image Repository List
└── ListReposDetails  (GET /v2/manage/projects/{project_id}/repos)
    ├── CLI:  hcloud SWR ListReposDetails --cli-region=<region> [--param=value...]
    └── SDK:  huaweicloudsdkswr.v2.SwrClient.list_repos_details(ListReposDetailsRequest)
              → response.body (list of Repository objects)

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: SWR (Software Repository for Container) enabled for the account The SWR ListReposDetails API is region-scoped. If the user has repositories in multiple regions, run the query for each region of interest.

IAM Permission Policies

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

Minimum required permissions:

• swr:repository:list — List SWR image repositories

Core Workflows

Task 1: List All Image Repositories

Query the full image repository list of the current project/region.

hcloud SWR ListReposDetails --cli-region={region} --limit=100

Task 2: List Repositories in a Namespace

Filter by namespace (organization) name.

hcloud SWR ListReposDetails --cli-region={region} --namespace=group-dev --limit=100

Task 3: Filter by Repository Name (Fuzzy Match)

Search repositories by name keyword.

hcloud SWR ListReposDetails --cli-region={region} --name=nginx --limit=100

Task 4: Filter by Category

Filter by repository category (app_server / linux / framework_app / database / lang / other / windows / arm).

hcloud SWR ListReposDetails --cli-region={region} --category=database --limit=100

Task 5: Paginated Listing with Sorting

Walk through all pages of image repositories.

# First page (limit 10, offset 0, sorted by update time descending)
hcloud SWR ListReposDetails --cli-region={region} --limit=10 --offset=0 --order_column=updated_time --order_type=desc

# Next page
hcloud SWR ListReposDetails --cli-region={region} --limit=10 --offset=10 --order_column=updated_time --order_type=desc

# Full JSON output (for agent consumption / parsing)
hcloud SWR ListReposDetails --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 SWR repository list operation is ListReposDetails. Response format: a flat JSON array of repository objects (not wrapped in an object). Response fields: each item has name, namespace, category, description, size, is_public, num_images (image/tag count), num_download, path (full image path for docker pull), internal_path, tags (array of tag name strings), created_at, updated_at. An empty array [] is a valid result — it means no image repositories exist in that project/region. Pagination: --limit and --offset must be used together. Default limit is 100, max is 1000. Sorting: --order_column accepts name, updated_time, or tag_count (note: tag_count is the param value, the response field is num_images).

Parameter Confirmation

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

KooCLI Command Format Standard

hcloud <Service> <Operation> --cli-region=<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 repository list or empty array)
hcloud SWR ListReposDetails --cli-region=cn-north-4 --limit=10

Reference Documents