Create Buckets
Describes how to create a bucket.
The bucket name is unique for each Object Store domain. For example, if a domain has a bucket named FinancialData, another domain can also have a bucket named FinancialData.
Usage Notes
Review the following notes before you create buckets.
- Creating buckets
- Currently, you cannot use awscli, s3cmd, or SDK to create buckets in an account. You
can only create buckets in an account that is not default account from the
Object Store UI or the
/opt/mapr/bin/mc
command. After you create a bucket, you can perform all operations through any interface, including awscli, s3cmd, SDK, Object Store UI, and/opt/mapr/bin/mc
. This behavior does not apply to the default account. If you have permissions and keys (accessKey/secretKey) to access the default account, you can create buckets in the default account through any interface. - Naming buckets
- When you name a bucket, do not include
mapr.
as a prefix for the bucket name. For example,mapr.bucket1
is not supported.
Create a Bucket Using the CLI
Use the mc mb command to create a bucket.
Create a Bucket Using the Object Store Interface
To create a bucket, using the Object Store Interface:
- Login to the Object Store Interface as the administrator or as the
root
user. - Click the bucket icon from the left pane.
- From the Buckets page, click Create Bucket
-
In Bucket name, enter a DNS-compliant name for your bucket.
The bucket name must:
- Be unique across all of HPE Ezmeral Object Store.
- Be between 3 and 63 characters long.
- Not contain uppercase characters.
- Start and end with a lowercase letter or number.
NOTEAfter you create the bucket, you cannot change its name. - Select the account to which the bucket belongs. By default, a bucket belongs to the default account.
- To enable locking of objects, turn on Object Lock. NOTETurning on Object Locking automatically enables Versioning. After enabling Object Locking, you cannot disable it for a bucket.
- Specify the retention mode and retention period.
- Governance mode - Users cannot overwrite or delete an object version or alter its
lock settings unless they have special permissions. Users with the
s3:BypassGovernanceRetention
permission can alter the retention period and delete objects. - Compliance mode - The admin user cannot alter the retention period, nor delete the object until the retention period has lapsed.
- Governance mode - Users cannot overwrite or delete an object version or alter its
lock settings unless they have special permissions. Users with the
- To use versioned buckets, enable Versioning. Versioning is selected by default if you turned Object Locking on.
- Enter a bucket policy or select the bucket policy JSON file.
- Add any tags as key-value pairs for the bucket. These tags are used to categorize storage.
- Specify the size of the objects to be considered as Tiny (Max Inline Object Size should be a maximum of 1 MB) and Small (Max Object Size in DB should be a maximum of 8 MB). Both tiny and small objects are stored in appropriate database tables. Specify the object chunk size to use when writing objects to disk.
- Click Create Bucket.