Skip to content

Lifecycle Management

All operations require authentication.

2 operationsv2/publicCloud/project
Agent setup

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

bucketName
required
string

Bucket name

projectId
required
string

Project ID

Response

200LifecycleRulesResponsesuccessful operation
rules
read-only
LifecycleRule[]

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"
ResponseExample
{ "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

bucketName
required
string

Bucket name

projectId
required
string

Project ID

Request body (required)

rules
required
LifecycleRule[]

Array of lifecycle rules. An empty array deletes all rules.

Response

200LifecycleRulesResponsesuccessful operation
rules
read-only
LifecycleRule[]

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"
ResponseExample
{ "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" } ] } ]}