Todos os produtos
Search

Este produto

    ApsaraVideo Media Processing:Configurar notificações

    Central de documentação

    ApsaraVideo Media Processing:Configurar notificações

    Última atualização: Jun 27, 2026

    Tarefas assíncronas, como transcodificação e moderação de conteúdo, não retornam resultados em tempo real. Configure notificações em uma fila ou workflow do MPS para monitorar alterações no status das tarefas.

    1. Ativar o Simple Message Queue (antigo MNS).

    2. Crie um tópico ou uma fila conforme suas necessidades.

      Nota

      Uma fila oferece um modelo de consumo um-para-um, altamente confiável e simultâneo. Um tópico fornece um modelo de publicação-assinatura um-para-muitos.

    3. (Opcional) Vincular uma fila do MPS.

    4. Configure as notificações.

    Etapa 1: Ativar o Simple Message Queue (antigo MNS)

    Importante

    As notificações do MPS dependem do SMQ para enviar mensagens. O MPS não cobra por esse recurso, mas o uso do SMQ gera custos. Faturamento.

    1. Ative o Simple Message Queue (antigo MNS) e conceda as permissões necessárias. Para obter instruções detalhadas, consulte Ativar o Simple Message Queue (antigo MNS) e conceder permissões.

    2. Clique em Management Console para abrir o console do Simple Message Queue (antigo MNS).

    Etapa 2: Criar um tópico ou uma fila

    O MPS envia notificações por push de mensagens para tópicos ou filas do SMQ. Crie um tópico ou uma fila conforme suas necessidades.

    Criar um tópico

    1. No painel de navegação à esquerda do console do SMQ, selecione Topics. Na página Topic List, clique em Create Topic.

    2. Na página Create Topic, configure os seguintes parâmetros.

      Parâmetro

      Descrição

      Name

      Nome do tópico.

      Nota

      O nome deve começar com uma letra, ter no máximo 120 caracteres e conter apenas letras, dígitos e hifens (-).

      Maximum Message Length

      Tamanho máximo do corpo da mensagem. Valores válidos: 1024–65536 bytes. Padrão: 65536.

      Enable Logging Feature

      Ativa o registro de log para este tópico.

      Nota

      Se você ativar esse recurso, o Simple Message Queue (formerly MNS) envia automaticamente logs de operação para seu LoggingBucket, permitindo visualizar rastreamentos de mensagens e atrasos na entrega. Visão geral do gerenciamento de logs.

    3. Clique em OK. O sistema cria o tópico e redireciona você para a página de detalhes do tópico.

    4. Clique em Create Subscription e configure os parâmetros.

      Parâmetro

      Descrição

      Name

      Nome da assinatura.

      Nota

      O nome deve começar com uma letra, ter no máximo 255 caracteres e conter apenas letras, dígitos e hifens (-).

      Push Type

      Selecione um tipo de push. Padrão: HTTP.

      Receiver Endpoint

      O Receiver Endpoint da mensagem.

      Nota

      O endpoint deve ser uma URL que comece com http:// ou https://.

      (Opcional) Message Filtering Tag

      Tag usada para filtrar mensagens.

      Nota

      A tag pode ter até 16 caracteres.

      Retry Policy

      Política de nova tentativa caso a entrega da mensagem ao endpoint falhe.

      • Backoff Retry: Tenta a entrega 3 vezes em intervalos aleatórios de 10 a 20 segundos.

      • Exponential Decay Retry: Até 176 tentativas ao longo de um dia. O intervalo começa em 1 segundo e aumenta exponencialmente (2n) até o máximo de 512 segundos.

      Message push format

      Formato da mensagem enviada por push.

      • SIMPLIFIED: Contém apenas o corpo da mensagem, sem atributos.

      • JSON: Corpo da mensagem em formato JSON com conteúdo e atributos.

      • XML: Corpo da mensagem em formato XML com conteúdo e atributos.

    5. Clique em OK para criar a assinatura.

    Criar uma fila

    1. No painel de navegação à esquerda do console do SMQ, clique em Queues.

    2. Na página Queue List, clique em Create Queue e configure os seguintes parâmetros.

      Parâmetro

      Descrição

      Name

      Nome da fila.

      Maximum Message Length

      Tamanho máximo do corpo da mensagem enviada para a fila.

      Long Polling Period

      Tempo máximo de espera para uma chamada ReceiveMessage quando a fila está vazia.

      Visibility Timeout Period

      Duração durante a qual uma mensagem recuperada permanece oculta para solicitações de recuperação subsequentes.

      Message Retention Period

      Tempo máximo que uma mensagem pode permanecer na fila antes da exclusão, independentemente de ter sido recuperada.

      Delivery delay

      Tempo de atraso aplicado a todas as mensagens antes de se tornarem consumíveis.

      Enable Logging Feature

      Ativa o gerenciamento de logs para esta fila.

    3. Após configurar os parâmetros, clique em OK para criar a fila.

    (Opcional) Etapa 3: Vincular uma fila do MPS

    Para receber notificações de tarefas em uma fila padrão do MPS, vincule a fila ao seu tópico ou fila do SMQ.

    Nota

    As tarefas de workflow ignoram os vínculos de notificação da fila do MPS. Para usar notificações em um workflow, selecione o tópico ou a fila de notificação no nó Input ao criar o workflow. Configurar notificações para tarefas de workflow.

    1. Faça login no console do ApsaraVideo Media Processing.

    2. Na barra de navegação superior, selecione uma Region.

      Nota

      A fila do MPS e suas tarefas devem estar na mesma região para que as notificações sejam recebidas.

    3. No painel de navegação à esquerda, selecione Global Settings > MPS Queue and Callback.

    4. Na lista de filas do MPS, localize a fila para a qual deseja ativar notificações e clique em Set Message Notification na coluna Actions.

    5. Na caixa de diálogo Set Message Notification, configure os seguintes parâmetros.

      Parâmetro

      Descrição

      Notifications

      Ative a chave.

      Message Type

      Selecione Queue ou Topic com base no tipo da sua entidade SMQ.

      Queue name

      Se você selecionar Queue para Message Type, escolha a fila desejada na lista suspensa Queue name.

      Message Name

      Caso selecione Topic para Message Type, escolha o tópico desejado na lista suspensa Message Name.

    6. Clique em OK para concluir o vínculo.

    Etapa 4: Configurar notificações

    Configurar notificações para tarefa única

    Ao criar uma tarefa, selecione a fila do MPS vinculada ao seu tópico ou fila do SMQ. O MPS envia uma notificação para o destino especificado quando o status da tarefa muda.

    Nota

    O tipo da fila do MPS deve corresponder ao tipo da tarefa. Por exemplo, para receber notificações de uma tarefa de miniatura inteligente, use uma fila do MPS de miniatura inteligente com notificações ativadas e selecione-a ao criar a tarefa.

    Configurar notificações de workflow

    Ative as notificações no nó Input do workflow para receber alertas quando uma tarefa de workflow iniciar e terminar.

    1. No console do ApsaraVideo Media Processing, selecione Workflows > Workflow Orchestration no painel de navegação à esquerda.

    2. Clique em Create Workflow para acessar a página Create Workflow.

    3. Na seção de edição da Topology do workflow, clique no ícone de edição no nó Input.

    4. Na caixa de diálogo Input Settings, ative Notifications e configure os seguintes parâmetros.

      Nota

      Para tarefas de workflow, as configurações de notificação no nó Input substituem as configurações da fila do MPS.

      Parâmetro

      Descrição

      Input bucket

      Preenchido automaticamente após a seleção de um caminho de entrada.

      Input Path

      Caminho do arquivo de entrada a ser processado.

      Transcoding MPS Queue

      Selecione um pipeline de transcodificação previamente vinculado.

      Notifications

      Ative para habilitar as notificações.

      Message Type

      Tipo de destino da mensagem. Deve corresponder ao tipo de entidade SMQ (Queue ou Topic) selecionado abaixo.

      Queue (topic) name

      Selecione a fila ou o tópico de destino.

    5. Configure outros nós do workflow conforme descrito em Criar um workflow.

    Perguntas frequentes

    Perguntas frequentes.