google-apis-file_v1 0.14.0 → 0.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 93cde6d1e8528ef1d28a77a98ed2eb7d542f93aa19d46c0e0d9c2f1fc48929f7
4
- data.tar.gz: 1b111a09e4c0f986e58198e21dfc0955219390f7b9a5b07c60bc4ab9389ce505
3
+ metadata.gz: 0e0f5108944eb2e09b31409c70c5328efb17bab5e2d7b68c9e63474d7dfe60ba
4
+ data.tar.gz: 42c2e1ca0547f5b80ca32900ecb38347f8dc9e7c21bd282ea12634c4b4293566
5
5
  SHA512:
6
- metadata.gz: 98abd5020a68c166cc89a4aebeee4681e8a44252c481c537f7a99656db8855bac6de530ae73f083ebdeca781ec68e400f762625e974207021b66b85c90803dc9
7
- data.tar.gz: 0c81dd3934fe5b795bffdebd1be65b9911f5fd6b6134461951ef46fb48ba084916f9c1794fab166d8ffa3913c4f2547878ddca9925f768450370d4ecd57c3698
6
+ metadata.gz: b858525c50d2ecdd026410da3d1c33775673e7af0c4c558b749fef5286912d10b7b2fd480ee0b2831559058a46a38c006102f70ef8cb91854d4cdcd4104dc7d9
7
+ data.tar.gz: b5d53495fd97c9d5e730ca0c3e899ef9aaf0c106a06aac0aea490fa86f3ff88d48b715942759495d7800bb3519fbbc9666afcd3041708cb77328f47b7f83cc53
data/CHANGELOG.md CHANGED
@@ -1,5 +1,18 @@
1
1
  # Release history for google-apis-file_v1
2
2
 
3
+ ### v0.17.0 (2022-02-28)
4
+
5
+ * Regenerated from discovery document revision 20220214
6
+ * Regenerated using generator version 0.4.1
7
+
8
+ ### v0.16.0 (2021-12-14)
9
+
10
+ * Unspecified changes
11
+
12
+ ### v0.15.0 (2021-11-14)
13
+
14
+ * Regenerated from discovery document revision 20211105
15
+
3
16
  ### v0.14.0 (2021-10-24)
4
17
 
5
18
  * Regenerated from discovery document revision 20211017
data/OVERVIEW.md CHANGED
@@ -51,7 +51,7 @@ require "google/apis/file_v1"
51
51
  client = Google::Apis::FileV1::CloudFilestoreService.new
52
52
 
53
53
  # Authenticate calls
54
- client.authentication = # ... use the googleauth gem to create credentials
54
+ client.authorization = # ... use the googleauth gem to create credentials
55
55
  ```
56
56
 
57
57
  See the class reference docs for information on the methods you can call from a client.
@@ -161,10 +161,10 @@ module Google
161
161
  # day and time zone are either specified elsewhere or are insignificant. The
162
162
  # date is relative to the Gregorian Calendar. This can represent one of the
163
163
  # following: * A full date, with non-zero year, month, and day values * A month
164
- # and day value, with a zero year, such as an anniversary * A year on its own,
165
- # with zero month and day values * A year and month value, with a zero day, such
166
- # as a credit card expiration date Related types are google.type.TimeOfDay and `
167
- # google.protobuf.Timestamp`.
164
+ # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
165
+ # zero month and a zero day * A year and month, with a zero day (e.g., a credit
166
+ # card expiration date) Related types: * google.type.TimeOfDay * google.type.
167
+ # DateTime * google.protobuf.Timestamp
168
168
  class Date
169
169
  include Google::Apis::Core::Hashable
170
170
 
@@ -207,10 +207,10 @@ module Google
207
207
  # day and time zone are either specified elsewhere or are insignificant. The
208
208
  # date is relative to the Gregorian Calendar. This can represent one of the
209
209
  # following: * A full date, with non-zero year, month, and day values * A month
210
- # and day value, with a zero year, such as an anniversary * A year on its own,
211
- # with zero month and day values * A year and month value, with a zero day, such
212
- # as a credit card expiration date Related types are google.type.TimeOfDay and `
213
- # google.protobuf.Timestamp`.
210
+ # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
211
+ # zero month and a zero day * A year and month, with a zero day (e.g., a credit
212
+ # card expiration date) Related types: * google.type.TimeOfDay * google.type.
213
+ # DateTime * google.protobuf.Timestamp
214
214
  # Corresponds to the JSON property `endDate`
215
215
  # @return [Google::Apis::FileV1::Date]
216
216
  attr_accessor :end_date
@@ -219,10 +219,10 @@ module Google
219
219
  # day and time zone are either specified elsewhere or are insignificant. The
220
220
  # date is relative to the Gregorian Calendar. This can represent one of the
221
221
  # following: * A full date, with non-zero year, month, and day values * A month
222
- # and day value, with a zero year, such as an anniversary * A year on its own,
223
- # with zero month and day values * A year and month value, with a zero day, such
224
- # as a credit card expiration date Related types are google.type.TimeOfDay and `
225
- # google.protobuf.Timestamp`.
222
+ # and day, with a zero year (e.g., an anniversary) * A year on its own, with a
223
+ # zero month and a zero day * A year and month, with a zero day (e.g., a credit
224
+ # card expiration date) Related types: * google.type.TimeOfDay * google.type.
225
+ # DateTime * google.protobuf.Timestamp
226
226
  # Corresponds to the JSON property `startDate`
227
227
  # @return [Google::Apis::FileV1::Date]
228
228
  attr_accessor :start_date
@@ -320,6 +320,15 @@ module Google
320
320
  # @return [String]
321
321
  attr_accessor :create_time
322
322
 
323
+ # Optional. The instance_type of this instance of format: projects/`project_id`/
324
+ # locations/`location_id`/instanceTypes/`instance_type_id`. Instance Type
325
+ # represents a high-level tier or SKU of the service that this instance belong
326
+ # to. When enabled(eg: Maintenance Rollout), Rollout uses 'instance_type' along
327
+ # with 'software_versions' to determine whether instance needs an update or not.
328
+ # Corresponds to the JSON property `instanceType`
329
+ # @return [String]
330
+ attr_accessor :instance_type
331
+
323
332
  # Optional. Resource labels to represent user provided metadata. Each label is a
324
333
  # key-value pair, where both the key and the value are arbitrary strings
325
334
  # provided by the user.
@@ -355,6 +364,13 @@ module Google
355
364
  # @return [String]
356
365
  attr_accessor :name
357
366
 
367
+ # Optional. notification_parameters are information that service producers may
368
+ # like to include that is not relevant to Rollout. This parameter will only be
369
+ # passed to Gamma and Cloud Logging for notification/logging purpose.
370
+ # Corresponds to the JSON property `notificationParameters`
371
+ # @return [Hash<String,String>]
372
+ attr_accessor :notification_parameters
373
+
358
374
  # Output only. Custom string attributes used primarily to expose producer-
359
375
  # specific information in monitoring dashboards. See go/get-instance-metadata.
360
376
  # Corresponds to the JSON property `producerMetadata`
@@ -412,11 +428,13 @@ module Google
412
428
  def update!(**args)
413
429
  @consumer_defined_name = args[:consumer_defined_name] if args.key?(:consumer_defined_name)
414
430
  @create_time = args[:create_time] if args.key?(:create_time)
431
+ @instance_type = args[:instance_type] if args.key?(:instance_type)
415
432
  @labels = args[:labels] if args.key?(:labels)
416
433
  @maintenance_policy_names = args[:maintenance_policy_names] if args.key?(:maintenance_policy_names)
417
434
  @maintenance_schedules = args[:maintenance_schedules] if args.key?(:maintenance_schedules)
418
435
  @maintenance_settings = args[:maintenance_settings] if args.key?(:maintenance_settings)
419
436
  @name = args[:name] if args.key?(:name)
437
+ @notification_parameters = args[:notification_parameters] if args.key?(:notification_parameters)
420
438
  @producer_metadata = args[:producer_metadata] if args.key?(:producer_metadata)
421
439
  @provisioned_resources = args[:provisioned_resources] if args.key?(:provisioned_resources)
422
440
  @slm_instance_template = args[:slm_instance_template] if args.key?(:slm_instance_template)
@@ -706,6 +724,11 @@ module Google
706
724
  # @return [Array<Google::Apis::FileV1::FileShareConfig>]
707
725
  attr_accessor :file_shares
708
726
 
727
+ # KMS key name used for data encryption.
728
+ # Corresponds to the JSON property `kmsKeyName`
729
+ # @return [String]
730
+ attr_accessor :kms_key_name
731
+
709
732
  # Resource labels to represent user provided metadata.
710
733
  # Corresponds to the JSON property `labels`
711
734
  # @return [Hash<String,String>]
@@ -739,6 +762,12 @@ module Google
739
762
  # @return [String]
740
763
  attr_accessor :status_message
741
764
 
765
+ # Output only. field indicates all the reasons the instance is in "SUSPENDED"
766
+ # state.
767
+ # Corresponds to the JSON property `suspensionReasons`
768
+ # @return [Array<String>]
769
+ attr_accessor :suspension_reasons
770
+
742
771
  # The service tier of the instance.
743
772
  # Corresponds to the JSON property `tier`
744
773
  # @return [String]
@@ -754,12 +783,14 @@ module Google
754
783
  @description = args[:description] if args.key?(:description)
755
784
  @etag = args[:etag] if args.key?(:etag)
756
785
  @file_shares = args[:file_shares] if args.key?(:file_shares)
786
+ @kms_key_name = args[:kms_key_name] if args.key?(:kms_key_name)
757
787
  @labels = args[:labels] if args.key?(:labels)
758
788
  @name = args[:name] if args.key?(:name)
759
789
  @networks = args[:networks] if args.key?(:networks)
760
790
  @satisfies_pzs = args[:satisfies_pzs] if args.key?(:satisfies_pzs)
761
791
  @state = args[:state] if args.key?(:state)
762
792
  @status_message = args[:status_message] if args.key?(:status_message)
793
+ @suspension_reasons = args[:suspension_reasons] if args.key?(:suspension_reasons)
763
794
  @tier = args[:tier] if args.key?(:tier)
764
795
  end
765
796
  end
@@ -886,6 +917,32 @@ module Google
886
917
  end
887
918
  end
888
919
 
920
+ # ListSnapshotsResponse is the result of ListSnapshotsRequest.
921
+ class ListSnapshotsResponse
922
+ include Google::Apis::Core::Hashable
923
+
924
+ # The token you can use to retrieve the next page of results. Not returned if
925
+ # there are no more results in the list.
926
+ # Corresponds to the JSON property `nextPageToken`
927
+ # @return [String]
928
+ attr_accessor :next_page_token
929
+
930
+ # A list of snapshots in the project for the specified instance.
931
+ # Corresponds to the JSON property `snapshots`
932
+ # @return [Array<Google::Apis::FileV1::Snapshot>]
933
+ attr_accessor :snapshots
934
+
935
+ def initialize(**args)
936
+ update!(**args)
937
+ end
938
+
939
+ # Update properties of this object
940
+ def update!(**args)
941
+ @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
942
+ @snapshots = args[:snapshots] if args.key?(:snapshots)
943
+ end
944
+ end
945
+
889
946
  # A resource that represents Google Cloud Platform location.
890
947
  class Location
891
948
  include Google::Apis::Core::Hashable
@@ -1024,6 +1081,12 @@ module Google
1024
1081
  class NetworkConfig
1025
1082
  include Google::Apis::Core::Hashable
1026
1083
 
1084
+ # The network connect mode of the Filestore instance. If not provided, the
1085
+ # connect mode defaults to DIRECT_PEERING.
1086
+ # Corresponds to the JSON property `connectMode`
1087
+ # @return [String]
1088
+ attr_accessor :connect_mode
1089
+
1027
1090
  # Output only. IPv4 addresses in the format ``octet1`.`octet2`.`octet3`.`octet4``
1028
1091
  # or IPv6 addresses in the format ``block1`:`block2`:`block3`:`block4`:`block5`:
1029
1092
  # `block6`:`block7`:`block8``.
@@ -1043,12 +1106,19 @@ module Google
1043
1106
  # @return [String]
1044
1107
  attr_accessor :network
1045
1108
 
1046
- # A /29 CIDR block in one of the [internal IP address ranges](https://www.arin.
1047
- # net/reference/research/statistics/address_filters/) that identifies the range
1048
- # of IP addresses reserved for this instance. For example, 10.0.0.0/29 or 192.
1049
- # 168.0.0/29. The range you specify can't overlap with either existing subnets
1050
- # or assigned IP address ranges for other Cloud Filestore instances in the
1051
- # selected VPC network.
1109
+ # Optional, reserved_ip_range can have one of the following two types of values.
1110
+ # * CIDR range value when using DIRECT_PEERING connect mode. * [Allocated IP
1111
+ # address range](https://cloud.google.com/compute/docs/ip-addresses/reserve-
1112
+ # static-internal-ip-address) when using PRIVATE_SERVICE_ACCESS connect mode.
1113
+ # When the name of an allocated IP address range is specified, it must be one of
1114
+ # the ranges associated with the private service access connection. When
1115
+ # specified as a direct CIDR value, it must be a /29 CIDR block for Basic tier
1116
+ # or a /24 CIDR block for High Scale or Enterprise tier in one of the [internal
1117
+ # IP address ranges](https://www.arin.net/reference/research/statistics/
1118
+ # address_filters/) that identifies the range of IP addresses reserved for this
1119
+ # instance. For example, 10.0.0.0/29 or 192.168.0.0/24. The range you specify
1120
+ # can't overlap with either existing subnets or assigned IP address ranges for
1121
+ # other Cloud Filestore instances in the selected VPC network.
1052
1122
  # Corresponds to the JSON property `reservedIpRange`
1053
1123
  # @return [String]
1054
1124
  attr_accessor :reserved_ip_range
@@ -1059,6 +1129,7 @@ module Google
1059
1129
 
1060
1130
  # Update properties of this object
1061
1131
  def update!(**args)
1132
+ @connect_mode = args[:connect_mode] if args.key?(:connect_mode)
1062
1133
  @ip_addresses = args[:ip_addresses] if args.key?(:ip_addresses)
1063
1134
  @modes = args[:modes] if args.key?(:modes)
1064
1135
  @network = args[:network] if args.key?(:network)
@@ -1303,6 +1374,59 @@ module Google
1303
1374
  end
1304
1375
  end
1305
1376
 
1377
+ # A Filestore snapshot.
1378
+ class Snapshot
1379
+ include Google::Apis::Core::Hashable
1380
+
1381
+ # Output only. The time when the snapshot was created.
1382
+ # Corresponds to the JSON property `createTime`
1383
+ # @return [String]
1384
+ attr_accessor :create_time
1385
+
1386
+ # A description of the snapshot with 2048 characters or less. Requests with
1387
+ # longer descriptions will be rejected.
1388
+ # Corresponds to the JSON property `description`
1389
+ # @return [String]
1390
+ attr_accessor :description
1391
+
1392
+ # Output only. The amount of bytes needed to allocate a full copy of the
1393
+ # snapshot content
1394
+ # Corresponds to the JSON property `filesystemUsedBytes`
1395
+ # @return [Fixnum]
1396
+ attr_accessor :filesystem_used_bytes
1397
+
1398
+ # Resource labels to represent user provided metadata.
1399
+ # Corresponds to the JSON property `labels`
1400
+ # @return [Hash<String,String>]
1401
+ attr_accessor :labels
1402
+
1403
+ # Output only. The resource name of the snapshot, in the format `projects/`
1404
+ # project_id`/locations/`location_id`/instances/`instance_id`/snapshots/`
1405
+ # snapshot_id``.
1406
+ # Corresponds to the JSON property `name`
1407
+ # @return [String]
1408
+ attr_accessor :name
1409
+
1410
+ # Output only. The snapshot state.
1411
+ # Corresponds to the JSON property `state`
1412
+ # @return [String]
1413
+ attr_accessor :state
1414
+
1415
+ def initialize(**args)
1416
+ update!(**args)
1417
+ end
1418
+
1419
+ # Update properties of this object
1420
+ def update!(**args)
1421
+ @create_time = args[:create_time] if args.key?(:create_time)
1422
+ @description = args[:description] if args.key?(:description)
1423
+ @filesystem_used_bytes = args[:filesystem_used_bytes] if args.key?(:filesystem_used_bytes)
1424
+ @labels = args[:labels] if args.key?(:labels)
1425
+ @name = args[:name] if args.key?(:name)
1426
+ @state = args[:state] if args.key?(:state)
1427
+ end
1428
+ end
1429
+
1306
1430
  # The `Status` type defines a logical error model that is suitable for different
1307
1431
  # programming environments, including REST APIs and RPC APIs. It is used by [
1308
1432
  # gRPC](https://github.com/grpc). Each `Status` message contains three pieces of
@@ -16,13 +16,13 @@ module Google
16
16
  module Apis
17
17
  module FileV1
18
18
  # Version of the google-apis-file_v1 gem
19
- GEM_VERSION = "0.14.0"
19
+ GEM_VERSION = "0.17.0"
20
20
 
21
21
  # Version of the code generator used to generate this client
22
- GENERATOR_VERSION = "0.4.0"
22
+ GENERATOR_VERSION = "0.4.1"
23
23
 
24
24
  # Revision of the discovery document this client was generated from
25
- REVISION = "20211017"
25
+ REVISION = "20220214"
26
26
  end
27
27
  end
28
28
  end
@@ -142,6 +142,12 @@ module Google
142
142
  include Google::Apis::Core::JsonObjectSupport
143
143
  end
144
144
 
145
+ class ListSnapshotsResponse
146
+ class Representation < Google::Apis::Core::JsonRepresentation; end
147
+
148
+ include Google::Apis::Core::JsonObjectSupport
149
+ end
150
+
145
151
  class Location
146
152
  class Representation < Google::Apis::Core::JsonRepresentation; end
147
153
 
@@ -196,6 +202,12 @@ module Google
196
202
  include Google::Apis::Core::JsonObjectSupport
197
203
  end
198
204
 
205
+ class Snapshot
206
+ class Representation < Google::Apis::Core::JsonRepresentation; end
207
+
208
+ include Google::Apis::Core::JsonObjectSupport
209
+ end
210
+
199
211
  class Status
200
212
  class Representation < Google::Apis::Core::JsonRepresentation; end
201
213
 
@@ -296,6 +308,7 @@ module Google
296
308
  class Representation < Google::Apis::Core::JsonRepresentation
297
309
  property :consumer_defined_name, as: 'consumerDefinedName'
298
310
  property :create_time, as: 'createTime'
311
+ property :instance_type, as: 'instanceType'
299
312
  hash :labels, as: 'labels'
300
313
  hash :maintenance_policy_names, as: 'maintenancePolicyNames'
301
314
  hash :maintenance_schedules, as: 'maintenanceSchedules', class: Google::Apis::FileV1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule, decorator: Google::Apis::FileV1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule::Representation
@@ -303,6 +316,7 @@ module Google
303
316
  property :maintenance_settings, as: 'maintenanceSettings', class: Google::Apis::FileV1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings, decorator: Google::Apis::FileV1::GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSettings::Representation
304
317
 
305
318
  property :name, as: 'name'
319
+ hash :notification_parameters, as: 'notificationParameters'
306
320
  hash :producer_metadata, as: 'producerMetadata'
307
321
  collection :provisioned_resources, as: 'provisionedResources', class: Google::Apis::FileV1::GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource, decorator: Google::Apis::FileV1::GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource::Representation
308
322
 
@@ -390,6 +404,7 @@ module Google
390
404
  property :etag, as: 'etag'
391
405
  collection :file_shares, as: 'fileShares', class: Google::Apis::FileV1::FileShareConfig, decorator: Google::Apis::FileV1::FileShareConfig::Representation
392
406
 
407
+ property :kms_key_name, as: 'kmsKeyName'
393
408
  hash :labels, as: 'labels'
394
409
  property :name, as: 'name'
395
410
  collection :networks, as: 'networks', class: Google::Apis::FileV1::NetworkConfig, decorator: Google::Apis::FileV1::NetworkConfig::Representation
@@ -397,6 +412,7 @@ module Google
397
412
  property :satisfies_pzs, as: 'satisfiesPzs'
398
413
  property :state, as: 'state'
399
414
  property :status_message, as: 'statusMessage'
415
+ collection :suspension_reasons, as: 'suspensionReasons'
400
416
  property :tier, as: 'tier'
401
417
  end
402
418
  end
@@ -439,6 +455,15 @@ module Google
439
455
  end
440
456
  end
441
457
 
458
+ class ListSnapshotsResponse
459
+ # @private
460
+ class Representation < Google::Apis::Core::JsonRepresentation
461
+ property :next_page_token, as: 'nextPageToken'
462
+ collection :snapshots, as: 'snapshots', class: Google::Apis::FileV1::Snapshot, decorator: Google::Apis::FileV1::Snapshot::Representation
463
+
464
+ end
465
+ end
466
+
442
467
  class Location
443
468
  # @private
444
469
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -477,6 +502,7 @@ module Google
477
502
  class NetworkConfig
478
503
  # @private
479
504
  class Representation < Google::Apis::Core::JsonRepresentation
505
+ property :connect_mode, as: 'connectMode'
480
506
  collection :ip_addresses, as: 'ipAddresses'
481
507
  collection :modes, as: 'modes'
482
508
  property :network, as: 'network'
@@ -538,6 +564,18 @@ module Google
538
564
  end
539
565
  end
540
566
 
567
+ class Snapshot
568
+ # @private
569
+ class Representation < Google::Apis::Core::JsonRepresentation
570
+ property :create_time, as: 'createTime'
571
+ property :description, as: 'description'
572
+ property :filesystem_used_bytes, :numeric_string => true, as: 'filesystemUsedBytes'
573
+ hash :labels, as: 'labels'
574
+ property :name, as: 'name'
575
+ property :state, as: 'state'
576
+ end
577
+ end
578
+
541
579
  class Status
542
580
  # @private
543
581
  class Representation < Google::Apis::Core::JsonRepresentation
@@ -360,6 +360,9 @@ module Google
360
360
  # @param [String] name
361
361
  # Required. The instance resource name, in the format `projects/`project_id`/
362
362
  # locations/`location`/instances/`instance_id``
363
+ # @param [Boolean] force
364
+ # If set to true, all snapshots of the instance will also be deleted. (Otherwise,
365
+ # the request will only work if the instance has no snapshots.)
363
366
  # @param [String] fields
364
367
  # Selector specifying which fields to include in a partial response.
365
368
  # @param [String] quota_user
@@ -377,11 +380,12 @@ module Google
377
380
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
378
381
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
379
382
  # @raise [Google::Apis::AuthorizationError] Authorization is required
380
- def delete_project_location_instance(name, fields: nil, quota_user: nil, options: nil, &block)
383
+ def delete_project_location_instance(name, force: nil, fields: nil, quota_user: nil, options: nil, &block)
381
384
  command = make_simple_command(:delete, 'v1/{+name}', options)
382
385
  command.response_representation = Google::Apis::FileV1::Operation::Representation
383
386
  command.response_class = Google::Apis::FileV1::Operation
384
387
  command.params['name'] = name unless name.nil?
388
+ command.query['force'] = force unless force.nil?
385
389
  command.query['fields'] = fields unless fields.nil?
386
390
  command.query['quotaUser'] = quota_user unless quota_user.nil?
387
391
  execute_or_queue_command(command, &block)
@@ -540,6 +544,191 @@ module Google
540
544
  execute_or_queue_command(command, &block)
541
545
  end
542
546
 
547
+ # Creates a snapshot.
548
+ # @param [String] parent
549
+ # Required. The Filestore Instance to create the snapshots of, in the format `
550
+ # projects/`project_id`/locations/`location`/instances/`instance_id``
551
+ # @param [Google::Apis::FileV1::Snapshot] snapshot_object
552
+ # @param [String] snapshot_id
553
+ # Required. The ID to use for the snapshot. The ID must be unique within the
554
+ # specified instance. This value must start with a lowercase letter followed by
555
+ # up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
556
+ # @param [String] fields
557
+ # Selector specifying which fields to include in a partial response.
558
+ # @param [String] quota_user
559
+ # Available to use for quota purposes for server-side applications. Can be any
560
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
561
+ # @param [Google::Apis::RequestOptions] options
562
+ # Request-specific options
563
+ #
564
+ # @yield [result, err] Result & error if block supplied
565
+ # @yieldparam result [Google::Apis::FileV1::Operation] parsed result object
566
+ # @yieldparam err [StandardError] error object if request failed
567
+ #
568
+ # @return [Google::Apis::FileV1::Operation]
569
+ #
570
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
571
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
572
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
573
+ def create_project_location_instance_snapshot(parent, snapshot_object = nil, snapshot_id: nil, fields: nil, quota_user: nil, options: nil, &block)
574
+ command = make_simple_command(:post, 'v1/{+parent}/snapshots', options)
575
+ command.request_representation = Google::Apis::FileV1::Snapshot::Representation
576
+ command.request_object = snapshot_object
577
+ command.response_representation = Google::Apis::FileV1::Operation::Representation
578
+ command.response_class = Google::Apis::FileV1::Operation
579
+ command.params['parent'] = parent unless parent.nil?
580
+ command.query['snapshotId'] = snapshot_id unless snapshot_id.nil?
581
+ command.query['fields'] = fields unless fields.nil?
582
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
583
+ execute_or_queue_command(command, &block)
584
+ end
585
+
586
+ # Deletes a snapshot.
587
+ # @param [String] name
588
+ # Required. The snapshot resource name, in the format `projects/`project_id`/
589
+ # locations/`location`/instances/`instance_id`/snapshots/`snapshot_id``
590
+ # @param [String] fields
591
+ # Selector specifying which fields to include in a partial response.
592
+ # @param [String] quota_user
593
+ # Available to use for quota purposes for server-side applications. Can be any
594
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
595
+ # @param [Google::Apis::RequestOptions] options
596
+ # Request-specific options
597
+ #
598
+ # @yield [result, err] Result & error if block supplied
599
+ # @yieldparam result [Google::Apis::FileV1::Operation] parsed result object
600
+ # @yieldparam err [StandardError] error object if request failed
601
+ #
602
+ # @return [Google::Apis::FileV1::Operation]
603
+ #
604
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
605
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
606
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
607
+ def delete_project_location_instance_snapshot(name, fields: nil, quota_user: nil, options: nil, &block)
608
+ command = make_simple_command(:delete, 'v1/{+name}', options)
609
+ command.response_representation = Google::Apis::FileV1::Operation::Representation
610
+ command.response_class = Google::Apis::FileV1::Operation
611
+ command.params['name'] = name unless name.nil?
612
+ command.query['fields'] = fields unless fields.nil?
613
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
614
+ execute_or_queue_command(command, &block)
615
+ end
616
+
617
+ # Gets the details of a specific snapshot.
618
+ # @param [String] name
619
+ # Required. The snapshot resource name, in the format `projects/`project_id`/
620
+ # locations/`location`/instances/`instance_id`/snapshots/`snapshot_id``
621
+ # @param [String] fields
622
+ # Selector specifying which fields to include in a partial response.
623
+ # @param [String] quota_user
624
+ # Available to use for quota purposes for server-side applications. Can be any
625
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
626
+ # @param [Google::Apis::RequestOptions] options
627
+ # Request-specific options
628
+ #
629
+ # @yield [result, err] Result & error if block supplied
630
+ # @yieldparam result [Google::Apis::FileV1::Snapshot] parsed result object
631
+ # @yieldparam err [StandardError] error object if request failed
632
+ #
633
+ # @return [Google::Apis::FileV1::Snapshot]
634
+ #
635
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
636
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
637
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
638
+ def get_project_location_instance_snapshot(name, fields: nil, quota_user: nil, options: nil, &block)
639
+ command = make_simple_command(:get, 'v1/{+name}', options)
640
+ command.response_representation = Google::Apis::FileV1::Snapshot::Representation
641
+ command.response_class = Google::Apis::FileV1::Snapshot
642
+ command.params['name'] = name unless name.nil?
643
+ command.query['fields'] = fields unless fields.nil?
644
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
645
+ execute_or_queue_command(command, &block)
646
+ end
647
+
648
+ # Lists all snapshots in a project for either a specified location or for all
649
+ # locations.
650
+ # @param [String] parent
651
+ # Required. The instance for which to retrieve snapshot information, in the
652
+ # format `projects/`project_id`/locations/`location`/instances/`instance_id``.
653
+ # @param [String] filter
654
+ # List filter.
655
+ # @param [String] order_by
656
+ # Sort results. Supported values are "name", "name desc" or "" (unsorted).
657
+ # @param [Fixnum] page_size
658
+ # The maximum number of items to return.
659
+ # @param [String] page_token
660
+ # The next_page_token value to use if there are additional results to retrieve
661
+ # for this list request.
662
+ # @param [String] fields
663
+ # Selector specifying which fields to include in a partial response.
664
+ # @param [String] quota_user
665
+ # Available to use for quota purposes for server-side applications. Can be any
666
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
667
+ # @param [Google::Apis::RequestOptions] options
668
+ # Request-specific options
669
+ #
670
+ # @yield [result, err] Result & error if block supplied
671
+ # @yieldparam result [Google::Apis::FileV1::ListSnapshotsResponse] parsed result object
672
+ # @yieldparam err [StandardError] error object if request failed
673
+ #
674
+ # @return [Google::Apis::FileV1::ListSnapshotsResponse]
675
+ #
676
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
677
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
678
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
679
+ def list_project_location_instance_snapshots(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
680
+ command = make_simple_command(:get, 'v1/{+parent}/snapshots', options)
681
+ command.response_representation = Google::Apis::FileV1::ListSnapshotsResponse::Representation
682
+ command.response_class = Google::Apis::FileV1::ListSnapshotsResponse
683
+ command.params['parent'] = parent unless parent.nil?
684
+ command.query['filter'] = filter unless filter.nil?
685
+ command.query['orderBy'] = order_by unless order_by.nil?
686
+ command.query['pageSize'] = page_size unless page_size.nil?
687
+ command.query['pageToken'] = page_token unless page_token.nil?
688
+ command.query['fields'] = fields unless fields.nil?
689
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
690
+ execute_or_queue_command(command, &block)
691
+ end
692
+
693
+ # Updates the settings of a specific snapshot.
694
+ # @param [String] name
695
+ # Output only. The resource name of the snapshot, in the format `projects/`
696
+ # project_id`/locations/`location_id`/instances/`instance_id`/snapshots/`
697
+ # snapshot_id``.
698
+ # @param [Google::Apis::FileV1::Snapshot] snapshot_object
699
+ # @param [String] update_mask
700
+ # Required. Mask of fields to update. At least one path must be supplied in this
701
+ # field.
702
+ # @param [String] fields
703
+ # Selector specifying which fields to include in a partial response.
704
+ # @param [String] quota_user
705
+ # Available to use for quota purposes for server-side applications. Can be any
706
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
707
+ # @param [Google::Apis::RequestOptions] options
708
+ # Request-specific options
709
+ #
710
+ # @yield [result, err] Result & error if block supplied
711
+ # @yieldparam result [Google::Apis::FileV1::Operation] parsed result object
712
+ # @yieldparam err [StandardError] error object if request failed
713
+ #
714
+ # @return [Google::Apis::FileV1::Operation]
715
+ #
716
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
717
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
718
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
719
+ def patch_project_location_instance_snapshot(name, snapshot_object = nil, update_mask: nil, fields: nil, quota_user: nil, options: nil, &block)
720
+ command = make_simple_command(:patch, 'v1/{+name}', options)
721
+ command.request_representation = Google::Apis::FileV1::Snapshot::Representation
722
+ command.request_object = snapshot_object
723
+ command.response_representation = Google::Apis::FileV1::Operation::Representation
724
+ command.response_class = Google::Apis::FileV1::Operation
725
+ command.params['name'] = name unless name.nil?
726
+ command.query['updateMask'] = update_mask unless update_mask.nil?
727
+ command.query['fields'] = fields unless fields.nil?
728
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
729
+ execute_or_queue_command(command, &block)
730
+ end
731
+
543
732
  # Starts asynchronous cancellation on a long-running operation. The server makes
544
733
  # a best effort to cancel the operation, but success is not guaranteed. If the
545
734
  # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-apis-file_v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.14.0
4
+ version: 0.17.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-10-27 00:00:00.000000000 Z
11
+ date: 2022-03-07 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
58
58
  metadata:
59
59
  bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
60
60
  changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-file_v1/CHANGELOG.md
61
- documentation_uri: https://googleapis.dev/ruby/google-apis-file_v1/v0.14.0
61
+ documentation_uri: https://googleapis.dev/ruby/google-apis-file_v1/v0.17.0
62
62
  source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-file_v1
63
63
  post_install_message:
64
64
  rdoc_options: []
@@ -75,7 +75,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
75
75
  - !ruby/object:Gem::Version
76
76
  version: '0'
77
77
  requirements: []
78
- rubygems_version: 3.2.17
78
+ rubygems_version: 3.3.5
79
79
  signing_key:
80
80
  specification_version: 4
81
81
  summary: Simple REST client for Cloud Filestore API V1