Conectores
Dados e Armazenamento

S3

11min

Objetivo/Resumo

Ao usar o conector S3, você pode integrar facilmente o Amazon S3 aos seus aplicativos, serviços ou fluxos de trabalho existentes, permitindo a manipulação de objetos armazenados na nuvem de forma flexível e escalável. Você pode realizar várias operações, como armazenamento de objetos, recuperação de objetos, listagem de objetos, exclusão de objetos, gerenciamento de buckets e transferência de dados.

Criando um fluxo utilizando o conector S3

Para criar um fluxo utilizando um conector S3 é preciso criar uma conexão e configurar o fluxo.

Criando conexão S3

OBS: Clique aqui e acesse nosso passo a passo para saber como criar uma conexão.

Estes são os seguintes parâmetros de configuração da conexão S3 que serão requisitados na hora da criação:

  • Nome: parâmetro padrão em qualquer criação de uma conexão, te ajudará a identificar melhor sua conexão.
  • Descrição: parâmetro padrão e opcional em qualquer criação de uma conexão, aqui você pode relatar detalhadamente para que fins servirá sua conexão.
  • ID de acesso: ou "Access Key" campo requerido para acesso ao serviço AWS.
  • Chave Secreta: ou "Secret Access Key" campo requerido para acesso ao serviço AWS.
  • Região: zona/local onde seu serviço será executado.

Configurando fluxo S3

Crie um fluxo e arraste o conector S3 para o canvas.

OBS: Clique aqui e acesse nosso passo a passo para saber como criar um fluxo.

Selecione o conector e na aba de Parametrização e preencha os seguintes parâmetros de configuração:

  • Recurso: entidade para qual será realizada a ação. No momento o conector dispões três recursos sendo eles, File, Bucket e Folder;
  • Operação: ação que será realizada para o recurso selecionado.
    • Operações disponiveis para recurso File:
      • Download: usado para buscar um arquivo no bucket, necessário informar nome do bucket e o caminho do arquivo que será feito o download;
      • Copy: usado para copiar um arquivo de um bucket para o outro, necessário informar nome de origem e de destino do bucket, e também o caminho da origem e o caminho de destino do arquivo;
      • Move: Usado para mover arquivos entre pastas, necessário informar nome do bucket, o caminho de origem do arquivo e o caminho de destino do arquivo.
      • Upload: usado para enviar um arquivo para o bucket, necessário informar nome do bucket, caminho para onde o arquivo será enviado e como será o envio do conteúdo que pode ser enviado utilizando Template ou De/para. Permite também carregar arquivos de imagem e pdf em formato base64, basta ativar a flag "Enviar base64" no Corpo
      • Delete: usado para excluir um arquivo, necessário informar nome do bucket e caminho do arquivo;
    • Operações disponiveis para recurso Bucket:
      • Create: usado para criar um bucket, necessário informar o nome do bucket que será criado;
      • Delete: usado para excluir um bucket, necessário informar o nome do bucket que será excluido;
    • Operações disponiveis para o recurso Folder:
      • Create: usado para criar uma pasta, necessário informar o nome do bucket e o nome da pasta;
      • Delete: usado para excluir uma pasta, necessário informar o nome do bucket e o nome da pasta;

Nota: Estes campos podem ser preenchidos usando Fluid Expression Language.

Na prática

Neste tópico será demonstrado um tutorial de como criar um fluxo utilizando o conector S3. O fluxo terá 2 passos sendo eles random e upload.

Document image


Passo 'random'

O passo random é um conector HTTP que fará um GET em uma api pública chamada random acessando o endpoint /api/v2/users que nos retornará dados de um usuário aleatório. Assim ficou as configurações do nosso conector HTTP na aba Parametrização:

Document image


Já na aba Propriedades é informado apenas o nome do passo, pois o get nessa api não precisa de nenhum tipo de conexão:

Document image


Nota: Para obter detalhes sobre nosso conector HTTP clique em saiba mais.

Fluxo de mensagens

Entrada:

Neste caso não possui dados de entrada

Saída:

JSON


Passo 'upload'

O passo upload é usado um conector S3 que enviará um arquivo para o bucket ultilizando o De/para para fazer a transformação dos dados recebidos no passo random , e assim criar o conteúdo do arquivo. Assim ficou as configurações do nosso conector S3 na aba Parametrização:

Document image


De/Para usado para criar o objeto do conteúdo:

Document image


Na aba Propriedades informamos o nome do passo, a conexão criada com as credenciais da AWS:

Document image


Fluxo de mensagens

Entrada:

JSON


Resultado do de/para do conteúdo:

JSON


Saída:

JSON


Resultado

Após disparar o fluxo podemos ver o resultado final nos logs que aparecerá no canvas, e clicando em detalhes teremos os dados da requisição e da resposta:

Document image


E se olharmos no bucket e no caminho usado no exemplo do passo 'upload' podemos vizualizar o arquivo 'teste.json' criado com o conteúdo gerado:

Document image




Updated 30 Apr 2024
Doc contributor
Doc contributor
Did this page help you?