Class Retention (3.5.0)
- 3.5.0 (latest)
- 3.4.1
- 3.3.1
- 3.2.0
- 3.1.1
- 3.0.0
- 2.19.0
- 2.17.0
- 2.16.0
- 2.15.0
- 2.14.0
- 2.13.0
- 2.12.0
- 2.11.0
- 2.10.0
- 2.9.0
- 2.8.0
- 2.7.0
- 2.6.0
- 2.5.0
- 2.4.0
- 2.3.0
- 2.2.1
- 2.1.0
- 2.0.0
- 1.44.0
- 1.43.0
- 1.42.3
- 1.41.1
- 1.40.0
- 1.39.0
- 1.38.0
- 1.37.1
- 1.36.2
- 1.35.1
- 1.34.0
- 1.33.0
- 1.32.0
- 1.31.2
- 1.30.0
- 1.29.0
- 1.28.1
- 1.27.0
- 1.26.0
- 1.25.0
- 1.24.1
- 1.23.0
- 1.22.0
- 1.21.0
- 1.20.0
- 1.19.0
- 1.18.0
- 1.17.0
Retention(blob,mode=None,retain_until_time=None,retention_expiration_time=None)Map an object's retention configuration.
Properties
blob
Blob for which this retention configuration applies to.
| Returns | |
|---|---|
| Type | Description |
| the instance's blob. |
mode
The mode of the retention configuration. Options are 'Unlocked' or 'Locked'.
| Returns | |
|---|---|
| Type | Description |
string | The mode of the retention configuration, which can be either set to 'Unlocked' or 'Locked'. |
retain_until_time
The earliest time that the object can be deleted or replaced, which is theretention configuration set for this object.
| Returns | |
|---|---|
| Type | Description |
| Datetime object parsed from RFC3339 valid timestamp, orNone if the blob's resource has not been loaded from the server (seereload). |
retention_expiration_time
The earliest time that the object can be deleted, which depends on anyretention configuration set for the object and any retention policy set forthe bucket that contains the object.
| Returns | |
|---|---|
| Type | Description |
| (readonly) The earliest time that the object can be deleted. |
Methods
clear
clear()API documentation forstorage.blob.Retention.clear method.
copy
copy()API documentation forstorage.blob.Retention.copy method.
from_api_repr
from_api_repr(resource,blob)Factory: construct instance from resource.
| Parameter | |
|---|---|
| Name | Description |
resource | dictmapping as returned from API call. |
| Returns | |
|---|---|
| Type | Description |
| Retention configuration 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 forstorage.blob.Retention.items method.
keys
keys()API documentation forstorage.blob.Retention.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] = vIn either case, this is followed by: for k in F: D[k] = F[k]
values
values()API documentation forstorage.blob.Retention.values method.
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-11-05 UTC.