google-apis-storage_v1 0.41.0 → 0.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57c37c08f620ede9482e418a18d8454f12fc8b008086ae1b081ff607e6d9fc88
-  data.tar.gz: 3f99f26864ddf171f5b309c322a2e02d58adb63830200fd96f9f76aa8ca21c9b
+  metadata.gz: f0d27e1f5816add42a6b30d40f3965f03e5d7134fc5f534d826fd54fddc27d79
+  data.tar.gz: 3432572957fd577ec18c80ab0c6d6551e926e237989f34c4bd2b6771f6d4b9ff
 SHA512:
-  metadata.gz: 5119dc88378c0302b7052a3d2c25f1ccfc527c53febc61577794703176fc5e2686413230eaa7a4eb747495d7e28036d9be7d3b5210fb34cf9ec8ec90e63a3d18
-  data.tar.gz: 559386b27b822dd2b337feb90fda12bd1679d1296a8c108dee7f131164429709e106b7541721d6ba60b64ab7b38ffa25b057c6a82dcb4aecba55fbaff08fb1b3
+  metadata.gz: e77cdfa2248dccd3b31890317633baac88420190c4dd2b76ecfcc423fcb80fe789f71dc12903610609e663eab151366cef49771ea636563fd6f56334e401216f
+  data.tar.gz: de8c652fc2682caf03c494440955c90c29ea79d62f0b744c3d9f9487ae9234e37ec4d825e2945177a145547c82af65dcd3150a64fdbadb69d20b411a0d2208c3

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release history for google-apis-storage_v1
 
+### 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

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

@@ -204,6 +204,11 @@ module Google
         # @return [String]
         attr_accessor :etag
       
+        # The generation of this bucket.
+        # Corresponds to the JSON property `generation`
+        # @return [Fixnum]
+        attr_accessor :generation
+      
         # The bucket's hierarchical namespace configuration.
         # Corresponds to the JSON property `hierarchicalNamespace`
         # @return [Google::Apis::StorageV1::Bucket::HierarchicalNamespace]
@@ -304,6 +309,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]
@@ -369,6 +380,7 @@ 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)
           @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)
@@ -386,6 +398,7 @@ 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)

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.41.0"
+      GEM_VERSION = "0.42.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 = "20240706"
+      REVISION = "20240805"
     end
   end
 end

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

@@ -461,6 +461,7 @@ 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 :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
@@ -486,6 +487,7 @@ 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

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,43 @@ module Google
           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.
@@ -2610,7 +2662,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] user_project
         #   The project to be billed for this request. Required for Requester Pays buckets.
         # @param [String] fields
@@ -2834,7 +2887,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

metadata

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