Ozone Command Line Interface

The Ozone Command Line Interface (CLI) serves as the primary tool for interacting with Ozone from the command line.

Volume Operations

Volume operations in Ozone are governed by ACLs (Access Control Lists), restricting volume creation permissions to ozone admins only.

Commands

• Create Volume: To create a volume, use the following command:

Or specify the OM service ID:

• Volume Info: Retrieve information about a volume using:

• List Volumes: List all volumes with:

• Delete Volume: To delete a volume, execute:

For recursive deletion (including all keys and buckets within the volume), use:

Confirm deletion by entering 'yes' when prompted.

Bucket Operations

Interact with buckets in Ozone using the following commands:

• Create Bucket: To create a bucket, use:

Or specify the OM service ID:

By default, buckets are configured to support the file system (FILE_SYSTEM_OPTIMIZED).

• Bucket Info: Retrieve information about a bucket with:

• Delete Bucket: Delete a bucket using:

For recursive deletion (including all keys within the bucket), utilize:

Confirm deletion by entering 'yes' when prompted. This will delete all the keys within the bucket, and then the bucket itself. After running the command there is no way to recover deleted contents.

Key Operations

Perform various operations on keys in Ozone using the following commands:

• Upload Keys: Upload a key to a specified location:

• Key Info: Retrieve information about a key:

• Get Key on Local System: Download a key to the local system:

• Delete Key: To delete the key:

If the key is in an FSO (File System Optimized) bucket, it will be moved to the trash upon deletion. The location of the trash folder is /volume/bucket/.Trash/user. If the key is in an OBS (Object Store) bucket, it will be permanently deleted.