Saltar al contenido principal

Usando Storin con AWS CLI

Introducción​

El Storin es compatible con la API Amazon S3, lo que permite utilizar diversas herramientas y bibliotecas ya existentes para gestionar buckets y objetos.

Una de estas herramientas es el AWS CLI, una interfaz de línea de comandos oficial de Amazon que permite interactuar con servicios compatibles con S3 directamente desde la terminal.

En esta documentación se mostrará:

  • Cómo instalar el AWS CLI
  • Cómo configurar las Access Keys
  • Cómo conectar al endpoint S3 de Storin
  • Cómo realizar operaciones básicas con buckets y objetos

Instalando el AWS CLI​

Linux​

Descargue e instale el AWS CLI utilizando los siguientes comandos:

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

Después de la instalación, verifique si el comando está disponible:

aws --version

Ejemplo de salida:

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

Windows​

  1. Descargue el instalador oficial:
https://awscli.amazonaws.com/AWSCLIV2.msi

  1. Ejecute el instalador .msi.

  2. Después de la instalación, abra PowerShell o el Símbolo del sistema y verifique:

aws --version

MacOS​

Instale utilizando el instalador oficial:

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

Verifique la instalación:

aws --version

Configurando las credenciales​

Después de instalar el AWS CLI, ejecute el siguiente comando para configurar sus credenciales:

aws configure

Complete la información solicitada:

AWS Access Key ID: SU_ACCESS_KEY AWS Secret Access Key: SU_SECRET_KEY Default region name: sp1 Default output format: json

Las Access Key y Secret Key son las mismas generadas en el panel de Storin en Access.

La región debe ser la misma región donde se crearon las claves.

El campo Default output format define el formato en que el AWS CLI mostrará las respuestas de los comandos en la terminal.

Los formatos disponibles son:

  • json – Formato predeterminado del AWS CLI. Muestra la respuesta estructurada en JSON, siendo el más utilizado para integraciones, scripts y automatizaciones.
  • table – Muestra la salida en formato de tabla, facilitando la lectura visual en la terminal.
  • text – Muestra la respuesta en texto simple, útil para uso en pipelines de shell o scripts simples.
  • yaml – Devuelve los datos en formato YAML, que también es estructurado y legible.

Recomendamos usar json, ya que es el formato predeterminado del AWS CLI y el más utilizado en documentación e integraciones.

Si aún no ha creado sus claves, consulte la documentación anterior sobre Access Key y Secret Key.

Ajuste de compatibilidad​

Algunas versiones recientes del AWS CLI utilizan automáticamente nuevos mecanismos de checksum en cargas a S3.

Como algunos servicios compatibles con S3 aún no soportan este formato, puede ocurrir el error:

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

Si esto sucede, ejecute los siguientes comandos:

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

Endpoint de Storin​

Como Storin es un servicio compatible con S3 (y no el propio servicio de AWS), es necesario informar manualmente el endpoint en las solicitudes.

Ejemplo de endpoint:

https://sp1-s3.saveincloud.io

Este endpoint será utilizado en los comandos mediante el parámetro:

--endpoint-url

Listando buckets​

Para listar todos los buckets disponibles en la cuenta:

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

Listando objetos de un bucket​

Para listar los archivos dentro de un bucket:

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

Enviando un archivo al bucket​

Para enviar un archivo local al bucket:

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

Después de la carga, el archivo estará disponible dentro del bucket en Storin.

Descargando un archivo del bucket​

Para descargar un archivo almacenado en el bucket:

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

El archivo será descargado en el directorio actual.

Eliminando un objeto del bucket​

Para eliminar un archivo almacenado en el bucket:

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

Próximos pasos​

Con el AWS CLI configurado, es posible automatizar diversas operaciones con Storin, tales como:

  • Subida y descarga de archivos
  • Sincronización de directorios
  • Automatización de backups
  • Integración con scripts y aplicaciones

En la próxima documentación veremos cómo generar URLs pre-firmadas (Presigned URLs) para permitir acceso temporal a objetos almacenados en Storin.

📚 Documentación y Recursos​

🧠 Soporte​

Si tiene dudas o necesita ayuda con la configuración, contacte con el soporte de Saveincloud a través de los canales disponibles en la plataforma.