关于 alicloud-media-live
通过 Alibaba Cloud OpenAPI 管理 ApsaraVideo Live 资源的技能,面向负责直播域名、推流和播放配置的运维人员。强调先查阅 API 元数据并读取现状,再执行变更和保存操作证据。
主要功能
- 01通过元数据发现 API 操作
- 02管理直播域名
- 03配置录制与转码模板
- 04查询在线流及流量指标
- 05将结果和证据保存到指定目录
适用场景
- 01盘点可用的 Live API
- 02变更直播域名前先核查状态
- 03检查在线流和域名流量
- 04记录 API 操作参数及结果
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ cinience/ alicloud-skills --skill alicloud-media-live安装后在 Claude Code 中输入/alicloud-media-live确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/sources.mdtemplates.mdscripts/list_openapi_meta_apis.py详细介绍
类别:服务
ApsaraVideo Live
验证
mkdir -p output/alicloud-media-live
python -m py_compile skills/media/live/alicloud-media-live/scripts/list_openapi_meta_apis.py
echo "py_compile_ok" > output/alicloud-media-live/validate.txt
通过标准:命令以 0 退出,并生成 output/alicloud-media-live/validate.txt。
输出与证据
- 将 API 清单和操作证据保存在
output/alicloud-media-live/下。 - 在证据文件中保留地域、域名、应用/流和请求参数。
使用 Alibaba Cloud OpenAPI(RPC)和官方 SDK 或 OpenAPI Explorer 管理 Live 资源。 变更操作前,优先基于元数据发现 API。
前提条件
- 准备遵循最小权限原则的 RAM AccessKey/STS 凭证。
- 变更前确认目标地域和直播域名范围。
- 使用只读 API(
Describe*/List*)查询当前状态,再调用Add*/Set*/Delete*。
工作流
- 确认目标直播域名、应用名称/流名称以及所需操作。
- 通过元数据和 API Explorer 查找 API 名称及所需参数。
- 执行只读验证调用。
- 制定回滚计划后执行变更操作。
- 将结果和上下文保存在
output/alicloud-media-live/下。
AccessKey 优先级
- 环境变量:
ALICLOUD_ACCESS_KEY_ID/ALICLOUD_ACCESS_KEY_SECRET/ALICLOUD_REGION_ID。 - 共享配置文件:
~/.alibabacloud/credentials。
如果地域不明确,请在执行写入操作前进行确认。
API 发现
- 产品代码:
live - 默认 API 版本:
2016-11-01 - 元数据来源:
https://api.aliyun.com/meta/v1/products/live/versions/2016-11-01/api-docs.json
最简可执行快速入门
python skills/media/live/alicloud-media-live/scripts/list_openapi_meta_apis.py
可选覆盖项:
python skills/media/live/alicloud-media-live/scripts/list_openapi_meta_apis.py \
--product-code live \
--version 2016-11-01 \
--output-dir output/alicloud-media-live
常见操作映射
- 域名管理:
AddLiveDomain、DeleteLiveDomain、DescribeLiveDomains - 流推送/播放鉴权:
AddLiveDomainMapping、SetLiveDomainStagingConfig - 录制/转码/模板:
AddLiveRecordTemplate、AddLiveTranscodeTemplate、DescribeLiveRecordConfig - 监控和指标:
DescribeLiveStreamOnlineList、DescribeLiveDomainBpsData、DescribeLiveDomainTrafficData - 流控制:
ForbidLiveStream、ResumeLiveStream、AddLiveAppRecordConfig
输出策略
将所有生成的文件和执行证据写入:
output/alicloud-media-live/
参考资料
- 来源列表:
references/sources.md - 任务模板:
references/templates.md
评论
支持 Markdown