Set lifecycle rules for a bucket

PUT https://mgmt.storage.dev/v1/providers/:provider_id/orgs/:org_id/buckets/:bucket_name/lifecycle

Sets lifecycle rules for automatic object transitions and expiration. If lifecycle rules already exist, they will be completely replaced with the new configuration.

Lifecycle Rules Overview

Lifecycle rules allow you to automatically:

• Transition objects to cheaper storage classes after a specified time
• Expire (permanently delete) objects after a specified time

Examples

Archive old logs and delete after 1 year

{
  "rules": [
    {
      "id": "archive-and-cleanup-logs",
      "enabled": true,
      "transitions": [
        { "days": 90, "storage_class": "GLACIER" }
      ],
      "expiration": { "days": 365 }
    }
  ]
}

Request

Path Parameters

provider_id string required

Provider ID

org_id string required

Organization ID

bucket_name string required

Bucket name

Body required

rules object[] required

List of lifecycle rules to apply to the bucket.

Array [

id string required

Unique identifier for the rule (max 255 chars). Use a descriptive name like archive-old-logs or expire-temp-uploads.

enabled boolean required

Whether the rule is currently active. Set to false to temporarily disable a rule without deleting it. When disabled, objects will not be transitioned or expired by this rule.

expiration object

Configuration for automatic object deletion (expiration).

Specify ONE Condition (Not Both)

• days: Delete objects N days after their creation date
• date: Delete all matching objects on a specific date

days integer

Number of days after object creation when the object will be deleted.

date date-time

Specific date (at midnight UTC) when all matching objects will be deleted, regardless of when they were created.

transitions object[]

List of storage class transitions. Objects will transition through each defined step.

Array [

days integer

Number of days after object creation when the transition occurs.

date date-time

Specific date (at midnight UTC) when all matching objects will be transitioned, regardless of when they were created.

storage_class StorageClass required

Storage class for the bucket. Default is STANDARD.

Possible values: [STANDARD, STANDARD_IA, GLACIER, GLACIER_IR]

filter object

Optional scope for a lifecycle rule. When unset, the rule applies to every object in the bucket.

prefix string

Only apply this rule to objects whose keys start with the given prefix.

{
  "rules": [
    {
      "id": "string",
      "enabled": true,
      "expiration": {
        "days": 0,
        "date": "2025-01-01T00:00:00Z"
      },
      "transitions": [
        {
          "days": 0,
          "date": "2025-06-01T00:00:00Z",
          "storage_class": "STANDARD"
        }
      ],
      "filter": {
        "prefix": "string"
      }
    }
  ]
}

Responses

• 200

  OK

• default

Unexpected error

{
  "message": "string"
}

Authorization: X-Tigris-Signature

name: X-Tigris-Signature
type: apiKey
in: header
description: HMAC-SHA256 of the canonical request signed using the signing key.

name: X-Tigris-Nonce
type: apiKey
in: header
description: Random unique string to identify the request and prevent replay attacks.

name: X-Tigris-Time
type: apiKey
in: header
description: Unix timestamp in milliseconds of the request.

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://mgmt.storage.dev/v1/providers/:provider_id/orgs/:org_id/buckets/:bucket_name/lifecycle");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("X-Tigris-Signature", "<X-Tigris-Signature>");
request.Headers.Add("X-Tigris-Nonce", "<X-Tigris-Nonce>");
request.Headers.Add("X-Tigris-Time", "<X-Tigris-Time>");
var content = new StringContent("{\n  \"rules\": [\n    {\n      \"id\": \"string\",\n      \"enabled\": true,\n      \"expiration\": {\n        \"days\": 0,\n        \"date\": \"2025-01-01T00:00:00Z\"\n      },\n      \"transitions\": [\n        {\n          \"days\": 0,\n          \"date\": \"2025-06-01T00:00:00Z\",\n          \"storage_class\": \"STANDARD\"\n        }\n      ],\n      \"filter\": {\n        \"prefix\": \"string\"\n      }\n    }\n  ]\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());