ApsaraVideo VOD:Notificação de eventos

Introdução às notificações de eventos

O ApsaraVideo VOD oferece suporte a várias regiões de armazenamento. Configure um método de callback e um endereço de webhook exclusivos para notificações de eventos em cada região. Após o upload e o processamento de um vídeo, o ApsaraVideo VOD envia uma notificação com base no método de callback e no endereço de webhook configurados para essa região.

Métodos de callback

O ApsaraVideo VOD disponibiliza dois métodos para receber notificações de eventos: callbacks HTTP (e HTTPS) e callbacks do Simple Message Queue (MNS).

• Callbacks HTTP (e HTTPS):

  Os callbacks HTTP são um método passivo de recebimento de notificações de eventos do ApsaraVideo VOD. Nesse método, implante um serviço HTTP para receber mensagens de callback e configure o endereço de webhook no ApsaraVideo VOD. Quando ocorre um evento, o serviço VOD envia uma solicitação HTTP POST para esse endereço e entrega a notificação no corpo HTTP.

• Callbacks do Simple Message Queue (anteriormente MNS):

  Os callbacks do Simple Message Queue (anteriormente MNS) constituem um método ativo que permite buscar notificações de eventos no ApsaraVideo VOD. Após conceder acesso do ApsaraVideo VOD ao MNS, crie ou use uma fila existente no Simple Message Queue (anteriormente MNS) e configure as notificações de eventos no ApsaraVideo VOD. Quando ocorre um evento, o ApsaraVideo VOD grava o conteúdo do callback na fila. Em seguida, recupere a mensagem da fila do Simple Message Queue (anteriormente MNS). Para mais informações sobre como criar uma fila e receber mensagens no console do Simple Message Queue (anteriormente MNS), consulte Operações de fila.

Comparação entre callbacks HTTP e MNS

Protocolos de callback

• Callbacks HTTP

  • Solicitação: Uma solicitação HTTP POST com corpo JSON. Para mais informações sobre o conteúdo específico do corpo de cada callback, consulte os documentos referenciados em Tipos de eventos.

  • Resposta: O ApsaraVideo VOD ignora o conteúdo do corpo da resposta.

• Callbacks do Simple Message Queue (anteriormente MNS)

  O conteúdo da mensagem recebida está no formato JSON. Para mais detalhes sobre o corpo específico de cada callback, veja os documentos referenciados em Tipos de eventos.

Parâmetros comuns de callback

Validação e novas tentativas de callback

• Callbacks HTTP

  • Quando o ApsaraVideo VOD envia um callback HTTP, considera-se bem-sucedido se o serviço receptor responder com código de status HTTP 200. Considera-se falha se o código de status não for 200 ou se a resposta atingir o tempo limite após 5 segundos. O ApsaraVideo VOD ignora o corpo da resposta e depende apenas do código de status HTTP.

  • Se um callback falhar devido a erro de configuração, como endereço de webhook incorreto ou serviço receptor anômalo, o ApsaraVideo VOD tentará o callback mais duas vezes, totalizando no máximo três tentativas. Após três tentativas com falha, a mensagem será descartada.

• Callbacks do Simple Message Queue (anteriormente MNS)

  • Quando o ApsaraVideo VOD envia um callback do Simple Message Queue (anteriormente MNS), considera-se bem-sucedido se a mensagem for gravada na fila do Simple Message Queue (anteriormente MNS). Caso contrário, considera-se falha.

  • Se a gravação da mensagem na fila do Simple Message Queue (anteriormente MNS) falhar devido a erro de configuração, o ApsaraVideo VOD tentará mais duas vezes, totalizando no máximo três tentativas. Exemplos de erros de configuração incluem não conceder permissões de acesso ao ApsaraVideo VOD, usar um endereço de fila fora da internet ou usar um nome de fila incorreto. Após três tentativas com falha, a mensagem será descartada.

Configuração de callback

Os procedimentos de configuração para callbacks HTTP e MNS diferem entre si. Configure ambos no console do ApsaraVideo VOD ou usando a API/SDK. Para mais informações sobre procedimentos e limites, consulte Como usar callbacks HTTP e Como usar callbacks MNS.

Tipos de eventos

O ApsaraVideo VOD oferece suporte aos seguintes tipos de notificação de eventos:

Perguntas frequentes

Em caso de problemas, como obtenção de URLs HTTPS a partir de callbacks ou implementação de vários endereços de webhook, consulte as Perguntas frequentes sobre notificações de eventos.