Vidensdatabase

1. Create your credentials

   For a step-by-step guide, see the getting started article "Generating S3 credentials".

   Make sure you save the keys locally right after you create them as it is not possible to view the secret key again, neither via Cloud Console nor via API.

2. Check curl version

   • curl version 7.86 or above

   On Debian, you have to enable the bookworm-backports apt repository and install curl from that.

   You can run curl -V to check the version.

   This getting started will use --aws-sigv4 for the signature (see curl documentation).

3. Set up environment variables

   Replace <access_key>, <secret_key>, and <region> (e.g. fsn1) with your actual information, and run the command below to add the environment variables in ~/.bashrc.

   cat << 'EOF' >> ~/.bashrc
   export ACCESS_KEY="<access_key>"
   export SECRET_KEY="<secret_key>"
   export REGION="<region>"
   export ENDPOINT="${REGION}.your-objectstorage.com"
   EOF

   Now update your environment variables:

   source ~/.bashrc

4. Manage your Buckets

   • List all Buckets

     curl -sS "https://${ENDPOINT}/" \
       --user "${ACCESS_KEY}:${SECRET_KEY}" \
       --aws-sigv4 "aws:amz:${REGION}:s3" \
       | grep -oP "<Name>\K[^<]+"

   
   

   • Create a Bucket

     Replace <bucket_name> with an available name.

     curl \
       -X PUT \
       --user "${ACCESS_KEY}:${SECRET_KEY}" \
       --aws-sigv4 "aws:amz:${REGION}:s3" \
       "https://${ENDPOINT}/<bucket_name>"

   
   

   • Delete a Bucket

     Replace <bucket_name> with the actual name.

     curl \
       -X DELETE \
       --user "${ACCESS_KEY}:${SECRET_KEY}" \
       --aws-sigv4 "aws:amz:${REGION}:s3" \
       "https://${ENDPOINT}/<bucket_name>"

5. Manage your objects

   • List objects

     Replace <bucket_name> with the actual name.

     curl -sS "https://<bucket_name>.${ENDPOINT}" \
       --user "${ACCESS_KEY}:${SECRET_KEY}" \
       --aws-sigv4 "aws:amz:${REGION}:s3" \
       | grep -oP "<Key>\K[^<]+"

   
   

   • Upload objects

     Replace <bucket_name>, <filename>, and <local_filename> with the actual names.

     curl "https://<bucket_name>.${ENDPOINT}/<filename>" \
       -T "<local_filename>" \
       --user "${ACCESS_KEY}:${SECRET_KEY}" \
       --aws-sigv4 "aws:amz:${REGION}:s3"

   
   

   • Download objects

     Replace <bucket_name>, <filename>, and <local_filename> with the actual names.

     curl "https://<bucket_name>.${ENDPOINT}/<filename>" \
       -o "<local_filename>" \
       --user "${ACCESS_KEY}:${SECRET_KEY}" \
       --aws-sigv4 "aws:amz:${REGION}:s3"

   
   

   • Delete objects

     Replace <bucket_name> and <filename> with the actual names.

     curl "https://<bucket_name>.${ENDPOINT}/<filename>" \
       -X DELETE \
       --user "${ACCESS_KEY}:${SECRET_KEY}" \
       --aws-sigv4 "aws:amz:${REGION}:s3"

You should now be ready to manage your Buckets. For more information about available functions, see the article "List of supported actions".