Retention
Every object has a retention setting. This setting determines how long the object must remain in the container before it can be deleted. This can range from allowing the object to be deleted at any time to preventing the object from ever being deleted. While an object cannot be deleted due to retention, it is said to be under retention.
You cannot use the HSwiftAPI to change the retention setting for an object.
Default retention setting
Each container in HCP has a default retention setting. This is the setting that’s applied to objects when they’re first stored in the container. When you create a container, its default retention setting is to allow deletion at any time.
You cannot use the HSwift API to change the default retention setting for a container. However, tenant administrators can change this setting for the containers you create.