google-apis-file_v1 0.61.0 → 0.62.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ecd09bcd80c6a3075032b99f334e90adb0cb451773fba5671d098850398f14a2
-  data.tar.gz: 594aa1d3cec4bd0ef7fe09ba00fe2a7a5b541b58e927f566c4a84d7ce2b2f406
+  metadata.gz: 3ea010db8e9d34842183c6496d76739c507786479f92c3ff55114730b6165171
+  data.tar.gz: b47ab765b1c24d7658f105c01d02168c455a71350ea7ec0addde4d5bc87c00a1
 SHA512:
-  metadata.gz: 219a1e58c0fa696b7a8c513e70ac22682a49c9c44dd0a3e8bd9bed39da0a9146e7b3fa8d105d3a69a045313d4472480666e3e92d8a379792ce7f50f966ca7062
-  data.tar.gz: 9feca23470c19c39d2ed59ea33d767ce25754e5ebb77085998d17876bb37ed37be443a34b932aceda1bc29050909ac7b346f8e1d21c0b256dc354451d8092e49
+  metadata.gz: c4ebf642ee74be2986514d2f07e40384cbbc7b86fd211573f954f065e4cc60bcfb06d85c0fccaa2b14980775756841f2cbdc6920597c940a39c165948f5d9ac5
+  data.tar.gz: aad55fccf829a9dfb25dd4b29cd32bbd9e832b96aef1984432889b9b1110ae73448585da7c92e8aceae4e38b8610729cd5e50f1f5b0b83c541ae69b7bfe65bb2

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release history for google-apis-file_v1
 
+### v0.62.0 (2025-12-14)
+
+* Regenerated from discovery document revision 20251204
+
 ### v0.61.0 (2025-10-26)
 
 * Regenerated from discovery document revision 20251015

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

@@ -852,7 +852,8 @@ module Google
       class Instance
         include Google::Apis::Core::Hashable
       
-        # Output only. The increase/decrease capacity step size in GB.
+        # Output only. The incremental increase or decrease in capacity, designated in
+        # some number of GB.
         # Corresponds to the JSON property `capacityStepSizeGb`
         # @return [Fixnum]
         attr_accessor :capacity_step_size_gb
@@ -913,12 +914,12 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Output only. The max capacity of the instance in GB.
+        # Output only. The maximum capacity of the instance in GB.
         # Corresponds to the JSON property `maxCapacityGb`
         # @return [Fixnum]
         attr_accessor :max_capacity_gb
       
-        # Output only. The min capacity of the instance in GB.
+        # Output only. The minimum capacity of the instance in GB.
         # Corresponds to the JSON property `minCapacityGb`
         # @return [Fixnum]
         attr_accessor :min_capacity_gb
@@ -958,7 +959,7 @@ module Google
         # @return [String]
         attr_accessor :protocol
       
-        # Replication specifications.
+        # Optional. The configuration used to replicate an instance.
         # Corresponds to the JSON property `replication`
         # @return [Google::Apis::FileV1::Replication]
         attr_accessor :replication
@@ -1199,8 +1200,9 @@ module Google
         attr_accessor :operations
       
         # Unordered list. Unreachable resources. Populated when the request sets `
-        # ListOperationsRequest.return_partial_success` and reads across collections e.g.
-        # when attempting to list all resources across all supported locations.
+        # ListOperationsRequest.return_partial_success` and reads across collections.
+        # For example, when attempting to list all resources across all supported
+        # locations.
         # Corresponds to the JSON property `unreachable`
         # @return [Array<String>]
         attr_accessor :unreachable
@@ -1634,6 +1636,19 @@ module Google
         end
       end
       
+      # PauseReplicaRequest pauses a Filestore standby instance (replica).
+      class PauseReplicaRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Used for setting the performance configuration. If the user doesn't specify
       # PerformanceConfig, automatically provision the default performance settings as
       # described in https://cloud.google.com/filestore/docs/performance. Larger
@@ -1669,27 +1684,27 @@ module Google
       class PerformanceLimits
         include Google::Apis::Core::Hashable
       
-        # Output only. The max IOPS.
+        # Output only. The maximum IOPS.
         # Corresponds to the JSON property `maxIops`
         # @return [Fixnum]
         attr_accessor :max_iops
       
-        # Output only. The max read IOPS.
+        # Output only. The maximum read IOPS.
         # Corresponds to the JSON property `maxReadIops`
         # @return [Fixnum]
         attr_accessor :max_read_iops
       
-        # Output only. The max read throughput in bytes per second.
+        # Output only. The maximum read throughput in bytes per second.
         # Corresponds to the JSON property `maxReadThroughputBps`
         # @return [Fixnum]
         attr_accessor :max_read_throughput_bps
       
-        # Output only. The max write IOPS.
+        # Output only. The maximum write IOPS.
         # Corresponds to the JSON property `maxWriteIops`
         # @return [Fixnum]
         attr_accessor :max_write_iops
       
-        # Output only. The max write throughput in bytes per second.
+        # Output only. The maximum write throughput in bytes per second.
         # Corresponds to the JSON property `maxWriteThroughputBps`
         # @return [Fixnum]
         attr_accessor :max_write_throughput_bps
@@ -1761,7 +1776,9 @@ module Google
         # @return [String]
         attr_accessor :last_active_sync_time
       
-        # Optional. The peer instance.
+        # Optional. The name of the source instance for the replica, in the format `
+        # projects/`project`/locations/`location`/instances/`instance``. This field is
+        # required when creating a replica.
         # Corresponds to the JSON property `peerInstance`
         # @return [String]
         attr_accessor :peer_instance
@@ -1795,7 +1812,7 @@ module Google
         end
       end
       
-      # Replication specifications.
+      # Optional. The configuration used to replicate an instance.
       class Replication
         include Google::Apis::Core::Hashable
       
@@ -1805,7 +1822,8 @@ module Google
         # @return [Array<Google::Apis::FileV1::ReplicaConfig>]
         attr_accessor :replicas
       
-        # Optional. The replication role.
+        # Optional. The replication role. When creating a new replica, this field must
+        # be set to `STANDBY`.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -1849,6 +1867,19 @@ module Google
         end
       end
       
+      # ResumeReplicaRequest resumes a Filestore standby instance (replica).
+      class ResumeReplicaRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # RevertInstanceRequest reverts the given instance's file share to the specified
       # snapshot.
       class RevertInstanceRequest

data/lib/google/apis/file_v1/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module FileV1
       # Version of the google-apis-file_v1 gem
-      GEM_VERSION = "0.61.0"
+      GEM_VERSION = "0.62.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.18.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20251015"
+      REVISION = "20251204"
     end
   end
 end

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

@@ -220,6 +220,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PauseReplicaRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class PerformanceConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -262,6 +268,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class ResumeReplicaRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class RevertInstanceRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -686,6 +698,12 @@ module Google
         end
       end
       
+      class PauseReplicaRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class PerformanceConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -749,6 +767,12 @@ module Google
         end
       end
       
+      class ResumeReplicaRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class RevertInstanceRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -85,8 +85,8 @@ module Google
         # @param [String] name
         #   The resource that owns the locations collection, if applicable.
         # @param [Array<String>, String] extra_location_types
-        #   Optional. Unless explicitly documented otherwise, don't use this unsupported
-        #   field which is primarily intended for internal usage.
+        #   Optional. Do not use this field. It is unsupported and is ignored unless
+        #   explicitly documented otherwise. This is primarily for internal usage.
         # @param [String] filter
         #   A filter to narrow down results to a preferred subset. The filtering language
         #   accepts strings like `"displayName=tokyo"`, and is documented in more detail
@@ -512,6 +512,42 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Pause the standby instance (replica). WARNING: This operation makes the
+        # standby instance's NFS filesystem writable. Any data written to the standby
+        # instance while paused will be lost when the replica is resumed or promoted.
+        # @param [String] name
+        #   Required. The resource name of the instance, in the format `projects/`
+        #   project_id`/locations/`location_id`/instances/`instance_id``.
+        # @param [Google::Apis::FileV1::PauseReplicaRequest] pause_replica_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FileV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FileV1::Operation]
+        #
+        # @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 pause_instance_replica(name, pause_replica_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:pauseReplica', options)
+          command.request_representation = Google::Apis::FileV1::PauseReplicaRequest::Representation
+          command.request_object = pause_replica_request_object
+          command.response_representation = Google::Apis::FileV1::Operation::Representation
+          command.response_class = Google::Apis::FileV1::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Promote the standby instance (replica).
         # @param [String] name
         #   Required. The resource name of the instance, in the format `projects/`
@@ -582,6 +618,41 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Resume the standby instance (replica). WARNING: Any data written to the
+        # standby instance while paused will be lost when the replica is resumed.
+        # @param [String] name
+        #   Required. The resource name of the instance, in the format `projects/`
+        #   project_id`/locations/`location_id`/instances/`instance_id``.
+        # @param [Google::Apis::FileV1::ResumeReplicaRequest] resume_replica_request_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::FileV1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FileV1::Operation]
+        #
+        # @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 resume_instance_replica(name, resume_replica_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:resumeReplica', options)
+          command.request_representation = Google::Apis::FileV1::ResumeReplicaRequest::Representation
+          command.request_object = resume_replica_request_object
+          command.response_representation = Google::Apis::FileV1::Operation::Representation
+          command.response_class = Google::Apis::FileV1::Operation
+          command.params['name'] = name unless name.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Revert an existing instance's file system to a specified snapshot.
         # @param [String] name
         #   Required. The resource name of the instance, in the format `projects/`
@@ -921,11 +992,12 @@ module Google
         #   The standard list page token.
         # @param [Boolean] return_partial_success
         #   When set to `true`, operations that are reachable are returned as normal, and
-        #   those that are unreachable are returned in the [ListOperationsResponse.
-        #   unreachable] field. This can only be `true` when reading across collections e.
-        #   g. when `parent` is set to `"projects/example/locations/-"`. This field is not
-        #   by default supported and will result in an `UNIMPLEMENTED` error if set unless
-        #   explicitly documented otherwise in service or product specific documentation.
+        #   those that are unreachable are returned in the ListOperationsResponse.
+        #   unreachable field. This can only be `true` when reading across collections.
+        #   For example, when `parent` is set to `"projects/example/locations/-"`. This
+        #   field is not supported by default and will result in an `UNIMPLEMENTED` error
+        #   if set unless explicitly documented otherwise in service or product specific
+        #   documentation.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-file_v1
 version: !ruby/object:Gem::Version
-  version: 0.61.0
+  version: 0.62.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,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-file_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-file_v1/v0.61.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-file_v1/v0.62.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-file_v1
 rdoc_options: []
 require_paths: