Baixar
Uma Assembly pode retornar URLs temporárias de download para os
resultados de processamento que ela inclui.
Encontre essas URLs nos resultados do Assembly Status JSON.
Por padrão, são incluídos os resultados dos Steps que nenhum outro Step usa. Defina
"result": true para incluir também os resultados de um Step intermediário.
Baixe os resultados temporários para seu próprio armazenamento assim que a Assembly for concluída, e faça esse download dentro de 24 horas. As URLs dos resultados deixam de funcionar após a expiração dos arquivos temporários. O armazenamento de um resultado de processamento também depende da política de retenção de arquivos temporários do Template ou Workspace correspondente. A retenção do Assembly Status JSON é uma configuração separada e não prolonga o armazenamento dos arquivos temporários.
Para fluxos de trabalho em produção, recomendamos um Robot de
exportação que salve os resultados no seu bucket na nuvem ou servidor. As exportações são repetidas
em caso de falha; por padrão, se a exportação continuar falhando após as novas tentativas, a Assembly
falhará em vez de informar que a exportação foi bem-sucedida.
O acesso aos arquivos no seu próprio armazenamento é controlado pelo provedor e pela sua configuração.
Confira o valor padrão de acl do Robot de exportação: algumas exportações são
públicas, a menos que você configure o acesso privado. O
guia do Google Cloud Storage e o
guia do DigitalOcean Spaces mostram configurações privadas.
As URLs temporárias (tmp-*.transloadit.net) servem estritamente para baixar arquivos uma única vez para seu próprio armazenamento:
- ✅ Permitido: baixar o arquivo uma única vez e armazená-lo na sua infraestrutura
- ❌ NÃO permitido: compartilhar URLs temporárias com seus usuários finais (viola os Termos de serviço (English))
- ❌ NÃO permitido: incorporar URLs temporárias no seu aplicativo/site
- ❌ NÃO permitido: usar como CDN ou para downloads repetidos
Violar essas restrições infringe nossos Termos de serviço e pode resultar na suspensão imediata da conta. Arquivos acessados mais de 10 vezes ou que consumam largura de banda excessiva são proibidos. Sempre use um Robot de exportação para salvar arquivos no seu próprio armazenamento para uso em produção.
O Robot 🤖/file/filter repassa os arquivos aceitos aos Steps seguintes e
não emite arquivos rejeitados como seus resultados. Ele reutiliza as informações de URL do arquivo
de entrada em vez de criar outra cópia temporária armazenada. Por padrão, os uploads têm armazenamento
temporário; filtrar um upload reutiliza essa cópia existente sem prolongar seu tempo de vida. A saída
de um Step de processamento que alimenta o filtro não é mantida no armazenamento temporário por padrão,
portanto, uma URL funcionando, por si só, não indica por quanto tempo essa saída continuará disponível.
Para solicitar armazenamento temporário, defina "result": true no Step que produz a saída.
Isso também inclui os resultados não filtrados desse Step no Assembly Status JSON e continua sujeito
à sua política de retenção. Para salvar apenas os arquivos aceitos no seu próprio armazenamento,
conecte um Step de exportação ao Step de filtragem.
Para entregar arquivos pelo Smart CDN, siga o guia de configuração do Smart CDN. As URLs temporárias de download não substituem o Smart CDN nem sua própria hospedagem.