huawei-cloud-cc-instance-query

概览

华为云 Cloud Connect（CC）是一项支持跨区域和跨云网络连接的服务。此技能为七种核心 CC 资源类型提供只读查询能力：

资源类型	描述
Cloud Connection	用于关联跨区域或跨云 VPC 的顶层容器
Bandwidth Package	绑定到云连接的已购买带宽资源
Inter-Region Bandwidth	带宽包中分配给两个特定区域之间的带宽
Network Instance	接入云连接的 VPC 或 VPC 子网
Cloud Connection Route	通过云连接转发流量的路由条目
Authorisation (granted)	此账户授予其他账户的跨账户授权——“我授权其他账户加载了我的哪些网络实例？”
Permission (received)	其他账户授予此账户的跨账户授权——“我可以将哪些外部网络实例加载到我的云连接中？”

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

不在范围内

此技能不涵盖以下 CC 资源类型和操作。如果用户询问这些内容，请明确告知，并建议使用对应的 hcloud CLI 命令。

不在范围内的资源 / 操作	建议的命令
中心网络（Central Network）	hcloud CC ListCentralNetworks / hcloud CC ShowCentralNetwork
全局互联带宽（Global Connection Bandwidth/GCB）	hcloud CC ListGlobalConnectionBandwidths / hcloud CC ShowGlobalConnectionBandwidth
站点网络（Site Network）	hcloud CC ListSiteNetworks / hcloud CC ShowSiteNetwork
标签管理（Tag/Untag/ListTags）	hcloud CC ListTags / hcloud CC ListCloudConnectionTags
所有写操作（Create/Update/Delete/Apply/Associate/Disassociate）	不支持——此技能为只读

前提条件

1. 已安装并完成身份验证的 hcloud CLI。详情请参阅 references/cli-installation-guide.md。
2. 已通过 hcloud configure（交互式，推荐）或环境变量配置 华为云 AK/SK：

   # Recommended: interactive configuration
   hcloud configure
   # Or set env vars: HUAWEI_ACCESS_KEY, HUAWEI_SECRET_KEY, HUAWEI_REGION
   

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

工作流

1. Identify the resource type to query (cloud connection / bandwidth package / inter-region bandwidth / network instance / route / authorisation / permission)
2. Determine whether a single instance or a list is needed
3. For single queries: provide --domain_id and --id
4. For list queries: provide --domain_id, optionally add filters (--limit, --marker, --status, --name, etc.)
5. Execute the hcloud command and review the output
6. **domain_id validation**: If `--domain_id` is not explicitly provided, the CLI will silently use the default domain_id from the auth config (not an error). Always recommend the user specify `--domain_id` explicitly to avoid querying the wrong account.

核心命令

所有命令的格式如下：

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

1. 云连接实例

查询单个云连接：

hcloud CC ShowCloudConnection --cli-region=cn-north-4 --domain_id=<account_id> --id=<cloud_connection_id>

列出云连接：

hcloud CC ListCloudConnections --cli-region=cn-north-4 --domain_id=<account_id> [--limit=10] [--marker=<marker>] [--status.1=ACTIVE] [--name.1=<name>]

参数	必填	描述
--domain_id	是	账户 ID
--id	是（Show）	云连接实例 ID
--limit	否	每页记录数（1–2000）
--marker	否	分页标记（与 limit 一起使用）
--status.[N]	否	按状态筛选（例如 ACTIVE）
--name.[N]	否	按资源名称筛选
--id.[N]	否	按资源 ID 筛选（仅列表查询）
--enterprise_project_id.[N]	否	按企业项目 ID 筛选

2. 带宽包实例

查询单个带宽包：

hcloud CC ShowBandwidthPackage --cli-region=cn-north-4 --domain_id=<account_id> --id=<bandwidth_package_id>

列出带宽包：

hcloud CC ListBandwidthPackages --cli-region=cn-north-4 --domain_id=<account_id> [--limit=10] [--status.1=ACTIVE] [--cloud_connection_id.1=<cc_id>]

参数	必填	描述
--domain_id	是	账户 ID
--id	是（Show）	带宽包实例 ID
--limit	否	每页记录数（1–2000）
--marker	否	分页标记
--status.[N]	否	按状态筛选（例如 ACTIVE）
--cloud_connection_id.[N]	否	按云连接 ID 筛选
--billing_mode.[N]	否	按计费模式筛选

3. 跨区域带宽实例

查询单个跨区域带宽：

hcloud CC ShowInterRegionBandwidth --cli-region=cn-north-4 --domain_id=<account_id> --id=<inter_region_bandwidth_id>

列出跨区域带宽：

hcloud CC ListInterRegionBandwidths --cli-region=cn-north-4 --domain_id=<account_id> [--limit=10] [--cloud_connection_id.1=<cc_id>] [--bandwidth_package_id.1=<bp_id>]

参数	必填	描述
--domain_id	是	账户 ID
--id	是（Show）	跨区域带宽实例 ID
--limit	否	每页记录数（1–2000）
--marker	否	分页标记
--cloud_connection_id.[N]	否	按云连接 ID 筛选
--bandwidth_package_id.[N]	否	按带宽包 ID 筛选

4. 网络实例

查询单个网络实例：

hcloud CC ShowNetworkInstance --cli-region=cn-north-4 --domain_id=<account_id> --id=<network_instance_id>

列出网络实例：

hcloud CC ListNetworkInstances --cli-region=cn-north-4 --domain_id=<account_id> [--limit=10] [--cloud_connection_id.1=<cc_id>] [--region_id.1=<region>] [--status.1=ACTIVE]

参数	必填	描述
--domain_id	是	账户 ID
--id	是（Show）	网络实例 ID
--limit	否	每页记录数（1–2000）
--marker	否	分页标记
--cloud_connection_id.[N]	否	按云连接 ID 筛选
--region_id.[N]	否	按部署区域筛选
--status.[N]	否	按状态筛选（例如，ACTIVE）
--type.[N]	否	按网络实例类型筛选

5. 云连接路由

查询单条路由：

hcloud CC ShowCloudConnectionRoutes --cli-region=cn-north-4 --domain_id=<account_id> --id=<route_id>

列出路由：

hcloud CC ListCloudConnectionRoutes --cli-region=cn-north-4 --domain_id=<account_id> [--limit=10] [--cloud_connection_id.1=<cc_id>] [--instance_id.1=<ni_id>] [--region_id=<region>]

参数	必填	描述
--domain_id	是	账户 ID
--id	是（Show）/ 否（List）	路由实例 ID
--limit	否	每页记录数（1–2000）
--marker	否	分页标记
--cloud_connection_id.[N]	否	按云连接 ID 筛选
--instance_id.[N]	否	按网络实例 ID 筛选
--region_id	否（仅 List）	按区域 ID 筛选

6. 跨账户授权（已授予）

用于回答：“我的哪些网络实例已获我授权，允许其他账户加载到其云连接中？”

这是授权方视图——调用账户拥有这些网络实例，并已授权其他账户（由 cloud_connection_domain_id 标识）加载这些实例。

列出授权：

hcloud CC ListAuthorisations --cli-region=cn-north-4 --domain_id=<account_id> [--limit=10] [--cloud_connection_id.1=<cc_id>] [--instance_id.1=<ni_id>] [--id.1=<auth_id>] [--name.1=<name>] [--description.1=<desc>]

参数	必填	描述
--domain_id	是	账户 ID（授权方，即你的账户）
--limit	否	每页记录数（1–2000）
--marker	否	分页标记
--cloud_connection_id.[N]	否	按云连接 ID 筛选
--instance_id.[N]	否	按网络实例 ID 筛选
--id.[N]	否	按授权 ID 筛选
--name.[N]	否	按授权名称筛选
--description.[N]	否	按描述筛选

关键响应字段：

字段	含义
id	授权记录 ID
domain_id	授权方的域 ID（你的账户）
instance_id	被授权的网络实例
instance_type	网络实例类型（例如，vpc）
cloud_connection_id	将加载该实例的云连接
cloud_connection_domain_id	被授权方的域 ID（另一账户）
is_loaded_by_cloud_connection	被授权方是否已将该实例加载到云连接中
status	授权状态（例如，authorized）

7. 跨账号权限（接收）

用于回答：“其他账号授权我将哪些外部网络实例加载到我的云连接中？”

这是被授权方视角——调用账号拥有云连接，并可加载其他账号拥有的网络实例（由 instance_domain_id 标识）。

列出权限：

hcloud CC ListPermissions --cli-region=cn-north-4 --domain_id=<account_id> [--limit=10] [--cloud_connection_id.1=<cc_id>] [--instance_id.1=<ni_id>] [--id.1=<perm_id>] [--name.1=<name>] [--description.1=<desc>]

参数	必填	描述
--domain_id	是	账号 ID（被授权方，即你的账号）
--limit	否	每页记录数（1–2000）
--marker	否	分页标记
--cloud_connection_id.[N]	否	按云连接 ID 筛选
--instance_id.[N]	否	按网络实例 ID 筛选
--id.[N]	否	按权限 ID 筛选
--name.[N]	否	按权限名称筛选
--description.[N]	否	按描述筛选

关键响应字段：

字段	含义
id	权限记录 ID
domain_id	被授权方的域 ID（你的账号）
instance_id	授权给你的外部网络实例
instance_type	网络实例类型（例如，vpc）
instance_domain_id	授权方的域 ID（拥有该实例的另一个账号）
cloud_connection_id	可加载该实例的你的云连接
status	权限状态（例如，authorized）

参数确认

参数	必填	描述	示例
--cli-region	是	华为云区域	cn-north-4
--domain_id	是	账号 ID（可在 IAM → 我的凭证中查看）	0a12345678...
--id	是（Show 操作）	资源实例 ID（32–36 个字符的 UUID）	a1b2c3d4-e5f6-7890-abcd-ef1234567890
--limit	否	页大小（1–2000）	10
--marker	否	分页令牌	<上一页中的 marker>

参考文档

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

KooCLI 命令格式标准

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

特性	描述	示例
服务名称	CC（Cloud Connect）	CC
操作名称	PascalCase	ShowCloudConnection、ListCloudConnections
区域参数	--cli-region=<value>	--cli-region=cn-north-4
简单参数	--key=value	--id=xxx
带索引的数组参数	--key.1=value1	--status.1=ACTIVE