调用SubmitSnapshotJob接口提交截图作业。

说明 目前仅支持生成jpg格式图片。
  • 异步模式:不保证接口返回时截图已经生成,截图任务将进入后台排队,异步执行截图。只要设置了IntervalNum中的任何一个参数,就表示异步模式。
  • 消息通知:提交截图作业时,PipelineId参数必填,只有在管道上指定了回调信息,完成后才会发送异步消息。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String SubmitSnapshotJob

操作接口名,系统规定参数,取值: SubmitSnapshotJob

Input String {"Bucket":"example-bucket", "Location":"oss-cn-hangzhou","Object":"example.flv"}

作业输入,JSON对象。

说明 需在控制台中授予此Bucket权限给媒体转码服务。详情参见添加媒体Bucket
SnapshotConfig String {"OutputFile":{"Bucket":"example-001","Location":"oss-cn-hangzhou","Object":"{Count}.jpg"},"Time":"5","Num":"10","Interval":"20"}

截图配置。详情参见SnapshotConfig参数详情

UserData String testid-001

用户自定义数据。最大长度1024个字节。

PipelineId String dd3dae411e704030b921e52698e5****

管道ID。

说明 必须保证此管道绑定了可用的消息主题,否则消息无法正确发送。

返回数据

名称 类型 示例值 描述
RequestId String 19B6D8C5-A5DD-467A-B435-29D393C7****

请求ID。

SnapshotJob Object

截图作业。

CreationTime String 2021-05-19T03:11:48Z

任务创建时间。

SnapshotConfig Object

截图配置。

Time String 4

截图开始时间。单位:毫秒。

TileOut Object

拼图配置。

Padding String 0

图片间距。

  • 默认:0
  • 单位:px。
Color String black

背景颜色。

  • 取值范围:颜色关键字random
  • 默认:black
  • 其中颜色关键字支持三种格式,比如黑色,支持Black,black,#000000。
CellSelStep String 3

选取单图片步长。

CellHeight String 100

单图片高度。默认截图输出分辨率高度。

CellWidth String 100

单图片宽度。默认截图输出分辨率宽度。

Margin String 5

外框宽度。

  • 默认:0
  • 单位:px。
Columns String 10

图片拼合列数。

  • 整型。
  • 取值范围:(0,10000]
  • 默认:10
IsKeepCellPic String false

是否保留单图片。

  • 取值:true(保留)、false(不保留)。
  • 默认:true
Lines String 10

图片拼合行数。

  • 整型。
  • 取值范围:(0,10000]
  • 默认:10
Interval String 10

截图间隔时间。

  • 若指定则表示序列截图,且值必须大于0。
  • 单位:秒。
  • 默认值:10
FrameType String intra

截图类型。

  • normal:普通帧。
  • intra:I帧。
  • 默认值:intra
Width String 8

截图输出图片宽度。取值范围:[8,4096]

Height String 8

截图输出图片高度。取值范围:[8,4096]

OutputFile Object

截图输出OSS配置。

RoleArn String acs:ram::1:role/testrole

指定角色的ARN。格式:acs:ram::$accountID:role/$roleName。

Object String example.png

截图输出文件(OSS Object)。

Location String oss-cn-hangzhou

截图输出OSS Bucket所在数据中心(OSS Location)。

Bucket String example-001

截图输出文件所在OSS Bucket。

Num String 10

截图数量。若指定则表示序列截图。

TileOutputFile Object

拼图任务大图的输出OSS配置。

RoleArn String acs:ram::1:role/testrole

指定角色的ARN。格式:acs:ram::$accountID:role/$roleName。

Object String example.png

输出文件 (OSS Object)。

Location String oss-cn-hangzhou

输出OSS Bucket所在数据中心(OSS Location)。

Bucket String example-001

输出文件所在OSS Bucket。

State String Snapshoting

截图状态。取值:

  • Submitted:已提交。
  • Snapshoting:截图中。
  • Success:截图成功。
  • Fail:截图失败。
Message String The resource operated InputFile is bad

分析失败时错误信息。

MNSMessageResult Object

MNS通知用户作业完成的结果。

MessageId String 799454621135656C7F815F198A76****

成功时消息ID。

ErrorMessage String The resource operated InputFile is bad

失败时错误信息。

ErrorCode String InvalidParameter

失败时错误码。

Input Object

作业输入。

RoleArn String acs:ram::1:role/testrole

指定角色的ARN。格式:acs:ram::$accountID:role/$roleName。

Object String example.flv

输入文件(OSS Object)。进行UrlEncode,使用UTF-8编码,遵守OSS Object定义,最大1024字节。

Location String oss-cn-hangzhou

输入OSS Bucket所在数据中心(OSS Location),最大64字节。

Bucket String example-001

输入文件所在OSS Bucket。遵守OSS Bucket定义,只能包括小写字母,数字和短横线(-),必须以小写字母或者数字开头,长度必须在3-255字节之间。

Count String 1

截取图片的数量。

TileCount String 5

拼图图片数量。

UserData String testid-001

用户自定义数据。

Code String ResourceContentBad

分析失败时错误码。

PipelineId String dd3dae411e704030b921e52698e5****

管道ID。

Id String f4e3b9ba9f3840c39d6e288056f0****

截图作业ID。

示例

请求示例

http(s)://[Endpoint]/?Action=SubmitSnapshotJob
&Input={"Bucket":"example-bucket", "Location":"oss-cn-hangzhou","Object":"example.flv" }
&SnapshotConfig={"OutputFile": {"Bucket": "example-001","Location":"oss-cn-hangzhou","Object": "{Count}.jpg"},"Time":"5","Num":"10","Interval":"20"}
&UserData=testid-001
&PipelineId=dd3dae411e704030b921e52698e5****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<SubmitSnapshotJobResponse>
    <RequestId>19B6D8C5-A5DD-467A-B435-29D393C7****</RequestId>
    <SnapshotJob>
        <CreationTime>2021-05-19T03:11:48Z</CreationTime>
        <SnapshotConfig>
            <Time>4</Time>
            <TileOut>
                <Padding>0</Padding>
                <Color>black</Color>
                <CellSelStep>3</CellSelStep>
                <CellHeight>100</CellHeight>
                <CellWidth>100</CellWidth>
                <Margin>5</Margin>
                <Columns>10</Columns>
                <IsKeepCellPic>false</IsKeepCellPic>
                <Lines>10</Lines>
            </TileOut>
            <Interval>10</Interval>
            <FrameType>intra</FrameType>
            <Width>8</Width>
            <Height>8</Height>
            <OutputFile>
                <RoleArn>acs:ram::1:role/testrole</RoleArn>
                <Object>example.png</Object>
                <Location>oss-cn-hangzhou</Location>
                <Bucket>example-001</Bucket>
            </OutputFile>
            <Num>10</Num>
            <TileOutputFile>
                <RoleArn>acs:ram::1:role/testrole</RoleArn>
                <Object>example.png</Object>
                <Location>oss-cn-hangzhou</Location>
                <Bucket>example-001</Bucket>
            </TileOutputFile>
        </SnapshotConfig>
        <State>Snapshoting</State>
        <Message>The resource operated InputFile is bad</Message>
        <MNSMessageResult>
            <MessageId>799454621135656C7F815F198A76****</MessageId>
            <ErrorMessage>The resource operated InputFile is bad</ErrorMessage>
            <ErrorCode>InvalidParameter</ErrorCode>
        </MNSMessageResult>
        <Input>
            <RoleArn>acs:ram::1:role/testrole</RoleArn>
            <Object>example.flv</Object>
            <Location>oss-cn-hangzhou</Location>
            <Bucket>example-001</Bucket>
        </Input>
        <Count>1</Count>
        <TileCount>5</TileCount>
        <UserData>testid-001</UserData>
        <Code>ResourceContentBad</Code>
        <PipelineId>dd3dae411e704030b921e52698e5****</PipelineId>
        <Id>f4e3b9ba9f3840c39d6e288056f0****</Id>
    </SnapshotJob>
</SubmitSnapshotJobResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "19B6D8C5-A5DD-467A-B435-29D393C7****",
  "SnapshotJob" : {
    "CreationTime" : "2021-05-19T03:11:48Z",
    "SnapshotConfig" : {
      "Time" : "4",
      "TileOut" : {
        "Padding" : "0",
        "Color" : "black",
        "CellSelStep" : "3",
        "CellHeight" : "100",
        "CellWidth" : "100",
        "Margin" : "5",
        "Columns" : "10",
        "IsKeepCellPic" : "false",
        "Lines" : "10"
      },
      "Interval" : "10",
      "FrameType" : "intra",
      "Width" : "8",
      "Height" : "8",
      "OutputFile" : {
        "RoleArn" : "acs:ram::1:role/testrole",
        "Object" : "example.png",
        "Location" : "oss-cn-hangzhou",
        "Bucket" : "example-001"
      },
      "Num" : "10",
      "TileOutputFile" : {
        "RoleArn" : "acs:ram::1:role/testrole",
        "Object" : "example.png",
        "Location" : "oss-cn-hangzhou",
        "Bucket" : "example-001"
      }
    },
    "State" : "Snapshoting",
    "Message" : "The resource operated InputFile is bad",
    "MNSMessageResult" : {
      "MessageId" : "799454621135656C7F815F198A76****",
      "ErrorMessage" : "The resource operated InputFile is bad",
      "ErrorCode" : "InvalidParameter"
    },
    "Input" : {
      "RoleArn" : "acs:ram::1:role/testrole",
      "Object" : "example.flv",
      "Location" : "oss-cn-hangzhou",
      "Bucket" : "example-001"
    },
    "Count" : "1",
    "TileCount" : "5",
    "UserData" : "testid-001",
    "Code" : "ResourceContentBad",
    "PipelineId" : "dd3dae411e704030b921e52698e5****",
    "Id" : "f4e3b9ba9f3840c39d6e288056f0****"
  }
}

错误码

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