调用BatchGetMediaInfos获取多个MediaId的媒资信息-智能媒体服务-阿里云-智能媒体服务(IMS)-阿里云帮助中心

批量获取媒资信息，支持传入多个mediaId。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ice:BatchGetMediaInfos

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
MediaIds	string	否	所有待查询的媒资 ID，以逗号分隔。	****b48fb04483915d4f2cd8**,**c48fb37407365d4f2cd8****
AdditionType	string	否	批量查询的媒资额外信息，默认只返回 BasicInfo，额外文件信息内容包括： -FileInfo -DynamicMetaData	FileInfo,DynamicMetaData
AuthTimeout	integer	否	鉴权过期时间，单位：秒。最小值：1。最大值：86400。默认值：3600。	30

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	****11-DB8D-4A9A-875B-275798****
MediaInfos	array<object>	符合要求的媒资集合。
	array<object>	符合要求的媒资集合。
MediaId	string	媒资 ID。	****c48fb37407365d4f2cd8****
MediaBasicInfo	object	媒资基础信息。
MediaId	string	媒资 ID。	****c48fb37407365d4f2cd8****
InputURL	string	待注册的媒资在相应系统中的地址。	https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4
MediaType	string	媒资媒体类型。取值为： Image。 Video。 Audio。 Text。	video
BusinessType	string	媒资业务类型。	general
Source	string	来源。取值为： OSS。 vod。	oss
Title	string	标题。	title
Description	string	内容描述。	description
Category	string	分类。	category1
MediaTags	string	标签。	tag1, tag2
CoverURL	string	封面地址。	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=
UserData	string	用户数据。	userDataTest
Snapshots	string	截图。	[ "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=", "http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=" ]
Status	string	资源状态。	Normal
TranscodeStatus	string	转码状态。	Init
CreateTime	string	媒资创建时间。	2020-12-26T04:11:10Z
ModifiedTime	string	媒资修改时间。	2020-12-26T04:11:12Z
DeletedTime	string	媒资删除时间。	2020-12-26T04:11:10Z
SpriteImages	string	雪碧图。	[{"bucket":"example-bucket","count":"32","iceJobId":"****83ec44d58b2069def2e**","location":"oss-cn-shanghai","snapshotRegular":"example/example-{Count}.jpg","spriteRegular":"example/example-{TileCount}.jpg","templateId":"**e438b14ff39293eaec25****","tileCount":"1"}]
Biz	string	媒资所属业务。	ICE
FileInfoList	array<object>	文件基础信息列表。
	array<object>	文件基础信息。
FileBasicInfo	object	文件基础信息，包含时长，大小等。
FileName	string	文件名。	example
FileStatus	string	文件状态。	Normal
FileType	string	文件类型。	source_file
FileSize	string	文件大小（字节）。	30611502
FileUrl	string	文件 OSS 地址。	http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=
Region	string	文件存储区域。	cn-shanghai
FormatName	string	封装格式。	mov,mp4,m4a,3gp,3g2,mj2
Duration	string	时长。	200
Bitrate	string	码率。	1132.68
Width	string	宽。	1920
Height	string	高。	1080
AudioStreamInfoList	array<object>	音频流信息，一个媒资可能有多条音频流
	object
Index	string	音频流序号
CodecName	string	编码格式简述名
CodecLongName	string	编码格式长述名
CodecTimeBase	string	编码时基
CodecTagString	string	编码格式标记文本
CodecTag	string	编码格式标记
Profile	string	编码预置
SampleFmt	string	采样格式
SampleRate	string	采样率
Channels	string	声道数
ChannelLayout	string	声道输出样式
Timebase	string	时基
StartTime	string	起始时间
Duration	string	时长
Bitrate	string	码率
Fps	string	音频帧率
NumFrames	string	总帧数
Lang	string	语言
VideoStreamInfoList	array<object>	视频流信息，一个媒资可能有多条视频流
	object
Index	string	视频流序号
CodecName	string	编码格式简述名
CodecLongName	string	编码格式长述名
Profile	string	编码预置
CodecTimeBase	string	编码时基
CodecTagString	string	编码格式标记文本
CodecTag	string	编码格式标记
Width	string	宽
Height	string	高
HasBFrames	string	是否有 B 帧
Sar	string	编码信号分辨率比
Dar	string	编码显示分辨率比
PixFmt	string	像素格式
Level	string	编码等级
Fps	string	视频帧率
AvgFPS	string	平均帧率
Timebase	string	时基
StartTime	string	起始时间
Duration	string	时长
Bitrate	string	码率
NumFrames	string	总帧数
Lang	string	语言
Rotate	string	旋转
Nb_frames	string	总帧数
SubtitleStreamInfoList	array<object>	字幕流信息，一个媒资可能有多条字幕流
	object
Index	string	音频流序号
CodecName	string	编码格式简述名
CodecLongName	string	编码格式长述名
CodecTimeBase	string	编码时基
CodecTagString	string	编码格式标记文本
CodecTag	string	编码格式标记
Timebase	string	时基
StartTime	string	起始时间
Duration	string	时长
Lang	string	语言
MediaDynamicInfo	object	媒资类型。
DynamicMetaData	object	类型。取值范围： "ai": AI 原始结果统一化处理后的 AI 数据 "user-defined": 用户自定义元数据 "system": 系统自带
Data	string	媒资类型。	system
IgnoredList	array	获取失败的媒资信息列表。
	string	媒资信息。	**20b48fb04483915d4f2cd8ac**

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaInfos": [
    {
      "MediaId": "******c48fb37407365d4f2cd8******",
      "MediaBasicInfo": {
        "MediaId": "******c48fb37407365d4f2cd8******",
        "InputURL": "https://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4",
        "MediaType": "video",
        "BusinessType": "general",
        "Source": "oss",
        "Title": "title",
        "Description": "description",
        "Category": "category1",
        "MediaTags": "tag1, tag2",
        "CoverURL": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.png?Expires=&OSSAccessKeyId=&Signature=&security-token=",
        "UserData": "userDataTest",
        "Snapshots": "[\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00001.png?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00002.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\",\n    \"http://example-bucket.oss-cn-shanghai.aliyuncs.com/snapshot-00003.jpg?Expires=&OSSAccessKeyId=&Signature=&security-token=\"\n]",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-26T04:11:10Z",
        "ModifiedTime": "2020-12-26T04:11:12Z",
        "DeletedTime": "2020-12-26T04:11:10Z",
        "SpriteImages": "[{\"bucket\":\"example-bucket\",\"count\":\"32\",\"iceJobId\":\"******83ec44d58b2069def2e******\",\"location\":\"oss-cn-shanghai\",\"snapshotRegular\":\"example/example-{Count}.jpg\",\"spriteRegular\":\"example/example-{TileCount}.jpg\",\"templateId\":\"******e438b14ff39293eaec25******\",\"tileCount\":\"1\"}]",
        "Biz": "ICE"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "example",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "30611502",
            "FileUrl": "http://example-bucket.oss-cn-shanghai.aliyuncs.com/example.mp4?Expires=&OSSAccessKeyId=&Signature=&security-token=",
            "Region": "cn-shanghai",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "200",
            "Bitrate": "1132.68",
            "Width": "1920",
            "Height": "1080"
          },
          "AudioStreamInfoList": [
            {
              "Index": "",
              "CodecName": "",
              "CodecLongName": "",
              "CodecTimeBase": "",
              "CodecTagString": "",
              "CodecTag": "",
              "Profile": "",
              "SampleFmt": "",
              "SampleRate": "",
              "Channels": "",
              "ChannelLayout": "",
              "Timebase": "",
              "StartTime": "",
              "Duration": "",
              "Bitrate": "",
              "Fps": "",
              "NumFrames": "",
              "Lang": ""
            }
          ],
          "VideoStreamInfoList": [
            {
              "Index": "",
              "CodecName": "",
              "CodecLongName": "",
              "Profile": "",
              "CodecTimeBase": "",
              "CodecTagString": "",
              "CodecTag": "",
              "Width": "",
              "Height": "",
              "HasBFrames": "",
              "Sar": "",
              "Dar": "",
              "PixFmt": "",
              "Level": "",
              "Fps": "",
              "AvgFPS": "",
              "Timebase": "",
              "StartTime": "",
              "Duration": "",
              "Bitrate": "",
              "NumFrames": "",
              "Lang": "",
              "Rotate": "",
              "Nb_frames": ""
            }
          ],
          "SubtitleStreamInfoList": [
            {
              "Index": "",
              "CodecName": "",
              "CodecLongName": "",
              "CodecTimeBase": "",
              "CodecTagString": "",
              "CodecTag": "",
              "Timebase": "",
              "StartTime": "",
              "Duration": "",
              "Lang": ""
            }
          ]
        }
      ],
      "MediaDynamicInfo": {
        "DynamicMetaData": {
          "Data": "system"
        }
      }
    }
  ],
  "IgnoredList": [
    "****20b48fb04483915d4f2cd8ac****"
  ]
}

错误码

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

变更历史

更多信息，参考变更详情。