Atualizado em Jul 26, 2026

Criar URL Assinada de Armazenamento

Use esta ação quando um passo posterior precisar de uma URL de download de curta duração para um arquivo que já existe no storage da sua empresa.

Melhor para

• Transformar uma referência de arquivo armazenado (por exemplo message.body.file ou o step(N).file de um passo anterior) em uma URL de download
• Enviar uma imagem armazenada para uma entrada de visão de LLM, com a proteção de tipo de mídia image
• Compartilhar novamente um arquivo já enviado em um passo posterior sem fazer upload de novo

Campos principais

Campo	O que faz
Arquivo	Expressão CEL que resolve para uma referência de arquivo de storage com bucket e fullPath, como message.body.file ou step(0).file. Quando preenchido, os dois campos abaixo são ignorados
bucket	Expressão CEL que resolve para o bucket de storage. Use apenas quando Arquivo não for fornecido
full_path	Expressão CEL que resolve para o caminho do objeto no storage. Use apenas quando Arquivo não for fornecido
media_kind	Proteção opcional de tipo de conteúdo: any (padrão), image, audio, video, pdf, text ou document. Quando o tipo do arquivo armazenado não corresponde, o passo falha em vez de retornar uma URL. Escolha image quando a URL for enviada a uma entrada de imagem de LLM
expires_in_seconds	Tempo de vida da URL assinada em segundos. O padrão é 900 (15 minutos) e o limite é 3600 (1 hora)
Propósito	Rótulo opcional para o que a URL será usada, exibido nos logs

O que passos posteriores podem usar

• step(N).signedUrl
• step(N).contentType
• step(N).size
• step(N).mediaKind
• step(N).bucket
• step(N).fullPath
• step(N).name
• step(N).expiresAt
• step(N).file — um objeto de arquivo pronto para reutilizar (bucket, fullPath, name, metadata) em passos de mídia posteriores

Dicas

• O arquivo deve já existir e pertencer à sua empresa: objetos na área de storage de outro tenant são sempre negados (storage_media_acl_denied), e objetos ausentes falham com storage_media_not_found.
• Mantenha o tempo de vida tão curto quanto o sistema consumidor permitir — a URL para de funcionar em expiresAt.
• Use a proteção de tipo de mídia quando o próximo passo assumir um tipo de arquivo específico; uma divergência falha com storage_media_unsupported_type em vez de repassar o arquivo errado.
• Combine com Upload para Storage ou Download para Armazenamento (actions/network/http/download-to-storage) quando o arquivo ainda não estiver no storage.