Cloud Enterprise Object Storage REST API

Search (SHIFT+S)




New in this release

Set Retention Period

PUT /{object_name}?retentionUpdate

Updates retention period for an object to a higher value or -1 (infinite retention).

URL Format

Host Style: http://bucketname.ns1.emc.com/{object_name}?retentionUpdate
Path Style: http://ns1.emc.com/bucketname/{object_name}?retentionUpdate

x-emc-retention-period is required.

Request Headers

x-emc-retention-period optionalUsed to specify the number of seconds, or -1 for infinite retention.

Prerequisites

The following conditions must be met in order to call this operation.

  • User should have s3:PutObject permission

  • BaseUrl used in a host-style request URL should be pre-configured using the ECS Management API or the ECS Portal (for example, emc.com in the URL: bucketname.ns1.emc.com).

  • Namespace and bucket corresponding to this object should exist


Request Payload

No Request Payload


Response Body

Response indicating Success or Failure to update retention period