AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Places an Object Retention configuration on an object. For more information, see Locking Objects. Users or accounts require the s3:PutObjectRetention permission in order to place an Object Retention configuration on objects. Bypassing a Governance Retention configuration requires the s3:BypassGovernanceRetention permission.

This action is not supported by Amazon S3 on Outposts.


When the Object Lock retention mode is set to compliance, you need s3:PutObjectRetention and s3:BypassGovernanceRetention permissions. For other requests to PutObjectRetention, only s3:PutObjectRetention permissions are required.


For .NET Core this operation is only available in asynchronous form. Please refer to PutObjectRetentionAsync.

Namespace: Amazon.S3
Assembly: AWSSDK.S3.dll
Version: 3.x.y.z


public abstract PutObjectRetentionResponse PutObjectRetention(
         PutObjectRetentionRequest request
Type: Amazon.S3.Model.PutObjectRetentionRequest

Container for the necessary parameters to execute the PutObjectRetention service method.

Return Value
The response from the PutObjectRetention service method, as returned by S3.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also