4.2 KiB
title | menu | ||||||
---|---|---|---|---|---|---|---|
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. |
{{< highlight bash >}} ozone sh bucket create /hive/jan {{< /highlight >}}
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 |
{{< highlight bash >}} ozone sh bucket delete /hive/jan {{< /highlight >}}
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. |
{{< highlight bash >}} ozone sh bucket info /hive/jan {{< /highlight >}}
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. |
{{< highlight bash >}} ozone sh bucket list /hive {{< /highlight >}}
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. |
{{< highlight bash >}} ozone sh bucket update --addAcl=user:bilbo:rw /hive/jan {{< /highlight >}}
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)
{{< highlight bash >}} ozone sh bucket path <> {{< /highlight >}}
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.