GetTranscodeTask - ApsaraVideo VOD

Mengkueri detail pekerjaan transkoding berdasarkan ID tugas transkoding.

Deskripsi operasi

Operasi ini hanya dapat digunakan untuk mengkueri tugas transkoding yang dibuat dalam satu tahun terakhir.

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

vod:GetTranscodeTask

get

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
TranscodeTaskId	string	No	ID tugas transkoding. Anda dapat memperoleh ID ini dengan salah satu cara berikut: Ambil nilai TranscodeTaskId dari respons operasi SubmitTranscodeJobs. Ambil nilai TranscodeTaskId dari respons operasi ListTranscodeTask.	b1b65ab107e14*****3dbb900f6c1fe0
JobIds	string	No	ID pekerjaan transkoding. Mendukung hingga 10 ID, dan beberapa ID harus dipisahkan dengan koma (,). Anda dapat memperoleh nilai ini dengan cara berikut: Saat memulai tugas transkoding melalui antarmuka SubmitTranscodeJobs, nilai ini adalah parameter JobId yang dikembalikan.	86c1925fba0**,7afb201e7fa,2cc4997378**

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	F4C6D5BE-BF13-45*****6C-516EA8906DCD
NonExistJobIds	array	ID pekerjaan yang tidak ada.
	string	ID pekerjaan yang tidak ada.	["hhhhhhh"]
TranscodeJobInfoList	array<object>	Daftar informasi pekerjaan transkoding.
	array<object>
Definition	string	Jenis kejernihan dan kualitas audio didefinisikan sebagai berikut: SD: Standard Definition. HD: High Definition. FHD: Full High Definition. OD: Original Definition. 2K: 2K. 4K: 4K. SQ: Standard Audio Quality. HQ: High Audio Quality. AUTO: Adaptive Bitrate. Ini hanya tersedia jika templat transkoding dikonfigurasi dengan pengaturan packaging. Untuk detail selengkapnya, lihat Konfigurasi Templat Transkoding - Pengaturan Package. Catatan Nilai ini merepresentasikan label kejernihan yang dikonfigurasi dalam templat transkoding dan tidak menunjukkan rentang resolusi aktual dari file output transkoding.	LD
CreationTime	string	Waktu pembuatan pekerjaan transkoding. Formatnya adalah yyyy-MM-dd'T'HH:mm:ssZ (waktu UTC).	2019-02-26T08:27:16Z
InputFileUrl	string	Alamat OSS dari file sumber untuk transkoding.	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*47f38e/31f1184c-***b2a2-f94-c213f.wmv
ErrorMessage	string	Pesan kesalahan yang dikembalikan.	ErrorMessage
ErrorCode	string	Kode kesalahan.	200
CompleteTime	string	Waktu penyelesaian pekerjaan transkoding. Formatnya adalah yyyy-MM-dd'T'HH:mm:ssZ (waktu UTC).	2019-02-26T08:30:16Z
TranscodeProgress	integer	Progres pemrosesan pekerjaan transkoding. Rentang nilainya [0, 100].	80
Priority	string	Prioritas tugas transkoding.	6
TranscodeJobStatus	string	Status pekerjaan transkoding: Transcoding: Sedang dalam proses transkoding. TranscodeSuccess: Transkoding berhasil. TranscodeFail: Transkoding gagal.	Transcoding
TranscodeTemplateId	string	ID templat yang digunakan untuk pekerjaan transkoding.	174b0534fea3*****b51c8f0ad1374
TranscodeJobId	string	ID pekerjaan transkoding.	38f0e513c88*****85515f9d50be188
OutputFile	object	Informasi tentang file output hasil transkoding.
VideoStreamList	string	Daftar aliran video.	[{\"AvgFPS\":\"30.0\",\"Bitrate\":\"933.814\",\"CodecLongName\":\"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10\",\"CodecName\":\"h264\",\"CodecTag\":\"0x31637661\",\"CodecTagString\":\"avc1\",\"CodecTimeBase\":\"1/60\",\"Dar\":\"9:16\",\"Duration\":\"12.033333\",\"Fps\":\"30.0\",\"HasBFrames\":\"2\",\"Height\":\"360\",\"Index\":\"0\",\"Lang\":\"und\",\"Level\":\"30\",\"PixFmt\":\"yuv420p\",\"Profile\":\"High\",\"Sar\":\"81:256\",\"StartTime\":\"0.000000\",\"Timebase\":\"1/15360\",\"Width\":\"640\"}]
OutputFileUrl	string	Alamat OSS dari file output hasil transkoding.	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*f20aaa352f/c3be4f073***7d5193ec8-{DestMd5}-od-S00000001-200000.mp4
Encryption	string	Konfigurasi enkripsi yang digunakan untuk file output hasil transkoding. Nilai-nilai: AliyunVoDEncryption: Enkripsi Video Alibaba Cloud (enkripsi privat). HLSEncryption: Enkripsi standar HLS.	{\"EncryptType\":\"AliyunVoDEncryption\"}
Height	string	Tinggi frame video dalam file output hasil transkoding. Satuan: piksel (px).	360
SubtitleStreamList	string	Daftar aliran subtitle.	[]
Bitrate	string	Bitrate rata-rata dari file output hasil transkoding. Satuan: Kbps.	964
AudioStreamList	string	Daftar aliran audio.	"AudioStreamList": "[{\"Bitrate\":\"64.533\",\"ChannelLayout\":\"stereo\",\"Channels\":\"2\",\"CodecLongName\":\"AAC (Advanced Audio Coding)\",\"CodecName\":\"aac\",\"CodecTag\":\"0x6134706d\",\"CodecTagString\":\"mp4a\",\"CodecTimeBase\":\"1/44100\",\"Duration\":\"12.615533\",\"Index\":\"1\",\"Lang\":\"und\",\"SampleFmt\":\"fltp\",\"Samplerate\":\"44100\",\"StartTime\":\"-0.046440\",\"Timebase\":\"1/44100\"}]
Width	string	Lebar frame video dalam file output hasil transkoding. Satuan: piksel (px).	640
Fps	string	Laju frame dari file output hasil transkoding. Satuan: frame per detik (fps).	25
Duration	string	Durasi file output hasil transkoding. Satuan: detik (s).	12
Format	string	Format kontainer dari file output hasil transkoding.	m3u8
Filesize	integer	Ukuran file output hasil transkoding. Satuan: byte (B).	851076
WatermarkIdList	array	Daftar watermark yang digunakan untuk transkoding.
	string	Daftar watermark yang digunakan untuk transkoding.	["64079a0e3e286*****b48a8c9413"]
TranscodeTask	object	Detail tentang tugas transkoding.
CreationTime	string	Waktu pembuatan tugas transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.	2019-01-23T12:35:12Z
Trigger	string	Mode pemicu tugas transkoding. Nilai yang valid: Auto: Tugas transkoding dipicu secara otomatis saat video diunggah. Manual: Tugas transkoding dipicu dengan memanggil operasi SubmitTranscodeJobs.	Auto
TaskStatus	string	Status tugas transkoding. Nilai yang valid: Processing: Sedang berlangsung. Partial: Beberapa 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 selesai tetapi hanya sebagian yang berhasil.	Processing
VideoId	string	ID file audio atau video.	883f5d98107*****b7f20aaa352f
CompleteTime	string	Waktu penyelesaian tugas transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.	2019-01-23T12:40:12Z
TranscodeTemplateGroupId	string	ID kelompok template transkoding.	b500c7094bd241*****3e9900752d7c3
TranscodeTaskId	string	ID tugas transkoding.	b1b65ab107e14*****3dbb900f6c1fe0
TranscodeJobInfoList	array<object>	Detail tentang pekerjaan transkoding.
	array<object>
Definition	string	Resolusi video. Nilai yang valid: LD: definisi rendah SD: definisi standar HD: definisi tinggi FHD: ultra definisi tinggi OD: definisi asli 2K: 2K 4K: 4K SQ: kualitas suara standar HQ: kualitas suara tinggi AUTO: bitrate adaptif Aliran bitrate adaptif hanya dikembalikan jika PackageSetting diatur dalam templat transkoding. Untuk informasi selengkapnya, lihat Struktur dasar. Catatan Parameter ini menunjukkan definisi yang dikonfigurasi dalam templat transkoding dan tidak menunjukkan resolusi aktual dari video output.	LD
CreationTime	string	Waktu pembuatan pekerjaan transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.	2019-02-26T08:27:16Z
InputFileUrl	string	URL Object Storage Service (OSS) dari file input.	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*47f38e/31f1184c-***b2a2-f94-c213f.wmv
ErrorMessage	string	Pesan kesalahan yang dikembalikan ketika pekerjaan transkoding gagal.	ErrorMessage
ErrorCode	string	Kode kesalahan yang dikembalikan ketika pekerjaan transkoding gagal.	200
CompleteTime	string	Waktu penyelesaian pekerjaan transkoding. Waktu mengikuti standar ISO 8601 dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.	2019-02-26T08:30:16Z
TranscodeProgress	integer	Progres pekerjaan transkoding. Nilai yang valid: `[0,100]`.	100
Priority	string	Prioritas pekerjaan transkoding.	6
TranscodeJobStatus	string	Status pekerjaan transkoding. Transcoding TranscodeSuccess TranscodeFail	Transcoding
TranscodeTemplateId	string	ID templat transkoding.	174b0534fea3*****b51c8f0ad1374
TranscodeJobId	string	ID pekerjaan transkoding.	38f0e513c88*****85515f9d50be188
OutputFile	object	Informasi tentang file output.
VideoStreamList	string	Aliran video.	[{\"AvgFPS\":\"30.0\",\"Bitrate\":\"933.814\",\"CodecLongName\":\"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10\",\"CodecName\":\"h264\",\"CodecTag\":\"0x31637661\",\"CodecTagString\":\"avc1\",\"CodecTimeBase\":\"1/60\",\"Dar\":\"9:16\",\"Duration\":\"12.033333\",\"Fps\":\"30.0\",\"HasBFrames\":\"2\",\"Height\":\"360\",\"Index\":\"0\",\"Lang\":\"und\",\"Level\":\"30\",\"PixFmt\":\"yuv420p\",\"Profile\":\"High\",\"Sar\":\"81:256\",\"StartTime\":\"0.000000\",\"Timebase\":\"1/15360\",\"Width\":\"640\"}]
OutputFileUrl	string	URL OSS dari file output.	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*f20aaa352f/c3be4f073***7d5193ec8-{DestMd5}-od-S00000001-200000.mp4
Encryption	string	Metode enkripsi file output. Nilai yang valid: AliyunVoDEncryption: Enkripsi privat Alibaba Cloud HLSEncryption: Enkripsi HTTP Live Streaming (HLS)	{\"EncryptType\":\"AliyunVoDEncryption\"}
Height	string	Tinggi video output. Satuan: piksel.	360
SubtitleStreamList	string	Aliran subtitle.	[]
Bitrate	string	Bitrate rata-rata file output. Satuan: Kbit/s.	964
AudioStreamList	string	Aliran audio.	"AudioStreamList": "[{\"Bitrate\":\"64.533\",\"ChannelLayout\":\"stereo\",\"Channels\":\"2\",\"CodecLongName\":\"AAC (Advanced Audio Coding)\",\"CodecName\":\"aac\",\"CodecTag\":\"0x6134706d\",\"CodecTagString\":\"mp4a\",\"CodecTimeBase\":\"1/44100\",\"Duration\":\"12.615533\",\"Index\":\"1\",\"Lang\":\"und\",\"SampleFmt\":\"fltp\",\"Samplerate\":\"44100\",\"StartTime\":\"-0.046440\",\"Timebase\":\"1/44100\"}]
Width	string	Lebar video output. Satuan: piksel.	640
Fps	string	Laju frame file output. Satuan: frame per detik.	25
Duration	string	Panjang file output. Satuan: detik.	12
Format	string	Format kontainer file output.	m3u8
Filesize	integer	Ukuran file output. Satuan: byte.	851076
WatermarkIdList	array	ID watermark yang digunakan oleh file output.
	string	ID watermark yang digunakan oleh file output.	["64079a0e3e286*****b48a8c9413"]

Contoh

Respons sukses

JSONformat

{
  "RequestId": "F4C6D5BE-BF13-45*****6C-516EA8906DCD",
  "NonExistJobIds": [
    "[\"hhhhhhh\"]"
  ],
  "TranscodeJobInfoList": [
    {
      "Definition": "LD",
      "CreationTime": "2019-02-26T08:27:16Z",
      "InputFileUrl": "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*****47f38e/31f1184c-*****b2a2-f94-c213f.wmv",
      "ErrorMessage": "ErrorMessage",
      "ErrorCode": "200",
      "CompleteTime": "2019-02-26T08:30:16Z\n",
      "TranscodeProgress": 80,
      "Priority": "6",
      "TranscodeJobStatus": "Transcoding",
      "TranscodeTemplateId": "174b0534fea3*****b51c8f0ad1374",
      "TranscodeJobId": "38f0e513c88*****85515f9d50be188",
      "OutputFile": {
        "VideoStreamList": "[{\\\"AvgFPS\\\":\\\"30.0\\\",\\\"Bitrate\\\":\\\"933.814\\\",\\\"CodecLongName\\\":\\\"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10\\\",\\\"CodecName\\\":\\\"h264\\\",\\\"CodecTag\\\":\\\"0x31637661\\\",\\\"CodecTagString\\\":\\\"avc1\\\",\\\"CodecTimeBase\\\":\\\"1/60\\\",\\\"Dar\\\":\\\"9:16\\\",\\\"Duration\\\":\\\"12.033333\\\",\\\"Fps\\\":\\\"30.0\\\",\\\"HasBFrames\\\":\\\"2\\\",\\\"Height\\\":\\\"360\\\",\\\"Index\\\":\\\"0\\\",\\\"Lang\\\":\\\"und\\\",\\\"Level\\\":\\\"30\\\",\\\"PixFmt\\\":\\\"yuv420p\\\",\\\"Profile\\\":\\\"High\\\",\\\"Sar\\\":\\\"81:256\\\",\\\"StartTime\\\":\\\"0.000000\\\",\\\"Timebase\\\":\\\"1/15360\\\",\\\"Width\\\":\\\"640\\\"}]",
        "OutputFileUrl": "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*****f20aaa352f/c3be4f073*****7d5193ec8-{DestMd5}-od-S00000001-200000.mp4",
        "Encryption": "{\\\"EncryptType\\\":\\\"AliyunVoDEncryption\\\"}",
        "Height": "360",
        "SubtitleStreamList": "[]",
        "Bitrate": "964",
        "AudioStreamList": "\"AudioStreamList\": \"[{\\\"Bitrate\\\":\\\"64.533\\\",\\\"ChannelLayout\\\":\\\"stereo\\\",\\\"Channels\\\":\\\"2\\\",\\\"CodecLongName\\\":\\\"AAC (Advanced Audio Coding)\\\",\\\"CodecName\\\":\\\"aac\\\",\\\"CodecTag\\\":\\\"0x6134706d\\\",\\\"CodecTagString\\\":\\\"mp4a\\\",\\\"CodecTimeBase\\\":\\\"1/44100\\\",\\\"Duration\\\":\\\"12.615533\\\",\\\"Index\\\":\\\"1\\\",\\\"Lang\\\":\\\"und\\\",\\\"SampleFmt\\\":\\\"fltp\\\",\\\"Samplerate\\\":\\\"44100\\\",\\\"StartTime\\\":\\\"-0.046440\\\",\\\"Timebase\\\":\\\"1/44100\\\"}]",
        "Width": "640",
        "Fps": "25",
        "Duration": "12",
        "Format": "m3u8",
        "Filesize": 851076,
        "WatermarkIdList": [
          "[\"64079a0e3e286*****b48a8c9413\"]"
        ]
      }
    }
  ],
  "TranscodeTask": {
    "CreationTime": "2019-01-23T12:35:12Z",
    "Trigger": "Auto ",
    "TaskStatus": "Processing",
    "VideoId": "883f5d98107*****b7f20aaa352f",
    "CompleteTime": "2019-01-23T12:40:12Z",
    "TranscodeTemplateGroupId": "b500c7094bd241*****3e9900752d7c3",
    "TranscodeTaskId": "b1b65ab107e14*****3dbb900f6c1fe0",
    "TranscodeJobInfoList": [
      {
        "Definition": "LD",
        "CreationTime": "2019-02-26T08:27:16Z",
        "InputFileUrl": "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*****47f38e/31f1184c-*****b2a2-f94-c213f.wmv",
        "ErrorMessage": "ErrorMessage",
        "ErrorCode": "200",
        "CompleteTime": "2019-02-26T08:30:16Z",
        "TranscodeProgress": 100,
        "Priority": "6",
        "TranscodeJobStatus": "Transcoding",
        "TranscodeTemplateId": "174b0534fea3*****b51c8f0ad1374",
        "TranscodeJobId": "38f0e513c88*****85515f9d50be188",
        "OutputFile": {
          "VideoStreamList": "[{\\\"AvgFPS\\\":\\\"30.0\\\",\\\"Bitrate\\\":\\\"933.814\\\",\\\"CodecLongName\\\":\\\"H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10\\\",\\\"CodecName\\\":\\\"h264\\\",\\\"CodecTag\\\":\\\"0x31637661\\\",\\\"CodecTagString\\\":\\\"avc1\\\",\\\"CodecTimeBase\\\":\\\"1/60\\\",\\\"Dar\\\":\\\"9:16\\\",\\\"Duration\\\":\\\"12.033333\\\",\\\"Fps\\\":\\\"30.0\\\",\\\"HasBFrames\\\":\\\"2\\\",\\\"Height\\\":\\\"360\\\",\\\"Index\\\":\\\"0\\\",\\\"Lang\\\":\\\"und\\\",\\\"Level\\\":\\\"30\\\",\\\"PixFmt\\\":\\\"yuv420p\\\",\\\"Profile\\\":\\\"High\\\",\\\"Sar\\\":\\\"81:256\\\",\\\"StartTime\\\":\\\"0.000000\\\",\\\"Timebase\\\":\\\"1/15360\\\",\\\"Width\\\":\\\"640\\\"}]",
          "OutputFileUrl": "http://outin-40564*****e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*****f20aaa352f/c3be4f073*****7d5193ec8-{DestMd5}-od-S00000001-200000.mp4",
          "Encryption": "{\\\"EncryptType\\\":\\\"AliyunVoDEncryption\\\"}",
          "Height": "360",
          "SubtitleStreamList": "[]",
          "Bitrate": "964",
          "AudioStreamList": "\"AudioStreamList\": \"[{\\\"Bitrate\\\":\\\"64.533\\\",\\\"ChannelLayout\\\":\\\"stereo\\\",\\\"Channels\\\":\\\"2\\\",\\\"CodecLongName\\\":\\\"AAC (Advanced Audio Coding)\\\",\\\"CodecName\\\":\\\"aac\\\",\\\"CodecTag\\\":\\\"0x6134706d\\\",\\\"CodecTagString\\\":\\\"mp4a\\\",\\\"CodecTimeBase\\\":\\\"1/44100\\\",\\\"Duration\\\":\\\"12.615533\\\",\\\"Index\\\":\\\"1\\\",\\\"Lang\\\":\\\"und\\\",\\\"SampleFmt\\\":\\\"fltp\\\",\\\"Samplerate\\\":\\\"44100\\\",\\\"StartTime\\\":\\\"-0.046440\\\",\\\"Timebase\\\":\\\"1/44100\\\"}]",
          "Width": "640",
          "Fps": "25",
          "Duration": "12",
          "Format": "m3u8",
          "Filesize": 851076,
          "WatermarkIdList": [
            "[\"64079a0e3e286*****b48a8c9413\"]"
          ]
        }
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.