Skip to main content
Outside service Partner
Hitachi Vantara Knowledge

HCP policies


An HCP policy is one or more settings that influence how transactions and services work on objects in namespaces. Policies ensure that objects behave in expected ways.

HCP supports these policies:

Retention

Shredding

Indexing

Versioning

Custom metadata XML checking

This chapter describes each policy.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Retention policy


The retention policy determines how long an object must remain in the repository. Each object has its own retention policy settings. These settings are part of the object metadata.

The retention policy consists of two settings:

A retention setting, which is one of these:

oA specific date and time before which the object cannot be deleted.

oDeletion Allowed, which means that the object can be deleted at any time.

oDeletion Prohibited, which means that the object can never be deleted.

oInitial Unspecified, which means that the object has not yet been assigned one of the other possible retention settings. Objects with a setting of Initial Unspecified cannot be deleted.

oA retention class, which prevents an object from being deleted before a certain amount of time past its creation date. The specific amount of time is part of the retention class definition.

A hold setting. An object is either on hold or not. An object that is on hold cannot be deleted through any mechanism under any circumstances. Objects can be placed on hold or released from hold at any time.

Users and applications can see and modify retention policy settings. For information on these activities, see Using a Namespace or Using the Default Namespace.

NoteWebHelp.png

Note: If the namespace is in enterprise mode, the privileged delete function can be used to delete objects regardless of their retention setting, except when the objects are on hold.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Shredding policy


The shredding policy determines whether objects are shredded by the shredding service when they’re deleted. Each object has its own shredding policy setting that indicates whether or not the object should be shredded. This setting is part of the object metadata.

Users and applications can see and modify shredding policy settings. For information on these activities, see Using a Namespace or Using the Default Namespace.

For information on the shredding service, see Shredding service.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Indexing policy


The indexing policy determines how the metadata query engine indexes objects. Each object has its own indexing policy setting that indicates whether the metadata query engine should index custom metadata for that object. This setting is part of the object metadata.

NoteWebHelp.png

Note: For any given object, if custom metadata indexing is disabled for the HCP system or for the namespace that contains the object, the metadata query engine does not index custom metadata for that object, regardless of its indexing policy setting. For more information on custom metadata indexing for the metadata query engine, see ………Metadata query engine index.

Every object has an individual indexing policy setting defined as part of its system metadata. HCP ignores this setting for an object when custom metadata indexing is disabled for its namespace. However, metadata query API requests can always use the individual indexing policy setting as a namespace search criterion. Additionally, third-party applications can use this setting for their own purposes.

Users and applications can see and modify indexing policy settings. For information on these activities, see Using a Namespace or Using the Default Namespace.

For information on metadata query engine indexing, see ………Metadata query engine index.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Versioning policy


The versioning policy determines whether HCP can create multiple versions of objects. The policy is set at the namespace level and applies only to HCP namespaces.

The versioning policy consists of two settings:

A versioning setting, which is either on or off. When versioning is on, an attempt to store an object that already exists in the target namespace results in the creation of a new version of the object. When versioning is off, an attempt to store such an object results in an error.

A version pruning setting. This setting is the amount of time HCP should wait after a version is created before automatically deleting it. HCP automatically deletes only old versions of objects and never automatically deletes the most recent version.

If the effective permission mask for the namespace prohibits deletions, HCP does not automatically prune object versions. For an explanation of effective permission mask, see Setting the systemwide permission mask.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Custom metadata XML checking policy


The custom metadata XML checking policy determines whether HCP allows custom metadata to be added to a namespace if it is not well-formed XML. This policy is set at the namespace level.

The XML checking policy can have a setting of enabled or disabled:

Enabled — When custom metadata is added to or replaced in a namespace, HCP checks whether it’s well-formed XML. If the XML is not well-formed, HCP rejects it.

Disabled — HCP accepts any data submitted as custom metadata.

XML checking applies only when custom metadata is added to or replaced in a namespace. It does not apply to custom metadata already in the namespace.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.