Bucket Commands

Ozone shell supports the following bucket commands.

Create

The bucket create command allows users 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 command allows users to delete a bucket. If the bucket is not empty then this command will fail.

Params:

Arguments Comment
Uri The name of the bucket
ozone sh bucket 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 command allows users 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.

path

The bucket command to provide ozone mapping for s3 bucket (Created via aws cli)

ozone s3 path <<s3Bucket>>

The above command will print VolumeName and the mapping created for s3Bucket.

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