

# ObjectLockRule
<a name="API_ObjectLockRule"></a>

The container element for an Object Lock rule.

## Contents
<a name="API_ObjectLockRule_Contents"></a>

 ** DefaultRetention **   <a name="AmazonS3-Type-ObjectLockRule-DefaultRetention"></a>
The default Object Lock retention settings for new objects in this bucket. You can specify:  
+ A default retention period, by using `Days` or `Years`.
+ A default event hold duration, by using `DefaultEventHold`. This setting also uses days or years.
You can set one or both. You cannot use days and years in the same setting.  
Type: [DefaultRetention](API_DefaultRetention.md) data type  
Required: No

## See Also
<a name="API_ObjectLockRule_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/s3-2006-03-01/ObjectLockRule) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/s3-2006-03-01/ObjectLockRule) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/s3-2006-03-01/ObjectLockRule) 