huawei-cloud-cc-central-network-query

华为云 CC 中心网络查询

概述

此技能使用 hcloud CLI 查询华为云云连接（CC）的中心网络资源。中心网络是云连接中的核心概念，可在不同区域和云之间构建全球化的集中式网络架构。

**范围：**仅查询，不执行创建、更新或删除操作。

涵盖的资源：

资源	列表	查看
中心网络实例	✅ ListCentralNetworks	✅ ShowCentralNetwork
中心网络附件	✅ ListCentralNetworkAttachments	✅ ShowCentralNetworkErRouteTableAttachment / ShowCentralNetworkGdgwAttachment
中心网络连接	✅ ListCentralNetworkConnections	✅ 通过 ListCentralNetworkConnections --id.1 筛选

**附件说明：**中心网络附件分为两种类型——ER 路由表和 GDGW。没有通用的“查看附件”命令；必须根据附件类型使用对应的专用命令。

**连接查看说明：**没有专用的 ShowCentralNetworkConnection API。若要查询单个连接，请使用带 --id.1 筛选条件的 ListCentralNetworkConnections，或读取 ShowCentralNetwork 响应中嵌入的 connections 数组。

范围之外（不覆盖的能力）：

此技能不涵盖以下中心网络功能。如果用户请求其中任何功能，请明确告知用户此技能不支持该功能。

功能	原因	建议操作
策略管理 — 创建／应用／删除／列出策略、查询变更集	写入操作＋不在范围内	直接使用 hcloud CLI 或管理技能
配额查询 — ListCentralNetworkQuotas	不在范围内	直接使用 hcloud CC ListCentralNetworkQuotas
能力列表查询 — ListCentralNetworkCapabilities	不在范围内	直接使用 hcloud CC ListCentralNetworkCapabilities
创建／更新／删除中心网络或附件	写入操作	直接使用 hcloud CLI 或管理技能
更新中心网络连接	写入操作	直接使用 hcloud CLI 或管理技能
标签管理	不在范围内	直接使用 hcloud CLI

如果用户请求策略查询／策略管理／配额查询／能力查询／标签管理，请告知用户此技能不涵盖这些功能，并建议直接使用 hcloud CLI。

先决条件

1. 已安装并完成身份验证的 hcloud CLI。请参阅 references/cli-installation-guide.md。
2. IAM 权限：cc:centralNetworks:list 和 cc:centralNetworks:get。请参阅 references/iam-policies.md。
3. **区域：**中心网络是全球服务，请使用 CC 可用的任一区域（例如 cn-north-4）。
4. **域 ID：**大多数命令都需要 --domain_id（账号 ID）。可从 IAM → 我的凭证中获取。

工作流

1. Identify the target central network (List → pick by name/id)
2. Query details as needed:
   ├── Instance details → ShowCentralNetwork
   ├── Attachments → ListCentralNetworkAttachments → Show by type
   └── Connections → ListCentralNetworkConnections → filter by id for single

核心命令

1. 列出中心网络实例

hcloud CC ListCentralNetworks --cli-region={region} --domain_id={domain_id} [optional filters]

格式说明模板，不可直接执行 — 将 {region}、{domain_id} 等占位符替换为实际值后执行。

关键参数：

参数	必填	说明
--cli-region	是	区域，例如 cn-north-4
--domain_id	是	账号 ID
--id.1	否	按实例 ID 筛选（支持多个：--id.1=xxx --id.2=yyy）
--name.1	否	按名称筛选
--limit	否	分页大小（1–2000）
--marker	否	分页标记
--sort_key	否	排序字段
--sort_dir	否	排序方向（asc／desc）
--enterprise_project_id.1	否	按企业项目 ID 筛选

示例：

hcloud CC ListCentralNetworks --cli-region=cn-north-4 --domain_id=xxx --limit=10

2. 显示云脊网实例

hcloud CC ShowCentralNetwork --cli-region={region} --domain_id={domain_id} --central_network_id={central_network_id}

格式说明模板，不可直接执行 — 将 {region}、{domain_id}、{central_network_id} 等占位符替换为实际值后执行。

关键参数：

参数	必填	说明
--cli-region	是	区域
--domain_id	是	账户 ID
--central_network_id	是	云脊网 ID

示例：

hcloud CC ShowCentralNetwork --cli-region=cn-north-4 --domain_id=xxx --central_network_id=cn-xxx

响应中包含一个嵌入的 connections 数组，其中包含 CentralNetworkConnectionInfo 对象 — 无需单独调用，即可查看所有连接。

3. 列出云脊网挂载

hcloud CC ListCentralNetworkAttachments --cli-region={region} --domain_id={domain_id} --central_network_id={central_network_id} [optional filters]

格式说明模板，不可直接执行 — 将 {region}、{domain_id}、{central_network_id} 等占位符替换为实际值后执行。

关键参数：

参数	必填	说明
--cli-region	是	区域
--domain_id	是	账户 ID
--central_network_id	是	云脊网 ID
--attachment_instance_type.1	否	按类型筛选：GDGW 或 ER_ROUTE_TABLE
--id.1	否	按挂载 ID 筛选
--name.1	否	按名称筛选
--state.1	否	按状态筛选（AVAILABLE、CREATING、FAILED 等）
--limit	否	分页大小（1–2000）
--marker	否	分页标记

示例：

hcloud CC ListCentralNetworkAttachments --cli-region=cn-north-4 --domain_id=xxx --central_network_id=cn-xxx --limit=10

4. 显示云脊网挂载（按类型）

没有通用的显示挂载命令。请根据挂载类型使用对应的专用命令。

4a. 显示 ER 路由表挂载

hcloud CC ShowCentralNetworkErRouteTableAttachment --cli-region={region} --domain_id={domain_id} --central_network_id={central_network_id} --er_route_table_attachment_id={attachment_id}

4b. 显示 GDGW 挂载

hcloud CC ShowCentralNetworkGdgwAttachment --cli-region={region} --domain_id={domain_id} --central_network_id={central_network_id} --gdgw_attachment_id={attachment_id}

格式说明模板，不可直接执行 — 将 {region}、{domain_id}、{central_network_id}、{attachment_id} 等占位符替换为实际值后执行。

如何确定挂载类型： 首先运行 ListCentralNetworkAttachments — 响应中的每个条目都包含 attachment_instance_type（GDGW 或 ER_ROUTE_TABLE）以及对应的挂载 ID。

5. 列出云脊网连接

hcloud CC ListCentralNetworkConnections --cli-region={region} --domain_id={domain_id} --central_network_id={central_network_id} [optional filters]

格式说明模板，不可直接执行 — 将 {region}、{domain_id}、{central_network_id} 等占位符替换为实际值后执行。

关键参数：

参数	必填	说明
--cli-region	是	区域
--domain_id	是	账户 ID
--central_network_id	是	云脊网 ID
--id.1	否	按连接 ID 筛选（用于“显示单个连接”）
--name.1	否	按名称筛选
--state.1	否	按状态筛选
--is_cross_region	否	筛选跨区域连接（布尔值）
--bandwidth_type	否	按带宽类型筛选：BandwidthPackage 或 TestBandwidth
--connection_type	否	按连接类型筛选
--limit	否	分页大小（1–2000）
--marker	否	分页标记

示例：

hcloud CC ListCentralNetworkConnections --cli-region=cn-north-4 --domain_id=xxx --central_network_id=cn-xxx --limit=10

6. 显示单个云脊网连接

没有专用的 ShowCentralNetworkConnection API。请使用带 ID 筛选条件的列表命令：

hcloud CC ListCentralNetworkConnections --cli-region={region} --domain_id={domain_id} --central_network_id={central_network_id} --id.1={connection_id}

格式说明模板，不可直接执行 — 将 {region}、{domain_id}、{central_network_id}、{connection_id} 等占位符替换为实际值后执行。

替代方法： ShowCentralNetwork 响应中嵌入了一个包含 CentralNetworkConnectionInfo 对象的 connections 数组 — 无需单独调用，即可在其中找到目标连接。

参数确认

参数	必填	说明	示例
{region}	是	华为云区域	cn-north-4
{domain_id}	是	账户 ID（IAM → 我的凭证）	xxx
{central_network_id}	是（用于显示/列出挂载和连接）	云脊网实例 ID	cn-xxx
{attachment_id}	是（用于显示挂载）	挂载 ID（因类型而异）	xxx
{connection_id}	是（用于显示单个连接）	连接 ID	xxx

参考文档

• CLI 安装指南
• IAM 策略
• 验证方法
• 数据流图
• 验收标准
• API 参考

KooCLI 命令格式标准

格式说明模板，不可直接执行：以下为命令格式说明，<...>、[...] 为占位符，需替换为实际值后才能在终端执行。

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

功能	说明	示例
服务名称	CC（Cloud Connect）	CC
操作名称	PascalCase	ListCentralNetworks、ShowCentralNetwork
区域参数	--cli-region=<value>	--cli-region=cn-north-4
简单参数	--key=value	--central_network_id=cn-xxx
索引参数	--key.1=value1	--id.1=cn-xxx