Huawei Cloud SWR Namespace (Organization) List Skill

Overview

Query the list of Huawei Cloud SWR (Software Repository for Container) namespaces (organizations) under the current account project and region. Namespaces are the top-level organizational unit in SWR — they group image repositories.

This skill provides:

• List all namespaces (organizations) in the current project/region
• Optional filter by namespace name (--namespace) or complex filter (--filter)
• Key namespace attributes in the response: ID, name, creator, auth level, access user count, repository count
• CLI-first execution with Python SDK fallback

Read-only skill: 本 skill 仅支持 SWR 命名空间只读查询（ListNamespaces），不支持创建、删除、修改等写操作。如需写操作，请使用 huawei-cloud-swr-image-management skill。

Architecture

Huawei Cloud SWR Namespace (Organization) List
└── ListNamespaces  (GET /v2/manage/projects/{project_id}/namespaces)
    ├── CLI:  hcloud SWR ListNamespaces --cli-region=<region> [--param=value...]
    └── SDK:  huaweicloudsdkswr.v2.SwrClient.list_namespaces(ListNamespacesRequest)
              → response.namespaces (list of Namespace 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 ListNamespaces API is region-scoped. If the user has namespaces 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:namespace:list — List SWR namespaces

Core Workflows

Task 1: List All Namespaces

Query the full namespace (organization) list of the current project/region.

hcloud SWR ListNamespaces --cli-region={region}

Task 2: Filter by Namespace Name

Filter namespaces by a specific name.

hcloud SWR ListNamespaces --cli-region={region} --namespace=group-dev

Task 3: Complex Filter

Filter using a complex filter expression.

# Filter by namespace name and visibility mode
hcloud SWR ListNamespaces --cli-region={region} --filter="namespace::group-dev|mode::visible"

Task 4: Full JSON Output

Output as JSON for agent consumption and parsing.

hcloud SWR ListNamespaces --cli-region={region} --cli-output=json

Core Commands

KooCLI parameter format: all parameters use the --param=value (equals-sign) format. Operation name: the SWR namespace list operation is ListNamespaces. Response format: a JSON object with a namespaces array. Response fields: each item has id (numeric namespace ID), name (namespace name), creator_name (creator IAM user name), auth (permission level: 7=manage, 3=edit, 1=read), access_user_count (number of users with access), repo_count (number of repositories under this namespace). An empty namespaces array is a valid result — it means no SWR namespaces exist in that project/region. SDK model note: the SDK Namespace model maps id, name, creator_name, and auth only; access_user_count and repo_count are returned by the CLI/API but not mapped in the SDK model. No pagination: ListNamespaces returns all namespaces; --limit/--offset are not supported.

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 namespace list or empty array)
hcloud SWR ListNamespaces --cli-region=cn-north-4

Reference Documents