Class: Google::Apis::StorageV1::Bucket::RetentionPolicy
- Inherits:
-
Object
- Object
- Google::Apis::StorageV1::Bucket::RetentionPolicy
- Includes:
- Core::Hashable, Core::JsonObjectSupport
- Defined in:
- lib/google/apis/storage_v1/classes.rb,
lib/google/apis/storage_v1/representations.rb,
lib/google/apis/storage_v1/representations.rb
Overview
The bucket's retention policy. The retention policy enforces a minimum retention time for all objects contained in the bucket, based on their creation time. Any attempt to overwrite or delete objects younger than the retention period will result in a PERMISSION_DENIED error. An unlocked retention policy can be modified or removed from the bucket via a storage. buckets.update operation. A locked retention policy cannot be removed or shortened in duration for the lifetime of the bucket. Attempting to remove or decrease period of a locked retention policy will result in a PERMISSION_DENIED error.
Instance Attribute Summary collapse
-
#effective_time ⇒ DateTime
Server-determined value that indicates the time from which policy was enforced and effective.
-
#is_locked ⇒ Boolean
(also: #is_locked?)
Once locked, an object retention policy cannot be modified.
-
#retention_period ⇒ Fixnum
The duration in seconds that objects need to be retained.
Instance Method Summary collapse
-
#initialize(**args) ⇒ RetentionPolicy
constructor
A new instance of RetentionPolicy.
-
#update!(**args) ⇒ Object
Update properties of this object.
Constructor Details
#initialize(**args) ⇒ RetentionPolicy
Returns a new instance of RetentionPolicy.
716 717 718 |
# File 'lib/google/apis/storage_v1/classes.rb', line 716 def initialize(**args) update!(**args) end |
Instance Attribute Details
#effective_time ⇒ DateTime
Server-determined value that indicates the time from which policy was enforced
and effective. This value is in RFC 3339 format.
Corresponds to the JSON property effectiveTime
700 701 702 |
# File 'lib/google/apis/storage_v1/classes.rb', line 700 def effective_time @effective_time end |
#is_locked ⇒ Boolean Also known as: is_locked?
Once locked, an object retention policy cannot be modified.
Corresponds to the JSON property isLocked
705 706 707 |
# File 'lib/google/apis/storage_v1/classes.rb', line 705 def is_locked @is_locked end |
#retention_period ⇒ Fixnum
The duration in seconds that objects need to be retained. Retention duration
must be greater than zero and less than 100 years. Note that enforcement of
retention periods less than a day is not guaranteed. Such periods should only
be used for testing purposes.
Corresponds to the JSON property retentionPeriod
714 715 716 |
# File 'lib/google/apis/storage_v1/classes.rb', line 714 def retention_period @retention_period end |
Instance Method Details
#update!(**args) ⇒ Object
Update properties of this object
721 722 723 724 725 |
# File 'lib/google/apis/storage_v1/classes.rb', line 721 def update!(**args) @effective_time = args[:effective_time] if args.key?(:effective_time) @is_locked = args[:is_locked] if args.key?(:is_locked) @retention_period = args[:retention_period] if args.key?(:retention_period) end |