google-apis-file_v1 0.46.0 → 0.48.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0908c8d713fe28a62478fb149d6b60f614894063efeb5e8db6f4e35e1825c9fb'
-  data.tar.gz: 48fe3fffe4a0e23fa8456250ab278891af19e63848852d03002ec82fd58aa51d
+  metadata.gz: 7f8fc62e8714068babd9dc93fa49f2a163a296fefb32a3bc2ac3d7761321db39
+  data.tar.gz: 5bcc6fd562b6fcb4277cd0f657205acda7976d391b96cbb993c806ad4ed26626
 SHA512:
-  metadata.gz: edbd9606b7d50d6aab36b2d16ca03929de8dd5304d7ffde74ddc7b3608a431f06853c903bf6f67fe0535fd53aff5ae35245ac0991daa62f47955ab89850fae88
-  data.tar.gz: dea6e35f9288b58bc09e99476a92662e43116dba34643090661c799e4abb78d9d621f0da44454381c7a0c252e6c55e7c60466650e754f63d178e63af05df1229
+  metadata.gz: 19e3dc5b669510f4c04d51e28583593c0d42d3dbb22a1da9f394cfc092361ab6778ef7ae888a88855c7b4ec4c044e2e9625f8ea4f83c9535e1f4e5ce069506ca
+  data.tar.gz: a3f84b7402b6da8392dc9891ad3134f66d2aba04708e97154a6b6e875afbc4e760e5199b1733cf6e4fafff94db27421eb382dbd26c43a011c093a857c77ab59c

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-file_v1
 
+### v0.48.0 (2024-10-27)
+
+* Regenerated from discovery document revision 20241015
+
+### v0.47.0 (2024-09-15)
+
+* Regenerated from discovery document revision 20240905
+
 ### v0.46.0 (2024-08-04)
 
 * Regenerated from discovery document revision 20240716

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

@@ -49,6 +49,12 @@ module Google
         # @return [Fixnum]
         attr_accessor :download_bytes
       
+        # Output only. The file system protocol of the source Filestore instance that
+        # this backup is created from.
+        # Corresponds to the JSON property `fileSystemProtocol`
+        # @return [String]
+        attr_accessor :file_system_protocol
+      
         # Immutable. KMS key name used for data encryption.
         # Corresponds to the JSON property `kmsKey`
         # @return [String]
@@ -107,7 +113,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :storage_bytes
       
-        # Optional. Input only. Immutable. Tag keys/values directly bound to this
+        # Optional. Input only. Immutable. Tag key-value pairs are bound to this
         # resource. For example: "123/environment": "production", "123/costCenter": "
         # marketing"
         # Corresponds to the JSON property `tags`
@@ -124,6 +130,7 @@ module Google
           @create_time = args[:create_time] if args.key?(:create_time)
           @description = args[:description] if args.key?(:description)
           @download_bytes = args[:download_bytes] if args.key?(:download_bytes)
+          @file_system_protocol = args[:file_system_protocol] if args.key?(:file_system_protocol)
           @kms_key = args[:kms_key] if args.key?(:kms_key)
           @labels = args[:labels] if args.key?(:labels)
           @name = args[:name] if args.key?(:name)
@@ -325,6 +332,32 @@ module Google
         end
       end
       
+      # Fixed IOPS (input/output operations per second) parameters.
+      class FixedIops
+        include Google::Apis::Core::Hashable
+      
+        # Required. Maximum IOPS.
+        # Corresponds to the JSON property `maxIops`
+        # @return [Fixnum]
+        attr_accessor :max_iops
+      
+        # Optional. Deprecated: `max_iops` should be used instead of this parameter.
+        # Maximum raw read IOPS.
+        # Corresponds to the JSON property `maxReadIops`
+        # @return [Fixnum]
+        attr_accessor :max_read_iops
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @max_iops = args[:max_iops] if args.key?(:max_iops)
+          @max_read_iops = args[:max_read_iops] if args.key?(:max_read_iops)
+        end
+      end
+      
       # Instance represents the interface for SLM services to actuate the state of
       # control plane resources. Example Instance in JSON, where consumer-project-
       # number=123456, producer-project-id=cloud-sql: ```json Instance: ` "name": "
@@ -759,15 +792,59 @@ module Google
         end
       end
       
+      # IOPS per TB. Filestore defines TB as 1024^4 bytes (TiB).
+      class IopsPerTb
+        include Google::Apis::Core::Hashable
+      
+        # Required. Maximum IOPS per TiB.
+        # Corresponds to the JSON property `maxIopsPerTb`
+        # @return [Fixnum]
+        attr_accessor :max_iops_per_tb
+      
+        # Optional. Deprecated: `max_iops_per_tb` should be used instead of this
+        # parameter. Maximum read IOPS per TiB.
+        # Corresponds to the JSON property `maxReadIopsPerTb`
+        # @return [Fixnum]
+        attr_accessor :max_read_iops_per_tb
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @max_iops_per_tb = args[:max_iops_per_tb] if args.key?(:max_iops_per_tb)
+          @max_read_iops_per_tb = args[:max_read_iops_per_tb] if args.key?(:max_read_iops_per_tb)
+        end
+      end
+      
       # A Filestore instance.
       class Instance
         include Google::Apis::Core::Hashable
       
+        # Output only. Indicates whether this instance's performance is configurable. If
+        # enabled, adjust it using the 'performance_config' field.
+        # Corresponds to the JSON property `configurablePerformanceEnabled`
+        # @return [Boolean]
+        attr_accessor :configurable_performance_enabled
+        alias_method :configurable_performance_enabled?, :configurable_performance_enabled
+      
         # Output only. The time when the instance was created.
         # Corresponds to the JSON property `createTime`
         # @return [String]
         attr_accessor :create_time
       
+        # Optional. Indicates whether the instance is protected against deletion.
+        # Corresponds to the JSON property `deletionProtectionEnabled`
+        # @return [Boolean]
+        attr_accessor :deletion_protection_enabled
+        alias_method :deletion_protection_enabled?, :deletion_protection_enabled
+      
+        # Optional. The reason for enabling deletion protection.
+        # Corresponds to the JSON property `deletionProtectionReason`
+        # @return [String]
+        attr_accessor :deletion_protection_reason
+      
         # The description of the instance (2048 characters or less).
         # Corresponds to the JSON property `description`
         # @return [String]
@@ -807,6 +884,29 @@ module Google
         # @return [Array<Google::Apis::FileV1::NetworkConfig>]
         attr_accessor :networks
       
+        # 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
+        # instances will be linearly set to more IOPS. If the instance's capacity is
+        # increased or decreased, its performance will be automatically adjusted upwards
+        # or downwards accordingly (respectively).
+        # Corresponds to the JSON property `performanceConfig`
+        # @return [Google::Apis::FileV1::PerformanceConfig]
+        attr_accessor :performance_config
+      
+        # The enforced performance limits, calculated from the instance's performance
+        # configuration.
+        # Corresponds to the JSON property `performanceLimits`
+        # @return [Google::Apis::FileV1::PerformanceLimits]
+        attr_accessor :performance_limits
+      
+        # Immutable. The protocol indicates the access protocol for all shares in the
+        # instance. This field is immutable and it cannot be changed after the instance
+        # has been created. Default value: `NFS_V3`.
+        # Corresponds to the JSON property `protocol`
+        # @return [String]
+        attr_accessor :protocol
+      
         # Replication specifications.
         # Corresponds to the JSON property `replication`
         # @return [Google::Apis::FileV1::Replication]
@@ -840,7 +940,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :suspension_reasons
       
-        # Optional. Input only. Immutable. Tag keys/values directly bound to this
+        # Optional. Input only. Immutable. Tag key-value pairs are bound to this
         # resource. For example: "123/environment": "production", "123/costCenter": "
         # marketing"
         # Corresponds to the JSON property `tags`
@@ -858,7 +958,10 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @configurable_performance_enabled = args[:configurable_performance_enabled] if args.key?(:configurable_performance_enabled)
           @create_time = args[:create_time] if args.key?(:create_time)
+          @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)
           @etag = args[:etag] if args.key?(:etag)
           @file_shares = args[:file_shares] if args.key?(:file_shares)
@@ -866,6 +969,9 @@ module Google
           @labels = args[:labels] if args.key?(:labels)
           @name = args[:name] if args.key?(:name)
           @networks = args[:networks] if args.key?(:networks)
+          @performance_config = args[:performance_config] if args.key?(:performance_config)
+          @performance_limits = args[:performance_limits] if args.key?(:performance_limits)
+          @protocol = args[:protocol] if args.key?(:protocol)
           @replication = args[:replication] if args.key?(:replication)
           @satisfies_pzi = args[:satisfies_pzi] if args.key?(:satisfies_pzi)
           @satisfies_pzs = args[:satisfies_pzs] if args.key?(:satisfies_pzs)
@@ -1396,6 +1502,74 @@ module Google
         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
+      # instances will be linearly set to more IOPS. If the instance's capacity is
+      # increased or decreased, its performance will be automatically adjusted upwards
+      # or downwards accordingly (respectively).
+      class PerformanceConfig
+        include Google::Apis::Core::Hashable
+      
+        # Fixed IOPS (input/output operations per second) parameters.
+        # Corresponds to the JSON property `fixedIops`
+        # @return [Google::Apis::FileV1::FixedIops]
+        attr_accessor :fixed_iops
+      
+        # IOPS per TB. Filestore defines TB as 1024^4 bytes (TiB).
+        # Corresponds to the JSON property `iopsPerTb`
+        # @return [Google::Apis::FileV1::IopsPerTb]
+        attr_accessor :iops_per_tb
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @fixed_iops = args[:fixed_iops] if args.key?(:fixed_iops)
+          @iops_per_tb = args[:iops_per_tb] if args.key?(:iops_per_tb)
+        end
+      end
+      
+      # The enforced performance limits, calculated from the instance's performance
+      # configuration.
+      class PerformanceLimits
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The max 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.
+        # Corresponds to the JSON property `maxReadThroughputBps`
+        # @return [Fixnum]
+        attr_accessor :max_read_throughput_bps
+      
+        # Output only. The max 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.
+        # Corresponds to the JSON property `maxWriteThroughputBps`
+        # @return [Fixnum]
+        attr_accessor :max_write_throughput_bps
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @max_read_iops = args[:max_read_iops] if args.key?(:max_read_iops)
+          @max_read_throughput_bps = args[:max_read_throughput_bps] if args.key?(:max_read_throughput_bps)
+          @max_write_iops = args[:max_write_iops] if args.key?(:max_write_iops)
+          @max_write_throughput_bps = args[:max_write_throughput_bps] if args.key?(:max_write_throughput_bps)
+        end
+      end
+      
       # PromoteReplicaRequest promotes a Filestore standby instance (replica).
       class PromoteReplicaRequest
         include Google::Apis::Core::Hashable
@@ -1451,8 +1625,8 @@ module Google
       class Replication
         include Google::Apis::Core::Hashable
       
-        # Optional. Replicas configuration on the instance. For now, only a single
-        # replica config is supported.
+        # Optional. Replication configuration for the replica instance associated with
+        # this instance. Only a single replica is supported.
         # Corresponds to the JSON property `replicas`
         # @return [Array<Google::Apis::FileV1::ReplicaConfig>]
         attr_accessor :replicas
@@ -1595,7 +1769,7 @@ module Google
         # @return [String]
         attr_accessor :state
       
-        # Optional. Input only. Immutable. Tag keys/values directly bound to this
+        # Optional. Input only. Immutable. Tag key-value pairs are bound to this
         # resource. For example: "123/environment": "production", "123/costCenter": "
         # marketing"
         # Corresponds to the JSON property `tags`
@@ -1663,24 +1837,28 @@ module Google
       class TimeOfDay
         include Google::Apis::Core::Hashable
       
-        # Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to
-        # allow the value "24:00:00" for scenarios like business closing time.
+        # Hours of a day in 24 hour format. Must be greater than or equal to 0 and
+        # typically must be less than or equal to 23. An API may choose to allow the
+        # value "24:00:00" for scenarios like business closing time.
         # Corresponds to the JSON property `hours`
         # @return [Fixnum]
         attr_accessor :hours
       
-        # Minutes of hour of day. Must be from 0 to 59.
+        # Minutes of an hour. Must be greater than or equal to 0 and less than or equal
+        # to 59.
         # Corresponds to the JSON property `minutes`
         # @return [Fixnum]
         attr_accessor :minutes
       
-        # Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.
+        # Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and
+        # less than or equal to 999,999,999.
         # Corresponds to the JSON property `nanos`
         # @return [Fixnum]
         attr_accessor :nanos
       
-        # Seconds of minutes of the time. Must normally be from 0 to 59. An API may
-        # allow the value 60 if it allows leap-seconds.
+        # Seconds of a minute. Must be greater than or equal to 0 and typically must be
+        # less than or equal to 59. An API may allow the value 60 if it allows leap-
+        # seconds.
         # Corresponds to the JSON property `seconds`
         # @return [Fixnum]
         attr_accessor :seconds

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.46.0"
+      GEM_VERSION = "0.48.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.15.1"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240716"
+      REVISION = "20241015"
     end
   end
 end

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

@@ -64,6 +64,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class FixedIops
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class GoogleCloudSaasacceleratorManagementProvidersV1Instance
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -118,6 +124,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class IopsPerTb
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Instance
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -196,6 +208,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class PerformanceConfig
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class PerformanceLimits
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class PromoteReplicaRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -269,6 +293,7 @@ module Google
           property :create_time, as: 'createTime'
           property :description, as: 'description'
           property :download_bytes, :numeric_string => true, as: 'downloadBytes'
+          property :file_system_protocol, as: 'fileSystemProtocol'
           property :kms_key, as: 'kmsKey'
           hash :labels, as: 'labels'
           property :name, as: 'name'
@@ -336,6 +361,14 @@ module Google
         end
       end
       
+      class FixedIops
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :max_iops, :numeric_string => true, as: 'maxIops'
+          property :max_read_iops, :numeric_string => true, as: 'maxReadIops'
+        end
+      end
+      
       class GoogleCloudSaasacceleratorManagementProvidersV1Instance
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -437,10 +470,21 @@ module Google
         end
       end
       
+      class IopsPerTb
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :max_iops_per_tb, :numeric_string => true, as: 'maxIopsPerTb'
+          property :max_read_iops_per_tb, :numeric_string => true, as: 'maxReadIopsPerTb'
+        end
+      end
+      
       class Instance
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :configurable_performance_enabled, as: 'configurablePerformanceEnabled'
           property :create_time, as: 'createTime'
+          property :deletion_protection_enabled, as: 'deletionProtectionEnabled'
+          property :deletion_protection_reason, as: 'deletionProtectionReason'
           property :description, as: 'description'
           property :etag, as: 'etag'
           collection :file_shares, as: 'fileShares', class: Google::Apis::FileV1::FileShareConfig, decorator: Google::Apis::FileV1::FileShareConfig::Representation
@@ -450,6 +494,11 @@ module Google
           property :name, as: 'name'
           collection :networks, as: 'networks', class: Google::Apis::FileV1::NetworkConfig, decorator: Google::Apis::FileV1::NetworkConfig::Representation
       
+          property :performance_config, as: 'performanceConfig', class: Google::Apis::FileV1::PerformanceConfig, decorator: Google::Apis::FileV1::PerformanceConfig::Representation
+      
+          property :performance_limits, as: 'performanceLimits', class: Google::Apis::FileV1::PerformanceLimits, decorator: Google::Apis::FileV1::PerformanceLimits::Representation
+      
+          property :protocol, as: 'protocol'
           property :replication, as: 'replication', class: Google::Apis::FileV1::Replication, decorator: Google::Apis::FileV1::Replication::Representation
       
           property :satisfies_pzi, as: 'satisfiesPzi'
@@ -591,6 +640,26 @@ module Google
         end
       end
       
+      class PerformanceConfig
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :fixed_iops, as: 'fixedIops', class: Google::Apis::FileV1::FixedIops, decorator: Google::Apis::FileV1::FixedIops::Representation
+      
+          property :iops_per_tb, as: 'iopsPerTb', class: Google::Apis::FileV1::IopsPerTb, decorator: Google::Apis::FileV1::IopsPerTb::Representation
+      
+        end
+      end
+      
+      class PerformanceLimits
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :max_read_iops, :numeric_string => true, as: 'maxReadIops'
+          property :max_read_throughput_bps, :numeric_string => true, as: 'maxReadThroughputBps'
+          property :max_write_iops, :numeric_string => true, as: 'maxWriteIops'
+          property :max_write_throughput_bps, :numeric_string => true, as: 'maxWriteThroughputBps'
+        end
+      end
+      
       class PromoteReplicaRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -479,7 +479,8 @@ module Google
         # @param [String] update_mask
         #   Mask of fields to update. At least one path must be supplied in this field.
         #   The elements of the repeated paths field may only include these fields: * "
-        #   description" * "file_shares" * "labels"
+        #   description" * "file_shares" * "labels" * "performance_config" * "
+        #   deletion_protection_enabled" * "deletion_protection_reason"
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -510,7 +511,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Promote an standby instance (replica).
+        # Promote the standby instance (replica).
         # @param [String] name
         #   Required. The resource name of the instance, in the format `projects/`
         #   project_id`/locations/`location_id`/instances/`instance_id``.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-file_v1
 version: !ruby/object:Gem::Version
-  version: 0.46.0
+  version: 0.48.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-08-04 00:00:00.000000000 Z
+date: 2024-10-27 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-file_v1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-file_v1/v0.46.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-file_v1/v0.48.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-file_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 Filestore API V1