google-cloud-netapp-v1 1.2.0 → 1.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.
@@ -314,15 +314,27 @@ module Google
314
314
  endpoint: @config.endpoint,
315
315
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
316
316
  universe_domain: @config.universe_domain,
317
- credentials: credentials
317
+ credentials: credentials,
318
+ logger: @config.logger
318
319
  )
319
320
 
321
+ @net_app_stub.logger(stub: true)&.info do |entry|
322
+ entry.set_system_name
323
+ entry.set_service
324
+ entry.message = "Created client for #{entry.service}"
325
+ entry.set_credentials_fields credentials
326
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
327
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
328
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
329
+ end
330
+
320
331
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
321
332
  config.credentials = credentials
322
333
  config.quota_project = @quota_project_id
323
334
  config.endpoint = @net_app_stub.endpoint
324
335
  config.universe_domain = @net_app_stub.universe_domain
325
336
  config.bindings_override = @config.bindings_override
337
+ config.logger = @net_app_stub.logger if config.respond_to? :logger=
326
338
  end
327
339
  end
328
340
 
@@ -340,6 +352,15 @@ module Google
340
352
  #
341
353
  attr_reader :location_client
342
354
 
355
+ ##
356
+ # The logger used for request/response debug logging.
357
+ #
358
+ # @return [Logger]
359
+ #
360
+ def logger
361
+ @net_app_stub.logger
362
+ end
363
+
343
364
  # Service calls
344
365
 
345
366
  ##
@@ -429,7 +450,6 @@ module Google
429
450
 
430
451
  @net_app_stub.list_storage_pools request, options do |result, operation|
431
452
  yield result, operation if block_given?
432
- return result
433
453
  end
434
454
  rescue ::Gapic::Rest::Error => e
435
455
  raise ::Google::Cloud::Error.from_error(e)
@@ -457,9 +477,9 @@ module Google
457
477
  # Required. Value for parent.
458
478
  # @param storage_pool_id [::String]
459
479
  # Required. Id of the requesting storage pool. Must be unique within the
460
- # parent resource. Must contain only letters, numbers, underscore and hyphen,
461
- # with the first character a letter or underscore, the last a letter or
462
- # underscore or a number, and a 63 character maximum.
480
+ # parent resource. Must contain only letters, numbers and hyphen, with the
481
+ # first character a letter, the last a letter or a number, and a 63 character
482
+ # maximum.
463
483
  # @param storage_pool [::Google::Cloud::NetApp::V1::StoragePool, ::Hash]
464
484
  # Required. The required parameters to create a new storage pool.
465
485
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -523,7 +543,7 @@ module Google
523
543
  @net_app_stub.create_storage_pool request, options do |result, operation|
524
544
  result = ::Gapic::Operation.new result, @operations_client, options: options
525
545
  yield result, operation if block_given?
526
- return result
546
+ throw :response, result
527
547
  end
528
548
  rescue ::Gapic::Rest::Error => e
529
549
  raise ::Google::Cloud::Error.from_error(e)
@@ -602,7 +622,6 @@ module Google
602
622
 
603
623
  @net_app_stub.get_storage_pool request, options do |result, operation|
604
624
  yield result, operation if block_given?
605
- return result
606
625
  end
607
626
  rescue ::Gapic::Rest::Error => e
608
627
  raise ::Google::Cloud::Error.from_error(e)
@@ -695,7 +714,7 @@ module Google
695
714
  @net_app_stub.update_storage_pool request, options do |result, operation|
696
715
  result = ::Gapic::Operation.new result, @operations_client, options: options
697
716
  yield result, operation if block_given?
698
- return result
717
+ throw :response, result
699
718
  end
700
719
  rescue ::Gapic::Rest::Error => e
701
720
  raise ::Google::Cloud::Error.from_error(e)
@@ -782,7 +801,7 @@ module Google
782
801
  @net_app_stub.delete_storage_pool request, options do |result, operation|
783
802
  result = ::Gapic::Operation.new result, @operations_client, options: options
784
803
  yield result, operation if block_given?
785
- return result
804
+ throw :response, result
786
805
  end
787
806
  rescue ::Gapic::Rest::Error => e
788
807
  raise ::Google::Cloud::Error.from_error(e)
@@ -870,7 +889,7 @@ module Google
870
889
  @net_app_stub.switch_active_replica_zone request, options do |result, operation|
871
890
  result = ::Gapic::Operation.new result, @operations_client, options: options
872
891
  yield result, operation if block_given?
873
- return result
892
+ throw :response, result
874
893
  end
875
894
  rescue ::Gapic::Rest::Error => e
876
895
  raise ::Google::Cloud::Error.from_error(e)
@@ -962,7 +981,6 @@ module Google
962
981
 
963
982
  @net_app_stub.list_volumes request, options do |result, operation|
964
983
  yield result, operation if block_given?
965
- return result
966
984
  end
967
985
  rescue ::Gapic::Rest::Error => e
968
986
  raise ::Google::Cloud::Error.from_error(e)
@@ -1041,7 +1059,6 @@ module Google
1041
1059
 
1042
1060
  @net_app_stub.get_volume request, options do |result, operation|
1043
1061
  yield result, operation if block_given?
1044
- return result
1045
1062
  end
1046
1063
  rescue ::Gapic::Rest::Error => e
1047
1064
  raise ::Google::Cloud::Error.from_error(e)
@@ -1069,9 +1086,9 @@ module Google
1069
1086
  # Required. Value for parent.
1070
1087
  # @param volume_id [::String]
1071
1088
  # Required. Id of the requesting volume. Must be unique within the parent
1072
- # resource. Must contain only letters, numbers, underscore and hyphen, with
1073
- # the first character a letter or underscore, the last a letter or underscore
1074
- # or a number, and a 63 character maximum.
1089
+ # resource. Must contain only letters, numbers and hyphen, with the first
1090
+ # character a letter, the last a letter or a number,
1091
+ # and a 63 character maximum.
1075
1092
  # @param volume [::Google::Cloud::NetApp::V1::Volume, ::Hash]
1076
1093
  # Required. The volume being created.
1077
1094
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -1135,7 +1152,7 @@ module Google
1135
1152
  @net_app_stub.create_volume request, options do |result, operation|
1136
1153
  result = ::Gapic::Operation.new result, @operations_client, options: options
1137
1154
  yield result, operation if block_given?
1138
- return result
1155
+ throw :response, result
1139
1156
  end
1140
1157
  rescue ::Gapic::Rest::Error => e
1141
1158
  raise ::Google::Cloud::Error.from_error(e)
@@ -1228,7 +1245,7 @@ module Google
1228
1245
  @net_app_stub.update_volume request, options do |result, operation|
1229
1246
  result = ::Gapic::Operation.new result, @operations_client, options: options
1230
1247
  yield result, operation if block_given?
1231
- return result
1248
+ throw :response, result
1232
1249
  end
1233
1250
  rescue ::Gapic::Rest::Error => e
1234
1251
  raise ::Google::Cloud::Error.from_error(e)
@@ -1319,7 +1336,7 @@ module Google
1319
1336
  @net_app_stub.delete_volume request, options do |result, operation|
1320
1337
  result = ::Gapic::Operation.new result, @operations_client, options: options
1321
1338
  yield result, operation if block_given?
1322
- return result
1339
+ throw :response, result
1323
1340
  end
1324
1341
  rescue ::Gapic::Rest::Error => e
1325
1342
  raise ::Google::Cloud::Error.from_error(e)
@@ -1413,7 +1430,7 @@ module Google
1413
1430
  @net_app_stub.revert_volume request, options do |result, operation|
1414
1431
  result = ::Gapic::Operation.new result, @operations_client, options: options
1415
1432
  yield result, operation if block_given?
1416
- return result
1433
+ throw :response, result
1417
1434
  end
1418
1435
  rescue ::Gapic::Rest::Error => e
1419
1436
  raise ::Google::Cloud::Error.from_error(e)
@@ -1507,7 +1524,6 @@ module Google
1507
1524
 
1508
1525
  @net_app_stub.list_snapshots request, options do |result, operation|
1509
1526
  yield result, operation if block_given?
1510
- return result
1511
1527
  end
1512
1528
  rescue ::Gapic::Rest::Error => e
1513
1529
  raise ::Google::Cloud::Error.from_error(e)
@@ -1587,7 +1603,6 @@ module Google
1587
1603
 
1588
1604
  @net_app_stub.get_snapshot request, options do |result, operation|
1589
1605
  yield result, operation if block_given?
1590
- return result
1591
1606
  end
1592
1607
  rescue ::Gapic::Rest::Error => e
1593
1608
  raise ::Google::Cloud::Error.from_error(e)
@@ -1618,9 +1633,9 @@ module Google
1618
1633
  # Required. A snapshot resource
1619
1634
  # @param snapshot_id [::String]
1620
1635
  # Required. ID of the snapshot to create. Must be unique within the parent
1621
- # resource. Must contain only letters, numbers, underscore and hyphen, with
1622
- # the first character a letter or underscore, the last a letter or underscore
1623
- # or a number, and a 63 character maximum.
1636
+ # resource. Must contain only letters, numbers and hyphen, with the first
1637
+ # character a letter, the last a letter or a
1638
+ # number, and a 63 character maximum.
1624
1639
  # @yield [result, operation] Access the result along with the TransportOperation object
1625
1640
  # @yieldparam result [::Gapic::Operation]
1626
1641
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -1682,7 +1697,7 @@ module Google
1682
1697
  @net_app_stub.create_snapshot request, options do |result, operation|
1683
1698
  result = ::Gapic::Operation.new result, @operations_client, options: options
1684
1699
  yield result, operation if block_given?
1685
- return result
1700
+ throw :response, result
1686
1701
  end
1687
1702
  rescue ::Gapic::Rest::Error => e
1688
1703
  raise ::Google::Cloud::Error.from_error(e)
@@ -1770,7 +1785,7 @@ module Google
1770
1785
  @net_app_stub.delete_snapshot request, options do |result, operation|
1771
1786
  result = ::Gapic::Operation.new result, @operations_client, options: options
1772
1787
  yield result, operation if block_given?
1773
- return result
1788
+ throw :response, result
1774
1789
  end
1775
1790
  rescue ::Gapic::Rest::Error => e
1776
1791
  raise ::Google::Cloud::Error.from_error(e)
@@ -1860,7 +1875,7 @@ module Google
1860
1875
  @net_app_stub.update_snapshot request, options do |result, operation|
1861
1876
  result = ::Gapic::Operation.new result, @operations_client, options: options
1862
1877
  yield result, operation if block_given?
1863
- return result
1878
+ throw :response, result
1864
1879
  end
1865
1880
  rescue ::Gapic::Rest::Error => e
1866
1881
  raise ::Google::Cloud::Error.from_error(e)
@@ -1952,7 +1967,6 @@ module Google
1952
1967
 
1953
1968
  @net_app_stub.list_active_directories request, options do |result, operation|
1954
1969
  yield result, operation if block_given?
1955
- return result
1956
1970
  end
1957
1971
  rescue ::Gapic::Rest::Error => e
1958
1972
  raise ::Google::Cloud::Error.from_error(e)
@@ -2031,7 +2045,6 @@ module Google
2031
2045
 
2032
2046
  @net_app_stub.get_active_directory request, options do |result, operation|
2033
2047
  yield result, operation if block_given?
2034
- return result
2035
2048
  end
2036
2049
  rescue ::Gapic::Rest::Error => e
2037
2050
  raise ::Google::Cloud::Error.from_error(e)
@@ -2062,9 +2075,9 @@ module Google
2062
2075
  # Required. Fields of the to be created active directory.
2063
2076
  # @param active_directory_id [::String]
2064
2077
  # Required. ID of the active directory to create. Must be unique within the
2065
- # parent resource. Must contain only letters, numbers, underscore and hyphen,
2066
- # with the first character a letter or underscore, the last a letter or
2067
- # underscore or a number, and a 63 character maximum.
2078
+ # parent resource. Must contain only letters, numbers and hyphen, with the
2079
+ # first character a letter , the last a letter or a number, and a 63
2080
+ # character maximum.
2068
2081
  # @yield [result, operation] Access the result along with the TransportOperation object
2069
2082
  # @yieldparam result [::Gapic::Operation]
2070
2083
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -2126,7 +2139,7 @@ module Google
2126
2139
  @net_app_stub.create_active_directory request, options do |result, operation|
2127
2140
  result = ::Gapic::Operation.new result, @operations_client, options: options
2128
2141
  yield result, operation if block_given?
2129
- return result
2142
+ throw :response, result
2130
2143
  end
2131
2144
  rescue ::Gapic::Rest::Error => e
2132
2145
  raise ::Google::Cloud::Error.from_error(e)
@@ -2219,7 +2232,7 @@ module Google
2219
2232
  @net_app_stub.update_active_directory request, options do |result, operation|
2220
2233
  result = ::Gapic::Operation.new result, @operations_client, options: options
2221
2234
  yield result, operation if block_given?
2222
- return result
2235
+ throw :response, result
2223
2236
  end
2224
2237
  rescue ::Gapic::Rest::Error => e
2225
2238
  raise ::Google::Cloud::Error.from_error(e)
@@ -2306,7 +2319,7 @@ module Google
2306
2319
  @net_app_stub.delete_active_directory request, options do |result, operation|
2307
2320
  result = ::Gapic::Operation.new result, @operations_client, options: options
2308
2321
  yield result, operation if block_given?
2309
- return result
2322
+ throw :response, result
2310
2323
  end
2311
2324
  rescue ::Gapic::Rest::Error => e
2312
2325
  raise ::Google::Cloud::Error.from_error(e)
@@ -2398,7 +2411,6 @@ module Google
2398
2411
 
2399
2412
  @net_app_stub.list_kms_configs request, options do |result, operation|
2400
2413
  yield result, operation if block_given?
2401
- return result
2402
2414
  end
2403
2415
  rescue ::Gapic::Rest::Error => e
2404
2416
  raise ::Google::Cloud::Error.from_error(e)
@@ -2426,9 +2438,9 @@ module Google
2426
2438
  # Required. Value for parent.
2427
2439
  # @param kms_config_id [::String]
2428
2440
  # Required. Id of the requesting KmsConfig. Must be unique within the parent
2429
- # resource. Must contain only letters, numbers, underscore and hyphen, with
2430
- # the first character a letter or underscore, the last a letter or underscore
2431
- # or a number, and a 63 character maximum.
2441
+ # resource. Must contain only letters, numbers and hyphen, with the first
2442
+ # character a letter, the last a letter or a
2443
+ # number, and a 63 character maximum.
2432
2444
  # @param kms_config [::Google::Cloud::NetApp::V1::KmsConfig, ::Hash]
2433
2445
  # Required. The required parameters to create a new KmsConfig.
2434
2446
  # @yield [result, operation] Access the result along with the TransportOperation object
@@ -2492,7 +2504,7 @@ module Google
2492
2504
  @net_app_stub.create_kms_config request, options do |result, operation|
2493
2505
  result = ::Gapic::Operation.new result, @operations_client, options: options
2494
2506
  yield result, operation if block_given?
2495
- return result
2507
+ throw :response, result
2496
2508
  end
2497
2509
  rescue ::Gapic::Rest::Error => e
2498
2510
  raise ::Google::Cloud::Error.from_error(e)
@@ -2571,7 +2583,6 @@ module Google
2571
2583
 
2572
2584
  @net_app_stub.get_kms_config request, options do |result, operation|
2573
2585
  yield result, operation if block_given?
2574
- return result
2575
2586
  end
2576
2587
  rescue ::Gapic::Rest::Error => e
2577
2588
  raise ::Google::Cloud::Error.from_error(e)
@@ -2664,7 +2675,7 @@ module Google
2664
2675
  @net_app_stub.update_kms_config request, options do |result, operation|
2665
2676
  result = ::Gapic::Operation.new result, @operations_client, options: options
2666
2677
  yield result, operation if block_given?
2667
- return result
2678
+ throw :response, result
2668
2679
  end
2669
2680
  rescue ::Gapic::Rest::Error => e
2670
2681
  raise ::Google::Cloud::Error.from_error(e)
@@ -2752,7 +2763,7 @@ module Google
2752
2763
  @net_app_stub.encrypt_volumes request, options do |result, operation|
2753
2764
  result = ::Gapic::Operation.new result, @operations_client, options: options
2754
2765
  yield result, operation if block_given?
2755
- return result
2766
+ throw :response, result
2756
2767
  end
2757
2768
  rescue ::Gapic::Rest::Error => e
2758
2769
  raise ::Google::Cloud::Error.from_error(e)
@@ -2831,7 +2842,6 @@ module Google
2831
2842
 
2832
2843
  @net_app_stub.verify_kms_config request, options do |result, operation|
2833
2844
  yield result, operation if block_given?
2834
- return result
2835
2845
  end
2836
2846
  rescue ::Gapic::Rest::Error => e
2837
2847
  raise ::Google::Cloud::Error.from_error(e)
@@ -2918,7 +2928,7 @@ module Google
2918
2928
  @net_app_stub.delete_kms_config request, options do |result, operation|
2919
2929
  result = ::Gapic::Operation.new result, @operations_client, options: options
2920
2930
  yield result, operation if block_given?
2921
- return result
2931
+ throw :response, result
2922
2932
  end
2923
2933
  rescue ::Gapic::Rest::Error => e
2924
2934
  raise ::Google::Cloud::Error.from_error(e)
@@ -3012,7 +3022,6 @@ module Google
3012
3022
 
3013
3023
  @net_app_stub.list_replications request, options do |result, operation|
3014
3024
  yield result, operation if block_given?
3015
- return result
3016
3025
  end
3017
3026
  rescue ::Gapic::Rest::Error => e
3018
3027
  raise ::Google::Cloud::Error.from_error(e)
@@ -3092,7 +3101,6 @@ module Google
3092
3101
 
3093
3102
  @net_app_stub.get_replication request, options do |result, operation|
3094
3103
  yield result, operation if block_given?
3095
- return result
3096
3104
  end
3097
3105
  rescue ::Gapic::Rest::Error => e
3098
3106
  raise ::Google::Cloud::Error.from_error(e)
@@ -3123,9 +3131,9 @@ module Google
3123
3131
  # Required. A replication resource
3124
3132
  # @param replication_id [::String]
3125
3133
  # Required. ID of the replication to create. Must be unique within the parent
3126
- # resource. Must contain only letters, numbers, underscore and hyphen, with
3127
- # the first character a letter or underscore, the last a letter or underscore
3128
- # or a number, and a 63 character maximum.
3134
+ # resource. Must contain only letters, numbers and hyphen, with the first
3135
+ # character a letter, the last a letter or a
3136
+ # number, and a 63 character maximum.
3129
3137
  # @yield [result, operation] Access the result along with the TransportOperation object
3130
3138
  # @yieldparam result [::Gapic::Operation]
3131
3139
  # @yieldparam operation [::Gapic::Rest::TransportOperation]
@@ -3187,7 +3195,7 @@ module Google
3187
3195
  @net_app_stub.create_replication request, options do |result, operation|
3188
3196
  result = ::Gapic::Operation.new result, @operations_client, options: options
3189
3197
  yield result, operation if block_given?
3190
- return result
3198
+ throw :response, result
3191
3199
  end
3192
3200
  rescue ::Gapic::Rest::Error => e
3193
3201
  raise ::Google::Cloud::Error.from_error(e)
@@ -3275,7 +3283,7 @@ module Google
3275
3283
  @net_app_stub.delete_replication request, options do |result, operation|
3276
3284
  result = ::Gapic::Operation.new result, @operations_client, options: options
3277
3285
  yield result, operation if block_given?
3278
- return result
3286
+ throw :response, result
3279
3287
  end
3280
3288
  rescue ::Gapic::Rest::Error => e
3281
3289
  raise ::Google::Cloud::Error.from_error(e)
@@ -3365,7 +3373,7 @@ module Google
3365
3373
  @net_app_stub.update_replication request, options do |result, operation|
3366
3374
  result = ::Gapic::Operation.new result, @operations_client, options: options
3367
3375
  yield result, operation if block_given?
3368
- return result
3376
+ throw :response, result
3369
3377
  end
3370
3378
  rescue ::Gapic::Rest::Error => e
3371
3379
  raise ::Google::Cloud::Error.from_error(e)
@@ -3460,7 +3468,7 @@ module Google
3460
3468
  @net_app_stub.stop_replication request, options do |result, operation|
3461
3469
  result = ::Gapic::Operation.new result, @operations_client, options: options
3462
3470
  yield result, operation if block_given?
3463
- return result
3471
+ throw :response, result
3464
3472
  end
3465
3473
  rescue ::Gapic::Rest::Error => e
3466
3474
  raise ::Google::Cloud::Error.from_error(e)
@@ -3548,7 +3556,7 @@ module Google
3548
3556
  @net_app_stub.resume_replication request, options do |result, operation|
3549
3557
  result = ::Gapic::Operation.new result, @operations_client, options: options
3550
3558
  yield result, operation if block_given?
3551
- return result
3559
+ throw :response, result
3552
3560
  end
3553
3561
  rescue ::Gapic::Rest::Error => e
3554
3562
  raise ::Google::Cloud::Error.from_error(e)
@@ -3637,7 +3645,195 @@ module Google
3637
3645
  @net_app_stub.reverse_replication_direction request, options do |result, operation|
3638
3646
  result = ::Gapic::Operation.new result, @operations_client, options: options
3639
3647
  yield result, operation if block_given?
3640
- return result
3648
+ throw :response, result
3649
+ end
3650
+ rescue ::Gapic::Rest::Error => e
3651
+ raise ::Google::Cloud::Error.from_error(e)
3652
+ end
3653
+
3654
+ ##
3655
+ # Establish replication peering.
3656
+ #
3657
+ # @overload establish_peering(request, options = nil)
3658
+ # Pass arguments to `establish_peering` via a request object, either of type
3659
+ # {::Google::Cloud::NetApp::V1::EstablishPeeringRequest} or an equivalent Hash.
3660
+ #
3661
+ # @param request [::Google::Cloud::NetApp::V1::EstablishPeeringRequest, ::Hash]
3662
+ # A request object representing the call parameters. Required. To specify no
3663
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3664
+ # @param options [::Gapic::CallOptions, ::Hash]
3665
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
3666
+ #
3667
+ # @overload establish_peering(name: nil, peer_cluster_name: nil, peer_svm_name: nil, peer_ip_addresses: nil, peer_volume_name: nil)
3668
+ # Pass arguments to `establish_peering` via keyword arguments. Note that at
3669
+ # least one keyword argument is required. To specify no parameters, or to keep all
3670
+ # the default parameter values, pass an empty Hash as a request object (see above).
3671
+ #
3672
+ # @param name [::String]
3673
+ # Required. The resource name of the replication, in the format of
3674
+ # projects/\\{project_id}/locations/\\{location}/volumes/\\{volume_id}/replications/\\{replication_id}.
3675
+ # @param peer_cluster_name [::String]
3676
+ # Required. Name of the user's local source cluster to be peered with the
3677
+ # destination cluster.
3678
+ # @param peer_svm_name [::String]
3679
+ # Required. Name of the user's local source vserver svm to be peered with the
3680
+ # destination vserver svm.
3681
+ # @param peer_ip_addresses [::Array<::String>]
3682
+ # Optional. List of IPv4 ip addresses to be used for peering.
3683
+ # @param peer_volume_name [::String]
3684
+ # Required. Name of the user's local source volume to be peered with the
3685
+ # destination volume.
3686
+ # @yield [result, operation] Access the result along with the TransportOperation object
3687
+ # @yieldparam result [::Gapic::Operation]
3688
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
3689
+ #
3690
+ # @return [::Gapic::Operation]
3691
+ #
3692
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
3693
+ #
3694
+ # @example Basic example
3695
+ # require "google/cloud/netapp/v1"
3696
+ #
3697
+ # # Create a client object. The client can be reused for multiple calls.
3698
+ # client = Google::Cloud::NetApp::V1::NetApp::Rest::Client.new
3699
+ #
3700
+ # # Create a request. To set request fields, pass in keyword arguments.
3701
+ # request = Google::Cloud::NetApp::V1::EstablishPeeringRequest.new
3702
+ #
3703
+ # # Call the establish_peering method.
3704
+ # result = client.establish_peering request
3705
+ #
3706
+ # # The returned object is of type Gapic::Operation. You can use it to
3707
+ # # check the status of an operation, cancel it, or wait for results.
3708
+ # # Here is how to wait for a response.
3709
+ # result.wait_until_done! timeout: 60
3710
+ # if result.response?
3711
+ # p result.response
3712
+ # else
3713
+ # puts "No response received."
3714
+ # end
3715
+ #
3716
+ def establish_peering request, options = nil
3717
+ raise ::ArgumentError, "request must be provided" if request.nil?
3718
+
3719
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::EstablishPeeringRequest
3720
+
3721
+ # Converts hash and nil to an options object
3722
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3723
+
3724
+ # Customize the options with defaults
3725
+ call_metadata = @config.rpcs.establish_peering.metadata.to_h
3726
+
3727
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3728
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3729
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3730
+ gapic_version: ::Google::Cloud::NetApp::V1::VERSION,
3731
+ transports_version_send: [:rest]
3732
+
3733
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3734
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3735
+
3736
+ options.apply_defaults timeout: @config.rpcs.establish_peering.timeout,
3737
+ metadata: call_metadata,
3738
+ retry_policy: @config.rpcs.establish_peering.retry_policy
3739
+
3740
+ options.apply_defaults timeout: @config.timeout,
3741
+ metadata: @config.metadata,
3742
+ retry_policy: @config.retry_policy
3743
+
3744
+ @net_app_stub.establish_peering request, options do |result, operation|
3745
+ result = ::Gapic::Operation.new result, @operations_client, options: options
3746
+ yield result, operation if block_given?
3747
+ throw :response, result
3748
+ end
3749
+ rescue ::Gapic::Rest::Error => e
3750
+ raise ::Google::Cloud::Error.from_error(e)
3751
+ end
3752
+
3753
+ ##
3754
+ # Syncs the replication. This will invoke one time volume data transfer from
3755
+ # source to destination.
3756
+ #
3757
+ # @overload sync_replication(request, options = nil)
3758
+ # Pass arguments to `sync_replication` via a request object, either of type
3759
+ # {::Google::Cloud::NetApp::V1::SyncReplicationRequest} or an equivalent Hash.
3760
+ #
3761
+ # @param request [::Google::Cloud::NetApp::V1::SyncReplicationRequest, ::Hash]
3762
+ # A request object representing the call parameters. Required. To specify no
3763
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3764
+ # @param options [::Gapic::CallOptions, ::Hash]
3765
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
3766
+ #
3767
+ # @overload sync_replication(name: nil)
3768
+ # Pass arguments to `sync_replication` via keyword arguments. Note that at
3769
+ # least one keyword argument is required. To specify no parameters, or to keep all
3770
+ # the default parameter values, pass an empty Hash as a request object (see above).
3771
+ #
3772
+ # @param name [::String]
3773
+ # Required. The resource name of the replication, in the format of
3774
+ # projects/\\{project_id}/locations/\\{location}/volumes/\\{volume_id}/replications/\\{replication_id}.
3775
+ # @yield [result, operation] Access the result along with the TransportOperation object
3776
+ # @yieldparam result [::Gapic::Operation]
3777
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
3778
+ #
3779
+ # @return [::Gapic::Operation]
3780
+ #
3781
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
3782
+ #
3783
+ # @example Basic example
3784
+ # require "google/cloud/netapp/v1"
3785
+ #
3786
+ # # Create a client object. The client can be reused for multiple calls.
3787
+ # client = Google::Cloud::NetApp::V1::NetApp::Rest::Client.new
3788
+ #
3789
+ # # Create a request. To set request fields, pass in keyword arguments.
3790
+ # request = Google::Cloud::NetApp::V1::SyncReplicationRequest.new
3791
+ #
3792
+ # # Call the sync_replication method.
3793
+ # result = client.sync_replication request
3794
+ #
3795
+ # # The returned object is of type Gapic::Operation. You can use it to
3796
+ # # check the status of an operation, cancel it, or wait for results.
3797
+ # # Here is how to wait for a response.
3798
+ # result.wait_until_done! timeout: 60
3799
+ # if result.response?
3800
+ # p result.response
3801
+ # else
3802
+ # puts "No response received."
3803
+ # end
3804
+ #
3805
+ def sync_replication request, options = nil
3806
+ raise ::ArgumentError, "request must be provided" if request.nil?
3807
+
3808
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::NetApp::V1::SyncReplicationRequest
3809
+
3810
+ # Converts hash and nil to an options object
3811
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3812
+
3813
+ # Customize the options with defaults
3814
+ call_metadata = @config.rpcs.sync_replication.metadata.to_h
3815
+
3816
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3817
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3818
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3819
+ gapic_version: ::Google::Cloud::NetApp::V1::VERSION,
3820
+ transports_version_send: [:rest]
3821
+
3822
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3823
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3824
+
3825
+ options.apply_defaults timeout: @config.rpcs.sync_replication.timeout,
3826
+ metadata: call_metadata,
3827
+ retry_policy: @config.rpcs.sync_replication.retry_policy
3828
+
3829
+ options.apply_defaults timeout: @config.timeout,
3830
+ metadata: @config.metadata,
3831
+ retry_policy: @config.retry_policy
3832
+
3833
+ @net_app_stub.sync_replication request, options do |result, operation|
3834
+ result = ::Gapic::Operation.new result, @operations_client, options: options
3835
+ yield result, operation if block_given?
3836
+ throw :response, result
3641
3837
  end
3642
3838
  rescue ::Gapic::Rest::Error => e
3643
3839
  raise ::Google::Cloud::Error.from_error(e)
@@ -3667,8 +3863,8 @@ module Google
3667
3863
  # @param backup_vault_id [::String]
3668
3864
  # Required. The ID to use for the backupVault.
3669
3865
  # The ID must be unique within the specified location.
3670
- # Must contain only letters, numbers, underscore and hyphen, with the first
3671
- # character a letter or underscore, the last a letter or underscore or a
3866
+ # Must contain only letters, numbers and hyphen, with the first
3867
+ # character a letter, the last a letter or a
3672
3868
  # number, and a 63 character maximum.
3673
3869
  # @param backup_vault [::Google::Cloud::NetApp::V1::BackupVault, ::Hash]
3674
3870
  # Required. A backupVault resource
@@ -3733,7 +3929,7 @@ module Google
3733
3929
  @net_app_stub.create_backup_vault request, options do |result, operation|
3734
3930
  result = ::Gapic::Operation.new result, @operations_client, options: options
3735
3931
  yield result, operation if block_given?
3736
- return result
3932
+ throw :response, result
3737
3933
  end
3738
3934
  rescue ::Gapic::Rest::Error => e
3739
3935
  raise ::Google::Cloud::Error.from_error(e)
@@ -3813,7 +4009,6 @@ module Google
3813
4009
 
3814
4010
  @net_app_stub.get_backup_vault request, options do |result, operation|
3815
4011
  yield result, operation if block_given?
3816
- return result
3817
4012
  end
3818
4013
  rescue ::Gapic::Rest::Error => e
3819
4014
  raise ::Google::Cloud::Error.from_error(e)
@@ -3907,7 +4102,6 @@ module Google
3907
4102
 
3908
4103
  @net_app_stub.list_backup_vaults request, options do |result, operation|
3909
4104
  yield result, operation if block_given?
3910
- return result
3911
4105
  end
3912
4106
  rescue ::Gapic::Rest::Error => e
3913
4107
  raise ::Google::Cloud::Error.from_error(e)
@@ -4000,7 +4194,7 @@ module Google
4000
4194
  @net_app_stub.update_backup_vault request, options do |result, operation|
4001
4195
  result = ::Gapic::Operation.new result, @operations_client, options: options
4002
4196
  yield result, operation if block_given?
4003
- return result
4197
+ throw :response, result
4004
4198
  end
4005
4199
  rescue ::Gapic::Rest::Error => e
4006
4200
  raise ::Google::Cloud::Error.from_error(e)
@@ -4088,7 +4282,7 @@ module Google
4088
4282
  @net_app_stub.delete_backup_vault request, options do |result, operation|
4089
4283
  result = ::Gapic::Operation.new result, @operations_client, options: options
4090
4284
  yield result, operation if block_given?
4091
- return result
4285
+ throw :response, result
4092
4286
  end
4093
4287
  rescue ::Gapic::Rest::Error => e
4094
4288
  raise ::Google::Cloud::Error.from_error(e)
@@ -4121,8 +4315,8 @@ module Google
4121
4315
  # @param backup_id [::String]
4122
4316
  # Required. The ID to use for the backup.
4123
4317
  # The ID must be unique within the specified backupVault.
4124
- # Must contain only letters, numbers, underscore and hyphen, with the first
4125
- # character a letter or underscore, the last a letter or underscore or a
4318
+ # Must contain only letters, numbers and hyphen, with the first
4319
+ # character a letter, the last a letter or a
4126
4320
  # number, and a 63 character maximum.
4127
4321
  # @param backup [::Google::Cloud::NetApp::V1::Backup, ::Hash]
4128
4322
  # Required. A backup resource
@@ -4187,7 +4381,7 @@ module Google
4187
4381
  @net_app_stub.create_backup request, options do |result, operation|
4188
4382
  result = ::Gapic::Operation.new result, @operations_client, options: options
4189
4383
  yield result, operation if block_given?
4190
- return result
4384
+ throw :response, result
4191
4385
  end
4192
4386
  rescue ::Gapic::Rest::Error => e
4193
4387
  raise ::Google::Cloud::Error.from_error(e)
@@ -4267,7 +4461,6 @@ module Google
4267
4461
 
4268
4462
  @net_app_stub.get_backup request, options do |result, operation|
4269
4463
  yield result, operation if block_given?
4270
- return result
4271
4464
  end
4272
4465
  rescue ::Gapic::Rest::Error => e
4273
4466
  raise ::Google::Cloud::Error.from_error(e)
@@ -4372,7 +4565,6 @@ module Google
4372
4565
 
4373
4566
  @net_app_stub.list_backups request, options do |result, operation|
4374
4567
  yield result, operation if block_given?
4375
- return result
4376
4568
  end
4377
4569
  rescue ::Gapic::Rest::Error => e
4378
4570
  raise ::Google::Cloud::Error.from_error(e)
@@ -4460,7 +4652,7 @@ module Google
4460
4652
  @net_app_stub.delete_backup request, options do |result, operation|
4461
4653
  result = ::Gapic::Operation.new result, @operations_client, options: options
4462
4654
  yield result, operation if block_given?
4463
- return result
4655
+ throw :response, result
4464
4656
  end
4465
4657
  rescue ::Gapic::Rest::Error => e
4466
4658
  raise ::Google::Cloud::Error.from_error(e)
@@ -4553,7 +4745,7 @@ module Google
4553
4745
  @net_app_stub.update_backup request, options do |result, operation|
4554
4746
  result = ::Gapic::Operation.new result, @operations_client, options: options
4555
4747
  yield result, operation if block_given?
4556
- return result
4748
+ throw :response, result
4557
4749
  end
4558
4750
  rescue ::Gapic::Rest::Error => e
4559
4751
  raise ::Google::Cloud::Error.from_error(e)
@@ -4585,8 +4777,8 @@ module Google
4585
4777
  # @param backup_policy_id [::String]
4586
4778
  # Required. The ID to use for the backup policy.
4587
4779
  # The ID must be unique within the specified location.
4588
- # Must contain only letters, numbers, underscore and hyphen, with the first
4589
- # character a letter or underscore, the last a letter or underscore or a
4780
+ # Must contain only letters, numbers and hyphen, with the first
4781
+ # character a letter, the last a letter or a
4590
4782
  # number, and a 63 character maximum.
4591
4783
  # @yield [result, operation] Access the result along with the TransportOperation object
4592
4784
  # @yieldparam result [::Gapic::Operation]
@@ -4649,7 +4841,7 @@ module Google
4649
4841
  @net_app_stub.create_backup_policy request, options do |result, operation|
4650
4842
  result = ::Gapic::Operation.new result, @operations_client, options: options
4651
4843
  yield result, operation if block_given?
4652
- return result
4844
+ throw :response, result
4653
4845
  end
4654
4846
  rescue ::Gapic::Rest::Error => e
4655
4847
  raise ::Google::Cloud::Error.from_error(e)
@@ -4729,7 +4921,6 @@ module Google
4729
4921
 
4730
4922
  @net_app_stub.get_backup_policy request, options do |result, operation|
4731
4923
  yield result, operation if block_given?
4732
- return result
4733
4924
  end
4734
4925
  rescue ::Gapic::Rest::Error => e
4735
4926
  raise ::Google::Cloud::Error.from_error(e)
@@ -4821,7 +5012,6 @@ module Google
4821
5012
 
4822
5013
  @net_app_stub.list_backup_policies request, options do |result, operation|
4823
5014
  yield result, operation if block_given?
4824
- return result
4825
5015
  end
4826
5016
  rescue ::Gapic::Rest::Error => e
4827
5017
  raise ::Google::Cloud::Error.from_error(e)
@@ -4914,7 +5104,7 @@ module Google
4914
5104
  @net_app_stub.update_backup_policy request, options do |result, operation|
4915
5105
  result = ::Gapic::Operation.new result, @operations_client, options: options
4916
5106
  yield result, operation if block_given?
4917
- return result
5107
+ throw :response, result
4918
5108
  end
4919
5109
  rescue ::Gapic::Rest::Error => e
4920
5110
  raise ::Google::Cloud::Error.from_error(e)
@@ -5002,7 +5192,7 @@ module Google
5002
5192
  @net_app_stub.delete_backup_policy request, options do |result, operation|
5003
5193
  result = ::Gapic::Operation.new result, @operations_client, options: options
5004
5194
  yield result, operation if block_given?
5005
- return result
5195
+ throw :response, result
5006
5196
  end
5007
5197
  rescue ::Gapic::Rest::Error => e
5008
5198
  raise ::Google::Cloud::Error.from_error(e)
@@ -5082,6 +5272,11 @@ module Google
5082
5272
  # default endpoint URL. The default value of nil uses the environment
5083
5273
  # universe (usually the default "googleapis.com" universe).
5084
5274
  # @return [::String,nil]
5275
+ # @!attribute [rw] logger
5276
+ # A custom logger to use for request/response debug logging, or the value
5277
+ # `:default` (the default) to construct a default logger, or `nil` to
5278
+ # explicitly disable logging.
5279
+ # @return [::Logger,:default,nil]
5085
5280
  #
5086
5281
  class Configuration
5087
5282
  extend ::Gapic::Config
@@ -5110,6 +5305,7 @@ module Google
5110
5305
  # by the host service.
5111
5306
  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
5112
5307
  config_attr :bindings_override, {}, ::Hash, nil
5308
+ config_attr :logger, :default, ::Logger, nil, :default
5113
5309
 
5114
5310
  # @private
5115
5311
  def initialize parent_config = nil
@@ -5334,6 +5530,16 @@ module Google
5334
5530
  #
5335
5531
  attr_reader :reverse_replication_direction
5336
5532
  ##
5533
+ # RPC-specific configuration for `establish_peering`
5534
+ # @return [::Gapic::Config::Method]
5535
+ #
5536
+ attr_reader :establish_peering
5537
+ ##
5538
+ # RPC-specific configuration for `sync_replication`
5539
+ # @return [::Gapic::Config::Method]
5540
+ #
5541
+ attr_reader :sync_replication
5542
+ ##
5337
5543
  # RPC-specific configuration for `create_backup_vault`
5338
5544
  # @return [::Gapic::Config::Method]
5339
5545
  #
@@ -5485,6 +5691,10 @@ module Google
5485
5691
  @resume_replication = ::Gapic::Config::Method.new resume_replication_config
5486
5692
  reverse_replication_direction_config = parent_rpcs.reverse_replication_direction if parent_rpcs.respond_to? :reverse_replication_direction
5487
5693
  @reverse_replication_direction = ::Gapic::Config::Method.new reverse_replication_direction_config
5694
+ establish_peering_config = parent_rpcs.establish_peering if parent_rpcs.respond_to? :establish_peering
5695
+ @establish_peering = ::Gapic::Config::Method.new establish_peering_config
5696
+ sync_replication_config = parent_rpcs.sync_replication if parent_rpcs.respond_to? :sync_replication
5697
+ @sync_replication = ::Gapic::Config::Method.new sync_replication_config
5488
5698
  create_backup_vault_config = parent_rpcs.create_backup_vault if parent_rpcs.respond_to? :create_backup_vault
5489
5699
  @create_backup_vault = ::Gapic::Config::Method.new create_backup_vault_config
5490
5700
  get_backup_vault_config = parent_rpcs.get_backup_vault if parent_rpcs.respond_to? :get_backup_vault