Atualizado em Jul 26, 2026

Download para Armazenamento

Use esta ação quando quiser baixar um arquivo de uma URL externa e transmiti-lo diretamente para o storage da sua empresa.

Melhor para

• Arquivos grandes demais para o limite de 5 MB de resposta da ação Requisição HTTP — esta ação transmite até 500 MB sem manter o arquivo inteiro em memória
• Salvar um arquivo remoto uma única vez e reutilizar sua referência armazenada ou URL assinada em passos posteriores
• Importar mídias (imagens, vídeos, áudios, documentos) de sistemas externos

Campos principais

Campo	O que faz
URL HTTP	Expressão CEL que resolve para a URL de download. Apenas requisições GET são feitas, e apenas URLs HTTP(S) públicas são permitidas
Propósito	Rótulo opcional do que o download faz, exibido nos logs
Cabeçalhos HTTP	Cabeçalhos de requisição opcionais, por exemplo para autenticação. Chaves e valores são expressões CEL — combine com Resolver Variáveis para carregar segredos
File Name	Expressão CEL opcional para o nome do arquivo armazenado. Se omitido, usa o cabeçalho Content-Disposition da resposta, depois o caminho da URL e por fim um nome gerado
Tipo de conteúdo	Expressão CEL opcional para o tipo MIME. Detectado automaticamente a partir do cabeçalho Content-Type da resposta ou da extensão do arquivo quando omitido
Categoria	Armazena o arquivo como images, videos, audios ou documents. Detectada automaticamente a partir do tipo de conteúdo quando omitida
Public	Controla se o arquivo armazenado deve ser abertamente acessível (desligado por padrão)

O que passos posteriores podem usar

• step(N).status
• step(N).file
• step(N).signedUrl
• step(N).contentType
• step(N).size

step(N).file contém o objeto armazenado (bucket, fullPath, name, metadata), e step(N).signedUrl é uma URL de download temporária válida por cerca de 15 minutos.

Dicas

• Downloads são limitados a 500 MB — transferências maiores são abortadas com download_size_limit_exceeded.
• Os bytes baixados contam para a cota de storage da sua empresa, e o passo falha com storage_quota_exceeded quando o download não couber nela.
• Uma resposta não-2xx faz o passo falhar (http_client_error ou http_server_error), e o download inteiro deve terminar em até 5 minutos.
• Nada fica para trás em caso de falha: um arquivo parcialmente armazenado é limpo automaticamente.
• Use Criar URL Assinada de Armazenamento (actions/media/storage/signed-url) mais tarde quando precisar de um novo link de download depois que o inicial expirar.