google-apis-storage_v1 0.25.0 → 0.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97d723a830a6b3c4533858d6ef2860700803d1ee0f31db97de0353013d5798a9
-  data.tar.gz: 56136bf429ae75777b77a4558173b67b690b73c0f84d478a04f58352655c469c
+  metadata.gz: feb2fe9978aa4d9c7958652200ba4260223738ff141abab73f911ab49df518c9
+  data.tar.gz: dc95d0254e830623e5149c6a32f1e79f8801c7c1a988a4d9bc9ea88f3005f146
 SHA512:
-  metadata.gz: f59961dfbbc27597440a1ebc55e8a21867c00c0f9b8a84debb474f5c0393906b19b95c5638075435e821ddce88cb18d6ec6d500136997720a860acf067743f47
-  data.tar.gz: 157005bc3557e49e37a58f38439babd494a7f88f4b279a2489ce51b5d9f3846ba9af742991d964f1527c4c549f3eb87c211690f566aa4457100540154089f77b
+  metadata.gz: 33cff6aefb30306df3a0333fc37ee16accdf54e3d553c029a000909fed19d3ad858f95307555604498acf8c6194a950388e5b38776fd2a4aee39fed22889bf80
+  data.tar.gz: d1f0ca34f4e9dc2d99c94273736012a197f0d0188f6c38d2fcf7d305b45e60aba9d3fe71a82017e3bec0bec6d24ad3ff718aea51e16121d5763d4e56bfc247a2

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-storage_v1
 
+### v0.27.0 (2023-09-24)
+
+* Regenerated from discovery document revision 20230922
+
+### v0.26.0 (2023-09-17)
+
+* Regenerated from discovery document revision 20230914
+
 ### v0.25.0 (2023-09-10)
 
 * Regenerated from discovery document revision 20230907

data/lib/google/apis/storage_v1/classes.rb

@@ -137,6 +137,11 @@ module Google
         # @return [String]
         attr_accessor :name
       
+        # The bucket's object retention config.
+        # Corresponds to the JSON property `objectRetention`
+        # @return [Google::Apis::StorageV1::Bucket::ObjectRetention]
+        attr_accessor :object_retention
+      
         # The owner of the bucket. This is always the project team's owner group.
         # Corresponds to the JSON property `owner`
         # @return [Google::Apis::StorageV1::Bucket::Owner]
@@ -177,6 +182,12 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
+        # The bucket's soft delete policy, which defines the period of time that soft-
+        # deleted objects will be retained, and cannot be permanently deleted.
+        # Corresponds to the JSON property `softDeletePolicy`
+        # @return [Google::Apis::StorageV1::Bucket::SoftDeletePolicy]
+        attr_accessor :soft_delete_policy
+      
         # The bucket's default storage class, used whenever no storageClass is specified
         # for a newly-created object. This defines how objects in the bucket are stored
         # and determines the SLA and the cost of storage. Values include MULTI_REGIONAL,
@@ -235,12 +246,14 @@ module Google
           @logging = args[:logging] if args.key?(:logging)
           @metageneration = args[:metageneration] if args.key?(:metageneration)
           @name = args[:name] if args.key?(:name)
+          @object_retention = args[:object_retention] if args.key?(:object_retention)
           @owner = args[:owner] if args.key?(:owner)
           @project_number = args[:project_number] if args.key?(:project_number)
           @retention_policy = args[:retention_policy] if args.key?(:retention_policy)
           @rpo = args[:rpo] if args.key?(:rpo)
           @satisfies_pzs = args[:satisfies_pzs] if args.key?(:satisfies_pzs)
           @self_link = args[:self_link] if args.key?(:self_link)
+          @soft_delete_policy = args[:soft_delete_policy] if args.key?(:soft_delete_policy)
           @storage_class = args[:storage_class] if args.key?(:storage_class)
           @time_created = args[:time_created] if args.key?(:time_created)
           @updated = args[:updated] if args.key?(:updated)
@@ -258,6 +271,19 @@ module Google
           attr_accessor :enabled
           alias_method :enabled?, :enabled
         
+          # The storage class that objects in the bucket eventually transition to if they
+          # are not read for a certain length of time. Valid values are NEARLINE and
+          # ARCHIVE.
+          # Corresponds to the JSON property `terminalStorageClass`
+          # @return [String]
+          attr_accessor :terminal_storage_class
+        
+          # A date and time in RFC 3339 format representing the time of the most recent
+          # update to "terminalStorageClass".
+          # Corresponds to the JSON property `terminalStorageClassUpdateTime`
+          # @return [DateTime]
+          attr_accessor :terminal_storage_class_update_time
+        
           # A date and time in RFC 3339 format representing the instant at which "enabled"
           # was last toggled.
           # Corresponds to the JSON property `toggleTime`
@@ -271,6 +297,8 @@ module Google
           # Update properties of this object
           def update!(**args)
             @enabled = args[:enabled] if args.key?(:enabled)
+            @terminal_storage_class = args[:terminal_storage_class] if args.key?(:terminal_storage_class)
+            @terminal_storage_class_update_time = args[:terminal_storage_class_update_time] if args.key?(:terminal_storage_class_update_time)
             @toggle_time = args[:toggle_time] if args.key?(:toggle_time)
           end
         end
@@ -682,6 +710,25 @@ module Google
           end
         end
         
+        # The bucket's object retention config.
+        class ObjectRetention
+          include Google::Apis::Core::Hashable
+        
+          # The bucket's object retention mode. Can be Enabled.
+          # Corresponds to the JSON property `mode`
+          # @return [String]
+          attr_accessor :mode
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @mode = args[:mode] if args.key?(:mode)
+          end
+        end
+        
         # The owner of the bucket. This is always the project team's owner group.
         class Owner
           include Google::Apis::Core::Hashable
@@ -751,6 +798,34 @@ module Google
           end
         end
         
+        # The bucket's soft delete policy, which defines the period of time that soft-
+        # deleted objects will be retained, and cannot be permanently deleted.
+        class SoftDeletePolicy
+          include Google::Apis::Core::Hashable
+        
+          # Server-determined value that indicates the time from which the policy, or one
+          # with a greater retention, was effective. This value is in RFC 3339 format.
+          # Corresponds to the JSON property `effectiveTime`
+          # @return [DateTime]
+          attr_accessor :effective_time
+        
+          # The period of time in seconds, that soft-deleted objects in the bucket will be
+          # retained and cannot be permanently deleted.
+          # Corresponds to the JSON property `retentionDurationSeconds`
+          # @return [Fixnum]
+          attr_accessor :retention_duration_seconds
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @effective_time = args[:effective_time] if args.key?(:effective_time)
+            @retention_duration_seconds = args[:retention_duration_seconds] if args.key?(:retention_duration_seconds)
+          end
+        end
+        
         # The bucket's versioning configuration.
         class Versioning
           include Google::Apis::Core::Hashable
@@ -1740,6 +1815,11 @@ module Google
         # @return [Google::Apis::StorageV1::Object::Owner]
         attr_accessor :owner
       
+        # A collection of object level retention parameters.
+        # Corresponds to the JSON property `retention`
+        # @return [Google::Apis::StorageV1::Object::Retention]
+        attr_accessor :retention
+      
         # A server-determined value that specifies the earliest time that the object's
         # retention period expires. This value is in RFC 3339 format. Note 1: This field
         # is not provided for objects with an active event-based hold, since retention
@@ -1830,6 +1910,7 @@ module Google
           @metageneration = args[:metageneration] if args.key?(:metageneration)
           @name = args[:name] if args.key?(:name)
           @owner = args[:owner] if args.key?(:owner)
+          @retention = args[:retention] if args.key?(:retention)
           @retention_expiration_time = args[:retention_expiration_time] if args.key?(:retention_expiration_time)
           @self_link = args[:self_link] if args.key?(:self_link)
           @size = args[:size] if args.key?(:size)
@@ -1891,6 +1972,31 @@ module Google
             @entity_id = args[:entity_id] if args.key?(:entity_id)
           end
         end
+        
+        # A collection of object level retention parameters.
+        class Retention
+          include Google::Apis::Core::Hashable
+        
+          # The bucket's object retention mode, can only be Unlocked or Locked.
+          # Corresponds to the JSON property `mode`
+          # @return [String]
+          attr_accessor :mode
+        
+          # A time in RFC 3339 format until which object retention protects this object.
+          # Corresponds to the JSON property `retainUntilTime`
+          # @return [DateTime]
+          attr_accessor :retain_until_time
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @mode = args[:mode] if args.key?(:mode)
+            @retain_until_time = args[:retain_until_time] if args.key?(:retain_until_time)
+          end
+        end
       end
       
       # An access-control entry.

data/lib/google/apis/storage_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module StorageV1
       # Version of the google-apis-storage_v1 gem
-      GEM_VERSION = "0.25.0"
+      GEM_VERSION = "0.27.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.12.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20230907"
+      REVISION = "20230922"
     end
   end
 end

data/lib/google/apis/storage_v1/representations.rb

@@ -103,6 +103,12 @@ module Google
           include Google::Apis::Core::JsonObjectSupport
         end
         
+        class ObjectRetention
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+          include Google::Apis::Core::JsonObjectSupport
+        end
+        
         class Owner
           class Representation < Google::Apis::Core::JsonRepresentation; end
         
@@ -115,6 +121,12 @@ module Google
           include Google::Apis::Core::JsonObjectSupport
         end
         
+        class SoftDeletePolicy
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+          include Google::Apis::Core::JsonObjectSupport
+        end
+        
         class Versioning
           class Representation < Google::Apis::Core::JsonRepresentation; end
         
@@ -252,6 +264,12 @@ module Google
         
           include Google::Apis::Core::JsonObjectSupport
         end
+        
+        class Retention
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+          include Google::Apis::Core::JsonObjectSupport
+        end
       
         include Google::Apis::Core::JsonObjectSupport
       end
@@ -342,6 +360,8 @@ module Google
       
           property :metageneration, :numeric_string => true, as: 'metageneration'
           property :name, as: 'name'
+          property :object_retention, as: 'objectRetention', class: Google::Apis::StorageV1::Bucket::ObjectRetention, decorator: Google::Apis::StorageV1::Bucket::ObjectRetention::Representation
+      
           property :owner, as: 'owner', class: Google::Apis::StorageV1::Bucket::Owner, decorator: Google::Apis::StorageV1::Bucket::Owner::Representation
       
           property :project_number, :numeric_string => true, as: 'projectNumber'
@@ -350,6 +370,8 @@ module Google
           property :rpo, as: 'rpo'
           property :satisfies_pzs, as: 'satisfiesPZS'
           property :self_link, as: 'selfLink'
+          property :soft_delete_policy, as: 'softDeletePolicy', class: Google::Apis::StorageV1::Bucket::SoftDeletePolicy, decorator: Google::Apis::StorageV1::Bucket::SoftDeletePolicy::Representation
+      
           property :storage_class, as: 'storageClass'
           property :time_created, as: 'timeCreated', type: DateTime
       
@@ -365,6 +387,9 @@ module Google
           # @private
           class Representation < Google::Apis::Core::JsonRepresentation
             property :enabled, as: 'enabled'
+            property :terminal_storage_class, as: 'terminalStorageClass'
+            property :terminal_storage_class_update_time, as: 'terminalStorageClassUpdateTime', type: DateTime
+        
             property :toggle_time, as: 'toggleTime', type: DateTime
         
           end
@@ -485,6 +510,13 @@ module Google
           end
         end
         
+        class ObjectRetention
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            property :mode, as: 'mode'
+          end
+        end
+        
         class Owner
           # @private
           class Representation < Google::Apis::Core::JsonRepresentation
@@ -503,6 +535,15 @@ module Google
           end
         end
         
+        class SoftDeletePolicy
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            property :effective_time, as: 'effectiveTime', type: DateTime
+        
+            property :retention_duration_seconds, :numeric_string => true, as: 'retentionDurationSeconds'
+          end
+        end
+        
         class Versioning
           # @private
           class Representation < Google::Apis::Core::JsonRepresentation
@@ -753,6 +794,8 @@ module Google
           property :name, as: 'name'
           property :owner, as: 'owner', class: Google::Apis::StorageV1::Object::Owner, decorator: Google::Apis::StorageV1::Object::Owner::Representation
       
+          property :retention, as: 'retention', class: Google::Apis::StorageV1::Object::Retention, decorator: Google::Apis::StorageV1::Object::Retention::Representation
+      
           property :retention_expiration_time, as: 'retentionExpirationTime', type: DateTime
       
           property :self_link, as: 'selfLink'
@@ -784,6 +827,15 @@ module Google
             property :entity_id, as: 'entityId'
           end
         end
+        
+        class Retention
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            property :mode, as: 'mode'
+            property :retain_until_time, as: 'retainUntilTime', type: DateTime
+        
+          end
+        end
       end
       
       class ObjectAccessControl

data/lib/google/apis/storage_v1/service.rb

@@ -426,6 +426,8 @@ module Google
         # @param [String] project
         #   A valid API project identifier.
         # @param [Google::Apis::StorageV1::Bucket] bucket_object
+        # @param [Boolean] enable_object_retention
+        #   When set to true, object retention is enabled for this bucket.
         # @param [String] predefined_acl
         #   Apply a predefined set of access controls to this bucket.
         # @param [String] predefined_default_object_acl
@@ -454,12 +456,13 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def insert_bucket(project, bucket_object = nil, predefined_acl: nil, predefined_default_object_acl: nil, projection: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def insert_bucket(project, bucket_object = nil, enable_object_retention: nil, predefined_acl: nil, predefined_default_object_acl: nil, projection: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:post, 'b', options)
           command.request_representation = Google::Apis::StorageV1::Bucket::Representation
           command.request_object = bucket_object
           command.response_representation = Google::Apis::StorageV1::Bucket::Representation
           command.response_class = Google::Apis::StorageV1::Bucket
+          command.query['enableObjectRetention'] = enable_object_retention unless enable_object_retention.nil?
           command.query['predefinedAcl'] = predefined_acl unless predefined_acl.nil?
           command.query['predefinedDefaultObjectAcl'] = predefined_default_object_acl unless predefined_default_object_acl.nil?
           command.query['project'] = project unless project.nil?
@@ -2073,6 +2076,9 @@ module Google
         # @param [Fixnum] if_metageneration_not_match
         #   Makes the operation conditional on whether the object's current metageneration
         #   does not match the given value.
+        # @param [Boolean] override_unlocked_retention
+        #   Must be true to remove the retention configuration, reduce its unlocked
+        #   retention period, or change its mode from unlocked to locked.
         # @param [String] predefined_acl
         #   Apply a predefined set of access controls to this object.
         # @param [String] projection
@@ -2098,7 +2104,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def patch_object(bucket, object, object_object = nil, generation: nil, if_generation_match: nil, if_generation_not_match: nil, if_metageneration_match: nil, if_metageneration_not_match: nil, predefined_acl: nil, projection: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def patch_object(bucket, object, object_object = nil, generation: nil, if_generation_match: nil, if_generation_not_match: nil, if_metageneration_match: nil, if_metageneration_not_match: nil, override_unlocked_retention: nil, predefined_acl: nil, projection: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:patch, 'b/{bucket}/o/{object}', options)
           command.request_representation = Google::Apis::StorageV1::Object::Representation
           command.request_object = object_object
@@ -2111,6 +2117,7 @@ module Google
           command.query['ifGenerationNotMatch'] = if_generation_not_match unless if_generation_not_match.nil?
           command.query['ifMetagenerationMatch'] = if_metageneration_match unless if_metageneration_match.nil?
           command.query['ifMetagenerationNotMatch'] = if_metageneration_not_match unless if_metageneration_not_match.nil?
+          command.query['overrideUnlockedRetention'] = override_unlocked_retention unless override_unlocked_retention.nil?
           command.query['predefinedAcl'] = predefined_acl unless predefined_acl.nil?
           command.query['projection'] = projection unless projection.nil?
           command.query['userProject'] = user_project unless user_project.nil?
@@ -2127,6 +2134,9 @@ module Google
         #   Name of the object. For information about how to URL encode object names to be
         #   path safe, see Encoding URI Path Parts.
         # @param [Google::Apis::StorageV1::Object] object_object
+        # @param [Boolean] copy_source_acl
+        #   If true, copies the source object's ACL; otherwise, uses the bucket's default
+        #   object ACL. The default is false.
         # @param [Fixnum] if_generation_match
         #   Makes the operation conditional on whether the object's one live generation
         #   matches the given value. Setting to 0 makes the operation succeed only if
@@ -2165,7 +2175,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def restore_object(bucket, object, object_object = nil, if_generation_match: nil, if_generation_not_match: nil, if_metageneration_match: nil, if_metageneration_not_match: nil, projection: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def restore_object(bucket, object, object_object = nil, copy_source_acl: nil, if_generation_match: nil, if_generation_not_match: nil, if_metageneration_match: nil, if_metageneration_not_match: nil, projection: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:post, 'b/{bucket}/o/{object}/restore', options)
           command.request_representation = Google::Apis::StorageV1::Object::Representation
           command.request_object = object_object
@@ -2173,6 +2183,7 @@ module Google
           command.response_class = Google::Apis::StorageV1::Object
           command.params['bucket'] = bucket unless bucket.nil?
           command.params['object'] = object unless object.nil?
+          command.query['copySourceAcl'] = copy_source_acl unless copy_source_acl.nil?
           command.query['generation'] = generation unless generation.nil?
           command.query['ifGenerationMatch'] = if_generation_match unless if_generation_match.nil?
           command.query['ifGenerationNotMatch'] = if_generation_not_match unless if_generation_not_match.nil?
@@ -2430,6 +2441,9 @@ module Google
         # @param [Fixnum] if_metageneration_not_match
         #   Makes the operation conditional on whether the object's current metageneration
         #   does not match the given value.
+        # @param [Boolean] override_unlocked_retention
+        #   Must be true to remove the retention configuration, reduce its unlocked
+        #   retention period, or change its mode from unlocked to locked.
         # @param [String] predefined_acl
         #   Apply a predefined set of access controls to this object.
         # @param [String] projection
@@ -2455,7 +2469,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def update_object(bucket, object, object_object = nil, generation: nil, if_generation_match: nil, if_generation_not_match: nil, if_metageneration_match: nil, if_metageneration_not_match: nil, predefined_acl: nil, projection: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def update_object(bucket, object, object_object = nil, generation: nil, if_generation_match: nil, if_generation_not_match: nil, if_metageneration_match: nil, if_metageneration_not_match: nil, override_unlocked_retention: nil, predefined_acl: nil, projection: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:put, 'b/{bucket}/o/{object}', options)
           command.request_representation = Google::Apis::StorageV1::Object::Representation
           command.request_object = object_object
@@ -2468,6 +2482,7 @@ module Google
           command.query['ifGenerationNotMatch'] = if_generation_not_match unless if_generation_not_match.nil?
           command.query['ifMetagenerationMatch'] = if_metageneration_match unless if_metageneration_match.nil?
           command.query['ifMetagenerationNotMatch'] = if_metageneration_not_match unless if_metageneration_not_match.nil?
+          command.query['overrideUnlockedRetention'] = override_unlocked_retention unless override_unlocked_retention.nil?
           command.query['predefinedAcl'] = predefined_acl unless predefined_acl.nil?
           command.query['projection'] = projection unless projection.nil?
           command.query['userProject'] = user_project unless user_project.nil?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-storage_v1
 version: !ruby/object:Gem::Version
-  version: 0.25.0
+  version: 0.27.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-10 00:00:00.000000000 Z
+date: 2023-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-storage_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-storage_v1/v0.25.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-storage_v1/v0.27.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-storage_v1
 post_install_message: 
 rdoc_options: []