Create New Bucket

This article explains how to create buckets in a BucketFS service.

Prerequisites

You must have a BucketFS service configured. For more information, see Create New Bucket.

Procedure

This procedure is carried out using ConfD.

The following examples use ConfD through the command-line tool confd_client, which is available on all database nodes. You can also access ConfD through XML-RPC in your own Python programs. For more information, see ConfD.

Placeholder values are indicated with UPPERCASE characters. Replace the placeholders with your own values.

To create a bucket, use the ConfD job bucket_add with the following parameters:

Parameter name Data type Description
bucket_name string The name of the new bucket name.
bucketfs_name string The name of the BucketFS service that will store the new bucket.
public boolean

Indicates whether the bucket content is public.

Valid values are True and False.
read_password string The password for read permissions in the bucket.
write_password string The password for read/write permissions in the bucket.

For example:

confd_client bucket_add bucket_name: my_bucket bucketfs_name: my_bucketfs public: False read_password: READPW write_password: WRITEPW

Verification

To verify that the bucket was successfully created, use the ConfD job bucketfs_info:

confd_client bucketfs_info bucketfs_name: my_bucketfs
my_bucket

Next Steps

For information about how to access and use the new bucket, see Manage Buckets and Files in BucketFS.

See also

For information about how to expand scripting languages using BucketFS, see Adding New Packages to Existing Script Languages.