360 Secure SkillHub
360 安全技能中心

huawei-cloud-cdm-query

基于华为云 KooCLI，以只读方式查询 CDM 资源，支持集群列表与详情、任务列表及任务执行历史，结果以 JSON 输出；AK/SK 通过环境变量注入，脚本按参数、认证、API、CLI 错误返回不同退出码。SKILL.md 引用的 references 文档和 scripts 路径在包内缺失。

yangaiwu
yangaiwu
热度 7.65
最近更新 2026-09-01 23:54:14
分类：数据依赖：代码执行 / 第三方 API应用场景：API 集成 / 数据处理 / DevOps / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add huawei-cloud-cdm-query
Metadata
name
huawei-cloud-cdm-query
version
0.1.0
description
查询华为云CDM（Cloud Data Migration）资源详情，包括集群列表、集群详情、任务列表和任务执行历史
triggers
["查询华为云CDM","CDM集群查询","CDM任务查询","数据迁移查询"]
tags
["huawei-cloud","cdm","query","data-migration"]

华为云 CDM 资源查询 Skill

安全硬约束

  1. 认证信息（AK/SK）必须通过环境变量注入，禁止在代码或命令行参数中硬编码。
  2. 支持的 environment variable 前缀包括 HUAWEI_、HW_、HWC_，脚本会自动扫描。
  3. 所有 API 请求均通过 HTTPS 加密传输。
  4. 脚本仅执行 CDM 资源的只读查询操作，不涉及任何创建、修改或删除操作。
  5. 所有 CLI 调用设置 timeout=30 秒，超时或 403/429 错误会给出明确提示。
  6. 错误信息中可能包含 API 请求 ID，但不包含敏感的认证凭据。

Overview

本 Skill 基于华为云 KooCLI（hcloud）实现对 CDM（Cloud Data Migration）服务的只读查询能力。支持查询集群列表、集群详情、任务列表以及任务执行历史。

该 Skill 适用于以下场景：

  • 日常巡检中快速查看 CDM 集群状态
  • 排查数据迁移任务执行情况
  • 自动化脚本中集成 CDM 信息查询

Prerequisites

环境要求

  • Python 3.7+
  • 华为云 KooCLI 已安装并配置（参考 references/cli-installation-guide.md）
  • 华为云账号已开通 CDM 服务
  • 已获取华为云 AK/SK 访问密钥

环境变量

变量名 说明 是否必填
HUAWEI_ACCESS_KEY 访问密钥 ID (AK) 是
HUAWEI_SECRET_KEY 秘密访问密钥 (SK) 是
HUAWEI_CLOUD_REGION 区域代码（默认: cn-north-4） 否

也支持 HW_ / HWC_ 前缀的等价变量名，以及 _AK / _SK / _REGION 后缀。

Workflow

CDM 查询的工作流程如下：

sequenceDiagram
    participant User as 用户
    participant Script as 查询脚本
    participant CLI as KooCLI
    participant API as CDM API
    participant CDM as 华为云 CDM

    User->>Script: 执行查询命令
    Script->>CLI: 调用 hcloud CDM <Operation>
    CLI->>API: HTTPS GET 请求
    API->>CDM: 查询资源
    CDM-->>API: 返回资源数据
    API-->>CLI: JSON 响应
    CLI-->>Script: stdout JSON
    Script-->>User: 格式化 JSON 输出

Core Commands

列出所有能力

python scripts/hcs-cdm-query.py --project-id <PROJECT_ID> capability-list

查询集群列表

python scripts/hcs-cdm-query.py --project-id <PROJECT_ID> list-clusters

可选参数：

  • --region：区域代码（默认: cn-north-4）

查询集群详情

python scripts/hcs-cdm-query.py --project-id <PROJECT_ID> show-cluster <cluster_id>

查询任务列表

python scripts/hcs-cdm-query.py --project-id <PROJECT_ID> list-jobs <cluster_id>

可选参数：

  • --job-name：任务名称（默认: all 查询全部）
  • --filter：任务名称模糊过滤
  • --job-type：任务类型过滤（NORMAL_JOB / BATCH_JOB / SCENARIO_JOB）
  • --page-no：页码
  • --page-size：每页数量（10-100）

查询任务执行历史

python scripts/hcs-cdm-query.py --project-id <PROJECT_ID> show-submissions <cluster_id> <job_name>

退出码

退出码 含义
0 执行成功
2 参数错误
3 认证错误
4 API 错误
5 CLI 错误

KooCLI Command Format Standard

本 Skill 使用 KooCLI 模式调用 CDM API，格式如下：

hcloud CDM <Operation> --cli-region={region} --project_id={project_id} [--param=value]

支持的操作对应关系：

子命令 CLI Operation HTTP Method API Path
list-clusters ListClusters GET /v1.1/{project_id}/clusters
show-cluster ShowClusterDetail GET /v1.1/{project_id}/clusters/{cluster_id}
list-jobs ShowJobs GET /v1.1/{project_id}/clusters/{cluster_id}/cdm/job/{job_name}
show-submissions ShowSubmissions GET /v1.1/{project_id}/clusters/{cluster_id}/cdm/submissions

Parameter Confirmation

参数 来源 获取方式
AK/SK 环境变量 自动检测
Region 环境变量/命令行参数 自动检测/用户指定
Project ID 命令行参数 用户输入（必填）
Cluster ID 命令行参数 用户输入
Job Name 命令行参数 用户输入

在执行查询之前，脚本会自动检测环境变量中的认证信息。如果 AK/SK 缺失，脚本将以退出码 3 终止并提示错误信息。

Reference Documents