mcpField
A
aliyun-vod-manage

aliyun-vod-manage

github.com/cinience云与 DevOps39656 次安装11 周前更新
代码仓库

关于 aliyun-vod-manage

用于通过 OpenAPI 管理阿里云 ApsaraVideo VOD 资源的技能。它强调先发现 API 元数据、变更前进行只读检查，并保存执行证据。

主要功能

  1. 01从元数据发现 VOD API
  2. 02使用只读 API 检查资源
  3. 03管理上传、媒体和播放
  4. 04配置转码与 AI 任务
  5. 05保存操作证据

适用场景

  1. 01执行任务前盘点 VOD API
  2. 02编辑前检查媒体详情
  3. 03提交转码或截图任务
  4. 04保存 API 结果以便排查

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-vod-manage

安装后在 Claude Code 中输入/aliyun-vod-manage确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
sources.md
templates.md
scripts/
list_openapi_meta_apis.py

详细介绍

Category: 服务

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。

工作流

  1. 确认目标媒体 ID、存储范围和所需操作。
  2. 通过元数据和 API Explorer 查找 API 名称及必需参数。
  3. 执行只读验证调用。
  4. 执行上传、处理、播放和配置操作。
  5. 将输出和证据保存到 output/aliyun-vod-manage/。

AccessKey 优先级

  1. 环境变量：ALIBABACLOUD_ACCESS_KEY_ID / ALIBABACLOUD_ACCESS_KEY_SECRET / ALIBABACLOUD_REGION_ID。
  2. 共享配置文件：~/.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