huawei-cloud-cloudrobo-resource

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]

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.

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).

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 边界情况

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