RefreshUploadVideo - - Centre de documentation Alibaba Cloud

Remarques sur l'utilisation

Pour remplacer le fichier source d'une vidéo ou d'un contenu audio, obtenez l'URL de téléchargement du fichier source en appelant cette opération. Chargez ensuite un nouveau fichier source sans modifier l'ID de la vidéo ou du contenu audio. Notez que le remplacement du fichier peut déclencher automatiquement des tâches de transcodage et de capture d'images si elles sont configurées. Pour plus d'informations, consultez la rubrique URL et identifiants de téléchargement.

Limite de QPS

Vous pouvez appeler cette opération jusqu'à 120 fois par seconde par compte. Si le nombre d'appels par seconde dépasse cette limite, un throttling est appliqué, ce qui peut affecter votre activité. Tenez compte de cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la page Limites de QPS sur les opérations API dans ApsaraVideo VOD.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre

Type

Obligatoire

Exemple

Description

Action

String

Oui

RefreshUploadVideo

Opération à effectuer. Définissez la valeur sur RefreshUploadVideo.

VideoId

String

Oui

c6a23a870c8c4ffcd40cbd381333****

ID du fichier audio ou vidéo. Obtenez cet ID via l'une des méthodes suivantes :

Connectez-vous à la console ApsaraVideo VOD. Dans le volet de navigation de gauche, choisissez Media Files > Audio/Video. Sur la page Vidéo et Audio, consultez l'ID du fichier audio ou vidéo.
Consultez la valeur du paramètre VideoId renvoyée par l'opération CreateUploadVideo appelée lors du chargement du fichier audio ou vidéo.
Consultez la valeur du paramètre VideoId renvoyée par l'opération SearchMedia appelée pour interroger l'ID du fichier audio ou vidéo après le chargement.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	25818875-5F78-4A43-7DF6-D7393642****	ID de la requête.
UploadAddress	String	eyJTZWN1cml0eVRiQ0FJU3p3TjFxNkZ0NUIyeW****	URL de téléchargement. Remarque L'URL de téléchargement renvoyée par cette opération est encodée en Base64. Décodez l'URL à l'aide de l'algorithme Base64 avant d'utiliser un SDK ou une opération API pour charger un élément multimédia. L'analyse de l'URL de téléchargement n'est nécessaire que si vous utilisez des SDK OSS natifs ou l'API OSS pour les téléchargements.
VideoId	String	c6a23a870c8c4ffcd40cbd381333****	ID du fichier audio ou vidéo.
UploadAuth	String	FJU3p3TZ0NUIyeW****	Identifiant de téléchargement. Remarque L'identifiant de téléchargement renvoyé par cette opération est encodé en Base64. Décodez l'identifiant à l'aide de l'algorithme Base64 avant d'utiliser un SDK ou une opération API pour charger un élément multimédia. L'analyse de l'identifiant de téléchargement n'est nécessaire que si vous utilisez des SDK OSS natifs ou l'API OSS pour les téléchargements.

Exemples

Exemple de requête

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

Exemple de réponse réussie

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****"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.

Erreurs courantes

Le tableau suivant décrit les erreurs courantes que cette opération peut renvoyer.

Code d'erreur	Message d'erreur	Code d'état HTTP	Description
InvalidVideo.Damaged	The video has been Damaged.	400	Le message d'erreur renvoyé indique qu'une erreur s'est produite lors de la création de la vidéo ou que la vidéo a été endommagée.
InvalidVideo.NotFound	The video not exist.	404	Le message d'erreur renvoyé indique que la vidéo n'existe pas.

Exemples de SDK

Nous vous recommandons d'utiliser un SDK serveur pour appeler cette opération. Pour plus d'informations sur les exemples de code utilisés pour appeler cette opération dans divers langages, consultez les rubriques suivantes :