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-resourceIs 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 ofexport 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 配额查询工作流
- List quotas —
cloudrobo resource list-quotas(returns domain_quotas + quotas + page_info) - Filter by type —
cloudrobo resource list-quotas --resource-type CCE(CCE: npu=0; MODELARTS: cpu/memory/gpu=0) - Filter by workspace —
cloudrobo resource list-quotas --workspace-id <id>(workspace-scoped quotas) - Check capacity — Review
domain_quotas[].available_specfor available compute resources
Resource Pool Query Workflow 资源池查询工作流
- List pools —
cloudrobo resource list-pools(returns resources + page_info) - Filter pools —
cloudrobo resource list-pools --resource-type MODELARTS --resource-sub-type STANDARD - Show pool detail —
cloudrobo resource show-pool --pool-id <id>(returns node info, status, config)
CLI Command Format Standard CLI命令格式标准
cloudrobo resource <command> [OPTIONS]
| Feature | Description | Example |
|---|---|---|
| Command group | resource | cloudrobo resource |
| Subcommand | kebab-case | list-quotas, list-pools, show-pool |
| Output format | JSON to stdout | out(result) |
| Comma list | --usages TRAINING,INFERENCE | --usages TRAINING,INFERENCE |
| Enum params | click.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-poolsis for pool/flavor discovery and does not reliably determine the value to submit. ModelArtsconfig.cluster_idmay beNone; do not assumeresource_idorconfig.pool_idis interchangeable with the task'scluster_id. For a training task, copycluster_idfrom a successful task in the same workspace. The observed SHARED format ispool-<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:
| Parameter | Used by | Values / Source | Notes |
|---|---|---|---|
--workspace-id | list-quotas | active workspace (cloudrobo workspace use --workspace-id <id>) or explicit ID | omit to use the active workspace context |
--resource-type | list-quotas, list-pools | CCE | MODELARTS | CCE quotas report npu=0; ModelArts quotas report cpu/memory/gpu=0 |
--resource-sub-type | list-quotas, list-pools | CPU | GPU | STANDARD | LITE | optional filter |
--pool-type | list-quotas, list-pools | DEDICATED | SHARED | optional filter |
--usages | list-pools | comma list, e.g. TRAINING,INFERENCE | optional filter |
--resource-id | list-quotas | resource_id from list-pools | optional filter |
--pool-id | show-pool | resource_id exactly as returned by list-pools | required for show-pool |
--limit / --offset | list-quotas, list-pools | --limit 1-50, --offset N | pagination |
--order | list-quotas, list-pools | ASC | DESC | optional sort order |
Reference Documents 参考文档
- CLI Installation Guide — cloudrobo CLI installation and configuration
- IAM Policies — Least-privilege credential model and ABAC actions
- API Paths — REST API paths discovered via SDK source
- Resource Config Reference — Field mapping, validation rules, enums
- Dataflow Diagram — Mermaid data flow diagram
- Verification Method — Verification method details
- Acceptance Criteria — Acceptance criteria
Edge Cases 边界情况
| Scenario | Handling |
|---|---|
Missing workspace_id | Quota 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 set | Operations fail at HTTP signing step; set HUAWEI_CLOUD_AK/HUAWEI_CLOUD_SK |
| API paths | Sourced from SDK source code (_url() calls in client.py), not inferred |
| Quota calculation isolation | CCE: 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-quotasreturnsdomain_quotaswith CCEnpu=0and ModelArtscpu/memory/gpu=0 - Verify
list-quotassupports--workspace-idand--resource-typefiltering - Verify
list-poolsreturnsresourceswithpage_info - Verify
show-poolreturns node-level details includinglabels - Verify
list-quotasandlist-poolssupport pagination (--limit,--offset)
Best Practices 最佳实践
- Run
list-quotasbefore launching workloads to verify available capacity - Use
--resource-typefilter to verify CCE/ModelArts quota isolation - Use
list-poolswith--usagesfilter to find pools suitable for specific workloads - Run
show-poolto inspect node-level details before allocating resources - Check
domain_quotas[].available_specfor Domain-level capacity overview - Use pagination (
--limit,--offset) to manage large result sets efficiently
How can the creator link this skill?
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>