versioningSettings

The versioningSettings data type describes the versioningSettings resource for namespaces and the versioningSettings property of the namespace and namespaceDefaults data types.

Properties

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

PropertyData typeDescriptionNotes
daysOnPrimaryInteger

Specifies the number of days old versions of objects must remain in the namespace before they are pruned. Valid values are integers in the range zero through 36,500 (that is, 100 years). A value of zero means prune immediately.

The default is zero.

Deprecated; replaced by the pruneDays property.

If specified on a PUT or POST request, this property has the same function as the pruneDays property. You cannot include both this property and the pruneDays property in the same request.

This property is not returned by any GET request.

daysOnReplicaInteger

Deprecated. The pruneDays property applies to the namespace on all systems on which the namespace exists.

This property is ignored on a PUT or POST request and is not returned by any GET request.

enabledBoolean

Specifies whether versioning is enabled for the namespace. Valid values are:

  • true

    Versioning is enabled.

  • false

    Versioning is disabled.

The default is false.

This property is required on a PUT request to create a namespace and on a POST request to modify namespace defaults if the request includes the versioningSettings property.

You cannot enable versioning for a namespace while the CIFS, NFS, WebDAV, or SMTP protocol or appendable objects are enabled.

keepDeletionRecordsBoolean

Specifies whether HCP should keep records of deletion operations (delete, purge, prune, disposition) that occur in the namespace if the namespace has ever had versioning enabled. Valid values are:

  • true

    Keep records of deletion operations.

  • false

    Do not keep records of deletion operations.

The default is true.

The amount of time for which HCP keeps deletion records is determined by the system configuration.

This property is not valid on a POST request to modify namespace defaults and is not returned by any GET request for namespace defaults.
pruneBoolean

Specifies whether version pruning is enabled for the namespace. Valid values are:

  • true

    Version pruning is enabled for the namespace.

  • false

    Version pruning is disabled for the namespace.

The default is false.

This property is required on a PUT request to create a namespace and on a POST request to modify namespace defaults if the enabled property is set to true.

You cannot include both this property and the pruneOnPrimary property in the same request.

pruneDaysInteger

Specifies the number of days old versions of objects must remain in the namespace before they are pruned. Valid values are integers in the range zero through 36,500 (that is, 100 years). A value of zero means prune immediately.

The default is zero.

This property is required on a PUT request to create a namespace and on a POST request to modify namespace defaults if the prune property is set to true.

You cannot include both this property and the daysOnPrimary property in the same request.

pruneOnPrimaryBoolean

Specifies whether version pruning is enabled for the namespace. Valid values are:

  • true

    Version pruning is enabled for the namespace.

  • false

    Version pruning is disabled for the namespace.

The default is false.

Deprecated; replaced by the prune property.

If specified on a PUT or POST request, this property has the same function as the prune property. You cannot include both this property and the prune property in the same request.

This property is not returned by any GET request.

pruneOnReplicaBoolean

Deprecated. The prune property applies to the namespace on all systems on which the namespace exists.

This property is ignored on a PUT or POST request and is not returned by any GET request.

Example

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

<versioningSettings>
   <enabled>true</enabled>
   <keepDeletionRecords>true</keepDeletionRecords>
   <prune>true</prune>
   <pruneDays>10</pruneDays>
</versioningSettings>