SubmitSnapshotJob_媒体处理_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
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
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 输入单个文件大小最大支持 100 GB,超过可能导致执行失败。

  • 请确认文件已成功上传至 OSS 后再提交截图作业,否则会导致执行失败。您可通过配置 OSS 回调消息确认文件上传状态。

  • 截图作业分为同步和异步模式。

    • 同步模式仅支持单张截图,会在接口返回时生成图片。
    • 异步模式不保证时效性,在提交截图作业后,任务会添加到管道中排队,被调度执行。所以在接口返回时,不保证截图已经生成。执行完成后需要调用查询截图作业结果接口轮询执行结果,或通过为管道绑定 MNS 消息接收执行结果,具体请参见接收消息通知
    • 只要设置了 IntervalNum 中的任何一个参数,就表示使用异步模式。
  • 目前仅支持生成 JPG 格式图片。

  • 更多截图常见问题,请参见截图常见问题

QPS 限制

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

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
mts:SubmitSnapshotJob
Create
全部资源
*

请求参数

字段名称字段详情
Inputstring

作业输入。详细说明请参见 Input 详情展开详情

示例值:{"Bucket":"example-bucket","Location":"example-location","Object":"example%2Ftest.flv"}
SnapshotConfigstring

截图配置。详细说明,请参见 SnapshotConfig 参数详情

示例值:{"OutputFile":{"Bucket":"example-001","Location":"example-location","Object":"{Count}.jpg"},"Time":"5","Num":"10","Interval":"20"}参考取值来源:
    QuerySnapshotJobList
UserDatastring

用户自定义数据。支持中英文、数字、短划线(-),不能以特殊字符开头,最大长度 1024 个字节。

示例值:testid-001
PipelineIdstring

管道 ID,详细说明,请参见基本概念展开详情

示例值:dd3dae411e704030b921e52698e5****

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:19B6D8C5-A5DD-467A-B435-29D393C71E2D
SnapshotJobobject

截图作业。

返回示例

变更历史

变更时间变更内容概要操作
2024-04-24
删除返回参数
2024-04-10
新增返回参数

相关示例

提交截图作业接口
2022-02-08