원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Huawei Cloud CC Central Network Query
Overview
This skill queries Huawei Cloud Cloud Connect (CC) Central Network resources using the hcloud CLI. Central Network is a core concept in Cloud Connect that enables global, centralized network architecture across regions and clouds.
Scope: Query only — no create, update, or delete operations.
Resources covered:
| Resource | List | Show |
|---|---|---|
| Central Network Instance | ✅ ListCentralNetworks | ✅ ShowCentralNetwork |
| Central Network Attachment | ✅ ListCentralNetworkAttachments | ✅ ShowCentralNetworkErRouteTableAttachment / ShowCentralNetworkGdgwAttachment |
| Central Network Connection | ✅ ListCentralNetworkConnections | ✅ Via ListCentralNetworkConnections --id.1 filter |
Note on attachments: Central network attachments come in two types — ER Route Table and GDGW. There is no generic "show attachment" command; you must use the type-specific command based on the attachment type.
Note on connection show: There is no dedicatedShowCentralNetworkConnectionAPI. To query a single connection, useListCentralNetworkConnectionswith the--id.1filter, or read theconnectionsarray embedded in theShowCentralNetworkresponse.
Out of Scope (不覆盖的能力):
The following Central Network capabilities are not covered by this skill. If the user requests any of these, inform them clearly that the skill does not support it.
| Capability | Reason | Suggested Action |
|---|---|---|
| Policy management (策略管理) — create / apply / delete / list policies, query change set | Write operations + not in scope | Use hcloud CLI directly or a management skill |
Quota query (配额查询) — ListCentralNetworkQuotas | Not in scope | Use hcloud CC ListCentralNetworkQuotas directly |
Capability list query (能力查询) — ListCentralNetworkCapabilities | Not in scope | Use hcloud CC ListCentralNetworkCapabilities directly |
| Create / Update / Delete central network or attachments | Write operations | Use hcloud CLI directly or a management skill |
| Update central network connections | Write operation | Use hcloud CLI directly or a management skill |
| Tag management (标签管理) | Not in scope | Use hcloud CLI directly |
If a user asks for 策略查询 / 策略管理 / 配额查询 / 能力查询 / 标签管理, tell them this skill does not cover these capabilities and suggest using the hcloud CLI directly.
Prerequisites
- hcloud CLI installed and authenticated. See
references/cli-installation-guide.md. - IAM permissions:
cc:centralNetworks:listandcc:centralNetworks:get. Seereferences/iam-policies.md. - Region: Central Network is a global service — use any region where CC is available (e.g.,
cn-north-4). - Domain ID: Most commands require
--domain_id(account ID). Obtain from IAM → My Credentials.
Workflow
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 singleCore Commands
1. List Central Network Instances
hcloud CC ListCentralNetworks --cli-region={region} --domain_id={domain_id} [optional filters]格式说明模板,不可直接执行 — 将 {region}、{domain_id} 等占位符替换为实际值后执行。
Key parameters:
| Parameter | Required | Description |
|---|---|---|
--cli-region | Yes | Region, e.g., cn-north-4 |
--domain_id | Yes | Account ID |
--id.1 | No | Filter by instance ID (supports multiple: --id.1=xxx --id.2=yyy) |
--name.1 | No | Filter by name |
--limit | No | Page size (1–2000) |
--marker | No | Pagination marker |
--sort_key | No | Sort field |
--sort_dir | No | Sort direction (asc / desc) |
--enterprise_project_id.1 | No | Filter by enterprise project ID |
Example:
hcloud CC ListCentralNetworks --cli-region=cn-north-4 --domain_id=xxx --limit=102. Show Central Network Instance
hcloud CC ShowCentralNetwork --cli-region={region} --domain_id={domain_id} --central_network_id={central_network_id}格式说明模板,不可直接执行 — 将 {region}、{domain_id}、{central_network_id} 等占位符替换为实际值后执行。
Key parameters:
| Parameter | Required | Description |
|---|---|---|
--cli-region | Yes | Region |
--domain_id | Yes | Account ID |
--central_network_id | Yes | Central network ID |
Example:
hcloud CC ShowCentralNetwork --cli-region=cn-north-4 --domain_id=xxx --central_network_id=cn-xxxThe response includes an embeddedconnectionsarray withCentralNetworkConnectionInfoobjects — useful for viewing all connections without a separate call.
3. List Central Network Attachments
hcloud CC ListCentralNetworkAttachments --cli-region={region} --domain_id={domain_id} --central_network_id={central_network_id} [optional filters]格式说明模板,不可直接执行 — 将 {region}、{domain_id}、{central_network_id} 等占位符替换为实际值后执行。
Key parameters:
| Parameter | Required | Description |
|---|---|---|
--cli-region | Yes | Region |
--domain_id | Yes | Account ID |
--central_network_id | Yes | Central network ID |
--attachment_instance_type.1 | No | Filter by type: GDGW or ER_ROUTE_TABLE |
--id.1 | No | Filter by attachment ID |
--name.1 | No | Filter by name |
--state.1 | No | Filter by state (AVAILABLE, CREATING, FAILED, etc.) |
--limit | No | Page size (1–2000) |
--marker | No | Pagination marker |
Example:
hcloud CC ListCentralNetworkAttachments --cli-region=cn-north-4 --domain_id=xxx --central_network_id=cn-xxx --limit=104. Show Central Network Attachment (by type)
There is no generic show-attachment command. Use the type-specific command based on the attachment type.
4a. Show ER Route Table Attachment
hcloud CC ShowCentralNetworkErRouteTableAttachment --cli-region={region} --domain_id={domain_id} --central_network_id={central_network_id} --er_route_table_attachment_id={attachment_id}4b. Show GDGW Attachment
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}等占位符替换为实际值后执行。
How to determine attachment type: Run ListCentralNetworkAttachments first — the response includes attachment_instance_type (GDGW or ER_ROUTE_TABLE) and the corresponding attachment ID for each entry.
5. List Central Network Connections
hcloud CC ListCentralNetworkConnections --cli-region={region} --domain_id={domain_id} --central_network_id={central_network_id} [optional filters]格式说明模板,不可直接执行 — 将 {region}、{domain_id}、{central_network_id} 等占位符替换为实际值后执行。
Key parameters:
| Parameter | Required | Description |
|---|---|---|
--cli-region | Yes | Region |
--domain_id | Yes | Account ID |
--central_network_id | Yes | Central network ID |
--id.1 | No | Filter by connection ID (use this for "show single") |
--name.1 | No | Filter by name |
--state.1 | No | Filter by state |
--is_cross_region | No | Filter cross-region connections (boolean) |
--bandwidth_type | No | Filter by bandwidth type: BandwidthPackage or TestBandwidth |
--connection_type | No | Filter by connection type |
--limit | No | Page size (1–2000) |
--marker | No | Pagination marker |
Example:
hcloud CC ListCentralNetworkConnections --cli-region=cn-north-4 --domain_id=xxx --central_network_id=cn-xxx --limit=106. Show Single Central Network Connection
No dedicated ShowCentralNetworkConnection API exists. Use the list command with an ID filter:
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} 等占位符替换为实际值后执行。
Alternative: The ShowCentralNetwork response embeds a connections array containing CentralNetworkConnectionInfo objects — you can find the target connection there without a separate call.
Parameter Confirmation
| Parameter | Required | Description | Example |
|---|---|---|---|
{region} | Yes | Huawei Cloud region | cn-north-4 |
{domain_id} | Yes | Account ID (IAM → My Credentials) | xxx |
{central_network_id} | Yes (for show/list attachments/connections) | Central network instance ID | cn-xxx |
{attachment_id} | Yes (for show attachment) | Attachment ID (type-specific) | xxx |
{connection_id} | Yes (for show single connection) | Connection ID | xxx |
Reference Documents
- CLI Installation Guide
- IAM Policies
- Verification Method
- Data Flow Diagram
- Acceptance Criteria
- API Reference
KooCLI Command Format Standard
格式说明模板,不可直接执行:以下为命令格式说明,<...>、[...]为占位符,需替换为实际值后才能在终端执行。
hcloud <Service> <Operation> --cli-region=<region> [--key=value ...]| Feature | Description | Example |
|---|---|---|
| Service name | CC (Cloud Connect) | CC |
| Operation name | PascalCase | ListCentralNetworks, ShowCentralNetwork |
| Region parameter | --cli-region=<value> | --cli-region=cn-north-4 |
| Simple parameter | --key=value | --central_network_id=cn-xxx |
| Indexed parameter | --key.1=value1 | --id.1=cn-xxx |

