google-apis-file_v1 0.43.0 → 0.45.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13db732f2b637c05b3204281616dc299c73916ba3e7d1b8597363be74da5cd42
-  data.tar.gz: 2ee96dd2819ef4718cfee000dc4434cc331e129e98411c8a670647b5e702cfbc
+  metadata.gz: 97d931f13d53fc9379a2264a99667037896952e7b37359a1e2e74ca1d0f423ae
+  data.tar.gz: cf56c01326b03ebeb97cfd1755ca9e2d78304856215e64cd49cc44e416f57438
 SHA512:
-  metadata.gz: 94b0481340aa2d5e042773788a6a159b69d1292d44d7e5ad0c49859f3caa91de22ba022694290cd58a5841bd68247567f69a07d628ab2ec163c481319883ce33
-  data.tar.gz: 41a8ff86b32d1973790ca69e1e39ee9bcfb44ecc90b4b6c0f567b2dd587f983d900dd88114f477784e7a85e790917ec0b118925f7fd6d4958618a705cb1af986
+  metadata.gz: f855dd4640c33423e3c4882d08dd8d85c23c822fd998fed0efdb6f52d6048badc9d558687085e5e1381863dfde46f484f48cc7e80ac3653e84af84fa5036dd05
+  data.tar.gz: ccbb054b5c825d750cc75979d6898059c32816d1afbc09acc6f567d72b7869458594331c2897cf67ff2d7441b29c46518817dce19dd40ae268bfeabbd2898099

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-file_v1
 
+### v0.45.0 (2024-06-26)
+
+* Regenerated from discovery document revision 20240619
+
+### v0.44.0 (2024-06-16)
+
+* Regenerated from discovery document revision 20240608
+
 ### v0.43.0 (2024-05-19)
 
 * Regenerated from discovery document revision 20240511

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

@@ -107,6 +107,13 @@ module Google
         # @return [Fixnum]
         attr_accessor :storage_bytes
       
+        # Optional. Input only. Immutable. Tag keys/values directly bound to this
+        # resource. For example: "123/environment": "production", "123/costCenter": "
+        # marketing"
+        # Corresponds to the JSON property `tags`
+        # @return [Hash<String,String>]
+        attr_accessor :tags
+      
         def initialize(**args)
            update!(**args)
         end
@@ -127,6 +134,7 @@ module Google
           @source_instance_tier = args[:source_instance_tier] if args.key?(:source_instance_tier)
           @state = args[:state] if args.key?(:state)
           @storage_bytes = args[:storage_bytes] if args.key?(:storage_bytes)
+          @tags = args[:tags] if args.key?(:tags)
         end
       end
       
@@ -297,6 +305,18 @@ module Google
         # @return [Array<Google::Apis::FileV1::NfsExportOptions>]
         attr_accessor :nfs_export_options
       
+        # Performance configuration. Used for setting the performance configuration.
+        # Defaults to `iops_by_capacity` if unset in instance creation.
+        # 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
+      
         # The resource name of the backup, in the format `projects/`project_number`/
         # locations/`location_id`/backups/`backup_id``, that this file share has been
         # restored from.
@@ -313,10 +333,31 @@ module Google
           @capacity_gb = args[:capacity_gb] if args.key?(:capacity_gb)
           @name = args[:name] if args.key?(:name)
           @nfs_export_options = args[:nfs_export_options] if args.key?(:nfs_export_options)
+          @performance_config = args[:performance_config] if args.key?(:performance_config)
+          @performance_limits = args[:performance_limits] if args.key?(:performance_limits)
           @source_backup = args[:source_backup] if args.key?(:source_backup)
         end
       end
       
+      # Fixed IOPS parameters.
+      class FixedIops
+        include Google::Apis::Core::Hashable
+      
+        # Required. 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_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": "
@@ -751,6 +792,25 @@ module Google
         end
       end
       
+      # IOPS per capacity parameters.
+      class IopsPerGb
+        include Google::Apis::Core::Hashable
+      
+        # Required. Maximum read IOPS per GB.
+        # Corresponds to the JSON property `maxReadIopsPerGb`
+        # @return [Fixnum]
+        attr_accessor :max_read_iops_per_gb
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @max_read_iops_per_gb = args[:max_read_iops_per_gb] if args.key?(:max_read_iops_per_gb)
+        end
+      end
+      
       # A Filestore instance.
       class Instance
         include Google::Apis::Core::Hashable
@@ -832,6 +892,13 @@ module Google
         # @return [Array<String>]
         attr_accessor :suspension_reasons
       
+        # Optional. Input only. Immutable. Tag keys/values directly bound to this
+        # resource. For example: "123/environment": "production", "123/costCenter": "
+        # marketing"
+        # Corresponds to the JSON property `tags`
+        # @return [Hash<String,String>]
+        attr_accessor :tags
+      
         # The service tier of the instance.
         # Corresponds to the JSON property `tier`
         # @return [String]
@@ -857,6 +924,7 @@ module Google
           @state = args[:state] if args.key?(:state)
           @status_message = args[:status_message] if args.key?(:status_message)
           @suspension_reasons = args[:suspension_reasons] if args.key?(:suspension_reasons)
+          @tags = args[:tags] if args.key?(:tags)
           @tier = args[:tier] if args.key?(:tier)
         end
       end
@@ -1380,6 +1448,94 @@ module Google
         end
       end
       
+      # Performance configuration. Used for setting the performance configuration.
+      # Defaults to `iops_by_capacity` if unset in instance creation.
+      class PerformanceConfig
+        include Google::Apis::Core::Hashable
+      
+        # Fixed IOPS parameters.
+        # Corresponds to the JSON property `fixedIops`
+        # @return [Google::Apis::FileV1::FixedIops]
+        attr_accessor :fixed_iops
+      
+        # Automatically provision maximum available IOPS based on the capacity of the
+        # instance. Larger instances will be granted more IOPS. If instance capacity is
+        # increased or decreased, IOPS will be automatically adjusted upwards or
+        # downwards accordingly. The maximum available IOPS for a given capacity is
+        # defined in Filestore documentation.
+        # Corresponds to the JSON property `iopsByCapacity`
+        # @return [Boolean]
+        attr_accessor :iops_by_capacity
+        alias_method :iops_by_capacity?, :iops_by_capacity
+      
+        # IOPS per capacity parameters.
+        # Corresponds to the JSON property `iopsPerGb`
+        # @return [Google::Apis::FileV1::IopsPerGb]
+        attr_accessor :iops_per_gb
+      
+        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_by_capacity = args[:iops_by_capacity] if args.key?(:iops_by_capacity)
+          @iops_per_gb = args[:iops_per_gb] if args.key?(:iops_per_gb)
+        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.
+        # Corresponds to the JSON property `maxReadThroughput`
+        # @return [Fixnum]
+        attr_accessor :max_read_throughput
+      
+        # 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.
+        # Corresponds to the JSON property `maxWriteThroughput`
+        # @return [Fixnum]
+        attr_accessor :max_write_throughput
+      
+        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 = args[:max_read_throughput] if args.key?(:max_read_throughput)
+          @max_write_iops = args[:max_write_iops] if args.key?(:max_write_iops)
+          @max_write_throughput = args[:max_write_throughput] if args.key?(:max_write_throughput)
+        end
+      end
+      
+      # PromoteReplicaRequest promotes a Filestore standby instance (replica).
+      class PromoteReplicaRequest
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
       # Replica configuration for the instance.
       class ReplicaConfig
         include Google::Apis::Core::Hashable
@@ -1566,6 +1722,13 @@ module Google
         # @return [String]
         attr_accessor :state
       
+        # Optional. Input only. Immutable. Tag keys/values directly bound to this
+        # resource. For example: "123/environment": "production", "123/costCenter": "
+        # marketing"
+        # Corresponds to the JSON property `tags`
+        # @return [Hash<String,String>]
+        attr_accessor :tags
+      
         def initialize(**args)
            update!(**args)
         end
@@ -1578,6 +1741,7 @@ module Google
           @labels = args[:labels] if args.key?(:labels)
           @name = args[:name] if args.key?(:name)
           @state = args[:state] if args.key?(:state)
+          @tags = args[:tags] if args.key?(:tags)
         end
       end
       

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.43.0"
+      GEM_VERSION = "0.45.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.15.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240511"
+      REVISION = "20240619"
     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 IopsPerGb
+        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,24 @@ 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
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class ReplicaConfig
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -273,6 +303,7 @@ module Google
           property :source_instance_tier, as: 'sourceInstanceTier'
           property :state, as: 'state'
           property :storage_bytes, :numeric_string => true, as: 'storageBytes'
+          hash :tags, as: 'tags'
         end
       end
       
@@ -325,10 +356,21 @@ module Google
           property :name, as: 'name'
           collection :nfs_export_options, as: 'nfsExportOptions', class: Google::Apis::FileV1::NfsExportOptions, decorator: Google::Apis::FileV1::NfsExportOptions::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 :source_backup, as: 'sourceBackup'
         end
       end
       
+      class FixedIops
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :max_read_iops, :numeric_string => true, as: 'maxReadIops'
+        end
+      end
+      
       class GoogleCloudSaasacceleratorManagementProvidersV1Instance
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -430,6 +472,13 @@ module Google
         end
       end
       
+      class IopsPerGb
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :max_read_iops_per_gb, :numeric_string => true, as: 'maxReadIopsPerGb'
+        end
+      end
+      
       class Instance
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -450,6 +499,7 @@ module Google
           property :state, as: 'state'
           property :status_message, as: 'statusMessage'
           collection :suspension_reasons, as: 'suspensionReasons'
+          hash :tags, as: 'tags'
           property :tier, as: 'tier'
         end
       end
@@ -583,6 +633,33 @@ 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_by_capacity, as: 'iopsByCapacity'
+          property :iops_per_gb, as: 'iopsPerGb', class: Google::Apis::FileV1::IopsPerGb, decorator: Google::Apis::FileV1::IopsPerGb::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, :numeric_string => true, as: 'maxReadThroughput'
+          property :max_write_iops, :numeric_string => true, as: 'maxWriteIops'
+          property :max_write_throughput, :numeric_string => true, as: 'maxWriteThroughput'
+        end
+      end
+      
+      class PromoteReplicaRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+        end
+      end
+      
       class ReplicaConfig
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -636,6 +713,7 @@ module Google
           hash :labels, as: 'labels'
           property :name, as: 'name'
           property :state, as: 'state'
+          hash :tags, as: 'tags'
         end
       end
       

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

@@ -510,6 +510,40 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Promote an 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``.
+        # @param [Google::Apis::FileV1::PromoteReplicaRequest] promote_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 promote_instance_replica(name, promote_replica_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1/{+name}:promoteReplica', options)
+          command.request_representation = Google::Apis::FileV1::PromoteReplicaRequest::Representation
+          command.request_object = promote_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
+        
         # Restores an existing instance's file share from a backup. The capacity of the
         # instance needs to be equal to or larger than the capacity of the backup (and
         # also equal to or larger than the minimum capacity of the tier).

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-file_v1
 version: !ruby/object:Gem::Version
-  version: 0.43.0
+  version: 0.45.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-05-19 00:00:00.000000000 Z
+date: 2024-06-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.43.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-file_v1/v0.45.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-file_v1
 post_install_message: 
 rdoc_options: []