Once your S3 gateway has been configured, you will be provided with the hostname, secret key, access key and region for accessing it.
Minio Client (Command Line Client)
As the CloudStor S3 gateways are based on Minio (https://www.minio.io), we recommend using the Minio client to access it. The Minio client is available here: https://www.minio.io/downloads.html#download-client
Once you have the Minio client, you can add your gateway using the following command:
mc config host add your-s3 https://your-s3.s3.aarnet.edu.au YOUR-ACCESS-KEY YOUR-SECRET-KEY
Basics
Function | Example command |
List bucket contents | mc ls your-s3/your-bucket-name |
Copy a file | mc cp path/to/your/file your-s3/your-bucket-name |
Copy a directory | mc mirror path/to/your/folder your-s3/your-bucket-name |
Mirror a local directory to S3 | mc mirror path/to/your/folder your-s3/your-bucket-name |
Mirror S3 to a local directory | mc mirror your-s3/your-bucket-name path/to/your/folder |
More information on the Minio client can be found here:
https://docs.minio.io/docs/minio-client-complete-guide
CyberDuck (GUI client)
As CyberDuck is also compatible with WebDAV and other file protocols, we suggest using it with S3 as well. It does not come pre-configured with a custom S3 profile, so you will need to follow the "Generic S3 Profiles" instructions before being able to use it with your S3 Gateway.
CyberDuck is available from: https://cyberduck.io/
Generic S3 Profiles instructions: https://trac.cyberduck.io/wiki/help/en/howto/s3