PutLifecyclePolicy
Writes an object lifecycle policy to a container. If the container already has an object lifecycle policy, the service replaces the existing policy with the new policy. It takes up to 20 minutes for the change to take effect.
For information about how to construct an object lifecycle policy, see Components of an Object Lifecycle Policy.
Request Syntax
{
"ContainerName": "string
",
"LifecyclePolicy": "string
"
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- ContainerName
-
The name of the container that you want to assign the object lifecycle policy to.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[\w-]+
Required: Yes
- LifecyclePolicy
-
The object lifecycle policy to apply to the container.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 8192.
Pattern:
[\u0009\u000A\u000D\u0020-\u00FF]+
Required: Yes
Response Elements
If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
Errors
For information about the errors that are common to all actions, see Common Errors.
- ContainerInUseException
-
The container that you specified in the request already exists or is being updated.
HTTP Status Code: 400
- ContainerNotFoundException
-
The container that you specified in the request does not exist.
HTTP Status Code: 400
- InternalServerError
-
The service is temporarily unavailable.
HTTP Status Code: 500
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: