S3cmd is a command line tool (for Linux and Mac) designed for services that support the Amazon S3 HTTP API. The general procedure for running commands can be found in the official S3cmd documentation.
Before you start
To install S3cmd, follow the instructions in the project repository.
To configure S3cmd, use the
s3cmd --configure command. The command will request values for the following parameters:
Access Key: enter the ID of the key that you received when generating the static key.
Secret Key: enter the secret key that you received when generating the static key.
Default Region: enter
To work with Object Storage, always specify the
us-east-1region. A different value of the region may lead to an authorization error.
S3 Endpoint: enter
DNS-style bucket+hostname:port template for accessing a bucket: enter
Leave the other parameter values of the other parameters unchanged.
The client will try to establish a connection with Object Storage and get a list of buckets. If successful, it will return
Success. Your access key and secret key worked fine :-).
s3cmd --configure command saves the settings to a
~/.s3cfg file in the format:
[default] access_key = id secret_key = secretKey bucket_location = us-east-1 host_base = storage.yandexcloud.net host_bucket = %(bucket)s.storage.yandexcloud.net
If necessary, you can change these settings directly in the file. You can also specify settings when launching the client by using the appropriate parameters.
For the static website hosting control commands to work correctly, manually add the following parameter to the configuration file:
website_endpoint = http://%(bucket)s.website.yandexcloud.net
Remember that S3cmd works with Object Storage like a hierarchical file system and object keys look like a file path.
Create a bucket
s3cmd mb s3://bucket
When creating a bucket, follow the naming guidelines.
Uploading an object
s3cmd put local_file s3://bucket/object
Getting a list of objects
s3cmd ls s3://bucket
Retrieve an object
s3cmd get s3://bucket/object local_file
Deleting an object
s3cmd del s3://bucket/object