google-apis-storage_v1 0.38.0 → 0.49.0

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?
@@ -683,6 +693,44 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Returns the storage layout configuration for the specified bucket. Note that
+        # this operation requires storage.objects.list permission.
+        # @param [String] bucket
+        #   Name of a bucket.
+        # @param [String] prefix
+        #   An optional prefix used for permission check. It is useful when the caller
+        #   only has storage.objects.list permission under a specific prefix.
+        # @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::BucketStorageLayout] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StorageV1::BucketStorageLayout]
+        #
+        # @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_storage_layout(bucket, prefix: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:get, 'b/{bucket}/storageLayout', options)
+          command.response_representation = Google::Apis::StorageV1::BucketStorageLayout::Representation
+          command.response_class = Google::Apis::StorageV1::BucketStorageLayout
+          command.params['bucket'] = bucket unless bucket.nil?
+          command.query['prefix'] = prefix unless prefix.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 bucket.
         # @param [String] project
         #   A valid API project identifier.
@@ -748,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
@@ -769,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
@@ -778,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?
@@ -882,6 +935,84 @@ 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] 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::Bucket] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::StorageV1::Bucket]
+        #
+        # @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, projection: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, 'b/{bucket}/restore', 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['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
+        
         # Updates an IAM policy for the specified bucket.
         # @param [String] bucket
         #   Name of a bucket.
@@ -2570,9 +2701,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
@@ -2596,7 +2734,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)
@@ -2614,6 +2752,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?
@@ -2796,7 +2935,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
@@ -2805,7 +2945,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
@@ -2849,6 +2990,103 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Moves the source object to the destination object in the same bucket.
+        # @param [String] bucket
+        #   Name of the bucket in which the object resides.
+        # @param [String] source_object
+        #   Name of the source object. For information about how to URL encode object
+        #   names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/
+        #   storage/docs/request-endpoints#encoding).
+        # @param [String] destination_object
+        #   Name of the destination object. For information about how to URL encode object
+        #   names to be path safe, see [Encoding URI Path Parts](https://cloud.google.com/
+        #   storage/docs/request-endpoints#encoding).
+        # @param [Fixnum] if_generation_match
+        #   Makes the operation conditional on whether the destination object's current
+        #   generation matches the given value. Setting to 0 makes the operation succeed
+        #   only if there are no live versions of the object. `ifGenerationMatch` and `
+        #   ifGenerationNotMatch` conditions are mutually exclusive: it's an error for
+        #   both of them to be set in the request.
+        # @param [Fixnum] if_generation_not_match
+        #   Makes the operation conditional on whether the destination object's current
+        #   generation does not 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.`ifGenerationMatch` and `ifGenerationNotMatch`
+        #   conditions are mutually exclusive: it's an error for both of them to be set in
+        #   the request.
+        # @param [Fixnum] if_metageneration_match
+        #   Makes the operation conditional on whether the destination object's current
+        #   metageneration matches the given value. `ifMetagenerationMatch` and `
+        #   ifMetagenerationNotMatch` conditions are mutually exclusive: it's an error for
+        #   both of them to be set in the request.
+        # @param [Fixnum] if_metageneration_not_match
+        #   Makes the operation conditional on whether the destination object's current
+        #   metageneration does not match the given value. `ifMetagenerationMatch` and `
+        #   ifMetagenerationNotMatch` conditions are mutually exclusive: it's an error for
+        #   both of them to be set in the request.
+        # @param [Fixnum] if_source_generation_match
+        #   Makes the operation conditional on whether the source object's current
+        #   generation matches the given value. `ifSourceGenerationMatch` and `
+        #   ifSourceGenerationNotMatch` conditions are mutually exclusive: it's an error
+        #   for both of them to be set in the request.
+        # @param [Fixnum] if_source_generation_not_match
+        #   Makes the operation conditional on whether the source object's current
+        #   generation does not match the given value. `ifSourceGenerationMatch` and `
+        #   ifSourceGenerationNotMatch` conditions are mutually exclusive: it's an error
+        #   for both of them to be set in the request.
+        # @param [Fixnum] if_source_metageneration_match
+        #   Makes the operation conditional on whether the source object's current
+        #   metageneration matches the given value. `ifSourceMetagenerationMatch` and `
+        #   ifSourceMetagenerationNotMatch` conditions are mutually exclusive: it's an
+        #   error for both of them to be set in the request.
+        # @param [Fixnum] if_source_metageneration_not_match
+        #   Makes the operation conditional on whether the source object's current
+        #   metageneration does not match the given value. `ifSourceMetagenerationMatch`
+        #   and `ifSourceMetagenerationNotMatch` conditions are mutually exclusive: it's
+        #   an error for both of them to be set in the request.
+        # @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 move_object(bucket, source_object, destination_object, if_generation_match: nil, if_generation_not_match: nil, if_metageneration_match: nil, if_metageneration_not_match: nil, if_source_generation_match: nil, if_source_generation_not_match: nil, if_source_metageneration_match: nil, if_source_metageneration_not_match: nil, user_project: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, 'b/{bucket}/o/{sourceObject}/moveTo/o/{destinationObject}', options)
+          command.response_representation = Google::Apis::StorageV1::Object::Representation
+          command.response_class = Google::Apis::StorageV1::Object
+          command.params['bucket'] = bucket unless bucket.nil?
+          command.params['sourceObject'] = source_object unless source_object.nil?
+          command.params['destinationObject'] = destination_object unless destination_object.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['ifSourceGenerationMatch'] = if_source_generation_match unless if_source_generation_match.nil?
+          command.query['ifSourceGenerationNotMatch'] = if_source_generation_not_match unless if_source_generation_not_match.nil?
+          command.query['ifSourceMetagenerationMatch'] = if_source_metageneration_match unless if_source_metageneration_match.nil?
+          command.query['ifSourceMetagenerationNotMatch'] = if_source_metageneration_not_match unless if_source_metageneration_not_match.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
+        
         # Patches an object's metadata.
         # @param [String] bucket
         #   Name of the bucket in which the object resides.
@@ -2931,7 +3169,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
@@ -2954,6 +3193,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
@@ -2975,7 +3219,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
@@ -2988,6 +3232,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?
@@ -3327,7 +3572,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
@@ -3370,6 +3616,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
@@ -3655,8 +3941,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.38.0
+  version: 0.49.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-05-19 00:00:00.000000000 Z
+date: 2024-12-15 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.38.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-storage_v1/v0.49.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.23
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Storage JSON API V1