google-apis-file_v1beta1 0.13.0 → 0.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 695cae4e5972dc360a9db757f3b17017acbaee731cf462d96b8bf0b5cf22c34d
-  data.tar.gz: 6d489a42c36bbff5443195f739f034387f7a37ba4520969c5b4965c2f0b89859
+  metadata.gz: 013a47616522e69f9facefb153ded1ab5d543ffcb5ba10e160cc4159435a8c4a
+  data.tar.gz: 82de47b51f537ff676da226f09eb4bb56bc2bfd40e2d447cca3e232cc639d6ec
 SHA512:
-  metadata.gz: 842d5d60150c9af56f166dca9b3fe9498557d146484eda11376209c3d854ad2e522a1f3dff7e7c040d6b10ea7f04a1d75a68b0c812644364e9e9007f45adbec4
-  data.tar.gz: 2545c82819a434d8a5e27f10081260b61dcae77254d71afff2279071a6859cf197f81b57fd0ef7fc620848d28c08f917de3cec477c98cd9ee8bf6224d6b02426
+  metadata.gz: 54404acadb3f3ba6f747f67d021f05cbe6715988af1e97b5db770bbd60b39ea467d74c0d922cd762aa400a1af5e9236a310f87064045a729e0dd2c755e56ffc8
+  data.tar.gz: e0cdf0986071db48a2c57835b617481b9d22a68efe686f66fcd05918dbf6ee899f0da19f8f69a9afb74de0b6e176cfedbcc03c5599b92f1544c563f663ddf36f

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Release history for google-apis-file_v1beta1
 
+### v0.17.0 (2021-12-14)
+
+* Unspecified changes
+
+### v0.16.0 (2021-10-24)
+
+* Regenerated from discovery document revision 20211017
+* Unspecified changes
+
+### v0.15.0 (2021-09-07)
+
+* Regenerated from discovery document revision 20210822
+
+### v0.14.0 (2021-08-28)
+
+* Regenerated from discovery document revision 20210810
+
 ### v0.13.0 (2021-08-19)
 
 * Regenerated from discovery document revision 20210804

data/OVERVIEW.md

@@ -51,7 +51,7 @@ require "google/apis/file_v1beta1"
 client = Google::Apis::FileV1beta1::CloudFilestoreService.new
 
 # Authenticate calls
-client.authentication = # ... use the googleauth gem to create credentials
+client.authorization = # ... use the googleauth gem to create credentials
 ```
 
 See the class reference docs for information on the methods you can call from a client.
@@ -60,8 +60,8 @@ See the class reference docs for information on the methods you can call from a
 
 More detailed descriptions of the Google simple REST clients are available in two documents.
 
- *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
- *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
+ *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
+ *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/main/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
 
 (Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the File service in particular.)
 

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

@@ -527,14 +527,6 @@ module Google
       class GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata
         include Google::Apis::Core::Hashable
       
-        # By default node is eligible if instance is eligible. But individual node might
-        # be excluded from SLO by adding entry here. For semantic see SloMetadata.
-        # exclusions. If both instance and node level exclusions are present for time
-        # period, the node level's reason will be reported by Eligibility Exporter.
-        # Corresponds to the JSON property `exclusions`
-        # @return [Array<Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion>]
-        attr_accessor :exclusions
-      
         # The location of the node, if different from instance location.
         # Corresponds to the JSON property `location`
         # @return [String]
@@ -556,7 +548,6 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @exclusions = args[:exclusions] if args.key?(:exclusions)
           @location = args[:location] if args.key?(:location)
           @node_id = args[:node_id] if args.key?(:node_id)
           @per_sli_eligibility = args[:per_sli_eligibility] if args.key?(:per_sli_eligibility)
@@ -651,71 +642,11 @@ module Google
         end
       end
       
-      # SloExclusion represents an exclusion in SLI calculation applies to all SLOs.
-      class GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion
-        include Google::Apis::Core::Hashable
-      
-        # Exclusion duration. No restrictions on the possible values. When an ongoing
-        # operation is taking longer than initially expected, an existing entry in the
-        # exclusion list can be updated by extending the duration. This is supported by
-        # the subsystem exporting eligibility data as long as such extension is
-        # committed at least 10 minutes before the original exclusion expiration -
-        # otherwise it is possible that there will be "gaps" in the exclusion
-        # application in the exported timeseries.
-        # Corresponds to the JSON property `duration`
-        # @return [String]
-        attr_accessor :duration
-      
-        # Human-readable reason for the exclusion. This should be a static string (e.g. "
-        # Disruptive update in progress") and should not contain dynamically generated
-        # data (e.g. instance name). Can be left empty.
-        # Corresponds to the JSON property `reason`
-        # @return [String]
-        attr_accessor :reason
-      
-        # Name of an SLI that this exclusion applies to. Can be left empty, signaling
-        # that the instance should be excluded from all SLIs.
-        # Corresponds to the JSON property `sliName`
-        # @return [String]
-        attr_accessor :sli_name
-      
-        # Start time of the exclusion. No alignment (e.g. to a full minute) needed.
-        # Corresponds to the JSON property `startTime`
-        # @return [String]
-        attr_accessor :start_time
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @duration = args[:duration] if args.key?(:duration)
-          @reason = args[:reason] if args.key?(:reason)
-          @sli_name = args[:sli_name] if args.key?(:sli_name)
-          @start_time = args[:start_time] if args.key?(:start_time)
-        end
-      end
-      
       # SloMetadata contains resources required for proper SLO classification of the
       # instance.
       class GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata
         include Google::Apis::Core::Hashable
       
-        # List of SLO exclusion windows. When multiple entries in the list match (
-        # matching the exclusion time-window against current time point) the exclusion
-        # reason used in the first matching entry will be published. It is not needed to
-        # include expired exclusion in this list, as only the currently applicable
-        # exclusions are taken into account by the eligibility exporting subsystem (the
-        # historical state of exclusions will be reflected in the historically produced
-        # timeseries regardless of the current state). This field can be used to mark
-        # the instance as temporary ineligible for the purpose of SLO calculation. For
-        # permanent instance SLO exclusion, use of custom instance eligibility is
-        # recommended. See 'eligibility' field below.
-        # Corresponds to the JSON property `exclusions`
-        # @return [Array<Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion>]
-        attr_accessor :exclusions
-      
         # Optional. List of nodes. Some producers need to use per-node metadata to
         # calculate SLO. This field allows such producers to publish per-node SLO meta
         # data, which will be consumed by SSA Eligibility Exporter and published in the
@@ -742,7 +673,6 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @exclusions = args[:exclusions] if args.key?(:exclusions)
           @nodes = args[:nodes] if args.key?(:nodes)
           @per_sli_eligibility = args[:per_sli_eligibility] if args.key?(:per_sli_eligibility)
           @tier = args[:tier] if args.key?(:tier)
@@ -775,6 +705,11 @@ module Google
         # @return [Array<Google::Apis::FileV1beta1::FileShareConfig>]
         attr_accessor :file_shares
       
+        # KMS key name used for data encryption.
+        # Corresponds to the JSON property `kmsKeyName`
+        # @return [String]
+        attr_accessor :kms_key_name
+      
         # Resource labels to represent user provided metadata.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
@@ -808,6 +743,12 @@ module Google
         # @return [String]
         attr_accessor :status_message
       
+        # Output only. field indicates all the reasons the instance is in "SUSPENDED"
+        # state.
+        # Corresponds to the JSON property `suspensionReasons`
+        # @return [Array<String>]
+        attr_accessor :suspension_reasons
+      
         # The service tier of the instance.
         # Corresponds to the JSON property `tier`
         # @return [String]
@@ -823,12 +764,14 @@ module Google
           @description = args[:description] if args.key?(:description)
           @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)
           @labels = args[:labels] if args.key?(:labels)
           @name = args[:name] if args.key?(:name)
           @networks = args[:networks] if args.key?(:networks)
           @satisfies_pzs = args[:satisfies_pzs] if args.key?(:satisfies_pzs)
           @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)
           @tier = args[:tier] if args.key?(:tier)
         end
       end
@@ -1351,7 +1294,7 @@ module Google
         end
       end
       
-      # RestoreInstanceRequest restores an existing instances's file share from a
+      # RestoreInstanceRequest restores an existing instance's file share from a
       # snapshot or backup.
       class RestoreInstanceRequest
         include Google::Apis::Core::Hashable
@@ -1386,6 +1329,29 @@ module Google
         end
       end
       
+      # RevertInstanceRequest reverts the given instance's file share to the specified
+      # snapshot.
+      class RevertInstanceRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The snapshot resource ID, in the format 'my-snapshot', where the
+        # specified ID is the `snapshot_id` of the fully qualified name like projects/`
+        # project_id`/locations/`location_id`/instances/`instance_id`/snapshots/`
+        # snapshot_id`
+        # Corresponds to the JSON property `targetSnapshotId`
+        # @return [String]
+        attr_accessor :target_snapshot_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @target_snapshot_id = args[:target_snapshot_id] if args.key?(:target_snapshot_id)
+        end
+      end
+      
       # Configure the schedule.
       class Schedule
         include Google::Apis::Core::Hashable

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

@@ -16,13 +16,13 @@ module Google
   module Apis
     module FileV1beta1
       # Version of the google-apis-file_v1beta1 gem
-      GEM_VERSION = "0.13.0"
+      GEM_VERSION = "0.17.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.4.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20210804"
+      REVISION = "20211017"
     end
   end
 end

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

@@ -106,12 +106,6 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
       class GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -202,6 +196,12 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class RevertInstanceRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class Schedule
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -358,8 +358,6 @@ module Google
       class GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          collection :exclusions, as: 'exclusions', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion::Representation
-      
           property :location, as: 'location'
           property :node_id, as: 'nodeId'
           property :per_sli_eligibility, as: 'perSliEligibility', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility::Representation
@@ -391,21 +389,9 @@ module Google
         end
       end
       
-      class GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :duration, as: 'duration'
-          property :reason, as: 'reason'
-          property :sli_name, as: 'sliName'
-          property :start_time, as: 'startTime'
-        end
-      end
-      
       class GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          collection :exclusions, as: 'exclusions', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion::Representation
-      
           collection :nodes, as: 'nodes', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1NodeSloMetadata::Representation
       
           property :per_sli_eligibility, as: 'perSliEligibility', class: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility, decorator: Google::Apis::FileV1beta1::GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility::Representation
@@ -422,6 +408,7 @@ module Google
           property :etag, as: 'etag'
           collection :file_shares, as: 'fileShares', class: Google::Apis::FileV1beta1::FileShareConfig, decorator: Google::Apis::FileV1beta1::FileShareConfig::Representation
       
+          property :kms_key_name, as: 'kmsKeyName'
           hash :labels, as: 'labels'
           property :name, as: 'name'
           collection :networks, as: 'networks', class: Google::Apis::FileV1beta1::NetworkConfig, decorator: Google::Apis::FileV1beta1::NetworkConfig::Representation
@@ -429,6 +416,7 @@ module Google
           property :satisfies_pzs, as: 'satisfiesPzs'
           property :state, as: 'state'
           property :status_message, as: 'statusMessage'
+          collection :suspension_reasons, as: 'suspensionReasons'
           property :tier, as: 'tier'
         end
       end
@@ -571,6 +559,13 @@ module Google
         end
       end
       
+      class RevertInstanceRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :target_snapshot_id, as: 'targetSnapshotId'
+        end
+      end
+      
       class Schedule
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation

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

@@ -360,6 +360,9 @@ module Google
         # @param [String] name
         #   Required. The instance resource name, in the format `projects/`project_id`/
         #   locations/`location`/instances/`instance_id``
+        # @param [Boolean] force
+        #   If set to true, any snapshots of the instance will also be deleted. (Otherwise,
+        #   the request will only work if the instance has no snapshots.)
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -377,11 +380,12 @@ 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 delete_project_location_instance(name, fields: nil, quota_user: nil, options: nil, &block)
+        def delete_project_location_instance(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
           command = make_simple_command(:delete, 'v1beta1/{+name}', options)
           command.response_representation = Google::Apis::FileV1beta1::Operation::Representation
           command.response_class = Google::Apis::FileV1beta1::Operation
           command.params['name'] = name unless name.nil?
+          command.query['force'] = force unless force.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           execute_or_queue_command(command, &block)
@@ -540,6 +544,40 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Revert an existing instance's file system to a specified snapshot.
+        # @param [String] name
+        #   Required. projects/`project_id`/locations/`location_id`/instances/`instance_id`
+        #   . The resource name of the instance, in the format
+        # @param [Google::Apis::FileV1beta1::RevertInstanceRequest] revert_instance_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::FileV1beta1::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::FileV1beta1::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 revert_instance(name, revert_instance_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'v1beta1/{+name}:revert', options)
+          command.request_representation = Google::Apis::FileV1beta1::RevertInstanceRequest::Representation
+          command.request_object = revert_instance_request_object
+          command.response_representation = Google::Apis::FileV1beta1::Operation::Representation
+          command.response_class = Google::Apis::FileV1beta1::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
+        
         # Creates a snapshot.
         # @param [String] parent
         #   Required. The Filestore Instance to create the snapshots of, in the format `

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-file_v1beta1
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.17.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-23 00:00:00.000000000 Z
+date: 2022-01-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -57,9 +57,9 @@ licenses:
 - Apache-2.0
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
-  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-file_v1beta1/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-file_v1beta1/v0.13.0
-  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/master/generated/google-apis-file_v1beta1
+  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-file_v1beta1/CHANGELOG.md
+  documentation_uri: https://googleapis.dev/ruby/google-apis-file_v1beta1/v0.17.0
+  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-file_v1beta1
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.4
 signing_key: 
 specification_version: 4
 summary: Simple REST client for Cloud Filestore API V1beta1