Kueri pekerjaan analisis informasi media menggunakan QueryMediaInfoJobList - ApsaraVideo Media Processing - Alibaba Cloud - ApsaraVideo Media Processing

Mengkueri Pekerjaan analisis informasi media.

Deskripsi operasi

In asynchronous mode, media information can be queried only after a successful Message Service (MNS) callback is received for the SubmitMediaInfoJob operation. If the media information cannot be queried after a long period, the media information analysis job may have failed.
You can query a maximum of 10 media information analysis jobs at a time.
By default, the returned results are sorted by CreationTime in descending order.

QPS limits

The queries per second (QPS) limit for this API operation is 100 per user. API calls that exceed this limit are subject to rate limiting, which may affect your business. Plan your API calls accordingly. For more information, see QPS limits.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

mts:QueryMediaInfoJobList

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
MediaInfoJobIds	string	Yes	ID Pekerjaan analisis informasi media. Anda dapat mengkueri hingga 10 Pekerjaan sekaligus. Pisahkan beberapa ID Pekerjaan dengan koma (,). Anda dapat memperoleh ID Pekerjaan dari parameter tanggapan Operasi API SubmitMediaInfoJob. Catatan Jika Anda tidak menentukan parameter ini, kode kesalahan InvalidParameter akan dikembalikan.	23ca1d184c0e4341e5b665e2a12****

Elemen respons

Element	Type	Description	Example
	object
NonExistMediaInfoJobIds	object
String	array	The media information analysis jobs that do not exist.
	string	A list of IDs of the media information analysis jobs that do not exist. This parameter is not returned if no data is available.	11ce1d184c0e4341e5b665e2a12****
RequestId	string	The request ID.	46A04AA5-B119-41BB-B750-7C5327AC3E7A
MediaInfoJobList	object
MediaInfoJob	array<object>	The list of media information analysis jobs.
	array<object>
CreationTime	string	The time when the job was created.	2014-01-10T12:00:00Z
State	string	The status of the job. Analyzing: The job is being run. Success: The job is successful. Fail: The job fails.	Success
JobId	string	The ID of the job.	23ca1d184c0e4341e5b665e2a12****
UserData	string	The custom data.	testid-001
Code	string	The error code returned if the job fails.	InvalidParameter.JsonObjectFormatInvalid
Message	string	The error message returned if the job fails.	The parameter ”*” does not conform to the JSON Object specification
PipelineId	string	The ID of the MPS queue.	88c6ca184c0e432bbf5b665e2a15****
Async	boolean	Indicates whether the job is in asynchronous mode.	true
Input	object	The information about the job input.
Object	string	The name of the Object Storage Service (OSS) object that is used as the input file.	example.mp4
Location	string	The ID of the OSS region.	oss-cn-hangzhou
Bucket	string	The OSS bucket in which the input file is stored.	example-bucket
MNSMessageResult	object	The message sent by MNS to notify you of the job result.
MessageId	string	The ID of the message returned if the job was successful. This parameter is not returned if the job fails.	123
ErrorMessage	string	The error message returned if the job failed. This parameter is not returned if the job is successful.	The parameter \"Input\" does not conform to the JSON Object specification
ErrorCode	string	The error code returned if the job failed. This parameter is not returned if the job is successful.	InvalidParameter.JsonObjectFormatInvalid
Properties	object	The information about the input file. For more information, see AliyunProperties.
Width	string	The width of the video. Unit: pixel.	1280
Height	string	The height of the video. Unit: pixel.	720
Duration	string	The duration of the media file.	17.226000
Fps	string	The frame rate of the media file.	25
Bitrate	string	The bitrate of the media file.	1630.045
FileFormat	string	The format of the input media file.	QuickTime/MOV
Streams	object	The media streams that are contained in the input media file.
VideoStreamList	object
VideoStream	array<object>	The information about each video stream.
	array<object>
Sar	string	The sample aspect ratio (SAR).	1:1
Height	string	The height of the video stream in pixels.	1080
CodecTagString	string	The tag string of the encoding format.	[0][0][0][0]
NetworkCost	object	The network bandwidth that is consumed.
PreloadTime	string	The time consumed to preload the video.	8
AvgBitrate	string	The average bitrate of the video stream.	300.34
CostBandwidth	string	The maximum bandwidth that is consumed.	10
Width	string	The width of the video in pixels.	1920
Index	string	The sequence number of the video stream. The value indicates the position of the video stream in all video streams.	1
Timebase	string	The time base.	1/1000
AvgFPS	string	The average frame rate.	23.976025
PixFmt	string	The pixel format.	yuv420p
Lang	string	The language.	eng
CodecLongName	string	The full name of the encoding format.	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10
NumFrames	string	The total number of frames.	100
Rotate	string	The rotation angle of the video.	180
Bitrate	string	The bitrate of the media file.	30541090
HasBFrames	string	Indicates whether the video stream contains bidirectional frames (B-frames). A value of 1 indicates that the video stream contains B-frames. A value of 0 indicates that the video stream does not contain B-frames.	0
Profile	string	The codec profile.	High
StartTime	string	The start time.	0.042000
Dar	string	The display aspect ratio (DAR).	16:9
CodecName	string	The short name of the encoding format. Valid values: h264 h265 gif webp	h264
Duration	string	The duration of the media file.	100
Fps	string	The frame rate of the media file.	25
CodecTag	string	The tag of the encoding format.	0x0000
CodecTimeBase	string	The codec time base.	1001/48000
Level	string	The codec level.	41
ColorRange	string	The color range.	700
ColorTransfer	string	The color channel.	R255 G83 B170
ColorPrimaries	string	The level of color reconstruction.	700
DurationInaccurate	string
DolbyVision	object
Profile	string
Level	string
AudioStreamList	object
AudioStream	array<object>	The information about each audio stream.
	object
Timebase	string	The time base.	1/1000
Index	string	The sequence number of the audio stream. The value indicates the position of the audio stream in all audio streams.	1
SampleFmt	string	The sampling format.	fltp
ChannelLayout	string	The number of sound channels.	5.1(side)
Lang	string	The language. For more information, see FFmpeg documentation.	eng
Samplerate	string	The sampling rate.	48000
CodecLongName	string	The full name of the encoding format.	DCA (DTS Coherent Acoustics)
Channels	string	The output layout of the sound channels.	2
NumFrames	string	The total number of frames.	123
Bitrate	string	The bitrate of the media file.	1536000
CodecTagString	string	The tag string of the encoding format.	[0][0][0][0]
StartTime	string	The start time.	0.042000
CodecName	string	The short name of the encoding format. Valid values: acc mp3 mp4 ogg flac	acc
Duration	string	The duration of the media file.	123
CodecTag	string	The tag of the encoding format.	0x0000
CodecTimeBase	string	The codec time base.	1/48000
DurationInaccurate	string
SubtitleStreamList	object
SubtitleStream	array<object>	The information about each subtitle stream.
	object
Timebase	string	The time base.	1/1000
Index	string	The sequence number of the subtitle stream. The value indicates the position of the subtitle stream in all subtitle streams.	3
StartTime	string	The start time.	0.000000
CodecName	string	The short name of the encoding format. Valid values: srt ass	ass
Lang	string	The language.	eng
CodecLongName	string	The full name of the encoding format.	ASS (Advanced SSA) subtitle
Duration	string	The duration. Unit: seconds.	1370.116000
CodecTag	string	The tag of the encoding format.	0x0000
CodecTimeBase	string	The codec time base.	0/1
CodecTagString	string	The tag string of the encoding format.	[0][0][0][0]
Format	object	The format information.
StartTime	string	The start time.	0.042000
NumPrograms	string	The total number of program streams.	2
Size	string	The size of the image file.	3509895
NumStreams	string	The total number of media streams.	1
FormatLongName	string	The full name of the container format.	QuickTime/MOV
Duration	string	The total duration.	17.226000
Bitrate	string	The total bitrate.	1630.045
FormatName	string	The short name of the container format.	mov
Tags	object
FileSize	string	The size of the image file.	3509895
FileMd5	string

format Paket callback.

Ketika status eksekusi Pekerjaan analisis informasi media berubah, ApsaraVideo Media Processing (MPS) mengirimkan Paket ke Antrian yang Anda tentukan. Untuk informasi tentang cara menentukan Antrian callback, lihat Operasi API UpdatePipeline. Isi Paket adalah string JSON yang berisi bidang berikut:

{
  "Type": "MediaInfo",
  "State": "Success",
  "JobId": "bb558c1cc25b45309aab5be44d19****",
  "UserData": "{\"key\":\"value\"}",
  "RequestId": "B52658D4-07AB-43CD-82B0-210958A6****"
}
```.

| Nama     | Tipe   | Deskripsi                                                                                    |
| -------- | ------ | ---------------------------------------------------------------------------------------------- |
| Type     | String | String tetap "MediaInfo", yang menunjukkan Pekerjaan analisis informasi media.                |
| JobId    | String | ID unik Pekerjaan.                                                                      |
| State    | String | Status Pekerjaan saat ini. Sama dengan parameter State di QueryMediaInfoJobList. |
| UserData | String | UserData yang Anda berikan di SubmitMediaInfoJob.                                              |.

Contoh

Respons sukses

JSONformat

{
  "NonExistMediaInfoJobIds": {
    "String": [
      "11ce1d184c0e4341e5b665e2a12****"
    ]
  },
  "RequestId": "46A04AA5-B119-41BB-B750-7C5327AC3E7A",
  "MediaInfoJobList": {
    "MediaInfoJob": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "State": "Success",
        "JobId": "23ca1d184c0e4341e5b665e2a12****",
        "UserData": "testid-001",
        "Code": "InvalidParameter.JsonObjectFormatInvalid",
        "Message": "The parameter ”*” does not conform to the JSON Object specification",
        "PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
        "Async": true,
        "Input": {
          "Object": "example.mp4",
          "Location": "oss-cn-hangzhou",
          "Bucket": "example-bucket"
        },
        "MNSMessageResult": {
          "MessageId": "123",
          "ErrorMessage": "The parameter \\\"Input\\\" does not conform to the JSON Object specification",
          "ErrorCode": "InvalidParameter.JsonObjectFormatInvalid"
        },
        "Properties": {
          "Width": "1280",
          "Height": "720",
          "Duration": "17.226000",
          "Fps": "25",
          "Bitrate": "1630.045",
          "FileFormat": "QuickTime/MOV",
          "Streams": {
            "VideoStreamList": {
              "VideoStream": [
                {
                  "Sar": "1:1",
                  "Height": "1080",
                  "CodecTagString": "[0][0][0][0]",
                  "NetworkCost": {
                    "PreloadTime": "8",
                    "AvgBitrate": "300.34",
                    "CostBandwidth": "10"
                  },
                  "Width": "1920",
                  "Index": "1",
                  "Timebase": "1/1000",
                  "AvgFPS": "23.976025",
                  "PixFmt": "yuv420p",
                  "Lang": "eng",
                  "CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
                  "NumFrames": "100",
                  "Rotate": "180",
                  "Bitrate": "30541090",
                  "HasBFrames": "0",
                  "Profile": "High",
                  "StartTime": "0.042000",
                  "Dar": "16:9",
                  "CodecName": "h264",
                  "Duration": "100",
                  "Fps": "25",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "1001/48000",
                  "Level": "41",
                  "ColorRange": "700",
                  "ColorTransfer": "R255 G83 B170",
                  "ColorPrimaries": "700",
                  "DurationInaccurate": "",
                  "DolbyVision": {
                    "Profile": "",
                    "Level": ""
                  }
                }
              ]
            },
            "AudioStreamList": {
              "AudioStream": [
                {
                  "Timebase": "1/1000",
                  "Index": "1",
                  "SampleFmt": "fltp",
                  "ChannelLayout": "5.1(side)",
                  "Lang": "eng",
                  "Samplerate": "48000",
                  "CodecLongName": "DCA (DTS Coherent Acoustics)",
                  "Channels": "2",
                  "NumFrames": "123",
                  "Bitrate": "1536000",
                  "CodecTagString": "[0][0][0][0]",
                  "StartTime": "0.042000",
                  "CodecName": "acc",
                  "Duration": "123",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "1/48000",
                  "DurationInaccurate": ""
                }
              ]
            },
            "SubtitleStreamList": {
              "SubtitleStream": [
                {
                  "Timebase": "1/1000",
                  "Index": "3",
                  "StartTime": "0.000000",
                  "CodecName": "ass",
                  "Lang": "eng",
                  "CodecLongName": "ASS (Advanced SSA) subtitle",
                  "Duration": "1370.116000",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "0/1",
                  "CodecTagString": "[0][0][0][0]"
                }
              ]
            }
          },
          "Format": {
            "StartTime": "0.042000",
            "NumPrograms": "2",
            "Size": "3509895",
            "NumStreams": "1",
            "FormatLongName": "QuickTime/MOV",
            "Duration": "17.226000",
            "Bitrate": "1630.045",
            "FormatName": "mov",
            "Tags": {
              "test": "test",
              "test2": 1
            }
          },
          "FileSize": "3509895",
          "FileMd5": ""
        }
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.