google-cloud-filestore-v1 0.2.0 → 0.4.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.
@@ -0,0 +1,999 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2023 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/filestore/v1/cloud_filestore_service_pb"
20
+
21
+ module Google
22
+ module Cloud
23
+ module Filestore
24
+ module V1
25
+ module CloudFilestoreManager
26
+ module Rest
27
+ ##
28
+ # REST service stub for the CloudFilestoreManager service.
29
+ # Service stub contains baseline method implementations
30
+ # including transcoding, making the REST call, and deserialing the response.
31
+ #
32
+ class ServiceStub
33
+ def initialize endpoint:, credentials:
34
+ # These require statements are intentionally placed here to initialize
35
+ # the REST modules only when it's required.
36
+ require "gapic/rest"
37
+
38
+ @client_stub = ::Gapic::Rest::ClientStub.new endpoint: endpoint, credentials: credentials,
39
+ numeric_enums: true,
40
+ raise_faraday_errors: false
41
+ end
42
+
43
+ ##
44
+ # Baseline implementation for the list_instances REST call
45
+ #
46
+ # @param request_pb [::Google::Cloud::Filestore::V1::ListInstancesRequest]
47
+ # A request object representing the call parameters. Required.
48
+ # @param options [::Gapic::CallOptions]
49
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
50
+ #
51
+ # @yield [result, operation] Access the result along with the TransportOperation object
52
+ # @yieldparam result [::Google::Cloud::Filestore::V1::ListInstancesResponse]
53
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
54
+ #
55
+ # @return [::Google::Cloud::Filestore::V1::ListInstancesResponse]
56
+ # A result object deserialized from the server's reply
57
+ def list_instances request_pb, options = nil
58
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
59
+
60
+ verb, uri, query_string_params, body = ServiceStub.transcode_list_instances_request request_pb
61
+ query_string_params = if query_string_params.any?
62
+ query_string_params.to_h { |p| p.split("=", 2) }
63
+ else
64
+ {}
65
+ end
66
+
67
+ response = @client_stub.make_http_request(
68
+ verb,
69
+ uri: uri,
70
+ body: body || "",
71
+ params: query_string_params,
72
+ options: options
73
+ )
74
+ operation = ::Gapic::Rest::TransportOperation.new response
75
+ result = ::Google::Cloud::Filestore::V1::ListInstancesResponse.decode_json response.body, ignore_unknown_fields: true
76
+
77
+ yield result, operation if block_given?
78
+ result
79
+ end
80
+
81
+ ##
82
+ # Baseline implementation for the get_instance REST call
83
+ #
84
+ # @param request_pb [::Google::Cloud::Filestore::V1::GetInstanceRequest]
85
+ # A request object representing the call parameters. Required.
86
+ # @param options [::Gapic::CallOptions]
87
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
88
+ #
89
+ # @yield [result, operation] Access the result along with the TransportOperation object
90
+ # @yieldparam result [::Google::Cloud::Filestore::V1::Instance]
91
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
92
+ #
93
+ # @return [::Google::Cloud::Filestore::V1::Instance]
94
+ # A result object deserialized from the server's reply
95
+ def get_instance request_pb, options = nil
96
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
97
+
98
+ verb, uri, query_string_params, body = ServiceStub.transcode_get_instance_request request_pb
99
+ query_string_params = if query_string_params.any?
100
+ query_string_params.to_h { |p| p.split("=", 2) }
101
+ else
102
+ {}
103
+ end
104
+
105
+ response = @client_stub.make_http_request(
106
+ verb,
107
+ uri: uri,
108
+ body: body || "",
109
+ params: query_string_params,
110
+ options: options
111
+ )
112
+ operation = ::Gapic::Rest::TransportOperation.new response
113
+ result = ::Google::Cloud::Filestore::V1::Instance.decode_json response.body, ignore_unknown_fields: true
114
+
115
+ yield result, operation if block_given?
116
+ result
117
+ end
118
+
119
+ ##
120
+ # Baseline implementation for the create_instance REST call
121
+ #
122
+ # @param request_pb [::Google::Cloud::Filestore::V1::CreateInstanceRequest]
123
+ # A request object representing the call parameters. Required.
124
+ # @param options [::Gapic::CallOptions]
125
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
126
+ #
127
+ # @yield [result, operation] Access the result along with the TransportOperation object
128
+ # @yieldparam result [::Google::Longrunning::Operation]
129
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
130
+ #
131
+ # @return [::Google::Longrunning::Operation]
132
+ # A result object deserialized from the server's reply
133
+ def create_instance request_pb, options = nil
134
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
135
+
136
+ verb, uri, query_string_params, body = ServiceStub.transcode_create_instance_request request_pb
137
+ query_string_params = if query_string_params.any?
138
+ query_string_params.to_h { |p| p.split("=", 2) }
139
+ else
140
+ {}
141
+ end
142
+
143
+ response = @client_stub.make_http_request(
144
+ verb,
145
+ uri: uri,
146
+ body: body || "",
147
+ params: query_string_params,
148
+ options: options
149
+ )
150
+ operation = ::Gapic::Rest::TransportOperation.new response
151
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
152
+
153
+ yield result, operation if block_given?
154
+ result
155
+ end
156
+
157
+ ##
158
+ # Baseline implementation for the update_instance REST call
159
+ #
160
+ # @param request_pb [::Google::Cloud::Filestore::V1::UpdateInstanceRequest]
161
+ # A request object representing the call parameters. Required.
162
+ # @param options [::Gapic::CallOptions]
163
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
164
+ #
165
+ # @yield [result, operation] Access the result along with the TransportOperation object
166
+ # @yieldparam result [::Google::Longrunning::Operation]
167
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
168
+ #
169
+ # @return [::Google::Longrunning::Operation]
170
+ # A result object deserialized from the server's reply
171
+ def update_instance request_pb, options = nil
172
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
173
+
174
+ verb, uri, query_string_params, body = ServiceStub.transcode_update_instance_request request_pb
175
+ query_string_params = if query_string_params.any?
176
+ query_string_params.to_h { |p| p.split("=", 2) }
177
+ else
178
+ {}
179
+ end
180
+
181
+ response = @client_stub.make_http_request(
182
+ verb,
183
+ uri: uri,
184
+ body: body || "",
185
+ params: query_string_params,
186
+ options: options
187
+ )
188
+ operation = ::Gapic::Rest::TransportOperation.new response
189
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
190
+
191
+ yield result, operation if block_given?
192
+ result
193
+ end
194
+
195
+ ##
196
+ # Baseline implementation for the restore_instance REST call
197
+ #
198
+ # @param request_pb [::Google::Cloud::Filestore::V1::RestoreInstanceRequest]
199
+ # A request object representing the call parameters. Required.
200
+ # @param options [::Gapic::CallOptions]
201
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
202
+ #
203
+ # @yield [result, operation] Access the result along with the TransportOperation object
204
+ # @yieldparam result [::Google::Longrunning::Operation]
205
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
206
+ #
207
+ # @return [::Google::Longrunning::Operation]
208
+ # A result object deserialized from the server's reply
209
+ def restore_instance request_pb, options = nil
210
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
211
+
212
+ verb, uri, query_string_params, body = ServiceStub.transcode_restore_instance_request request_pb
213
+ query_string_params = if query_string_params.any?
214
+ query_string_params.to_h { |p| p.split("=", 2) }
215
+ else
216
+ {}
217
+ end
218
+
219
+ response = @client_stub.make_http_request(
220
+ verb,
221
+ uri: uri,
222
+ body: body || "",
223
+ params: query_string_params,
224
+ options: options
225
+ )
226
+ operation = ::Gapic::Rest::TransportOperation.new response
227
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
228
+
229
+ yield result, operation if block_given?
230
+ result
231
+ end
232
+
233
+ ##
234
+ # Baseline implementation for the delete_instance REST call
235
+ #
236
+ # @param request_pb [::Google::Cloud::Filestore::V1::DeleteInstanceRequest]
237
+ # A request object representing the call parameters. Required.
238
+ # @param options [::Gapic::CallOptions]
239
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
240
+ #
241
+ # @yield [result, operation] Access the result along with the TransportOperation object
242
+ # @yieldparam result [::Google::Longrunning::Operation]
243
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
244
+ #
245
+ # @return [::Google::Longrunning::Operation]
246
+ # A result object deserialized from the server's reply
247
+ def delete_instance request_pb, options = nil
248
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
249
+
250
+ verb, uri, query_string_params, body = ServiceStub.transcode_delete_instance_request request_pb
251
+ query_string_params = if query_string_params.any?
252
+ query_string_params.to_h { |p| p.split("=", 2) }
253
+ else
254
+ {}
255
+ end
256
+
257
+ response = @client_stub.make_http_request(
258
+ verb,
259
+ uri: uri,
260
+ body: body || "",
261
+ params: query_string_params,
262
+ options: options
263
+ )
264
+ operation = ::Gapic::Rest::TransportOperation.new response
265
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
266
+
267
+ yield result, operation if block_given?
268
+ result
269
+ end
270
+
271
+ ##
272
+ # Baseline implementation for the list_snapshots REST call
273
+ #
274
+ # @param request_pb [::Google::Cloud::Filestore::V1::ListSnapshotsRequest]
275
+ # A request object representing the call parameters. Required.
276
+ # @param options [::Gapic::CallOptions]
277
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
278
+ #
279
+ # @yield [result, operation] Access the result along with the TransportOperation object
280
+ # @yieldparam result [::Google::Cloud::Filestore::V1::ListSnapshotsResponse]
281
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
282
+ #
283
+ # @return [::Google::Cloud::Filestore::V1::ListSnapshotsResponse]
284
+ # A result object deserialized from the server's reply
285
+ def list_snapshots request_pb, options = nil
286
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
287
+
288
+ verb, uri, query_string_params, body = ServiceStub.transcode_list_snapshots_request request_pb
289
+ query_string_params = if query_string_params.any?
290
+ query_string_params.to_h { |p| p.split("=", 2) }
291
+ else
292
+ {}
293
+ end
294
+
295
+ response = @client_stub.make_http_request(
296
+ verb,
297
+ uri: uri,
298
+ body: body || "",
299
+ params: query_string_params,
300
+ options: options
301
+ )
302
+ operation = ::Gapic::Rest::TransportOperation.new response
303
+ result = ::Google::Cloud::Filestore::V1::ListSnapshotsResponse.decode_json response.body, ignore_unknown_fields: true
304
+
305
+ yield result, operation if block_given?
306
+ result
307
+ end
308
+
309
+ ##
310
+ # Baseline implementation for the get_snapshot REST call
311
+ #
312
+ # @param request_pb [::Google::Cloud::Filestore::V1::GetSnapshotRequest]
313
+ # A request object representing the call parameters. Required.
314
+ # @param options [::Gapic::CallOptions]
315
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
316
+ #
317
+ # @yield [result, operation] Access the result along with the TransportOperation object
318
+ # @yieldparam result [::Google::Cloud::Filestore::V1::Snapshot]
319
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
320
+ #
321
+ # @return [::Google::Cloud::Filestore::V1::Snapshot]
322
+ # A result object deserialized from the server's reply
323
+ def get_snapshot request_pb, options = nil
324
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
325
+
326
+ verb, uri, query_string_params, body = ServiceStub.transcode_get_snapshot_request request_pb
327
+ query_string_params = if query_string_params.any?
328
+ query_string_params.to_h { |p| p.split("=", 2) }
329
+ else
330
+ {}
331
+ end
332
+
333
+ response = @client_stub.make_http_request(
334
+ verb,
335
+ uri: uri,
336
+ body: body || "",
337
+ params: query_string_params,
338
+ options: options
339
+ )
340
+ operation = ::Gapic::Rest::TransportOperation.new response
341
+ result = ::Google::Cloud::Filestore::V1::Snapshot.decode_json response.body, ignore_unknown_fields: true
342
+
343
+ yield result, operation if block_given?
344
+ result
345
+ end
346
+
347
+ ##
348
+ # Baseline implementation for the create_snapshot REST call
349
+ #
350
+ # @param request_pb [::Google::Cloud::Filestore::V1::CreateSnapshotRequest]
351
+ # A request object representing the call parameters. Required.
352
+ # @param options [::Gapic::CallOptions]
353
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
354
+ #
355
+ # @yield [result, operation] Access the result along with the TransportOperation object
356
+ # @yieldparam result [::Google::Longrunning::Operation]
357
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
358
+ #
359
+ # @return [::Google::Longrunning::Operation]
360
+ # A result object deserialized from the server's reply
361
+ def create_snapshot request_pb, options = nil
362
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
363
+
364
+ verb, uri, query_string_params, body = ServiceStub.transcode_create_snapshot_request request_pb
365
+ query_string_params = if query_string_params.any?
366
+ query_string_params.to_h { |p| p.split("=", 2) }
367
+ else
368
+ {}
369
+ end
370
+
371
+ response = @client_stub.make_http_request(
372
+ verb,
373
+ uri: uri,
374
+ body: body || "",
375
+ params: query_string_params,
376
+ options: options
377
+ )
378
+ operation = ::Gapic::Rest::TransportOperation.new response
379
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
380
+
381
+ yield result, operation if block_given?
382
+ result
383
+ end
384
+
385
+ ##
386
+ # Baseline implementation for the delete_snapshot REST call
387
+ #
388
+ # @param request_pb [::Google::Cloud::Filestore::V1::DeleteSnapshotRequest]
389
+ # A request object representing the call parameters. Required.
390
+ # @param options [::Gapic::CallOptions]
391
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
392
+ #
393
+ # @yield [result, operation] Access the result along with the TransportOperation object
394
+ # @yieldparam result [::Google::Longrunning::Operation]
395
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
396
+ #
397
+ # @return [::Google::Longrunning::Operation]
398
+ # A result object deserialized from the server's reply
399
+ def delete_snapshot request_pb, options = nil
400
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
401
+
402
+ verb, uri, query_string_params, body = ServiceStub.transcode_delete_snapshot_request request_pb
403
+ query_string_params = if query_string_params.any?
404
+ query_string_params.to_h { |p| p.split("=", 2) }
405
+ else
406
+ {}
407
+ end
408
+
409
+ response = @client_stub.make_http_request(
410
+ verb,
411
+ uri: uri,
412
+ body: body || "",
413
+ params: query_string_params,
414
+ options: options
415
+ )
416
+ operation = ::Gapic::Rest::TransportOperation.new response
417
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
418
+
419
+ yield result, operation if block_given?
420
+ result
421
+ end
422
+
423
+ ##
424
+ # Baseline implementation for the update_snapshot REST call
425
+ #
426
+ # @param request_pb [::Google::Cloud::Filestore::V1::UpdateSnapshotRequest]
427
+ # A request object representing the call parameters. Required.
428
+ # @param options [::Gapic::CallOptions]
429
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
430
+ #
431
+ # @yield [result, operation] Access the result along with the TransportOperation object
432
+ # @yieldparam result [::Google::Longrunning::Operation]
433
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
434
+ #
435
+ # @return [::Google::Longrunning::Operation]
436
+ # A result object deserialized from the server's reply
437
+ def update_snapshot request_pb, options = nil
438
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
439
+
440
+ verb, uri, query_string_params, body = ServiceStub.transcode_update_snapshot_request request_pb
441
+ query_string_params = if query_string_params.any?
442
+ query_string_params.to_h { |p| p.split("=", 2) }
443
+ else
444
+ {}
445
+ end
446
+
447
+ response = @client_stub.make_http_request(
448
+ verb,
449
+ uri: uri,
450
+ body: body || "",
451
+ params: query_string_params,
452
+ options: options
453
+ )
454
+ operation = ::Gapic::Rest::TransportOperation.new response
455
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
456
+
457
+ yield result, operation if block_given?
458
+ result
459
+ end
460
+
461
+ ##
462
+ # Baseline implementation for the list_backups REST call
463
+ #
464
+ # @param request_pb [::Google::Cloud::Filestore::V1::ListBackupsRequest]
465
+ # A request object representing the call parameters. Required.
466
+ # @param options [::Gapic::CallOptions]
467
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
468
+ #
469
+ # @yield [result, operation] Access the result along with the TransportOperation object
470
+ # @yieldparam result [::Google::Cloud::Filestore::V1::ListBackupsResponse]
471
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
472
+ #
473
+ # @return [::Google::Cloud::Filestore::V1::ListBackupsResponse]
474
+ # A result object deserialized from the server's reply
475
+ def list_backups request_pb, options = nil
476
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
477
+
478
+ verb, uri, query_string_params, body = ServiceStub.transcode_list_backups_request request_pb
479
+ query_string_params = if query_string_params.any?
480
+ query_string_params.to_h { |p| p.split("=", 2) }
481
+ else
482
+ {}
483
+ end
484
+
485
+ response = @client_stub.make_http_request(
486
+ verb,
487
+ uri: uri,
488
+ body: body || "",
489
+ params: query_string_params,
490
+ options: options
491
+ )
492
+ operation = ::Gapic::Rest::TransportOperation.new response
493
+ result = ::Google::Cloud::Filestore::V1::ListBackupsResponse.decode_json response.body, ignore_unknown_fields: true
494
+
495
+ yield result, operation if block_given?
496
+ result
497
+ end
498
+
499
+ ##
500
+ # Baseline implementation for the get_backup REST call
501
+ #
502
+ # @param request_pb [::Google::Cloud::Filestore::V1::GetBackupRequest]
503
+ # A request object representing the call parameters. Required.
504
+ # @param options [::Gapic::CallOptions]
505
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
506
+ #
507
+ # @yield [result, operation] Access the result along with the TransportOperation object
508
+ # @yieldparam result [::Google::Cloud::Filestore::V1::Backup]
509
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
510
+ #
511
+ # @return [::Google::Cloud::Filestore::V1::Backup]
512
+ # A result object deserialized from the server's reply
513
+ def get_backup request_pb, options = nil
514
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
515
+
516
+ verb, uri, query_string_params, body = ServiceStub.transcode_get_backup_request request_pb
517
+ query_string_params = if query_string_params.any?
518
+ query_string_params.to_h { |p| p.split("=", 2) }
519
+ else
520
+ {}
521
+ end
522
+
523
+ response = @client_stub.make_http_request(
524
+ verb,
525
+ uri: uri,
526
+ body: body || "",
527
+ params: query_string_params,
528
+ options: options
529
+ )
530
+ operation = ::Gapic::Rest::TransportOperation.new response
531
+ result = ::Google::Cloud::Filestore::V1::Backup.decode_json response.body, ignore_unknown_fields: true
532
+
533
+ yield result, operation if block_given?
534
+ result
535
+ end
536
+
537
+ ##
538
+ # Baseline implementation for the create_backup REST call
539
+ #
540
+ # @param request_pb [::Google::Cloud::Filestore::V1::CreateBackupRequest]
541
+ # A request object representing the call parameters. Required.
542
+ # @param options [::Gapic::CallOptions]
543
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
544
+ #
545
+ # @yield [result, operation] Access the result along with the TransportOperation object
546
+ # @yieldparam result [::Google::Longrunning::Operation]
547
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
548
+ #
549
+ # @return [::Google::Longrunning::Operation]
550
+ # A result object deserialized from the server's reply
551
+ def create_backup request_pb, options = nil
552
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
553
+
554
+ verb, uri, query_string_params, body = ServiceStub.transcode_create_backup_request request_pb
555
+ query_string_params = if query_string_params.any?
556
+ query_string_params.to_h { |p| p.split("=", 2) }
557
+ else
558
+ {}
559
+ end
560
+
561
+ response = @client_stub.make_http_request(
562
+ verb,
563
+ uri: uri,
564
+ body: body || "",
565
+ params: query_string_params,
566
+ options: options
567
+ )
568
+ operation = ::Gapic::Rest::TransportOperation.new response
569
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
570
+
571
+ yield result, operation if block_given?
572
+ result
573
+ end
574
+
575
+ ##
576
+ # Baseline implementation for the delete_backup REST call
577
+ #
578
+ # @param request_pb [::Google::Cloud::Filestore::V1::DeleteBackupRequest]
579
+ # A request object representing the call parameters. Required.
580
+ # @param options [::Gapic::CallOptions]
581
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
582
+ #
583
+ # @yield [result, operation] Access the result along with the TransportOperation object
584
+ # @yieldparam result [::Google::Longrunning::Operation]
585
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
586
+ #
587
+ # @return [::Google::Longrunning::Operation]
588
+ # A result object deserialized from the server's reply
589
+ def delete_backup request_pb, options = nil
590
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
591
+
592
+ verb, uri, query_string_params, body = ServiceStub.transcode_delete_backup_request request_pb
593
+ query_string_params = if query_string_params.any?
594
+ query_string_params.to_h { |p| p.split("=", 2) }
595
+ else
596
+ {}
597
+ end
598
+
599
+ response = @client_stub.make_http_request(
600
+ verb,
601
+ uri: uri,
602
+ body: body || "",
603
+ params: query_string_params,
604
+ options: options
605
+ )
606
+ operation = ::Gapic::Rest::TransportOperation.new response
607
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
608
+
609
+ yield result, operation if block_given?
610
+ result
611
+ end
612
+
613
+ ##
614
+ # Baseline implementation for the update_backup REST call
615
+ #
616
+ # @param request_pb [::Google::Cloud::Filestore::V1::UpdateBackupRequest]
617
+ # A request object representing the call parameters. Required.
618
+ # @param options [::Gapic::CallOptions]
619
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
620
+ #
621
+ # @yield [result, operation] Access the result along with the TransportOperation object
622
+ # @yieldparam result [::Google::Longrunning::Operation]
623
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
624
+ #
625
+ # @return [::Google::Longrunning::Operation]
626
+ # A result object deserialized from the server's reply
627
+ def update_backup request_pb, options = nil
628
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
629
+
630
+ verb, uri, query_string_params, body = ServiceStub.transcode_update_backup_request request_pb
631
+ query_string_params = if query_string_params.any?
632
+ query_string_params.to_h { |p| p.split("=", 2) }
633
+ else
634
+ {}
635
+ end
636
+
637
+ response = @client_stub.make_http_request(
638
+ verb,
639
+ uri: uri,
640
+ body: body || "",
641
+ params: query_string_params,
642
+ options: options
643
+ )
644
+ operation = ::Gapic::Rest::TransportOperation.new response
645
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
646
+
647
+ yield result, operation if block_given?
648
+ result
649
+ end
650
+
651
+ ##
652
+ # @private
653
+ #
654
+ # GRPC transcoding helper method for the list_instances REST call
655
+ #
656
+ # @param request_pb [::Google::Cloud::Filestore::V1::ListInstancesRequest]
657
+ # A request object representing the call parameters. Required.
658
+ # @return [Array(String, [String, nil], Hash{String => String})]
659
+ # Uri, Body, Query string parameters
660
+ def self.transcode_list_instances_request request_pb
661
+ transcoder = Gapic::Rest::GrpcTranscoder.new
662
+ .with_bindings(
663
+ uri_method: :get,
664
+ uri_template: "/v1/{parent}/instances",
665
+ matches: [
666
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/?$}, false]
667
+ ]
668
+ )
669
+ transcoder.transcode request_pb
670
+ end
671
+
672
+ ##
673
+ # @private
674
+ #
675
+ # GRPC transcoding helper method for the get_instance REST call
676
+ #
677
+ # @param request_pb [::Google::Cloud::Filestore::V1::GetInstanceRequest]
678
+ # A request object representing the call parameters. Required.
679
+ # @return [Array(String, [String, nil], Hash{String => String})]
680
+ # Uri, Body, Query string parameters
681
+ def self.transcode_get_instance_request request_pb
682
+ transcoder = Gapic::Rest::GrpcTranscoder.new
683
+ .with_bindings(
684
+ uri_method: :get,
685
+ uri_template: "/v1/{name}",
686
+ matches: [
687
+ ["name", %r{^projects/[^/]+/locations/[^/]+/instances/[^/]+/?$}, false]
688
+ ]
689
+ )
690
+ transcoder.transcode request_pb
691
+ end
692
+
693
+ ##
694
+ # @private
695
+ #
696
+ # GRPC transcoding helper method for the create_instance REST call
697
+ #
698
+ # @param request_pb [::Google::Cloud::Filestore::V1::CreateInstanceRequest]
699
+ # A request object representing the call parameters. Required.
700
+ # @return [Array(String, [String, nil], Hash{String => String})]
701
+ # Uri, Body, Query string parameters
702
+ def self.transcode_create_instance_request request_pb
703
+ transcoder = Gapic::Rest::GrpcTranscoder.new
704
+ .with_bindings(
705
+ uri_method: :post,
706
+ uri_template: "/v1/{parent}/instances",
707
+ body: "instance",
708
+ matches: [
709
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/?$}, false]
710
+ ]
711
+ )
712
+ transcoder.transcode request_pb
713
+ end
714
+
715
+ ##
716
+ # @private
717
+ #
718
+ # GRPC transcoding helper method for the update_instance REST call
719
+ #
720
+ # @param request_pb [::Google::Cloud::Filestore::V1::UpdateInstanceRequest]
721
+ # A request object representing the call parameters. Required.
722
+ # @return [Array(String, [String, nil], Hash{String => String})]
723
+ # Uri, Body, Query string parameters
724
+ def self.transcode_update_instance_request request_pb
725
+ transcoder = Gapic::Rest::GrpcTranscoder.new
726
+ .with_bindings(
727
+ uri_method: :patch,
728
+ uri_template: "/v1/{instance.name}",
729
+ body: "instance",
730
+ matches: [
731
+ ["instance.name", %r{^projects/[^/]+/locations/[^/]+/instances/[^/]+/?$}, false]
732
+ ]
733
+ )
734
+ transcoder.transcode request_pb
735
+ end
736
+
737
+ ##
738
+ # @private
739
+ #
740
+ # GRPC transcoding helper method for the restore_instance REST call
741
+ #
742
+ # @param request_pb [::Google::Cloud::Filestore::V1::RestoreInstanceRequest]
743
+ # A request object representing the call parameters. Required.
744
+ # @return [Array(String, [String, nil], Hash{String => String})]
745
+ # Uri, Body, Query string parameters
746
+ def self.transcode_restore_instance_request request_pb
747
+ transcoder = Gapic::Rest::GrpcTranscoder.new
748
+ .with_bindings(
749
+ uri_method: :post,
750
+ uri_template: "/v1/{name}:restore",
751
+ body: "*",
752
+ matches: [
753
+ ["name", %r{^projects/[^/]+/locations/[^/]+/instances/[^/]+/?$}, false]
754
+ ]
755
+ )
756
+ transcoder.transcode request_pb
757
+ end
758
+
759
+ ##
760
+ # @private
761
+ #
762
+ # GRPC transcoding helper method for the delete_instance REST call
763
+ #
764
+ # @param request_pb [::Google::Cloud::Filestore::V1::DeleteInstanceRequest]
765
+ # A request object representing the call parameters. Required.
766
+ # @return [Array(String, [String, nil], Hash{String => String})]
767
+ # Uri, Body, Query string parameters
768
+ def self.transcode_delete_instance_request request_pb
769
+ transcoder = Gapic::Rest::GrpcTranscoder.new
770
+ .with_bindings(
771
+ uri_method: :delete,
772
+ uri_template: "/v1/{name}",
773
+ matches: [
774
+ ["name", %r{^projects/[^/]+/locations/[^/]+/instances/[^/]+/?$}, false]
775
+ ]
776
+ )
777
+ transcoder.transcode request_pb
778
+ end
779
+
780
+ ##
781
+ # @private
782
+ #
783
+ # GRPC transcoding helper method for the list_snapshots REST call
784
+ #
785
+ # @param request_pb [::Google::Cloud::Filestore::V1::ListSnapshotsRequest]
786
+ # A request object representing the call parameters. Required.
787
+ # @return [Array(String, [String, nil], Hash{String => String})]
788
+ # Uri, Body, Query string parameters
789
+ def self.transcode_list_snapshots_request request_pb
790
+ transcoder = Gapic::Rest::GrpcTranscoder.new
791
+ .with_bindings(
792
+ uri_method: :get,
793
+ uri_template: "/v1/{parent}/snapshots",
794
+ matches: [
795
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/instances/[^/]+/?$}, false]
796
+ ]
797
+ )
798
+ transcoder.transcode request_pb
799
+ end
800
+
801
+ ##
802
+ # @private
803
+ #
804
+ # GRPC transcoding helper method for the get_snapshot REST call
805
+ #
806
+ # @param request_pb [::Google::Cloud::Filestore::V1::GetSnapshotRequest]
807
+ # A request object representing the call parameters. Required.
808
+ # @return [Array(String, [String, nil], Hash{String => String})]
809
+ # Uri, Body, Query string parameters
810
+ def self.transcode_get_snapshot_request request_pb
811
+ transcoder = Gapic::Rest::GrpcTranscoder.new
812
+ .with_bindings(
813
+ uri_method: :get,
814
+ uri_template: "/v1/{name}",
815
+ matches: [
816
+ ["name", %r{^projects/[^/]+/locations/[^/]+/instances/[^/]+/snapshots/[^/]+/?$}, false]
817
+ ]
818
+ )
819
+ transcoder.transcode request_pb
820
+ end
821
+
822
+ ##
823
+ # @private
824
+ #
825
+ # GRPC transcoding helper method for the create_snapshot REST call
826
+ #
827
+ # @param request_pb [::Google::Cloud::Filestore::V1::CreateSnapshotRequest]
828
+ # A request object representing the call parameters. Required.
829
+ # @return [Array(String, [String, nil], Hash{String => String})]
830
+ # Uri, Body, Query string parameters
831
+ def self.transcode_create_snapshot_request request_pb
832
+ transcoder = Gapic::Rest::GrpcTranscoder.new
833
+ .with_bindings(
834
+ uri_method: :post,
835
+ uri_template: "/v1/{parent}/snapshots",
836
+ body: "snapshot",
837
+ matches: [
838
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/instances/[^/]+/?$}, false]
839
+ ]
840
+ )
841
+ transcoder.transcode request_pb
842
+ end
843
+
844
+ ##
845
+ # @private
846
+ #
847
+ # GRPC transcoding helper method for the delete_snapshot REST call
848
+ #
849
+ # @param request_pb [::Google::Cloud::Filestore::V1::DeleteSnapshotRequest]
850
+ # A request object representing the call parameters. Required.
851
+ # @return [Array(String, [String, nil], Hash{String => String})]
852
+ # Uri, Body, Query string parameters
853
+ def self.transcode_delete_snapshot_request request_pb
854
+ transcoder = Gapic::Rest::GrpcTranscoder.new
855
+ .with_bindings(
856
+ uri_method: :delete,
857
+ uri_template: "/v1/{name}",
858
+ matches: [
859
+ ["name", %r{^projects/[^/]+/locations/[^/]+/instances/[^/]+/snapshots/[^/]+/?$}, false]
860
+ ]
861
+ )
862
+ transcoder.transcode request_pb
863
+ end
864
+
865
+ ##
866
+ # @private
867
+ #
868
+ # GRPC transcoding helper method for the update_snapshot REST call
869
+ #
870
+ # @param request_pb [::Google::Cloud::Filestore::V1::UpdateSnapshotRequest]
871
+ # A request object representing the call parameters. Required.
872
+ # @return [Array(String, [String, nil], Hash{String => String})]
873
+ # Uri, Body, Query string parameters
874
+ def self.transcode_update_snapshot_request request_pb
875
+ transcoder = Gapic::Rest::GrpcTranscoder.new
876
+ .with_bindings(
877
+ uri_method: :patch,
878
+ uri_template: "/v1/{snapshot.name}",
879
+ body: "snapshot",
880
+ matches: [
881
+ ["snapshot.name", %r{^projects/[^/]+/locations/[^/]+/instances/[^/]+/snapshots/[^/]+/?$}, false]
882
+ ]
883
+ )
884
+ transcoder.transcode request_pb
885
+ end
886
+
887
+ ##
888
+ # @private
889
+ #
890
+ # GRPC transcoding helper method for the list_backups REST call
891
+ #
892
+ # @param request_pb [::Google::Cloud::Filestore::V1::ListBackupsRequest]
893
+ # A request object representing the call parameters. Required.
894
+ # @return [Array(String, [String, nil], Hash{String => String})]
895
+ # Uri, Body, Query string parameters
896
+ def self.transcode_list_backups_request request_pb
897
+ transcoder = Gapic::Rest::GrpcTranscoder.new
898
+ .with_bindings(
899
+ uri_method: :get,
900
+ uri_template: "/v1/{parent}/backups",
901
+ matches: [
902
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/?$}, false]
903
+ ]
904
+ )
905
+ transcoder.transcode request_pb
906
+ end
907
+
908
+ ##
909
+ # @private
910
+ #
911
+ # GRPC transcoding helper method for the get_backup REST call
912
+ #
913
+ # @param request_pb [::Google::Cloud::Filestore::V1::GetBackupRequest]
914
+ # A request object representing the call parameters. Required.
915
+ # @return [Array(String, [String, nil], Hash{String => String})]
916
+ # Uri, Body, Query string parameters
917
+ def self.transcode_get_backup_request request_pb
918
+ transcoder = Gapic::Rest::GrpcTranscoder.new
919
+ .with_bindings(
920
+ uri_method: :get,
921
+ uri_template: "/v1/{name}",
922
+ matches: [
923
+ ["name", %r{^projects/[^/]+/locations/[^/]+/backups/[^/]+/?$}, false]
924
+ ]
925
+ )
926
+ transcoder.transcode request_pb
927
+ end
928
+
929
+ ##
930
+ # @private
931
+ #
932
+ # GRPC transcoding helper method for the create_backup REST call
933
+ #
934
+ # @param request_pb [::Google::Cloud::Filestore::V1::CreateBackupRequest]
935
+ # A request object representing the call parameters. Required.
936
+ # @return [Array(String, [String, nil], Hash{String => String})]
937
+ # Uri, Body, Query string parameters
938
+ def self.transcode_create_backup_request request_pb
939
+ transcoder = Gapic::Rest::GrpcTranscoder.new
940
+ .with_bindings(
941
+ uri_method: :post,
942
+ uri_template: "/v1/{parent}/backups",
943
+ body: "backup",
944
+ matches: [
945
+ ["parent", %r{^projects/[^/]+/locations/[^/]+/?$}, false]
946
+ ]
947
+ )
948
+ transcoder.transcode request_pb
949
+ end
950
+
951
+ ##
952
+ # @private
953
+ #
954
+ # GRPC transcoding helper method for the delete_backup REST call
955
+ #
956
+ # @param request_pb [::Google::Cloud::Filestore::V1::DeleteBackupRequest]
957
+ # A request object representing the call parameters. Required.
958
+ # @return [Array(String, [String, nil], Hash{String => String})]
959
+ # Uri, Body, Query string parameters
960
+ def self.transcode_delete_backup_request request_pb
961
+ transcoder = Gapic::Rest::GrpcTranscoder.new
962
+ .with_bindings(
963
+ uri_method: :delete,
964
+ uri_template: "/v1/{name}",
965
+ matches: [
966
+ ["name", %r{^projects/[^/]+/locations/[^/]+/backups/[^/]+/?$}, false]
967
+ ]
968
+ )
969
+ transcoder.transcode request_pb
970
+ end
971
+
972
+ ##
973
+ # @private
974
+ #
975
+ # GRPC transcoding helper method for the update_backup REST call
976
+ #
977
+ # @param request_pb [::Google::Cloud::Filestore::V1::UpdateBackupRequest]
978
+ # A request object representing the call parameters. Required.
979
+ # @return [Array(String, [String, nil], Hash{String => String})]
980
+ # Uri, Body, Query string parameters
981
+ def self.transcode_update_backup_request request_pb
982
+ transcoder = Gapic::Rest::GrpcTranscoder.new
983
+ .with_bindings(
984
+ uri_method: :patch,
985
+ uri_template: "/v1/{backup.name}",
986
+ body: "backup",
987
+ matches: [
988
+ ["backup.name", %r{^projects/[^/]+/locations/[^/]+/backups/[^/]+/?$}, false]
989
+ ]
990
+ )
991
+ transcoder.transcode request_pb
992
+ end
993
+ end
994
+ end
995
+ end
996
+ end
997
+ end
998
+ end
999
+ end