All Products
Search
Document Center

:UpdateMediaCover

Last Updated:May 27, 2026

Memperbarui thumbnail file media.

Catatan penggunaan

Operasi ini hanya dapat digunakan untuk memperbarui thumbnail file media. Untuk informasi selengkapnya tentang cara memperbarui seluruh informasi file media, lihat UpdateMedia.

Batas QPS

Anda dapat memanggil operasi ini hingga 100 kali per detik. Jika jumlah panggilan per detik melebihi batas tersebut, Pembatasan kecepatan akan dipicu, yang berpotensi mengganggu bisnis Anda. Kami menyarankan agar Anda mematuhi batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Batas QPS.

Debugging

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

Parameter permintaan

Parameter Type Required Example Description
Action String Yes UpdateMediaCover

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke UpdateMediaCover.

MediaId String Yes 6cc3aa66d1cb4bb2adf14e726c0a****

ID file media yang thumbnail-nya ingin Anda perbarui. Untuk mendapatkan ID file media, Anda dapat memanggil operasi AddMedia. Atau, lakukan langkah-langkah berikut di Konsol ApsaraVideo Media Processing (MPS): Di panel navigasi sebelah kiri, pilih Media Management > Media List. Temukan video yang diperlukan dan klik Manage. ID video tersebut ditampilkan di tab Basics.

CoverURL String No http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4

URL thumbnail yang ingin Anda tetapkan untuk file media. URL tersebut sesuai dengan RFC 2396 dan dikodekan dalam UTF-8. Panjang URL maksimal 3.200 byte.

Catatan Untuk mendapatkan URL thumbnail, Anda dapat mencari gambar tersebut di bucket Object Storage Service (OSS) dan klik gambarnya untuk melihat detail. Di panel View Details, salin bagian sebelum tanda tanya (?) dari bidang URL. Anda hanya dapat memasukkan URL HTTP.

Parameter respons

Parameter Type Example Description
RequestId String 0DC39B9E-13D4-40BA-AE76-CFF9BD64239D

ID permintaan.

Contoh

Contoh permintaan

http(s)://mts.cn-hangzhou.aliyuncs.com/?Action=UpdateMediaCover
&MediaId=6cc3aa66d1cb4bb2adf14e726c0a****
&CoverURL=http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4
&<Common request parameters>

Contoh respons sukses

XML format

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

<UpdateMediaCoverResponse>
    <RequestId>0DC39B9E-13D4-40BA-AE76-CFF9BD64239D</RequestId>
</UpdateMediaCoverResponse>

JSON format

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

{
  "RequestId" : "0DC39B9E-13D4-40BA-AE76-CFF9BD64239D"
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.