Lifecycle Management
All operations require authentication.
2 operationsv2/publicCloud/project
List lifecycle rulesAlpha
GET
/v2/ publicCloud/ project/ {projectId}/ storage/ object/ bucket/ {bucketName}/ lifecycle
Returns the rules that expire objects or move them to another storage class.
Path parameters
bucket Name
required
string
Bucket name
project Id
required
string
Project ID
Response
200Lifecycle Rules Responsesuccessful operation
rules
read-only
Lifecycle Rule []
Array of lifecycle rules
409objectError 409 response
Example uses bucketName = string, projectId = string
$ curl https:/ / api.eu.ovhcloud.com/ v2/ publicCloud/ project/ {projectId}/ storage/ object/ bucket/ {bucketName}/ lifecycle \
-H "authorization: Bearer $OVH_TOKEN"{ "rules": [ { "abortIncompleteMultipartUpload": { "daysAfterInitiation": 0 }, "expiration": { "date": "2024-01-01", "days": 0, "expiredObjectDeleteMarker": true }, "filter": { "objectSizeGreaterThan": 0, "objectSizeLessThan": 0, "prefix": "string", "tags": { "key": "string" } }, "id": "string", "noncurrentVersionExpiration": { "newerNoncurrentVersions": 0, "noncurrentDays": 0 }, "noncurrentVersionTransitions": [ { "newerNoncurrentVersions": 0, "noncurrentDays": 0, "storageClass": "DEEP_ARCHIVE" } ], "status": "DISABLED", "transitions": [ { "date": "2024-01-01", "days": 0, "storageClass": "DEEP_ARCHIVE" } ] } ]}
Replace lifecycle rulesAlpha
PUT
/v2/ publicCloud/ project/ {projectId}/ storage/ object/ bucket/ {bucketName}/ lifecycle
Replaces all lifecycle rules of the bucket. An empty list deletes all rules.
Path parameters
bucket Name
required
string
Bucket name
project Id
required
string
Project ID
Request body (required)
rules
required
Lifecycle Rule []
Array of lifecycle rules. An empty array deletes all rules.
Response
200Lifecycle Rules Responsesuccessful operation
rules
read-only
Lifecycle Rule []
Array of lifecycle rules
409objectError 409 response
Example uses bucketName = string, projectId = string
$ curl https:/ / api.eu.ovhcloud.com/ v2/ publicCloud/ project/ {projectId}/ storage/ object/ bucket/ {bucketName}/ lifecycle \
-H "authorization: Bearer $OVH_TOKEN"{ "rules": [ { "abortIncompleteMultipartUpload": { "daysAfterInitiation": 0 }, "expiration": { "date": "2024-01-01", "days": 0, "expiredObjectDeleteMarker": true }, "filter": { "objectSizeGreaterThan": 0, "objectSizeLessThan": 0, "prefix": "string", "tags": { "key": "string" } }, "id": "string", "noncurrentVersionExpiration": { "newerNoncurrentVersions": 0, "noncurrentDays": 0 }, "noncurrentVersionTransitions": [ { "newerNoncurrentVersions": 0, "noncurrentDays": 0, "storageClass": "DEEP_ARCHIVE" } ], "status": "DISABLED", "transitions": [ { "date": "2024-01-01", "days": 0, "storageClass": "DEEP_ARCHIVE" } ] } ]}