google-cloud-dataplex-v1 1.0.1 → 1.2.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.
Files changed (51) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +30 -20
  3. data/lib/google/cloud/dataplex/v1/bindings_override.rb +120 -0
  4. data/lib/google/cloud/dataplex/v1/catalog_pb.rb +17 -1
  5. data/lib/google/cloud/dataplex/v1/catalog_service/client.rb +626 -144
  6. data/lib/google/cloud/dataplex/v1/catalog_service/operations.rb +12 -15
  7. data/lib/google/cloud/dataplex/v1/catalog_service/paths.rb +19 -0
  8. data/lib/google/cloud/dataplex/v1/catalog_service/rest/client.rb +592 -144
  9. data/lib/google/cloud/dataplex/v1/catalog_service/rest/operations.rb +72 -38
  10. data/lib/google/cloud/dataplex/v1/catalog_service/rest/service_stub.rb +435 -133
  11. data/lib/google/cloud/dataplex/v1/catalog_service/rest.rb +4 -4
  12. data/lib/google/cloud/dataplex/v1/catalog_service.rb +4 -4
  13. data/lib/google/cloud/dataplex/v1/catalog_services_pb.rb +44 -20
  14. data/lib/google/cloud/dataplex/v1/content_service/client.rb +30 -9
  15. data/lib/google/cloud/dataplex/v1/content_service/rest/client.rb +30 -9
  16. data/lib/google/cloud/dataplex/v1/content_service/rest/service_stub.rb +78 -50
  17. data/lib/google/cloud/dataplex/v1/data_discovery_pb.rb +52 -0
  18. data/lib/google/cloud/dataplex/v1/data_quality_pb.rb +1 -1
  19. data/lib/google/cloud/dataplex/v1/data_scan_service/client.rb +34 -10
  20. data/lib/google/cloud/dataplex/v1/data_scan_service/operations.rb +12 -15
  21. data/lib/google/cloud/dataplex/v1/data_scan_service/paths.rb +36 -0
  22. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/client.rb +33 -10
  23. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/operations.rb +72 -38
  24. data/lib/google/cloud/dataplex/v1/data_scan_service/rest/service_stub.rb +86 -56
  25. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/client.rb +41 -16
  26. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/operations.rb +12 -15
  27. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/rest/client.rb +38 -16
  28. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/rest/operations.rb +72 -38
  29. data/lib/google/cloud/dataplex/v1/data_taxonomy_service/rest/service_stub.rb +134 -92
  30. data/lib/google/cloud/dataplex/v1/dataplex_service/client.rb +54 -34
  31. data/lib/google/cloud/dataplex/v1/dataplex_service/operations.rb +12 -15
  32. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/client.rb +52 -34
  33. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/operations.rb +72 -38
  34. data/lib/google/cloud/dataplex/v1/dataplex_service/rest/service_stub.rb +278 -200
  35. data/lib/google/cloud/dataplex/v1/datascans_pb.rb +3 -1
  36. data/lib/google/cloud/dataplex/v1/logs_pb.rb +3 -1
  37. data/lib/google/cloud/dataplex/v1/metadata_service/client.rb +31 -10
  38. data/lib/google/cloud/dataplex/v1/metadata_service/rest/client.rb +31 -10
  39. data/lib/google/cloud/dataplex/v1/metadata_service/rest/service_stub.rb +86 -56
  40. data/lib/google/cloud/dataplex/v1/version.rb +1 -1
  41. data/proto_docs/google/api/client.rb +39 -0
  42. data/proto_docs/google/api/field_info.rb +88 -0
  43. data/proto_docs/google/cloud/dataplex/v1/catalog.rb +710 -234
  44. data/proto_docs/google/cloud/dataplex/v1/data_discovery.rb +156 -0
  45. data/proto_docs/google/cloud/dataplex/v1/data_profile.rb +4 -4
  46. data/proto_docs/google/cloud/dataplex/v1/data_quality.rb +7 -2
  47. data/proto_docs/google/cloud/dataplex/v1/datascans.rb +30 -12
  48. data/proto_docs/google/cloud/dataplex/v1/logs.rb +51 -1
  49. data/proto_docs/google/cloud/dataplex/v1/tasks.rb +3 -4
  50. data/proto_docs/google/longrunning/operations.rb +19 -14
  51. metadata +8 -5
@@ -34,10 +34,10 @@ module Google
34
34
  module V1
35
35
  ##
36
36
  # The primary resources offered by this service are EntryGroups, EntryTypes,
37
- # AspectTypes, Entry and Aspect which collectively allow a data administrator
38
- # to organize, manage, secure and catalog data across their organization
39
- # located across cloud projects in a variety of storage systems including Cloud
40
- # Storage and BigQuery.
37
+ # AspectTypes, and Entries. They collectively let data administrators organize,
38
+ # manage, secure, and catalog data located across cloud projects in their
39
+ # organization in a variety of storage systems, including Cloud Storage and
40
+ # BigQuery.
41
41
  #
42
42
  # To load this service and instantiate a REST client:
43
43
  #
@@ -34,10 +34,10 @@ module Google
34
34
  module V1
35
35
  ##
36
36
  # The primary resources offered by this service are EntryGroups, EntryTypes,
37
- # AspectTypes, Entry and Aspect which collectively allow a data administrator
38
- # to organize, manage, secure and catalog data across their organization
39
- # located across cloud projects in a variety of storage systems including Cloud
40
- # Storage and BigQuery.
37
+ # AspectTypes, and Entries. They collectively let data administrators organize,
38
+ # manage, secure, and catalog data located across cloud projects in their
39
+ # organization in a variety of storage systems, including Cloud Storage and
40
+ # BigQuery.
41
41
  #
42
42
  # @example Load this service and instantiate a gRPC client
43
43
  #
@@ -25,10 +25,10 @@ module Google
25
25
  module V1
26
26
  module CatalogService
27
27
  # The primary resources offered by this service are EntryGroups, EntryTypes,
28
- # AspectTypes, Entry and Aspect which collectively allow a data administrator
29
- # to organize, manage, secure and catalog data across their organization
30
- # located across cloud projects in a variety of storage systems including Cloud
31
- # Storage and BigQuery.
28
+ # AspectTypes, and Entries. They collectively let data administrators organize,
29
+ # manage, secure, and catalog data located across cloud projects in their
30
+ # organization in a variety of storage systems, including Cloud Storage and
31
+ # BigQuery.
32
32
  class Service
33
33
 
34
34
  include ::GRPC::GenericService
@@ -37,35 +37,35 @@ module Google
37
37
  self.unmarshal_class_method = :decode
38
38
  self.service_name = 'google.cloud.dataplex.v1.CatalogService'
39
39
 
40
- # Creates an EntryType
40
+ # Creates an EntryType.
41
41
  rpc :CreateEntryType, ::Google::Cloud::Dataplex::V1::CreateEntryTypeRequest, ::Google::Longrunning::Operation
42
- # Updates a EntryType resource.
42
+ # Updates an EntryType.
43
43
  rpc :UpdateEntryType, ::Google::Cloud::Dataplex::V1::UpdateEntryTypeRequest, ::Google::Longrunning::Operation
44
- # Deletes a EntryType resource.
44
+ # Deletes an EntryType.
45
45
  rpc :DeleteEntryType, ::Google::Cloud::Dataplex::V1::DeleteEntryTypeRequest, ::Google::Longrunning::Operation
46
46
  # Lists EntryType resources in a project and location.
47
47
  rpc :ListEntryTypes, ::Google::Cloud::Dataplex::V1::ListEntryTypesRequest, ::Google::Cloud::Dataplex::V1::ListEntryTypesResponse
48
- # Retrieves a EntryType resource.
48
+ # Gets an EntryType.
49
49
  rpc :GetEntryType, ::Google::Cloud::Dataplex::V1::GetEntryTypeRequest, ::Google::Cloud::Dataplex::V1::EntryType
50
- # Creates an AspectType
50
+ # Creates an AspectType.
51
51
  rpc :CreateAspectType, ::Google::Cloud::Dataplex::V1::CreateAspectTypeRequest, ::Google::Longrunning::Operation
52
- # Updates a AspectType resource.
52
+ # Updates an AspectType.
53
53
  rpc :UpdateAspectType, ::Google::Cloud::Dataplex::V1::UpdateAspectTypeRequest, ::Google::Longrunning::Operation
54
- # Deletes a AspectType resource.
54
+ # Deletes an AspectType.
55
55
  rpc :DeleteAspectType, ::Google::Cloud::Dataplex::V1::DeleteAspectTypeRequest, ::Google::Longrunning::Operation
56
56
  # Lists AspectType resources in a project and location.
57
57
  rpc :ListAspectTypes, ::Google::Cloud::Dataplex::V1::ListAspectTypesRequest, ::Google::Cloud::Dataplex::V1::ListAspectTypesResponse
58
- # Retrieves a AspectType resource.
58
+ # Gets an AspectType.
59
59
  rpc :GetAspectType, ::Google::Cloud::Dataplex::V1::GetAspectTypeRequest, ::Google::Cloud::Dataplex::V1::AspectType
60
- # Creates an EntryGroup
60
+ # Creates an EntryGroup.
61
61
  rpc :CreateEntryGroup, ::Google::Cloud::Dataplex::V1::CreateEntryGroupRequest, ::Google::Longrunning::Operation
62
- # Updates a EntryGroup resource.
62
+ # Updates an EntryGroup.
63
63
  rpc :UpdateEntryGroup, ::Google::Cloud::Dataplex::V1::UpdateEntryGroupRequest, ::Google::Longrunning::Operation
64
- # Deletes a EntryGroup resource.
64
+ # Deletes an EntryGroup.
65
65
  rpc :DeleteEntryGroup, ::Google::Cloud::Dataplex::V1::DeleteEntryGroupRequest, ::Google::Longrunning::Operation
66
66
  # Lists EntryGroup resources in a project and location.
67
67
  rpc :ListEntryGroups, ::Google::Cloud::Dataplex::V1::ListEntryGroupsRequest, ::Google::Cloud::Dataplex::V1::ListEntryGroupsResponse
68
- # Retrieves a EntryGroup resource.
68
+ # Gets an EntryGroup.
69
69
  rpc :GetEntryGroup, ::Google::Cloud::Dataplex::V1::GetEntryGroupRequest, ::Google::Cloud::Dataplex::V1::EntryGroup
70
70
  # Creates an Entry.
71
71
  rpc :CreateEntry, ::Google::Cloud::Dataplex::V1::CreateEntryRequest, ::Google::Cloud::Dataplex::V1::Entry
@@ -73,14 +73,38 @@ module Google
73
73
  rpc :UpdateEntry, ::Google::Cloud::Dataplex::V1::UpdateEntryRequest, ::Google::Cloud::Dataplex::V1::Entry
74
74
  # Deletes an Entry.
75
75
  rpc :DeleteEntry, ::Google::Cloud::Dataplex::V1::DeleteEntryRequest, ::Google::Cloud::Dataplex::V1::Entry
76
- # Lists entries within an entry group.
76
+ # Lists Entries within an EntryGroup.
77
77
  rpc :ListEntries, ::Google::Cloud::Dataplex::V1::ListEntriesRequest, ::Google::Cloud::Dataplex::V1::ListEntriesResponse
78
- # Gets a single entry.
78
+ # Gets an Entry.
79
+ #
80
+ # **Caution**: The BigQuery metadata that is stored in Dataplex Catalog is
81
+ # changing. For more information, see [Changes to BigQuery metadata stored in
82
+ # Dataplex
83
+ # Catalog](https://cloud.google.com/dataplex/docs/biqquery-metadata-changes).
79
84
  rpc :GetEntry, ::Google::Cloud::Dataplex::V1::GetEntryRequest, ::Google::Cloud::Dataplex::V1::Entry
80
- # Looks up a single entry.
85
+ # Looks up a single Entry by name using the permission on the source system.
86
+ #
87
+ # **Caution**: The BigQuery metadata that is stored in Dataplex Catalog is
88
+ # changing. For more information, see [Changes to BigQuery metadata stored in
89
+ # Dataplex
90
+ # Catalog](https://cloud.google.com/dataplex/docs/biqquery-metadata-changes).
81
91
  rpc :LookupEntry, ::Google::Cloud::Dataplex::V1::LookupEntryRequest, ::Google::Cloud::Dataplex::V1::Entry
82
- # Searches for entries matching given query and scope.
92
+ # Searches for Entries matching the given query and scope.
83
93
  rpc :SearchEntries, ::Google::Cloud::Dataplex::V1::SearchEntriesRequest, ::Google::Cloud::Dataplex::V1::SearchEntriesResponse
94
+ # Creates a metadata job. For example, use a metadata job to import Dataplex
95
+ # Catalog entries and aspects from a third-party system into Dataplex.
96
+ rpc :CreateMetadataJob, ::Google::Cloud::Dataplex::V1::CreateMetadataJobRequest, ::Google::Longrunning::Operation
97
+ # Gets a metadata job.
98
+ rpc :GetMetadataJob, ::Google::Cloud::Dataplex::V1::GetMetadataJobRequest, ::Google::Cloud::Dataplex::V1::MetadataJob
99
+ # Lists metadata jobs.
100
+ rpc :ListMetadataJobs, ::Google::Cloud::Dataplex::V1::ListMetadataJobsRequest, ::Google::Cloud::Dataplex::V1::ListMetadataJobsResponse
101
+ # Cancels a metadata job.
102
+ #
103
+ # If you cancel a metadata import job that is in progress, the changes in the
104
+ # job might be partially applied. We recommend that you reset the state of
105
+ # the entry groups in your project by running another metadata job that
106
+ # reverts the changes from the canceled job.
107
+ rpc :CancelMetadataJob, ::Google::Cloud::Dataplex::V1::CancelMetadataJobRequest, ::Google::Protobuf::Empty
84
108
  end
85
109
 
86
110
  Stub = Service.rpc_stub_class
@@ -187,14 +187,26 @@ module Google
187
187
  universe_domain: @config.universe_domain,
188
188
  channel_args: @config.channel_args,
189
189
  interceptors: @config.interceptors,
190
- channel_pool_config: @config.channel_pool
190
+ channel_pool_config: @config.channel_pool,
191
+ logger: @config.logger
191
192
  )
192
193
 
194
+ @content_service_stub.stub_logger&.info do |entry|
195
+ entry.set_system_name
196
+ entry.set_service
197
+ entry.message = "Created client for #{entry.service}"
198
+ entry.set_credentials_fields credentials
199
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
200
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
201
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
202
+ end
203
+
193
204
  @location_client = Google::Cloud::Location::Locations::Client.new do |config|
194
205
  config.credentials = credentials
195
206
  config.quota_project = @quota_project_id
196
207
  config.endpoint = @content_service_stub.endpoint
197
208
  config.universe_domain = @content_service_stub.universe_domain
209
+ config.logger = @content_service_stub.logger if config.respond_to? :logger=
198
210
  end
199
211
 
200
212
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
@@ -202,6 +214,7 @@ module Google
202
214
  config.quota_project = @quota_project_id
203
215
  config.endpoint = @content_service_stub.endpoint
204
216
  config.universe_domain = @content_service_stub.universe_domain
217
+ config.logger = @content_service_stub.logger if config.respond_to? :logger=
205
218
  end
206
219
  end
207
220
 
@@ -219,6 +232,15 @@ module Google
219
232
  #
220
233
  attr_reader :iam_policy_client
221
234
 
235
+ ##
236
+ # The logger used for request/response debug logging.
237
+ #
238
+ # @return [Logger]
239
+ #
240
+ def logger
241
+ @content_service_stub.logger
242
+ end
243
+
222
244
  # Service calls
223
245
 
224
246
  ##
@@ -307,7 +329,6 @@ module Google
307
329
 
308
330
  @content_service_stub.call_rpc :create_content, request, options: options do |response, operation|
309
331
  yield response, operation if block_given?
310
- return response
311
332
  end
312
333
  rescue ::GRPC::BadStatus => e
313
334
  raise ::Google::Cloud::Error.from_error(e)
@@ -399,7 +420,6 @@ module Google
399
420
 
400
421
  @content_service_stub.call_rpc :update_content, request, options: options do |response, operation|
401
422
  yield response, operation if block_given?
402
- return response
403
423
  end
404
424
  rescue ::GRPC::BadStatus => e
405
425
  raise ::Google::Cloud::Error.from_error(e)
@@ -486,7 +506,6 @@ module Google
486
506
 
487
507
  @content_service_stub.call_rpc :delete_content, request, options: options do |response, operation|
488
508
  yield response, operation if block_given?
489
- return response
490
509
  end
491
510
  rescue ::GRPC::BadStatus => e
492
511
  raise ::Google::Cloud::Error.from_error(e)
@@ -575,7 +594,6 @@ module Google
575
594
 
576
595
  @content_service_stub.call_rpc :get_content, request, options: options do |response, operation|
577
596
  yield response, operation if block_given?
578
- return response
579
597
  end
580
598
  rescue ::GRPC::BadStatus => e
581
599
  raise ::Google::Cloud::Error.from_error(e)
@@ -670,7 +688,6 @@ module Google
670
688
 
671
689
  @content_service_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
672
690
  yield response, operation if block_given?
673
- return response
674
691
  end
675
692
  rescue ::GRPC::BadStatus => e
676
693
  raise ::Google::Cloud::Error.from_error(e)
@@ -772,7 +789,6 @@ module Google
772
789
 
773
790
  @content_service_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
774
791
  yield response, operation if block_given?
775
- return response
776
792
  end
777
793
  rescue ::GRPC::BadStatus => e
778
794
  raise ::Google::Cloud::Error.from_error(e)
@@ -873,7 +889,6 @@ module Google
873
889
 
874
890
  @content_service_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
875
891
  yield response, operation if block_given?
876
- return response
877
892
  end
878
893
  rescue ::GRPC::BadStatus => e
879
894
  raise ::Google::Cloud::Error.from_error(e)
@@ -984,7 +999,7 @@ module Google
984
999
  @content_service_stub.call_rpc :list_content, request, options: options do |response, operation|
985
1000
  response = ::Gapic::PagedEnumerable.new @content_service_stub, :list_content, request, response, operation, options
986
1001
  yield response, operation if block_given?
987
- return response
1002
+ throw :response, response
988
1003
  end
989
1004
  rescue ::GRPC::BadStatus => e
990
1005
  raise ::Google::Cloud::Error.from_error(e)
@@ -1073,6 +1088,11 @@ module Google
1073
1088
  # default endpoint URL. The default value of nil uses the environment
1074
1089
  # universe (usually the default "googleapis.com" universe).
1075
1090
  # @return [::String,nil]
1091
+ # @!attribute [rw] logger
1092
+ # A custom logger to use for request/response debug logging, or the value
1093
+ # `:default` (the default) to construct a default logger, or `nil` to
1094
+ # explicitly disable logging.
1095
+ # @return [::Logger,:default,nil]
1076
1096
  #
1077
1097
  class Configuration
1078
1098
  extend ::Gapic::Config
@@ -1097,6 +1117,7 @@ module Google
1097
1117
  config_attr :retry_policy, nil, ::Hash, ::Proc, nil
1098
1118
  config_attr :quota_project, nil, ::String, nil
1099
1119
  config_attr :universe_domain, nil, ::String, nil
1120
+ config_attr :logger, :default, ::Logger, nil, :default
1100
1121
 
1101
1122
  # @private
1102
1123
  def initialize parent_config = nil
@@ -180,15 +180,27 @@ module Google
180
180
  endpoint: @config.endpoint,
181
181
  endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
182
182
  universe_domain: @config.universe_domain,
183
- credentials: credentials
183
+ credentials: credentials,
184
+ logger: @config.logger
184
185
  )
185
186
 
187
+ @content_service_stub.logger(stub: true)&.info do |entry|
188
+ entry.set_system_name
189
+ entry.set_service
190
+ entry.message = "Created client for #{entry.service}"
191
+ entry.set_credentials_fields credentials
192
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
193
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
194
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
195
+ end
196
+
186
197
  @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
187
198
  config.credentials = credentials
188
199
  config.quota_project = @quota_project_id
189
200
  config.endpoint = @content_service_stub.endpoint
190
201
  config.universe_domain = @content_service_stub.universe_domain
191
202
  config.bindings_override = @config.bindings_override
203
+ config.logger = @content_service_stub.logger if config.respond_to? :logger=
192
204
  end
193
205
 
194
206
  @iam_policy_client = Google::Iam::V1::IAMPolicy::Rest::Client.new do |config|
@@ -197,6 +209,7 @@ module Google
197
209
  config.endpoint = @content_service_stub.endpoint
198
210
  config.universe_domain = @content_service_stub.universe_domain
199
211
  config.bindings_override = @config.bindings_override
212
+ config.logger = @content_service_stub.logger if config.respond_to? :logger=
200
213
  end
201
214
  end
202
215
 
@@ -214,6 +227,15 @@ module Google
214
227
  #
215
228
  attr_reader :iam_policy_client
216
229
 
230
+ ##
231
+ # The logger used for request/response debug logging.
232
+ #
233
+ # @return [Logger]
234
+ #
235
+ def logger
236
+ @content_service_stub.logger
237
+ end
238
+
217
239
  # Service calls
218
240
 
219
241
  ##
@@ -295,7 +317,6 @@ module Google
295
317
 
296
318
  @content_service_stub.create_content request, options do |result, operation|
297
319
  yield result, operation if block_given?
298
- return result
299
320
  end
300
321
  rescue ::Gapic::Rest::Error => e
301
322
  raise ::Google::Cloud::Error.from_error(e)
@@ -380,7 +401,6 @@ module Google
380
401
 
381
402
  @content_service_stub.update_content request, options do |result, operation|
382
403
  yield result, operation if block_given?
383
- return result
384
404
  end
385
405
  rescue ::Gapic::Rest::Error => e
386
406
  raise ::Google::Cloud::Error.from_error(e)
@@ -460,7 +480,6 @@ module Google
460
480
 
461
481
  @content_service_stub.delete_content request, options do |result, operation|
462
482
  yield result, operation if block_given?
463
- return result
464
483
  end
465
484
  rescue ::Gapic::Rest::Error => e
466
485
  raise ::Google::Cloud::Error.from_error(e)
@@ -542,7 +561,6 @@ module Google
542
561
 
543
562
  @content_service_stub.get_content request, options do |result, operation|
544
563
  yield result, operation if block_given?
545
- return result
546
564
  end
547
565
  rescue ::Gapic::Rest::Error => e
548
566
  raise ::Google::Cloud::Error.from_error(e)
@@ -630,7 +648,6 @@ module Google
630
648
 
631
649
  @content_service_stub.get_iam_policy request, options do |result, operation|
632
650
  yield result, operation if block_given?
633
- return result
634
651
  end
635
652
  rescue ::Gapic::Rest::Error => e
636
653
  raise ::Google::Cloud::Error.from_error(e)
@@ -725,7 +742,6 @@ module Google
725
742
 
726
743
  @content_service_stub.set_iam_policy request, options do |result, operation|
727
744
  yield result, operation if block_given?
728
- return result
729
745
  end
730
746
  rescue ::Gapic::Rest::Error => e
731
747
  raise ::Google::Cloud::Error.from_error(e)
@@ -819,7 +835,6 @@ module Google
819
835
 
820
836
  @content_service_stub.test_iam_permissions request, options do |result, operation|
821
837
  yield result, operation if block_given?
822
- return result
823
838
  end
824
839
  rescue ::Gapic::Rest::Error => e
825
840
  raise ::Google::Cloud::Error.from_error(e)
@@ -923,7 +938,7 @@ module Google
923
938
  @content_service_stub.list_content request, options do |result, operation|
924
939
  result = ::Gapic::Rest::PagedEnumerable.new @content_service_stub, :list_content, "content", request, result, options
925
940
  yield result, operation if block_given?
926
- return result
941
+ throw :response, result
927
942
  end
928
943
  rescue ::Gapic::Rest::Error => e
929
944
  raise ::Google::Cloud::Error.from_error(e)
@@ -1003,6 +1018,11 @@ module Google
1003
1018
  # default endpoint URL. The default value of nil uses the environment
1004
1019
  # universe (usually the default "googleapis.com" universe).
1005
1020
  # @return [::String,nil]
1021
+ # @!attribute [rw] logger
1022
+ # A custom logger to use for request/response debug logging, or the value
1023
+ # `:default` (the default) to construct a default logger, or `nil` to
1024
+ # explicitly disable logging.
1025
+ # @return [::Logger,:default,nil]
1006
1026
  #
1007
1027
  class Configuration
1008
1028
  extend ::Gapic::Config
@@ -1031,6 +1051,7 @@ module Google
1031
1051
  # by the host service.
1032
1052
  # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
1033
1053
  config_attr :bindings_override, {}, ::Hash, nil
1054
+ config_attr :logger, :default, ::Logger, nil, :default
1034
1055
 
1035
1056
  # @private
1036
1057
  def initialize parent_config = nil
@@ -30,7 +30,8 @@ module Google
30
30
  # including transcoding, making the REST call, and deserialing the response.
31
31
  #
32
32
  class ServiceStub
33
- def initialize endpoint:, endpoint_template:, universe_domain:, credentials:
33
+ # @private
34
+ def initialize endpoint:, endpoint_template:, universe_domain:, credentials:, logger:
34
35
  # These require statements are intentionally placed here to initialize
35
36
  # the REST modules only when it's required.
36
37
  require "gapic/rest"
@@ -40,7 +41,9 @@ module Google
40
41
  universe_domain: universe_domain,
41
42
  credentials: credentials,
42
43
  numeric_enums: true,
43
- raise_faraday_errors: false
44
+ service_name: self.class,
45
+ raise_faraday_errors: false,
46
+ logger: logger
44
47
  end
45
48
 
46
49
  ##
@@ -61,6 +64,15 @@ module Google
61
64
  @client_stub.endpoint
62
65
  end
63
66
 
67
+ ##
68
+ # The logger used for request/response debug logging.
69
+ #
70
+ # @return [Logger]
71
+ #
72
+ def logger stub: false
73
+ stub ? @client_stub.stub_logger : @client_stub.logger
74
+ end
75
+
64
76
  ##
65
77
  # Baseline implementation for the create_content REST call
66
78
  #
@@ -87,16 +99,18 @@ module Google
87
99
 
88
100
  response = @client_stub.make_http_request(
89
101
  verb,
90
- uri: uri,
91
- body: body || "",
92
- params: query_string_params,
102
+ uri: uri,
103
+ body: body || "",
104
+ params: query_string_params,
105
+ method_name: "create_content",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::Dataplex::V1::Content.decode_json response.body, ignore_unknown_fields: true
97
-
98
- yield result, operation if block_given?
99
- result
110
+ catch :response do
111
+ yield result, operation if block_given?
112
+ result
113
+ end
100
114
  end
101
115
 
102
116
  ##
@@ -125,16 +139,18 @@ module Google
125
139
 
126
140
  response = @client_stub.make_http_request(
127
141
  verb,
128
- uri: uri,
129
- body: body || "",
130
- params: query_string_params,
142
+ uri: uri,
143
+ body: body || "",
144
+ params: query_string_params,
145
+ method_name: "update_content",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::Dataplex::V1::Content.decode_json response.body, ignore_unknown_fields: true
135
-
136
- yield result, operation if block_given?
137
- result
150
+ catch :response do
151
+ yield result, operation if block_given?
152
+ result
153
+ end
138
154
  end
139
155
 
140
156
  ##
@@ -163,16 +179,18 @@ module Google
163
179
 
164
180
  response = @client_stub.make_http_request(
165
181
  verb,
166
- uri: uri,
167
- body: body || "",
168
- params: query_string_params,
182
+ uri: uri,
183
+ body: body || "",
184
+ params: query_string_params,
185
+ method_name: "delete_content",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Protobuf::Empty.decode_json response.body, ignore_unknown_fields: true
173
-
174
- yield result, operation if block_given?
175
- result
190
+ catch :response do
191
+ yield result, operation if block_given?
192
+ result
193
+ end
176
194
  end
177
195
 
178
196
  ##
@@ -201,16 +219,18 @@ module Google
201
219
 
202
220
  response = @client_stub.make_http_request(
203
221
  verb,
204
- uri: uri,
205
- body: body || "",
206
- params: query_string_params,
222
+ uri: uri,
223
+ body: body || "",
224
+ params: query_string_params,
225
+ method_name: "get_content",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Cloud::Dataplex::V1::Content.decode_json response.body, ignore_unknown_fields: true
211
-
212
- yield result, operation if block_given?
213
- result
230
+ catch :response do
231
+ yield result, operation if block_given?
232
+ result
233
+ end
214
234
  end
215
235
 
216
236
  ##
@@ -239,16 +259,18 @@ module Google
239
259
 
240
260
  response = @client_stub.make_http_request(
241
261
  verb,
242
- uri: uri,
243
- body: body || "",
244
- params: query_string_params,
262
+ uri: uri,
263
+ body: body || "",
264
+ params: query_string_params,
265
+ method_name: "get_iam_policy",
245
266
  options: options
246
267
  )
247
268
  operation = ::Gapic::Rest::TransportOperation.new response
248
269
  result = ::Google::Iam::V1::Policy.decode_json response.body, ignore_unknown_fields: true
249
-
250
- yield result, operation if block_given?
251
- result
270
+ catch :response do
271
+ yield result, operation if block_given?
272
+ result
273
+ end
252
274
  end
253
275
 
254
276
  ##
@@ -277,16 +299,18 @@ module Google
277
299
 
278
300
  response = @client_stub.make_http_request(
279
301
  verb,
280
- uri: uri,
281
- body: body || "",
282
- params: query_string_params,
302
+ uri: uri,
303
+ body: body || "",
304
+ params: query_string_params,
305
+ method_name: "set_iam_policy",
283
306
  options: options
284
307
  )
285
308
  operation = ::Gapic::Rest::TransportOperation.new response
286
309
  result = ::Google::Iam::V1::Policy.decode_json response.body, ignore_unknown_fields: true
287
-
288
- yield result, operation if block_given?
289
- result
310
+ catch :response do
311
+ yield result, operation if block_given?
312
+ result
313
+ end
290
314
  end
291
315
 
292
316
  ##
@@ -315,16 +339,18 @@ module Google
315
339
 
316
340
  response = @client_stub.make_http_request(
317
341
  verb,
318
- uri: uri,
319
- body: body || "",
320
- params: query_string_params,
342
+ uri: uri,
343
+ body: body || "",
344
+ params: query_string_params,
345
+ method_name: "test_iam_permissions",
321
346
  options: options
322
347
  )
323
348
  operation = ::Gapic::Rest::TransportOperation.new response
324
349
  result = ::Google::Iam::V1::TestIamPermissionsResponse.decode_json response.body, ignore_unknown_fields: true
325
-
326
- yield result, operation if block_given?
327
- result
350
+ catch :response do
351
+ yield result, operation if block_given?
352
+ result
353
+ end
328
354
  end
329
355
 
330
356
  ##
@@ -353,16 +379,18 @@ module Google
353
379
 
354
380
  response = @client_stub.make_http_request(
355
381
  verb,
356
- uri: uri,
357
- body: body || "",
358
- params: query_string_params,
382
+ uri: uri,
383
+ body: body || "",
384
+ params: query_string_params,
385
+ method_name: "list_content",
359
386
  options: options
360
387
  )
361
388
  operation = ::Gapic::Rest::TransportOperation.new response
362
389
  result = ::Google::Cloud::Dataplex::V1::ListContentResponse.decode_json response.body, ignore_unknown_fields: true
363
-
364
- yield result, operation if block_given?
365
- result
390
+ catch :response do
391
+ yield result, operation if block_given?
392
+ result
393
+ end
366
394
  end
367
395
 
368
396
  ##