Use gatilhos 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. Ao contrário do processamento em lote, um gatilho processa apenas novos arquivos adicionados a um bucket após a crie do gatilho. Ele não processa arquivos existentes.
As APIs e os kits de desenvolvimento de software (SDKs) para o novo recurso de processamento de dados estão disponíveis em regiões com endpoints do IMM.
Gatilhos são tarefas assíncronas executadas em segundo plano. O tempo para concluir uma tarefa varia. Portanto, o arquivo de saída não fica disponível para acesso imediatamente após o upload do arquivo source.
Após a crie, o gatilho gera uma tarefa de processamento de dados para cada novo arquivo. A execute da tarefa gera custos. Para mais informações, consulte Faturamento.
Notas de uso
Um gatilho gera tarefas de processamento de dados para arquivos que atendem às condições especifique. Recomendamos testar o gatilho com um número reduzido de arquivos.
Se você suspender um gatilho, ele para imediatamente de gerar novas tarefas de processamento de dados. No entanto, as tarefas já enviadas continuam em execute.
O caminho de saída não pode ser igual ao caminho de entrada nem tê-lo como prefixo. Isso evita loops de gatilho e a sobrescrita de arquivos source.
O caminho de saída não pode terminar com uma 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 sobrescreverão.
Ao usar as variáveis {key}, {barename} ou {basename} no caminho de saída, certifique-se de que ele seja diferente do caminho de entrada. Caso contrário, você poderá sobrescrever os objetos source ou desencadear um processamento recursivo.
Você não pode reutilizar um arquivo gerado por um gatilho como entrada.
Gatilhos aceitam apenas arquivos da classe de armazenamento Standard.
Crie um gatilho
No painel de navegação à esquerda, clique em Buckets e, em seguida, no nome do bucket de destino.
No painel de navegação à esquerda, escolha Data Processing.
selecione document processing, ApsaraVideo Media Processing ou outro recurso de processamento de dados (este exemplo usa document processing).
clique em aba Trigger e, em seguida, em Create Trigger.
-
No painel Create Trigger, configure Input Configuration, Output Configuration, Permission Configuration e Notification Configuration.
Parâmetro
Descrição
Input Bucket
O bucket que contém os arquivos a serem processados.
Path Prefix
O prefixo do caminho dos arquivos a serem processados.
Filter Rule
Filtra os arquivos a serem processados com base no prefixo do caminho e na regra de filtro.
All: Processa todos os arquivos no diretório especifique pelo parâmetro Path Prefix.
File Prefix: Processa dados de arquivos cujos nomes correspondem a um prefixo específico no diretório especifique por Path Prefix. Para especifique vários prefixos, separe-os por vírgulas (,).
File Suffix: Processa dados de arquivos com um sufixo específico no diretório especifique pelo prefixo do caminho. Para especifique vários sufixos, separe-os por vírgulas (,).
Style
O estilo a ser usado para processar objetos. Se nenhum estilo estiver disponível, selecione Add Style na lista suspensa para crie um.
Output Path
O caminho de armazenamento dos arquivos processados.
O caminho não pode terminar com uma barra (/). Use variáveis no caminho de saída. Caso contrário, a saída de várias tarefas se sobrescreverá. Para mais informações, consulte Variáveis.
Stop on Task Submission Failure
selecione se deseja interromper imediatamente caso uma tarefa enviada falhe.
Break: Se ocorrer um erro durante o envio da subtarefa, o gatilho falha e para imediatamente.
Ignore: Se o envio de uma subtarefa falhar, o gatilho continua em execute.
Service Role
A função que concede ao IMM permissões para acessar outros recursos de cloud, como o OSS. Recomendamos usar a função de service
AliyunIMMBatchTriggerRole. Se a função de service 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 concluir uma tarefa, o sistema pode enviar uma notificação com o resultado do processamento para uma fila de mensagens leve. Para mais informações, consulte Início rápido.
Clique em OK.
Consultar um gatilho
Faça login no console do OSS.
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 aba Trigger para visualize a lista de gatilhos.
A tabela a seguir descreve os status dos gatilhos.
Status
Descrição
Ready
Uma tarefa recém-crie apresenta este status.
Running
A tarefa está em execute normal.
Success
A tarefa foi concluída com sucesso.
Paused
A tarefa está pausada e o sistema não aciona novas tarefas. As tarefas já iniciadas continuam em execute até a conclusão.
Failed
A tarefa falhou. Ocorreu um erro durante a execute e não é possível recuperá-la automaticamente.
Na caixa de pesquisa Trigger ID, insira o ID do gatilho e clique em ícone de pesquisa.
Para visualize os detalhes de um gatilho, clique em View Details na coluna Actions.
clique em ícone de expansão ao lado do ID de um gatilho para visualize todas as tarefas desse gatilho. Pesquise tarefas por caminho de arquivo ou status.