Obtém um arquivo de um bucket Amazon S3 (ou Armazenamento dos Serviços de Cloud).

Figura 1 – Bloco Abrir arquivo do S3

Compatibilidade

• Bloco servidor: cronapp.AmazonS3Service.obterArquivo()

Retorno

Retorna o endereço onde o arquivo obtido do bucket S3 foi salvo.

Parâmetros

Chave de acesso

No bucket da Amazon, este campo corresponde a caixa de seleção Access Key, da aba de configuração "Select AWS access type" nas configurações do AWS Iam User. No Cronapp este campo corresponde ao campo "Chave de acesso" da janela de configuração do bucket (destaque 4 da figura 2).

• Posição: 1
• Inglês: Access key
• Tipo: String
• Exemplo:  "AKIAY2KVNQTZB7CCAOOT"

Chave secreta

No bucket da Amazon, a chave secreta, ou Secret Acess Key, é gerada ao finalizar a criação de um usuário. No Cronapp este parâmetro corresponde ao campo "Senha de acesso" da janela de configuração do bucket (destaque 5 da figura 2).

• Posição: 2
• Inglês: Secret key
• Tipo: Texto / String
• Exemplo: "GrXNP6X6zS5SZNgky5B+xZ8LDpBCKCo+XzMwJv/8"

Nome do bucket

No bucket da Amazon, este parâmetro corresponde ao parâmetro Name, do formulário de criação do bucket. No Cronapp, podemos relacioná-lo ao campo "Nome" da janela de configuração do bucket (destaque 6 da figura 2).

• Posição: 3
• Inglês: Bucket name
• Tipo: Texto / String
• Exemplo: "s3.storage.cloud.cronapp.io"

Arquivo de origem

Caminho do arquivo que consta no bucket. É necessário informar o nome e extensão do arquivo.

• Posição: 4
• Inglês: Local file
• Tipo: Texto / String
• Exemplo: "imagemS3/cronapp-nuvem.png" 

Caminho de destino

Caminho do arquivo que será salvo no projeto. É necessário informar a extensão do arquivo.

• Posição: 5
• Inglês: Path to save
• Tipo: Texto / String
• Exemplo: "src/main/webapp/public/assets/imagem/cronapp-nuvem-s3.png"

Região

No bucket da Amazon, este parâmetro corresponde ao parâmetro Aws Region, do formulário de criação do bucket. No Cronapp, podemos relacioná-lo ao campo correspondente ao texto selecionado no campo "CNAME" da janela de configuração do bucket (destaque 7 da figura 2).

• Posição: 6
• Inglês: Region
• Tipo: String
• Exemplo:  "US_EAST_1"

Exemplo

A configuração dos parâmetros no bloco é diretamente influenciada pelas configurações do bucket Amazon S3. Neste exemplo específico, estamos utilizando o Serviço de Cloud Armazenamento, fornecido pelo Cronapp.

Para acessar o Serviço de Cloud, clique no ícone em forma de nuvem (destaque 1 na figura 2) e, em seguida, vá para a aba "Armazenamento" (2). Neste exemplo, já temos um bucket previamente criado, consulte a documentação de Serviços de Cloud para obter informações detalhadas sobre como criar um bucket.

Para visualizar a janela com os parâmetros necessários para o bloco, é necessário editar o bucket (3). Uma vez que a janela estiver aberta, basta copiar os campos correspondentes e colá-los nos parâmetros correspondentes no bloco.

Figura 2 – Acesso e configuração do bucket S3

Usaremos o bloco Abrir arquivo do S3 para obter um arquivo do S3, portanto, no parâmetro "Arquivo de origem", devemos informar o endereço do arquivo que consta no bucket, e no parâmetro "Caminho de destino", informamos o endereço no qual o arquivo será armazenado no nosso projeto.

O parâmetro destacado em azul no campo 7 da figura 2 deve ser inserido como o último parâmetro no bloco.

Figura 2.1 – Configuração do bloco com os parâmetros do bucket

O resultado da execução da função anterior pode ser conferido abaixo. O arquivo foi obtido do bucket S3 e seu endereço de destino está impresso no console do depurador.

Figura 2.2 – Arquivo obtido do bucket