Use triggers para processar novos arquivos em um bucket do Object Storage Service (OSS). Por exemplo, converta novos arquivos .docx para o formato .pdf ou transcodifique arquivos .mov para o formato .mp4. Diferentemente do processamento em lote, um trigger processa apenas os novos arquivos adicionados a um bucket após sua criação. Arquivos existentes não são processados.
As APIs e os kits de desenvolvimento de software (SDKs) do novo recurso de processamento de dados estão disponíveis nas regiões com endpoints do IMM.
Triggers são tarefas assíncronas executadas em segundo plano. O tempo de conclusão varia. Portanto, o arquivo de saída não fica disponível imediatamente após o upload do arquivo source.
Após a criação, o trigger gera uma tarefa de processamento de dados para cada novo arquivo. A execução da tarefa gera cobranças. Para mais informações, consulte Faturamento.
Observações de uso
O trigger gera tarefas de processamento de dados para arquivos que atendem às condições especificadas. Teste o trigger com poucos arquivos antes do uso em produção.
A suspensão de um trigger interrompe imediatamente a geração de novas tarefas de processamento de dados. Contudo, as tarefas já enviadas continuam em execução.
O caminho de saída não deve ser igual ao caminho de entrada nem tê-lo como prefixo. Essa medida evita loops de trigger e a substituição de arquivos source.
O caminho de saída não pode terminar com barra (
/). Especifique o caminho completo do objeto de saída, incluindo a extensão. O nome do objeto pode incluir variáveis. Para mais informações sobre variáveis, consulte Variáveis.O nome do arquivo deve conter pelo menos uma variável. Caso contrário, vários arquivos de saída se substituirão mutuamente.
Ao usar as variáveis {key}, {barename} ou {basename} no caminho de saída, garanta que ele difira do caminho de entrada. Do contrário, objetos source podem ser substituídos ou pode ocorrer processamento recursivo.
Não é possível reutilizar um arquivo gerado por trigger como entrada.
Triggers aceitam apenas arquivos da classe de armazenamento Standard.
Crie um trigger
Faça login no console do OSS.
No painel de navegação à esquerda, clique em Buckets e, em seguida, clique em no nome do bucket de destino.
No painel de navegação à esquerda, escolha Data Processing.
Selecione document processing, ApsaraVideo Media Processing ou outros recursos de processamento de dados (este exemplo usa document processing).
Clique em na aba Trigger e, em seguida, clique em Create Trigger.
-
No painel Create Trigger, configure Input Configuration, Output Configuration, Permission Configuration e Notification Configuration.
Parâmetro
Descrição
Input Bucket
Bucket que contém os arquivos a processar.
Path Prefix
Prefixo do caminho dos arquivos a processar.
Filter Rule
Filtra os arquivos a processar com base no prefixo do caminho e na regra de filtro.
-
All: Processa todos os arquivos no diretório especificado pelo parâmetro Path Prefix.
-
File Prefix: Processa dados de arquivos cujos nomes correspondem a um prefixo específico no diretório definido em Path Prefix. Para especificar vários prefixos, separe-os por vírgulas (,).
-
File Suffix: Processa dados de arquivos com um sufixo específico no diretório indicado pelo prefixo do caminho. Para definir múltiplos sufixos, separe-os por vírgulas (,).
Style
Estilo para processar objetos. Se nenhum estilo estiver disponível, selecione Add Style na lista suspensa para criar um novo.
Output Path
Caminho de armazenamento dos arquivos processados.
O caminho não pode terminar com barra (/). Use variáveis no caminho de saída; caso contrário, as saídas de múltiplas tarefas serão sobrescritas. Para mais detalhes, consulte Variáveis.
Stop on Task Submission Failure
Define se o processo deve parar imediatamente caso falhe o envio de uma tarefa.
-
Break: Se ocorrer um erro durante o envio da subtarefa, o trigger falha e para imediatamente.
-
Ignore: Se houver falha no envio de uma subtarefa, o trigger continua sua execução.
Service Role
Função que concede ao IMM permissões para acessar outros recursos de nuvem, como o OSS. Recomendamos a função de serviço
AliyunIMMBatchTriggerRole. Se essa função não existir, crie-a na página do Resource Access Management (RAM).Message Queue
Configure uma fila de mensagens para receber os resultados das tarefas de processamento de dados após a conclusão. Ao terminar uma tarefa, o sistema pode enviar uma notificação com o resultado para uma fila de mensagens leve. Para mais informações, consulte Guia de início rápido.
-
Clique em OK.
Consultar um trigger
Faça login no console do OSS.
No painel de navegação à esquerda, clique em Buckets e, em seguida, clique em no nome do bucket de destino.
No painel de navegação à esquerda, escolha Data Processing e selecione o tipo de processamento desejado, como Document Processing ou ApsaraVideo Media Processing.
-
Clique em na aba Trigger para visualizar a lista de triggers.
A tabela a seguir descreve os status dos triggers.
Status
Descrição
Ready
Status atribuído a uma tarefa recém-criada.
Running
A tarefa está em execução normal.
Success
A tarefa foi concluída com êxito.
Paused
A tarefa está pausada. Nenhum novo trigger é acionado. As tarefas já iniciadas continuam em execução até a finalização.
Failed
Falha na execução da tarefa. Ocorreu um erro e a recuperação automática não é possível.
Na caixa de pesquisa Trigger ID, insira um ID de trigger e clique em no ícone de pesquisa.
Para visualizar os detalhes de um trigger, clique em View Details na coluna Actions.
Clique em no ícone de expansão ao lado de um ID de trigger para ver todas as tarefas associadas. Pesquise tarefas por caminho de arquivo ou status.