huawei-cloud-cc-gcb-query

概要

Huawei Cloud Cloud Connect（CC）は、**グローバル接続帯域幅（GCB）**を提供します。GCB は、さまざまなサービスインスタンス（クラウド接続、セントラルネットワーク、ブランチネットワーク、グローバル EIP）にバインドできる帯域幅リソースで、リージョン間またはクラウド間の接続を可能にします。

このスキルでは、GCB 関連の次の 4 つの操作について、読み取り専用のクエリ機能を提供します。

操作	説明
GCB の表示	ID を指定して単一の GCB を照会します。応答には、バインド済みのインスタンス情報が含まれます
GCB の一覧表示	ステータス、課金モード、バインド先サービス、インスタンス、タイプ、名前、エンタープライズプロジェクトで絞り込める、詳細なフィルターに対応したページ分割リストです
GCB テナント設定	テナントレベルの設定（サイズ範囲、クォータ、対応する課金モード、対応するサービス、バインド上限、SLA レベル）を照会します
バインド可能な GCB のサポート	特定のサービス種別（CC／GEIP／GCN／GSN）へのバインドが可能な GCB を一覧表示し、ローカル／リモートのエリアで絞り込みます

すべての操作はクエリ専用（GET）です。作成、更新、削除の操作は行いません。

対象外

このスキルでは、以下の GCB クエリ機能は対象外です。

対象外の機能	対応する API／CLI コマンド	説明
タグ管理	ListGcbResourceTags, ListGcbTenantTags, BatchCreateGcbResourceTags 等	hcloud CC ListGcbResourceTags 等を使用してください
回線レベル	ListGlobalConnectionBandwidthLineLevels	hcloud CC ListGlobalConnectionBandwidthLineLevels を使用してください
サイト	ListGlobalConnectionBandwidthSites	hcloud CC ListGlobalConnectionBandwidthSites を使用してください
仕様コード	ListGlobalConnectionBandwidthSpecCodes	hcloud CC ListGlobalConnectionBandwidthSpecCodes を使用してください
すべての書き込み操作	Create/Delete/Update/Associate/Disassociate 等	このスキルではクエリ（GET）機能のみを提供します

前提条件

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

   # Set AK/SK via secure prompt — never hardcode secrets in scripts
   read -rsp "Access Key ID: "     HUAWEI_ACCESS_KEY; echo
   read -rsp "Secret Access Key: " HUAWEI_SECRET_KEY; echo
   export HUAWEI_ACCESS_KEY HUAWEI_SECRET_KEY
   export HUAWEI_REGION="cn-north-4"
   

3. IAM 権限 — 呼び出し元には CC ReadOnlyAccess または同等の権限が必要です。最小権限のポリシーについては、references/iam-policies.md を参照してください。
4. ドメイン ID — すべての CC GCB API で --domain_id（アカウント ID）が必要です。コンソールから取得してください：IAM → 認証情報 → アカウント ID。

ワークフロー

1. Identify the query type (single GCB / list / tenant configs / support binding)
2. Obtain the domain_id (account ID from IAM → My Credentials)
3. For single query: provide --domain_id and --id (GCB instance ID)
4. For list query: provide --domain_id, optionally add filters
5. For tenant configs: provide --domain_id only
6. For support binding: provide --domain_id and --binding_service (required)
7. Execute the hcloud command and review the output

主なコマンド

すべてのコマンドは次の形式を使用します：

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

1. 単一のグローバル接続帯域幅を照会する

ID を指定して GCB の詳細を照会します。応答には、GCB の設定とバインド済みインスタンス情報（この GCB にバインドされているクラウド接続、セントラルネットワーク、その他のサービスインスタンス）が含まれます。

hcloud CC ShowGlobalConnectionBandwidth --cli-region=cn-north-4 --domain_id=<account_id> --id=<gcb_id>

パラメーター	必須	説明
--domain_id	はい	アカウント ID
--id	はい	GCB インスタンス ID（32～36 文字）

主な応答フィールド：

フィールド	意味
id	GCB インスタンス ID
name	GCB 名
size	帯域幅サイズ（Mbit/s）
type	帯域幅タイプ：TrsArea（リージョン間）、Area（大リージョン）、SubArea（リージョン）、Region（都市圏）
charge_mode	課金モード：bwd（帯域幅課金）、95（従来型 95 パーセンタイル）、95avr（日次 95 パーセンタイル）
admin_state	ステータス：NORMAL または FREEZED
binding_service	バインド先のサービス種別：CC、GEIP、GCN、GSN
instances	バインド済みインスタンス（クラウド接続、セントラルネットワークなど）のリスト
local_area	ローカルアクセスポイント
remote_area	リモートアクセスポイント
enterprise_project_id	エンタープライズプロジェクト ID

2. グローバル接続帯域幅の一覧表示

豊富なフィルタリングオプションを備えたページ分割された一覧です。

hcloud CC ListGlobalConnectionBandwidths --cli-region=cn-north-4 --domain_id=<account_id> \
  [--limit=10] [--marker=<marker>] \
  [--admin_state.1=NORMAL] \
  [--binding_service.1=CC] \
  [--charge_mode.1=bwd] \
  [--id.1=<gcb_id>] \
  [--instance_id.1=<instance_id>] \
  [--instance_type.1=CC] \
  [--name.1=<name>] \
  [--type.1=TrsArea] \
  [--enterprise_project_id.1=<ep_id>]

パラメーター	必須	説明
--domain_id	はい	アカウント ID
--limit	いいえ	1 ページあたりのレコード数（1～2000）
--marker	いいえ	ページネーションマーカー（limit と併用）
--admin_state.[N]	いいえ	ステータスでフィルター：NORMAL または FREEZED
--binding_service.[N]	いいえ	バインド済みサービスの種類でフィルター：CC、GEIP、GCN、GSN
--charge_mode.[N]	いいえ	課金モードでフィルター：bwd、95、95avr
--id.[N]	いいえ	GCB ID でフィルター（複数指定に対応）
--instance_id.[N]	いいえ	バインド済みインスタンス ID でフィルター
--instance_type.[N]	いいえ	バインド済みインスタンスの種類でフィルター：CC、GEIP、GCN、GSN
--name.[N]	いいえ	名前でフィルター（複数指定に対応）
--type.[N]	いいえ	帯域幅の種類でフィルター：TrsArea、Area、SubArea、Region
--enterprise_project_id.[N]	いいえ	エンタープライズプロジェクト ID でフィルター

3. GCB テナント設定の照会

GCB のテナントレベルの設定を照会します。課金モードごとのサイズ範囲、クォータ、サポートされるサービス、サポートされる帯域幅の種類、バインド上限、SLA レベルなどが含まれます。

hcloud CC ListGlobalConnectionBandwidthConfigs --cli-region=cn-north-4 --domain_id=<account_id>

パラメーター	必須	説明
--domain_id	はい	アカウント ID

主なレスポンスフィールド：

フィールド	意味
gcbSizeRange / size_range	課金モード（trf、bwd、95p、95、95avr）ごとの帯域幅サイズ範囲
quotas	クォータ：gcb.size（帯域幅の合計クォータ）と gcb.count（GCB 数のクォータ）
charge_mode / chargeMode	サポートされる課金モード
services / serviceList	サポートされるバインド対象サービスの種類
gcb_type / gcbType	サポートされる GCB の種類：Area、TrsArea、Region、SubArea
bind_limit	1 つの GCB にバインドできるインスタンスの最大数
sla_level	SLA レベル：Pt、Au、Ag
relation	GCB の種類ごとにサポートされるサービスの種類
crossborder	クロスボーダー帯域幅が有効かどうか
ces_enabled	CES モニタリングが有効かどうか

4. バインド可能な GCB の一覧表示

特定のサービスの種類について、バインド条件を満たす GCB を一覧表示します。新しいクラウド接続、セントラルネットワーク、その他のサービスインスタンスにバインドする利用可能な GCB を探す場合に便利です。

hcloud CC ListSupportBindingConnectionBandwidths --cli-region=cn-north-4 --domain_id=<account_id> \
  --binding_service=<CC|GEIP|GCN|GSN> \
  [--limit=10] [--marker=<marker>] \
  [--local_area=<local_area>] \
  [--remote_area=<remote_area>] \
  [--enterprise_project_id.1=<ep_id>]

パラメーター	必須	説明
--domain_id	はい	アカウント ID
--binding_service	はい	対象サービスの種類：CC（クラウド接続）、GEIP（グローバル EIP）、GCN（セントラルネットワーク）、GSN（ブランチネットワーク）
--limit	いいえ	1 ページあたりのレコード数（1～2000）
--marker	いいえ	ページネーションマーカー
--local_area	いいえ	ローカルアクセスポイント（remote_area と併用します。両方を指定するか、どちらも指定しない必要があります）
--remote_area	いいえ	リモートアクセスポイント（local_area と併用します）
--enterprise_project_id.[N]	いいえ	エンタープライズプロジェクト ID でフィルター

パラメーターの確認

パラメーター	必須	説明	例
--cli-region	はい	Huawei Cloud のリージョン	cn-north-4
--domain_id	はい	アカウント ID（IAM → My Credentials から取得）	0a12345678...
--id	はい（表示）	GCB インスタンス ID（32～36 文字の UUID）	a1b2c3d4-e5f6-7890-abcd-ef1234567890
--binding_service	はい（バインドのサポート）	対象サービスの種類	CC
--limit	いいえ	ページサイズ（1～2000）	10
--marker	いいえ	ページネーショントークン	<前のページのマーカー>

参考ドキュメント

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

KooCLI コマンド形式の標準

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

機能	説明	例
サービス名	CC（Cloud Connect）	CC
オペレーション名	パスカルケース	ShowGlobalConnectionBandwidth、ListGlobalConnectionBandwidths
リージョンパラメーター	--cli-region=<value>	--cli-region=cn-north-4
単純なパラメーター	--key=value	--id=xxx
インデックス付き配列パラメーター	--key.1=value1	--admin_state.1=NORMAL