Pular para o conteúdo principal

Utilizando o Storin com AWS CLI

Introdução​

O Storin é compatível com a API Amazon S3, o que permite utilizar diversas ferramentas e bibliotecas já existentes para gerenciar buckets e objetos.

Uma dessas ferramentas é o AWS CLI, uma interface de linha de comando oficial da Amazon que permite interagir com serviços compatíveis com S3 diretamente pelo terminal.

Nesta documentação será demonstrado:

  • Como instalar o AWS CLI
  • Como configurar as Access Keys
  • Como conectar ao endpoint S3 do Storin
  • Como realizar operações básicas com buckets e objetos

Instalando o AWS CLI​

Linux​

Baixe e instale o AWS CLI utilizando os comandos abaixo:

curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

Após a instalação, verifique se o comando está disponível:

aws --version

Exemplo de saída:

aws-cli/2.x.x Python/3.x Linux/x86_64

Windows​

  1. Baixe o instalador oficial:
https://awscli.amazonaws.com/AWSCLIV2.msi

  1. Execute o instalador .msi.

  2. Após a instalação, abra o PowerShell ou Prompt de Comando e verifique:

aws --version

MacOS​

Instale utilizando o instalador oficial:

curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
sudo installer -pkg AWSCLIV2.pkg -target /

Verifique a instalação:

aws --version

Configurando as credenciais​

Após instalar o AWS CLI, execute o comando abaixo para configurar suas credenciais:

aws configure

Preencha as informações solicitadas:

AWS Access Key ID: SUA_ACCESS_KEY AWS Secret Access Key: SUA_SECRET_KEY Default region name: sp1 Default output format: json

As Access Key e Secret Key são as mesmas geradas no painel do Storin em Access.

A region deve ser a mesma região onde as chaves foram criadas.

O campo Default output format define o formato em que o AWS CLI exibirá as respostas dos comandos no terminal.

Os formatos disponíveis são:

  • json – Formato padrão do AWS CLI. Exibe a resposta estruturada em JSON, sendo o mais utilizado para integrações, scripts e automações.
  • table – Mostra a saída em formato de tabela, facilitando a leitura visual no terminal.
  • text – Exibe a resposta em texto simples, útil para uso em pipelines de shell ou scripts simples.
  • yaml – Retorna os dados no formato YAML, que também é estruturado e legível.

Recomendamos utilizar json, pois é o formato padrão do AWS CLI e o mais utilizado em documentações e integrações.

Caso ainda não tenha criado suas chaves, consulte a documentação anterior sobre Access Key e Secret Key.

Ajuste de compatibilidade​

Algumas versões recentes da AWS CLI utilizam automaticamente novos mecanismos de checksum em uploads para S3.

Como alguns serviços compatíveis com S3 ainda não suportam esse formato, pode ocorrer o erro:

ValidationError: The input fails to satisfy the constraints specified by an AWS service.

Caso isso aconteça, execute os comandos abaixo:

aws configure set default.request_checksum_calculation when_required
aws configure set default.response_checksum_validation when_required

Endpoint do Storin​

Como o Storin é um serviço compatível com S3 (e não o próprio serviço da AWS), é necessário informar manualmente o endpoint nas requisições.

Exemplo de endpoint:

https://sp1-s3.saveincloud.io

Esse endpoint será utilizado nos comandos através do parâmetro:

--endpoint-url

Listando buckets​

Para listar todos os buckets disponíveis na conta:

aws s3 ls --endpoint-url https://sp1-s3.saveincloud.io

Listando objetos de um bucket​

Para listar os arquivos dentro de um bucket:

aws s3 ls s3://nome-do-bucket --endpoint-url https://sp1-s3.saveincloud.io

Enviando um arquivo para o bucket​

Para enviar um arquivo local para o bucket:

aws s3 cp arquivo.txt s3://nome-do-bucket --endpoint-url https://sp1-s3.saveincloud.io

Após o upload, o arquivo estará disponível dentro do bucket no Storin.

Baixando um arquivo do bucket​

Para baixar um arquivo armazenado no bucket:

aws s3 cp s3://nome-do-bucket/arquivo.txt . --endpoint-url https://sp1-s3.saveincloud.io

O arquivo será baixado para o diretório atual.

Removendo um objeto do bucket​

Para remover um arquivo armazenado no bucket:

aws s3 rm s3://nome-do-bucket/arquivo.txt --endpoint-url https://sp1-s3.saveincloud.io

Próximos passos​

Com o AWS CLI configurado, é possível automatizar diversas operações com o Storin, como:

  • Upload e download de arquivos
  • Sincronização de diretórios
  • Automação de backups
  • Integração com scripts e aplicações

Na próxima documentação veremos como gerar URLs pré-assinadas (Presigned URLs) para permitir acesso temporário a objetos armazenados no Storin.

📚 Documentação e Recursos​

🧠 Suporte​

Caso tenha dúvidas ou precise de ajuda na configuração, entre em contato com o suporte da Saveincloud através dos canais disponíveis na plataforma.