Kueri atau filter informasi aset media di perpustakaan media sesuai permintaan - ApsaraVideo VOD

Anda dapat mengkueri informasi tentang aset media seperti file video, audio, dan gambar serta menentukan bidang yang akan dikembalikan. Beberapa mode kueri didukung, termasuk pencocokan kabur dan kueri multi-nilai. Anda juga dapat memfilter dan mengurutkan informasi aset media berdasarkan parameter tertentu. Topik ini menjelaskan cara mengkueri informasi aset media menggunakan konsol ApsaraVideo VOD, API, atau SDK.

Metode

Anda dapat menggunakan dua metode berikut untuk mengkueri informasi aset media:

Dengan menggunakan konsol ApsaraVideo VOD
Masuk ke konsol ApsaraVideo VOD dan buka halaman Audio/Video. Anda dapat memfilter file audio dan video berdasarkan jenis, kategori, status, dan sumber. Anda juga dapat mencari aset media berdasarkan nama media, ID media, atau nama tag.
Catatan
Jika file video berada dalam status Transcoding Gagal, hapus file tersebut dan unggah ulang. Jika transkoding gagal beberapa kali, lihat kemungkinan penyebab dan solusi yang sesuai di FAQ tentang transkoding.
Dengan menggunakan operasi API atau SDK
Panggil operasi SearchMedia dan gunakan protokol pencarian untuk mengkueri informasi aset media. Anda dapat memanggil operasi SearchMedia untuk mengkueri informasi aset media dan menentukan bidang yang akan dikembalikan. Beberapa mode kueri didukung, seperti pencocokan tepat, pencocokan kabur, kueri multi-nilai, dan kueri rentang. Anda dapat memfilter informasi aset media berdasarkan VideoId, CateId, StorageLocation, Title, atau Tags. Untuk informasi lebih lanjut tentang sintaksis dan aturan pencarian, lihat Protokol untuk pencarian aset media.

Batasan

Batasan Paging

Saat Anda mengkueri aset media menggunakan operasi API atau SDK, operasi SearchMedia hanya mengembalikan sebagian data yang memenuhi kondisi kueri untuk menghindari masalah kinerja yang disebabkan oleh halaman dalam. Untuk mendapatkan lebih banyak data atau melintasi semua data, Anda harus menggunakan pengenal paginasi ScrollToken dan SessionId.

Parameter paginasi seperti PageNo dan PageSize digunakan untuk mendapatkan sebagian data tanpa melewati ScrollToken atau SessionId. Anda dapat memperoleh hingga 5.000 catatan data pertama untuk satu kueri.
Untuk mendapatkan lebih banyak data atau melintasi semua data, Anda harus menggunakan parameter paginasi PageNo, PageSize, serta pengenal paginasi ScrollToken dan SessionId. Pastikan bahwa jumlah catatan data pada halaman antara nomor halaman saat ini dan nomor halaman yang diminta tidak melebihi 1.200. Saat Anda pergi ke halaman yang ditentukan oleh nomor halaman yang diminta, Anda dapat memperoleh hingga 1.200 catatan data berikutnya. Ulangi operasi sebelumnya untuk mendapatkan semua data. Anda dapat memperoleh data dalam beberapa segmen berdasarkan pengenal paginasi, dengan maksimum 1.200 catatan data dalam setiap segmen.

Contoh panggilan API

Kode sampel di bagian berikut menggambarkan pernyataan kueri yang digunakan untuk mengkueri informasi video.

Penting

Sebelum Anda mengirim permintaan, Anda harus melakukan pengkodean URL pada parameter permintaan.
Tanda sama dengan (=), tanda kutip ganda ("), tanda kutip tunggal ('), dan tanda kurung yang digunakan dalam pernyataan harus berupa karakter single-byte.

Item	Deskripsi
Bidang Pengembalian	Secara default, operasi SearchMedia hanya mengembalikan informasi dasar aset media. Untuk mendapatkan lebih banyak informasi aset media, Anda harus menyetel bidang `Fields`. Dapatkan parameter `Title` dan `CoverURL`: `Fields=Title,CoverURL` Permintaan contoh: `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &Fields=Title,CoverURL`
Pencocokan Tepat	Kueri informasi tentang video yang `VideoId`-nya adalah `28ba2b26d540446c94cdd2c4c48090e5`: `VideoId='28ba2b26d540446c94cdd2c4c48090e5'` Permintaan contoh: `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &Match=VideoId='28ba2b26d540446c94cdd2c4c48090e5'`
Pencocokan Kabur	Kueri informasi aset media di mana `Title` berisi `Music`: `Title='Music'` atau `Title in ('Music')` Permintaan contoh: `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &Match=Title='Music'`
Kueri Multi-Nilai	Catatan: Jika bidang yang digunakan untuk kueri hanya mendukung pencocokan kabur, hasil kueri juga akan dikembalikan berdasarkan pencocokan kabur. Kueri informasi tentang aset media yang `Status`-nya adalah `Normal` atau `Checking`: `Status in ('Normal','Checking')` Permintaan contoh: `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &Match=Status in ('Normal','Checking')`
Kueri Rentang	Gunakan interval terbuka atau tertutup untuk menunjukkan rentang waktu. Kueri informasi tentang aset media yang `CreationTime`-nya berada di antara `2018-01-01T00:00:00Z` dan `2018-02-01T00:00:00Z`: `CreationTime=('2018-01-01T00:00:00Z','2018-02-01T00:00:00Z')` Permintaan contoh: `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &Match=CreationTime=('2018-01-01T00:00:00Z','2018-02-01T00:00:00Z')` Gunakan interval terbuka kiri atau kanan untuk menentukan hanya waktu akhir atau awal dari rentang waktu. Kueri informasi tentang aset media yang `CreationTime`-nya lebih dari `2018-01-01T00:00:00Z`: `CreationTime=('2018-01-01T00:00:00Z',)` Permintaan contoh: `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &Match=CreationTime=('2018-01-01T00:00:00Z',)`
Bidang Pengurutan	Urutkan informasi aset media secara kronologis terbalik berdasarkan waktu pembuatan: `CreationTime:Desc` Permintaan contoh: `http://vod.cn-shanghai.aliyuncs.com?Action=SearchMedia &SortBy=CreationTime:Desc`

ApsaraVideo VOD：Kueri informasi aset media

Metode

Batasan

Contoh panggilan API

Referensi