ApsaraVideo VOD prend en charge les notifications d'événements via des rappels HTTP (et HTTPS) et des rappels Simple Message Queue (formerly MNS). Cette rubrique décrit les types d'événements, les méthodes de rappel, la configuration, les protocoles, les paramètres courants, la validation, la politique de nouvelle tentative ainsi que les questions fréquentes (FAQ).
Présentation des notifications d'événements
ApsaraVideo VOD est compatible avec plusieurs régions de stockage. Vous pouvez configurer une méthode de rappel et une adresse webhook spécifiques pour les notifications d'événements dans chaque région. Une fois une vidéo chargée et traitée, ApsaraVideo VOD envoie une notification selon la méthode de rappel et l'adresse webhook configurées pour cette région.
Le corps du rappel renvoie uniquement des URL HTTP. Les URL HTTPS ne sont pas prises en charge. Pour savoir comment obtenir des URL HTTPS, consultez la rubrique FAQ sur les notifications d'événements.
Méthodes de rappel
ApsaraVideo VOD propose deux méthodes pour recevoir des notifications d'événements : rappels HTTP (et HTTPS) et rappels Simple Message Queue (MNS).
-
Rappels HTTP (et HTTPS) :
Les rappels HTTP constituent une méthode passive de réception des notifications d'événements provenant d'ApsaraVideo VOD. Avec cette approche, vous déployez un service HTTP chargé de recevoir les messages de rappel et vous configurez l'adresse webhook dans ApsaraVideo VOD. Lorsqu'un événement se produit, le service VOD envoie une requête HTTP POST à cette adresse et transmet la notification d'événement dans le corps HTTP.
-
Rappels Simple Message Queue (formerly MNS) :
Les rappels Simple Message Queue (formerly MNS) constituent une méthode active qui vous permet d'extraire les notifications d'événements depuis ApsaraVideo VOD. Après avoir accordé à ApsaraVideo VOD l'accès à MNS, vous pouvez créer ou utiliser une file d'attente existante dans Simple Message Queue (formerly MNS) et configurer les notifications d'événements dans ApsaraVideo VOD. Lorsqu'un événement se produit, ApsaraVideo VOD écrit le contenu du rappel dans la file d'attente. Vous devez ensuite récupérer le message depuis la file d'attente Simple Message Queue (formerly MNS). Pour plus d'informations sur la création d'une file d'attente et la réception des messages dans la console Simple Message Queue (formerly MNS), consultez la rubrique Opérations sur les files d'attente.
Comparaison des rappels HTTP et MNS
|**Élément**
|
**Rappel HTTP**
|
**Rappel MNS (recommandé)**
| | --- | --- | --- | |
Fiabilité
|
Si votre service de réception des messages HTTP rencontre des anomalies, comme un plantage ou un redémarrage, des messages peuvent être perdus.
|
**Plus fiable**. Les rappels aboutissent presque toujours avec une configuration appropriée.
| |
Sécurité
|
Tout utilisateur peut envoyer une requête à l'adresse webhook. Toutefois, vous pouvez utiliser l'authentification des rappels pour filtrer les requêtes illégitimes et renforcer la sécurité.
Pour plus d'informations, consultez la rubrique [Authentification des rappels HTTP](t1959309.dita#multiTask1630).
|
**Plus sécurisé**, car seules les parties autorisées peuvent lire et écrire dans la file d'attente de messages.
| |
Facilité d'utilisation
|
**Plus facile** à intégrer. Il suffit de déployer un service de réception des messages.
|
Nécessite l'activation et la configuration de Simple Message Queue (formerly MNS). Vous devez également développer et déployer un programme pour consommer les messages.
|
Protocoles de rappel
-
Rappels HTTP
Requête : une requête HTTP POST avec un corps JSON. Pour plus d'informations sur le contenu spécifique du corps de chaque rappel, consultez les documents référencés dans la section Types d'événements.
Réponse : ApsaraVideo VOD ignore le contenu du corps de la réponse.
-
Rappels Simple Message Queue (formerly MNS)
Le contenu du message reçu est au format JSON. Pour plus d'informations sur le contenu spécifique du corps de chaque rappel, consultez les documents référencés dans la section Types d'événements.
Paramètres courants des rappels
Paramètre | Type | Description |
EventTime | String | L'heure à laquelle l'événement s'est produit, au format UTC. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. |
EventType | String | Le type d'événement. |
VideoId | String | L'ID de la vidéo. |
Status | String | Le statut du traitement. Valeurs valides :
|
Extend | String | Lorsque vous appelez une API de chargement ou de soumission de tâche, vous pouvez spécifier le paramètre UserData. Si ce paramètre contient le champ Extend, les données utilisateur personnalisées sont transmises et renvoyées dans le rappel de fin d'événement. La longueur maximale est de 512 octets. |
Validation des rappels et nouvelles tentatives
-
Rappels HTTP
Lorsqu'ApsaraVideo VOD envoie un rappel HTTP, le rappel est considéré comme réussi si le service de réception répond avec un code d'état HTTP 200. Le rappel est considéré comme échoué si le code d'état n'est pas 200 ou si la réponse expire après 5 secondes. ApsaraVideo VOD ignore le corps de la réponse et se fie uniquement au code d'état HTTP.
Si un rappel échoue en raison d'une erreur de configuration, telle qu'une adresse webhook incorrecte ou un service de réception anormal, ApsaraVideo VOD effectue deux nouvelles tentatives, soit un maximum de trois tentatives. Après trois échecs consécutifs, le message est ignoré.
-
Rappels Simple Message Queue (formerly MNS)
Lorsqu'ApsaraVideo VOD envoie un rappel Simple Message Queue (formerly MNS), le rappel est considéré comme réussi si le message est écrit dans la file d'attente Simple Message Queue (formerly MNS). Dans le cas contraire, le rappel est considéré comme échoué.
Si l'écriture du message dans la file d'attente Simple Message Queue (formerly MNS) échoue en raison d'une erreur de configuration, ApsaraVideo VOD effectue deux nouvelles tentatives, soit un maximum de trois tentatives. Parmi les exemples d'erreurs de configuration figurent l'absence d'octroi des autorisations d'accès à ApsaraVideo VOD, l'utilisation d'une adresse de file d'attente qui n'est pas accessible sur Internet ou l'utilisation d'un nom de file d'attente incorrect. Après trois échecs consécutifs, le message est ignoré.
Après l'échec d'un rappel, ApsaraVideo VOD tente à nouveau l'opération après un intervalle de 1 seconde. Si le rappel échoue toujours après trois tentatives au total, le message est ignoré. Pour garantir la fiabilité des notifications, utilisez les rappels Simple Message Queue (formerly MNS). Ils offrent une fiabilité supérieure et aboutissent presque toujours s'ils sont correctement configurés.
Configuration des rappels
Les procédures de configuration des rappels HTTP et MNS diffèrent. Vous pouvez configurer les deux dans la console ApsaraVideo VOD ou via l'API/SDK. Pour plus d'informations sur les procédures et les limites, consultez les rubriques Utilisation des rappels HTTP et Utilisation des rappels MNS.
Types d'événements
ApsaraVideo VOD prend en charge les types de notifications d'événements suivants :
|**Type d'événement**
|
**Référence**
| | --- | --- | |
FileUploadComplete
|
[Chargement de vidéo terminé](t1959312.dita#concept_2526104)
| |
ImageUploadComplete
|
[Chargement d'image terminé](t1959313.dita#concept_2526105)
| |
StreamTranscodeComplete
|
[Transcodage pour une seule définition terminé](t1959314.dita#concept_2526106)
| |
TranscodeComplete
|
[Transcodage pour toutes les définitions terminé](t1959315.dita#concept_2526107)
| |
SnapshotComplete
|
[Capture d'instantanés vidéo terminée](t1959316.xdita#topic-1959316)
| |
DynamicImageComplete
|
[Création d'image animée terminée](t1959329.xdita#topic-1959329)
| |
AddLiveRecordVideoComplete
|
[Enregistrement de flux en direct terminé](t1959317.dita#concept_2526109)
| |
LiveRecordVideoComposeStart
|
[Démarrage de la composition de vidéo enregistrée](t1959318.dita#concept_2526110)
| |
UploadByURLComplete
|
[Chargement de vidéo par URL terminé](t1959319.dita#concept_2526111)
| |
UploadByURLComplete
|
[Chargement de flux transcodé par URL terminé](t2160553.xdita#)
| |
CreateAuditComplete
|
[Révision manuelle terminée](t1959320.dita#concept_2526112)
| |
VideoAnalysisComplete
|
[Analyse audio et vidéo terminée](t1959322.dita#concept_1988394)
| |
UpdateMediaStorageClassComplete
|
[Modification de la classe de stockage des ressources multimédias terminée](t2521384.xdita#)
| |
RestoreMediaComplete
|
[Restauration des ressources multimédias terminée](t2521387.xdita#)
| |
AttachedMediaUploadComplete
|
[Chargement de ressource multimédia auxiliaire terminé](t1959325.dita#concept_2526117)
| |
ProduceMediaComplete
|
[Montage et composition vidéo terminés](t1959327.dita#concept_2526119)
| |
DeleteMediaComplete
|
[Suppression de ressource multimédia terminée](t1959326.dita#concept_2526118)
| |
MediaBaseChangeComplete
|
[Modification des informations de base des ressources multimédias terminée](t1959328.xdita#topic-1959328)
| |
SubmitMediaRefreshComplete
|
[Purge ou préchargement audio/vidéo terminé](t2218361.xdita#)
| |
WorkflowTaskComplete
|
[Tâche de workflow terminée](t3157958.xdita#)
|
FAQ
Si vous rencontrez des problèmes, par exemple pour savoir comment obtenir des URL HTTPS à partir des rappels ou comment mettre en œuvre plusieurs adresses webhook, consultez la rubrique FAQ sur les notifications d'événements.