SearchMedia - 搜索媒体信息

根据用户所提供参数,返回符合条件的媒资信息。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

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

过滤条件,支持以下字段搜索

  • fullText 全文(支持标题、描述、标签tag)
  • title 标题
  • description 描述
  • mediaId 媒资id
  • tags 打标
  • cateId 分类
  • status 状态(int)
  • userId 用户id(int)
  • utcCreate 创建时间(int)
  • utcModified 修改时间(int)
  • fileInfo.storageLocation 位置

status枚举

  • INIT(0, "Init"),
  • PREPARING(1, "Preparing"),
  • PREPARE_FAIL(2, "PrepareFail"),
  • NORMAL(3, "Normal"),
  • UPLOADING(10, "Uploading"),
  • UPLOADED(12, "UploadSucc"),
  • ENCODING(13, "Transcoding"),
  • ENCODE_FAILED(14, "TranscodeFail"),
  • CHECKING(15, "Checking"),
  • BLOCKED(16, "Blocked"),
  • DELETED(17, "Deleted"),
  • UPLOAD_FAIL(18, "UploadFail"),
fullText = 'test-1' and title = '中国' and mediaId == 'id' and utcCreate = ('1','2')
SortBystring

排序字段和排序顺序。多个使用英文逗号(,)分隔。

utcCreate:Desc, utcModified:Desc
PageNointeger

当前页码。默认值为1。

1
PageSizeinteger

每页返回的数据条数。默认值为10,最大值为50。

20
EntityIdstring

实体ID。

2d3bf1e35a1e42b5ab338d701efa7603

返回参数

名称类型描述示例值
object

Schema of Response。

RequestIdstring

请求ID。

6F61C357-ACC0-57FB-876E-D58795335E59
Successstring

是否成功。

True
Codestring

返回码。

200
MediaInfoListarray

符合要求的媒资集合。

object

媒资信息列表。

MediaIdstring

媒资ID。

3b187b3620c8490886cfc2a9578c3ce6
MediaBasicInfoobject

媒资基础信息。

MediaIdstring

媒资ID。

132bd600fc3c71ec99476732a78f6402
InputURLstring

待注册的媒资在相应系统中的地址。

oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf84981650248140427
MediaTypestring

媒资媒体类型。

video
BusinessTypestring

媒资业务类型。

opening
Sourcestring

来源。

oss
Titlestring

标题。

智能横屏转竖屏
Descriptionstring

内容描述。

对这个视频进行转码处理了
Categorystring

分类。

image
MediaTagsstring

标签。

tags,tags2
CoverURLstring

封面地址。

https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/e694372e-4f5b-4821-ae09-efd064f27b63_large_cover_url.jpg
UserDatastring

用户数据。

userData
Snapshotsstring

截图。

[{"bucket":"example-bucket","count":"3","iceJobId":"******f48f0e4154976b2b8c45******","location":"oss-cn-beijing","snapshotRegular":"example.jpg","templateId":"******e6a6440b29eb60bd7c******"}]
Statusstring

资源状态。

Normal
TranscodeStatusstring

转码状态。

Init
CreateTimestring

媒资创建时间。

2020-12-01T19:48Z
ModifiedTimestring

媒资修改时间。

2020-12-01T19:48Z
DeletedTimestring

媒资删除时间。

2020-12-01T19:48Z
SpriteImagesstring

雪碧图。

[{"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"}]
CateIdLong

分类ID。

44
Bizstring

媒资所属业务。

IMS
UploadSourcestring

上传资源。

general
CateNamestring

分类名称。

子分类1
ReferenceIdstring

自定义ID,仅支持小写字母、大写字母、数字、横线、下划线,长度6-64位。用户维度唯一。

123-123
FileInfoListarray

FileInfos。

object

fileinfo列表。

FileBasicInfoobject

文件基础信息,包含时长,大小等。

FileNamestring

文件名。

164265080291300080527050.wav
FileStatusstring

文件状态。

Normal
FileTypestring

文件类型。

source_file
FileSizestring

文件大小(字节)。

324784
FileUrlstring

文件OSS地址。

https://outin-d3f4681ddfd911ec99a600163e1403e7.oss-cn-shanghai.aliyuncs.com/sv/23d5cdd1-18180984899/23d5cdd1-18180984899.mp4
Regionstring

文件存储区域。

cn-beijing
FormatNamestring

封装格式。

mov,mp4,m4a,3gp,3g2,mj2
Durationstring

时长。

60.00000
Bitratestring

码率。

1912.13
Widthstring

宽。

1920
Heightstring

高。

480
CreateTimestring

创建时间。

2022-05-30T02:02:17Z
ModifiedTimestring

最后修改时间。

2021-12-10T12:19Z
TotalLong

符合条件的媒资总数。

163

示例

正常返回示例

JSON格式

{
  "RequestId": "6F61C357-ACC0-57FB-876E-D58795335E59",
  "Success": "True",
  "Code": "200",
  "MediaInfoList": [
    {
      "MediaId": "3b187b3620c8490886cfc2a9578c3ce6",
      "MediaBasicInfo": {
        "MediaId": "132bd600fc3c71ec99476732a78f6402",
        "InputURL": "oss://clipres/longvideo/material/voice/prod/20220418/07d7c799f6054dc3bbef250854cf84981650248140427",
        "MediaType": "video",
        "BusinessType": "opening",
        "Source": "oss",
        "Title": "智能横屏转竖屏",
        "Description": "对这个视频进行转码处理了",
        "Category": "image",
        "MediaTags": "tags,tags2\n",
        "CoverURL": "https://dtlive-bj.oss-cn-beijing.aliyuncs.com/cover/e694372e-4f5b-4821-ae09-efd064f27b63_large_cover_url.jpg",
        "UserData": "userData",
        "Snapshots": "[{\"bucket\":\"example-bucket\",\"count\":\"3\",\"iceJobId\":\"******f48f0e4154976b2b8c45******\",\"location\":\"oss-cn-beijing\",\"snapshotRegular\":\"example.jpg\",\"templateId\":\"******e6a6440b29eb60bd7c******\"}]",
        "Status": "Normal",
        "TranscodeStatus": "Init",
        "CreateTime": "2020-12-01T19:48Z",
        "ModifiedTime": "2020-12-01T19:48Z\n",
        "DeletedTime": "2020-12-01T19:48Z\n",
        "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\"}]",
        "CateId": 44,
        "Biz": "IMS",
        "UploadSource": "general",
        "CateName": "子分类1",
        "ReferenceId": "123-123"
      },
      "FileInfoList": [
        {
          "FileBasicInfo": {
            "FileName": "164265080291300080527050.wav",
            "FileStatus": "Normal",
            "FileType": "source_file",
            "FileSize": "324784",
            "FileUrl": "https://outin-d3f4681ddfd911ec99a600163e1403e7.oss-cn-shanghai.aliyuncs.com/sv/23d5cdd1-18180984899/23d5cdd1-18180984899.mp4",
            "Region": "cn-beijing",
            "FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
            "Duration": "60.00000\n",
            "Bitrate": "1912.13\n",
            "Width": "1920",
            "Height": "480",
            "CreateTime": "2022-05-30T02:02:17Z",
            "ModifiedTime": "2021-12-10T12:19Z"
          }
        }
      ]
    }
  ],
  "Total": 163
}

错误码

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

阿里云首页 智能媒体生产 相关技术圈