aliyun-ice-manage について
Alibaba Cloud OpenAPIでIntelligent Cloud Editing(ICE)のリソースとメディア処理ジョブを管理するスキルです。APIを先に調査し、変更前の読み取り専用確認と実行記録の保存を重視します。
主な機能
- 01OpenAPIメタデータの検索
- 02メディアとワークフローの管理
- 03処理ジョブの送信と監視
- 04前提リソースの読み取り専用確認
- 05操作記録の保存
活用シーン
- 01メディアメタデータの確認
- 02メディアワークフローの作成・更新
- 03メディアジョブの送信と監視
- 04処理前のリソース検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill aliyun-ice-manageインストール後、Claude Code で/aliyun-ice-manageを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/sources.mdtemplates.mdscripts/list_openapi_meta_apis.py詳細
カテゴリ:サービス
Intelligent Cloud Editing(ICE)
検証
mkdir -p output/aliyun-ice-manage
python -m py_compile skills/media/ice/aliyun-ice-manage/scripts/list_openapi_meta_apis.py
echo "py_compile_ok" > output/aliyun-ice-manage/validate.txt
合格基準:コマンドが終了コード 0 で終了し、output/aliyun-ice-manage/validate.txt が生成されます。
出力と証跡
- API の一覧と操作の証跡を
output/aliyun-ice-manage/に保存します。 - リージョン、ワークフロー ID、ジョブ ID、リクエストパラメーターを証跡ファイルに記録します。
Alibaba Cloud OpenAPI(RPC)と公式 SDK、または OpenAPI Explorer を使用して ICE リソースを管理します。 変更操作の前に、メタデータを優先して API を調査します。
前提条件
- 最小権限の RAM AccessKey/STS 認証情報を用意します。
- 変更前に、対象リージョン、入力/出力先の OSS ロケーション、ワークフローの範囲を確認します。
- 処理ジョブを実行する前に、読み取り専用 API で現在の状態を照会します。
ワークフロー
- 対象のワークフロー/テンプレートと、メディアの入力/出力先を確認します。
- メタデータと API Explorer を使用して、API 名と必須パラメーターを調べます。
- 読み取り専用 API を使用して、前提となるリソースを検証します。
- 処理ジョブを送信して監視します。
- 出力と証跡を
output/aliyun-ice-manage/に保存します。
AccessKey の優先順位
- 環境変数:
ALIBABACLOUD_ACCESS_KEY_ID/ALIBABACLOUD_ACCESS_KEY_SECRET/ALIBABACLOUD_REGION_ID。 - 共有設定ファイル:
~/.alibabacloud/credentials。
リージョンが不明確な場合は、書き込み操作の前に確認してください。
API の調査
- プロダクトコード:
ice - デフォルトの API バージョン:
2020-11-09 - メタデータソース:
https://api.aliyun.com/meta/v1/products/ice/versions/2020-11-09/api-docs.json
実行可能な最小クイックスタート
python skills/media/ice/aliyun-ice-manage/scripts/list_openapi_meta_apis.py
オプションの上書き設定:
python skills/media/ice/aliyun-ice-manage/scripts/list_openapi_meta_apis.py \
--product-code ice \
--version 2020-11-09 \
--output-dir output/aliyun-ice-manage
一般的な操作の対応関係
- メディア情報とメタデータ:
GetMediaInfo、SearchMedia、UpdateMediaMeta - ワークフロー/テンプレート:
CreateMediaWorkflow、UpdateMediaWorkflow、ListMediaWorkflowExecutions - ジョブの送信:
SubmitMediaProducingJob、SubmitBatchMediaProducingJob、GetMediaProducingJob - 編集/素材:
CreateSourceLocation、AddMedia、GetDefaultMaterial - タスクのステータス/トラブルシューティング:
GetTaskInfo、ListJobs、GetBatchMediaProducingJob
出力ポリシー
生成されたすべてのファイルと実行証跡を次の場所に書き込みます:
output/aliyun-ice-manage/
参考資料
- ソース一覧:
references/sources.md - タスクテンプレート:
references/templates.md
コメント
Markdown 対応