Skip to main content
Last update:


AWS CLI (AWS Command Line Interface) is a command line interface for working with AWS services.

Through the AWS CLI, you can work with the S3 API.

Customize AWS CLI

  1. Configure access.
  2. Install client.
  3. Create AWS CLI configuration.

1. Configure access

Access can be configured by a user with role Account Owner or User Administrator.

  1. Create a service user with a role with access to object storage, see Role Model Access for details.
  2. Issue the user an S3 key.

2. Install the client

Use the Install or update to the latest version of the AWS CLI instructions in the Amazon documentation.

3. Create an AWS CLI configuration

  1. Open the terminal.

  2. Open the configuration mode:

    aws configure
  3. Enter AWS Access Key ID — the value of the Access key field from S3-key.

  4. Enter AWS Secret Access Key — the value of the Secret key field from the S3 key.

  5. Enter Default region name — pool (ru-1).

  6. The settings will be saved in the configuration files:

    • credentials in .aws/credentials:

      aws_access_key_id = <access_key>
      aws_secret_access_key = <secret_key>
    • default pool in .aws/config:

      region = ru-1
  7. If you want to use Virtual-Hosted addressing, add a parameter to the .aws/config configuration file:

    s3 =
    addressing_style = virtual

Working with AWS CLI

For command syntax, see the AWS instructions in the Amazon documentation.

To work with object storage through the AWS CLI, use:

  • s3api — commands corresponding to operations in the REST API;
  • s3 — additional commands simplifying work with a large number of objects.

When running the aws command, the --endpoint-url= parameter is mandatory, where ru-1 is pool.

Create a container

Create a container:

aws --endpoint-url= s3 mb s3://<container_name>


  • ru-1 — pool;
  • <container_name> is the name of the new container.

View a list of facilities

Check out the list of facilities:

aws --endpoint-url= s3 ls --recursive s3://<container_name>


  • ru-1 — pool;
  • <container_name> is the name of the container.

Download the object

Upload the files to the repository:

aws --endpoint-url= s3 cp <object_name> s3://<container_name>/


  • ru-1 — pool;
  • <object_name> is the name of the object;
  • <container_name> is the name of the container.

Delete object

Delete the object:

aws --endpoint-url= s3 rm s3://<container_name>/<object_name>


  • ru-1 — pool;
  • <container_name> is the name of the container;
  • <object_name> is the name of the object.