RefreshUploadVideo - - Alibaba Cloud Documentation Center

Mendapatkan kredensial unggah baru setelah masa berlaku unggah video habis.

Catatan penggunaan

Jika ingin menimpa file sumber video atau audio, Anda dapat memperoleh URL unggah file tersebut dengan memanggil operasi ini, lalu mengunggah file sumber baru tanpa mengubah ID video atau audio. Penimpaan file ini secara otomatis akan memicu Pekerjaan Transkoding dan Pekerjaan snapshot jika pekerjaan tersebut telah dikonfigurasi. Untuk informasi selengkapnya, lihat Upload URLs and credentials.

Batas QPS

Operasi ini dapat dipanggil hingga 120 kali per detik per akun. Jika jumlah panggilan per detik melebihi batas tersebut, Pembatasan kecepatan akan dipicu, yang berpotensi mengganggu bisnis Anda. Pastikan Anda memperhatikan batas ini saat memanggil operasi ini. Untuk informasi selengkapnya, lihat QPS limits on API operations in ApsaraVideo VOD.

Debugging

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

Parameter permintaan

Parameter

Type

Required

Contoh

Deskripsi

Action

String

Yes

RefreshUploadVideo

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke RefreshUploadVideo.

VideoId

String

Yes

c6a23a870c8c4ffcd40cbd381333****

ID file audio atau video. Anda dapat memperoleh ID tersebut dengan salah satu metode berikut:

Masuk ke konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Media Files > Audio/Video. Di halaman Video dan Audio, Anda dapat melihat ID file audio atau video tersebut.
Lihat nilai parameter VideoId yang dikembalikan oleh operasi CreateUploadVideo yang Anda panggil untuk mengunggah file audio atau video.
Lihat nilai parameter VideoId yang dikembalikan oleh operasi SearchMedia yang Anda panggil untuk menanyakan ID file audio atau video setelah file tersebut diunggah.

Parameter respons

Parameter	Type	Contoh	Deskripsi
RequestId	String	25818875-5F78-4A43-7DF6-D7393642****	ID permintaan.
UploadAddress	String	eyJTZWN1cml0eVRiQ0FJU3p3TjFxNkZ0NUIyeW****	URL unggah. Catatan URL unggah yang dikembalikan oleh operasi ini dikodekan dalam Base64. Sebelum Anda dapat menggunakan SDK atau operasi API untuk mengunggah aset media berdasarkan URL unggah tersebut, Anda harus mendekode URL unggah tersebut menggunakan algoritma Base64. Anda hanya perlu mengurai URL unggah tersebut jika menggunakan SDK Object Storage Service (OSS) native atau API OSS untuk unggah.
VideoId	String	c6a23a870c8c4ffcd40cbd381333****	ID file audio atau video.
UploadAuth	String	FJU3p3TZ0NUIyeW****	Kredensial unggah. Catatan Kredensial unggah yang dikembalikan oleh operasi ini dikodekan dalam Base64. Sebelum Anda dapat menggunakan SDK atau operasi API untuk mengunggah aset media berdasarkan kredensial unggah tersebut, Anda harus mendekode kredensial unggah tersebut menggunakan algoritma Base64. Anda hanya perlu mengurai kredensial unggah tersebut jika menggunakan SDK OSS native atau API OSS untuk unggah.

Contoh

Contoh permintaan

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=RefreshUploadVideo
&VideoId=c6a23a870c8c4ffcd40cbd381333****
&<Common request parameters>

Contoh respons sukses

XML format

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

<RefreshUploadVideoResponse>
    <RequestId>25818875-5F78-4A43-7DF6-D7393642****</RequestId>
    <UploadAddress>eyJTZWN1cml0eVRiQ0FJU3p3TjFxNkZ0NUIyeW****</UploadAddress>
    <VideoId>c6a23a870c8c4ffcd40cbd381333****</VideoId>
    <UploadAuth>FJU3p3TZ0NUIyeW****</UploadAuth>
</RefreshUploadVideoResponse>

JSON format

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

{
  "RequestId" : "25818875-5F78-4A43-7DF6-D7393642****",
  "UploadAddress" : "eyJTZWN1cml0eVRiQ0FJU3p3TjFxNkZ0NUIyeW****",
  "VideoId" : "c6a23a870c8c4ffcd40cbd381333****",
  "UploadAuth" : "FJU3p3TZ0NUIyeW****"
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.

Kesalahan umum

Tabel berikut menjelaskan kesalahan umum yang dapat dikembalikan oleh operasi ini.

Kode kesalahan	Pesan kesalahan	Kode status HTTP	Deskripsi
InvalidVideo.Damaged	The video has been Damaged.	400	Pesan kesalahan dikembalikan karena terjadi kesalahan selama pembuatan video atau video rusak.
InvalidVideo.NotFound	The video not exist.	404	Pesan kesalahan dikembalikan karena video tidak ada.

Contoh SDK

Kami menyarankan menggunakan server SDK untuk memanggil operasi ini. Untuk informasi selengkapnya mengenai contoh kode pemanggilan dalam berbagai bahasa, lihat topik berikut: