retentionClass

The retentionClass data type describes the retentionClasses resource.

Properties

The table below describes the properties included in the retentionClass data type.

PropertyData typeDescriptionNotes
allowDispositionBoolean

Specifies whether HCP automatically deletes expired objects in the retention class. Valid values are:

  • true

    Automatically delete expired objects.

  • false

    Do not automatically delete expired objects.

This property is required on a PUT request when the value of the retention class is an offset. It is ignored if the value is not an offset.

This property is required on a POST request when the retention class value is being changed to an offset from another type of value.

descriptionString

Specifies a description of the retention class. This description is optional. The default is no description.

To remove a description from an existing retention class, specify the description property with no value.

nameString

Specifies the name of the retention class. Retention class names must be from one through 64 characters long, can contain only alphanumeric characters, hyphens (-), and underscores (_), and are not case sensitive.

The retention class name must be unique for the namespace. Different namespaces can have retention classes with the same name.

This property is required on a PUT request. It is not valid on a POST request and is returned only by a verbose GET request.
valueStringSpecifies the retention class value. Valid values are special values and offsets. This property is required on a PUT request.

Example

Here’s an XML example of the retentionClass data type:

<retentionClass>
    <description>Implements Finance department standard #42 - keep for 10
         years.</description>
    <value>A+10y</value>
    <allowDisposition>true</allowDisposition>
    <name>FN-Std-42</name>
</retentionClass>