bucket create

Sergei Tikhomirov

Definition

Creates a new bucket in a given volume.

Usage

$ ozone sh bucket create [-ghV] [-k=<bekName>]
                                [-l=<allowedBucketLayout>]
                                [--namespace-quota=<quotaInNamespace>]
                                [--quota=<quotaInBytes>]
                                [-r=<replication>]
                                [-t=<type>]
                                [-u=<ownerName>]
                                <value>
Arguments
Parameter Description

bekName

Bucket encryption key name

value

A bucket URI. It can be a full URI (starts with o3://, e.g. o3://hostname:9862/vol1/bucket1/) or a short URI (starts with a volume name, e.g. vol1/bucket1). Any missing information is obtained from the configuration files

allowedBucketLayout

A bucket layout. Possible values: OBJECT_STORE, LEGACY, and the default FILE_SYSTEM_OPTIMIZED

quotaInNamespace

Maximum number of keys in a bucket

quotaInBytes

Maximum space quota that can be used (in bytes)

replication

Replication definition. The valid values are based on the replication type. For RATIS: ONE or THREE. In case of EC, it should follow the CODEC-DATA-PARITY-CHUNKSIZE pattern, e.g. rs-3-2-1024k

type

Replication type. The supported types are RATIS and EC

ownerName

Owner of the bucket. Defaults to the current user if not specified

-g, --enforcegdpr

Indicates to create a GDPR-enforced bucket

-h, --help

Prints out a help manual for this command

-V, --version

Prints out version information and exits

Examples

Create a bucket with a specified quota:

$ ozone sh bucket create --quota=1073741824 vol1/bucket3

Create a bucket with a specified replication config:

$ ozone sh bucket create -t=RATIS -r=ONE vol1/bucket4
Found a mistake? Seleсt text and press Ctrl+Enter to report it