Skip to main content

Using Storin with AWS CLI

Introduction​

Storin is compatible with the Amazon S3 API, which allows using various existing tools and libraries to manage buckets and objects.

One of these tools is the AWS CLI, an official Amazon command-line interface that allows interacting with S3-compatible services directly from the terminal.

This documentation will demonstrate:

  • How to install the AWS CLI
  • How to configure the Access Keys
  • How to connect to the Storin S3 endpoint
  • How to perform basic operations with buckets and objects

Installing the AWS CLI​

Linux​

Download and install the AWS CLI using the commands below:

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

After installation, verify if the command is available:

aws --version

Example output:

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

Windows​

  1. Download the official installer:
https://awscli.amazonaws.com/AWSCLIV2.msi

  1. Run the .msi installer.

  2. After installation, open PowerShell or Command Prompt and verify:

aws --version

MacOS​

Install using the official installer:

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

Verify the installation:

aws --version

Configuring credentials​

After installing the AWS CLI, run the command below to configure your credentials:

aws configure

Fill in the requested information:

AWS Access Key ID: YOUR_ACCESS_KEY AWS Secret Access Key: YOUR_SECRET_KEY Default region name: sp1 Default output format: json

The Access Key and Secret Key are the same ones generated in the Storin panel under Access.

The region must be the same region where the keys were created.

The Default output format field defines the format in which the AWS CLI will display command responses in the terminal.

Available formats are:

  • json – AWS CLI's default format. Displays the response structured in JSON, most used for integrations, scripts, and automations.
  • table – Shows the output in table format, facilitating visual reading in the terminal.
  • text – Displays the response in plain text, useful for use in shell pipelines or simple scripts.
  • yaml – Returns data in YAML format, which is also structured and readable.

We recommend using json, as it is the AWS CLI default format and the most used in documentation and integrations.

If you have not yet created your keys, refer to the previous documentation about Access Key and Secret Key.

Compatibility adjustment​

Some recent versions of the AWS CLI automatically use new checksum mechanisms in uploads to S3.

Since some S3-compatible services do not yet support this format, the error may occur:

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

If this happens, run the commands below:

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

Storin Endpoint​

Since Storin is an S3-compatible service (and not the AWS service itself), it is necessary to manually specify the endpoint in requests.

Example endpoint:

https://sp1-s3.saveincloud.io

This endpoint will be used in commands through the parameter:

--endpoint-url

Listing buckets​

To list all buckets available in the account:

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

Listing objects in a bucket​

To list files inside a bucket:

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

Uploading a file to the bucket​

To upload a local file to the bucket:

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

After the upload, the file will be available inside the bucket in Storin.

Downloading a file from the bucket​

To download a file stored in the bucket:

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

The file will be downloaded to the current directory.

Removing an object from the bucket​

To remove a file stored in the bucket:

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

Next steps​

With the AWS CLI configured, it is possible to automate various operations with Storin, such as:

  • Uploading and downloading files
  • Directory synchronization
  • Backup automation
  • Integration with scripts and applications

In the next documentation, we will see how to generate Presigned URLs to allow temporary access to objects stored in Storin.

📚 Documentation and Resources​

🧠 Support​

If you have questions or need help with configuration, contact Saveincloud support through the channels available on the platform.