RefreshMediaPlayUrls
调用本接口通过音视频ID发起音视频刷新或预热任务
服务地址：
华东2（上海）
输入参数
只看必填
MediaIds需要刷新或预热的音/视频ID
TaskType提交的任务类型
Formats设置需要刷新或预热的播放流格式
Definitions设置需要刷新或预热的播放流清晰度
StreamType设置需要刷新或预热的播放流类型
ResultType设置刷新或预热的结果类型
SliceFlag设置是否刷新或预热M3U8播放流的TS...
请选择布尔值
SliceCount设置刷新或预热M3U8播放流的TS文件...
UserData自定义设置
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

  • 视频点播提供资源的刷新和预热功能，通过刷新功能，您可以删除 CDN 节点上已经缓存的资源，并强制 CDN 节点回源站获取最新资源；通过预热功能，您可以在业务高峰前预热热门资源，提前将热门资源下载并缓存到 CDN 节点，提高资源的访问效率。
  • 本接口直接通过音/视频 ID 发起刷新或预热任务，且支持筛选播放流格式及清晰度等，满足用户按需选择合适的播放流进行刷新预热的需求。
  • 最多支持一次发起 20 个音/视频的刷新或预热任务。

QPS 限制

本接口的单用户 QPS 限制为 50 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见 QPS 限制。

请求参数

字段名称字段详情
MediaIdsstring

需要刷新或预热的音/视频 ID。支持设置一个或多个，多个 ID 之前使用半角逗号（,）分隔，最多支持 20 个。展开详情

示例值:ca3a8f6e4957b658067095869****, a6e49sfgd23p5g9ja7095863****参考取值来源:
    RestoreMedia
    RegisterMedia
    BatchGetMediaInfos
    GetAIMediaAuditJob
    SearchMedia
    UpdateAttachedMediaInfos
    SubmitAIMediaAuditJob
    DescribeVodMediaPlayData
TaskTypestring

提交的任务类型。取值：展开详情

示例值:Preload
Formatsstring

设置需要刷新或预热的播放流格式。支持设置多个格式，多个格式之间使用半角逗号（,）分隔。若不设置，则默认刷新或预热所有格式的播放流。支持的格式如下：展开详情

示例值:mp4,m3u8
Definitionsstring

设置需要刷新或预热的播放流清晰度。支持设置多个清晰度，多个清晰度之间使用半角逗号（,）分隔。若不设置，则默认刷新或预热所有清晰度的播放流。展开详情

示例值:HD, SD
StreamTypestring

设置需要刷新或预热的播放流类型。支持设置多个播放流类型，多个播放流类型之间使用半角逗号（,）分隔。若不设置，则默认刷新或预热所有的播放流类型。取值：展开详情

示例值:video
ResultTypestring

设置刷新或预热的结果类型。取值：展开详情

示例值:Single
SliceFlagboolean

设置是否刷新或预热 M3U8 播放流的 TS 文件的播放链接。取值：展开详情

示例值:false
SliceCountinteger<int32>

设置刷新或预热 M3U8 播放流的 TS 文件播放链接的个数。每个 M3U8 播放流仅会刷新前 N 个 TS 文件的播放链接。取值范围为 1~20，默认值为 5。

示例值:5
UserDatastring

自定义设置。为 JSON 字符串，支持消息回调、上传加速等设置。更多信息，请参见 UserData 。展开详情

示例值:{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"}, "Extend":{"localId":"xxx","test":"www"}}

返回参数

字段名称字段详情
MediaRefreshJobIdstring

刷新或预热的任务 ID

示例值:41d465e31957****
NonExistMediaIdsstring

不存在的音/视频 ID 列表。

示例值:ca3a8f6e4957b658067095869****
ForbiddenMediaIdsstring

被禁止操作的音/视频 ID 列表，通常是由于没有多应用的权限而导致被禁止操作，更多信息，请参见多应用。

示例值:a6e49sfgd23p5g9ja7095863****
RequestIdstring

请求 ID。

示例值:25818875-5F78-4AF6-04D5-D7393642****
变更历史
暂无变更历史