Skip to main content

LifecycleTransition

Configuration for transitioning objects to a different storage class.

When the transition condition is met, objects are moved to the specified storage class. This is useful for reducing storage costs by moving infrequently accessed data to cheaper tiers.

Specify ONE Condition (Not Both)​

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


<Schema
  schema={{"type":"object","required":["storage_class"],"description":"Configuration for transitioning objects to a different storage class.\n\nWhen the transition condition is met, objects are moved to the specified storage class.\nThis is useful for reducing storage costs by moving infrequently accessed data to cheaper tiers.\n\n## Specify ONE Condition (Not Both)\n\n- `days`: Transition objects N days after their creation date\n- `date`: Transition all matching objects on a specific date\n```\n","properties":{"days":{"type":"integer","description":"Number of days after object creation when the transition occurs.\nThe transition happens at midnight UTC on the calculated date.\n\nExample: If `days: 60` and an object was created on Jan 1, it transitions on Mar 2.\n"},"date":{"type":"string","format":"date-time","description":"Specific date (at midnight UTC) when all matching objects will be transitioned, regardless of when they were created.\nUse this for planned migrations or cost optimization deadlines.\n\nMust be a future date in RFC3339 format with midnight UTC time.\n","example":"2025-06-01T00:00:00Z"},"storage_class":{"type":"string","description":"Storage class for the bucket. Default is `STANDARD`.","enum":["STANDARD","STANDARD_IA","GLACIER","GLACIER_IR"],"title":"StorageClass"}},"title":"LifecycleTransition"}}
  schemaType={"response"}
>
  
</Schema>
LifecycleTransition
{
  "days": 0,
  "date": "2025-06-01T00:00:00Z",
  "storage_class": "STANDARD"
}