Search (SHIFT+S)
ECS Management API
ECS Object Service API
-
Amazon S3
- S3 Bucket
- S3 Bucket ACL
- S3 Bucket Cors
- S3 Bucket Empty Status Operations
- S3 Bucket Is Stale Allowed
- S3 Bucket Lifecycle
- S3 Bucket List Fanout (Cloud DVR)
- S3 Bucket List Uploads
- S3 Bucket Location
- S3 Bucket Lock Configuration Operations
- S3 Bucket Object Lock Operations
- S3 Bucket Policy
- S3 Bucket Versioning
- S3 Bucket Versions
- S3 Data Node
- S3 Metadata Key List
- S3 Metadata Key System List
- S3 Metadata Search
- S3 Multi Object Delete
- S3 Object
- S3 Object ACL
- S3 Object Detailed Replication Status Operations
- S3 Object Init Uploads
- S3 Object Legal Hold Operations
- S3 Object Replication Info Operations
- S3 Object Retention Operations
- S3 Object Tagging Operations
- S3 Object Uploads
- S3 Options
- S3 Ping
- S3 Retention Update Operation
- S3 Select Operations
- EMC Atmos
- OpenStack Swift
ECS API Changes
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 | optional | Used 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