S3 API and CLI Access

Get the S3 Endpoint URL#

From the Bucket Settings grab the "S3 Url".
It should look like this:

https://object-store.<region-name>.acvile.cloud/<bucket-name>

You can determine the the S3 Endpoint URL by removing the /<bucket-name> path:

S3 Endpoint URL example#

https://object-store.eu-east-1.acvile.cloud

Create API Credentials#

Navigate to "API Access" -> "S3 / EC2 Credentials" and create a new pair of access key and secret.

s3-api

AWS CLI#

This guide assumes you've already installed the AWS CLI on your computer.

Edit your ~/.aws/credentials file to add the access and secret key.

[default]aws_access_key_id = <access_key> aws_secret_access_key = <secret_key> region = eu-east-1

Specify the S3 Endpoint URL to the --endpoint-url parameter of the aws s3 command.

List the available buckets#

aws --endpoint-url https://object-store.eu-east-1.acvile.cloud s3 ls

API access (AWS SDK)#

You can easily integrate the S3 API into your application by using an official AWS S3 SDK available for your programming language.
Here is a convenient list: