(Optional) Apply rule action to items whose age, in days, exceeds this value.
created_before
datetime.date
(Optional) Apply rule action to items created before this date.
is_live
bool
(Optional) If true, apply rule action to non-versioned items, or to items with no newer versions. If false, apply rule action to versioned items with at least one newer version.
matches_prefix
list(str)
(Optional) Apply rule action to items which any prefix matches the beginning of the item name.
matches_storage_class
list(str), one or more of Bucket.STORAGE_CLASSES.
(Optional) Apply rule action to items whose storage class matches this value.
matches_suffix
list(str)
(Optional) Apply rule action to items which any suffix matches the end of the item name.
number_of_newer_versions
int
(Optional) Apply rule action to versioned items having N newer versions.
days_since_custom_time
int
(Optional) Apply rule action to items whose number of days elapsed since the custom timestamp. This condition is relevant only for versioned objects. The value of the field must be a non negative integer. If it's zero, the object version will become eligible for lifecycle action as soon as it becomes custom.
custom_time_before
datetime.date
(Optional) Date object parsed from RFC3339 valid date, apply rule action to items whose custom time is before this date. This condition is relevant only for versioned objects, e.g., 2019-03-16.
days_since_noncurrent_time
int
(Optional) Apply rule action to items whose number of days elapsed since the non current timestamp. This condition is relevant only for versioned objects. The value of the field must be a non negative integer. If it's zero, the object version will become eligible for lifecycle action as soon as it becomes non current.
noncurrent_time_before
datetime.date
(Optional) Date object parsed from RFC3339 valid date, apply rule action to items whose non current time is before this date. This condition is relevant only for versioned objects, e.g, 2019-03-16.
Properties
age
Conditon's age value.
created_before
Conditon's created_before value.
custom_time_before
Conditon's 'custom_time_before' value.
days_since_custom_time
Conditon's 'days_since_custom_time' value.
days_since_noncurrent_time
Conditon's 'days_since_noncurrent_time' value.
is_live
Conditon's 'is_live' value.
matches_prefix
Conditon's 'matches_prefix' value.
matches_storage_class
Conditon's 'matches_storage_class' value.
matches_suffix
Conditon's 'matches_suffix' value.
noncurrent_time_before
Conditon's 'noncurrent_time_before' value.
number_of_newer_versions
Conditon's 'number_of_newer_versions' value.
Methods
clear
clear()
API documentation for storage.bucket.LifecycleRuleConditions.clear method.
copy
copy()
API documentation for storage.bucket.LifecycleRuleConditions.copy method.
from_api_repr
from_api_repr(resource)
Factory: construct instance from resource.
Parameter
Name
Description
resource
dict
mapping as returned from API call.
Returns
Type
Description
LifecycleRuleConditions
Instance created from resource.
fromkeys
fromkeys(value=None,/)
Create a new dictionary with keys from iterable and values set to value.
get
get(key,default=None,/)
Return the value for key if key is in the dictionary, else default.
items
items()
API documentation for storage.bucket.LifecycleRuleConditions.items method.
keys
keys()
API documentation for storage.bucket.LifecycleRuleConditions.keys method.
pop
pop(k[,d])
If the key is not found, return the default if given; otherwise,
raise a KeyError.
popitem
popitem()
Remove and return a (key, value) pair as a 2-tuple.
Pairs are returned in LIFO (last-in, first-out) order.
Raises KeyError if the dict is empty.
setdefault
setdefault(key,default=None,/)
Insert key with a value of default if key is not in the dictionary.
Return the value for key if key is in the dictionary, else default.
update
update([E,]**F)
If E is present and has a .keys() method, then does: for k in E: D[k] = E[k]
If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v
In either case, this is followed by: for k in F: D[k] = F[k]
values
values()
API documentation for storage.bucket.LifecycleRuleConditions.values method.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-12 UTC."],[],[],null,["# Class LifecycleRuleConditions (3.3.0)\n\nVersion latestkeyboard_arrow_down\n\n- [3.3.0 (latest)](/python/docs/reference/storage/latest/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [3.2.0](/python/docs/reference/storage/3.2.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [3.1.1](/python/docs/reference/storage/3.1.1/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [3.0.0](/python/docs/reference/storage/3.0.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.19.0](/python/docs/reference/storage/2.19.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.17.0](/python/docs/reference/storage/2.17.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.16.0](/python/docs/reference/storage/2.16.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.15.0](/python/docs/reference/storage/2.15.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.14.0](/python/docs/reference/storage/2.14.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.13.0](/python/docs/reference/storage/2.13.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.12.0](/python/docs/reference/storage/2.12.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.11.0](/python/docs/reference/storage/2.11.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.10.0](/python/docs/reference/storage/2.10.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.9.0](/python/docs/reference/storage/2.9.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.8.0](/python/docs/reference/storage/2.8.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.7.0](/python/docs/reference/storage/2.7.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.6.0](/python/docs/reference/storage/2.6.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.5.0](/python/docs/reference/storage/2.5.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.4.0](/python/docs/reference/storage/2.4.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.3.0](/python/docs/reference/storage/2.3.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.2.1](/python/docs/reference/storage/2.2.1/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.1.0](/python/docs/reference/storage/2.1.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [2.0.0](/python/docs/reference/storage/2.0.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.44.0](/python/docs/reference/storage/1.44.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.43.0](/python/docs/reference/storage/1.43.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.42.3](/python/docs/reference/storage/1.42.3/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.41.1](/python/docs/reference/storage/1.41.1/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.40.0](/python/docs/reference/storage/1.40.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.39.0](/python/docs/reference/storage/1.39.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.38.0](/python/docs/reference/storage/1.38.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.37.1](/python/docs/reference/storage/1.37.1/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.36.2](/python/docs/reference/storage/1.36.2/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.35.1](/python/docs/reference/storage/1.35.1/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.34.0](/python/docs/reference/storage/1.34.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.33.0](/python/docs/reference/storage/1.33.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.32.0](/python/docs/reference/storage/1.32.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.31.2](/python/docs/reference/storage/1.31.2/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.30.0](/python/docs/reference/storage/1.30.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.29.0](/python/docs/reference/storage/1.29.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.28.1](/python/docs/reference/storage/1.28.1/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.27.0](/python/docs/reference/storage/1.27.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.26.0](/python/docs/reference/storage/1.26.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.25.0](/python/docs/reference/storage/1.25.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.24.1](/python/docs/reference/storage/1.24.1/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.23.0](/python/docs/reference/storage/1.23.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.22.0](/python/docs/reference/storage/1.22.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.21.0](/python/docs/reference/storage/1.21.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.20.0](/python/docs/reference/storage/1.20.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.19.0](/python/docs/reference/storage/1.19.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.18.0](/python/docs/reference/storage/1.18.0/google.cloud.storage.bucket.LifecycleRuleConditions)\n- [1.17.0](/python/docs/reference/storage/1.17.0/google.cloud.storage.bucket.LifecycleRuleConditions) \n\n LifecycleRuleConditions(\n age=None,\n created_before=None,\n is_live=None,\n matches_storage_class=None,\n number_of_newer_versions=None,\n days_since_custom_time=None,\n custom_time_before=None,\n days_since_noncurrent_time=None,\n noncurrent_time_before=None,\n matches_prefix=None,\n matches_suffix=None,\n _factory=False,\n )\n\nMap a single lifecycle rule for a bucket.\n\nSee: \u003chttps://cloud.google.com/storage/docs/lifecycle\u003e\n\nProperties\n----------\n\n### age\n\nConditon's age value.\n\n### created_before\n\nConditon's created_before value.\n\n### custom_time_before\n\nConditon's 'custom_time_before' value.\n\n### days_since_custom_time\n\nConditon's 'days_since_custom_time' value.\n\n### days_since_noncurrent_time\n\nConditon's 'days_since_noncurrent_time' value.\n\n### is_live\n\nConditon's 'is_live' value.\n\n### matches_prefix\n\nConditon's 'matches_prefix' value.\n\n### matches_storage_class\n\nConditon's 'matches_storage_class' value.\n\n### matches_suffix\n\nConditon's 'matches_suffix' value.\n\n### noncurrent_time_before\n\nConditon's 'noncurrent_time_before' value.\n\n### number_of_newer_versions\n\nConditon's 'number_of_newer_versions' value.\n\nMethods\n-------\n\n### clear\n\n clear()\n\nAPI documentation for `storage.bucket.LifecycleRuleConditions.clear` method.\n\n### copy\n\n copy()\n\nAPI documentation for `storage.bucket.LifecycleRuleConditions.copy` method.\n\n### from_api_repr\n\n from_api_repr(resource)\n\nFactory: construct instance from resource.\n\n### fromkeys\n\n fromkeys(value=None, /)\n\nCreate a new dictionary with keys from iterable and values set to value.\n\n### get\n\n get(key, default=None, /)\n\nReturn the value for key if key is in the dictionary, else default.\n\n### items\n\n items()\n\nAPI documentation for `storage.bucket.LifecycleRuleConditions.items` method.\n\n### keys\n\n keys()\n\nAPI documentation for `storage.bucket.LifecycleRuleConditions.keys` method.\n\n### pop\n\n pop(k[,d])\n\nIf the key is not found, return the default if given; otherwise,\nraise a KeyError.\n\n### popitem\n\n popitem()\n\nRemove and return a (key, value) pair as a 2-tuple.\n\nPairs are returned in LIFO (last-in, first-out) order.\nRaises KeyError if the dict is empty.\n\n### setdefault\n\n setdefault(key, default=None, /)\n\nInsert key with a value of default if key is not in the dictionary.\n\nReturn the value for key if key is in the dictionary, else default.\n\n### update\n\n update([E, ]**F)\n\nIf E is present and has a .keys() method, then does: for k in E: D\\[k\\] = E\\[k\\]\nIf E is present and lacks a .keys() method, then does: for k, v in E: D\\[k\\] = v\nIn either case, this is followed by: for k in F: D\\[k\\] = F\\[k\\]\n\n### values\n\n values()\n\nAPI documentation for `storage.bucket.LifecycleRuleConditions.values` method."]]