S3: Quick start

You can work with S3 in the control panel and via API.

1. Create a bucket.
2. Optional: configure bucket access.
3. Optional: set limits.
4. Optional: select a tool to work with the storage.
5. Upload objects to the bucket.

1. Create a bucket

1. Top up the balance.

2. In the control panel, on the top menu, click Products and select S3.

3. Go to the Buckets section.

4. Click Create bucket.

5. Enter a bucket name. For S3 API compatibility, the bucket name must meet the following conditions:

   • be unique among the buckets of all users who use the storage via S3 API and are hosted in the same pool;
   • comply with Amazon S3 bucket naming rules — contain only digits, Latin letters, . and -; see Bucket naming rules in the Amazon documentation for details.

6. Select the region and pool where the bucket will be created.

7. In the Configuration block:

   7.1. Select a bucket type:

   • private — for storing backups and other data with access via login and password or an authorization token;
   • public — for distributing content for a website or web application, accessible without authorization.

   7.2. Select a storage class:

   • standard storage — for storing and distributing frequently accessed data;
   • infrequent access storage — for storing rarely accessed data;
   • glacier storage — for storing very rarely accessed data. Available only in the ru-3 pool.

   The storage class only affects the cost of resources; technically, the performance of all classes is the same. Once a bucket is created, the storage class cannot be changed.

   7.3. Select an addressing type. We recommend choosing vHosted addressing for S3 API operations. You cannot change the addressing type to Path-Style after the bucket is created.

8. Optional: to store previous versions of objects, in the Data Protection block, select the Versioning checkbox.

9. Click Create bucket.

2. Optional: configure bucket access

For more information on access management, see the Manage access to S3 instruction.

1. Add users with the required roles.
2. Configure the bucket policy.

3. Optional: set limits

You can set limits on the number of objects, the total size of objects, and specify the object retention period; for more information, see the Bucket limits instruction.

4. Optional: select a tool to work with the storage

To improve convenience and increase object upload speed, configure tools, such as the FTP protocol, Rclone client, AWS CLI, and others.

5. Upload objects

Use the Upload an object instruction.