alicloud-security-kms について
OpenAPI を通じて Alibaba Cloud Key Management Service のリソースを管理するスキルです。API の検索、リソース操作、Alibaba Cloud の認証情報を使った結果検証に対応します。
主な機能
- 01OpenAPI の API 検索
- 02リソースの一覧表示と変更
- 03ステータス確認とトラブルシューティング
- 04環境変数または共有ファイルの認証情報
活用シーン
- 01KMS リソースの一覧表示
- 02KMS 設定の変更
- 03操作ステータスの確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill alicloud-security-kmsインストール後、Claude Code で/alicloud-security-kmsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/sources.mdscripts/list_openapi_meta_apis.py詳細
カテゴリー:サービス
Key Management Service
検証
mkdir -p output/alicloud-security-kms
python -m py_compile skills/security/key-management/alicloud-security-kms/scripts/list_openapi_meta_apis.py && echo "py_compile_ok" > output/alicloud-security-kms/validate.txt
合格基準:コマンドが終了コード 0 で終了し、output/alicloud-security-kms/validate.txt が生成されること。
出力と証跡
- KMS API の検出結果と操作結果を
output/alicloud-security-kms/に保存します。 - 操作の種類ごとに、リクエストパラメーターの例を少なくとも 1 つ保持します。
Alibaba Cloud OpenAPI(RPC)と公式 SDK または OpenAPI Explorer を使用して、KeyManagementService のリソースを管理します。
ワークフロー
- リージョン、リソース識別子、実行する操作を確認します。
- API の一覧と必須パラメーターを調べます(参考資料を参照)。
- SDK または OpenAPI Explorer で API を呼び出します。
- describe/list API で結果を確認します。
AccessKey の優先順位(必ず従うこと)
- 環境変数:
ALICLOUD_ACCESS_KEY_ID/ALICLOUD_ACCESS_KEY_SECRET/ALICLOUD_REGION_IDリージョンのポリシー:ALICLOUD_REGION_IDは任意のデフォルト値です。設定されていない場合は、タスクに最も適したリージョンを選択します。不明な場合は、ユーザーに確認します。 - 共有設定ファイル:
~/.alibabacloud/credentials
API の検出
- プロダクトコード:
Kms - デフォルトの API バージョン:
2016-01-20 - 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/alicloud-security-kms/
前提条件
- 実行前に、最小権限の Alibaba Cloud 認証情報を設定します。
- 環境変数を優先します:
ALICLOUD_ACCESS_KEY_ID、ALICLOUD_ACCESS_KEY_SECRET、任意のALICLOUD_REGION_ID。 - リージョンが不明な場合は、変更を伴う操作を実行する前にユーザーに確認します。
参考資料
- ソース:
references/sources.md
コメント
Markdown 対応