|

Como acessar o Object Storage Nevolus – Via AWS CLI

PorNevolus - Suporte

Esse guia tem como objetivo documentar a configuração e utilização do AWS CLI para realizar upload de arquivos no object storage da Nevolus.

É necessário possuir:

  • AWS CLI instalado;
  • Access Key fornecida pelo serviço;
  • Secret Key fornecida pelo serviço;
  • acesso ao bucket desejado.

Verificando instalação:

Verificar se o AWS CLI está instalado:

aws --version

Deve aparecer algo como: 

aws-cli/2.36.44 Python/3.14.6 Linux/6.8.0-124-generic exe/x86_64.ubuntu.24

Configuração do profile:

Criar o profile:

aws configure --profile SEU_PROFILE

Preencher as informações solicitadas:

AWS Access Key ID: SUA_ACCESS_KEY
AWS Secret Access Key: SUA_SECRET_KEY
Default region name: us-east-1
Default output format: json

As credenciais ficam armazenadas no profile SEU_PROFILE, permitindo utilizar esse profile sem alterar a configuração padrão do AWS CLI.

Nota: O storage apresenta incompatibilidade com o mecanismo de checksum utilizado por versões recentes do AWS CLI.

Sem essa configuração, o upload pode falhar com: XAmzContentSHA256Mismatch

E o AWS CLI pode apresentar adicionalmente: argument of type ‘NoneType’ is not a container or iterable

Para corrigir, configurar o profile wiki com:

aws configure set request_checksum_calculation WHEN_REQUIRED --profile SEU_PROFILE
aws configure set response_checksum_validation WHEN_REQUIRED --profile SEU_PROFILE

Também é recomendado utilizar path-style addressing:

aws configure set s3.addressing_style path --profile SEU_PROFILE

Teste de conexão com Storage:

Antes de realizar uploads, validar se o bucket está acessível:

aws s3 ls s3://s3profile \
  --endpoint-url https://br-south-1-files.acessoseguro.net \
  --profile SEU_PROFILE

Se estiver funcionando, os arquivos existentes no bucket serão listados:

2026-09-14 12:40:41      25834 teste.pdf

Upload de um arquivo/pasta:

Para enviar um arquivo local para o storage:

aws s3 cp /CAMINHO/DO/ARQUIVO s3://s3profile/ \
  --endpoint-url https://br-south-1-files.acessoseguro.net \
  --profile SEU_PROFILE

Em uma única linha:

aws s3 cp /CAMINHO/DO/ARQUIVO s3://s3profile/ --endpoint-url https://br-south-1-files.acessoseguro.net --profile SEU_PROFILE

Para verificar: 

aws s3 ls s3://s3profile \
  --endpoint-url https://br-south-1-files.acessoseguro.net \
  --profile SEU_PROFILE

AVISO LEGAL: Os procedimentos descritos neste documento devem ser executados de acordo com o contexto de cada sistema, de forma a evitar impactos negativos à segurança, disponibilidade, integridade e privacidade de dados. A Nevolus se reserva o direito de modificar a qualquer tempo e sem aviso prévio as informações aqui apresentadas a fim de refletir o lançamento de novos serviços, atualizações físicas e operacionais, e evolução do estado-da-arte da tecnologia.

Posts Similares