---
title: "Working With a Bucket in CCC"
slug: "working-with-a-bucket"
updated: 2026-01-29T17:03:54Z
published: 2026-01-29T17:03:54Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wasabi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Working With a Bucket in CCC

There are various bucket properties that can be modified for existing buckets.

- Bucket versioning—Maintains multiple variations of an object in the same bucket. You can then retrieve and restore any version of an object in the bucket. This provides protection against inadvertent removal of an object (such as by overwriting or expiration).
- Bucket logging—Creates a text log file of all access to the bucket. You can specify the target bucket in which to store log files as well as a prefix to include in the log file name.
- Object lock—Helps prevent objects from being deleted or overwritten for a fixed amount of time or indefinitely.

## Bucket Versioning

A bucket can be in one of three versioning states:

- Unversioned
- Enabled
- Suspended

Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket. The versioned objects that have been created will remain in the bucket. You will want to remove them specifically if they are no longer needed.

### Enabling Bucket Versioning for Unversioned Buckets

1. From the **Buckets** list, select an **Unversioned** bucket. The Objects page opens. To check the version of a bucket click the ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/menu_button(2).png) icon and then select **View.**

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720449683212.png)
2. Enable **Show Versions**.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720450593314.png)

Each object's version is displayed in the **Version ID** field.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720451014104.png)
3. Click the **Properties** tab. Bucket Versioning is currently unversioned.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720457232415.png)
4. Select **Enable Versioning.**

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720457130896.png)
5. Click **Confirm**to enable versioning.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720033923679.png)

### Suspending Bucket Versioning for Versioned Buckets

1. From the **Buckets** list, select a **Versioned** bucket. The Objects page opens. To check the version of a bucket click the ![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/menu_button(2).png) icon and select **View**.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720453295054.png)
2. Enable **Show Versions**.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720454312855.png)

Each object's version is displayed in the **Version ID** field.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720454658633.png)
3. Click the **Properties** tab. The Bucket Versioning is enabled.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720456980547.png)
4. Select **Suspend Versioning**.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720456857196.png)
5. Click **Confirm**to suspend versioning.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720034765020.png)

## Bucket Logging

Bucket Logging creates a text log file of all access to the bucket. You can specify the target bucket in which to store log files as well as a prefix to include in the log file name.

### Enabling Bucket Logging

1. From the **Buckets** list, select a bucket for which you want to enable bucket logging. The Objects page opens.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720459124240.png)
2. Click the **Properties**tab.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720462257122.png)
3. In the **Bucket Logging** section, select **Enable Bucket Logging**.****

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720462385933.png)
4. Enter a **Logging Prefix**to include in the log file name. Each log file will start with the characters you enter.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720462524742.png)
5. Select a **Bucket to store****logs**target bucket in which to store log files.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720462638548.png)
6. Click **Update**. An alert confirms that Bucket Logging was successfully enabled.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720462737796.png)

## Object Lock

Object Lock can help prevent objects from being deleted or overwritten for a fixed amount of time or indefinitely. Object Lock must be enabled when the bucket is created, and versioning must be enabled on the bucket.

Once enabled, Object Lock cannot be disabled.

### Creating an Object Lock Bucket

1. Select the **Buckets** tab. Click **Create Bucket** to display the Create Bucket page.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720460750369.png)
2. Enter a **Bucket Name** for the new bucket. Select a region from the **Select Region** drop-down. Select **Object Lock** on this bucket. (Note that Bucket Versioning will be enabled automatically.) Click **Create**.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720463397497.png)

### Setting Object Lock Defaults

When Object Lock is enabled for a bucket, the Object Lock section on the bucket Properties page will have default settings that can be configured.

1. From the **Buckets** list, select a bucket for which you want to configure Object Lock defaults. The Objects page opens. (Note that this bucket must have had Object Lock enabled when the bucket was created.)

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720031097259.png)
2. Click the **Properties**tab.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720031364405.png)
3. In the Object Lock section, select **Enable Bucket-Level Object Retention**. These settings will automatically apply to all new objects placed into the bucket after you apply the settings.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720545828966.png)
4. Select either **Enable** **Governance Mode**or **Enable Compliance Mode**.

Objects placed in Governance Mode remain immutable until after they have reached the "retain until" date, unless a user has specific IAM permissions to alter the setting.

Objects placed in Compliance Mode remain immutable until after they have reached the "retain until" date. This cannot be reversed for any reason by any user regardless of user permissions.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720536014366.png)
5. Configure the **Retention Period**by setting the **Time Scale** day(s) or year(s) and setting the **Retention Time**for the number of days/years to retain the objects.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720546029079.png)
6. Click **Update**.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720546162697.png)
7. Type **CONFIRM**and then click **Confirm**to save the settings.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720537904407.png)

### Viewing Object Lock Information for an Object

1. Click on a bucket.
2. Select an object from the list. The File Details panel is displayed.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720538543141.png)
3. If you want to modify the Mode and/or Retain Until date, click **Edit**(to the right of Object Lock). After making your change, click **Apply**to save the changes.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720542918581.png)

If object lock was not previously configured on the object:

1. Click **Enable**(to the right of Object Lock).

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720548134961.png)
2. Select a **Mode**and enter a **Retain Until**date for the object. Click **Apply**.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720548242507.png)

### Setting a Legal Hold

1. Select **Legal Hold** for the object. When legal hold is enabled, it prevents anyone from deleting the object.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720546866480.png)

When you enable Legal Hold, an alert displays.
2. Click **Confirm**.

![](https://cdn.document360.io/bef0a1ea-7768-4d5a-b520-c4fe2f7fafad/Images/Documentation/image-1720547110287.png)