ApsaraVideo VOD:Notification d'événements

Présentation des notifications d'événements

ApsaraVideo VOD est disponible dans plusieurs régions de stockage. Vous pouvez configurer une méthode de callback et une adresse webhook uniques pour les notifications d'événements dans chaque région. Une fois la vidéo chargée et traitée, ApsaraVideo VOD envoie une notification selon la méthode de callback et l'adresse webhook configurées pour cette région.

Méthodes de callback

ApsaraVideo VOD propose deux méthodes pour recevoir des notifications d'événements : les callbacks HTTP (et HTTPS) et les callbacks Simple Message Queue (MNS).

• Callbacks HTTP (et HTTPS) :

  Les callbacks HTTP constituent une méthode passive de réception des notifications d'événements depuis ApsaraVideo VOD. Avec cette approche, déployez un service HTTP chargé de recevoir les messages de callback et 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 la notification d'événement est transmise dans le corps HTTP.

• Callbacks Simple Message Queue (formerly MNS) :

  Les callbacks Simple Message Queue (formerly MNS) reposent sur une méthode active qui vous permet d'extraire (pull) les notifications d'événements depuis ApsaraVideo VOD. Après avoir accordé à ApsaraVideo VOD l'accès à MNS, créez ou utilisez une file d'attente existante dans Simple Message Queue (formerly MNS) et configurez les notifications d'événements dans ApsaraVideo VOD. Lorsqu'un événement se produit, ApsaraVideo VOD écrit le contenu du callback dans la file d'attente. Récupérez ensuite 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 de messages dans la console Simple Message Queue (formerly MNS), consultez la section Opérations sur les files d'attente.

Comparaison des callbacks HTTP et MNS

Protocoles de callback

• Callbacks 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 callback, 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.

• Callbacks 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 callback, consultez les documents référencés dans la section Types d'événements.

Paramètres courants des callbacks

Validation des callbacks et nouvelles tentatives

• Callbacks HTTP

  • Lorsqu'ApsaraVideo VOD envoie un callback HTTP, celui-ci est considéré comme réussi si le service récepteur répond avec un code d'état HTTP 200. Le callback 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 base uniquement sur le code d'état HTTP.

  • Si un callback échoue en raison d'une erreur de configuration, telle qu'une adresse webhook incorrecte ou un service récepteur anormal, ApsaraVideo VOD effectue deux nouvelles tentatives supplémentaires, soit un maximum de trois tentatives. Après trois échecs consécutifs, le message est ignoré.

• Callbacks Simple Message Queue (formerly MNS)

  • Lorsqu'ApsaraVideo VOD envoie un callback Simple Message Queue (formerly MNS), celui-ci 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 callback 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 supplémentaires, soit un maximum de trois tentatives. Parmi les erreurs de configuration figurent l'absence d'octroi des autorisations d'accès à ApsaraVideo VOD, l'utilisation d'une adresse de file d'attente non accessible sur Internet ou l'utilisation d'un nom de file d'attente incorrect. Après trois échecs consécutifs, le message est ignoré.

Configuration des callbacks

Les procédures de configuration des callbacks HTTP et MNS diffèrent. Vous pouvez configurer les deux types dans la console ApsaraVideo VOD ou via l'API/SDK. Pour plus d'informations sur les procédures et les limites, consultez les sections Utilisation des callbacks HTTP et Utilisation des callbacks MNS.

Types d'événements

ApsaraVideo VOD prend en charge les types de notifications d'événements suivants :

FAQ

Si vous rencontrez des problèmes, par exemple pour obtenir des URL HTTPS à partir des callbacks ou pour implémenter plusieurs adresses webhook, consultez la section FAQ sur les notifications d'événements.