提交媒体信息异步任务。
接口说明
您可以调用本接口,通过回调或者再次查询的方式,对输入的文件进行媒体分析,适用于时效性需求相对较弱,或并发量高的场景。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
ice:SubmitMediaInfoJob |
|
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Name | string | 否 | 任务名字。 | job-name |
Input | object | 是 | 任务输入。 | |
Type | string | 是 | 媒体对象类型 - OSS: oss 文件, Media: 媒资 ID | OSS |
Media | string | 是 | 媒体值:
说明
URL 中的 OSS bucket 需要先添加到 IMS存储管理后再使用。
| oss://bucket/path/to/video.mp4 |
UserData | string | 否 | 用户数据。 | user-data |
ScheduleConfig | object | 否 | 调度参数。 | |
PipelineId | string | 否 | 管道 ID。 | e37ebee5d98b4781897f6086e89f9c56 |
Priority | integer | 否 | 任务优先级。数字越大优先级越高,取值范围:1~10 | 5 |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
"MediaInfoJob": {
"Name": "job-name",
"TriggerSource": "API",
"JobId": "ab4802364a2e49208c99efab82dfa8e8",
"Input": {
"Type": "OSS",
"Media": "oss://bucket/path/to/video.mp4"
},
"Async": true,
"UserData": "user-data",
"ScheduleConfig": {
"PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
"Priority": 5
},
"Status": "Init",
"SubmitResultJson": {},
"MediaInfoProperty": {
"FileBasicInfo": {
"MediaId": "2b36bd19c13f4145b094c0cad80dbce5",
"FileName": "file.m3u8",
"FileStatus": "Normal",
"FileType": "source_file",
"FileSize": "31737",
"FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
"Region": "cn-shanghai",
"FormatName": "hls,applehttp",
"Duration": "403.039999",
"Bitrate": "888.563",
"Width": "848",
"Height": "478"
},
"AudioStreamInfoList": [
{
"Index": "1",
"CodecName": "aac",
"CodecLongName": "AAC (Advanced Audio Coding)",
"CodecTimeBase": "1/44100",
"CodecTagString": "[15][0][0][0]",
"CodecTag": "0x000f",
"SampleFmt": "fltp",
"SampleRate": "44100",
"Channels": "2",
"ChannelLayout": "stereo",
"Timebase": "1/90000",
"StartTime": "1.473556",
"Duration": "403.039989",
"Bitrate": "0.f",
"Lang": "us"
}
],
"VideoStreamInfoList": [
{
"Index": "0",
"Codec_name": "h264",
"Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"Profile": "High",
"Codec_time_base": "1/50",
"Codec_tag_string": "[27][0][0][0]",
"Codec_tag": "0x001b",
"Width": "848",
"Height": "478",
"Has_b_frames": "2",
"Sar": "478:477",
"Dar": "16:9",
"PixFmt": "yuv420p",
"Level": "31",
"Fps": "25.0",
"Avg_fps": "25.0",
"Time_base": "1/90000",
"Start_time": "1.473556",
"Duration": "403.039989",
"Bit_rate": "888.563",
"NumFrames": "10040",
"Lang": "zh",
"Rotate": "0"
}
]
},
"SubmitTime": "2022-01-12T08:49:41Z",
"FinishTime": "2022-01-12T08:49:41Z",
"RequestId": "4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168"
}
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2022-08-10 | API 内部配置变更,不影响调用 | 查看变更详情 |
2022-07-11 | 新增 OpenAPI | 查看变更详情 |