S3
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.
Para criar um fluxo utilizando um conector S3 é preciso criar uma conexão e configurar o fluxo.
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.
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.
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.
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:
Já na aba Propriedades é informado apenas o nome do passo, pois o get nessa api não precisa de nenhum tipo de conexão:
Nota: Para obter detalhes sobre nosso conector HTTP clique em saiba mais.
Fluxo de mensagens
Entrada:
Saída:
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:
De/Para usado para criar o objeto do conteúdo:
Na aba Propriedades informamos o nome do passo, a conexão criada com as credenciais da AWS:
Fluxo de mensagens
Entrada:
Resultado do de/para do conteúdo:
Saída:
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:
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: