google-apis-file_v1 0.60.0 → 0.62.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e1c004a74c85c9b457482cb1958e2a97e6936d9dd7036fd64fe466d7e5115e1c
-  data.tar.gz: 67c8f1b3b302e90aeac9bd38857b5a479a29166cb6a673204652cfeb11b912dc
+  metadata.gz: 3ea010db8e9d34842183c6496d76739c507786479f92c3ff55114730b6165171
+  data.tar.gz: b47ab765b1c24d7658f105c01d02168c455a71350ea7ec0addde4d5bc87c00a1
 SHA512:
-  metadata.gz: a9c849d709c2bfe637454f8c4c5cf596fc35c2d90d4ddb558f5d3c9f76980952708eff95b540817613462c58582db37f6ea9aabb6ed17b4b91bbc8671e51c326
-  data.tar.gz: 44d2e86114c7f2c5f2de71ce1c64bdf0705b8ef9a454ed172932d34358d6a89fd59a8ec7a6eda9a7db93662a270e5a741c1131a0809a9824ffdb312a19cbe671
+  metadata.gz: c4ebf642ee74be2986514d2f07e40384cbbc7b86fd211573f954f065e4cc60bcfb06d85c0fccaa2b14980775756841f2cbdc6920597c940a39c165948f5d9ac5
+  data.tar.gz: aad55fccf829a9dfb25dd4b29cd32bbd9e832b96aef1984432889b9b1110ae73448585da7c92e8aceae4e38b8610729cd5e50f1f5b0b83c541ae69b7bfe65bb2

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 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
+
 ### v0.60.0 (2025-10-12)
 
 * Regenerated from discovery document revision 20250929

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

@@ -278,6 +278,25 @@ module Google
         end
       end
       
+      # Directory Services configuration for Kerberos-based authentication.
+      class DirectoryServicesConfig
+        include Google::Apis::Core::Hashable
+      
+        # LdapConfig contains all the parameters for connecting to LDAP servers.
+        # Corresponds to the JSON property `ldap`
+        # @return [Google::Apis::FileV1::LdapConfig]
+        attr_accessor :ldap
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @ldap = args[:ldap] if args.key?(:ldap)
+        end
+      end
+      
       # A generic empty message that you can re-use to avoid defining duplicated empty
       # messages in your APIs. A typical example is to use it as the request or the
       # response type of an API method. For instance: service Foo ` rpc Bar(google.
@@ -833,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
@@ -867,6 +887,11 @@ module Google
         # @return [String]
         attr_accessor :description
       
+        # Directory Services configuration for Kerberos-based authentication.
+        # Corresponds to the JSON property `directoryServices`
+        # @return [Google::Apis::FileV1::DirectoryServicesConfig]
+        attr_accessor :directory_services
+      
         # Server-specified ETag for the instance resource to prevent simultaneous
         # updates from overwriting each other.
         # Corresponds to the JSON property `etag`
@@ -889,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
@@ -934,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
@@ -995,6 +1020,7 @@ module Google
           @deletion_protection_enabled = args[:deletion_protection_enabled] if args.key?(:deletion_protection_enabled)
           @deletion_protection_reason = args[:deletion_protection_reason] if args.key?(:deletion_protection_reason)
           @description = args[:description] if args.key?(:description)
+          @directory_services = args[:directory_services] if args.key?(:directory_services)
           @etag = args[:etag] if args.key?(:etag)
           @file_shares = args[:file_shares] if args.key?(:file_shares)
           @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
@@ -1017,6 +1043,51 @@ module Google
         end
       end
       
+      # LdapConfig contains all the parameters for connecting to LDAP servers.
+      class LdapConfig
+        include Google::Apis::Core::Hashable
+      
+        # Required. The LDAP domain name in the format of `my-domain.com`.
+        # Corresponds to the JSON property `domain`
+        # @return [String]
+        attr_accessor :domain
+      
+        # Optional. The groups Organizational Unit (OU) is optional. This parameter is a
+        # hint to allow faster lookup in the LDAP namespace. In case that this parameter
+        # is not provided, Filestore instance will query the whole LDAP namespace.
+        # Corresponds to the JSON property `groupsOu`
+        # @return [String]
+        attr_accessor :groups_ou
+      
+        # Required. The servers names are used for specifying the LDAP servers names.
+        # The LDAP servers names can come with two formats: 1. DNS name, for example: `
+        # ldap.example1.com`, `ldap.example2.com`. 2. IP address, for example: `10.0.0.1`
+        # , `10.0.0.2`, `10.0.0.3`. All servers names must be in the same format: either
+        # all DNS names or all IP addresses.
+        # Corresponds to the JSON property `servers`
+        # @return [Array<String>]
+        attr_accessor :servers
+      
+        # Optional. The users Organizational Unit (OU) is optional. This parameter is a
+        # hint to allow faster lookup in the LDAP namespace. In case that this parameter
+        # is not provided, Filestore instance will query the whole LDAP namespace.
+        # Corresponds to the JSON property `usersOu`
+        # @return [String]
+        attr_accessor :users_ou
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @domain = args[:domain] if args.key?(:domain)
+          @groups_ou = args[:groups_ou] if args.key?(:groups_ou)
+          @servers = args[:servers] if args.key?(:servers)
+          @users_ou = args[:users_ou] if args.key?(:users_ou)
+        end
+      end
+      
       # ListBackupsResponse is the result of ListBackupsRequest.
       class ListBackupsResponse
         include Google::Apis::Core::Hashable
@@ -1128,6 +1199,14 @@ module Google
         # @return [Array<Google::Apis::FileV1::Operation>]
         attr_accessor :operations
       
+        # Unordered list. Unreachable resources. Populated when the request sets `
+        # 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
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1136,6 +1215,7 @@ module Google
         def update!(**args)
           @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
           @operations = args[:operations] if args.key?(:operations)
+          @unreachable = args[:unreachable] if args.key?(:unreachable)
         end
       end
       
@@ -1556,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
@@ -1591,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
@@ -1683,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
@@ -1717,7 +1812,7 @@ module Google
         end
       end
       
-      # Replication specifications.
+      # Optional. The configuration used to replicate an instance.
       class Replication
         include Google::Apis::Core::Hashable
       
@@ -1727,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
@@ -1771,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.60.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 = "20250929"
+      REVISION = "20251204"
     end
   end
 end

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

@@ -52,6 +52,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class DirectoryServicesConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Empty
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -136,6 +142,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class LdapConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ListBackupsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -208,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
       
@@ -250,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
       
@@ -350,6 +374,14 @@ module Google
         end
       end
       
+      class DirectoryServicesConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :ldap, as: 'ldap', class: Google::Apis::FileV1::LdapConfig, decorator: Google::Apis::FileV1::LdapConfig::Representation
+      
+        end
+      end
+      
       class Empty
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -493,6 +525,8 @@ module Google
           property :deletion_protection_enabled, as: 'deletionProtectionEnabled'
           property :deletion_protection_reason, as: 'deletionProtectionReason'
           property :description, as: 'description'
+          property :directory_services, as: 'directoryServices', class: Google::Apis::FileV1::DirectoryServicesConfig, decorator: Google::Apis::FileV1::DirectoryServicesConfig::Representation
+      
           property :etag, as: 'etag'
           collection :file_shares, as: 'fileShares', class: Google::Apis::FileV1::FileShareConfig, decorator: Google::Apis::FileV1::FileShareConfig::Representation
       
@@ -520,6 +554,16 @@ module Google
         end
       end
       
+      class LdapConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :domain, as: 'domain'
+          property :groups_ou, as: 'groupsOu'
+          collection :servers, as: 'servers'
+          property :users_ou, as: 'usersOu'
+        end
+      end
+      
       class ListBackupsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -555,6 +599,7 @@ module Google
           property :next_page_token, as: 'nextPageToken'
           collection :operations, as: 'operations', class: Google::Apis::FileV1::Operation, decorator: Google::Apis::FileV1::Operation::Representation
       
+          collection :unreachable, as: 'unreachable'
         end
       end
       
@@ -653,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
@@ -716,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/`
@@ -919,6 +990,14 @@ module Google
         #   The standard list page size.
         # @param [String] page_token
         #   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.
+        #   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
@@ -936,7 +1015,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_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+        def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, return_partial_success: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:get, 'v1/{+name}/operations', options)
           command.response_representation = Google::Apis::FileV1::ListOperationsResponse::Representation
           command.response_class = Google::Apis::FileV1::ListOperationsResponse
@@ -944,6 +1023,7 @@ module Google
           command.query['filter'] = filter unless filter.nil?
           command.query['pageSize'] = page_size unless page_size.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['returnPartialSuccess'] = return_partial_success unless return_partial_success.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-file_v1
 version: !ruby/object:Gem::Version
-  version: 0.60.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.60.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: