Using curl - Hetzner Docs

⚠️ Object Storage is currently in Beta test. For more information see this FAQ: Object Storage » Beta test

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.

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).

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
```

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>"

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".

Next:

Using S3 compatible API tools