aliyun-airec-manage

カテゴリ：サービス

AIRec

公式 SDK または OpenAPI Explorer を使用して Alibaba Cloud OpenAPI（RPC）を利用し、AIRec のリソースを管理します。

ワークフロー

1. リージョン、リソース識別子、実行する操作を確認します。
2. API の一覧と必須パラメーターを確認します（参考資料を参照）。
3. SDK または OpenAPI Explorer で API を呼び出します。
4. describe/list API で結果を確認します。

AccessKey の優先順位（必ず従ってください）

1. 環境変数：ALIBABACLOUD_ACCESS_KEY_ID / ALIBABACLOUD_ACCESS_KEY_SECRET / ALIBABACLOUD_REGION_ID リージョンのポリシー：ALIBABACLOUD_REGION_ID は任意のデフォルト値です。設定されていない場合は、タスクに最も適したリージョンを選択します。不明な場合はユーザーに確認してください。
2. 共有設定ファイル：~/.alibabacloud/credentials

API の確認

• プロダクトコード：Airec
• デフォルトの API バージョン：2020-11-26
• OpenAPI メタデータエンドポイントを使用して API の一覧とスキーマを取得します（参考資料を参照）。

頻繁に使用する操作パターン

1. インベントリ／一覧：現在のリソースを取得するには、List* / Describe* API を優先します。
2. 変更／設定：変更には、Create* / Update* / Modify* / Set* API を優先します。
3. ステータス／トラブルシューティング：診断には、Get* / Query* / Describe*Status API を優先します。

最小限の実行可能なクイックスタート

ビジネス API を呼び出す前に、メタデータを確認します。

python scripts/list_openapi_meta_apis.py

任意の上書き設定：

python scripts/list_openapi_meta_apis.py --product-code <ProductCode> --version <Version>

スクリプトは、スキルの出力ディレクトリに API インベントリの成果物を保存します。

出力ポリシー

レスポンスや生成された成果物を保存する必要がある場合は、次の場所に保存します。 output/aliyun-airec-manage/

検証

mkdir -p output/aliyun-airec-manage
for f in skills/ai/recommendation/aliyun-airec-manage/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/aliyun-airec-manage/validate.txt

合格基準：コマンドが 0 で終了し、output/aliyun-airec-manage/validate.txt が生成されます。

出力とエビデンス

• 成果物、コマンド出力、API レスポンスの概要を output/aliyun-airec-manage/ に保存します。
• 再現性を確保するため、エビデンスファイルに主要なパラメーター（リージョン／リソース ID／期間）を記載します。

前提条件

• 実行前に、最小権限の Alibaba Cloud 認証情報を設定します。
• 環境変数 ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET、任意の ALIBABACLOUD_REGION_ID の使用を推奨します。
• リージョンが不明な場合は、変更を伴う操作を実行する前にユーザーに確認してください。

参考資料

• ソース：references/sources.md