buckets.rst

Buckets

A bucket is the parent object of collections and groups.

A bucket is a mapping with the following attributes:

• data: (optional) attributes of the bucket object

  • id: the bucket object id
  • last_modified: the timestamp of the last modification

• permissions: the ACLs <ACL> for the bucket object

Creating a bucket

A bucket also accept arbitrary attributes. For example, you may want to store some application settings there.

Replacing a bucket

Retrieve an existing bucket

Updating an existing bucket

Deleting a bucket

Retrieving all buckets

Delete all buckets

Personal bucket «default»

When the built-in plugin kinto.plugins.default_bucket is enabled in configuration, a bucket default is available.

As explained in the section about collections<collections>, the default bucket implicitly creates the collections objects on their first use.

For convenience, the actual default bucket id is provided in the root URL of Kinto: