Video yükleme işlemi zaman aşımına uğradığında yeni bir yükleme kimlik bilgisi alır.
Kullanım notları
Bir video veya ses kaynak dosyasının üzerine yazmak istiyorsanız bu işlemi çağırarak kaynak dosyanın yükleme URL'sini alabilirsiniz. Ardından video veya ses ID'sini değiştirmeden yeni bir kaynak dosya yükleyebilirsiniz. Ancak bu işlemler yapılandırılmışsa dosyanın üzerine yazılması otomatik olarak kod dönüştürme ve anlık görüntü görevlerini tetikleyebilir. Daha fazla bilgi için bkz. Yükleme URL'leri ve kimlik bilgileri.
Saniye başına sorgu (QPS) sınırı
Bu işlemi hesap başına saniyede en fazla 120 kez çağırabilirsiniz. Saniye başına yapılan çağrı sayısı limiti aşarsa sistem istekleri kısıtlar. Bu durum iş süreçlerinizi etkileyebilir. Bu işlemi çağırırken limite dikkat etmenizi öneririz. Daha fazla bilgi için bkz. ApsaraVideo VOD'daki API işlemleri için QPS sınırları.
Hata ayıklama
İstek parametreleri
| Parametre | Tür | Zorunlu | Örnek | Açıklama |
| Action | String | Evet | RefreshUploadVideo | Gerçekleştirmek istediğiniz işlem. Değeri RefreshUploadVideo olarak ayarlayın. |
| VideoId | String | Evet | c6a23a870c8c4ffcd40cbd381333**** | Ses veya video dosyasının ID'si. ID'yi almak için aşağıdaki yöntemlerden birini kullanabilirsiniz:
|
Yanıt parametreleri
| Parametre | Tür | Örnek | Açıklama |
| RequestId | String | 25818875-5F78-4A43-7DF6-D7393642**** | İsteğin ID'si. |
| UploadAddress | String | eyJTZWN1cml0eVRiQ0FJU3p3TjFxNkZ0NUIyeW**** | Yükleme URL'si. Not Bu işlem tarafından döndürülen yükleme URL'si Base64 ile kodlanmıştır. Bir SDK veya API işlemi kullanarak medya varlığını yükleme URL'sine göre yüklemeye başlamadan önce yükleme URL'sini Base64 algoritmasıyla çözmeniz gerekir. Yükleme için yerel Object Storage Service (OSS) SDK'larını veya OSS API'sini kullanıyorsanız yükleme URL'sini ayrıştırmanız gerekir. |
| VideoId | String | c6a23a870c8c4ffcd40cbd381333**** | Ses veya video dosyasının ID'si. |
| UploadAuth | String | FJU3p3TZ0NUIyeW**** | Yükleme kimlik bilgisi. Not Bu işlem tarafından döndürülen yükleme kimlik bilgisi Base64 ile kodlanmıştır. Bir SDK veya API işlemi kullanarak medya varlığını yükleme kimlik bilgisine göre yüklemeye başlamadan önce yükleme kimlik bilgisini Base64 algoritmasıyla çözmeniz gerekir. Yükleme için yerel OSS SDK'larını veya OSS API'sini kullanıyorsanız yükleme kimlik bilgisini ayrıştırmanız gerekir. |
Örnekler
Örnek istekler
http(s)://vod.cn-shanghai.aliyuncs.com/?Action=RefreshUploadVideo
&VideoId=c6a23a870c8c4ffcd40cbd381333****
&<Common request parameters>Örnek başarılı yanıt
XML biçimi
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 biçimi
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "25818875-5F78-4A43-7DF6-D7393642****",
"UploadAddress" : "eyJTZWN1cml0eVRiQ0FJU3p3TjFxNkZ0NUIyeW****",
"VideoId" : "c6a23a870c8c4ffcd40cbd381333****",
"UploadAuth" : "FJU3p3TZ0NUIyeW****"
}Hata kodları
Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.
Yaygın hatalar
Aşağıdaki tabloda bu işlemin döndürebileceği yaygın hatalar açıklanmaktadır.
|
Hata kodu |
Hata mesajı |
HTTP durum kodu |
Açıklama |
|
InvalidVideo.Damaged |
The video has been Damaged. |
400 |
Video oluşturma sırasında bir hata oluştuğu veya videonun zarar gördüğü için döndürülen hata mesajı. |
|
InvalidVideo.NotFound |
The video not exist. |
404 |
Video mevcut olmadığı için döndürülen hata mesajı. |
SDK örnekleri
Bu işlemi çağırmak için bir sunucu SDK'sı kullanmanızı öneririz. Çeşitli dillerde bu işlemi çağırmak için kullanılan örnek kod hakkında daha fazla bilgi için aşağıdaki konulara bakın: