google-apis-storage_v1 0.24.0 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5034469e0103790dd96ab06b044c987e1726521c6cc2d50f1331bb5d10101b27
-  data.tar.gz: 3e17a0ee65922e9228da5dfe56d6310e2bbe0bb5b23e7dd30e1a70aa1962bff3
+  metadata.gz: 0ac3bda0c55dce8463c85e9d322b51eb398882c6d4839c91b0624c65c3d85322
+  data.tar.gz: 5a831d29ac1d89f9fe4690f86335973719c3a5c223472691328a91f6a90a1517
 SHA512:
-  metadata.gz: 9e4459da1abbfebbdbc48f5538fed89aff681f656e6da91d310fca43934cd8b9730eaffee6a9dc8d3b408ab7e27ec16a1fe3cbfe57cea53b65c594f764cb2e3c
-  data.tar.gz: 49bd875e7b6791bd67bb889e592a4f26831e1e12e7d9b2dcd6a81dcfd5f7155f5ae54d9b2cad78b4e7656d6110ca230e04c175e786a169adeab5685122ee4077
+  metadata.gz: b19d739437d70d60bf75c8d24e59e575e3ed08e847b048a628a69e6ce8891fa540dd4c46ec99a18ed2c003f765d60cd185c31e8730adfba1c4fa967dd09f2d63
+  data.tar.gz: 2c081af800735e4f6139e97d259cc4c5515806ee0b21dd55e9f84858c1fc2b390145c121aff17ff1c84cc593ee6f3a3847ded1975382ecb620213e338e997594

data/CHANGELOG.md

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

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
@@ -979,6 +1054,59 @@ module Google
         end
       end
       
+      # A bulk restore objects request.
+      class BulkRestoreObjectsRequest
+        include Google::Apis::Core::Hashable
+      
+        # If false (default), the restore will not overwrite live objects with the same
+        # name at the destination. This means some deleted objects may be skipped. If
+        # true, live objects will be overwritten resulting in a noncurrent object (if
+        # versioning is enabled). If versioning is not enabled, overwriting the object
+        # will result in a soft-deleted object. In either case, if a noncurrent object
+        # already exists with the same name, a live version can be written without issue.
+        # Corresponds to the JSON property `allowOverwrite`
+        # @return [Boolean]
+        attr_accessor :allow_overwrite
+        alias_method :allow_overwrite?, :allow_overwrite
+      
+        # If true, copies the source object's ACL; otherwise, uses the bucket's default
+        # object ACL. The default is false.
+        # Corresponds to the JSON property `copySourceAcl`
+        # @return [Boolean]
+        attr_accessor :copy_source_acl
+        alias_method :copy_source_acl?, :copy_source_acl
+      
+        # Restores only the objects matching any of the specified glob(s). If this
+        # parameter is not specified, all objects will be restored within the specified
+        # time range.
+        # Corresponds to the JSON property `matchGlobs`
+        # @return [Array<String>]
+        attr_accessor :match_globs
+      
+        # Restores only the objects that were soft-deleted after this time.
+        # Corresponds to the JSON property `softDeletedAfterTime`
+        # @return [DateTime]
+        attr_accessor :soft_deleted_after_time
+      
+        # Restores only the objects that were soft-deleted before this time.
+        # Corresponds to the JSON property `softDeletedBeforeTime`
+        # @return [DateTime]
+        attr_accessor :soft_deleted_before_time
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @allow_overwrite = args[:allow_overwrite] if args.key?(:allow_overwrite)
+          @copy_source_acl = args[:copy_source_acl] if args.key?(:copy_source_acl)
+          @match_globs = args[:match_globs] if args.key?(:match_globs)
+          @soft_deleted_after_time = args[:soft_deleted_after_time] if args.key?(:soft_deleted_after_time)
+          @soft_deleted_before_time = args[:soft_deleted_before_time] if args.key?(:soft_deleted_before_time)
+        end
+      end
+      
       # An notification channel used to watch for resource changes.
       class Channel
         include Google::Apis::Core::Hashable
@@ -1184,6 +1312,131 @@ module Google
         end
       end
       
+      # The response message for storage.buckets.operations.list.
+      class GoogleLongrunningListOperationsResponse
+        include Google::Apis::Core::Hashable
+      
+        # The continuation token, used to page through large result sets. Provide this
+        # value in a subsequent request to return the next page of results.
+        # Corresponds to the JSON property `nextPageToken`
+        # @return [String]
+        attr_accessor :next_page_token
+      
+        # A list of operations that matches the specified filter in the request.
+        # Corresponds to the JSON property `operations`
+        # @return [Array<Google::Apis::StorageV1::GoogleLongrunningOperation>]
+        attr_accessor :operations
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
+          @operations = args[:operations] if args.key?(:operations)
+        end
+      end
+      
+      # This resource represents a long-running operation that is the result of a
+      # network API call.
+      class GoogleLongrunningOperation
+        include Google::Apis::Core::Hashable
+      
+        # If the value is "false", it means the operation is still in progress. If "true"
+        # , the operation is completed, and either "error" or "response" is available.
+        # Corresponds to the JSON property `done`
+        # @return [Boolean]
+        attr_accessor :done
+        alias_method :done?, :done
+      
+        # The "Status" type defines a logical error model that is suitable for different
+        # programming environments, including REST APIs and RPC APIs. It is used by [
+        # gRPC](https://github.com/grpc). Each "Status" message contains three pieces of
+        # data: error code, error message, and error details. You can find out more
+        # about this error model and how to work with it in the [API Design Guide](https:
+        # //cloud.google.com/apis/design/errors).
+        # Corresponds to the JSON property `error`
+        # @return [Google::Apis::StorageV1::GoogleRpcStatus]
+        attr_accessor :error
+      
+        # Service-specific metadata associated with the operation. It typically contains
+        # progress information and common metadata such as create time. Some services
+        # might not provide such metadata. Any method that returns a long-running
+        # operation should document the metadata type, if any.
+        # Corresponds to the JSON property `metadata`
+        # @return [Hash<String,Object>]
+        attr_accessor :metadata
+      
+        # The server-assigned name, which is only unique within the same service that
+        # originally returns it. If you use the default HTTP mapping, the "name" should
+        # be a resource name ending with "operations/`operationId`".
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # The normal response of the operation in case of success. If the original
+        # method returns no data on success, such as "Delete", the response is google.
+        # protobuf.Empty. If the original method is standard Get/Create/Update, the
+        # response should be the resource. For other methods, the response should have
+        # the type "XxxResponse", where "Xxx" is the original method name. For example,
+        # if the original method name is "TakeSnapshot()", the inferred response type is
+        # "TakeSnapshotResponse".
+        # Corresponds to the JSON property `response`
+        # @return [Hash<String,Object>]
+        attr_accessor :response
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @done = args[:done] if args.key?(:done)
+          @error = args[:error] if args.key?(:error)
+          @metadata = args[:metadata] if args.key?(:metadata)
+          @name = args[:name] if args.key?(:name)
+          @response = args[:response] if args.key?(:response)
+        end
+      end
+      
+      # The "Status" type defines a logical error model that is suitable for different
+      # programming environments, including REST APIs and RPC APIs. It is used by [
+      # gRPC](https://github.com/grpc). Each "Status" message contains three pieces of
+      # data: error code, error message, and error details. You can find out more
+      # about this error model and how to work with it in the [API Design Guide](https:
+      # //cloud.google.com/apis/design/errors).
+      class GoogleRpcStatus
+        include Google::Apis::Core::Hashable
+      
+        # The status code, which should be an enum value of google.rpc.Code.
+        # Corresponds to the JSON property `code`
+        # @return [Fixnum]
+        attr_accessor :code
+      
+        # A list of messages that carry the error details. There is a common set of
+        # message types for APIs to use.
+        # Corresponds to the JSON property `details`
+        # @return [Array<Hash<String,Object>>]
+        attr_accessor :details
+      
+        # A developer-facing error message, which should be in English.
+        # Corresponds to the JSON property `message`
+        # @return [String]
+        attr_accessor :message
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @code = args[:code] if args.key?(:code)
+          @details = args[:details] if args.key?(:details)
+          @message = args[:message] if args.key?(:message)
+        end
+      end
+      
       # JSON template to produce a JSON-style HMAC Key resource for Create responses.
       class HmacKey
         include Google::Apis::Core::Hashable
@@ -1562,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
@@ -1652,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)
@@ -1713,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.24.0"
+      GEM_VERSION = "0.26.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 = "20230710"
+      REVISION = "20230914"
     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
         
@@ -154,6 +166,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class BulkRestoreObjectsRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Channel
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -184,6 +202,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class GoogleLongrunningListOperationsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleLongrunningOperation
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GoogleRpcStatus
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class HmacKey
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -228,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
@@ -318,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'
@@ -326,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
       
@@ -341,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
@@ -461,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
@@ -479,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
@@ -540,6 +605,19 @@ module Google
         end
       end
       
+      class BulkRestoreObjectsRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :allow_overwrite, as: 'allowOverwrite'
+          property :copy_source_acl, as: 'copySourceAcl'
+          collection :match_globs, as: 'matchGlobs'
+          property :soft_deleted_after_time, as: 'softDeletedAfterTime', type: DateTime
+      
+          property :soft_deleted_before_time, as: 'softDeletedBeforeTime', type: DateTime
+      
+        end
+      end
+      
       class Channel
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -594,6 +672,36 @@ module Google
         end
       end
       
+      class GoogleLongrunningListOperationsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :next_page_token, as: 'nextPageToken'
+          collection :operations, as: 'operations', class: Google::Apis::StorageV1::GoogleLongrunningOperation, decorator: Google::Apis::StorageV1::GoogleLongrunningOperation::Representation
+      
+        end
+      end
+      
+      class GoogleLongrunningOperation
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :done, as: 'done'
+          property :error, as: 'error', class: Google::Apis::StorageV1::GoogleRpcStatus, decorator: Google::Apis::StorageV1::GoogleRpcStatus::Representation
+      
+          hash :metadata, as: 'metadata'
+          property :name, as: 'name'
+          hash :response, as: 'response'
+        end
+      end
+      
+      class GoogleRpcStatus
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :code, as: 'code'
+          collection :details, as: 'details'
+          property :message, as: 'message'
+        end
+      end
+      
       class HmacKey
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -686,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'
@@ -717,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?
@@ -1479,6 +1482,42 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Initiates a long-running bulk restore operation on the specified bucket.
+        # @param [String] bucket
+        #   Name of the bucket in which the object resides.
+        # @param [Google::Apis::StorageV1::BulkRestoreObjectsRequest] bulk_restore_objects_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::StorageV1::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StorageV1::GoogleLongrunningOperation]
+        #
+        # @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 bulk_restore_objects(bucket, bulk_restore_objects_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, 'b/{bucket}/o/bulkRestore', options)
+          command.request_representation = Google::Apis::StorageV1::BulkRestoreObjectsRequest::Representation
+          command.request_object = bulk_restore_objects_request_object
+          command.response_representation = Google::Apis::StorageV1::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::StorageV1::GoogleLongrunningOperation
+          command.params['bucket'] = bucket unless bucket.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Concatenates a list of existing objects into a new object in the same bucket.
         # @param [String] destination_bucket
         #   Name of the bucket containing the source objects. The destination object is
@@ -1736,6 +1775,9 @@ module Google
         #   does not match the given value.
         # @param [String] projection
         #   Set of properties to return. Defaults to noAcl.
+        # @param [Boolean] soft_deleted
+        #   If true, only soft-deleted object versions will be listed. The default is
+        #   false. For more information, see Soft Delete.
         # @param [String] user_project
         #   The project to be billed for this request. Required for Requester Pays buckets.
         # @param [String] fields
@@ -1759,7 +1801,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 get_object(bucket, object, generation: 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, download_dest: nil, options: nil, &block)
+        def get_object(bucket, object, generation: nil, if_generation_match: nil, if_generation_not_match: nil, if_metageneration_match: nil, if_metageneration_not_match: nil, projection: nil, soft_deleted: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, download_dest: nil, options: nil, &block)
         
           if download_dest.nil?
             command = make_simple_command(:get, 'b/{bucket}/o/{object}', options)
@@ -1777,6 +1819,7 @@ module Google
           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['projection'] = projection unless projection.nil?
+          command.query['softDeleted'] = soft_deleted unless soft_deleted.nil?
           command.query['userProject'] = user_project unless user_project.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -1953,6 +1996,9 @@ module Google
         #   Filter results to objects whose names begin with this prefix.
         # @param [String] projection
         #   Set of properties to return. Defaults to noAcl.
+        # @param [Boolean] soft_deleted
+        #   If true, only soft-deleted object versions will be listed. The default is
+        #   false. For more information, see Soft Delete.
         # @param [String] start_offset
         #   Filter results to objects whose names are lexicographically equal to or after
         #   startOffset. If endOffset is also set, the objects listed will have names
@@ -1981,7 +2027,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 list_objects(bucket, delimiter: nil, end_offset: nil, include_trailing_delimiter: nil, match_glob: nil, max_results: nil, page_token: nil, prefix: nil, projection: nil, start_offset: nil, user_project: nil, versions: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_objects(bucket, delimiter: nil, end_offset: nil, include_trailing_delimiter: nil, match_glob: nil, max_results: nil, page_token: nil, prefix: nil, projection: nil, soft_deleted: nil, start_offset: nil, user_project: nil, versions: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:get, 'b/{bucket}/o', options)
           command.response_representation = Google::Apis::StorageV1::Objects::Representation
           command.response_class = Google::Apis::StorageV1::Objects
@@ -1994,6 +2040,7 @@ module Google
           command.query['pageToken'] = page_token unless page_token.nil?
           command.query['prefix'] = prefix unless prefix.nil?
           command.query['projection'] = projection unless projection.nil?
+          command.query['softDeleted'] = soft_deleted unless soft_deleted.nil?
           command.query['startOffset'] = start_offset unless start_offset.nil?
           command.query['userProject'] = user_project unless user_project.nil?
           command.query['versions'] = versions unless versions.nil?
@@ -2029,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
@@ -2054,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
@@ -2067,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?
@@ -2076,6 +2127,72 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Restores a soft-deleted object.
+        # @param [String] bucket
+        #   Name of the bucket in which the object resides.
+        # @param [String] object
+        #   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 [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
+        #   there are no live versions of the object.
+        # @param [Fixnum] if_generation_not_match
+        #   Makes the operation conditional on whether none of the object's live
+        #   generations match the given value. If no live object exists, the precondition
+        #   fails. Setting to 0 makes the operation succeed only if there is a live
+        #   version of the object.
+        # @param [Fixnum] if_metageneration_match
+        #   Makes the operation conditional on whether the object's one live
+        #   metageneration matches the given value.
+        # @param [Fixnum] if_metageneration_not_match
+        #   Makes the operation conditional on whether none of the object's live
+        #   metagenerations match the given value.
+        # @param [String] projection
+        #   Set of properties to return. Defaults to full.
+        # @param [String] user_project
+        #   The project to be billed for this request. Required for Requester Pays buckets.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::StorageV1::Object] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StorageV1::Object]
+        #
+        # @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)
+          command = make_simple_command(:post, 'b/{bucket}/o/{object}/restore', options)
+          command.request_representation = Google::Apis::StorageV1::Object::Representation
+          command.request_object = object_object
+          command.response_representation = Google::Apis::StorageV1::Object::Representation
+          command.response_class = Google::Apis::StorageV1::Object
+          command.params['bucket'] = bucket unless bucket.nil?
+          command.params['object'] = object unless object.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?
+          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['projection'] = projection unless projection.nil?
+          command.query['userProject'] = user_project unless user_project.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Rewrites a source object to a destination object. Optionally overrides
         # metadata.
         # @param [String] source_bucket
@@ -2320,6 +2437,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
@@ -2345,7 +2465,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
@@ -2358,6 +2478,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?
@@ -2447,6 +2568,123 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Starts asynchronous cancellation on a long-running operation. The server makes
+        # a best effort to cancel the operation, but success is not guaranteed.
+        # @param [String] bucket
+        #   The parent bucket of the operation resource.
+        # @param [String] operation_id
+        #   The ID of the operation resource.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [NilClass] No result returned for this method
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [void]
+        #
+        # @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 cancel_bucket_operation(bucket, operation_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, 'b/{bucket}/operations/{operationId}/cancel', options)
+          command.params['bucket'] = bucket unless bucket.nil?
+          command.params['operationId'] = operation_id unless operation_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the latest state of a long-running operation.
+        # @param [String] bucket
+        #   The parent bucket of the operation resource.
+        # @param [String] operation_id
+        #   The ID of the operation resource.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::StorageV1::GoogleLongrunningOperation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StorageV1::GoogleLongrunningOperation]
+        #
+        # @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 get_bucket_operation(bucket, operation_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:get, 'b/{bucket}/operations/{operationId}', options)
+          command.response_representation = Google::Apis::StorageV1::GoogleLongrunningOperation::Representation
+          command.response_class = Google::Apis::StorageV1::GoogleLongrunningOperation
+          command.params['bucket'] = bucket unless bucket.nil?
+          command.params['operationId'] = operation_id unless operation_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Lists operations that match the specified filter in the request.
+        # @param [String] bucket
+        #   Name of the bucket in which to look for operations.
+        # @param [String] filter
+        #   A filter to narrow down results to a preferred subset. The filtering language
+        #   is documented in more detail in [AIP-160](https://google.aip.dev/160).
+        # @param [Fixnum] page_size
+        #   Maximum number of items to return in a single page of responses. Fewer total
+        #   results may be returned than requested. The service uses this parameter or 100
+        #   items, whichever is smaller.
+        # @param [String] page_token
+        #   A previously-returned page token representing part of the larger set of
+        #   results to view.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   An opaque string that represents a user for quota purposes. Must not exceed 40
+        #   characters.
+        # @param [String] user_ip
+        #   Deprecated. Please use quotaUser instead.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::StorageV1::GoogleLongrunningListOperationsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StorageV1::GoogleLongrunningListOperationsResponse]
+        #
+        # @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 list_bucket_operations(bucket, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:get, 'b/{bucket}/operations', options)
+          command.response_representation = Google::Apis::StorageV1::GoogleLongrunningListOperationsResponse::Representation
+          command.response_class = Google::Apis::StorageV1::GoogleLongrunningListOperationsResponse
+          command.params['bucket'] = bucket unless bucket.nil?
+          command.query['filter'] = filter unless filter.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Creates a new HMAC key for the specified service account.
         # @param [String] project_id
         #   Project ID owning the service account.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-storage_v1
 version: !ruby/object:Gem::Version
-  version: 0.24.0
+  version: 0.26.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-16 00:00:00.000000000 Z
+date: 2023-09-17 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.24.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-storage_v1/v0.26.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-storage_v1
 post_install_message: 
 rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Storage JSON API V1