aliyun-adb-mysql について
Alibaba Cloud OpenAPI を通じて AnalyticDB for MySQL のリソースを管理するスキルです。データベースリソースの確認、設定、トラブルシューティングに使うワークフロー向けに、APIとパラメーターを先に調べ、実行後に結果を検証します。
主な機能
- 01OpenAPI とスキーマの確認
- 02リソースの一覧表示と詳細確認
- 03リソース設定の作成・変更
- 04状態確認とトラブルシューティング
- 05操作証跡と応答概要の保存
活用シーン
- 01AnalyticDB for MySQL リソースの棚卸し
- 02リソース設定の作成や調整
- 03リソース状態の確認と問題の診断
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill aliyun-adb-mysqlインストール後、Claude Code で/aliyun-adb-mysqlを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/sources.mdscripts/list_openapi_meta_apis.py詳細
カテゴリ:サービス
AnalyticDB for MySQL
公式 SDK または OpenAPI Explorer を使用して Alibaba Cloud OpenAPI(RPC)を利用し、AnalyticDB for MySQL のリソースを管理します。
ワークフロー
- リージョン、リソース識別子、実行する操作を確認します。
- API 一覧と必須パラメーターを確認します(参考資料を参照)。
- SDK または OpenAPI Explorer で API を呼び出します。
- describe/list API で結果を確認します。
AccessKey の優先順位(必ず従ってください)
- 環境変数:
ALIBABACLOUD_ACCESS_KEY_ID/ALIBABACLOUD_ACCESS_KEY_SECRET/ALIBABACLOUD_REGION_IDリージョンの方針:ALIBABACLOUD_REGION_IDは任意のデフォルト値です。設定されていない場合は、タスクに最適と思われるリージョンを選択します。不明な場合はユーザーに確認してください。 - 共有設定ファイル:
~/.alibabacloud/credentials
API の確認
- プロダクトコード:
adb - デフォルトの API バージョン:
2021-12-01 - OpenAPI メタデータエンドポイントを使用して、API 一覧とスキーマを取得します(参考資料を参照)。
高頻度の操作パターン
- インベントリ/一覧表示:現在のリソースを取得するには、
List*/Describe*API を優先します。 - 変更/設定:変更操作には、
Create*/Update*/Modify*/Set*API を優先します。 - 状態確認/トラブルシューティング:診断には、
Get*/Query*/Describe*StatusAPI を優先します。
最小限の実行可能なクイックスタート
ビジネス API を呼び出す前に、メタデータを優先して確認します。
python scripts/list_openapi_meta_apis.py
任意のオーバーライド:
python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>
このスクリプトは、API インベントリアーティファクトをスキルの出力ディレクトリに書き込みます。
出力ポリシー
レスポンスや生成されたアーティファクトを保存する必要がある場合は、次の場所に書き込んでください。
output/aliyun-adb-mysql/
検証
mkdir -p output/aliyun-adb-mysql
for f in skills/database/analyticdb/aliyun-adb-mysql/scripts/*.py; do
python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-adb-mysql/validate.txt
合格基準:コマンドが 0 で終了し、output/aliyun-adb-mysql/validate.txt が生成されていること。
出力と証跡
- アーティファクト、コマンド出力、API レスポンスの概要を
output/aliyun-adb-mysql/に保存します。 - 再現性を確保するため、主要なパラメーター(リージョン/リソース ID/時間範囲)を証跡ファイルに含めます。
前提条件
- 実行前に、最小権限の Alibaba Cloud 認証情報を設定してください。
- 環境変数を優先してください:
ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET、任意のALIBABACLOUD_REGION_ID。 - リージョンが不明な場合、変更操作を実行する前にユーザーに確認してください。
参考資料
- ソース:
references/sources.md
コメント
Markdown 対応