huawei-cloud-computing-query

Huawei Cloud リソースのクエリ

⚠️ 実行方法（必読）：このスキルは、ローカルの Python スクリプトを使用してクエリを実行します。hcloud、openstack などの CLI ツールや、API の直接呼び出しは禁止されています。

• クエリスクリプトはスキルディレクトリ scripts/<service_category>/（例：scripts/as/list_scaling_groups.py）にあります。
• すべてのスクリプトと環境チェック用スクリプトはスキルパッケージ内にあります。実行には必ず skill action=exec を使用してください。シェルから直接実行しないでください。
• スクリプトのパスとパラメーターについては、references/<service>/guide.md を参照してください。
• hcloud、openstack、curl IAM などの CLI／API による方法を試さないでください。このスキルはそれらのツールに依存しません。
• すべてのパスはスキルディレクトリ（この SKILL.md があるディレクトリ）からの相対パスです。

概要

このスキルは、ローカルの Python スクリプトを通じて Huawei Cloud Python SDK を呼び出し、Huawei Cloud リソース、利用可能な仕様、および既存リソースの情報を照会する、単独で動作する読み取り専用のクエリスキルです。

このスキルは、次のようなシナリオで使用できます。

1. 指定したリージョンで利用可能なクラウドリソースの仕様を照会する
2. 特定のオペレーティングシステムで利用可能なイメージを照会する
3. クラウドディスクの種類と既存のクラウドディスク情報を照会する
4. 既存リソースとその主要な属性を照会する
5. Terraform やその他の IaC ツールを使用せずに作成されたリソースを照会する
6. 自動化設定、リソース検証、環境インベントリのための実際のパラメーターを準備する
7. リソース ID、名前、仕様、イメージ、ネットワーク、ディスクなどの再利用可能な情報を取得する

このスキルでは、次の操作は行いません。

1. リソースの作成
2. リソースの変更
3. リソースの削除
4. 照会していない情報の推測や捏造

---

対応範囲

このスキルは、scripts ディレクトリにあるカテゴリ別のスクリプトを通じてクエリ機能を提供し、references ディレクトリにあるカテゴリ別のガイドを通じて使用方法を案内します。 このスキルでは、次のクエリ機能を利用できます。

1. リソース一覧の照会
2. 個々のリソースの詳細の照会
3. 利用可能な仕様、イメージ、ディスクの種類など、選択に関する情報の照会
4. 既存リソースの主要な識別子と依存関係の照会

---

使用原則

重要：このスキル内で実行するスクリプトのパスはすべて、この SKILL.md があるスキルディレクトリからの相対パスです。

1. このスキルはクエリのみを実行し、書き込み操作は行いません
2. リージョン、プロジェクト、AZ、リソース名、リソース ID など、ユーザーが明示した情報を優先して使用してください
3. クエリ結果は実際の API 応答に基づいている必要があります。経験に基づいて推測しないでください
4. 返す結果には、後で再利用できるよう主要なフィールドを保持してください
5. 結果が大量にある場合は、リージョン、名前、ID、ステータス、タグなどの条件で対象を絞り込むことを優先してください
6. 現在のリソースタイプに対応するスクリプトまたはガイドがない場合は、対応していないことを明確に伝えてください。信頼できない結果を返さないでください
7. ユーザーが必要な範囲情報を指定しておらず、環境にもデフォルト値がない場合は、クエリを実行する前に情報を確認してください
8. guide.md に従って直接実行してください。scripts ディレクトリ内のスクリプトの内容を読まないでください
9. 出力が大量の場合は、キャッシュしてください
10. 各スクリプトを実行する前に、必ず -h を実行して使い方を確認してください
11. スクリプト名を捏造しないでください。guide.md に記載されたスクリプト名に従って実行してください。スクリプト名が guide.md に記載されていない場合は、対応していません

前提条件

使用する前に、環境チェック用スクリプトを実行して、環境の検証と依存関係のインストールを一度に完了する必要があります。

• Linux / macOS：skill action=exec: bash skill://scripts/check_env.sh
• Windows：skill action=exec: powershell -ExecutionPolicy Bypass -File skill://scripts/check_env.ps1

Windows に関する注意：PowerShell 5.x は && によるコマンドの連結をサポートしていないため、使用しないでください。先にディレクトリを変更する場合は、セミコロンを使用してください。

スクリプトは、Python >= 3.6 の確認 → 依存関係のインストール → SDK の検証 → 認証情報の検証 → サービスの利用可能性の検証、の順に実行します。環境チェックに失敗した場合は、他のスクリプトを実行する前に問題を解決してください。

環境変数：

変数	必須	説明
HW_ACCESS_KEY	はい	Huawei Cloud AK
HW_SECRET_KEY	はい	Huawei Cloud SK
HW_REGION_NAME	いいえ	デフォルトは cn-north-4
HW_PROJECT_ID	いいえ	プロジェクト ID（設定されていない場合は IAM API 経由で自動取得）
HW_SECURITY_TOKEN	いいえ	一時的な AK/SK を使用する場合に必要

上記の環境変数の値を出力しないでください。 利用可能ゾーン、エンタープライズプロジェクトなど、追加パラメーターが必要な他のリソーススクリプトについては、該当する guide.md を参照してください。

---

実行フロー

このスキルが呼び出されたら、ユーザーから追加の指示を待たずに、次の手順に従ってください。

ステップ 1：環境の準備

環境チェック用スクリプトを実行して、依存関係がインストールされ、認証情報が設定されていることを確認します。

• Linux / macOS：skill action=exec: bash skill://scripts/check_env.sh
• Windows：skill action=exec: powershell -ExecutionPolicy Bypass -File skill://scripts/check_env.ps1

環境チェックに失敗した場合は、指示に従って問題を解決し、成功するまで再実行してください。

ステップ 2：クエリスクリプトの特定と実行

1. ユーザーのクエリの意図に基づいて references/<service>/guide.md を読み、実行するスクリプトのパスとパラメーターを確認します
2. まず -h を実行して、スクリプトの使用方法を確認します。
   • Linux / macOS：skill action=exec: skill://.venv/bin/python3 skill://scripts/<service>/<script>.py -h
   • Windows：skill action=exec: skill://.venv/Scripts/python3.exe skill://scripts/<service>/<script>.py -h
3. ユーザーの要件に基づいてパラメーターを組み立て、スクリプトを実行します。
   • Linux / macOS：skill action=exec: skill://.venv/bin/python3 skill://scripts/<service>/<script>.py <parameters>
   • Windows：skill action=exec: skill://.venv/Scripts/python3.exe skill://scripts/<service>/<script>.py <parameters>
4. 結果を整形してユーザーに返します

重要：

• すべてのスクリプトと環境チェック用スクリプトはスキルパッケージ内にあります。実行には skill action=exec を使用し、シェルから直接実行しないでください
• 仮想環境は check_env スクリプトによって自動的に作成されます。Linux/macOS では Python は .venv/bin/python3 に、Windows では .venv/Scripts/python3.exe にあります
• スクリプトの実行に python3 を直接使用しないでください
• scripts ディレクトリ内のスクリプトのソースコードを読まず、guide.md の指示に従って実行してください
• 出力が大きい場合は、結果をキャッシュしてください
• --project_id パラメーターは省略可能です。指定されていない場合は、リージョンに基づいて IAM API 経由で自動取得されます

---

ディレクトリ構成

ディレクトリの規則は次のとおりです（すべてのパスはスキルディレクトリからの相対パスです）。

1. scripts/<resource_category>/ には、対応するリソースの Python クエリスクリプトが含まれます。スクリプトの内容を読む必要はありません。guide.md の使用方法に従って実行してください
2. references/<resource_category>/guide.md には、対応するリソースの使用ガイドが含まれます
3. 各スクリプトは、明確なクエリアクションを 1 つ実行します
4. 各リソースカテゴリには、スクリプトの機能、パラメーター、使用方法を説明する guide.md が少なくとも 1 つあります

パラメーターの確認

クエリスクリプトを実行する前に、次のパラメーターを確認してください。

パラメーター	必須	説明
region	はい	Huawei Cloud のリージョン（例：cn-north-4）
--project_id	いいえ	プロジェクト ID。指定されていない場合は自動的に取得されます
--availability_zone	いいえ	アベイラビリティーゾーン。一部のリソースクエリで必要です

スクリプト固有のパラメーターについては、references/<service>/guide.md を参照してください。

---

出力形式

クエリ結果は JSON 形式で出力され、次の共通フィールドが含まれます。

• total：一致するリソースの総数
• items：リソースの一覧。各リソースには、id、name、status などの主要フィールドが含まれます
• 固有のフィールドはリソースの種類によって異なります。詳細については、各 guide.md ファイルを参照してください

---

検証方法

1. 環境確認スクリプトを実行し、依存関係と認証情報が利用可能であることを確認します
2. -h パラメーターを使用してスクリプトの使い方を確認し、パラメーターが正しいことを確認します
3. 既知のリソースに対してクエリを実行し、コンソールのデータと比較して結果の正確性を検証します
4. 返された total の件数が妥当かどうか確認します

---

ベストプラクティス

1. データが多く返されすぎないよう、まずクエリ範囲を絞り込みます（リージョン、アベイラビリティーゾーンなどを指定します）
2. --help を使用して、スクリプトでサポートされているパラメーターの一覧を確認します
3. クエリ結果が大量の場合は、リクエストの繰り返しを避けるため、ローカルにキャッシュします
4. 複数のリソース情報が必要な場合は、依存関係の順にクエリします（例：まず VPC をクエリし、次にサブネットをクエリします）
5. スクリプトの実行に失敗した場合は、まず環境変数とネットワーク接続を確認します

---

参考ドキュメント

• 各サービスのクエリスクリプト使用ガイド：references/<service>/guide.md

---

注意事項

1. このスキルが提供するのは読み取り専用のクエリ機能のみであり、書き込み操作は実行しません
2. HW_ACCESS_KEY や HW_SECRET_KEY などの環境変数の値を出力しないでください
3. すべてのスクリプトは skill action=exec を介して実行する必要があります。シェルから直接実行しないでください
4. スクリプト名を捏造しないでください。guide.md に記載された名前に従って実行してください
5. クエリを実行する前に、環境確認スクリプトを実行する必要があります
6. 一時的な AK/SK を使用する場合は、HW_SECURITY_TOKEN を設定する必要があります