google-apis-storage_v1 0.44.0 → 0.46.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: db2c5b0c0f27e2492f68f0d6b567f9e0f9836fff031d7ca4f36ae3cd43baad0c
-  data.tar.gz: 07b9c9f3590d43a55247ddbc43a6464189f3ed69545b318f1c3a5d71f947dec1
+  metadata.gz: 1157b77e0344db0a3c7d1bbaf09130e72f20e68a62890bc84cca07ddfb07aa88
+  data.tar.gz: 610fb3cd0d5c8b7b9fed4f3ff9ef2c3e008480cffc5469c5164cb781403bb2ec
 SHA512:
-  metadata.gz: cf6db1090e0a02d8a7ab7a8b7019bc943ea50a74448542bb2fc32607fd39687e19ab92315230398d83c8538349bc3fd079022a35d55b0f04567ee8a8f01ca8d0
-  data.tar.gz: 81c92691c9a908b1776916ada6e42c8d39473ee5bd74718ca51f5409185acd510255c8f5b8cbccd0ebb063cb605797f120c4149a04cae0e27d2f2f891a7d22ca
+  metadata.gz: cb8b236a908a129179f847901c3ea9b829d2c44a1831e1fdf08b5c306b4aed8cc9fa99098dcd304ed944d82c1c4fe5f0d30db931cf6488c40133a63d8b5491a5
+  data.tar.gz: a08bdd88746ff2260d91fd6dbe458b80e61bd547fe801c0420fb4bc606c91c143d4165ebed7b7270d69f0f90db8e20b13930e7a9294ce794359ea51150f6de61

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-storage_v1
 
+### v0.46.0 (2024-09-29)
+
+* Regenerated from discovery document revision 20240924
+
+### v0.45.0 (2024-09-22)
+
+* Regenerated from discovery document revision 20240916
+
 ### v0.44.0 (2024-08-25)
 
 * Regenerated from discovery document revision 20240819

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

@@ -2412,6 +2412,13 @@ module Google
         # @return [Google::Apis::StorageV1::Object::Owner]
         attr_accessor :owner
       
+        # Restore token used to differentiate deleted objects with the same name and
+        # generation. This field is only returned for deleted objects in hierarchical
+        # namespace buckets.
+        # Corresponds to the JSON property `restoreToken`
+        # @return [String]
+        attr_accessor :restore_token
+      
         # A collection of object level retention parameters.
         # Corresponds to the JSON property `retention`
         # @return [Google::Apis::StorageV1::Object::Retention]
@@ -2513,6 +2520,7 @@ module Google
           @metageneration = args[:metageneration] if args.key?(:metageneration)
           @name = args[:name] if args.key?(:name)
           @owner = args[:owner] if args.key?(:owner)
+          @restore_token = args[:restore_token] if args.key?(:restore_token)
           @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)
@@ -2923,6 +2931,59 @@ module Google
         end
       end
       
+      # A Relocate Bucket request.
+      class RelocateBucketRequest
+        include Google::Apis::Core::Hashable
+      
+        # The bucket's new custom placement configuration if relocating to a Custom Dual
+        # Region.
+        # Corresponds to the JSON property `destinationCustomPlacementConfig`
+        # @return [Google::Apis::StorageV1::RelocateBucketRequest::DestinationCustomPlacementConfig]
+        attr_accessor :destination_custom_placement_config
+      
+        # The new location the bucket will be relocated to.
+        # Corresponds to the JSON property `destinationLocation`
+        # @return [String]
+        attr_accessor :destination_location
+      
+        # If true, validate the operation, but do not actually relocate the bucket.
+        # Corresponds to the JSON property `validateOnly`
+        # @return [Boolean]
+        attr_accessor :validate_only
+        alias_method :validate_only?, :validate_only
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @destination_custom_placement_config = args[:destination_custom_placement_config] if args.key?(:destination_custom_placement_config)
+          @destination_location = args[:destination_location] if args.key?(:destination_location)
+          @validate_only = args[:validate_only] if args.key?(:validate_only)
+        end
+        
+        # The bucket's new custom placement configuration if relocating to a Custom Dual
+        # Region.
+        class DestinationCustomPlacementConfig
+          include Google::Apis::Core::Hashable
+        
+          # The list of regional locations in which data is placed.
+          # Corresponds to the JSON property `dataLocations`
+          # @return [Array<String>]
+          attr_accessor :data_locations
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @data_locations = args[:data_locations] if args.key?(:data_locations)
+          end
+        end
+      end
+      
       # A rewrite response.
       class RewriteResponse
         include Google::Apis::Core::Hashable

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.44.0"
+      GEM_VERSION = "0.46.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.15.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240819"
+      REVISION = "20240924"
     end
   end
 end

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

@@ -394,6 +394,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RelocateBucketRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+        class DestinationCustomPlacementConfig
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+        
+          include Google::Apis::Core::JsonObjectSupport
+        end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RewriteResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1045,6 +1057,7 @@ module Google
           property :name, as: 'name'
           property :owner, as: 'owner', class: Google::Apis::StorageV1::Object::Owner, decorator: Google::Apis::StorageV1::Object::Owner::Representation
       
+          property :restore_token, as: 'restoreToken'
           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
@@ -1161,6 +1174,23 @@ module Google
         end
       end
       
+      class RelocateBucketRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :destination_custom_placement_config, as: 'destinationCustomPlacementConfig', class: Google::Apis::StorageV1::RelocateBucketRequest::DestinationCustomPlacementConfig, decorator: Google::Apis::StorageV1::RelocateBucketRequest::DestinationCustomPlacementConfig::Representation
+      
+          property :destination_location, as: 'destinationLocation'
+          property :validate_only, as: 'validateOnly'
+        end
+        
+        class DestinationCustomPlacementConfig
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            collection :data_locations, as: 'dataLocations'
+          end
+        end
+      end
+      
       class RewriteResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -935,6 +935,42 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Initiates a long-running Relocate Bucket operation on the specified bucket.
+        # @param [String] bucket
+        #   Name of the bucket to be moved.
+        # @param [Google::Apis::StorageV1::RelocateBucketRequest] relocate_bucket_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 relocate_bucket(bucket, relocate_bucket_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, 'b/{bucket}/relocate', options)
+          command.request_representation = Google::Apis::StorageV1::RelocateBucketRequest::Representation
+          command.request_object = relocate_bucket_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
+        
         # Restores a soft-deleted bucket.
         # @param [String] bucket
         #   Name of a bucket.
@@ -2660,6 +2696,12 @@ module Google
         #   does not match the given value.
         # @param [String] projection
         #   Set of properties to return. Defaults to noAcl.
+        # @param [String] restore_token
+        #   Restore token used to differentiate soft-deleted objects with the same name
+        #   and generation. Only applicable for hierarchical namespace buckets and if
+        #   softDeleted is set to true. This parameter is optional, and is only required
+        #   in the rare case when there are multiple soft-deleted objects with the same
+        #   name and generation.
         # @param [Boolean] soft_deleted
         #   If true, only soft-deleted object versions will be listed. The default is
         #   false. For more information, see [Soft Delete](https://cloud.google.com/
@@ -2687,7 +2729,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, soft_deleted: 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, restore_token: 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)
@@ -2705,6 +2747,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['restoreToken'] = restore_token unless restore_token.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?
@@ -3048,6 +3091,11 @@ module Google
         #   metagenerations match the given value.
         # @param [String] projection
         #   Set of properties to return. Defaults to full.
+        # @param [String] restore_token
+        #   Restore token used to differentiate sof-deleted objects with the same name and
+        #   generation. Only applicable for hierarchical namespace buckets. This parameter
+        #   is optional, and is only required in the rare case when there are multiple
+        #   soft-deleted objects with the same name and generation.
         # @param [String] user_project
         #   The project to be billed for this request. Required for Requester Pays buckets.
         # @param [String] fields
@@ -3069,7 +3117,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, generation, 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)
+        def restore_object(bucket, object, generation, copy_source_acl: nil, if_generation_match: nil, if_generation_not_match: nil, if_metageneration_match: nil, if_metageneration_not_match: nil, projection: nil, restore_token: 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.response_representation = Google::Apis::StorageV1::Object::Representation
           command.response_class = Google::Apis::StorageV1::Object
@@ -3082,6 +3130,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['restoreToken'] = restore_token unless restore_token.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?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-storage_v1
 version: !ruby/object:Gem::Version
-  version: 0.44.0
+  version: 0.46.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-08-25 00:00:00.000000000 Z
+date: 2024-09-29 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.44.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-storage_v1/v0.46.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-storage_v1
 post_install_message: 
 rdoc_options: []