Bucket Commands

Ozone shell supports the following bucket commands.

Create

The bucket create command allows a user to create a bucket.

Params:

Arguments Comment
Uri The name of the bucket in /volume/bucket format. 
ozone sh bucket create /hive/jan

The above command will create a bucket called jan in the hive volume. Since no scheme was specified this command defaults to O3 (RPC) protocol.

Delete

The bucket delete commands allows an user to delete a volume. If the bucket is not empty then this command will fail.

Params:

Arguments Comment
Uri The name of the bucket 
ozone sh volume delete /hive/jan

The above command will delete jan bucket if it is empty.

Info

The bucket info commands returns the information about the bucket. Params:

Arguments Comment
Uri The name of the bucket. 
ozone sh bucket info /hive/jan

The above command will print out the information about jan bucket.

List

The bucket list commands allows uset to list the buckets in a volume.

Params:

Arguments Comment
-l, –length Maximum number of results to return. Default: 100
-p, –prefix Optional, Only buckets that match this prefix will be returned.
-s, –start The listing will start from key after the start key.
Uri The name of the volume. 
ozone sh bucket list /hive

This command will list all buckets on the volume hive.

Update

The bucket update command allows changing access permissions on bucket.

Params:

Arguments Comment
–addAcl Optional, Comma separated ACLs that will added to bucket.
–removeAcl Optional, Comma separated list of acl to remove.
Uri The name of the bucket. 
ozone sh bucket update --addAcl=user:bilbo:rw /hive/jan

The above command gives user bilbo read/write permission to the bucket.

You can try out these commands from the docker instance of the Alpha Cluster.