google-apis-storage_v1 0.40.0 → 0.47.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc2817e120ad16d60743c2a442925e8a855dab1ad241d7cb9e44fdf4f71e1582
-  data.tar.gz: 8baf01d69125bf894fb49416a916a62e73a55cfe79ff58fecc32c065756fe8ff
+  metadata.gz: ef8b5adcdb3729a4eb973fca4db7833a049cf192d1143b51c65a8fa9052fa15e
+  data.tar.gz: 4bceace55bc99a4dce993779048757d5092e5b56f04230519a95b8fabe35d53f
 SHA512:
-  metadata.gz: 44a5a33c4d0d48747f2a68ab884764d5ccf7fe8f64eae86b1c301f4e5d088cc4888a58405e0d922200eb83978f8e39b60e268880401da42b4bac69ee824c212b
-  data.tar.gz: 8dc887aef896142eab243f127b9874e634ecbae9537e359bf2a60e029c510797f29f07f188269b3a4859549ffc150f9e1fe7d39fb7b0fd9c6d15e6a7aaba3243
+  metadata.gz: '08ca145fa5900879fc2c04c59228785e90132215b7255c08e1c4fe10898afb7d34390e3d80814baa1040ddc11e7d46ad1d94e7bda508d1810e4cc8a370a4400e'
+  data.tar.gz: e913f80e5dd886a4abf5637c9c7c0d51bf075471c5ec070c3d0c0a41a2e56a1f7b11382100d8439980590664ea94e0d5a3f4da3c470a0e902dd234a6e3349053

data/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Release history for google-apis-storage_v1
 
+### v0.47.0 (2024-10-13)
+
+* Regenerated from discovery document revision 20241008
+
+### 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
+
+### v0.43.0 (2024-08-18)
+
+* Regenerated from discovery document revision 20240809
+
+### v0.42.0 (2024-08-11)
+
+* Regenerated from discovery document revision 20240805
+* Regenerated using generator version 0.15.1
+
+### v0.41.0 (2024-07-25)
+
+* Regenerated from discovery document revision 20240706
+
 ### v0.40.0 (2024-06-26)
 
 * Regenerated from discovery document revision 20240621

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

@@ -22,6 +22,34 @@ module Google
   module Apis
     module StorageV1
       
+      # An AdvanceRelocateBucketOperation request.
+      class AdvanceRelocateBucketOperationRequest
+        include Google::Apis::Core::Hashable
+      
+        # Specifies the time when the relocation will revert to the sync stage if the
+        # relocation hasn't succeeded.
+        # Corresponds to the JSON property `expireTime`
+        # @return [DateTime]
+        attr_accessor :expire_time
+      
+        # Specifies the duration after which the relocation will revert to the sync
+        # stage if the relocation hasn't succeeded. Optional, if not supplied, a default
+        # value of 12h will be used.
+        # Corresponds to the JSON property `ttl`
+        # @return [String]
+        attr_accessor :ttl
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @expire_time = args[:expire_time] if args.key?(:expire_time)
+          @ttl = args[:ttl] if args.key?(:ttl)
+        end
+      end
+      
       # An Anywhere Cache instance.
       class AnywhereCache
         include Google::Apis::Core::Hashable
@@ -204,6 +232,16 @@ module Google
         # @return [String]
         attr_accessor :etag
       
+        # The generation of this bucket.
+        # Corresponds to the JSON property `generation`
+        # @return [Fixnum]
+        attr_accessor :generation
+      
+        # The hard delete time of the bucket in RFC 3339 format.
+        # Corresponds to the JSON property `hardDeleteTime`
+        # @return [DateTime]
+        attr_accessor :hard_delete_time
+      
         # The bucket's hierarchical namespace configuration.
         # Corresponds to the JSON property `hierarchicalNamespace`
         # @return [Google::Apis::StorageV1::Bucket::HierarchicalNamespace]
@@ -219,6 +257,13 @@ module Google
         # @return [String]
         attr_accessor :id
       
+        # The bucket's IP filter configuration. Specifies the network sources that are
+        # allowed to access the operations on the bucket, as well as its underlying
+        # objects. Only enforced when the mode is set to 'Enabled'.
+        # Corresponds to the JSON property `ipFilter`
+        # @return [Google::Apis::StorageV1::Bucket::IpFilter]
+        attr_accessor :ip_filter
+      
         # The kind of item this is. For buckets, this is always storage#bucket.
         # Corresponds to the JSON property `kind`
         # @return [String]
@@ -229,15 +274,16 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # The bucket's lifecycle configuration. See lifecycle management for more
-        # information.
+        # The bucket's lifecycle configuration. See [Lifecycle Management](https://cloud.
+        # google.com/storage/docs/lifecycle) for more information.
         # Corresponds to the JSON property `lifecycle`
         # @return [Google::Apis::StorageV1::Bucket::Lifecycle]
         attr_accessor :lifecycle
       
         # The location of the bucket. Object data for objects in the bucket resides in
-        # physical storage within this region. Defaults to US. See the developer's guide
-        # for the authoritative list.
+        # physical storage within this region. Defaults to US. See the [Developer's
+        # Guide](https://cloud.google.com/storage/docs/locations) for the authoritative
+        # list.
         # Corresponds to the JSON property `location`
         # @return [String]
         attr_accessor :location
@@ -297,6 +343,12 @@ module Google
         # @return [String]
         attr_accessor :rpo
       
+        # Reserved for future use.
+        # Corresponds to the JSON property `satisfiesPZI`
+        # @return [Boolean]
+        attr_accessor :satisfies_pzi
+        alias_method :satisfies_pzi?, :satisfies_pzi
+      
         # Reserved for future use.
         # Corresponds to the JSON property `satisfiesPZS`
         # @return [Boolean]
@@ -314,13 +366,18 @@ module Google
         # @return [Google::Apis::StorageV1::Bucket::SoftDeletePolicy]
         attr_accessor :soft_delete_policy
       
+        # The soft delete time of the bucket in RFC 3339 format.
+        # Corresponds to the JSON property `softDeleteTime`
+        # @return [DateTime]
+        attr_accessor :soft_delete_time
+      
         # 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,
         # REGIONAL, STANDARD, NEARLINE, COLDLINE, ARCHIVE, and
         # DURABLE_REDUCED_AVAILABILITY. If this value is not specified when the bucket
-        # is created, it will default to STANDARD. For more information, see storage
-        # classes.
+        # is created, it will default to STANDARD. For more information, see [Storage
+        # Classes](https://cloud.google.com/storage/docs/storage-classes).
         # Corresponds to the JSON property `storageClass`
         # @return [String]
         attr_accessor :storage_class
@@ -341,8 +398,8 @@ module Google
         attr_accessor :versioning
       
         # The bucket's website configuration, controlling how the service behaves when
-        # accessing bucket contents as a web site. See the Static Website Examples for
-        # more information.
+        # accessing bucket contents as a web site. See the [Static Website Examples](
+        # https://cloud.google.com/storage/docs/static-website) for more information.
         # Corresponds to the JSON property `website`
         # @return [Google::Apis::StorageV1::Bucket::Website]
         attr_accessor :website
@@ -362,9 +419,12 @@ module Google
           @default_object_acl = args[:default_object_acl] if args.key?(:default_object_acl)
           @encryption = args[:encryption] if args.key?(:encryption)
           @etag = args[:etag] if args.key?(:etag)
+          @generation = args[:generation] if args.key?(:generation)
+          @hard_delete_time = args[:hard_delete_time] if args.key?(:hard_delete_time)
           @hierarchical_namespace = args[:hierarchical_namespace] if args.key?(:hierarchical_namespace)
           @iam_configuration = args[:iam_configuration] if args.key?(:iam_configuration)
           @id = args[:id] if args.key?(:id)
+          @ip_filter = args[:ip_filter] if args.key?(:ip_filter)
           @kind = args[:kind] if args.key?(:kind)
           @labels = args[:labels] if args.key?(:labels)
           @lifecycle = args[:lifecycle] if args.key?(:lifecycle)
@@ -378,9 +438,11 @@ module Google
           @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_pzi = args[:satisfies_pzi] if args.key?(:satisfies_pzi)
           @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)
+          @soft_delete_time = args[:soft_delete_time] if args.key?(:soft_delete_time)
           @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)
@@ -649,8 +711,89 @@ module Google
           end
         end
         
-        # The bucket's lifecycle configuration. See lifecycle management for more
-        # information.
+        # The bucket's IP filter configuration. Specifies the network sources that are
+        # allowed to access the operations on the bucket, as well as its underlying
+        # objects. Only enforced when the mode is set to 'Enabled'.
+        class IpFilter
+          include Google::Apis::Core::Hashable
+        
+          # The mode of the IP filter. Valid values are 'Enabled' and 'Disabled'.
+          # Corresponds to the JSON property `mode`
+          # @return [String]
+          attr_accessor :mode
+        
+          # The public network source of the bucket's IP filter.
+          # Corresponds to the JSON property `publicNetworkSource`
+          # @return [Google::Apis::StorageV1::Bucket::IpFilter::PublicNetworkSource]
+          attr_accessor :public_network_source
+        
+          # The list of [VPC network](https://cloud.google.com/vpc/docs/vpc) sources of
+          # the bucket's IP filter.
+          # Corresponds to the JSON property `vpcNetworkSources`
+          # @return [Array<Google::Apis::StorageV1::Bucket::IpFilter::VpcNetworkSource>]
+          attr_accessor :vpc_network_sources
+        
+          def initialize(**args)
+             update!(**args)
+          end
+        
+          # Update properties of this object
+          def update!(**args)
+            @mode = args[:mode] if args.key?(:mode)
+            @public_network_source = args[:public_network_source] if args.key?(:public_network_source)
+            @vpc_network_sources = args[:vpc_network_sources] if args.key?(:vpc_network_sources)
+          end
+          
+          # The public network source of the bucket's IP filter.
+          class PublicNetworkSource
+            include Google::Apis::Core::Hashable
+          
+            # The list of public IPv4, IPv6 cidr ranges that are allowed to access the
+            # bucket.
+            # Corresponds to the JSON property `allowedIpCidrRanges`
+            # @return [Array<String>]
+            attr_accessor :allowed_ip_cidr_ranges
+          
+            def initialize(**args)
+               update!(**args)
+            end
+          
+            # Update properties of this object
+            def update!(**args)
+              @allowed_ip_cidr_ranges = args[:allowed_ip_cidr_ranges] if args.key?(:allowed_ip_cidr_ranges)
+            end
+          end
+          
+          # 
+          class VpcNetworkSource
+            include Google::Apis::Core::Hashable
+          
+            # The list of IPv4, IPv6 cidr ranges subnetworks that are allowed to access the
+            # bucket.
+            # Corresponds to the JSON property `allowedIpCidrRanges`
+            # @return [Array<String>]
+            attr_accessor :allowed_ip_cidr_ranges
+          
+            # Name of the network. Format: projects/`PROJECT_ID`/global/networks/`
+            # NETWORK_NAME`
+            # Corresponds to the JSON property `network`
+            # @return [String]
+            attr_accessor :network
+          
+            def initialize(**args)
+               update!(**args)
+            end
+          
+            # Update properties of this object
+            def update!(**args)
+              @allowed_ip_cidr_ranges = args[:allowed_ip_cidr_ranges] if args.key?(:allowed_ip_cidr_ranges)
+              @network = args[:network] if args.key?(:network)
+            end
+          end
+        end
+        
+        # The bucket's lifecycle configuration. See [Lifecycle Management](https://cloud.
+        # google.com/storage/docs/lifecycle) for more information.
         class Lifecycle
           include Google::Apis::Core::Hashable
         
@@ -994,8 +1137,8 @@ module Google
         end
         
         # The bucket's website configuration, controlling how the service behaves when
-        # accessing bucket contents as a web site. See the Static Website Examples for
-        # more information.
+        # accessing bucket contents as a web site. See the [Static Website Examples](
+        # https://cloud.google.com/storage/docs/static-website) for more information.
         class Website
           include Google::Apis::Core::Hashable
         
@@ -2195,7 +2338,8 @@ module Google
       
         # CRC32c checksum, as described in RFC 4960, Appendix B; encoded using base64 in
         # big-endian byte order. For more information about using the CRC32c checksum,
-        # see Hashes and ETags: Best Practices.
+        # see [Data Validation and Change Detection](https://cloud.google.com/storage/
+        # docs/data-validation).
         # Corresponds to the JSON property `crc32c`
         # @return [String]
         attr_accessor :crc32c
@@ -2262,7 +2406,8 @@ module Google
         attr_accessor :kms_key_name
       
         # MD5 hash of the data; encoded using base64. For more information about using
-        # the MD5 hash, see Hashes and ETags: Best Practices.
+        # the MD5 hash, see [Data Validation and Change Detection](https://cloud.google.
+        # com/storage/docs/data-validation).
         # Corresponds to the JSON property `md5Hash`
         # @return [String]
         attr_accessor :md5_hash
@@ -2295,6 +2440,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]
@@ -2396,6 +2548,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)
@@ -2806,6 +2959,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.40.0"
+      GEM_VERSION = "0.47.0"
 
       # Version of the code generator used to generate this client
-      GENERATOR_VERSION = "0.15.0"
+      GENERATOR_VERSION = "0.15.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240621"
+      REVISION = "20241008"
     end
   end
 end

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

@@ -22,6 +22,12 @@ module Google
   module Apis
     module StorageV1
       
+      class AdvanceRelocateBucketOperationRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AnywhereCache
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -91,6 +97,24 @@ module Google
           include Google::Apis::Core::JsonObjectSupport
         end
         
+        class IpFilter
+          class Representation < Google::Apis::Core::JsonRepresentation; end
+          
+          class PublicNetworkSource
+            class Representation < Google::Apis::Core::JsonRepresentation; end
+          
+            include Google::Apis::Core::JsonObjectSupport
+          end
+          
+          class VpcNetworkSource
+            class Representation < Google::Apis::Core::JsonRepresentation; end
+          
+            include Google::Apis::Core::JsonObjectSupport
+          end
+        
+          include Google::Apis::Core::JsonObjectSupport
+        end
+        
         class Lifecycle
           class Representation < Google::Apis::Core::JsonRepresentation; end
           
@@ -376,6 +400,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
       
@@ -394,6 +430,15 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AdvanceRelocateBucketOperationRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :expire_time, as: 'expireTime', type: DateTime
+      
+          property :ttl, as: 'ttl'
+        end
+      end
+      
       class AnywhereCache
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -443,11 +488,16 @@ module Google
           property :encryption, as: 'encryption', class: Google::Apis::StorageV1::Bucket::Encryption, decorator: Google::Apis::StorageV1::Bucket::Encryption::Representation
       
           property :etag, as: 'etag'
+          property :generation, :numeric_string => true, as: 'generation'
+          property :hard_delete_time, as: 'hardDeleteTime', type: DateTime
+      
           property :hierarchical_namespace, as: 'hierarchicalNamespace', class: Google::Apis::StorageV1::Bucket::HierarchicalNamespace, decorator: Google::Apis::StorageV1::Bucket::HierarchicalNamespace::Representation
       
           property :iam_configuration, as: 'iamConfiguration', class: Google::Apis::StorageV1::Bucket::IamConfiguration, decorator: Google::Apis::StorageV1::Bucket::IamConfiguration::Representation
       
           property :id, as: 'id'
+          property :ip_filter, as: 'ipFilter', class: Google::Apis::StorageV1::Bucket::IpFilter, decorator: Google::Apis::StorageV1::Bucket::IpFilter::Representation
+      
           property :kind, as: 'kind'
           hash :labels, as: 'labels'
           property :lifecycle, as: 'lifecycle', class: Google::Apis::StorageV1::Bucket::Lifecycle, decorator: Google::Apis::StorageV1::Bucket::Lifecycle::Representation
@@ -466,10 +516,13 @@ module Google
           property :retention_policy, as: 'retentionPolicy', class: Google::Apis::StorageV1::Bucket::RetentionPolicy, decorator: Google::Apis::StorageV1::Bucket::RetentionPolicy::Representation
       
           property :rpo, as: 'rpo'
+          property :satisfies_pzi, as: 'satisfiesPZI'
           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 :soft_delete_time, as: 'softDeleteTime', type: DateTime
+      
           property :storage_class, as: 'storageClass'
           property :time_created, as: 'timeCreated', type: DateTime
       
@@ -560,6 +613,32 @@ module Google
           end
         end
         
+        class IpFilter
+          # @private
+          class Representation < Google::Apis::Core::JsonRepresentation
+            property :mode, as: 'mode'
+            property :public_network_source, as: 'publicNetworkSource', class: Google::Apis::StorageV1::Bucket::IpFilter::PublicNetworkSource, decorator: Google::Apis::StorageV1::Bucket::IpFilter::PublicNetworkSource::Representation
+        
+            collection :vpc_network_sources, as: 'vpcNetworkSources', class: Google::Apis::StorageV1::Bucket::IpFilter::VpcNetworkSource, decorator: Google::Apis::StorageV1::Bucket::IpFilter::VpcNetworkSource::Representation
+        
+          end
+          
+          class PublicNetworkSource
+            # @private
+            class Representation < Google::Apis::Core::JsonRepresentation
+              collection :allowed_ip_cidr_ranges, as: 'allowedIpCidrRanges'
+            end
+          end
+          
+          class VpcNetworkSource
+            # @private
+            class Representation < Google::Apis::Core::JsonRepresentation
+              collection :allowed_ip_cidr_ranges, as: 'allowedIpCidrRanges'
+              property :network, as: 'network'
+            end
+          end
+        end
+        
         class Lifecycle
           # @private
           class Representation < Google::Apis::Core::JsonRepresentation
@@ -993,6 +1072,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
@@ -1109,6 +1189,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

@@ -554,7 +554,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Permanently deletes an empty bucket.
+        # Deletes an empty bucket. Deletions are permanent unless soft delete is enabled
+        # on the bucket.
         # @param [String] bucket
         #   Name of a bucket.
         # @param [Fixnum] if_metageneration_match
@@ -598,6 +599,9 @@ module Google
         # Returns metadata for the specified bucket.
         # @param [String] bucket
         #   Name of a bucket.
+        # @param [Fixnum] generation
+        #   If present, specifies the generation of the bucket. This is required if
+        #   softDeleted is true.
         # @param [Fixnum] if_metageneration_match
         #   Makes the return of the bucket metadata conditional on whether the bucket's
         #   current metageneration matches the given value.
@@ -606,6 +610,10 @@ module Google
         #   current metageneration does not match the given value.
         # @param [String] projection
         #   Set of properties to return. Defaults to noAcl.
+        # @param [Boolean] soft_deleted
+        #   If true, return the soft-deleted version of this bucket. The default is false.
+        #   For more information, see [Soft Delete](https://cloud.google.com/storage/docs/
+        #   soft-delete).
         # @param [String] user_project
         #   The project to be billed for this request. Required for Requester Pays buckets.
         # @param [String] fields
@@ -627,14 +635,16 @@ 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_bucket(bucket, 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 get_bucket(bucket, generation: 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, options: nil, &block)
           command = make_simple_command(:get, 'b/{bucket}', options)
           command.response_representation = Google::Apis::StorageV1::Bucket::Representation
           command.response_class = Google::Apis::StorageV1::Bucket
           command.params['bucket'] = bucket unless bucket.nil?
+          command.query['generation'] = generation unless generation.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['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?
@@ -786,6 +796,10 @@ module Google
         #   Filter results to buckets 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 bucket versions will be returned. The default is
+        #   false. For more information, see [Soft Delete](https://cloud.google.com/
+        #   storage/docs/soft-delete).
         # @param [String] user_project
         #   The project to be billed for this request.
         # @param [String] fields
@@ -807,7 +821,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_buckets(project, max_results: nil, page_token: nil, prefix: nil, projection: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_buckets(project, max_results: nil, page_token: nil, prefix: nil, projection: nil, soft_deleted: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:get, 'b', options)
           command.response_representation = Google::Apis::StorageV1::Buckets::Representation
           command.response_class = Google::Apis::StorageV1::Buckets
@@ -816,6 +830,7 @@ module Google
           command.query['prefix'] = prefix unless prefix.nil?
           command.query['project'] = project unless project.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?
@@ -920,6 +935,79 @@ 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.
+        # @param [Fixnum] generation
+        #   Generation of a bucket.
+        # @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 [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 restore_bucket(bucket, generation, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, 'b/{bucket}/restore', options)
+          command.params['bucket'] = bucket unless bucket.nil?
+          command.query['generation'] = generation unless generation.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
+        
         # Updates an IAM policy for the specified bucket.
         # @param [String] bucket
         #   Name of a bucket.
@@ -2608,9 +2696,16 @@ 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.
+        #   false. For more information, see [Soft Delete](https://cloud.google.com/
+        #   storage/docs/soft-delete).
         # @param [String] user_project
         #   The project to be billed for this request. Required for Requester Pays buckets.
         # @param [String] fields
@@ -2634,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)
@@ -2652,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?
@@ -2834,7 +2930,8 @@ module Google
         #   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.
+        #   false. For more information, see [Soft Delete](https://cloud.google.com/
+        #   storage/docs/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
@@ -2843,7 +2940,8 @@ module Google
         #   The project to be billed for this request. Required for Requester Pays buckets.
         # @param [Boolean] versions
         #   If true, lists all versions of an object as distinct results. The default is
-        #   false. For more information, see Object Versioning.
+        #   false. For more information, see [Object Versioning](https://cloud.google.com/
+        #   storage/docs/object-versioning).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2969,7 +3067,8 @@ module Google
         #   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.
+        #   path safe, see [Encoding URI Path Parts](https://cloud.google.com/storage/docs/
+        #   request-endpoints#encoding).
         # @param [Fixnum] generation
         #   Selects a specific revision of this object.
         # @param [Boolean] copy_source_acl
@@ -2992,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
@@ -3013,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
@@ -3026,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?
@@ -3365,7 +3470,8 @@ module Google
         #   The project to be billed for this request. Required for Requester Pays buckets.
         # @param [Boolean] versions
         #   If true, lists all versions of an object as distinct results. The default is
-        #   false. For more information, see Object Versioning.
+        #   false. For more information, see [Object Versioning](https://cloud.google.com/
+        #   storage/docs/object-versioning).
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -3408,6 +3514,46 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Starts asynchronous advancement of the relocate bucket operation in the case
+        # of required write downtime, to allow it to lock the bucket at the source
+        # location, and proceed with the bucket location swap. The server makes a best
+        # effort to advance the relocate bucket operation, but success is not guaranteed.
+        # @param [String] bucket
+        #   Name of the bucket to advance the relocate for.
+        # @param [String] operation_id
+        #   ID of the operation resource.
+        # @param [Google::Apis::StorageV1::AdvanceRelocateBucketOperationRequest] advance_relocate_bucket_operation_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 [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 advance_relocate_bucket_operation(bucket, operation_id, advance_relocate_bucket_operation_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, 'b/{bucket}/operations/{operationId}/advanceRelocateBucket', options)
+          command.request_representation = Google::Apis::StorageV1::AdvanceRelocateBucketOperationRequest::Representation
+          command.request_object = advance_relocate_bucket_operation_request_object
+          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
+        
         # 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
@@ -3693,8 +3839,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates the state of an HMAC key. See the HMAC Key resource descriptor for
-        # valid states.
+        # Updates the state of an HMAC key. See the [HMAC Key resource descriptor](https:
+        # //cloud.google.com/storage/docs/json_api/v1/projects/hmacKeys/update#request-
+        # body) for valid states.
         # @param [String] project_id
         #   Project ID owning the service account of the updated key.
         # @param [String] access_id

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-storage_v1
 version: !ruby/object:Gem::Version
-  version: 0.40.0
+  version: 0.47.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-06-27 00:00:00.000000000 Z
+date: 2024-10-13 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.40.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-storage_v1/v0.47.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.5.6
+rubygems_version: 3.5.21
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Storage JSON API V1