huawei-cloud-cc-central-network-query

Huawei Cloud CC セントラルネットワークの照会

概要

このスキルでは、hcloud CLI を使用して Huawei Cloud Cloud Connect（CC）のセントラルネットワークリソースを照会します。セントラルネットワークは Cloud Connect の中核概念であり、リージョンやクラウドをまたいだグローバルかつ集中管理型のネットワークアーキテクチャを実現します。

対象範囲： 照会のみです。作成、更新、削除の操作は行いません。

対象リソース：

リソース	一覧表示	詳細表示
セントラルネットワークインスタンス	✅ ListCentralNetworks	✅ ShowCentralNetwork
セントラルネットワークアタッチメント	✅ ListCentralNetworkAttachments	✅ ShowCentralNetworkErRouteTableAttachment / ShowCentralNetworkGdgwAttachment
セントラルネットワーク接続	✅ ListCentralNetworkConnections	✅ ListCentralNetworkConnections --id.1 フィルターを使用

アタッチメントに関する注意： セントラルネットワークアタッチメントには、ER ルートテーブルとGDGWの 2 種類があります。汎用の「アタッチメントを詳細表示」するコマンドはありません。アタッチメントの種類に応じて、該当するコマンドを使用してください。

接続の詳細表示に関する注意： 専用の ShowCentralNetworkConnection API はありません。単一の接続を照会するには、ListCentralNetworkConnections で --id.1 フィルターを使用するか、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

レスポンスには CentralNetworkConnectionInfo オブジェクトを含む connections 配列が埋め込まれています。別途呼び出すことなく、すべての接続を確認するのに便利です。

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}	はい	Huawei Cloud のリージョン	cn-north-4
{domain_id}	はい	アカウント ID（IAM → My Credentials）	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
操作名	パスカルケース	ListCentralNetworks, ShowCentralNetwork
リージョンパラメーター	--cli-region=<value>	--cli-region=cn-north-4
シンプルパラメーター	--key=value	--central_network_id=cn-xxx
インデックス付きパラメーター	--key.1=value1	--id.1=cn-xxx