huawei-cloud-cc-gcb-query

概述

Huawei Cloud Cloud Connect（CC）提供全球连接带宽（GCB）——一种带宽资源，可绑定到各种服务实例（云连接、中心网络、分支网络、全球 EIP），以实现跨区域或跨云连接。

此技能为 4 项与 GCB 相关的操作提供只读查询能力：

操作	描述
显示 GCB	按 ID 查询单个 GCB — 响应包含绑定的实例信息
列出 GCB	分页列表，支持丰富的筛选条件（状态、计费模式、绑定服务、实例、类型、名称、企业项目）
GCB 租户配置	查询租户级配置：规格范围、配额、支持的计费模式、支持的服务、绑定限制、SLA 级别
支持绑定的 GCB	列出可绑定到特定服务类型（CC / GEIP / GCN / GSN）的 GCB，并按本地区域/远程区域筛选

所有操作均为只读查询（GET）。不会执行任何创建、更新或删除操作。

不在范围内

本 skill 不覆盖以下 GCB 查询能力：

未覆盖能力	对应 API / CLI 命令	说明
标签管理	ListGcbResourceTags, ListGcbTenantTags, BatchCreateGcbResourceTags 等	请使用 hcloud CC ListGcbResourceTags 等
线路级别	ListGlobalConnectionBandwidthLineLevels	请使用 hcloud CC ListGlobalConnectionBandwidthLineLevels
站点	ListGlobalConnectionBandwidthSites	请使用 hcloud CC ListGlobalConnectionBandwidthSites
规格代码	ListGlobalConnectionBandwidthSpecCodes	请使用 hcloud CC ListGlobalConnectionBandwidthSpecCodes
所有写操作	Create/Delete/Update/Associate/Disassociate 等	本 skill 仅提供查询（GET）能力

前提条件

1. 已安装并完成身份验证的 hcloud CLI。详情请参阅 references/cli-installation-guide.md。
2. 已通过环境变量或 CLI 配置文件配置 Huawei Cloud AK/SK：

   # Set AK/SK via secure prompt — never hardcode secrets in scripts
   read -rsp "Access Key ID: "     HUAWEI_ACCESS_KEY; echo
   read -rsp "Secret Access Key: " HUAWEI_SECRET_KEY; echo
   export HUAWEI_ACCESS_KEY HUAWEI_SECRET_KEY
   export HUAWEI_REGION="cn-north-4"
   

3. IAM 权限 — 调用方需要 CC ReadOnlyAccess 或同等权限。最小权限策略请参阅 references/iam-policies.md。
4. 域 ID — 所有 CC GCB API 都需要 --domain_id（账号 ID）。请从控制台获取：IAM → 我的凭证 → 账号 ID。

工作流

1. Identify the query type (single GCB / list / tenant configs / support binding)
2. Obtain the domain_id (account ID from IAM → My Credentials)
3. For single query: provide --domain_id and --id (GCB instance ID)
4. For list query: provide --domain_id, optionally add filters
5. For tenant configs: provide --domain_id only
6. For support binding: provide --domain_id and --binding_service (required)
7. Execute the hcloud command and review the output

核心命令

所有命令均采用以下格式：

hcloud CC <Operation> --cli-region=<region> --domain_id=<account_id> [additional params]

1. 查询单个全球连接带宽

按 ID 查询 GCB 详情。响应包含 GCB 的配置和绑定的实例信息（绑定到此 GCB 的云连接、中心网络或其他服务实例）。

hcloud CC ShowGlobalConnectionBandwidth --cli-region=cn-north-4 --domain_id=<account_id> --id=<gcb_id>

参数	必填	描述
--domain_id	是	账号 ID
--id	是	GCB 实例 ID（32–36 个字符）

关键响应字段：

字段	含义
id	GCB 实例 ID
name	GCB 名称
size	带宽大小（Mbit/s）
type	带宽类型：TrsArea（跨区）、Area（大区）、SubArea（区域）、Region（城域）
charge_mode	计费模式：bwd（按带宽）、95（传统 95）、95avr（日 95）
admin_state	状态：NORMAL 或 FREEZED
binding_service	绑定的服务类型：CC、GEIP、GCN、GSN
instances	绑定的实例列表（云连接、中心网络等）
local_area	本地接入点
remote_area	远程接入点
enterprise_project_id	企业项目 ID

2. 列出全局连接带宽

支持分页，并提供丰富的筛选选项。

hcloud CC ListGlobalConnectionBandwidths --cli-region=cn-north-4 --domain_id=<account_id> \
  [--limit=10] [--marker=<marker>] \
  [--admin_state.1=NORMAL] \
  [--binding_service.1=CC] \
  [--charge_mode.1=bwd] \
  [--id.1=<gcb_id>] \
  [--instance_id.1=<instance_id>] \
  [--instance_type.1=CC] \
  [--name.1=<name>] \
  [--type.1=TrsArea] \
  [--enterprise_project_id.1=<ep_id>]

参数	必填	描述
--domain_id	是	账户 ID
--limit	否	每页记录数（1–2000）
--marker	否	分页标记（与 limit 配合使用）
--admin_state.[N]	否	按状态筛选：NORMAL 或 FREEZED
--binding_service.[N]	否	按绑定的服务类型筛选：CC、GEIP、GCN、GSN
--charge_mode.[N]	否	按计费模式筛选：bwd、95、95avr
--id.[N]	否	按 GCB ID 筛选（支持多个）
--instance_id.[N]	否	按绑定的实例 ID 筛选
--instance_type.[N]	否	按绑定的实例类型筛选：CC、GEIP、GCN、GSN
--name.[N]	否	按名称筛选（支持多个）
--type.[N]	否	按带宽类型筛选：TrsArea、Area、SubArea、Region
--enterprise_project_id.[N]	否	按企业项目 ID 筛选

3. 查询 GCB 租户配置

查询 GCB 租户级配置，包括各计费模式的容量范围、配额、支持的服务、支持的带宽类型、绑定限制、SLA 级别等。

hcloud CC ListGlobalConnectionBandwidthConfigs --cli-region=cn-north-4 --domain_id=<account_id>

参数	必填	描述
--domain_id	是	账户 ID

主要响应字段：

字段	含义
gcbSizeRange / size_range	各计费模式（trf、bwd、95p、95、95avr）对应的带宽容量范围
quotas	配额：gcb.size（带宽总配额）和 gcb.count（GCB 数量配额）
charge_mode / chargeMode	支持的计费模式
services / serviceList	支持绑定的服务类型
gcb_type / gcbType	支持的 GCB 类型：Area、TrsArea、Region、SubArea
bind_limit	单个 GCB 可绑定的最大实例数
sla_level	SLA 级别：Pt、Au、Ag
relation	各 GCB 类型支持的服务类型
crossborder	是否启用了跨境带宽
ces_enabled	是否启用了 CES 监控

4. 列出符合绑定条件的 GCB

列出符合特定服务类型绑定条件的 GCB。需要查找可用于绑定到新的云连接、中心网络或其他服务实例的 GCB 时，此操作很有用。

hcloud CC ListSupportBindingConnectionBandwidths --cli-region=cn-north-4 --domain_id=<account_id> \
  --binding_service=<CC|GEIP|GCN|GSN> \
  [--limit=10] [--marker=<marker>] \
  [--local_area=<local_area>] \
  [--remote_area=<remote_area>] \
  [--enterprise_project_id.1=<ep_id>]

参数	必填	描述
--domain_id	是	账户 ID
--binding_service	是	目标服务类型：CC（云连接）、GEIP（全局 EIP）、GCN（中心网络）、GSN（分支网络）
--limit	否	每页记录数（1–2000）
--marker	否	分页标记
--local_area	否	本地接入点（与 remote_area 配合使用；两者必须同时提供或同时省略）
--remote_area	否	远端接入点（与 local_area 配合使用）
--enterprise_project_id.[N]	否	按企业项目 ID 筛选

参数确认

参数	必填	描述	示例
--cli-region	是	华为云区域	cn-north-4
--domain_id	是	账户 ID（来自 IAM → 我的凭证）	0a12345678...
--id	是（展示）	GCB 实例 ID（32–36 个字符的 UUID）	a1b2c3d4-e5f6-7890-abcd-ef1234567890
--binding_service	是（支持绑定）	目标服务类型	CC
--limit	否	每页条数（1–2000）	10
--marker	否	分页令牌	<上一页的 marker>

参考文档

• CLI 安装指南 — hcloud CLI 设置与身份验证
• IAM 策略 — 用于 CC GCB 查询操作的最小权限策略
• 验证方法 — 如何验证查询结果
• 数据流图 — 技能数据流的 Mermaid 图
• 验收标准 — 各查询类型的成功标准
• API 参考 — 已验证的 REST API 端点

KooCLI 命令格式规范

hcloud <Service> <Operation> --cli-region=<region> [--key=value ...]

特性	说明	示例
服务名称	CC（Cloud Connect）	CC
操作名称	PascalCase	ShowGlobalConnectionBandwidth、ListGlobalConnectionBandwidths
区域参数	--cli-region=<value>	--cli-region=cn-north-4
简单参数	--key=value	--id=xxx
带索引的数组参数	--key.1=value1	--admin_state.1=NORMAL