Use a retention update job to change the length of time
that an object is retained.
By using a retention update job, you can change the retention
period of an object based on the class of an object or the state of
its properties. There are two ways to specify a new retention date:
- Specify a date directly, by using the SpecificRetentionDate property,
or
- Cause a date to be calculated, by specifying three things:
- The name of a base date property on the Sweep Target class. This
name is specified by the BaseDatePropertyName property,
which must identify a valid property on the sweep target class, and
that property must have a data type of DateTime.
- An offset. The offset is specified by the RetentionDuration property.
- The units that the offset is expressed in. The units are specified
by the RetentionPeriodUnits property.
You cannot both specify a date and cause a date to be
calculated, so if a value is provided by the SpecificRetentionDate property,
then both the RetentionDuration property and
the BaseDatePropertyName property must be set
to a null value. Similarly, if the SpecificRetentionDate property
is null, then both the RetentionDuration property
and the BaseDatePropertyName property must be
set to valid values.
Access control
Retention updates jobs execute
with the access rights of the security principal specified as the
owner of the job.
The following table defines the minimum access
rights that are required to create an instance of a retention update
job:
Table 1. Access rights required
to create a retention update jobAccess right |
Granting object |
Create instance |
Class definition for retention update job |
Create new objects |
Object store |
Connect to store |
Object store |
Modify retention |
Object store |
Retention update jobs are supported in two modes:
RetentionReductionAllow and
RetentionReductionPrevent,
controlled by the
AllowRetentionReduction property. When
the mode is set to
RetentionReductionAllow, then
the sweep updates the retention on all affected items, even if doing
so results in the retention period being reduced. When the mode is
RetentionReductionPrevent,
then the sweep does not update the retention on any objects for which
the update would result in reducing the retention period. The
AllowRetentionReduction property
is read-only, which means that the only way to change the value is
to update the default value given in its property definition. The
default value can be changed by modifying the
PropertyDefaultBoolean property
on the Property Definition for the
AllowRetentionReduction property.
Table 2. Access rights required to modify
the AllowRetentionReduction propertyAccess right |
Granting object |
View all properties |
Class definition for the retention update job |
Modify all properties |
Class definition for the retention update job |
Modify existing object |
Object store |
Connect to store |
Object store |
Modify retention |
Object store |