GetTranscodeSummary - - Alibaba Cloud Documentation Center

Mengambil ringkasan transkoding file media berdasarkan ID file. Ringkasan tersebut mencakup status dan progres transkoding media.

Catatan penggunaan

File media dapat ditranskode beberapa kali. Operasi ini hanya mengembalikan ringkasan transkoding terbaru.
Anda dapat mengambil ringkasan transkoding hingga maksimal 10 file media dalam satu permintaan.
Anda dapat memanggil operasi ListTranscodeTask untuk mengambil informasi tugas transkoding historis.
Operasi ini hanya dapat digunakan untuk mengambil informasi tugas transkoding yang dibuat dalam satu tahun terakhir.

Batas QPS

Anda dapat memanggil operasi ini hingga 15 kali per detik per akun. Permintaan yang melebihi batas ini akan dijatuhkan dan dapat menyebabkan gangguan layanan. Pastikan Anda mematuhi batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS pada Operasi API di ApsaraVideo VOD.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan, kami menyarankan Anda memanggil operasi ini melalui OpenAPI Explorer, yang secara dinamis menghasilkan contoh kode untuk berbagai SDK.

Parameter permintaan

Parameter

Type

Wajib

Contoh

Deskripsi

Action

String

Yes

GetTranscodeSummary

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke GetTranscodeSummary.

VideoIds

String

Yes

"d4860fcc6ae9fed52e8938244****,e1db68cc586644b83e562bcd94****,hhhhhhh"

ID file audio atau video. Anda dapat menentukan hingga 10 ID. Pisahkan ID dengan koma (,). Anda dapat memperoleh ID dengan salah satu metode berikut:

Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Media Files > Audio/Video. Di halaman Video dan Audio, lihat ID file audio atau video tersebut. Metode ini berlaku untuk file yang diunggah melalui Konsol ApsaraVideo VOD.
Ambil nilai VideoId dari respons operasi CreateUploadVideo yang Anda panggil untuk mendapatkan URL unggah dan kredensial.
Ambil nilai VideoId dengan memanggil operasi SearchMedia. Metode ini berlaku untuk file yang telah diunggah.

Parameter respons

Parameter	Type	Contoh	Deskripsi
RequestId	String	25818875-5F78-4A*****F6-D7393642CA58	ID permintaan.
NonExistVideoIds	Array of String	["hhhhhhh"]	ID file audio atau video yang tidak ada.
TranscodeSummaryList	Array of TranscodeSummary		Ringkasan transkoding file.
CreationTime	String	2019-01-23T12:35:12Z	Waktu pembuatan tugas transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
VideoId	String	e1db68cc586644b83e562bcd94****	ID file audio atau video.
CompleteTime	String	2019-01-23T12:40:12Z	Waktu penyelesaian tugas transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
TranscodeStatus	String	Processing	Status tugas transkoding. Nilai yang valid: Processing: Sedang berlangsung. Partial: Sebagian pekerjaan transkoding telah selesai. CompleteAllSucc: Semua pekerjaan transkoding berhasil. CompleteAllFail: Semua pekerjaan transkoding gagal. Jika terjadi pengecualian pada file sumber, tidak ada pekerjaan transkoding yang dimulai dan tugas transkoding gagal. CompletePartialSucc: Semua pekerjaan transkoding telah selesai tetapi hanya sebagian yang berhasil.
TranscodeTemplateGroupId	String	44f9e406bbb*****736a9abe876ecc0	ID kelompok template transkoding.
TranscodeJobInfoSummaryList	Array of TranscodeJobInfoSummary		Ringkasan pekerjaan transkoding.
CreationTime	String	2019-02-27T03:34:46Z	Waktu pembuatan pekerjaan transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
ErrorMessage	String	ErrorMessage	Pesan kesalahan yang dikembalikan ketika pekerjaan transkoding gagal.
Height	String	960	Tinggi video output. Satuan: piksel.
TranscodeProgress	Long	100	Progres transkoding. Nilai yang valid: `[0,100]`.
TranscodeTemplateId	String	57496724ae2*****0968d6e08acc8f6	ID template transkoding.
Bitrate	String	749	Bitrate rata-rata video output. Satuan: Kbit/s.
ErrorCode	String	200	Kode kesalahan yang dikembalikan ketika pekerjaan transkoding gagal.
CompleteTime	String	2019-02-27T03:40:51Z	Waktu penyelesaian pekerjaan transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.
Width	String	544	Lebar video output. Satuan: piksel.
Duration	String	12	Durasi video output. Satuan: detik.
Fps	String	30	Laju frame video output. Satuan: frame per detik.
TranscodeJobStatus	String	Transcoding	Status pekerjaan transkoding. Nilai yang valid: Transcoding TranscodeSuccess TranscodeFail
FileSize	Long	1144259	Ukuran video output. Satuan: byte.
Format	String	mp4	Format kontainer video output.
WatermarkIdList	Array of String	["af2afe4761992c*****d947dae97337"]	ID watermark yang diterapkan pada video output.

Contoh

Permintaan Contoh

https://vod.{ApiRegion}.aliyuncs.com/?Action=GetTranscodeSummary
&VideoIds="d4860fcc6a*****e9fed52e893824,e1db68cc58664*****4b83e562bcd9,hhhhhhh"
&<Common request parameters>

Respons Contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<GetTranscodeSummaryResponse>
<RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
	<TranscodeSummaryList>
		<VideoId>e1db68cc58664*****4b83e562bcd9</VideoId>
		<TranscodeStatus>Processing</TranscodeStatus>
		<TranscodeTemplateGroupId>44f9e406bbb*****736a9abe876ecc0</TranscodeTemplateGroupId>
		<CreationTime>2019-01-23T12:35:12Z</CreationTime>
		<CompleteTime>2019-01-23T12:40:12Z</CompleteTime>
		<TranscodeJobInfoSummaryList>
			<Format>mp4</Format>
			<Encryption>{}</Encryption>
			<TranscodeProgress>100</TranscodeProgress>
			<Height>960</Height>
			<CreationTime>2019-02-27T03:34:46Z</CreationTime>
			<CompleteTime>2019-02-27T03:40:51Z</CompleteTime>
			<TranscodeJobStatus>TranscodeSuccess</TranscodeJobStatus>
			<Filesize>1144259</Filesize>
			<WatermarkIdList>af2afe4761992c*****d947dae97337</WatermarkIdList>
			<Duration>12</Duration>
			<TranscodeTemplateId>57496724ae2*****0968d6e08acc8f6</TranscodeTemplateId>
			<Width>544</Width>
			<Fps>30</Fps>
			<Bitrate>749</Bitrate>
			<Definition>LD</Definition>
		</TranscodeJobInfoSummaryList>
		<TranscodeJobInfoSummaryList>
			<Format>m3u8</Format>
			<Encryption>{&quot;EncryptType&quot;:&quot;AliyunVoDEncryption&quot;}</Encryption>
			<TranscodeProgress>100</TranscodeProgress>
			<Height>640</Height>
			<CreationTime>2019-02-27T03:34:46Z</CreationTime>
			<CompleteTime>2019-02-27T03:40:50Z</CompleteTime>
			<TranscodeJobStatus>TranscodeSuccess</TranscodeJobStatus>
			<Filesize>759520</Filesize>
			<Duration>12</Duration>
			<TranscodeTemplateId>4733b3a55b27*****82dae36ac22d34</TranscodeTemplateId>
			<Width>360</Width>
			<Fps>25</Fps>
			<Bitrate>499</Bitrate>
			<Definition>LD</Definition>
		</TranscodeJobInfoSummaryList>
	</TranscodeSummaryList>
	<NonExistVideoIds>hhhhhhh</NonExistVideoIds>
</GetTranscodeSummaryResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "25818875-5F78-4A*****F6-D7393642CA58",
  "TranscodeSummaryList" : [ {
    "VideoId" : "e1db68cc58664*****4b83e562bcd9",
    "TranscodeStatus" : "Processing",
    "TranscodeTemplateGroupId" : "44f9e406bbb*****736a9abe876ecc0",
    "CreationTime" : "2019-01-23T12:35:12Z",
    "CompleteTime" : "2019-01-23T12:40:12Z",
    "TranscodeJobInfoSummaryList" : [ {
      "Format" : "mp4",
      "Encryption" : "{}",
      "TranscodeProgress" : 100,
      "Height" : "960",
      "CreationTime" : "2019-02-27T03:34:46Z",
      "CompleteTime" : "2019-02-27T03:40:51Z",
      "TranscodeJobStatus" : "TranscodeSuccess",
      "Filesize" : 1144259,
      "WatermarkIdList" : [ "af2afe4761992c*****d947dae97337" ],
      "Duration" : "12",
      "TranscodeTemplateId" : "57496724ae2*****0968d6e08acc8f6",
      "Width" : "544",
      "Fps" : "30",
      "Bitrate" : "749",
      "Definition" : "LD"
    }, {
      "Format" : "m3u8",
      "Encryption" : "{\"EncryptType\":\"AliyunVoDEncryption\"}",
      "TranscodeProgress" : 100,
      "Height" : "640",
      "CreationTime" : "2019-02-27T03:34:46Z",
      "CompleteTime" : "2019-02-27T03:40:50Z",
      "TranscodeJobStatus" : "TranscodeSuccess",
      "Filesize" : 759520,
      "Duration" : "12",
      "TranscodeTemplateId" : "4733b3a55b27*****82dae36ac22d34",
      "Width" : "360",
      "Fps" : "25",
      "Bitrate" : "499",
      "Definition" : "LD"
    } ]
  } ],
  "NonExistVideoIds" : [ "hhhhhhh" ]
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.