ListTranscodeJobs - Intelligent Media Services - Alibaba Cloud Documentation Center

Mengkueri daftar pekerjaan transkoding untuk file media.

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

ice:ListTranscodeJobs

*Semua sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
StartOfCreateTime	string	No	Pengatur waktu mulai filter pengatur waktu pembuatan pekerjaan. Format: yyyy-MM-ddTHH:mm:ssZ.	2022-07-01T00:00:00Z
EndOfCreateTime	string	No	Pengatur waktu akhir filter pengatur waktu pembuatan pekerjaan. Format: yyyy-MM-ddTHH:mm:ssZ.	2022-07-15T00:00:00Z
ParentJobId	string	No	ID pekerjaan induk yang digunakan untuk memfilter hasil.	7b38a5d86f1e47838927b6e7ccb1****
Status	string	No	Status pekerjaan. Nilai valid: Init: Dikirim. Success: Berhasil. Fail: Gagal.	Success
OrderBy	string	No	Pesanan pengurutan. Nilai valid: CreateTimeDesc: Pesanan menurun pengatur waktu pembuatan. CreateTimeAsc: Pesanan menaik pengatur waktu pembuatan.	CreateTimeDesc
PageSize	integer	No	Ukuran halaman. Nilai valid: 0 hingga 100. Nilai default: 20.	10
NextPageToken	string	No	Tanda untuk halaman berikutnya selama pembagian halaman berkelanjutan dalam kueri berhalaman. Tanda ini tidak dikembalikan untuk halaman pertama.	ab4802364a2e49208c99efab82df****

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	31E30781-9495-5E2D-A84D-759B0A01E262
Jobs	array<object>	Daftar pekerjaan.
	array<object>	Informasi pekerjaan.
CreateTime	string	Waktu saat pekerjaan dibuat. Format: yyyy-MM-ddTHH:mm:ssZ.	2022-01-12T08:49:41Z
Name	string	Nama pekerjaan.	transcode-job
RequestId	string	ID permintaan yang dikirimkan untuk pekerjaan.	31E30781-9495-5E2D-A84D-759B0A01E262
ParentJobId	string	ID pekerjaan induk.	8b2198504dd340b7b3c9842a74fc****
JobCount	integer	Jumlah sub-pekerjaan.	1
Status	string	Status pekerjaan. Nilai valid: Success: Pekerjaan berhasil jika setidaknya satu sub-pekerjaan berhasil setelah semua sub-pekerjaan selesai. Fail: Pekerjaan gagal jika semua sub-pekerjaan gagal.	Success
TriggerSource	string	Sumber yang memicu pekerjaan. Nilai valid: API: API. WorkFlow: Alur kerja. Console: Konsol.	API
Percent	integer	Persentase penyelesaian pekerjaan.	0
SubmitTime	string	Waktu saat pekerjaan dikirimkan. Format: yyyy-MM-ddTHH:mm:ssZ.	2022-01-12T08:49:41Z
FinishTime	string	Waktu saat pekerjaan diselesaikan. Format: yyyy-MM-ddTHH:mm:ssZ.	2022-01-12T08:49:41Z
InputGroup	array<object>	Kelompok input pekerjaan. Satu input menunjukkan pekerjaan transkoding. Beberapa input menunjukkan pekerjaan penggabungan audio dan video.
	object	Input pekerjaan.
Type	string	Tipe objek media. Nilai valid: OSS: File OSS. Media: ID aset media.	OSS
Media	string	Nilai media. Jika Type diatur ke OSS, nilainya adalah URL yang mendukung protokol OSS dan HTTP. Jika Type diatur ke Media, nilainya adalah ID aset media.	oss://bucket/path/to/video.mp4
InputUrl	string	URL aliran aset media. Tentukan parameter ini hanya saat Anda mentranskode aliran aset media.	oss://bucket/path/to/video.mp4
OutputGroup	array<object>	Kelompok output pekerjaan.
	array<object>	Output pekerjaan.
Output	object	Konfigurasi media output.
Type	string	Tipe objek media. Nilai valid: OSS: File OSS. Media: ID aset media.	OSS
Media	string	Nilai media. Jika Type diatur ke OSS, nilainya adalah URL yang mendukung protokol OSS dan HTTP. Jika Type diatur ke Media, nilainya adalah ID aset media.	oss://bucket/path/to/video.mp4
OutputUrl	string	URL aliran output hasil transkoding. Tentukan parameter ini hanya saat output adalah aliran aset media.	oss://bucket/path/to/{MediaId}/{JobId}.mp4
ProcessConfig	object	Konfigurasi pemrosesan pekerjaan.
Transcode	object	Konfigurasi transkoding.
TemplateId	string	ID templat.	9547c6ad97cb4f2aaa29683ebd18****
OverwriteParams	object	Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.
Video	object	Pengaturan video.
Codec	string	Format encoding.	H.264
Profile	string	Profil pengkodean. Nilai valid: baseline: Untuk perangkat seluler. main: Untuk perangkat resolusi standar. high: Untuk perangkat resolusi tinggi. Nilai default: high.	Main
Bitrate	string	Bitrate video rata-rata. Nilai valid: 10 hingga 50000. Unit: Kbit/s.	3000
Crf	string	Faktor laju konstan (CRF) untuk kontrol kualitas-bitrate. Nilai valid: 0 hingga 51. Nilai default: 23 untuk H.264 dan 26 untuk H.265. Jika Crf ditentukan, pengaturan Bitrate menjadi tidak valid.	23
Width	string	Lebar video. Nilai valid: 128 hingga 4096. Unit: piksel. Nilai default: lebar asli video.	1920
Height	string	Tinggi video. Nilai valid: 128 hingga 4096. Unit: piksel. Nilai default: tinggi asli video.	1080
Fps	string	Laju frame video. Nilai valid: (0, 60]. Jika laju frame file input melebihi 60, nilai 60 akan digunakan. Nilai default: laju frame file input.	25
Gop	string	Jumlah frame maksimum antar keyframe. Nilai valid: 1 hingga 1080000. Nilai default: 250.	250
Preset	string	Preset algoritma video. Parameter ini hanya didukung untuk H.264. Nilai valid: veryfast, fast, medium, slow, dan slower. Nilai default: medium.	medium
ScanMode	string	Mode pemindaian. Nilai valid: interlaced dan progressive.	progressive
PixFmt	string	Format piksel video. Nilai valid: format piksel standar seperti yuv420p dan yuvj420p.	yuv420p
Remove	string	Apakah akan menghapus video.	false
Crop	string	Pengaturan pemangkasan video. Dua metode didukung: Deteksi dan pangkas batas hitam secara otomatis. Atur nilai ke border. Pemangkasan kustom. Format parameter: width:height:left:top. Contoh: 1280:800:0:140.	1280:800:0:140
Pad	string	Pengaturan padding video yang digunakan untuk menambahkan batas hitam. Format parameter: width:height:left:top. Contoh: 1280:800:0:140.	1280:800:0:140
LongShortMode	string	Apakah akan mengaktifkan mode sisi panjang-pendek untuk orientasi lanskap dan potret adaptif.	false
Bufsize	string	Ukuran buffer. Nilai valid: 1000 hingga 128000. Nilai default: 6000. Unit: KB.	6000
Maxrate	string	Bitrate video puncak. Nilai valid: 10 hingga 50000. Unit: Kbit/s.	9000
AbrMax	string	Bitrate adaptif (ABR) maksimum. Parameter ini hanya berlaku ketika Narrowband HD 1.0 diaktifkan. Nilai valid: 10 hingga 50000. Unit: Kbit/s.	6000
Audio	object	Pengaturan audio.
Codec	string	Kodek audio. Nilai valid: AAC, MP3, VORBIS, dan FLAC. Nilai default: AAC.	AAC
Profile	string	Profil pengkodean audio. Ketika kodek adalah AAC, nilai valid adalah aac_low, aac_he, aac_he_v2, aac_ld, dan aac_eld.	aac_low
Samplerate	string	Laju sampel. Nilai default: 44100. Nilai valid: 22050, 32000, 44100, 48000, dan 96000. Unit: Hz.	44100
Bitrate	string	Bitrate audio file output. Nilai valid: 8 hingga 1000. Unit: Kbit/s. Nilai default: 128.	128
Channels	string	Jumlah saluran audio. Nilai default: 2.	2
Remove	string	Apakah akan menghapus aliran audio.	false
Volume	object	Pengaturan kontrol volume.
Method	string	Metode penyesuaian volume.	auto
IntegratedLoudnessTarget	string	Volume target.	-6
TruePeak	string	Volume puncak.	-1
LoudnessRangeTarget	string	Rentang kenyaringan.	8
Container	object	Pengaturan format kontainer.
Format	string	Format kontainer.	mp4
MuxConfig	object	Pengaturan muxing.
Segment	object	Pengaturan segmentasi.
Duration	string	Durasi segmen.	10
ForceSegTime	string	Pengatur waktu segmentasi paksa.	2,3
Tags	object
	string
ImageWatermarks	array<object>	Pengaturan watermark gambar.
	array<object>	Pengaturan watermark gambar.
TemplateId	string	ID templat.	9547c6ad97cb4f2aaa29683ebd18****
OverwriteParams	object	Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.
Width	string	Lebar.	32
Height	string	Tinggi.	32
Dx	string	Koordinat X watermark.	10
Dy	string	Koordinat Y watermark.	10
ReferPos	string	Posisi referensi. Nilai valid: TopLeft, TopRight, BottomLeft, dan BottomRight. Nilai default: TopLeft.	TopLeft
Timeline	object	Pengaturan waktu tampilan.
Start	string	Waktu mulai.	00:00:05
Duration	string	Durasi tampilan dalam detik, atau ToEND.	ToEND
File	object	File gambar watermark.
Type	string	Tipe objek media. Nilai valid: OSS: File OSS. Media: ID aset media.	OSS
Media	string	Nilai media. Jika tipe adalah OSS, nilai adalah URL yang mendukung protokol OSS dan HTTP. Jika tipe adalah Media, nilai adalah ID aset media.	oss://bucket/path/to/video.mp4
TextWatermarks	array<object>	Pengaturan watermark teks.
	array<object>	Pengaturan watermark teks.
TemplateId	string	ID templat.	9547c6ad97cb4f2aaa29683ebd18****
OverwriteParams	object	Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.
Content	string	Teks watermark. Pengkodean Base64 tidak diperlukan, dan string harus dikodekan dalam UTF-8.	Test Watermark
FontName	string	Nama font.	SimSun
FontColor	string	Warna font.	#006400
FontAlpha	string	Opasitas font.	1.0
Top	string	Jarak dari tepi atas untuk posisi watermark.	10
Left	string	Jarak dari tepi kiri untuk posisi watermark.	10
FontSize	integer	Ukuran font.	16
BorderWidth	integer	Lebar border.	0
BorderColor	string	Warna border.	#006400
Adaptive	string	Apakah akan menyesuaikan ukuran font berdasarkan ukuran video keluaran. Nilai valid: true: Sistem secara otomatis menyesuaikan ukuran font teks berdasarkan ukuran video keluaran. false: Ukuran font tetap dan tidak terpengaruh oleh ukuran video keluaran. Nilai default: false.	false
Subtitles	array<object>	Konfigurasi burn-in subtitle.
	array<object>	Konfigurasi burn-in subtitle.
TemplateId	string	ID templat.	9547c6ad97cb4f2aaa29683ebd18****
OverwriteParams	object	Parameter timpa. Jika ditentukan, parameter ini akan menimpa parameter yang sesuai di templat.
Format	string	Format file subtitle.	vtt
CharEnc	string	Format encoding file.	UTF-8
File	object	File subtitle.
Type	string	Tipe objek media. Nilai valid: OSS: File OSS. Media: ID aset media.	OSS
Media	string	Nilai media. Jika tipe adalah OSS, nilai berupa URL yang mendukung protokol OSS dan HTTP. Jika tipe adalah Media, nilai berupa ID aset media.	oss://bucket/path/to/video.mp4
Encryption	object	Konfigurasi enkripsi.
EncryptType	string	Tipe enkripsi.	PrivateEncryption
CipherText	string	Ciphertext kunci enkripsi standar.	MTYi00NDU0LTg5O****
DecryptKeyUri	string	URL layanan dekripsi untuk enkripsi standar.	https://sample.com/path?CipherText=MTYi00NDU0LTg5O****
CombineConfigs	array<object>	Konfigurasi penggabungan aliran multi-input.
	object
AudioIndex	string	Indeks aliran audio.	0 or exclude
VideoIndex	string	Indeks aliran video.	0 or exclude
Start	number	Waktu mulai aliran input. Nilai default: 0.	0.0
Duration	number	Durasi aliran input. Nilai default: durasi video.	20.0
IsInheritTags	boolean	Apakah akan mewarisi tag dari aliran input. Parameter ini tidak berlaku jika input bukan aset media. Nilai default: false.
UserData	string	Data pengguna.	user-data
ScheduleConfig	object	Konfigurasi penjadwalan pekerjaan.
PipelineId	string	ID pipeline.	e37ebee5d98b4781897f6086e89f****
Priority	integer	Prioritas pekerjaan. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi. Nilai valid: 1 hingga 10.	5
NextPageToken	string	Token halaman berikutnya. Kosongkan parameter ini untuk permintaan pertama. Token halaman berikutnya dikembalikan setelah kueri pertama.	019daf5780f74831b0e1a767c9f1****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
  "Jobs": [
    {
      "CreateTime": "2022-01-12T08:49:41Z",
      "Name": "transcode-job",
      "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
      "ParentJobId": "8b2198504dd340b7b3c9842a74fc****",
      "JobCount": 1,
      "Status": "Success",
      "TriggerSource": "API",
      "Percent": 0,
      "SubmitTime": "2022-01-12T08:49:41Z",
      "FinishTime": "2022-01-12T08:49:41Z",
      "InputGroup": [
        {
          "Type": "OSS",
          "Media": "oss://bucket/path/to/video.mp4",
          "InputUrl": "oss://bucket/path/to/video.mp4"
        }
      ],
      "OutputGroup": [
        {
          "Output": {
            "Type": "OSS",
            "Media": "oss://bucket/path/to/video.mp4",
            "OutputUrl": "oss://bucket/path/to/{MediaId}/{JobId}.mp4"
          },
          "ProcessConfig": {
            "Transcode": {
              "TemplateId": "9547c6ad97cb4f2aaa29683ebd18****",
              "OverwriteParams": {
                "Video": {
                  "Codec": "H.264",
                  "Profile": "Main",
                  "Bitrate": "3000",
                  "Crf": "23",
                  "Width": "1920",
                  "Height": "1080",
                  "Fps": "25",
                  "Gop": "250",
                  "Preset": "medium",
                  "ScanMode": "progressive",
                  "PixFmt": "yuv420p",
                  "Remove": "false",
                  "Crop": "1280:800:0:140",
                  "Pad": "1280:800:0:140",
                  "LongShortMode": "false",
                  "Bufsize": "6000",
                  "Maxrate": "9000",
                  "AbrMax": "6000"
                },
                "Audio": {
                  "Codec": "AAC",
                  "Profile": "aac_low",
                  "Samplerate": "44100",
                  "Bitrate": "128",
                  "Channels": "2",
                  "Remove": "false",
                  "Volume": {
                    "Method": "auto",
                    "IntegratedLoudnessTarget": "-6",
                    "TruePeak": "-1",
                    "LoudnessRangeTarget": "8"
                  }
                },
                "Container": {
                  "Format": "mp4"
                },
                "MuxConfig": {
                  "Segment": {
                    "Duration": "10",
                    "ForceSegTime": "2,3"
                  }
                },
                "Tags": {
                  "key": ""
                }
              }
            },
            "ImageWatermarks": [
              {
                "TemplateId": "9547c6ad97cb4f2aaa29683ebd18****",
                "OverwriteParams": {
                  "Width": "32",
                  "Height": "32",
                  "Dx": "10",
                  "Dy": "10",
                  "ReferPos": "TopLeft",
                  "Timeline": {
                    "Start": "00:00:05",
                    "Duration": "ToEND"
                  },
                  "File": {
                    "Type": "OSS",
                    "Media": "oss://bucket/path/to/video.mp4"
                  }
                }
              }
            ],
            "TextWatermarks": [
              {
                "TemplateId": "9547c6ad97cb4f2aaa29683ebd18****",
                "OverwriteParams": {
                  "Content": "Test Watermark",
                  "FontName": "SimSun",
                  "FontColor": "#006400",
                  "FontAlpha": "1.0",
                  "Top": "10",
                  "Left": "10",
                  "FontSize": 16,
                  "BorderWidth": 0,
                  "BorderColor": "#006400",
                  "Adaptive": "false"
                }
              }
            ],
            "Subtitles": [
              {
                "TemplateId": "9547c6ad97cb4f2aaa29683ebd18****",
                "OverwriteParams": {
                  "Format": "vtt",
                  "CharEnc": "UTF-8",
                  "File": {
                    "Type": "OSS",
                    "Media": "oss://bucket/path/to/video.mp4"
                  }
                }
              }
            ],
            "Encryption": {
              "EncryptType": "PrivateEncryption",
              "CipherText": "MTYi00NDU0LTg5O****",
              "DecryptKeyUri": "https://sample.com/path?CipherText=MTYi00NDU0LTg5O****"
            },
            "CombineConfigs": [
              {
                "AudioIndex": "0 or exclude",
                "VideoIndex": "0 or exclude",
                "Start": 0,
                "Duration": 20
              }
            ],
            "IsInheritTags": false
          }
        }
      ],
      "UserData": "user-data",
      "ScheduleConfig": {
        "PipelineId": "e37ebee5d98b4781897f6086e89f****",
        "Priority": 5
      }
    }
  ],
  "NextPageToken": "019daf5780f74831b0e1a767c9f1****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.