aliyun-vod-manage について
OpenAPI を通じて Alibaba Cloud ApsaraVideo VOD のリソースを管理するスキルです。API メタデータの確認、変更前の読み取り専用チェック、実行証跡の保存を重視します。
主な機能
- 01メタデータから VOD API を検索
- 02読み取り専用 API でリソースを確認
- 03アップロード、メディア、再生を管理
- 04トランスコードと AI ジョブを設定
- 05操作証跡を保存
活用シーン
- 01作業前に VOD API を一覧化
- 02編集前にメディア情報を確認
- 03トランスコードやスナップショットを実行
- 04API 結果をトラブル調査用に記録
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill aliyun-vod-manageインストール後、Claude Code で/aliyun-vod-manageを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/sources.mdtemplates.mdscripts/list_openapi_meta_apis.py詳細
カテゴリ:サービス
ApsaraVideo VOD
検証
mkdir -p output/aliyun-vod-manage
python -m py_compile skills/media/vod/aliyun-vod-manage/scripts/list_openapi_meta_apis.py
echo "py_compile_ok" > output/aliyun-vod-manage/validate.txt
合格条件:コマンドが終了コード 0 で終了し、output/aliyun-vod-manage/validate.txt が生成されること。
出力と証跡
- API の一覧と操作の証跡を
output/aliyun-vod-manage/の下に保存します。 - リージョン、メディア ID、テンプレート ID、リクエストパラメーターを証跡ファイルに記録します。
Alibaba Cloud OpenAPI(RPC)を公式 SDK または OpenAPI Explorer と併用して、VOD リソースを管理します。 変更操作の前に、メタデータを優先して API を確認してください。
前提条件
- 最小権限の RAM AccessKey/STS 認証情報を準備します。
- 変更前に対象リージョンとメディアの範囲を確認します。
- まず読み取り専用の
Describe*/List*API を使用します。
ワークフロー
- 対象メディア ID、ストレージの範囲、希望する操作を確認します。
- メタデータと API Explorer を使って API 名と必須パラメーターを確認します。
- 読み取り専用の検証呼び出しを実行します。
- アップロード/処理/再生/設定の操作を実行します。
- 出力と証跡を
output/aliyun-vod-manage/の下に保存します。
AccessKey の優先順位
- 環境変数:
ALIBABACLOUD_ACCESS_KEY_ID/ALIBABACLOUD_ACCESS_KEY_SECRET/ALIBABACLOUD_REGION_ID。 - 共有設定ファイル:
~/.alibabacloud/credentials。
リージョンが不明確な場合は、書き込み操作の前に確認してください。
API の確認
- プロダクトコード:
vod - デフォルトの API バージョン:
2017-03-21 - メタデータのソース:
https://api.aliyun.com/meta/v1/products/vod/versions/2017-03-21/api-docs.json
最小限の実行可能なクイックスタート
python skills/media/vod/aliyun-vod-manage/scripts/list_openapi_meta_apis.py
任意の上書き設定:
python skills/media/vod/aliyun-vod-manage/scripts/list_openapi_meta_apis.py \
--product-code vod \
--version 2017-03-21 \
--output-dir output/aliyun-vod-manage
一般的な操作の対応表
- アップロードとアセット:
CreateUploadVideo、CreateUploadImage、GetPlayInfo、SearchMedia - メディア管理:
GetVideoInfo、UpdateVideoInfo、DeleteVideo - トランスコード/テンプレート:
AddTranscodeTemplateGroup、UpdateTranscodeTemplateGroup、SubmitTranscodeJobs - スナップショット/AI ジョブ:
SubmitSnapshotJob、SubmitAIJob、GetJobDetail - セキュリティ/再生認証:
GetVideoPlayAuth、SetMessageCallback、SetDefaultWatermark
出力ポリシー
生成されたすべてのファイルと実行証跡を次の場所に書き込みます:
output/aliyun-vod-manage/
参考資料
- ソース一覧:
references/sources.md - タスクテンプレート:
references/templates.md
コメント
Markdown 対応