Table of Contents | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
Object Locking Essentials
...
Excerpt | ||
---|---|---|
| ||
Refer to the following steps to apply Object Locking to an existing bucket:
NoteObject Locking cannot be disabled once enabled for a bucket. The retention mode and duration can be updated. |
...
Create an object under the bucket that has Object Locking enabled. This newly created object inherits the default retention mode and period configured on the bucket.
Explicitly set a retention period when creating a new object. This overrides the default retention period configured on the bucket if present.
Explicitly set a retention period on an existing object version.
Info |
---|
InfoEach object within a given bucket can have unique and independent retention policies applied to them. |
Inheriting Default Retention
Before inheriting the default retention period of a bucket, verify the default retention mode and retention period under the Bucket’s Settings > Properties. To learn more about uploading through Content UI, see Uploading Files.
Info |
---|
InfoWhen uploading an object via Content UI, any defaults defined at the bucket level are visible during the upload process. If either the mode or duration is missing, the upload process does not proceed until the values are provided for that specific upload. |
New object versions can inherit the default retention configuration of the buckets by referring to the following steps:
Navigate to the upload page for the target bucket in Content UI.
The upload settings for Object Locking are located under Retention Time. The defaults set at the bucket level are automatically applied. The upload does not proceed until all required values are present if either default is missing.
A legal Hold can also be applied during the upload. This setting is independent of the retention locking settings and is not subject to any bucket-level defaults.
Adding a file name prefix and metadata for the object version is optional.
Click Start Upload.
The new object version is added to the bucket with the retention configuration applied. A lock icon is displayed next to the object version name to represent that the object version is locked.
...
Click on the locked object version to view the Object Locking details.
...
Setting Up Retention on a New Object
If the bucket has Object Locking enabled but does not have any prior default retention configured, a retention policy can explicitly be set on a new object during its creation. To learn more about uploading through Content UI, see Uploading Files.
Navigate to the upload page for the target bucket in Content UI.
The upload settings for Object Locking are located under Retention Time. As there are no defaults at the bucket level, no policy is automatically applied. An object lock policy is optional; no policy needs to be defined. If any values are specified, then the upload does not proceed until all required values are present.
Select an Object Locking mode which is either Governance or Compliance.
Enter the Object Locking duration in either days or years.
A legal hold can also be applied during the upload. This setting is independent of the retention locking settings and is not subject to any bucket-level defaults.
Adding a file name prefix and metadata for the object version is optional.
Click Start Upload.
The new object version is added to the bucket with the retention configuration applied. A lock icon is displayed next to the object version name to represent that the object version is locked.
...
Click on the object version to view its details.
...
Modifying Retention on an Existing Object Version
The user can apply a retention lock on an object version as long as the bucket has Object Locking enabled if an existing object version does not have Object Locking enabled. This same process is used to update Object Locking on an existing object version. Refer to the following steps to apply retention on an existing object:
Locate the object within the bucket.
Select the object and optionally choose a specific version to update.
Slick the Actions drop-down in the details for the object.
Select Edit Object Lock from the list.
Select the retention mode which is either Governance or Compliance.
Enter a retention duration in days or years.
Click Update Lock.
Content UI shows a success message saying that Object Lock status updated once the retention is set up.
...
Explicitly enable legal hold when creating a new object.
Explicitly enable legal hold on an existing object version.
Info |
---|
InfoOne can apply a legal hold irrespective of retention locks applied on the object version. It is applied independently of retention locks. |
Setting Up Legal Hold During Upload
The legal hold can explicitly set on a new object during creation if the bucket has Object Locking enabled. See Uploading Files to learn more about uploading through Content UI.
Navigate to the upload page for the target bucket in Content UI.
The upload settings for Object Locking are located under Retention Time.
Select the checkbox for Apply Legal Hold. This setting is independent of retention locking settings.
Adding a file name prefix and metadata for the object version is optional.
Click Start Upload.
The new object version is added to the bucket with the legal hold applied. A “balance scales” icon is displayed next to the object version name to represent that the object version has the legal hold applied.
...
Click on the object version to view the details.
...
Modifying Legal Hold on an Existing Object Version
One can apply the legal hold to an existing object version as long as the bucket has Object Locking enabled. This same process is used to remove the legal hold from an existing object version. Refer to the following steps to modify legal hold on an existing object:
Locate the object within the bucket.
Select the object and optionally choose a specific version to update.
...
Click the Actions drop-down in the details for the object.
Select Apply Legal Hold from the list. This reads Remove Legal Hold if the legal hold is already applied.
Verify the change of legal hold status.
Click Apply Legal Hold. This reads Remove Legal Hold when removing legal hold.
Content UI shows a success message saying Object legal hold applied once the legal hold status has changed.children