Bucket

A logical entity that helps organize the storage of objects.

Bucket naming

A bucket's name is used as part of the data access URL and will be visible to your data users. For example, http://storage.yandexcloud.net/bucket-name.

Naming rules:

• Bucket names are unique in the entire Object Storage, that is, you can't create two buckets with the same name even in different folders of different clouds. Keep this in mind if you plan to create buckets automatically via the API.

• The bucket name restrictions are as follows:

  • The length of the name must be from 3 to 63 characters.
  • The name may contain lowercase Latin letters, numbers, hyphens, and periods.
  • The first and last characters must be letters or numbers.
  • Characters to the right and left of the period must be letters or numbers.
  • The name must not look like an IP address (for example, 10.1.3.9).

Names containing dots should only be used for static website hosting.

Bucket settings

You can:

• Limit the maximum size of a bucket. Object Storage will not allow uploading an object if, when adding it, the bucket size exceeds the maximum value.
• Set the default storage class. Objects uploaded to a bucket are by default saved with the storage class specified for that bucket.
• Configure a bucket for static website hosting.
• Download a CORS configuration for a bucket.
• Configure the lifecycle of objects.

Usage

• A bucket cannot be renamed.

• Object Storage performance does not depend on the number of buckets. You can store all your data in one or several buckets.

• Buckets can't be nested.

• You can only delete an empty bucket.

• It may take some time after deleting a bucket before you can create a new bucket with the same name. There is also a risk that another Yandex.Cloud user will create a bucket with the name you've released before you claim it again. Do not delete buckets for no good reason.

• When objects are uploaded in quick succession, the maximum specified bucket size can be exceeded.

• After deleting objects from a bucket, their storage capacity is considered occupied for some time.

  Note

  If you have limited the maximum size of a bucket, it may remain unavailable for writes for some time, even if you free up enough space for new objects.