Standard Commands

This document provides instructions for managing IONOS Object Storage using the AWS CLI. Additionally, this task can also be performed through the DCD DCD and API.

Examples

List buckets

• Option 1: Using s3 set of commands:

  Copy

  aws s3 ls --endpoint-url https://s3.eu-central-2.ionoscloud.com

• Option 2: Using s3api set of commands:

  Copy

  aws s3api list-buckets --endpoint-url https://s3.eu-central-2.ionoscloud.com

• Create a bucket in the eu-central-2 region (Berlin, Germany):

  • Option 1: Using s3 set of commands:

    Copy

    aws s3 mb s3://my-bucket --region eu-central-2 --endpoint-url https://s3.eu-central-2.ionoscloud.com

  • Option 2: Using s3api set of commands:

    Copy

    aws s3api create-bucket --bucket my-bucket --region=eu-central-2 --create-bucket-configuration LocationConstraint=eu-central-2 --endpoint-url https://s3.eu-central-2.ionoscloud.com

• Create a bucket in the de region (Frankfurt, Germany) with Object Lock enabled:

  Copy

  aws s3api create-bucket --bucket my-bucket --object-lock-enabled-for-bucket --region=de --create-bucket-configuration LocationConstraint=de --endpoint-url https://s3.eu-central-1.ionoscloud.com

Upload and download objects

• Upload an object from the current directory to a bucket:

  Copy

  aws s3 cp filename.txt s3://my-bucket --endpoint-url https://s3.eu-central-2.ionoscloud.com
  

• Download all the objects from the my-bucket bucket to the local directory my-dir:

  Copy

  aws s3 cp s3://my-bucket my-dir --recursive --endpoint-url https://s3.eu-central-2.ionoscloud.com
  

Copy and sync objects

• Copy the object to the bucket:

  Copy

  aws s3 cp my-dir s3://my-bucket/ --recursive --endpoint-url https://s3.eu-central-2.ionoscloud.com

• Copy the contents of the local directory my-dir to the bucket my-bucket:

  Copy

  aws s3 cp my-dir s3://my-bucket/ --recursive --endpoint-url https://s3.eu-central-2.ionoscloud.com

  For more information, see the cp command reference.

• Copy all objects from my-source-bucket to my-dest-bucket excluding .zip files. The command does not support cross-region copying for IONOS Object Storage:

  Copy

  aws s3 cp s3://my-source-bucket/ s3://my-dest-bucket/ --recursive --exclude "*.zip" --endpoint-url https://s3.eu-central-2.ionoscloud.com`

• Sync the bucket my-bucket with the contents of the local directory my-dir:

  Copy

  aws s3 sync my-dir s3://my-bucket --endpoint-url https://s3.eu-central-2.ionoscloud.com

For more information, see sync command reference.