Gunakan GetTranscodeTask untuk kueri detail pekerjaan transcoding - ApsaraVideo VOD - Alibaba Cloud - ApsaraVideo VOD

Mengkueri detail pekerjaan transkoding berdasarkan ID tugas transkoding.

Deskripsi operasi

Catatan penggunaan

Operasi ini hanya mendukung pengkuerian data tugas transkoding dari satu tahun terakhir.

Batas QPS

Satu pengguna dapat melakukan maksimum 15 kueri per detik (QPS). Pembatasan kecepatan akan dipicu jika batas ini terlampaui, yang dapat memengaruhi bisnis Anda. Untuk informasi lebih lanjut, lihat Batas QPS.

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 dengan menggunakan salah satu metode berikut: Panggil operasi SubmitTranscodeJobs untuk mengirimkan tugas transkoding. Nilai TranscodeTaskId dalam tanggapan adalah ID tugas transkoding. Panggil operasi ListTranscodeTask. Nilai TranscodeTaskId dalam tanggapan adalah ID tugas transkoding.	b1b65ab107e14*****3dbb900f6c1fe0
JobIds	string	No	ID pekerjaan transkoding. Anda dapat menentukan maksimum 10 ID. Pisahkan beberapa ID dengan koma (,). Anda dapat memperoleh ID dengan menggunakan metode berikut: Panggil operasi SubmitTranscodeJobs untuk mengirimkan tugas transkoding. Nilai JobId dalam tanggapan adalah ID pekerjaan transkoding.	86c1925fba0**,7afb201e7fa,2cc4997378**

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	F4C6D5BE-BF13-45*****6C-516EA8906DCD.
NonExistJobIds	array	ID pekerjaan transkoding yang tidak ada.
	string	ID pekerjaan transkoding yang tidak ada.	["hhhhhhh"]
TranscodeJobInfoList	array<object>	Informasi pekerjaan transkoding.
	array<object>	Informasi pekerjaan transkoding.
Definition	string	Definisi video. Nilai valid: LD: lancar. SD: definisi standar. HD: definisi tinggi. FHD: definisi ultra tinggi. OD: kualitas asli. 2K: 2K. 4K: 4K. SQ: kualitas suara standar. HQ: kualitas suara tinggi. AUTO: streaming bitrate adaptif. Definisi ini hanya tersedia ketika pengemasan dikonfigurasi dalam template transkoding. Untuk informasi lebih lanjut, lihat Konfigurasi template transkoding - PackageSetting. Catatan Nilai ini adalah label definisi yang dikonfigurasi dalam template transkoding dan tidak menunjukkan rentang resolusi aktual dari file output hasil transkoding.	LD
CreationTime	string	Waktu saat pekerjaan transkoding dibuat. Waktu dalam format yyyy-MM-ddTHH:mm:ssZ (UTC).	2019-02-26T08:27:16Z
InputFileUrl	string	URL OSS file sumber transkoding.	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 saat pekerjaan transkoding selesai. Waktu dalam format yyyy-MM-ddTHH:mm:ssZ (UTC).	2019-02-26T08:30:16Z
TranscodeProgress	integer	Progres pekerjaan transkoding. Rentang nilai: `[0,100]`.	2019-02-26T08:30:16Z
Priority	string	Prioritas tugas transkoding.	6
TranscodeJobStatus	string	Status pekerjaan transkoding. Nilai valid: Transcoding: transkoding sedang berlangsung. TranscodeSuccess: transkoding berhasil. TranscodeFail: transkoding gagal.	Transcoding.
TranscodeTemplateId	string	ID template transkoding yang digunakan untuk transkoding.	174b0534fea3*****b51c8f0ad1374
TranscodeJobId	string	ID pekerjaan transkoding.	38f0e513c88*****85515f9d50be188
OutputFile	object	Informasi tentang file output hasil transkoding.
VideoStreamList	string	The list of video streams.	[{\"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	The OSS URL of the transcoding output file.	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*f20aaa352f/c3be4f073***7d5193ec8-{DestMd5}-od-S00000001-200000.mp4
Encryption	string	The encryption configuration used for the transcoding output file. Valid values: AliyunVoDEncryption: Alibaba Cloud video encryption (proprietary encryption). HLSEncryption: HLS encryption.	{\"EncryptType\":\"AliyunVoDEncryption\"}
Height	string	The height of the transcoding output video. Unit: px.	360
SubtitleStreamList	string	The list of subtitle streams.	[]
Bitrate	string	The average bitrate of the transcoding output file. Unit: Kbps.	964
AudioStreamList	string	The list of audio streams.	"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	The width of the transcoding output video. Unit: px.	640
Fps	string	The frame rate of the transcoding output file. Unit: frames per second.	25
Duration	string	The duration of the transcoding output file. Unit: seconds.	12
Format	string	The container format of the transcoding output file.	m3u8
Filesize	integer	The size of the transcoding output file. Unit: bytes.	851076
WatermarkIdList	array	The list of watermarks used for transcoding.
	string	The list of watermarks used for transcoding.	["64079a0e3e286*****b48a8c9413"]
TranscodeTask	object	Informasi tugas transkoding.
CreationTime	string	Waktu saat tugas transkoding dibuat. Waktu dalam format yyyy-MM-ddTHH:mm:ssZ (UTC).	2019-01-23T12:35:12Z
Trigger	string	Tipe pemicu. Nilai valid: Auto: dipicu secara otomatis setelah video diunggah. Manual: dipicu dengan memanggil operasi SubmitTranscodeJobs.	Auto.
TaskStatus	string	Status tugas transkoding. Nilai valid: Processing: pemrosesan sedang berlangsung. Partial: sebagian selesai. CompleteAllSucc: semua pekerjaan transkoding selesai dan berhasil. CompleteAllFail: semua pekerjaan transkoding selesai tetapi gagal. Jika file sumber memiliki masalah, tidak ada pekerjaan transkoding yang dimulai dan seluruh tugas transkoding gagal. CompletePartialSucc: semua pekerjaan transkoding selesai tetapi hanya sebagian yang berhasil.	Processing.
VideoId	string	ID audio atau video.	883f5d98107*****b7f20aaa352f.
CompleteTime	string	Waktu saat tugas transkoding selesai. Waktu dalam format yyyy-MM-ddTHH:mm:ssZ (UTC).	2019-01-23T12:40:12Z
TranscodeTemplateGroupId	string	ID kelompok template transkoding yang digunakan untuk transkoding.	b500c7094bd241*****3e9900752d7c3
TranscodeTaskId	string	ID tugas transkoding.	b1b65ab107e14*****3dbb900f6c1fe0
TranscodeJobInfoList	array<object>	Informasi pekerjaan transkoding.
	array<object>	Informasi pekerjaan transkoding.
Definition	string	The video definition. Valid values: LD: fluent. SD: standard definition. HD: high definition. FHD: ultra high definition. OD: original quality. 2K: 2K. 4K: 4K. SQ: standard sound quality. HQ: high sound quality. AUTO: adaptive bitrate streaming. This definition is available only when packaging is configured in the transcoding template. For more information, see Transcoding template configuration - PackageSetting. Catatan This value is the definition label configured in the transcoding template and does not indicate the actual resolution range of the transcoded output file.	LD
CreationTime	string	The time when the transcoding job was created. The time is in the yyyy-MM-ddTHH:mm:ssZ format (UTC).	2019-02-26T08:27:16Z
InputFileUrl	string	The OSS URL of the transcoding source file.	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/customerTrans/5b95e568f8e*47f38e/31f1184c-***b2a2-f94-c213f.wmv
ErrorMessage	string	The error message returned when the transcoding job failed.	ErrorMessage
ErrorCode	string	The error code returned when the transcoding job failed.	200
CompleteTime	string	The time when the transcoding job was completed. The time is in the yyyy-MM-ddTHH:mm:ssZ format (UTC).	2019-02-26T08:30:16Z
TranscodeProgress	integer	The transcoding job progress. Value range: `[0,100]`.	100
Priority	string	The priority of the transcoding task.	6
TranscodeJobStatus	string	The status of the transcoding job. Valid values: Transcoding: transcoding in progress. TranscodeSuccess: transcoding succeeded. TranscodeFail: transcoding failed.	Transcoding
TranscodeTemplateId	string	The ID of the transcoding template used for transcoding.	174b0534fea3*****b51c8f0ad1374
TranscodeJobId	string	The transcoding job ID.	38f0e513c88*****85515f9d50be188
OutputFile	object	The information about the transcoding output file.
VideoStreamList	string	The list of video streams.	[{\"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	The OSS URL of the transcoding output file.	http://outin-40564***e1403e7.oss-cn-shanghai.aliyuncs.com/883f5d*f20aaa352f/c3be4f073***7d5193ec8-{DestMd5}-od-S00000001-200000.mp4
Encryption	string	The encryption configuration used for the transcoding output file. Valid values: AliyunVoDEncryption: Alibaba Cloud video encryption (proprietary encryption). HLSEncryption: HLS encryption.	{\"EncryptType\":\"AliyunVoDEncryption\"}
Height	string	The height of the transcoding output video. Unit: px.	360
SubtitleStreamList	string	The list of subtitle streams.	[]
Bitrate	string	The average bitrate of the transcoding output file. Unit: Kbps.	964
AudioStreamList	string	The list of audio streams.	"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	The width of the transcoding output video. Unit: px.	640
Fps	string	The frame rate of the transcoding output file. Unit: frames per second.	25
Duration	string	The duration of the transcoding output file. Unit: seconds.	12
Format	string	The container format of the transcoding output file.	m3u8
Filesize	integer	The size of the transcoding output file. Unit: bytes.	851076
WatermarkIdList	array	The list of watermark IDs used for the transcoding output file.
	string	The list of watermark IDs used for the transcoding output file.	["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": 0,
      "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.