UpdateMediaCover - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Cette opération met uniquement à jour la vignette d'un fichier multimédia. Pour mettre à jour toutes les informations relatives à un fichier multimédia, consultez la rubrique UpdateMedia.

Limites de QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde. Si le nombre d'appels par seconde dépasse cette limite, un mécanisme de limitation du débit (throttling) se déclenche et peut affecter votre activité. Tenez compte de cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la rubrique Limites de QPS.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Par souci de simplicité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	UpdateMediaCover	Opération à effectuer. Définissez la valeur sur UpdateMediaCover.
MediaId	String	Yes	6cc3aa66d1cb4bb2adf14e726c0a****	ID du fichier multimédia dont vous souhaitez mettre à jour la vignette. Pour obtenir l'ID d'un fichier multimédia, appelez l'opération AddMedia. Vous pouvez également procéder comme suit dans la console ApsaraVideo Media Processing (MPS) : dans le volet de navigation de gauche, choisissez Media Management > Media List. Recherchez la vidéo souhaitée et cliquez sur Manage. L'ID de la vidéo s'affiche dans l'onglet Basics.
CoverURL	String	No	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4	URL de la vignette à spécifier pour le fichier multimédia. L'URL doit être conforme à la norme RFC 2396 et encodée en UTF-8. Sa longueur maximale est de 3 200 octets. Remarque Pour obtenir l'URL de la vignette, localisez l'image dans le bucket Object Storage Service (OSS), puis cliquez dessus pour afficher les détails. Dans le panneau View Details, copiez la partie de l'URL située avant le point d'interrogation (?). Seules les URL HTTP sont acceptées.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	0DC39B9E-13D4-40BA-AE76-CFF9BD64239D	ID de la requête.

Exemples

Exemple de requête

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>

Exemple de réponse réussie

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

Codes d'erreur

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