全部產品
Search
文件中心

Intelligent Media Services:ListMediaInfoJobs

更新時間:Aug 05, 2026

查詢媒體資訊任務列表。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:ListMediaInfoJobs

*全部資源。

*

無 無

請求參數

名稱

類型

必填

描述

樣本值

StartOfCreateTime

string

否

任務建立時間篩選條件的起始時間。格式為:yyyy-MM-ddTHH:mm:ssZ。

2022-07-01T00:00:00Z

EndOfCreateTime

string

否

任務建立時間篩選條件的結束時間。格式為:yyyy-MM-ddTHH:mm:ssZ。

2022-07-15T00:00:00Z

JobId

string

否

按 jobId 篩選。

7b38a5d86f1e47838927b6e7ccb1****

Status

string

否

任務狀態。

Success

OrderBy

string

否

排序順序。目前只支援兩種:

CreateTimeDesc

PageSize

integer

否

分頁大小,預設值為 10。

10

NextPageToken

string

否

連續分頁查詢時下一頁的標記(第一頁沒有)。

ab4802364a2e49208c99efab82df****

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

請求 ID。

31E30781-9495-5E2D-A84D-759B0A01E262

Jobs

array<object>

媒體資訊任務清單。

array<object>

任務詳情。

Name

string

任務名稱。

job-name

TriggerSource

string

任務來源。

API

JobId

string

任務 ID。

ab4802364a2e49208c99efab82df****

Input

object

任務輸入。

Type

string

媒體物件類型。 取值:

  • OSS: OSS 檔案。

  • Media: 媒資 ID。

OSS

Media

string

媒體值:

  • type 為 OSS 時,為 URL, 支援 OSS 協議和 HTTP 協議;

  • type 為 Media 時,為媒資 ID。

oss://bucket/path/to/video.mp4

Async

boolean

是否非同步處理。

true

UserData

string

使用者資料。

user-data

ScheduleConfig

object

排程資訊。

PipelineId

string

管道 ID。

e37ebee5d98b4781897f6086e89f****

Priority

integer

任務優先順序。數字越大優先順序越高,取值範圍:1~10

5

Status

string

任務狀態。

Init

SubmitResultJson

object

任務提交資訊。

MediaInfoProperty

object

媒體資訊詳情。

FileBasicInfo

object

基礎檔案資訊。

MediaId

string

媒資 ID。

4765337007f571edbfdf81848c01****

FileName

string

檔案名稱。

file.m3u8

FileStatus

string

檔案狀態。

Normal

FileType

string

檔案類型。取值:

  • source_file:源檔案

  • transcode_file:轉碼檔案

source_file

FileSize

string

檔案大小。單位:Byte。

31737

FileUrl

string

檔案 URL。

http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8

Region

string

檔案所在地區。

cn-shanghai

FormatName

string

視頻格式名稱。

hls,applehttp

Duration

string

視頻時間長度(單位:秒)。

403.039999

Bitrate

string

視頻碼率。

888.563

Width

string

寬。

848

Height

string

高。

478

AudioStreamInfoList

array<object>

音頻流資訊。

object

音頻流資訊。

Index

string

流序號。

1

CodecName

string

編碼格式。

aac

CodecLongName

string

編碼格式名。

AAC (Advanced Audio Coding)

CodecTimeBase

string

編碼器時間基。

1/44100

CodecTagString

string

編碼器標籤名。

[15][0][0][0]

CodecTag

string

編碼器標籤。

0x000f

SampleFmt

string

採樣格式。

fltp

SampleRate

string

採樣率(單位:Hz)。

44100

Channels

string

聲道數。

2

ChannelLayout

string

聲道布局。

stereo

Timebase

string

時間基。

1/90000

StartTime

string

開始時間。

1.473556

Duration

string

時間長度(單位:秒)。

403.039989

Bitrate

string

碼率。

0.f

Lang

string

語言。

cn

VideoStreamInfoList

array<object>

視頻流資訊。

object

視頻流資訊。

Index

string

流序號。

0

Codec_name

string

編碼格式。

h264

Codec_long_name

string

編碼格式名。

H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10

Profile

string

編碼器預設。

High

Codec_time_base

string

編碼時基。

1/50

Codec_tag_string

string

編碼格式標記文本。

[27][0][0][0]

Codec_tag

string

編碼格式標記。

0x001b

Width

string

寬。

848

Height

string

高。

478

Has_b_frames

string

是否有 B 幀。 取值:

  • 0:沒有 B 幀,

  • 1:有一個 B 幀,

  • 2:有多個連續 B 幀。

2

Sar

string

採集點數寬高比。

478:477

Dar

string

映像顯示寬高比。

16:9

PixFmt

string

顏色儲存格式。

yuv420p

Level

string

編碼等級。

31

Fps

string

幀率。

25.0

Avg_fps

string

平均幀率。

25.0

Time_base

string

時基。

1/90000

Start_time

string

起始時間。

1.473556

Duration

string

時間長度(單位:秒)。

403.039989

Bit_rate

string

碼率。

888.563

NumFrames

string

總幀數。

10040

Lang

string

語言。

cn

Rotate

string

視頻畫面旋轉角度。

  • 取值 0, 90, 180, 270。

  • 預設值 0

0

SubmitTime

string

工作提交時間。格式為:yyyy-MM-ddTHH:mm:ssZ。

2022-01-12T08:49:41Z

FinishTime

string

工作完成時間。格式為:yyyy-MM-ddTHH:mm:ssZ。

2022-01-12T08:49:41Z

RequestId

string

請求 ID。

4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168

NextPageToken

string

下一頁識別碼,第一次提交時為空即可。下一頁識別碼將在第一次查詢後返回。

019daf5780f74831b0e1a767c9f1c178

樣本

正常返回樣本

JSON格式

{
  "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
  "Jobs": [
    {
      "Name": "job-name",
      "TriggerSource": "API",
      "JobId": "ab4802364a2e49208c99efab82df****",
      "Input": {
        "Type": "OSS",
        "Media": "oss://bucket/path/to/video.mp4"
      },
      "Async": true,
      "UserData": "user-data",
      "ScheduleConfig": {
        "PipelineId": "e37ebee5d98b4781897f6086e89f****",
        "Priority": 5
      },
      "Status": "Init",
      "SubmitResultJson": {
        "test": "test",
        "test2": 1
      },
      "MediaInfoProperty": {
        "FileBasicInfo": {
          "MediaId": "4765337007f571edbfdf81848c01****",
          "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": "cn"
          }
        ],
        "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": "cn",
            "Rotate": "0"
          }
        ]
      },
      "SubmitTime": "2022-01-12T08:49:41Z",
      "FinishTime": "2022-01-12T08:49:41Z",
      "RequestId": "4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168"
    }
  ],
  "NextPageToken": "019daf5780f74831b0e1a767c9f1c178"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情。