Cloud Storage Guides
- 1 Managing your buckets
- 1.1 How to create a new bucket?
- 1.1.1 Protocol
- 1.1.2 Bucket Type
- 1.1.3 Name
- 1.2 How to delete a bucket?
- 1.2.1 Single-bucket deletion
- 1.2.2 Bulk deletion
- 1.2.3 CDN origin buckets
- 1.3 How to change bucket type?
- 1.1 How to create a new bucket?
- 2 Managing your objects
- 2.1.1 Access Credentials
- 2.1.2 Swift password update
- 2.1.3 Object management tools
- 2.2 Your storage statistics
- 2.2.1 Why are there no stats?
Managing your buckets
How to create a new bucket?
To create your first bucket, open the Cloud Storage section of the user panel. You’ll land at the bucket creation page immediately, as shown below:
Set up the following bucket parameters: Protocol, Type, and Name.
Protocol
You can use different protocol types for different buckets, but you cannot switch the protocol for any existing bucket.
Algorithms vary widely, depending on whether a load is distributed on the network or application layer. Algorithm selection impacts the effectiveness of load distribution mechanisms and, consequently, performance and business continuity.
There are two protocols available:
S3
A modern Amazon object storage protocol running via a web service interface, supporting any object types and hybrid cloud storage.
See https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html for more information.
Swift
A standard old-fashioned open-source protocol designed to manage any object storage.
See https://docs.openstack.org/swift/latest/ for more information.
Choose the most appropriate protocol for your current bucket by ticking the corresponding radio button.
Bucket Type
Make sure to stick to the CDN bucket type for any CDN origins in use to maintain your content availability.
CDN bucket
Well-suited to support Anycast CDN or Video CDN services
Private bucket
Suitable for a general-purpose object storage
Choose the suitable bucket type for your bucket-in-creation by ticking the corresponding radio button.
You can use a mix of bucket types for different goals in your cloud storage, and you’ll be able to change the bucket type for any existing bucket down the road by editing it.
Name
Please note: requirements for the bucket name differ depending on the previous parameters selected, so enter the name only after you select the protocol and the type.
Input your new bucket name and click the Create bucket button below to proceed with bucket creation.
Bucket name requirements
Certain naming requirements are in place, depending on the protocol and bucket type.
- S3 bucket (CDN or Private)
The name should be 3-63 characters long, can consist only of lowercase letters, numbers, and hyphens, and must begin and end with a letter or number.
- Swift CDN bucket
The name should be a maximum of 63 characters long, can consist only of letters, numbers, and hyphens, and must begin and end with a letter or number.
- Swift Private bucket
The name should be 3-63 characters long, can consist only of lowercase letters, numbers, dots, and hyphens, and must begin and end with a letter or number.
For CDN bucket type, you’ll be suggested to specify your default bucket index file name, otherwise, the default index.html name will be used.
After you set up all the required parameters, please press the Create bucket button, and your new bucket will be created and displayed in the buckets list.
To add another bucket, scroll down the buckets list view, as depicted below:
Press the Create new bucket button in the bottom-right corner of the user panel.
You’ll be redirected to the initial bucket creation page. Go through the same motions as described above in How to create a new bucket?
How to delete a bucket?
You are able to delete your buckets in two ways.
Single-bucket deletion
To delete any storage bucket, click the Delete bucket icon on the right side of the bucket row, it appears upon hover:
Confirm the bucket deletion in the pop-up.
Depending on the bucket’s size, deletion might take some time. Hence you might catch a deletion state in the list view, as shown below:
Bulk deletion
For bulk operations, you can select two or more buckets and click the Delete buckets button to delete them altogether, as follows:
Confirm bulk deletion in the pop-up.
CDN origin buckets
Please note you can't select and delete or mark for a bulk deletion a bucket that is used as any CDN’s origin.
To delete such a bucket, you need to first stop using it with any CDN origin. Thereafter, you are able to delete this bucket in any way described above.
How to change bucket type?
You are able to change your bucket type. To do so, please click the Settings icon in the middle of any bucket row, as follows:
You’ll see a window with configurable bucket parameters, as follows:
Here, you can change your bucket type. For bucket type distinction, refer to the Cloud Storage Guides paragraph. After changing the type, please click the Update button to apply your changes.
Please note, you can't change the type from CDN to Private while the bucket is used as a CDN origin.
Managing your objects
To manage your objects inside your bucket, you need two things:
Access credentials are required to access your objects.
Management tool to manage your objects using the credentials.
Access Credentials
You can see your storage credentials on the Credentials page, as follows:
On the adjacent tab you’ll find swift protocol credentials, and both types can be managed via the CyberDuck
There are two separate sets of credentials with a totally different structure for S3 and Swift access protocols. Use S3 credentials to access only S3 buckets and, respectively, Swift credentials - to only access Swift buckets.
Swift password update
For Swift protocol buckets, you can change the access password: navigate to the Credentials section of the Cloud Storage within the user panel, as shown above. locate and press the Change button to the right of the Password row.
Input your new password and click the Change password button to save changes.
Object management tools
You must use an external management tool to visually manage the objects in your buckets. We recommend using the CyberDuck management tool, and you can access it from the right side of your Credentials page, as shown above.
There, you can download the tool via the provided links, along with the ready configuration file for a quick setup.
For further steps, please refer to the documentation below:
Your storage statistics
You are able to see your current storage statistics on the Statistics page.
To see statistics, please select the bucket and set a time period for which you would like to view statistics, as shown below:
When changing a bucket or a time period, new parameters are applied immediately and statistics data are changed.
Why are there no stats?
Please note: your stats will be collected and displayed upon storage usage, the statistics page will be empty, as shown above if you check it immediately upon creating your first bucket or before any factual usage occurs.