Standard Commands

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

Prerequisites:

• Set up the AWS CLI by following the installation instructions.

• Make sure to consider the supported S3 Endpoints.

Examples

List buckets

• Option 1: Using s3 set of commands:

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

• Option 2: Using s3api set of commands:

  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:

    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:

    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:

  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:

  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:

  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:

  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:

  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 S3 Object Storage:

  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:

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

For more information, see sync command reference.