google-cloud-cloud_dms-v1 1.0.1 → 1.1.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e2dcb5e1a88bd35d3aa45ea5d3fc1f4baee63181dfba6287c927eca135762832
4
- data.tar.gz: 801c5e61e10d69d0e4e4615fbdd12b26206579f409735c1e529509bbb828f7fe
3
+ metadata.gz: 3586167cd5b8d360a01b04e7590eff93c64349a6947be8da969d2a6cd9d9c071
4
+ data.tar.gz: 82efa6ddea4968679c24babb429a9771d3f08516fcf7a5b3e890b44ac4c6969b
5
5
  SHA512:
6
- metadata.gz: 48ef28a408761a35751deb50049ac802efa1480a2adfc86b07a098d89cc67efc0de1ff45b0bd80feec73dd845fb1e2009ee55bfcdc6963c628ef04a2e44d0351
7
- data.tar.gz: ec7f454d484f8e8756d310ecc25eb1326b56404adcff0d423809b6bec02ff5adaee928274cf97a83effcd5eab8befed2821d77f5697000aeacb9e522a1abb3c3
6
+ metadata.gz: 1f0fdb04e0d3ce29edc2aa3d5039bfe6ba27b9331123c45c67e03cd40798c46c14599d6328305346ab125c35aea6fa631705106a7abad3c679dedc9a61cbafdd
7
+ data.tar.gz: 37ea098b2fd8ecea666e7f2954e3ff771f75be6cddae340edcb96b38188ffb2affc530627a312cc4092c10a9b39149e41c76870e58336bf111484eea2a8aa538
data/README.md CHANGED
@@ -43,33 +43,43 @@ for class and method documentation.
43
43
  See also the [Product Documentation](https://cloud.google.com/database-migration/)
44
44
  for general usage information.
45
45
 
46
- ## Enabling Logging
47
-
48
- To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
49
- The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
51
- that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
52
- and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
-
54
- Configuring a Ruby stdlib logger:
46
+ ## Debug Logging
47
+
48
+ This library comes with opt-in Debug Logging that can help you troubleshoot
49
+ your application's integration with the API. When logging is activated, key
50
+ events such as requests and responses, along with data payloads and metadata
51
+ such as headers and client configuration, are logged to the standard error
52
+ stream.
53
+
54
+ **WARNING:** Client Library Debug Logging includes your data payloads in
55
+ plaintext, which could include sensitive data such as PII for yourself or your
56
+ customers, private keys, or other security data that could be compromising if
57
+ leaked. Always practice good data hygiene with your application logs, and follow
58
+ the principle of least access. Google also recommends that Client Library Debug
59
+ Logging be enabled only temporarily during active debugging, and not used
60
+ permanently in production.
61
+
62
+ To enable logging, set the environment variable `GOOGLE_SDK_RUBY_LOGGING_GEMS`
63
+ to the value `all`. Alternatively, you can set the value to a comma-delimited
64
+ list of client library gem names. This will select the default logging behavior,
65
+ which writes logs to the standard error stream. On a local workstation, this may
66
+ result in logs appearing on the console. When running on a Google Cloud hosting
67
+ service such as [Google Cloud Run](https://cloud.google.com/run), this generally
68
+ results in logs appearing alongside your application logs in the
69
+ [Google Cloud Logging](https://cloud.google.com/logging/) service.
70
+
71
+ You can customize logging by modifying the `logger` configuration when
72
+ constructing a client object. For example:
55
73
 
56
74
  ```ruby
75
+ require "google/cloud/cloud_dms/v1"
57
76
  require "logger"
58
77
 
59
- module MyLogger
60
- LOGGER = Logger.new $stderr, level: Logger::WARN
61
- def logger
62
- LOGGER
63
- end
64
- end
65
-
66
- # Define a gRPC module-level logger method before grpc/logconfig.rb loads.
67
- module GRPC
68
- extend MyLogger
78
+ client = ::Google::Cloud::CloudDMS::V1::DataMigrationService::Client.new do |config|
79
+ config.logger = Logger.new "my-app.log"
69
80
  end
70
81
  ```
71
82
 
72
-
73
83
  ## Google Cloud Samples
74
84
 
75
85
  To browse ready to use code samples check [Google Cloud Samples](https://cloud.google.com/docs/samples).
@@ -243,14 +243,26 @@ module Google
243
243
  universe_domain: @config.universe_domain,
244
244
  channel_args: @config.channel_args,
245
245
  interceptors: @config.interceptors,
246
- channel_pool_config: @config.channel_pool
246
+ channel_pool_config: @config.channel_pool,
247
+ logger: @config.logger
247
248
  )
248
249
 
250
+ @data_migration_service_stub.stub_logger&.info do |entry|
251
+ entry.set_system_name
252
+ entry.set_service
253
+ entry.message = "Created client for #{entry.service}"
254
+ entry.set_credentials_fields credentials
255
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
256
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
257
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
258
+ end
259
+
249
260
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
250
261
  config.credentials = credentials
251
262
  config.quota_project = @quota_project_id
252
263
  config.endpoint = @data_migration_service_stub.endpoint
253
264
  config.universe_domain = @data_migration_service_stub.universe_domain
265
+ config.logger = @data_migration_service_stub.logger if config.respond_to? :logger=
254
266
  end
255
267
 
256
268
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -258,6 +270,7 @@ module Google
258
270
  config.quota_project = @quota_project_id
259
271
  config.endpoint = @data_migration_service_stub.endpoint
260
272
  config.universe_domain = @data_migration_service_stub.universe_domain
273
+ config.logger = @data_migration_service_stub.logger if config.respond_to? :logger=
261
274
  end
262
275
  end
263
276
 
@@ -282,6 +295,15 @@ module Google
282
295
  #
283
296
  attr_reader :iam_policy_client
284
297
 
298
+ ##
299
+ # The logger used for request/response debug logging.
300
+ #
301
+ # @return [Logger]
302
+ #
303
+ def logger
304
+ @data_migration_service_stub.logger
305
+ end
306
+
285
307
  # Service calls
286
308
 
287
309
  ##
@@ -393,7 +415,7 @@ module Google
393
415
  @data_migration_service_stub.call_rpc :list_migration_jobs, request, options: options do |response, operation|
394
416
  response = ::Gapic::PagedEnumerable.new @data_migration_service_stub, :list_migration_jobs, request, response, operation, options
395
417
  yield response, operation if block_given?
396
- return response
418
+ throw :response, response
397
419
  end
398
420
  rescue ::GRPC::BadStatus => e
399
421
  raise ::Google::Cloud::Error.from_error(e)
@@ -479,7 +501,6 @@ module Google
479
501
 
480
502
  @data_migration_service_stub.call_rpc :get_migration_job, request, options: options do |response, operation|
481
503
  yield response, operation if block_given?
482
- return response
483
504
  end
484
505
  rescue ::GRPC::BadStatus => e
485
506
  raise ::Google::Cloud::Error.from_error(e)
@@ -587,7 +608,7 @@ module Google
587
608
  @data_migration_service_stub.call_rpc :create_migration_job, request, options: options do |response, operation|
588
609
  response = ::Gapic::Operation.new response, @operations_client, options: options
589
610
  yield response, operation if block_given?
590
- return response
611
+ throw :response, response
591
612
  end
592
613
  rescue ::GRPC::BadStatus => e
593
614
  raise ::Google::Cloud::Error.from_error(e)
@@ -692,7 +713,7 @@ module Google
692
713
  @data_migration_service_stub.call_rpc :update_migration_job, request, options: options do |response, operation|
693
714
  response = ::Gapic::Operation.new response, @operations_client, options: options
694
715
  yield response, operation if block_given?
695
- return response
716
+ throw :response, response
696
717
  end
697
718
  rescue ::GRPC::BadStatus => e
698
719
  raise ::Google::Cloud::Error.from_error(e)
@@ -798,7 +819,7 @@ module Google
798
819
  @data_migration_service_stub.call_rpc :delete_migration_job, request, options: options do |response, operation|
799
820
  response = ::Gapic::Operation.new response, @operations_client, options: options
800
821
  yield response, operation if block_given?
801
- return response
822
+ throw :response, response
802
823
  end
803
824
  rescue ::GRPC::BadStatus => e
804
825
  raise ::Google::Cloud::Error.from_error(e)
@@ -895,7 +916,7 @@ module Google
895
916
  @data_migration_service_stub.call_rpc :start_migration_job, request, options: options do |response, operation|
896
917
  response = ::Gapic::Operation.new response, @operations_client, options: options
897
918
  yield response, operation if block_given?
898
- return response
919
+ throw :response, response
899
920
  end
900
921
  rescue ::GRPC::BadStatus => e
901
922
  raise ::Google::Cloud::Error.from_error(e)
@@ -989,7 +1010,7 @@ module Google
989
1010
  @data_migration_service_stub.call_rpc :stop_migration_job, request, options: options do |response, operation|
990
1011
  response = ::Gapic::Operation.new response, @operations_client, options: options
991
1012
  yield response, operation if block_given?
992
- return response
1013
+ throw :response, response
993
1014
  end
994
1015
  rescue ::GRPC::BadStatus => e
995
1016
  raise ::Google::Cloud::Error.from_error(e)
@@ -1084,7 +1105,7 @@ module Google
1084
1105
  @data_migration_service_stub.call_rpc :resume_migration_job, request, options: options do |response, operation|
1085
1106
  response = ::Gapic::Operation.new response, @operations_client, options: options
1086
1107
  yield response, operation if block_given?
1087
- return response
1108
+ throw :response, response
1088
1109
  end
1089
1110
  rescue ::GRPC::BadStatus => e
1090
1111
  raise ::Google::Cloud::Error.from_error(e)
@@ -1179,7 +1200,7 @@ module Google
1179
1200
  @data_migration_service_stub.call_rpc :promote_migration_job, request, options: options do |response, operation|
1180
1201
  response = ::Gapic::Operation.new response, @operations_client, options: options
1181
1202
  yield response, operation if block_given?
1182
- return response
1203
+ throw :response, response
1183
1204
  end
1184
1205
  rescue ::GRPC::BadStatus => e
1185
1206
  raise ::Google::Cloud::Error.from_error(e)
@@ -1280,7 +1301,7 @@ module Google
1280
1301
  @data_migration_service_stub.call_rpc :verify_migration_job, request, options: options do |response, operation|
1281
1302
  response = ::Gapic::Operation.new response, @operations_client, options: options
1282
1303
  yield response, operation if block_given?
1283
- return response
1304
+ throw :response, response
1284
1305
  end
1285
1306
  rescue ::GRPC::BadStatus => e
1286
1307
  raise ::Google::Cloud::Error.from_error(e)
@@ -1379,7 +1400,7 @@ module Google
1379
1400
  @data_migration_service_stub.call_rpc :restart_migration_job, request, options: options do |response, operation|
1380
1401
  response = ::Gapic::Operation.new response, @operations_client, options: options
1381
1402
  yield response, operation if block_given?
1382
- return response
1403
+ throw :response, response
1383
1404
  end
1384
1405
  rescue ::GRPC::BadStatus => e
1385
1406
  raise ::Google::Cloud::Error.from_error(e)
@@ -1474,7 +1495,6 @@ module Google
1474
1495
 
1475
1496
  @data_migration_service_stub.call_rpc :generate_ssh_script, request, options: options do |response, operation|
1476
1497
  yield response, operation if block_given?
1477
- return response
1478
1498
  end
1479
1499
  rescue ::GRPC::BadStatus => e
1480
1500
  raise ::Google::Cloud::Error.from_error(e)
@@ -1575,7 +1595,6 @@ module Google
1575
1595
 
1576
1596
  @data_migration_service_stub.call_rpc :generate_tcp_proxy_script, request, options: options do |response, operation|
1577
1597
  yield response, operation if block_given?
1578
- return response
1579
1598
  end
1580
1599
  rescue ::GRPC::BadStatus => e
1581
1600
  raise ::Google::Cloud::Error.from_error(e)
@@ -1690,7 +1709,7 @@ module Google
1690
1709
  @data_migration_service_stub.call_rpc :list_connection_profiles, request, options: options do |response, operation|
1691
1710
  response = ::Gapic::PagedEnumerable.new @data_migration_service_stub, :list_connection_profiles, request, response, operation, options
1692
1711
  yield response, operation if block_given?
1693
- return response
1712
+ throw :response, response
1694
1713
  end
1695
1714
  rescue ::GRPC::BadStatus => e
1696
1715
  raise ::Google::Cloud::Error.from_error(e)
@@ -1776,7 +1795,6 @@ module Google
1776
1795
 
1777
1796
  @data_migration_service_stub.call_rpc :get_connection_profile, request, options: options do |response, operation|
1778
1797
  yield response, operation if block_given?
1779
- return response
1780
1798
  end
1781
1799
  rescue ::GRPC::BadStatus => e
1782
1800
  raise ::Google::Cloud::Error.from_error(e)
@@ -1890,7 +1908,7 @@ module Google
1890
1908
  @data_migration_service_stub.call_rpc :create_connection_profile, request, options: options do |response, operation|
1891
1909
  response = ::Gapic::Operation.new response, @operations_client, options: options
1892
1910
  yield response, operation if block_given?
1893
- return response
1911
+ throw :response, response
1894
1912
  end
1895
1913
  rescue ::GRPC::BadStatus => e
1896
1914
  raise ::Google::Cloud::Error.from_error(e)
@@ -2003,7 +2021,7 @@ module Google
2003
2021
  @data_migration_service_stub.call_rpc :update_connection_profile, request, options: options do |response, operation|
2004
2022
  response = ::Gapic::Operation.new response, @operations_client, options: options
2005
2023
  yield response, operation if block_given?
2006
- return response
2024
+ throw :response, response
2007
2025
  end
2008
2026
  rescue ::GRPC::BadStatus => e
2009
2027
  raise ::Google::Cloud::Error.from_error(e)
@@ -2110,7 +2128,7 @@ module Google
2110
2128
  @data_migration_service_stub.call_rpc :delete_connection_profile, request, options: options do |response, operation|
2111
2129
  response = ::Gapic::Operation.new response, @operations_client, options: options
2112
2130
  yield response, operation if block_given?
2113
- return response
2131
+ throw :response, response
2114
2132
  end
2115
2133
  rescue ::GRPC::BadStatus => e
2116
2134
  raise ::Google::Cloud::Error.from_error(e)
@@ -2218,7 +2236,7 @@ module Google
2218
2236
  @data_migration_service_stub.call_rpc :create_private_connection, request, options: options do |response, operation|
2219
2237
  response = ::Gapic::Operation.new response, @operations_client, options: options
2220
2238
  yield response, operation if block_given?
2221
- return response
2239
+ throw :response, response
2222
2240
  end
2223
2241
  rescue ::GRPC::BadStatus => e
2224
2242
  raise ::Google::Cloud::Error.from_error(e)
@@ -2304,7 +2322,6 @@ module Google
2304
2322
 
2305
2323
  @data_migration_service_stub.call_rpc :get_private_connection, request, options: options do |response, operation|
2306
2324
  yield response, operation if block_given?
2307
- return response
2308
2325
  end
2309
2326
  rescue ::GRPC::BadStatus => e
2310
2327
  raise ::Google::Cloud::Error.from_error(e)
@@ -2415,7 +2432,7 @@ module Google
2415
2432
  @data_migration_service_stub.call_rpc :list_private_connections, request, options: options do |response, operation|
2416
2433
  response = ::Gapic::PagedEnumerable.new @data_migration_service_stub, :list_private_connections, request, response, operation, options
2417
2434
  yield response, operation if block_given?
2418
- return response
2435
+ throw :response, response
2419
2436
  end
2420
2437
  rescue ::GRPC::BadStatus => e
2421
2438
  raise ::Google::Cloud::Error.from_error(e)
@@ -2517,7 +2534,7 @@ module Google
2517
2534
  @data_migration_service_stub.call_rpc :delete_private_connection, request, options: options do |response, operation|
2518
2535
  response = ::Gapic::Operation.new response, @operations_client, options: options
2519
2536
  yield response, operation if block_given?
2520
- return response
2537
+ throw :response, response
2521
2538
  end
2522
2539
  rescue ::GRPC::BadStatus => e
2523
2540
  raise ::Google::Cloud::Error.from_error(e)
@@ -2603,7 +2620,6 @@ module Google
2603
2620
 
2604
2621
  @data_migration_service_stub.call_rpc :get_conversion_workspace, request, options: options do |response, operation|
2605
2622
  yield response, operation if block_given?
2606
- return response
2607
2623
  end
2608
2624
  rescue ::GRPC::BadStatus => e
2609
2625
  raise ::Google::Cloud::Error.from_error(e)
@@ -2713,7 +2729,7 @@ module Google
2713
2729
  @data_migration_service_stub.call_rpc :list_conversion_workspaces, request, options: options do |response, operation|
2714
2730
  response = ::Gapic::PagedEnumerable.new @data_migration_service_stub, :list_conversion_workspaces, request, response, operation, options
2715
2731
  yield response, operation if block_given?
2716
- return response
2732
+ throw :response, response
2717
2733
  end
2718
2734
  rescue ::GRPC::BadStatus => e
2719
2735
  raise ::Google::Cloud::Error.from_error(e)
@@ -2819,7 +2835,7 @@ module Google
2819
2835
  @data_migration_service_stub.call_rpc :create_conversion_workspace, request, options: options do |response, operation|
2820
2836
  response = ::Gapic::Operation.new response, @operations_client, options: options
2821
2837
  yield response, operation if block_given?
2822
- return response
2838
+ throw :response, response
2823
2839
  end
2824
2840
  rescue ::GRPC::BadStatus => e
2825
2841
  raise ::Google::Cloud::Error.from_error(e)
@@ -2924,7 +2940,7 @@ module Google
2924
2940
  @data_migration_service_stub.call_rpc :update_conversion_workspace, request, options: options do |response, operation|
2925
2941
  response = ::Gapic::Operation.new response, @operations_client, options: options
2926
2942
  yield response, operation if block_given?
2927
- return response
2943
+ throw :response, response
2928
2944
  end
2929
2945
  rescue ::GRPC::BadStatus => e
2930
2946
  raise ::Google::Cloud::Error.from_error(e)
@@ -3029,7 +3045,7 @@ module Google
3029
3045
  @data_migration_service_stub.call_rpc :delete_conversion_workspace, request, options: options do |response, operation|
3030
3046
  response = ::Gapic::Operation.new response, @operations_client, options: options
3031
3047
  yield response, operation if block_given?
3032
- return response
3048
+ throw :response, response
3033
3049
  end
3034
3050
  rescue ::GRPC::BadStatus => e
3035
3051
  raise ::Google::Cloud::Error.from_error(e)
@@ -3129,7 +3145,6 @@ module Google
3129
3145
 
3130
3146
  @data_migration_service_stub.call_rpc :create_mapping_rule, request, options: options do |response, operation|
3131
3147
  yield response, operation if block_given?
3132
- return response
3133
3148
  end
3134
3149
  rescue ::GRPC::BadStatus => e
3135
3150
  raise ::Google::Cloud::Error.from_error(e)
@@ -3223,7 +3238,6 @@ module Google
3223
3238
 
3224
3239
  @data_migration_service_stub.call_rpc :delete_mapping_rule, request, options: options do |response, operation|
3225
3240
  yield response, operation if block_given?
3226
- return response
3227
3241
  end
3228
3242
  rescue ::GRPC::BadStatus => e
3229
3243
  raise ::Google::Cloud::Error.from_error(e)
@@ -3325,7 +3339,7 @@ module Google
3325
3339
  @data_migration_service_stub.call_rpc :list_mapping_rules, request, options: options do |response, operation|
3326
3340
  response = ::Gapic::PagedEnumerable.new @data_migration_service_stub, :list_mapping_rules, request, response, operation, options
3327
3341
  yield response, operation if block_given?
3328
- return response
3342
+ throw :response, response
3329
3343
  end
3330
3344
  rescue ::GRPC::BadStatus => e
3331
3345
  raise ::Google::Cloud::Error.from_error(e)
@@ -3417,7 +3431,6 @@ module Google
3417
3431
 
3418
3432
  @data_migration_service_stub.call_rpc :get_mapping_rule, request, options: options do |response, operation|
3419
3433
  yield response, operation if block_given?
3420
- return response
3421
3434
  end
3422
3435
  rescue ::GRPC::BadStatus => e
3423
3436
  raise ::Google::Cloud::Error.from_error(e)
@@ -3522,7 +3535,7 @@ module Google
3522
3535
  @data_migration_service_stub.call_rpc :seed_conversion_workspace, request, options: options do |response, operation|
3523
3536
  response = ::Gapic::Operation.new response, @operations_client, options: options
3524
3537
  yield response, operation if block_given?
3525
- return response
3538
+ throw :response, response
3526
3539
  end
3527
3540
  rescue ::GRPC::BadStatus => e
3528
3541
  raise ::Google::Cloud::Error.from_error(e)
@@ -3626,7 +3639,7 @@ module Google
3626
3639
  @data_migration_service_stub.call_rpc :import_mapping_rules, request, options: options do |response, operation|
3627
3640
  response = ::Gapic::Operation.new response, @operations_client, options: options
3628
3641
  yield response, operation if block_given?
3629
- return response
3642
+ throw :response, response
3630
3643
  end
3631
3644
  rescue ::GRPC::BadStatus => e
3632
3645
  raise ::Google::Cloud::Error.from_error(e)
@@ -3731,7 +3744,7 @@ module Google
3731
3744
  @data_migration_service_stub.call_rpc :convert_conversion_workspace, request, options: options do |response, operation|
3732
3745
  response = ::Gapic::Operation.new response, @operations_client, options: options
3733
3746
  yield response, operation if block_given?
3734
- return response
3747
+ throw :response, response
3735
3748
  end
3736
3749
  rescue ::GRPC::BadStatus => e
3737
3750
  raise ::Google::Cloud::Error.from_error(e)
@@ -3827,7 +3840,7 @@ module Google
3827
3840
  @data_migration_service_stub.call_rpc :commit_conversion_workspace, request, options: options do |response, operation|
3828
3841
  response = ::Gapic::Operation.new response, @operations_client, options: options
3829
3842
  yield response, operation if block_given?
3830
- return response
3843
+ throw :response, response
3831
3844
  end
3832
3845
  rescue ::GRPC::BadStatus => e
3833
3846
  raise ::Google::Cloud::Error.from_error(e)
@@ -3921,7 +3934,7 @@ module Google
3921
3934
  @data_migration_service_stub.call_rpc :rollback_conversion_workspace, request, options: options do |response, operation|
3922
3935
  response = ::Gapic::Operation.new response, @operations_client, options: options
3923
3936
  yield response, operation if block_given?
3924
- return response
3937
+ throw :response, response
3925
3938
  end
3926
3939
  rescue ::GRPC::BadStatus => e
3927
3940
  raise ::Google::Cloud::Error.from_error(e)
@@ -4030,7 +4043,7 @@ module Google
4030
4043
  @data_migration_service_stub.call_rpc :apply_conversion_workspace, request, options: options do |response, operation|
4031
4044
  response = ::Gapic::Operation.new response, @operations_client, options: options
4032
4045
  yield response, operation if block_given?
4033
- return response
4046
+ throw :response, response
4034
4047
  end
4035
4048
  rescue ::GRPC::BadStatus => e
4036
4049
  raise ::Google::Cloud::Error.from_error(e)
@@ -4151,7 +4164,7 @@ module Google
4151
4164
  @data_migration_service_stub.call_rpc :describe_database_entities, request, options: options do |response, operation|
4152
4165
  response = ::Gapic::PagedEnumerable.new @data_migration_service_stub, :describe_database_entities, request, response, operation, options
4153
4166
  yield response, operation if block_given?
4154
- return response
4167
+ throw :response, response
4155
4168
  end
4156
4169
  rescue ::GRPC::BadStatus => e
4157
4170
  raise ::Google::Cloud::Error.from_error(e)
@@ -4254,7 +4267,6 @@ module Google
4254
4267
 
4255
4268
  @data_migration_service_stub.call_rpc :search_background_jobs, request, options: options do |response, operation|
4256
4269
  yield response, operation if block_given?
4257
- return response
4258
4270
  end
4259
4271
  rescue ::GRPC::BadStatus => e
4260
4272
  raise ::Google::Cloud::Error.from_error(e)
@@ -4345,7 +4357,6 @@ module Google
4345
4357
 
4346
4358
  @data_migration_service_stub.call_rpc :describe_conversion_workspace_revisions, request, options: options do |response, operation|
4347
4359
  yield response, operation if block_given?
4348
- return response
4349
4360
  end
4350
4361
  rescue ::GRPC::BadStatus => e
4351
4362
  raise ::Google::Cloud::Error.from_error(e)
@@ -4437,7 +4448,6 @@ module Google
4437
4448
 
4438
4449
  @data_migration_service_stub.call_rpc :fetch_static_ips, request, options: options do |response, operation|
4439
4450
  yield response, operation if block_given?
4440
- return response
4441
4451
  end
4442
4452
  rescue ::GRPC::BadStatus => e
4443
4453
  raise ::Google::Cloud::Error.from_error(e)
@@ -4526,6 +4536,11 @@ module Google
4526
4536
  # default endpoint URL. The default value of nil uses the environment
4527
4537
  # universe (usually the default "googleapis.com" universe).
4528
4538
  # @return [::String,nil]
4539
+ # @!attribute [rw] logger
4540
+ # A custom logger to use for request/response debug logging, or the value
4541
+ # `:default` (the default) to construct a default logger, or `nil` to
4542
+ # explicitly disable logging.
4543
+ # @return [::Logger,:default,nil]
4529
4544
  #
4530
4545
  class Configuration
4531
4546
  extend ::Gapic::Config
@@ -4550,6 +4565,7 @@ module Google
4550
4565
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
4551
4566
  config_attr :quota_project, nil, ::String, nil
4552
4567
  config_attr :universe_domain, nil, ::String, nil
4568
+ config_attr :logger, :default, ::Logger, nil, :default
4553
4569
 
4554
4570
  # @private
4555
4571
  def initialize parent_config = nil
@@ -124,14 +124,6 @@ module Google
124
124
  # Lists operations that match the specified filter in the request. If the
125
125
  # server doesn't support this method, it returns `UNIMPLEMENTED`.
126
126
  #
127
- # NOTE: the `name` binding allows API services to override the binding
128
- # to use different resource name schemes, such as `users/*/operations`. To
129
- # override the binding, API services can add a binding such as
130
- # `"/v1/{name=users/*}/operations"` to their service configuration.
131
- # For backwards compatibility, the default name includes the operations
132
- # collection id, however overriding users must ensure the name binding
133
- # is the parent resource, without the operations collection id.
134
- #
135
127
  # @overload list_operations(request, options = nil)
136
128
  # Pass arguments to `list_operations` via a request object, either of type
137
129
  # {::Google::Longrunning::ListOperationsRequest} or an equivalent Hash.
@@ -221,7 +213,7 @@ module Google
221
213
  wrap_lro_operation = ->(op_response) { ::Gapic::Operation.new op_response, @operations_client }
222
214
  response = ::Gapic::PagedEnumerable.new @operations_stub, :list_operations, request, response, operation, options, format_resource: wrap_lro_operation
223
215
  yield response, operation if block_given?
224
- return response
216
+ throw :response, response
225
217
  end
226
218
  rescue ::GRPC::BadStatus => e
227
219
  raise ::Google::Cloud::Error.from_error(e)
@@ -317,7 +309,7 @@ module Google
317
309
  @operations_stub.call_rpc :get_operation, request, options: options do |response, operation|
318
310
  response = ::Gapic::Operation.new response, @operations_client, options: options
319
311
  yield response, operation if block_given?
320
- return response
312
+ throw :response, response
321
313
  end
322
314
  rescue ::GRPC::BadStatus => e
323
315
  raise ::Google::Cloud::Error.from_error(e)
@@ -406,7 +398,6 @@ module Google
406
398
 
407
399
  @operations_stub.call_rpc :delete_operation, request, options: options do |response, operation|
408
400
  yield response, operation if block_given?
409
- return response
410
401
  end
411
402
  rescue ::GRPC::BadStatus => e
412
403
  raise ::Google::Cloud::Error.from_error(e)
@@ -421,8 +412,9 @@ module Google
421
412
  # other methods to check whether the cancellation succeeded or whether the
422
413
  # operation completed despite cancellation. On successful cancellation,
423
414
  # the operation is not deleted; instead, it becomes an operation with
424
- # an {::Google::Longrunning::Operation#error Operation.error} value with a {::Google::Rpc::Status#code google.rpc.Status.code} of 1,
425
- # corresponding to `Code.CANCELLED`.
415
+ # an {::Google::Longrunning::Operation#error Operation.error} value with a
416
+ # {::Google::Rpc::Status#code google.rpc.Status.code} of `1`, corresponding to
417
+ # `Code.CANCELLED`.
426
418
  #
427
419
  # @overload cancel_operation(request, options = nil)
428
420
  # Pass arguments to `cancel_operation` via a request object, either of type
@@ -501,7 +493,6 @@ module Google
501
493
 
502
494
  @operations_stub.call_rpc :cancel_operation, request, options: options do |response, operation|
503
495
  yield response, operation if block_given?
504
- return response
505
496
  end
506
497
  rescue ::GRPC::BadStatus => e
507
498
  raise ::Google::Cloud::Error.from_error(e)
@@ -599,7 +590,7 @@ module Google
599
590
  @operations_stub.call_rpc :wait_operation, request, options: options do |response, operation|
600
591
  response = ::Gapic::Operation.new response, @operations_client, options: options
601
592
  yield response, operation if block_given?
602
- return response
593
+ throw :response, response
603
594
  end
604
595
  rescue ::GRPC::BadStatus => e
605
596
  raise ::Google::Cloud::Error.from_error(e)
@@ -688,6 +679,11 @@ module Google
688
679
  # default endpoint URL. The default value of nil uses the environment
689
680
  # universe (usually the default "googleapis.com" universe).
690
681
  # @return [::String,nil]
682
+ # @!attribute [rw] logger
683
+ # A custom logger to use for request/response debug logging, or the value
684
+ # `:default` (the default) to construct a default logger, or `nil` to
685
+ # explicitly disable logging.
686
+ # @return [::Logger,:default,nil]
691
687
  #
692
688
  class Configuration
693
689
  extend ::Gapic::Config
@@ -712,6 +708,7 @@ module Google
712
708
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
713
709
  config_attr :quota_project, nil, ::String, nil
714
710
  config_attr :universe_domain, nil, ::String, nil
711
+ config_attr :logger, :default, ::Logger, nil, :default
715
712
 
716
713
  # @private
717
714
  def initialize parent_config = nil
@@ -21,7 +21,7 @@ module Google
21
21
  module Cloud
22
22
  module CloudDMS
23
23
  module V1
24
- VERSION = "1.0.1"
24
+ VERSION = "1.1.0"
25
25
  end
26
26
  end
27
27
  end
@@ -28,6 +28,9 @@ module Google
28
28
  # @!attribute [rw] destinations
29
29
  # @return [::Array<::Google::Api::ClientLibraryDestination>]
30
30
  # The destination where API teams want this client library to be published.
31
+ # @!attribute [rw] selective_gapic_generation
32
+ # @return [::Google::Api::SelectiveGapicGeneration]
33
+ # Configuration for which RPCs should be generated in the GAPIC client.
31
34
  class CommonLanguageSettings
32
35
  include ::Google::Protobuf::MessageExts
33
36
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,6 +215,12 @@ module Google
212
215
  # enabled. By default, asynchronous REST clients will not be generated.
213
216
  # This feature will be enabled by default 1 month after launching the
214
217
  # feature in preview packages.
218
+ # @!attribute [rw] protobuf_pythonic_types_enabled
219
+ # @return [::Boolean]
220
+ # Enables generation of protobuf code using new types that are more
221
+ # Pythonic which are included in `protobuf>=5.29.x`. This feature will be
222
+ # enabled by default 1 month after launching the feature in preview
223
+ # packages.
215
224
  class ExperimentalFeatures
216
225
  include ::Google::Protobuf::MessageExts
217
226
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,9 +306,28 @@ module Google
297
306
  # @!attribute [rw] common
298
307
  # @return [::Google::Api::CommonLanguageSettings]
299
308
  # Some settings.
309
+ # @!attribute [rw] renamed_services
310
+ # @return [::Google::Protobuf::Map{::String => ::String}]
311
+ # Map of service names to renamed services. Keys are the package relative
312
+ # service names and values are the name to be used for the service client
313
+ # and call options.
314
+ #
315
+ # publishing:
316
+ # go_settings:
317
+ # renamed_services:
318
+ # Publisher: TopicAdmin
300
319
  class GoSettings
301
320
  include ::Google::Protobuf::MessageExts
302
321
  extend ::Google::Protobuf::MessageExts::ClassMethods
322
+
323
+ # @!attribute [rw] key
324
+ # @return [::String]
325
+ # @!attribute [rw] value
326
+ # @return [::String]
327
+ class RenamedServicesEntry
328
+ include ::Google::Protobuf::MessageExts
329
+ extend ::Google::Protobuf::MessageExts::ClassMethods
330
+ end
303
331
  end
304
332
 
305
333
  # Describes the generator configuration for a method.
@@ -375,6 +403,17 @@ module Google
375
403
  end
376
404
  end
377
405
 
406
+ # This message is used to configure the generation of a subset of the RPCs in
407
+ # a service for client libraries.
408
+ # @!attribute [rw] methods
409
+ # @return [::Array<::String>]
410
+ # An allowlist of the fully qualified names of RPCs that should be included
411
+ # on public client surfaces.
412
+ class SelectiveGapicGeneration
413
+ include ::Google::Protobuf::MessageExts
414
+ extend ::Google::Protobuf::MessageExts::ClassMethods
415
+ end
416
+
378
417
  # The organization for which the client libraries are being published.
379
418
  # Affects the url where generated docs are published, etc.
380
419
  module ClientLibraryOrganization
@@ -42,7 +42,7 @@ module Google
42
42
  # The error result of the operation in case of failure or cancellation.
43
43
  # @!attribute [rw] response
44
44
  # @return [::Google::Protobuf::Any]
45
- # The normal response of the operation in case of success. If the original
45
+ # The normal, successful response of the operation. If the original
46
46
  # method returns no data on success, such as `Delete`, the response is
47
47
  # `google.protobuf.Empty`. If the original method is standard
48
48
  # `Get`/`Create`/`Update`, the response should be the resource. For other
@@ -55,7 +55,8 @@ module Google
55
55
  extend ::Google::Protobuf::MessageExts::ClassMethods
56
56
  end
57
57
 
58
- # The request message for Operations.GetOperation.
58
+ # The request message for
59
+ # Operations.GetOperation.
59
60
  # @!attribute [rw] name
60
61
  # @return [::String]
61
62
  # The name of the operation resource.
@@ -64,7 +65,8 @@ module Google
64
65
  extend ::Google::Protobuf::MessageExts::ClassMethods
65
66
  end
66
67
 
67
- # The request message for Operations.ListOperations.
68
+ # The request message for
69
+ # Operations.ListOperations.
68
70
  # @!attribute [rw] name
69
71
  # @return [::String]
70
72
  # The name of the operation's parent resource.
@@ -82,7 +84,8 @@ module Google
82
84
  extend ::Google::Protobuf::MessageExts::ClassMethods
83
85
  end
84
86
 
85
- # The response message for Operations.ListOperations.
87
+ # The response message for
88
+ # Operations.ListOperations.
86
89
  # @!attribute [rw] operations
87
90
  # @return [::Array<::Google::Longrunning::Operation>]
88
91
  # A list of operations that matches the specified filter in the request.
@@ -94,7 +97,8 @@ module Google
94
97
  extend ::Google::Protobuf::MessageExts::ClassMethods
95
98
  end
96
99
 
97
- # The request message for Operations.CancelOperation.
100
+ # The request message for
101
+ # Operations.CancelOperation.
98
102
  # @!attribute [rw] name
99
103
  # @return [::String]
100
104
  # The name of the operation resource to be cancelled.
@@ -103,7 +107,8 @@ module Google
103
107
  extend ::Google::Protobuf::MessageExts::ClassMethods
104
108
  end
105
109
 
106
- # The request message for Operations.DeleteOperation.
110
+ # The request message for
111
+ # Operations.DeleteOperation.
107
112
  # @!attribute [rw] name
108
113
  # @return [::String]
109
114
  # The name of the operation resource to be deleted.
@@ -112,7 +117,8 @@ module Google
112
117
  extend ::Google::Protobuf::MessageExts::ClassMethods
113
118
  end
114
119
 
115
- # The request message for Operations.WaitOperation.
120
+ # The request message for
121
+ # Operations.WaitOperation.
116
122
  # @!attribute [rw] name
117
123
  # @return [::String]
118
124
  # The name of the operation resource to wait on.
@@ -130,13 +136,12 @@ module Google
130
136
  #
131
137
  # Example:
132
138
  #
133
- # rpc LongRunningRecognize(LongRunningRecognizeRequest)
134
- # returns (google.longrunning.Operation) {
135
- # option (google.longrunning.operation_info) = {
136
- # response_type: "LongRunningRecognizeResponse"
137
- # metadata_type: "LongRunningRecognizeMetadata"
138
- # };
139
- # }
139
+ # rpc Export(ExportRequest) returns (google.longrunning.Operation) {
140
+ # option (google.longrunning.operation_info) = {
141
+ # response_type: "ExportResponse"
142
+ # metadata_type: "ExportMetadata"
143
+ # };
144
+ # }
140
145
  # @!attribute [rw] response_type
141
146
  # @return [::String]
142
147
  # Required. The message name of the primary return type for this
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-cloud_dms-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.0.1
4
+ version: 1.1.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: 2024-08-30 00:00:00.000000000 Z
11
+ date: 2024-12-10 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
16
16
  requirements:
17
17
  - - ">="
18
18
  - !ruby/object:Gem::Version
19
- version: 0.21.1
19
+ version: 0.24.0
20
20
  - - "<"
21
21
  - !ruby/object:Gem::Version
22
22
  version: 2.a
@@ -26,7 +26,7 @@ dependencies:
26
26
  requirements:
27
27
  - - ">="
28
28
  - !ruby/object:Gem::Version
29
- version: 0.21.1
29
+ version: 0.24.0
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -148,7 +148,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
148
148
  - !ruby/object:Gem::Version
149
149
  version: '0'
150
150
  requirements: []
151
- rubygems_version: 3.5.6
151
+ rubygems_version: 3.5.23
152
152
  signing_key:
153
153
  specification_version: 4
154
154
  summary: Manage Cloud Database Migration Service resources on Google Cloud Platform.