Cloud / AWS

Amazon S3, SQS e Lambda

Configurar AWS

aws.configure

Define credenciais e região

Como usar

Cria a sessão AWS usada pelos demais comandos, com access key e secret do cofre e a região. Deixe a access key vazia para usar as credenciais já configuradas na máquina. O endpoint permite usar serviços compatíveis, como MinIO.

Exemplo: Configure a região sa-east-1 com a chave do robô e o segredo AWS_SECRET em {aws}.

Campos

Campo	Tipo	Padrão
Access key ID (vazio = credenciais da máquina)	Texto
Secret access key (cofre)	Credencial do cofre
Região	Texto	`us-east-1`
Salvar a sessão na variável *	Variável de saída	`aws`

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Session token (cofre)	Credencial do cofre
Endpoint (MinIO, LocalStack...)	Texto

Resultado: guardado na variável aws (Objeto).

S3 Upload

aws.s3_upload

Faz upload para bucket S3

Como usar

Envia um arquivo para um bucket S3. A chave é o caminho no bucket: vazia usa o nome do arquivo; terminando em / funciona como pasta.

Exemplo: Envie {relatorio} para o bucket relatorios-financeiro na chave {ano}/{mes}/.

Campos

Campo	Tipo	Padrão
Sessão AWS *	Variável	`aws`
Arquivo *	Arquivo
Bucket *	Texto
Chave (caminho no bucket; vazio = nome do arquivo; terminando em / = pasta)	Texto
Salvar o endereço s3:// na variável	Variável de saída

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Tipo de conteúdo (Content-Type)	Texto

Resultado: guardado na variável escolhida (Texto).

S3 Download

aws.s3_download

Faz download do S3

Como usar

Baixa um objeto do S3 para uma pasta ou arquivo local e guarda o caminho.

Exemplo: Baixe entrada/pedidos.csv do bucket integracoes para C:\Robos\entrada.

Campos

Campo	Tipo	Padrão
Sessão AWS *	Variável	`aws`
Bucket *	Texto
Chave (caminho no bucket) *	Texto
Salvar em (pasta ou arquivo) *	Pasta
Salvar o caminho na variável	Variável de saída

Resultado: guardado na variável escolhida (Texto).

S3 Listar Objetos

aws.s3_list

Lista objetos de um bucket

Como usar

Lista os objetos de um bucket, opcionalmente só os de um prefixo (pasta), com tamanho e data.

Exemplo: Liste o prefixo entrada/ do bucket integracoes e baixe os novos.

Campos

Campo	Tipo	Padrão	Detalhes
Sessão AWS *	Variável	`aws`
Bucket *	Texto
Prefixo (pasta)	Texto
Salvar resultado na variável *	Variável de saída	`objects`	Lista de {key, size, modified}

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Máximo de itens (0 = todos)	Número	`1000`

Resultado: guardado na variável objects (Lista).

SQS Enviar

aws.sqs_send

Envia mensagem para fila SQS

Como usar

Envia uma mensagem para uma fila SQS (pelo nome ou URL), com atraso opcional e grupo para filas FIFO. Dicionários e listas viram JSON.

Exemplo: Envie {pedido} para a fila pedidos-novos.

Campos

Campo	Tipo	Padrão	Detalhes
Sessão AWS *	Variável	`aws`
Fila (nome ou URL) *	Texto
Mensagem *	Texto		Texto, ou variável com dicionário/lista (vai como JSON)
Salvar o ID da mensagem na variável	Variável de saída

+ Avançado (2)

Campo	Tipo	Padrão	Detalhes
Atraso	Número	`0 s`
Grupo (filas FIFO)	Texto

Resultado: guardado na variável escolhida (Texto).

SQS Receber

aws.sqs_receive

Recebe mensagens da fila SQS

Como usar

Recebe até N mensagens da fila, esperando alguns segundos, já convertendo JSON e removendo da fila depois de ler (se marcado).

Exemplo: Receba até 10 mensagens de pedidos-novos e processe cada uma com Para Cada.

Campos

Campo	Tipo	Padrão	Detalhes
Sessão AWS *	Variável	`aws`
Fila (nome ou URL) *	Texto
Máximo de mensagens	Número	`1`
Esperar até	Número	`5 s`
Remover da fila depois de ler	Sim/Não	`Sim`
Salvar resultado na variável *	Variável de saída	`messages`	Lista de {id, body}; vazia se não houver mensagens

+ Avançado (1)

Campo	Tipo	Padrão	Detalhes
Converter JSON em dicionário/lista	Sim/Não	`Sim`

Resultado: guardado na variável messages (Lista).

Lambda Invocar

aws.lambda_invoke

Invoca função Lambda

Como usar

Chama uma função Lambda com os dados informados e guarda o retorno, ou dispara sem esperar o resultado.

Exemplo: Invoque calcular-frete com {pedido} e use {result.valor}.

Campos

Campo	Tipo	Padrão	Detalhes
Sessão AWS *	Variável	`aws`
Função (nome ou ARN) *	Texto
Dados enviados	Texto		Variável com dicionário/lista ou texto JSONEx.: `{dados}`
Não esperar o resultado	Sim/Não	`Não`
Salvar resultado na variável *	Variável de saída	`result`

Resultado: guardado na variável result (Qualquer).