huawei-cloud-cc-instance-query

概要

Huawei Cloud Cloud Connect（CC）は、リージョン間およびクラウド間のネットワーク接続を可能にするサービスです。このスキルでは、7 種類の主要な CC リソースに対する読み取り専用の照会機能を提供します。

リソースタイプ	説明
Cloud Connection	リージョン間またはクラウド間の VPC を接続する最上位のコンテナです
Bandwidth Package	クラウド接続にバインドされた、購入済みの帯域幅リソースです
Inter-Region Bandwidth	帯域幅パッケージ内で、2 つの特定のリージョン間に割り当てられた帯域幅です
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 management（タグ管理：Tag/Untag/ListTags）	hcloud CC ListTags / hcloud CC ListCloudConnectionTags
すべての書き込み操作（Create/Update/Delete/Apply/Associate/Disassociate）	サポート対象外です。このスキルは読み取り専用です

前提条件

1. hcloud CLI がインストールされ、認証済みであること。詳細は references/cli-installation-guide.md を参照してください。
2. Huawei Cloud AK/SK が hcloud configure（対話形式、推奨）または環境変数で設定されていること：

   # 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 → My Credentials → Account 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. Cloud Connection インスタンス

単一のクラウド接続を照会：

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）	Cloud Connection インスタンス ID
--limit	いいえ	1 ページあたりのレコード数（1～2000）
--marker	いいえ	ページネーションマーカー（limit と併用）
--status.[N]	いいえ	ステータスで絞り込み（例：ACTIVE）
--name.[N]	いいえ	リソース名で絞り込み
--id.[N]	いいえ	リソース ID で絞り込み（一覧表示のみ）
--enterprise_project_id.[N]	いいえ	エンタープライズプロジェクト ID で絞り込み

2. Bandwidth Package インスタンス

単一の帯域幅パッケージを照会：

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）	Bandwidth Package インスタンス ID
--limit	いいえ	1 ページあたりのレコード数（1～2000）
--marker	いいえ	ページネーションマーカー
--status.[N]	いいえ	ステータスで絞り込み（例：ACTIVE）
--cloud_connection_id.[N]	いいえ	Cloud Connection 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	はい（詳細表示）	リージョン間帯域幅インスタンス ID
--limit	いいえ	1 ページあたりのレコード数（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	はい（詳細表示）	ネットワークインスタンス ID
--limit	いいえ	1 ページあたりのレコード数（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	はい（詳細表示）／いいえ（一覧表示）	ルートインスタンス ID
--limit	いいえ	1 ページあたりのレコード数（1–2000）
--marker	いいえ	ページネーションマーカー
--cloud_connection_id.[N]	いいえ	クラウド接続 ID で絞り込み
--instance_id.[N]	いいえ	ネットワークインスタンス ID で絞り込み
--region_id	いいえ（一覧表示のみ）	リージョン 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 ページあたりのレコード数（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ページあたりのレコード数（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	はい	Huawei Cloud のリージョン	cn-north-4
--domain_id	はい	アカウント ID（IAM → My Credentials から取得）	0a12345678...
--id	はい（表示操作）	リソースインスタンス ID（32～36 文字の UUID）	a1b2c3d4-e5f6-7890-abcd-ef1234567890
--limit	いいえ	ページサイズ（1～2000）	10
--marker	いいえ	ページネーショントークン	<marker from previous page>

参考ドキュメント

• CLI インストールガイド — hcloud CLI のセットアップと認証
• IAM ポリシー — CC クエリ操作向けの最小権限ポリシー
• 検証方法 — クエリ結果の検証方法
• データフロー図 — スキルのデータフローを示す Mermaid 図
• 受け入れ基準 — 各クエリタイプの成功基準
• API リファレンス — SDK のソースから確認された REST API エンドポイント

KooCLI コマンド形式の標準

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

機能	説明	例
サービス名	CC（Cloud Connect）	CC
操作名	パスカルケース	ShowCloudConnection、ListCloudConnections
リージョンパラメーター	--cli-region=<value>	--cli-region=cn-north-4
単純なパラメーター	--key=value	--id=xxx
インデックス付き配列パラメーター	--key.1=value1	--status.1=ACTIVE