Huawei Cloud CCI Query（华为云云容器实例查询）

安全硬约束

1. AK/SK 只从环境变量动态读取，严禁写入文件/日志/评论。
2. 所有 hcloud 调用设 30s 超时（timeout 30），超时判定失败，不 hang。
3. API 返回 403（无 agency/权限）时：停止该区域查询，提示用户在 CCI 控制台完成服务授权委托，严禁绕行。
4. 仅执行只读查询（list/read/get），严禁执行 create/delete/update/patch/replace 等变更操作。
5. 凭据环境变量缺失 → 脚本退出码 3，不降级、不模拟。
6. region 参数由用户指定，脚本不做硬编码默认区域假设。

Overview / 概述

华为云 CCI（Cloud Container Instances，云容器实例）是基于 Kubernetes 的无服务器容器服务。CCI 的 API 遵循 Kubernetes 风格，资源以 命名空间（Namespace）+ 资源名 组织，而非传统云服务的"实例 ID"模型。

⚠️ 重要说明：CCI 服务在 KooCLI（hcloud）中 没有 ListInstances / ShowInstance 这类命令。Issue/Spec 中提到的这两个命令名并不存在于 hcloud CCI。CCI 的"实例"在 Kubernetes 语义下对应 Pod，查询 Pod 列表用 listCoreV1NamespacedPod，查询 Pod 详情用 readCoreV1NamespacedPod。本 Skill 覆盖以下真实只读查询命令。

架构

用户 / Agent
    │  执行 scripts/cci_query.py <subcommand> [--params]
    ▼
scripts/cci_query.py
    │  动态读取 AK/SK 环境变量 → 配置 hcloud profile
    │  调用 hcloud CCI <Operation> --cli-region=<region> --cli-profile=default [--params]
    ▼
KooCLI (hcloud)
    │  HTTPS → CCI OpenAPI (Kubernetes 风格)
    ▼
华为云 CCI 服务
    │  返回 JSON (NamespaceList / Pod / PodList ...)
    ▼
脚本格式化输出（JSON / 表格）→ 用户

适用场景

Prerequisites / 前置条件

凭据环境变量

脚本动态扫描以下前缀的环境变量获取 AK/SK（不依赖固定变量名）：

• 前缀 HUAWEI / HW / HWC，且包含 ACCESS_KEY / _AK / AK → 作为 AK
• 前缀 HUAWEI / HW / HWC，且包含 SECRET_KEY / _SK / SK → 作为 SK

例如 HUAWEICLOUD_SDK_AK / HUAWEICLOUD_SDK_SK 即可被识别。

Workflow / 工作流

1. 确认前置：hcloud --version 可用；AK/SK 环境变量已设置且非空。
2. 配置认证：脚本首次运行时自动 hcloud configure set 写入 default profile（AK/SK 从环境变量读取）。
3. 指定区域：所有查询必须传 --cli-region=<region>（如 cn-north-4、cn-east-3）。
4. 执行查询：按场景选择子命令，脚本调用对应 hcloud CCI <Operation>。
5. 解析输出：脚本输出 JSON，便于 Agent 后续处理；--pretty 可输出格式化表格。
6. 处理空结果/403：空 items 表示该区域无资源；403 提示前往 CCI 控制台完成服务授权委托。

Core Commands / 核心命令

所有命令通过 scripts/cci_query.py 子命令封装。也可直接使用 hcloud CCI <Operation> 原生命令。

1. 命名空间查询

# 列出所有命名空间（指定区域）
python3 scripts/cci_query.py list-namespaces --region=cn-north-4

# 原生 hcloud 等价命令
hcloud CCI listNamespaces --cli-region=cn-north-4 --cli-profile=default

2. Pod 查询（CCI "实例"）

# 列出指定命名空间下的 Pod（CCI 容器实例列表）
python3 scripts/cci_query.py list-pods --region=cn-north-4 --namespace=<ns>

# 查询指定 Pod 详情（CCI 实例详情）
python3 scripts/cci_query.py show-pod --region=cn-north-4 --namespace=<ns> --name=<pod-name>

# 跨所有命名空间列出 Pod
python3 scripts/cci_query.py list-all-pods --region=cn-north-4

原生 hcloud 等价命令：

hcloud CCI listCoreV1NamespacedPod --cli-region=cn-north-4 --cli-profile=default --namespace=<ns>
hcloud CCI readCoreV1NamespacedPod --cli-region=cn-north-4 --cli-profile=default --namespace=<ns> --name=<pod-name>
hcloud CCI listCoreV1PodForAllNamespaces --cli-region=cn-north-4 --cli-profile=default

3. 工作负载查询

# Deployment 列表 / 详情
python3 scripts/cci_query.py list-deployments --region=cn-north-4 --namespace=<ns>
python3 scripts/cci_query.py show-deployment --region=cn-north-4 --namespace=<ns> --name=<name>

# StatefulSet 列表 / 详情
python3 scripts/cci_query.py list-statefulsets --region=cn-north-4 --namespace=<ns>
python3 scripts/cci_query.py show-statefulset --region=cn-north-4 --namespace=<ns> --name=<name>

# Job 列表 / 详情
python3 scripts/cci_query.py list-jobs --region=cn-north-4 --namespace=<ns>
python3 scripts/cci_query.py show-job --region=cn-north-4 --namespace=<ns> --name=<name>

4. 服务与网络查询

# Service 列表 / 详情
python3 scripts/cci_query.py list-services --region=cn-north-4 --namespace=<ns>
python3 scripts/cci_query.py show-service --region=cn-north-4 --namespace=<ns> --name=<name>

# Network（CCI 专属网络）列表 / 详情
python3 scripts/cci_query.py list-networks --region=cn-north-4 --namespace=<ns>
python3 scripts/cci_query.py show-network --region=cn-north-4 --namespace=<ns> --name=<name>

5. 其他资源

# ConfigMap / Secret / PVC / Event
python3 scripts/cci_query.py list-configmaps --region=cn-north-4 --namespace=<ns>
python3 scripts/cci_query.py list-secrets --region=cn-north-4 --namespace=<ns>
python3 scripts/cci_query.py list-pvcs --region=cn-north-4 --namespace=<ns>
python3 scripts/cci_query.py list-events --region=cn-north-4 --namespace=<ns>

6. 能力与特性查询

# 查看脚本支持的所有子命令
python3 scripts/cci_query.py --help

# 查看脚本能力清单
python3 scripts/cci_query.py capability-list

Parameter Confirmation / 参数确认

KooCLI Command Format Standard

CCI 服务的 hcloud 命令遵循以下格式：

hcloud CCI <Operation> --cli-region=<region> --cli-profile=<profile> [--path-params] [--query-params]

命名规则

• Service：CCI（固定，全大写）
• Operation：Kubernetes 风格命名
  • list* → 列表查询（GET，返回 List 资源）
  • read* → 详情查询（GET，返回单个资源）
  • get* → 元数据/版本查询（GET，返回 API group/version）
• 路径参数（path）：--namespace、--name
• 查询参数（query）：--label-selector、--field-selector、--limit、--continue、--watch

只读操作白名单（本 Skill 覆盖）

验证命令可用性

# 列出 CCI 全部可用操作
hcloud CCI --help

# 验证某个操作存在及其参数
hcloud CCI listCoreV1NamespacedPod --help

Reference Documents / 参考文档

• CCI hcloud 命令参考 — 全部只读查询命令的参数与输出说明
• IAM 权限策略 — 最小权限 CCI:ReadOnlyAccess
• hcloud CLI 安装认证指南 — KooCLI 安装与 AK/SK 配置
• 验证方法 — 如何确认 Skill 输出正确
• 数据流图 — 请求/响应流程（Mermaid）
• 验收标准 — Skill 合格条件

常见问题