Creating a bucket
In S3 compatible storage, buckets are organizational containers that store objects. When creating a bucket, you have the option to enable or disable object locking, and select one of the available Object Locking modes. Object locking settings apply to all objects in the bucket.
- Governance mode - prevents users without the appropriate permissions from overwriting or deleting an object version or altering its lock settings. With governance mode, you protect objects against being deleted by most users, but you can still grant some users permission to alter the retention settings or delete the object if necessary. You can also use governance mode to test retention-period settings before creating a compliance-mode retention period.
- Compliance mode - prevents objects from being overwritten or deleted by any user during the specified lock period. When an object is locked in compliance mode, its retention mode can't be changed, and its retention period can't be shortened. Compliance mode ensures that an object version can't be overwritten or deleted for the duration of the retention period.
- None - no restrictions are applied.
|
|
NOTE: QoreStor supports a maximum of 100 buckets. The bucket default-bucket is created automatically when the object container is created. |
To create a bucket
- In the navigation menu, click Containers.
- On the Containers pane, find the object storage container ObjectContainer. Click the ellipses icon, and click Edit.
- Click Create bucket.
- Enter a Name for your bucket.
- Optionally, select Object Locking and configure
- Locking Mode - select between Compliance and Governance.
- Locking Duration - select the number and format (days or years) to specify the time that the object lock will be active.
|
|
IMPORTANT: The Object Locking status of a bucket cannot be changed once the bucket is created. To ensure flexibility in the future, you may set the object locking status to enabled, but the locking mode to None. If the locking mode is set to disabled, you will not be able to edit the bucket settings in the future |
- Click Save.
Editing bucket settings
The settings for existing buckets can be edited on the Object Storage page.When changing bucket settings using this procedure, the changes are applied to new objects. To change retention settings on existing objects, refer to Changing bucket retention.
To edit bucket settings
- On the Containers pane, find the object storage container ObjectContainer. Click the ellipses icon, and click Edit.
- In the Buckets section, find the desired bucket. Right-click on the ellipsis icon and click Bucket Settings.
- In the Locking Mode section, select from one of the options below:
- Compliance - prevents objects from being overwritten or deleted by any user during the specified lock period. When an object is locked in compliance mode, its retention mode can't be changed, and its retention period can't be shortened. Compliance mode ensures that an object version can't be overwritten or deleted for the duration of the retention period.
- Governing - prevents users without the appropriate permissions from overwriting or deleting an object version or altering its lock settings. With governance mode, you protect objects against being deleted by most users, but you can still grant some users permission to alter the retention settings or delete the object if necessary. You can also use governance mode to test retention-period settings before creating a compliance-mode retention period.
- None - provides no object locking.
|
|
IMPORTANT: Changes in the locking mode are applied to files written to the container after the change was applied. Existing files are locked according to the locking method in place at the time they were added to the container. |
- In the Locking Duration field, select the number and format (days or years) to specify the time that the object lock will be active.
- Click Update.
Changing bucket retention
To change retention settings for existing objects, follow the procedures below. To change the default bucket settings for new objects, refer to Editing bucket settings
To change bucket retention settings
- On the Containers pane, find the object storage container ObjectContainer. Click the ellipses icon, and click Edit.
- In the Buckets section, find the desired bucket. Right-click on the ellipsis icon and click Change Retention.
- [Optional] In the Prefix section, enter the folder prefix. This will limit retention changes to objects in the specified folder.
- In the Locking Mode section, select from one of the options below:
- Compliance - prevents objects from being overwritten or deleted by any user during the specified lock period. When an object is locked in compliance mode, its retention mode can't be changed, and its retention period can't be shortened. Compliance mode ensures that an object version can't be overwritten or deleted for the duration of the retention period.
- Governing - prevents users without the appropriate permissions from overwriting or deleting an object version or altering its lock settings. With governance mode, you protect objects against being deleted by most users, but you can still grant some users permission to alter the retention settings or delete the object if necessary. You can also use governance mode to test retention-period settings before creating a compliance-mode retention period.
- None - provides no object locking.
- In the Locking Duration field, select the number and format (days or years) to specify the time that the object lock will be active.
- Click Update.
Deleting a bucket
Before deleting a bucket review the details below:
- Deleting a bucket is permanent. Make sure that objects within the bucket can be removed.
- To avoid unnecessary charges, confirm the bucket deletion on your cloud provider portal.
To delete a bucket
- In the navigation menu, click Containers.
- On the Containers pane, find the object storage container ObjectContainer. Click the ellipses icon, and click Edit.
- On the list of buckets, click the ellipses icon and click Delete.
- Click Remove.
