AddVodTemplate - 添加截图模板

调用AddVodTemplate添加截图模板。

接口说明

说明
  • 添加截图模板后,可通过提交截图预处理接口传递截图模板ID发起截图任务。
  • 您可以通过HTTP回调(兼容HTTPS)、MNS回调两种方式来接收截图完成回调消息。具体详情,请参见回调方式
  • 调试

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

    调试

    授权信息

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

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

      请求参数

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

      模板名称。

      • 长度不超过128个字节。
      • UTF-8编码。
      test
      TemplateTypestring

      模板类型。取固定值:Snapshot

      Snapshot
      TemplateConfigstring

      截图模板配置数据(JSON格式)。数据结构详情,请参见SnapshotTemplateConfig

      {"SnapshotConfig":{"Count":10,"SpecifiedOffsetTime":0,"Interval":1},"SnapshotType":"NormalSnapshot"}
      AppIdstring

      应用ID。默认取值app-1000000。使用说明,请参见多应用

      app-****

      返回参数

      名称类型描述示例值
      object
      VodTemplateIdstring

      截图模板ID。可使用提交媒体截图发起截图处理。

      f5b228fe6930e*****0d6bf55bd87789
      RequestIdstring

      请求ID。

      25818875-5F78-4A*****F6-D7393642CA58

      示例

      请求示例

      https://vod.{ApiRegion}.aliyuncs.com/?Action=AddVodTemplate
      &Name=test
      &TemplateConfig={"SnapshotConfig":{"Count":10,"SpecifiedOffsetTime":0,"Interval":1},"SnapshotType":"NormalSnapshot"}
      &TemplateType=Snapshot
      &<公共请求参数>
      

      正常返回示例

      JSON格式

       {
          "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
          "VodTemplateId":"f5b228fe6930e*****0d6bf55bd87789"
       }

      XML格式

      <AddVodTemplateResponse>
          <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
      	<VodTemplateId>f5b228fe6930e*****0d6bf55bd87789</VodTemplateId>
      </AddVodTemplateResponse>

      错误码

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

      阿里云首页 视频点播 相关技术圈