Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Enjoy members-only rewards and discounts
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.
Sign In Create an Account Dell Financial Services Premier Sign In Partner Program Sign In
Contact Us

Your Dell.com Carts

ECS 3.6.2 Data Access Guide

PDF

Extending retention period on objects

ECS allows you to extend the retention period for the objects that are under retention.

To extend the object retention period, add a value to the x-emc-retention-period header. For example, a value of -1 implies infinitive retention period.

Limitations

  • It is possible to extend the object retention period by changing the retention_class values in the namespace or in the bucket. The modified retention period applies to all the objects in the bucket or to all the objects that are using the retention_class defined in namespace. It is not possible to extend an individual object retention period.
  • As to extend the retention period, namespace should have retention_class with some period value, buckets should have retention-period, and objects should have retention-period and retention_class as defined in the namespace.
NOTE: When modifying the retention value of an object, the new value is added to the object creation time. If the retention period value is greater than the current time, the operation will be blocked.
Table 1. S3 API to extend the object retention period
Action Request Permission Response
Update retention period PUT /<bucket>/<object-key>?retentionUpdate x-emc-retention-period:<seconds>

Example: /root/s3curl.pl --id=<id> -- -X PUT "http://$ip:9020/bucket/key1?retentionUpdate" -H 'x-emc-retention-period:3000'

NOTE:
  • New retention period value can only be increased that is, it can be the same as the current or greater value.
  • If the new retention period value is -1, infinite retention applies on that object. For example: -H 'x-emc-retention-period:-1'
s3:PutObject 200 No content

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\