RefreshMediaPlayUrls - 提交音视频刷新或预热任务

调用RefreshMediaPlayUrls通过音视频ID发起音视频刷新或预热任务。

接口说明

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

QPS 限制

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

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
vod:RefreshMediaPlayUrlsWrite
  • 全部资源
    *

请求参数

名称类型必填描述示例值
MediaIdsstring

需要刷新或预热的音/视频 ID。支持设置一个或多个,多个 ID 之前使用半角逗号(,)分隔,最多支持 20 个。 音/视频 ID 可通过以下方式获取:

  • 通过控制台上传的音/视频,可登录点播控制台,选择媒资库 > 音/视频查看音/视频 ID。
  • 通过获取音视频上传地址和凭证接口获取上传地址和凭证时,音/视频 ID 为返回参数 VideoId 的值。
  • 音/视频上传后,可通过搜索媒体信息接口查询音/视频 ID,为请求后返回参数 VideoId 的值。
ca3a8f6e4957b658067095869****, a6e49sfgd23p5g9ja7095863****
TaskTypestring

提交的任务类型。取值:

  • Refresh:刷新
  • Preload:预热
Preload
Formatsstring

设置需要刷新或预热的播放流格式。支持设置多个格式,多个格式之间使用半角逗号(,)分隔。若不设置,则默认刷新或预热所有格式的播放流。支持的格式如下:

  • mp4
  • m3u8
  • mp3
  • flv
  • webm
  • ts
mp4,m3u8
Definitionsstring

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

说明 取值必须为媒资参数说明清晰度:Definition所定义的取值。
HD, SD
StreamTypestring

设置需要刷新或预热的播放流类型。支持设置多个播放流类型,多个播放流类型之间使用半角逗号(,)分隔。若不设置,则默认刷新或预热所有的播放流类型。取值:

  • video:视频
  • audio:音频
video
ResultTypestring

设置刷新或预热的结果类型。取值:

  • Single(默认):每种清晰度和格式只刷新或预热一路最新转码完成的流。
  • Multiple:每种清晰度和格式刷新或预热所有转码完成的流。
Single
SliceFlagboolean

设置是否刷新或预热 M3U8 播放流的 TS 文件的播放链接。取值:

  • false(默认):否
  • true:是
false
SliceCountinteger

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

5
UserDatastring

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

说明
  • 此参数中消息回调的使用前提是需要在控制台配置 HTTP 回调地址和勾选对应的回调事件类型才能使用,否则回调设置不生效。控制台配置 HTTP 回调的操作,请参见回调设置
  • 如需使用上传加速功能,请提交工单申请开通,更多信息,请参见上传相关说明。关于如何提交工单,请参见联系我们
  • {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"}, "Extend":{"localId":"xxx","test":"www"}}

    返回参数

    名称类型描述示例值
    object

    返回结果。

    MediaRefreshJobIdstring

    刷新或预热的任务 ID

    41d465e31957****
    NonExistMediaIdsstring

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

    ca3a8f6e4957b658067095869****
    ForbiddenMediaIdsstring

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

    a6e49sfgd23p5g9ja7095863****
    RequestIdstring

    请求 ID。

    25818875-5F78-4AF6-04D5-D7393642****

    示例

    正常返回示例

    JSON格式

    {
      "MediaRefreshJobId": "41d465e31957****",
      "NonExistMediaIds": "ca3a8f6e4957b658067095869****",
      "ForbiddenMediaIds": "a6e49sfgd23p5g9ja7095863****",
      "RequestId": "25818875-5F78-4AF6-04D5-D7393642****"
    }

    错误码

    访问错误中心查看更多错误码。

    变更历史

    变更时间变更内容概要操作
    2022-03-31新增 OpenAPI查看变更详情