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

huawei-cloud-cloudrobo-asset

Manage the full lifecycle of CloudRobo assets — query repositories and catalogs, create/list/show/update/delete assets and versions, batch-delete, tag management, predefined tag discovery, Action CRUD, permission checks, marketplace search, official/community asset listing, asset lineage, and local-to-OBS import/export. Triggers include: asset import, asset export, asset version management, tag management, Action configuration, permission check, marketplace search, lineage query, repository listing, catalog listing, publication asset discovery, 资产管理, 资产导入导出, 版本管理, 标签管理, Action配置, 权限校验, 广场搜索, 血缘关系, 资产仓库, 目录查询.

How do I install this agent skill?

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

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill is a management tool for Huawei Cloud CloudRobo assets, authored by the official vendor. It follows security best practices for credential handling and uses trusted infrastructure. A minor attack surface for indirect prompt injection exists because the tool parses metadata from local files during asset imports, though it implements validation and safe parsing logic.

  • Socketwarn

    1 alert: gptAnomaly

  • Snykfail

    Risk: CRITICAL · 2 issues

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-asset skill manages the full lifecycle of CloudRobo platform assets. It covers repository and catalog queries, asset CRUD (create/list/show/update/delete/batch-delete), version CRUD, tag management, Action CRUD, permission checks, marketplace search, official/community asset listing, asset lineage, and local-to-OBS import/export.

Applicable scenarios:

  • Asset lifecycle — Create, list, show, update, delete, batch-delete assets and versions
  • Import/Export — Import local folders to OBS as assets; export asset versions to local paths
  • Marketplace discovery — Search marketplace assets; list official/community publication assets
  • Tag management — Add/delete tags; query platform predefined tag lists
  • Action management — Create/list/show/update/delete Actions on asset versions
  • Permission check — Verify user permissions on asset versions
  • Lineage — Query parent-child relationships between asset versions

Architecture:

Agent / LLM
    │
    ├── CLI  →  cloudrobo asset <command>
    ├── SDK  →  AssetClient (Python)
                    │
                    ▼
              cloudrobo-asset-manager (REST API)
              /v1/repositories
              /v1/catalogs
              /v1/assets/*
              /v1/asset-service/search
              /v1/asset-service/publication-assets
              /v1/asset-tags
              │
              ├── OBS (import/export file transfer)
              └── cloudrobo-obs endpoint (configured separately)

All operations target the cloudrobo-asset-manager backend. Import/export additionally requires a cloudrobo-obs endpoint for OBS file transfer.

Prerequisites 前置条件

See references/cli-installation-guide.md for CLI installation, AK/SK authentication, and configuration. Import/export operations require the cloudrobo-obs endpoint to be configured in ~/.cloudrobo/config.yaml or via the CLOUDROBO_ENDPOINT_cloudrobo-obs environment variable.

Workflow 工作流

Prerequisite: Get catalog_id 前置步骤

Multiple scenarios require a catalog_id. Only execute when the user has not provided it:

  1. Get from current workspace (preferred): cloudrobo workspace current → read asset_catalog_id field (the catalog bound to the current workspace)
  2. Fallback — list repositories and catalogs: If no workspace is configured or asset_catalog_id is empty:
    1. cloudrobo asset list-repositories → get repository_id
    2. cloudrobo asset list-catalogs --repository-id <repo-id> → get catalog_id

Scenario 1: Import Local Asset 导入资产

Import local files (models, datasets, etc.) into the CloudRobo asset repository.

Fast path: If local-path/README.md exists with valid frontmatter (e.g., from a previous export-asset), only --catalog-id (for new asset) or --asset-id (for new version) is needed — all other metadata is read from frontmatter. Without frontmatter, catalog_id, name, type (and sub_type for simulation) must be provided via CLI.

  1. (Only when creating new asset and catalog_id is missing) Execute "Prerequisite: Get catalog_id"
  2. Import:
    # With frontmatter (recommended — after export)
    cloudrobo asset import-asset --catalog-id <id> --local-path <path>
    # Without frontmatter
    cloudrobo asset import-asset --catalog-id <id> --name <name> --type <type> --local-path <path> [--sub-type <sub-type>] [--ext-metadata '{"key":"value"}']
    
    • Auto-reads local-path/README.md frontmatter for metadata (name, type, sub_type, description, status, tags, version, ext_metadata, parent_asset_version_id, generation_method)
    • Frontmatter values override CLI parameters (except catalog_id, CLI only); fields missing from both trigger errors
    • --ext-metadata CLI param also supported (frontmatter overrides it)
    • ext_metadata pre-validated by type before API call (model→model_type, dataset→annotation_status, algorithm→engine+command, image→arch+device_type, simulation (sub_type=robot)→robot_type+robot_manufacturer)
    • Auto-creates asset + version + uploads to OBS
    • Existing asset new version: add --asset-id <existing-asset-id>
    • Reuse existing version for upload retry: add --asset-id <id> --version-id <vid> (uploads files directly; same-name OBS objects are overwritten idempotently)

Type constraints:

  • image type is NOT supported by import-asset — image is a SWR reference with no local code upload semantics; use create-asset instead (CLI raises UsageError otherwise)
  • algorithm type IS supported — importing an algorithm uploads local code to the OBS code_dir:
    # Mode 1: new asset
    cloudrobo asset import-asset --catalog-id <id> --name <name> --type algorithm --tags "Train" --ext-metadata '{"engine":{"image_url":"swr...","image_source":"custom"},"command":"python train.py"}' --local-path ./algo-dir
    # Mode 2: new version for existing algorithm asset (no --catalog-id needed)
    cloudrobo asset import-asset --asset-id <existing-algo-asset-id> --type algorithm --tags "Train" --ext-metadata '{"engine":{"image_url":"swr...","image_source":"custom"},"command":"python train.py"}' --local-path ./algo-dir
    
    Algorithm import flow (automatic, Mode 1 & Mode 2):
    1. Validates --tags is required (allowed: Data Processing / Train)
    2. Mode 2 requires --ext-metadata (must include engine and command); not passing raises ValueError, passing invalid raises ValidationError
    3. Gets catalog.url (Mode 2: from asset detail, no --catalog-id needed); creates asset/version with placeholder code_dir = {catalog.url}/pending (preset image backend requires code_dir)
    4. Creates asset/version → gets asset_id + version_id
    5. Uploads local code to {catalog.url}/{asset_id}/{version_id}/
    6. Updates code_dir to the actual upload path on both asset-level and version-level ext_metadata (clears placeholder pending)
    • --asset-id --version-id (Mode 3) is NOT supported for algorithm — raises ValueError (version reuse unsupported; use --asset-id for a new version)
    • Mode 3 also rejects image assets at SDK layer (not just CLI) — raises ValueError "import_asset does not support image assets"
  1. Verify: cloudrobo asset show-asset --asset-id <asset-id>

Error recovery: If import fails at OBS upload (asset and version created but files not uploaded, version stays in CREATING status), do NOT create a new version. Two recovery strategies:

  • Reuse version (recommended): list-versions --asset-id <id> to find the failed version, re-run import-asset --asset-id <id> --version-id <vid> to upload directly (retries all files; the version transitions to DRAFT once upload succeeds)
  • Delete and retry: delete-version --asset-id <id> --version-id <vid> then re-run import-asset --asset-id <id>

Scenario 2: Search Marketplace 搜索广场资产

  1. Search: cloudrobo asset search-assets --keyword <keyword>
  2. Show detail: cloudrobo asset show-asset --asset-id <asset-id>

Browse official/community: cloudrobo asset list-publication-assets --type <type>

Export after search: Only when the user requests export. Before downloading, check that the current account holds data_read permission on the asset version; --version-id is required — if the user did not provide one, resolve the latest version ID via list-versions --asset-id <id>, then run: cloudrobo asset check-permission --asset-id <id> --version-id <version-id> --permissions data_read If the verdict is deny, do not run the export and inform the user: "当前账号无该资产数据读取 权限,仅能导出元数据(README),无法下载数据文件". Only when data_read is granted, run cloudrobo asset export-asset --asset-id <id> --local-path <path> (default latest version; add --version-id for specific version). Export automatically generates README.md with YAML frontmatter containing asset metadata, enabling seamless re-import with minimal CLI parameters.

Scenario 3: List Workspace Assets 列举空间资产

  1. (Only when catalog_id is missing) Execute "Prerequisite: Get catalog_id"
  2. List: cloudrobo asset list-assets --catalog-id <catalog-id>
    • Filter by --type, --sub-type, --status
    • Or use --repository-id instead of --catalog-id for repository-level queries

Scenario 4: List Asset Versions 列举资产版本

  1. If asset_id is known, skip to step 3
  2. (Only when asset_id is missing) Execute "Prerequisite: Get catalog_id", then list-assets --catalog-id <id> to locate asset_id
  3. List versions: cloudrobo asset list-versions --asset-id <asset-id>

Scenario 5: Create Asset with ext_metadata 创建含扩展元数据的资产

model, dataset, simulation, algorithm, image types require ext_metadata at creation. Consult references/validation-rules.md for required fields by type.

  1. (Only when catalog_id is missing) Execute "Prerequisite: Get catalog_id"
  2. Create: cloudrobo asset create-asset --catalog-id <id> --name <name> --type model --ext-metadata '{"model_type":"planning"}'
  3. Create version: cloudrobo asset create-version --asset-id <id> --version 1.0.0 --ext-metadata '{"model_type":"planning"}'

Task scenario tag constraints (algorithm/image types):

  • --tags is required at creation (at least 1 task scenario tag)
  • algorithm tags allowed: Data Processing, Train
  • image tags allowed: Data Processing, Notebook, Online Deployment, Train
  • When an algorithm references an image (ext_metadata.engine.asset_id), the algorithm tags must be a subset of the image tags (SDK validates; raises ValidationError otherwise)

Scenario 6: Tag Management 标签管理

  1. Add: cloudrobo asset add-tags --asset-id <id> --tags "tag1,tag2"
  2. Delete: cloudrobo asset delete-tag --asset-id <id> --tag <tag>
  3. Query predefined: cloudrobo asset list-tags --language zh (optional --type/--sub-type filter)

CLI Command Format Standard CLI命令格式标准

cloudrobo asset <command> [OPTIONS]
FeatureDescriptionExample
Command groupcloudrobo assetcloudrobo asset list-assets
Subcommandkebab-caselist-repositories, create-asset, import-asset
JSON parameter--ext-metadata '{"key":"value"}'--ext-metadata '{"model_type":"planning"}'
Comma list--tags tag1,tag2--tags robot,arm
Dry-run--dry-run (where supported)Preview without executing
Output formatJSON to stdoutout(result)
UUID identifiers--asset-id, --version-id, --catalog-idUUID format required

Core Commands 核心命令

Repository & Catalog 仓库与目录

CommandKey ParamsSDK MethodAPI
list-repositories[--name] [--sort-dir] [--offset] [--limit]client.list_repositories(**params)GET /v1/repositories
list-catalogs--repository-id <id> [--name] [--sort-dir] [--offset] [--limit]client.list_catalogs(repository_id, **params)GET /v1/catalogs
show-catalog--catalog-id <id>client.show_catalog(catalog_id)GET /v1/catalogs/{catalog_id}

List return structure (unified): All list commands — list-repositories, list-catalogs, list-assets, list-versions, list-publication-assets, list-tags — return a unified JSON shape with a data array plus a page_info pagination object:

{"page_info": {"total": 3, "limit": 10, "offset": 0}, "data": [{"name": "my-repo", "repository_id": "a1b2c3d4-..."}]}

Always read list results from data (may be empty []) and pagination totals from page_info.total; do not treat the top-level object as a single record.

Asset Management 资产管理

Create asset

cloudrobo asset create-asset --catalog-id <catalog-id> --type <type> [--name <name>] [--sub-type <sub-type>] [--description <desc>] [--status <status>] [--tags "tag1,tag2"] [--url <obs-or-swr-path>] [--ext-metadata '{"key":"value"}'] [--parent-asset-version-id <uuid>] [--generation-method <method>] [--dry-run]
  • SDK: client.create_asset(req: dict)
  • API: POST /v1/assets

Note: --tags is required for algorithm/image types (task scenario tag).

  • algorithm tags: Data Processing, Train
  • image tags: Data Processing, Notebook, Online Deployment, Train
  • When algorithm references an image (engine.asset_id), algorithm tags must be a subset of image tags (SDK validates; raises ValidationError otherwise)
  • --sub-type applies to simulation only; for algorithm/image it is ignored (client drops it before the API call)

List assets

cloudrobo asset list-assets [--repository-id <id>] [--catalog-id <id>] [--type <type>] [--sub-type <sub-type>] [--status <status>] [--name <name>] [--tags "tag1,tag2"] [--mine] [--offset <n>] [--limit <n>]
# Either --repository-id OR --catalog-id filters the list. Full parameter list: see references/api-paths.md → List Assets
  • SDK: client.list_assets(**params)
  • API: GET /v1/assets

Return structure: same unified list shape as Repository & Catalog — top-level data array plus page_info ({"page_info": {"total": N}, "data": [...]}). list-versions and list-publication-assets also follow this structure. Read records from data and totals from page_info.total.

Note: repository-id and catalog-id — at least one must be provided; both provided = AND filter.

Update asset

cloudrobo asset update-asset --asset-id <asset-id> [--name <name>] [--description <desc>] [--status <status>] [--tags "tag1,tag2"] [--ext-metadata '{"key":"value"}'] [--dry-run]
  • SDK: client.update_asset(asset_id, req: dict)
  • API: PUT /v1/assets/{asset_id}

Note: update-asset only supports modifying name/description/status/tags/ ext-metadata — the CLI exposes no parameters for catalog_id, type, sub_type, url, parent_asset_version_id, or generation_method, so these fields are immutable.

CommandKey ParamsSDK MethodAPI
show-asset--asset-id <id>client.show_asset(asset_id)GET /v1/assets/{asset_id}
delete-asset--asset-id <id> [--dry-run]client.delete_asset(asset_id)DELETE /v1/assets/{asset_id}
batch-delete-assets--asset-ids "id1,id2" [--dry-run]client.batch_delete_assets({"asset_ids": [...]})POST /v1/assets/batch-delete

Version Management 版本管理

Create version

cloudrobo asset create-version --asset-id <asset-id> [--version <version>] [--description <desc>] [--status <status>] [--url <obs-or-swr-path>] [--ext-metadata '{"key":"value"}'] [--parent-asset-version-id <uuid>] [--generation-method <method>] [--dry-run]
  • SDK: client.create_asset_version(asset_id, req: dict)
  • API: POST /v1/assets/{asset_id}/versions

List versions

cloudrobo asset list-versions --asset-id <asset-id> [--version <version>] [--exact-version <version>] [--sort-key <field>] [--sort-dir <asc|desc>] [--offset <n>] [--limit <n>] [--actions "FFT,LORA"] [--actions-operator <and|or>] [--ext-metadata <key=value>] [--action-status "ENABLE,DISABLE"]
  • SDK: client.list_asset_versions(asset_id, **params)
  • API: GET /v1/assets/{asset_id}/versions

Update version

cloudrobo asset update-version --asset-id <asset-id> --version-id <version-id> [--version <version>] [--description <desc>] [--status <status>] [--ext-metadata '{"key":"value"}'] [--dry-run]
  • SDK: client.update_asset_version(asset_id, version_id, req: dict)
  • API: PUT /v1/assets/{asset_id}/versions/{version_id}

Note: update-version only supports modifying version/description/status/ ext-metadata — the CLI exposes no parameters for url, parent_asset_version_id, or generation_method, so these fields are immutable.

CommandKey ParamsSDK MethodAPI
show-version--asset-id <id> --version-id <vid>client.show_asset_version(asset_id, version_id)GET /v1/assets/{asset_id}/versions/{version_id}
delete-version--asset-id <id> --version-id <vid> [--dry-run]client.delete_asset_version(asset_id, version_id)DELETE /v1/assets/{asset_id}/versions/{version_id}
batch-delete-versions--asset-id <id> --version-ids "v1,v2" [--dry-run]client.batch_delete_asset_versions(asset_id, {"version_ids": [...]})POST /v1/assets/{asset_id}/versions/batch-delete

Tag Management 标签管理

CommandKey ParamsSDK MethodAPI
add-tags--asset-id <id> --tags "t1,t2" [--dry-run]client.add_tags(asset_id, tags)POST /v1/assets/{asset_id}/tags
delete-tag--asset-id <id> --tag <tag> [--dry-run]client.delete_tag(asset_id, tag)DELETE /v1/assets/{asset_id}/tags/{tag}
list-tags--language <zh|en> [--type] [--sub-type]client.list_all_tags(language, type, sub_type)GET /v1/asset-tags

Action Management Action管理

CommandKey ParamsSDK MethodAPI
list-actions--asset-id <id> --version-id <vid>client.list_asset_actions(asset_id, version_id)GET /v1/assets/{asset_id}/versions/{version_id}/actions
show-action--asset-id <id> --version-id <vid> --action <name>client.show_asset_action(asset_id, version_id, action)GET .../actions/{action}
delete-action--asset-id <id> --version-id <vid> --action <name> [--dry-run]client.delete_asset_action(asset_id, version_id, action)DELETE .../actions/{action}

Create/Update action (detailed):

cloudrobo asset create-action --asset-id <id> --version-id <vid> --action-info '{"action":"FFT","algorithm":{"asset_id":"...","version_id":"..."},"status":"ENABLE"}' [--dry-run]
# SDK: client.create_asset_action(asset_id, version_id, req)
# API: POST /v1/assets/{asset_id}/versions/{version_id}/actions
# action-info supports single action object {"action":"FFT",...} or batch {"actions":[{...},{...}]}

cloudrobo asset update-action --asset-id <id> --version-id <vid> --action <name> --action-info '{"status":"DISABLE"}' [--dry-run]
# SDK: client.update_asset_action(asset_id, version_id, action, req)
# API: PUT /v1/assets/{asset_id}/versions/{version_id}/actions/{action}

Permission & Lineage 权限与血缘

CommandKey ParamsSDK MethodAPI
check-permission--asset-id <id> --version-id <vid> --permissions "meta_read,data_read"client.check_asset_permission(asset_id, version_id, req)POST .../check-permission
show-lineage--asset-id <id> --version-id <vid> --type <children|parent>client.show_asset_tree(asset_id, version_id, type)GET .../tree?type=<children|parent>

Valid permissions: meta_read, meta_write, data_read, data_write, data_usable Lineage: children = parent-to-child; parent = child-to-parent.

Marketplace 广场

CommandKey ParamsSDK MethodAPI
search-assets--keyword <kw> [--type] [--limit] [--offset]client.search_assets(req)POST /v1/asset-service/search
list-publication-assets[--type] [--sub-type] [--name] [--tags] [--status] [--capabilities] [--offset] [--limit]client.list_publication_assets(**params)GET /v1/asset-service/publication-assets

Full parameter list: see references/api-paths.md → List Publication Assets

Import & Export 导入导出

Import asset

cloudrobo asset import-asset --local-path <local-folder> [--catalog-id <id>] [--name <name>] [--type <type>] [--sub-type <sub-type>] [--tags "tag1,tag2"] [--ext-metadata '{"key":"value"}'] [--asset-id <id>] [--version-id <vid>] [--dry-run]

Type constraints:

  • image type NOT supported — CLI raises UsageError; use create-asset
  • algorithm type supported (Mode 1 & Mode 2) — imports local code to {catalog.url}/{asset_id}/{version_id}/, code_dir placeholder {catalog.url}/pending at creation then updated to actual path on both asset-level and version-level; user must NOT provide code_dir/boot_file; Mode 2 gets catalog_id from asset detail (no --catalog-id needed)
  • Mode 3 (--asset-id --version-id) NOT supported for algorithm — raises ValueError

Frontmatter support:

  • Auto-reads local-path/README.md YAML frontmatter
  • Fields: name, type, sub_type, description, status, tags, version, ext_metadata, parent_asset_version_id, generation_method
  • Priority: frontmatter overrides CLI parameters (except catalog_id, CLI only); fields missing from both trigger errors
  • Required fields for new asset: catalog_id (CLI only), name (frontmatter or CLI), type (frontmatter or CLI)
  • Required for new version (--asset-id): ext_metadata (backend requires it for model/dataset/image/simulation; pass via --ext-metadata or frontmatter)
  • ext_metadata pre-validation: model/dataset/algorithm/image/simulation types validated before API call (robot is a sub_type of simulation)

Modes:

  • No --asset-id: Create new asset + version + upload to OBS; after upload, if version status is CREATING, auto-update to DRAFT
  • --asset-id only: Create new version for existing asset + upload to OBS; ext_metadata is required (backend validates for model/dataset/image/simulation; pass via --ext-metadata or frontmatter); after upload, if version status is CREATING, auto-update to DRAFT
  • --asset-id + --version-id: Reuse existing version, upload files directly to OBS (same-name objects are overwritten idempotently); after upload, if version status is CREATING, auto-update to DRAFT; NOT supported for algorithm assets (raises ValueError)

Status flow: When no --status is specified, the backend creates the version with status CREATING. After a successful OBS upload, if the version status is still CREATING, the SDK automatically calls update-version to set it to DRAFT. If the user explicitly specifies a status (e.g., RELEASE via frontmatter), the upload succeeds but the status is not auto-modified.

Export asset

cloudrobo asset check-permission --asset-id <id> --version-id <version-id> --permissions data_read
# verify verdict; only proceed with export when verdict=allow
cloudrobo asset export-asset --asset-id <id> --local-path <local-folder> [--version-id <version-id>] [--dry-run]

Permission pre-check (required): Before exporting an asset the current account may not own (e.g. marketplace/published assets), always run check-permission --asset-id <id> --version-id <vid> --permissions data_read first (--version-id required; resolve via list-versions --asset-id <id> if unknown). If the verdict is deny, do not run export-asset and inform the user: "当前账号无该资产数据读取 权限,仅能导出元数据(README),无法下载数据文件" — otherwise the CLI would return a misleading status:exported result with missing data files (OBS 403).

Type constraints:

  • image type is NOT supported — raises ValueError (SWR reference, no downloadable files); use create-asset instead
  • algorithm type IS supported — downloads code from ext_metadata.code_dir OBS path; if code_dir is missing, raises RuntimeError with recovery guidance

Path requirement: --local-path must be an existing directory (raises FileNotFoundError if not found, ValueError if it's a file). The SDK creates a subdirectory {local-path}/{asset_id}/ inside it for the downloaded files.

README.md generation:

  • Creates <local-path>/<asset-id>/README.md with YAML frontmatter
  • Frontmatter fields: name, type, sub_type, description, status, tags, version, ext_metadata, parent_asset_version_id, generation_method
  • If README.md already exists, preserves body content and replaces frontmatter only
  • Enables seamless re-import with minimal CLI parameters

Parameter Confirmation 参数确认

ParameterRequiredDescriptionExample
--catalog-idConditional (new asset import, most commands)Catalog UUIDb2c3d4e5-f6a7-...
--asset-idYes (asset/version ops)Asset UUIDa1b2c3d4-...
--version-idYes (version ops)Version UUIDd4e5f6a7-b8c9-...
--typeConditional (import without frontmatter)Asset typemodel, dataset, algorithm, image, simulation
--nameConditional (import without frontmatter)Asset namemy-model
--sub-typeConditional (simulation only)Asset sub_type; algorithm/image no longer accept sub_type (client drops it if provided)simulation: robot,environment,object,scene
--local-pathYes (import/export)Local folder path./my-model
--ext-metadataConditional (model/dataset/algorithm/image/simulation)Extended metadata JSON{"model_type":"planning"}
--languageYes (list-tags)Tag languagezh, en
--permissionsYes (check-permission)Permission listmeta_read,data_read
--dry-runNoPreview without executingflag
--descriptionNoAsset/version descriptionMy model description
--statusNoAsset/version statusCREATING, DRAFT, RELEASE, etc.
--tagsConditional (algorithm/image create)Tag list (comma-separated); required for algorithm/image create; algorithm tags must be subset of referenced image tags; full replacement on updateData Processing,Train
--urlNoOBS or SWR path (create-asset/create-version only)obs://bucket/path
--generation-methodNoAsset generation method (create-asset/create-version only)manual
--parent-asset-version-idNoParent version UUID (create-asset/create-version only)d4e5f6a7-...

Mutating operations (create/update/delete/import/export/batch-delete) should be confirmed by the user before execution. --dry-run can be used to preview the operation safely.

Reference Documents 参考文档

Edge Cases 边界情况

Key edge cases include: missing catalog_id, import OBS upload failure recovery, export permission checks, immutable field validation, built-in vs workspace asset distinction, and capabilities filter mapping. See Edge Cases for the full table.

Verification Method 验证方法

# Specification compliance + functional testing (read-only + --dry-run rehearsal; no side effects)
bash scripts/test-cli-commands.sh -s . -e {cli|sdk}
# Key lifecycle real execution (create→update→tag→version→delete; confirms each mutation):
#   RUN_LIFECYCLE=1 REPOSITORY_ID=... CATALOG_ID=... ASSET_ID=... VERSION_ID=... bash scripts/test-cli-commands.sh -s . -e cli

Test cases: see templates/test-vars.json for the full list covering all asset operations.

Verification Checklist 验证清单

  • After create/update/import: verify via show-asset/show-version/list-actions that changes took effect
  • After list/search/check-permission: verify results match filter criteria and verdict contains allow/deny
  • Before delete: confirm with user — deletion is irreversible
  • Before export: run check-permission --asset-id <id> --version-id <vid> --permissions data_read first (version-id required; resolve via list-versions if unknown); deny → inform user, do not export
  • After export: check local directory file structure matches OBS source

Best Practices 最佳实践

  • Use --dry-run with create/update/delete/import/export to validate parameters before execution
  • Before creating assets with ext_metadata, consult references/validation-rules.md for required fields by type
  • Use import-asset (not create-asset) for most scenarios — it handles the full flow (asset + version + OBS upload)
  • For failed imports, reuse the existing version with --asset-id --version-id to avoid accumulating empty versions
  • Query predefined tags via list-tags before adding tags to ensure they are valid
  • Use export-asset followed by import-asset for seamless asset migration — export generates README.md with frontmatter, import auto-reads it to fill metadata
  • For import without frontmatter, provide --ext-metadata for model/dataset/simulation types to pass pre-validation

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-asset">View huawei-cloud-cloudrobo-asset on skillZs</a>