KnowledgeLayer

Search form

Main menu

You are here

Add and delete a Bucket in IBM COS (S3)

Using buckets via the Bluemix Portal

Click the Account Name in the above accounts list to open the details page for that account.

The details page shows the following info on the top header bar:

Name of the account currently being viewed

The current region being viewed

The total capacity usage in the current billing cycle

The total bandwidth usage in the current billing cycle

The page also shows the list of buckets present in the account.

A new bucket can be added by clicking on the + button at the right of the first row.

The new bucket name can be entered and the new bucket added, by clicking the Add button. Bucket names must be DNS-compliant. Names must be between 3 and 63 characters long, must be made of lowercase letters, numbers, and dashes, must be globally unique, and cannot appear to be an IP address. A common approach to ensuring uniqueness is to append a UUID or other distinctive suffix to bucket names.

A bucket can be deleted, by clicking the red - button to the extreme right of the bucket name. This opens a confirmation window.

Note:Only empty buckets can be deleted. Attempting to delete a non-empty bucket will result in an error.

Click the Delete button to remove the bucket from the account.

Using buckets from SoftLayer Portal

Login to control

Click the Storage tab and then Object Storage

Click the Object storage account you wish to use

The details page shows the following info on the top header bar:

Name of the account currently being viewed

The total capacity usage in the current billing cycle

The total bandwidth usage in the current billing cycle

The page also shows the list of buckets present in the account.

A new bucket can be added by clicking on the + button at the right of the first row.

The new bucket name can be entered and the new bucket added, by clicking the Add button. Bucket names must be DNS-compliant. Names must be between 3 and 63 characters long, must be made of lowercase letters, numbers, and dashes, must be globally unique, and cannot appear to be an IP address. A common approach to ensuring uniqueness is to append a UUID or other distinctive suffix to bucket names.

A bucket can be deleted, by clicking the red - button to the extreme right of the bucket name. This opens a confirmation window.

Note:Only empty buckets can be deleted. Attempting to delete a non-empty bucket will result in an error.

Click the Delete button to remove the bucket from the account.

Using buckets via the S3 API (examples)

Create a new bucket

A PUT issued to the endpoint root will create a bucket when a string is provided. Bucket names must be unique, and accounts are limited to 100 buckets each. Bucket names must be DNS-compliant; names between 3 and 63 characters long must be made of lowercase letters, numbers, and dashes. Bucket names must begin and end with a lowercase letter or number. Bucket names resembling IP addresses are not allowed.Note:Using third-party tools or SDKs may enforce setting a ‘Location Constraint’ when creating a bucket. If required, this value must be set to ‘us-standard’.