Conecta-seEntrar na plataforma

S3

Enviar, baixar, listar e administrar arquivos e buckets do Amazon S3.

Integrações e ferramentasArquivos e documentosConexão: Credencial protegida

O que faz

Integre o S3 ao fluxo. Envie, baixe, copie e exclua objetos (um a um ou em lote), consulte os metadados de objetos, gere URLs pré-assinadas com prazo de validade, liste o conteúdo de buckets e crie, liste ou exclua buckets. Requer a chave de acesso (access key) e a chave de acesso secreta (secret access key) da AWS.

Quando usar: Use quando o seu fluxo precisar enviar, baixar, listar e administrar arquivos e buckets do Amazon S3.

Exemplo de situação: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

  1. Adicione S3 ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Baixar arquivoBaixa arquivo com o bloco S3.
Enviar arquivoEnvia arquivo com o bloco S3.
Listar objetosLista objetos com o bloco S3.
Excluir objetoExclui objeto com o bloco S3.
Excluir objetos (em lote)Exclui objetos (em lote) com o bloco S3.
Copiar objetoCopia objeto com o bloco S3.
Consultar objeto (metadados)Consulta objeto (metadados) com o bloco S3.
Gerar URL pré-assinadaGera URL pré-assinada com o bloco S3.
Listar bucketsLista buckets com o bloco S3.
Criar bucketCria bucket com o bloco S3.
Excluir bucketExclui bucket com o bloco S3.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Baixar arquivo · Enviar arquivo · Listar objetos · Excluir objeto · Excluir objetos (em lote) · Copiar objeto · Consultar objeto (metadados) · Gerar URL pré-assinada · Listar buckets · Criar bucket · Excluir bucket
    Padrão:
    Baixar arquivo

  • ID da chave de acesso (Access Key ID)

    ObrigatórioDado protegido

    Informe o ID da chave de acesso da AWS.

    Padrão:
    Segredo protegido

  • Chave de acesso secreta (Secret Access Key)

    ObrigatórioDado protegido

    Informe a chave de acesso secreta da AWS.

    Padrão:
    Segredo protegido

  • Região da AWS

    Obrigatório conforme a operação

    Região da AWS onde fica o bucket do S3 (ex.: sa-east-1, São Paulo).

    Aparece em:
    Enviar arquivo, Listar objetos, Excluir objeto, Excluir objetos (em lote), Copiar objeto, Consultar objeto (metadados), Gerar URL pré-assinada, Listar buckets, Criar bucket, Excluir bucket
    Exemplo:
    us-east-1, us-west-2

  • Região da AWS

    Usada quando a URL do S3 não inclui a região.

    Aparece em:
    Baixar arquivo
    Exemplo:
    Usada quando a URL do S3 não inclui a região

  • Nome do bucket

    Obrigatório conforme a operação

    Informe o nome do bucket do S3.

    Aparece em:
    Enviar arquivo, Listar objetos, Excluir objeto, Excluir objetos (em lote), Consultar objeto (metadados), Gerar URL pré-assinada, Criar bucket, Excluir bucket
    Exemplo:
    Exemplo de atendimento

  • Chave/caminho do objeto

    Obrigatório conforme a operação

    Caminho e nome do arquivo dentro do bucket do S3, incluindo as pastas (ex.: notas-fiscais/2025/nf-1234.pdf); no envio, um arquivo com a mesma chave é substituído.

    Aparece em:
    Enviar arquivo
    Exemplo:
    meuarquivo.pdf ou documentos/relatorio.pdf

  • Arquivo a enviar

    Envie um arquivo.

    Aparece em:
    Enviar arquivo
    Exemplo:
    (selecione um arquivo de teste)

  • Referência do arquivo

    Em campos adicionais

    Referencie um arquivo de blocos anteriores.

    Aparece em:
    Enviar arquivo

  • Conteúdo de texto

    Ou informe um conteúdo de texto para enviar.

    Aparece em:
    Enviar arquivo
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Tipo de conteúdo

    Em campos adicionais

    Informa o conteúdo de texto que será enviado ou processado.

    Aparece em:
    Enviar arquivo
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Controle de acesso

    Em campos adicionais

    Selecione a ACL (padrão: privada).

    Aparece em:
    Enviar arquivo
    Opções:
    Privado · Leitura pública · Leitura e gravação públicas · Leitura autenticada
    Exemplo:
    Privado

  • URL do objeto no S3

    Obrigatório conforme a operação

    Informa o endereço seguro do serviço ou recurso que será acessado.

    Aparece em:
    Baixar arquivo
    Exemplo:
    https://api.exemplo.com/v1/recurso

  • Prefixo/pasta

    Filtre por prefixo (ex.: pasta/, ou deixe vazio para todos).

    Aparece em:
    Listar objetos
    Exemplo:
    pasta/, ou deixe vazio para todos

  • Máximo de resultados

    Em campos adicionais

    Quantidade máxima de objetos a retornar (padrão: 1000).

    Aparece em:
    Listar objetos
    Exemplo:
    10

  • Token de continuação

    Em campos adicionais

    Token de paginação (da resposta anterior).

    Aparece em:
    Listar objetos
    Exemplo:
    Token de paginação (da resposta anterior)

  • Bucket de origem

    Obrigatório conforme a operação

    Nome do bucket de origem.

    Aparece em:
    Copiar objeto
    Exemplo:
    Nome do bucket de origem

  • Chave do objeto de origem

    Obrigatório conforme a operação

    Caminho completo, dentro do bucket de origem, do arquivo que será copiado (ex.: relatorios/junho.pdf).

    Aparece em:
    Copiar objeto
    Exemplo:
    arquivoantigo.pdf ou pasta/arquivo.pdf

  • Bucket de destino

    Obrigatório conforme a operação

    Nome do bucket de destino (pode ser o mesmo da origem).

    Aparece em:
    Copiar objeto
    Exemplo:
    Nome do bucket de destino (pode ser o mesmo da origem)

  • Chave do objeto de destino

    Obrigatório conforme a operação

    Caminho completo, com o nome, que a cópia vai ter no bucket de destino (ex.: backup/relatorios/junho.pdf).

    Aparece em:
    Copiar objeto
    Exemplo:
    arquivonovo.pdf ou backup/arquivo.pdf

  • Controle de acesso

    Em campos adicionais

    Selecione a ACL do objeto copiado (padrão: privada).

    Aparece em:
    Copiar objeto
    Opções:
    Privado · Leitura pública · Leitura e gravação públicas · Leitura autenticada
    Exemplo:
    Privado

  • ID da versão

    Em campos adicionais

    ID da versão do objeto, opcional (para buckets com versionamento).

    Aparece em:
    Consultar objeto (metadados)
    Exemplo:
    id-do-recurso

  • Chaves dos objetos

    Obrigatório conforme a operação

    Uma chave por linha ou uma lista JSON (ex.: ["a.txt", "pasta/b.txt"]).

    Aparece em:
    Excluir objetos (em lote)
    Exemplo:
    ["a.txt", "pasta/b.txt"]

  • Modo silencioso

    Em campos adicionais

    Ativa ou desativa este comportamento.

    Aparece em:
    Excluir objetos (em lote)
    Exemplo:
    false

  • Tipo de URL

    Obrigatório conforme a operação

    Selecione o tipo de URL.

    Aparece em:
    Gerar URL pré-assinada
    Opções:
    Baixar (GET) · Enviar (PUT)
    Exemplo:
    Baixar (GET)

  • Expira em (segundos)

    Validade da URL em segundos (1-604800, padrão: 3600).

    Aparece em:
    Gerar URL pré-assinada
    Exemplo:
    Validade da URL em segundos (1-604800, padrão: 3600)

  • Tipo de conteúdo

    Em campos adicionais

    Content-Type que o envio precisa usar (só PUT).

    Aparece em:
    Gerar URL pré-assinada
    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Prefixo do bucket

    Filtre os buckets pelo prefixo do nome (opcional).

    Aparece em:
    Listar buckets
    Exemplo:
    Filtre os buckets pelo prefixo do nome (opcional)

  • Máximo de buckets

    Em campos adicionais

    Quantidade máxima de buckets a retornar (1-10000).

    Aparece em:
    Listar buckets
    Exemplo:
    10

  • Token de continuação

    Em campos adicionais

    Token de paginação (da resposta anterior).

    Aparece em:
    Listar buckets
    Exemplo:
    Token de paginação (da resposta anterior)

  • Controle de acesso

    Em campos adicionais

    Selecione a ACL do novo bucket (padrão: privada).

    Aparece em:
    Criar bucket
    Opções:
    Privado · Leitura pública · Leitura e gravação públicas · Leitura autenticada
    Exemplo:
    Privado

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <s3.url>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<s3.url>stringURL do objeto no S3.
<s3.uri>stringURI do S3 (s3://bucket/key) para usar com outros serviços da AWS.
<s3.file>fileArquivo baixado, guardado nos arquivos da execução.
<s3.objects>jsonLista de objetos (na operação de listar).
<s3.buckets>jsonLista de buckets (na operação de listar buckets).
<s3.deleted>jsonStatus da exclusão (booleano) ou objetos excluídos (lista).
<s3.errors>jsonExclusões que falharam (na exclusão em lote).
<s3.exists>booleanIndica se o objeto existe (na consulta de metadados).
<s3.metadata>jsonMetadados da operação.

Exemplo de uso

Objetivo: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

InícioS3próxima etapa
Operação
Baixar arquivo
Região da AWS
Usada quando a URL do S3 não inclui a região
URL do objeto no S3
https://api.exemplo.com/v1/recurso

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <s3.url>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Credencial ausente ou recusada
Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados