google-cloud-datastream-v1 0.10.1 → 0.12.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.
@@ -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 list_connection_profiles 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: "list_connection_profiles",
93
106
  options: options
94
107
  )
95
108
  operation = ::Gapic::Rest::TransportOperation.new response
96
109
  result = ::Google::Cloud::Datastream::V1::ListConnectionProfilesResponse.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: "get_connection_profile",
131
146
  options: options
132
147
  )
133
148
  operation = ::Gapic::Rest::TransportOperation.new response
134
149
  result = ::Google::Cloud::Datastream::V1::ConnectionProfile.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: "create_connection_profile",
169
186
  options: options
170
187
  )
171
188
  operation = ::Gapic::Rest::TransportOperation.new response
172
189
  result = ::Google::Longrunning::Operation.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: "update_connection_profile",
207
226
  options: options
208
227
  )
209
228
  operation = ::Gapic::Rest::TransportOperation.new response
210
229
  result = ::Google::Longrunning::Operation.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: "delete_connection_profile",
245
266
  options: options
246
267
  )
247
268
  operation = ::Gapic::Rest::TransportOperation.new response
248
269
  result = ::Google::Longrunning::Operation.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: "discover_connection_profile",
283
306
  options: options
284
307
  )
285
308
  operation = ::Gapic::Rest::TransportOperation.new response
286
309
  result = ::Google::Cloud::Datastream::V1::DiscoverConnectionProfileResponse.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: "list_streams",
321
346
  options: options
322
347
  )
323
348
  operation = ::Gapic::Rest::TransportOperation.new response
324
349
  result = ::Google::Cloud::Datastream::V1::ListStreamsResponse.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: "get_stream",
359
386
  options: options
360
387
  )
361
388
  operation = ::Gapic::Rest::TransportOperation.new response
362
389
  result = ::Google::Cloud::Datastream::V1::Stream.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
  ##
@@ -391,16 +419,18 @@ module Google
391
419
 
392
420
  response = @client_stub.make_http_request(
393
421
  verb,
394
- uri: uri,
395
- body: body || "",
396
- params: query_string_params,
422
+ uri: uri,
423
+ body: body || "",
424
+ params: query_string_params,
425
+ method_name: "create_stream",
397
426
  options: options
398
427
  )
399
428
  operation = ::Gapic::Rest::TransportOperation.new response
400
429
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
401
-
402
- yield result, operation if block_given?
403
- result
430
+ catch :response do
431
+ yield result, operation if block_given?
432
+ result
433
+ end
404
434
  end
405
435
 
406
436
  ##
@@ -429,16 +459,18 @@ module Google
429
459
 
430
460
  response = @client_stub.make_http_request(
431
461
  verb,
432
- uri: uri,
433
- body: body || "",
434
- params: query_string_params,
462
+ uri: uri,
463
+ body: body || "",
464
+ params: query_string_params,
465
+ method_name: "update_stream",
435
466
  options: options
436
467
  )
437
468
  operation = ::Gapic::Rest::TransportOperation.new response
438
469
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
439
-
440
- yield result, operation if block_given?
441
- result
470
+ catch :response do
471
+ yield result, operation if block_given?
472
+ result
473
+ end
442
474
  end
443
475
 
444
476
  ##
@@ -467,16 +499,58 @@ module Google
467
499
 
468
500
  response = @client_stub.make_http_request(
469
501
  verb,
470
- uri: uri,
471
- body: body || "",
472
- params: query_string_params,
502
+ uri: uri,
503
+ body: body || "",
504
+ params: query_string_params,
505
+ method_name: "delete_stream",
473
506
  options: options
474
507
  )
475
508
  operation = ::Gapic::Rest::TransportOperation.new response
476
509
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
510
+ catch :response do
511
+ yield result, operation if block_given?
512
+ result
513
+ end
514
+ end
515
+
516
+ ##
517
+ # Baseline implementation for the run_stream REST call
518
+ #
519
+ # @param request_pb [::Google::Cloud::Datastream::V1::RunStreamRequest]
520
+ # A request object representing the call parameters. Required.
521
+ # @param options [::Gapic::CallOptions]
522
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
523
+ #
524
+ # @yield [result, operation] Access the result along with the TransportOperation object
525
+ # @yieldparam result [::Google::Longrunning::Operation]
526
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
527
+ #
528
+ # @return [::Google::Longrunning::Operation]
529
+ # A result object deserialized from the server's reply
530
+ def run_stream request_pb, options = nil
531
+ raise ::ArgumentError, "request must be provided" if request_pb.nil?
477
532
 
478
- yield result, operation if block_given?
479
- result
533
+ verb, uri, query_string_params, body = ServiceStub.transcode_run_stream_request request_pb
534
+ query_string_params = if query_string_params.any?
535
+ query_string_params.to_h { |p| p.split "=", 2 }
536
+ else
537
+ {}
538
+ end
539
+
540
+ response = @client_stub.make_http_request(
541
+ verb,
542
+ uri: uri,
543
+ body: body || "",
544
+ params: query_string_params,
545
+ method_name: "run_stream",
546
+ options: options
547
+ )
548
+ operation = ::Gapic::Rest::TransportOperation.new response
549
+ result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
550
+ catch :response do
551
+ yield result, operation if block_given?
552
+ result
553
+ end
480
554
  end
481
555
 
482
556
  ##
@@ -505,16 +579,18 @@ module Google
505
579
 
506
580
  response = @client_stub.make_http_request(
507
581
  verb,
508
- uri: uri,
509
- body: body || "",
510
- params: query_string_params,
582
+ uri: uri,
583
+ body: body || "",
584
+ params: query_string_params,
585
+ method_name: "get_stream_object",
511
586
  options: options
512
587
  )
513
588
  operation = ::Gapic::Rest::TransportOperation.new response
514
589
  result = ::Google::Cloud::Datastream::V1::StreamObject.decode_json response.body, ignore_unknown_fields: true
515
-
516
- yield result, operation if block_given?
517
- result
590
+ catch :response do
591
+ yield result, operation if block_given?
592
+ result
593
+ end
518
594
  end
519
595
 
520
596
  ##
@@ -543,16 +619,18 @@ module Google
543
619
 
544
620
  response = @client_stub.make_http_request(
545
621
  verb,
546
- uri: uri,
547
- body: body || "",
548
- params: query_string_params,
622
+ uri: uri,
623
+ body: body || "",
624
+ params: query_string_params,
625
+ method_name: "lookup_stream_object",
549
626
  options: options
550
627
  )
551
628
  operation = ::Gapic::Rest::TransportOperation.new response
552
629
  result = ::Google::Cloud::Datastream::V1::StreamObject.decode_json response.body, ignore_unknown_fields: true
553
-
554
- yield result, operation if block_given?
555
- result
630
+ catch :response do
631
+ yield result, operation if block_given?
632
+ result
633
+ end
556
634
  end
557
635
 
558
636
  ##
@@ -581,16 +659,18 @@ module Google
581
659
 
582
660
  response = @client_stub.make_http_request(
583
661
  verb,
584
- uri: uri,
585
- body: body || "",
586
- params: query_string_params,
662
+ uri: uri,
663
+ body: body || "",
664
+ params: query_string_params,
665
+ method_name: "list_stream_objects",
587
666
  options: options
588
667
  )
589
668
  operation = ::Gapic::Rest::TransportOperation.new response
590
669
  result = ::Google::Cloud::Datastream::V1::ListStreamObjectsResponse.decode_json response.body, ignore_unknown_fields: true
591
-
592
- yield result, operation if block_given?
593
- result
670
+ catch :response do
671
+ yield result, operation if block_given?
672
+ result
673
+ end
594
674
  end
595
675
 
596
676
  ##
@@ -619,16 +699,18 @@ module Google
619
699
 
620
700
  response = @client_stub.make_http_request(
621
701
  verb,
622
- uri: uri,
623
- body: body || "",
624
- params: query_string_params,
702
+ uri: uri,
703
+ body: body || "",
704
+ params: query_string_params,
705
+ method_name: "start_backfill_job",
625
706
  options: options
626
707
  )
627
708
  operation = ::Gapic::Rest::TransportOperation.new response
628
709
  result = ::Google::Cloud::Datastream::V1::StartBackfillJobResponse.decode_json response.body, ignore_unknown_fields: true
629
-
630
- yield result, operation if block_given?
631
- result
710
+ catch :response do
711
+ yield result, operation if block_given?
712
+ result
713
+ end
632
714
  end
633
715
 
634
716
  ##
@@ -657,16 +739,18 @@ module Google
657
739
 
658
740
  response = @client_stub.make_http_request(
659
741
  verb,
660
- uri: uri,
661
- body: body || "",
662
- params: query_string_params,
742
+ uri: uri,
743
+ body: body || "",
744
+ params: query_string_params,
745
+ method_name: "stop_backfill_job",
663
746
  options: options
664
747
  )
665
748
  operation = ::Gapic::Rest::TransportOperation.new response
666
749
  result = ::Google::Cloud::Datastream::V1::StopBackfillJobResponse.decode_json response.body, ignore_unknown_fields: true
667
-
668
- yield result, operation if block_given?
669
- result
750
+ catch :response do
751
+ yield result, operation if block_given?
752
+ result
753
+ end
670
754
  end
671
755
 
672
756
  ##
@@ -695,16 +779,18 @@ module Google
695
779
 
696
780
  response = @client_stub.make_http_request(
697
781
  verb,
698
- uri: uri,
699
- body: body || "",
700
- params: query_string_params,
782
+ uri: uri,
783
+ body: body || "",
784
+ params: query_string_params,
785
+ method_name: "fetch_static_ips",
701
786
  options: options
702
787
  )
703
788
  operation = ::Gapic::Rest::TransportOperation.new response
704
789
  result = ::Google::Cloud::Datastream::V1::FetchStaticIpsResponse.decode_json response.body, ignore_unknown_fields: true
705
-
706
- yield result, operation if block_given?
707
- result
790
+ catch :response do
791
+ yield result, operation if block_given?
792
+ result
793
+ end
708
794
  end
709
795
 
710
796
  ##
@@ -733,16 +819,18 @@ module Google
733
819
 
734
820
  response = @client_stub.make_http_request(
735
821
  verb,
736
- uri: uri,
737
- body: body || "",
738
- params: query_string_params,
822
+ uri: uri,
823
+ body: body || "",
824
+ params: query_string_params,
825
+ method_name: "create_private_connection",
739
826
  options: options
740
827
  )
741
828
  operation = ::Gapic::Rest::TransportOperation.new response
742
829
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
743
-
744
- yield result, operation if block_given?
745
- result
830
+ catch :response do
831
+ yield result, operation if block_given?
832
+ result
833
+ end
746
834
  end
747
835
 
748
836
  ##
@@ -771,16 +859,18 @@ module Google
771
859
 
772
860
  response = @client_stub.make_http_request(
773
861
  verb,
774
- uri: uri,
775
- body: body || "",
776
- params: query_string_params,
862
+ uri: uri,
863
+ body: body || "",
864
+ params: query_string_params,
865
+ method_name: "get_private_connection",
777
866
  options: options
778
867
  )
779
868
  operation = ::Gapic::Rest::TransportOperation.new response
780
869
  result = ::Google::Cloud::Datastream::V1::PrivateConnection.decode_json response.body, ignore_unknown_fields: true
781
-
782
- yield result, operation if block_given?
783
- result
870
+ catch :response do
871
+ yield result, operation if block_given?
872
+ result
873
+ end
784
874
  end
785
875
 
786
876
  ##
@@ -809,16 +899,18 @@ module Google
809
899
 
810
900
  response = @client_stub.make_http_request(
811
901
  verb,
812
- uri: uri,
813
- body: body || "",
814
- params: query_string_params,
902
+ uri: uri,
903
+ body: body || "",
904
+ params: query_string_params,
905
+ method_name: "list_private_connections",
815
906
  options: options
816
907
  )
817
908
  operation = ::Gapic::Rest::TransportOperation.new response
818
909
  result = ::Google::Cloud::Datastream::V1::ListPrivateConnectionsResponse.decode_json response.body, ignore_unknown_fields: true
819
-
820
- yield result, operation if block_given?
821
- result
910
+ catch :response do
911
+ yield result, operation if block_given?
912
+ result
913
+ end
822
914
  end
823
915
 
824
916
  ##
@@ -847,16 +939,18 @@ module Google
847
939
 
848
940
  response = @client_stub.make_http_request(
849
941
  verb,
850
- uri: uri,
851
- body: body || "",
852
- params: query_string_params,
942
+ uri: uri,
943
+ body: body || "",
944
+ params: query_string_params,
945
+ method_name: "delete_private_connection",
853
946
  options: options
854
947
  )
855
948
  operation = ::Gapic::Rest::TransportOperation.new response
856
949
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
857
-
858
- yield result, operation if block_given?
859
- result
950
+ catch :response do
951
+ yield result, operation if block_given?
952
+ result
953
+ end
860
954
  end
861
955
 
862
956
  ##
@@ -885,16 +979,18 @@ module Google
885
979
 
886
980
  response = @client_stub.make_http_request(
887
981
  verb,
888
- uri: uri,
889
- body: body || "",
890
- params: query_string_params,
982
+ uri: uri,
983
+ body: body || "",
984
+ params: query_string_params,
985
+ method_name: "create_route",
891
986
  options: options
892
987
  )
893
988
  operation = ::Gapic::Rest::TransportOperation.new response
894
989
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
895
-
896
- yield result, operation if block_given?
897
- result
990
+ catch :response do
991
+ yield result, operation if block_given?
992
+ result
993
+ end
898
994
  end
899
995
 
900
996
  ##
@@ -923,16 +1019,18 @@ module Google
923
1019
 
924
1020
  response = @client_stub.make_http_request(
925
1021
  verb,
926
- uri: uri,
927
- body: body || "",
928
- params: query_string_params,
1022
+ uri: uri,
1023
+ body: body || "",
1024
+ params: query_string_params,
1025
+ method_name: "get_route",
929
1026
  options: options
930
1027
  )
931
1028
  operation = ::Gapic::Rest::TransportOperation.new response
932
1029
  result = ::Google::Cloud::Datastream::V1::Route.decode_json response.body, ignore_unknown_fields: true
933
-
934
- yield result, operation if block_given?
935
- result
1030
+ catch :response do
1031
+ yield result, operation if block_given?
1032
+ result
1033
+ end
936
1034
  end
937
1035
 
938
1036
  ##
@@ -961,16 +1059,18 @@ module Google
961
1059
 
962
1060
  response = @client_stub.make_http_request(
963
1061
  verb,
964
- uri: uri,
965
- body: body || "",
966
- params: query_string_params,
1062
+ uri: uri,
1063
+ body: body || "",
1064
+ params: query_string_params,
1065
+ method_name: "list_routes",
967
1066
  options: options
968
1067
  )
969
1068
  operation = ::Gapic::Rest::TransportOperation.new response
970
1069
  result = ::Google::Cloud::Datastream::V1::ListRoutesResponse.decode_json response.body, ignore_unknown_fields: true
971
-
972
- yield result, operation if block_given?
973
- result
1070
+ catch :response do
1071
+ yield result, operation if block_given?
1072
+ result
1073
+ end
974
1074
  end
975
1075
 
976
1076
  ##
@@ -999,16 +1099,18 @@ module Google
999
1099
 
1000
1100
  response = @client_stub.make_http_request(
1001
1101
  verb,
1002
- uri: uri,
1003
- body: body || "",
1004
- params: query_string_params,
1102
+ uri: uri,
1103
+ body: body || "",
1104
+ params: query_string_params,
1105
+ method_name: "delete_route",
1005
1106
  options: options
1006
1107
  )
1007
1108
  operation = ::Gapic::Rest::TransportOperation.new response
1008
1109
  result = ::Google::Longrunning::Operation.decode_json response.body, ignore_unknown_fields: true
1009
-
1010
- yield result, operation if block_given?
1011
- result
1110
+ catch :response do
1111
+ yield result, operation if block_given?
1112
+ result
1113
+ end
1012
1114
  end
1013
1115
 
1014
1116
  ##
@@ -1247,6 +1349,28 @@ module Google
1247
1349
  transcoder.transcode request_pb
1248
1350
  end
1249
1351
 
1352
+ ##
1353
+ # @private
1354
+ #
1355
+ # GRPC transcoding helper method for the run_stream REST call
1356
+ #
1357
+ # @param request_pb [::Google::Cloud::Datastream::V1::RunStreamRequest]
1358
+ # A request object representing the call parameters. Required.
1359
+ # @return [Array(String, [String, nil], Hash{String => String})]
1360
+ # Uri, Body, Query string parameters
1361
+ def self.transcode_run_stream_request request_pb
1362
+ transcoder = Gapic::Rest::GrpcTranscoder.new
1363
+ .with_bindings(
1364
+ uri_method: :post,
1365
+ uri_template: "/v1/{name}:run",
1366
+ body: "*",
1367
+ matches: [
1368
+ ["name", %r{^projects/[^/]+/locations/[^/]+/streams/[^/]+/?$}, false]
1369
+ ]
1370
+ )
1371
+ transcoder.transcode request_pb
1372
+ end
1373
+
1250
1374
  ##
1251
1375
  # @private
1252
1376
  #