skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
huaweicloud/huaweicloud-skills80 installs

huawei-cloud-cloudrobo-resource

Query CloudRobo resource quotas and resource pools — list workspace-level and Domain-level quotas with CCE/ModelArts isolation (CCE: cpu/memory/gpu, ModelArts: npu), list resource pools with multi-condition filtering (type/sub-type/pool-type/usages), and show resource pool details with node-level information (name, status, resources, labels). Provides compute capacity visibility for training, evaluation, and inference workloads. Triggers include: resource quota query, resource pool query, resource pool list, resource pool detail, quota list, Domain quota aggregation, CCE quota, ModelArts quota, 资源配额查询, 资源池查询, 资源池列表, 资源池详情, 配额查询.

How do I install this agent skill?

npx skills add https://github.com/huaweicloud/huaweicloud-skills --skill huawei-cloud-cloudrobo-resource
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill is a standard tool for querying Huawei Cloud CloudRobo resources. It performs read-only operations to list quotas and resource pools using the official vendor CLI and SDK. No security issues were detected.

  • Socketwarn

    1 alert: gptAnomaly

  • Snykfail

    Risk: CRITICAL · 1 issue

What does this agent skill do?

Windows / PowerShell: Examples use bash syntax. To run on Windows PowerShell:

  • Flatten \ line continuations to a single line, or end lines with a backtick.
  • Set env vars with $env:NAME="value" instead of export NAME="value".
  • Single-quoted JSON '{"a":"b"}' works as-is.

Overview 概述

The cloudrobo-resource skill provides query capabilities for CloudRobo compute resources. It covers two core areas: resource quota querying (with Domain-level aggregation and CCE/ModelArts isolation) and resource pool querying (list with multi-condition filtering, show with node-level details). This skill is read-only — no write operations are included.

Applicable scenarios:

  • Quota querying — View workspace-level and Domain-level resource quotas; verify CCE (cpu/memory/gpu) and ModelArts (npu) quota isolation; check available capacity before launching workloads
  • Resource pool querying — List resource pools by type/sub-type/pool-type/usages; inspect node-level details (name, status, resources, labels)

Architecture:

Agent / LLM
    │
    ├── CLI  →  cloudrobo resource <command>
    ├── SDK  →  ResourceClient (Python)
                    │
                    ▼
              cloudrobo-service (REST API)
              /v1/resources/quotas
              /v1/resources/pools
              /v1/resources/pools/{pool_id}

All operations target the cloudrobo-service backend. Resource operations are domain-level — quota list and pool list require ABAC permission; pool detail does not.

Prerequisites 前置条件

See references/cli-installation-guide.md for CLI installation, AK/SK authentication, and initial configuration. The cloudrobo-resource package depends on cloudrobo-core. Ensure cloudrobo workspace use --workspace-id <id> has been run to set the active workspace context before using resource commands.

Workflow 工作流

Quota Query Workflow 配额查询工作流

  1. List quotas — cloudrobo resource list-quotas (returns domain_quotas + quotas + page_info)
  2. Filter by type — cloudrobo resource list-quotas --resource-type CCE (CCE: npu=0; MODELARTS: cpu/memory/gpu=0)
  3. Filter by workspace — cloudrobo resource list-quotas --workspace-id <id> (workspace-scoped quotas)
  4. Check capacity — Review domain_quotas[].available_spec for available compute resources

Resource Pool Query Workflow 资源池查询工作流

  1. List pools — cloudrobo resource list-pools (returns resources + page_info)
  2. Filter pools — cloudrobo resource list-pools --resource-type MODELARTS --resource-sub-type STANDARD
  3. Show pool detail — cloudrobo resource show-pool --pool-id <id> (returns node info, status, config)

CLI Command Format Standard CLI命令格式标准

cloudrobo resource <command> [OPTIONS]
FeatureDescriptionExample
Command groupresourcecloudrobo resource
Subcommandkebab-caselist-quotas, list-pools, show-pool
Output formatJSON to stdoutout(result)
Comma list--usages TRAINING,INFERENCE--usages TRAINING,INFERENCE
Enum paramsclick.Choice validated`--resource-type CCE
Pagination--limit 1-50 / --offset N--limit 20 --offset 0

Core Commands 核心命令

Quota Query 配额查询

List quotas

cloudrobo resource list-quotas [--workspace-id <id>] [--resource-id <id>] [--resource-type CCE|MODELARTS] [--resource-sub-type CPU|GPU|STANDARD|LITE] [--pool-type DEDICATED|SHARED] [--limit <n>] [--offset <n>] [--order ASC|DESC]
  • SDK: client.list_quotas(**params)
  • API: GET /v1/resources/quotas

Returns: domain_quotas (Domain-level aggregation with total_spec, used_spec, available_spec), quotas (workspace-level list with quota_id, resource_name, specs, nodes), page_info. CCE type quotas have npu=0; ModelArts type quotas have cpu/memory/gpu=0.

Resource Pool Query 资源池查询

List resource pools

cloudrobo resource list-pools [--resource-type CCE|MODELARTS] [--resource-sub-type CPU|GPU|STANDARD|LITE] [--pool-type DEDICATED|SHARED] [--usages TRAINING,INFERENCE] [--limit <n>] [--offset <n>] [--order ASC|DESC]
  • SDK: client.list_pools(**params)
  • API: GET /v1/resources/pools

Returns: resources (list of ResourceVo with resource_id, resource_name, resource_type, resource_sub_type, nodes, config, status, description, usages, pool_type, create_at), page_info. Pass resource_id to show-pool --pool-id.

Training task cluster_id: list-pools is for pool/flavor discovery and does not reliably determine the value to submit. ModelArts config.cluster_id may be None; do not assume resource_id or config.pool_id is interchangeable with the task's cluster_id. For a training task, copy cluster_id from a successful task in the same workspace. The observed SHARED format is pool-<resource_id>; do not assume it applies to DEDICATED pools.

Show resource pool detail

cloudrobo resource show-pool --pool-id <uuid>
  • SDK: client.show_pool(pool_id)
  • API: GET /v1/resources/pools/{pool_id}

--pool-id takes the pool's resource_id exactly as returned by list-pools — pass it through unmodified (no prefix stripping needed).

Returns: full ResourceVo including nodes (name, status, resources, available_resources, labels), config, status (AVAILABLE/UNAVAILABLE).

Parameter Confirmation 参数确认

All resource commands are read-only queries. Confirm the following before running them:

ParameterUsed byValues / SourceNotes
--workspace-idlist-quotasactive workspace (cloudrobo workspace use --workspace-id <id>) or explicit IDomit to use the active workspace context
--resource-typelist-quotas, list-poolsCCE | MODELARTSCCE quotas report npu=0; ModelArts quotas report cpu/memory/gpu=0
--resource-sub-typelist-quotas, list-poolsCPU | GPU | STANDARD | LITEoptional filter
--pool-typelist-quotas, list-poolsDEDICATED | SHAREDoptional filter
--usageslist-poolscomma list, e.g. TRAINING,INFERENCEoptional filter
--resource-idlist-quotasresource_id from list-poolsoptional filter
--pool-idshow-poolresource_id exactly as returned by list-poolsrequired for show-pool
--limit / --offsetlist-quotas, list-pools--limit 1-50, --offset Npagination
--orderlist-quotas, list-poolsASC | DESCoptional sort order

Reference Documents 参考文档

Edge Cases 边界情况

ScenarioHandling
Missing workspace_idQuota list returns all domain quotas; use --workspace-id to filter by workspace
ABAC permission denied (403)Quota list and pool list require ABAC; pool detail does not require ABAC
Pagination out of range (400)limit must be 1-50; offset must be ≥ 0; server validates and returns 400
Resource pool not found (404)show-pool with invalid pool_id returns 404; verify with list-pools first
AK/SK not setOperations fail at HTTP signing step; set HUAWEI_CLOUD_AK/HUAWEI_CLOUD_SK
API pathsSourced from SDK source code (_url() calls in client.py), not inferred
Quota calculation isolationCCE: only cpu/memory/gpu counted (npu=0); ModelArts: only npu counted (cpu/memory/gpu=0)

Verification Method 验证方法

Specification Compliance Verification 规范合规验证

bash scripts/test-cli-commands.sh -s . -e cli

Functional Testing 功能测试

# CLI / SDK
bash scripts/test-cli-commands.sh -s . -e {cli|sdk}

Test Cases 测试用例

See templates/test-vars.json for the full test case list covering quota querying and resource pool querying scenarios.

Verification Checklist 验证清单

  • Verify list-quotas returns domain_quotas with CCE npu=0 and ModelArts cpu/memory/gpu=0
  • Verify list-quotas supports --workspace-id and --resource-type filtering
  • Verify list-pools returns resources with page_info
  • Verify show-pool returns node-level details including labels
  • Verify list-quotas and list-pools support pagination (--limit, --offset)

Best Practices 最佳实践

  • Run list-quotas before launching workloads to verify available capacity
  • Use --resource-type filter to verify CCE/ModelArts quota isolation
  • Use list-pools with --usages filter to find pools suitable for specific workloads
  • Run show-pool to inspect node-level details before allocating resources
  • Check domain_quotas[].available_spec for Domain-level capacity overview
  • Use pagination (--limit, --offset) to manage large result sets efficiently

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/huaweicloud/huaweicloud-skills/huawei-cloud-cloudrobo-resource">View huawei-cloud-cloudrobo-resource on skillZs</a>