google-cloud-datastream-v1alpha1 0.2.0 → 0.4.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: 16d67b2b668f1b3a883a9e50f7fa794b505c6aeb2cbab5f9b2e0511e00b2912c
4
- data.tar.gz: 16417ecd87cf1fc5141b20691051ff960b06141c5f11459e6f983a3dd48d8c28
3
+ metadata.gz: d8c8bf8f6fd120afed5f480229871583b39a5010e87339b792a81fdda179c64d
4
+ data.tar.gz: 6f3079f4d99c1818f3e83cb25f5da358a27d99871945a42f6597a3b14e04bd75
5
5
  SHA512:
6
- metadata.gz: 02f659ac7048760bd2f2be8e84e2f91c4921c5aa283826348c3db25f99d252e52919ba9c3cbf159fdad4b03b964b73aed87d9fe15767231f9c160400bc9d5974
7
- data.tar.gz: 2192d7681c764808945d5ec6b126113aaf2962fb2136c7986cffbfd8d414ee961b27d75396675300a00743ea5cb0d602605d547fef3104112a554d4beccaaf68
6
+ metadata.gz: 8ac99d52416b8990c8c262038acdab8456df005a8954d7553a3bf82f91a3daca95b5eee3d5082ab7b2b6b6b762072b74dc48fa3f9237d15f15c39f8f27e346bc
7
+ data.tar.gz: e7d948bf8dbd5507e21516efb25a82510e449614ddbaea915dd08b0967189b9d156177767eec322e2dc3380ee5114b1072c9d4369ec96aef8b2a871c7032cb86
data/AUTHENTICATION.md CHANGED
@@ -112,7 +112,7 @@ credentials are discovered.
112
112
  To configure your system for this, simply:
113
113
 
114
114
  1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
115
- 2. Authenticate using OAuth 2.0 `$ gcloud auth login`
115
+ 2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
116
116
  3. Write code as if already authenticated.
117
117
 
118
118
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
data/README.md CHANGED
@@ -46,8 +46,8 @@ for general usage information.
46
46
  ## Enabling Logging
47
47
 
48
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/stdlib/libdoc/logger/rdoc/Logger.html) as shown below,
50
- or a [`Google::Cloud::Logging::Logger`](https://googleapis.dev/ruby/google-cloud-logging/latest)
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
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
52
  and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
53
53
 
@@ -148,7 +148,7 @@ module Google
148
148
  credentials = @config.credentials
149
149
  # Use self-signed JWT if the endpoint is unchanged from default,
150
150
  # but only if the default endpoint does not have a region prefix.
151
- enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
151
+ enable_self_signed_jwt = @config.endpoint == Configuration::DEFAULT_ENDPOINT &&
152
152
  !@config.endpoint.split(".").first.include?("-")
153
153
  credentials ||= Credentials.default scope: @config.scope,
154
154
  enable_self_signed_jwt: enable_self_signed_jwt
@@ -238,13 +238,11 @@ module Google
238
238
  # # Call the list_connection_profiles method.
239
239
  # result = client.list_connection_profiles request
240
240
  #
241
- # # The returned object is of type Gapic::PagedEnumerable. You can
242
- # # iterate over all elements by calling #each, and the enumerable
243
- # # will lazily make API calls to fetch subsequent pages. Other
244
- # # methods are also available for managing paging directly.
245
- # result.each do |response|
241
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
242
+ # # over elements, and API calls will be issued to fetch pages as needed.
243
+ # result.each do |item|
246
244
  # # Each element is of type ::Google::Cloud::Datastream::V1alpha1::ConnectionProfile.
247
- # p response
245
+ # p item
248
246
  # end
249
247
  #
250
248
  def list_connection_profiles request, options = nil
@@ -433,14 +431,14 @@ module Google
433
431
  # # Call the create_connection_profile method.
434
432
  # result = client.create_connection_profile request
435
433
  #
436
- # # The returned object is of type Gapic::Operation. You can use this
437
- # # object to check the status of an operation, cancel it, or wait
438
- # # for results. Here is how to block until completion:
434
+ # # The returned object is of type Gapic::Operation. You can use it to
435
+ # # check the status of an operation, cancel it, or wait for results.
436
+ # # Here is how to wait for a response.
439
437
  # result.wait_until_done! timeout: 60
440
438
  # if result.response?
441
439
  # p result.response
442
440
  # else
443
- # puts "Error!"
441
+ # puts "No response received."
444
442
  # end
445
443
  #
446
444
  def create_connection_profile request, options = nil
@@ -546,14 +544,14 @@ module Google
546
544
  # # Call the update_connection_profile method.
547
545
  # result = client.update_connection_profile request
548
546
  #
549
- # # The returned object is of type Gapic::Operation. You can use this
550
- # # object to check the status of an operation, cancel it, or wait
551
- # # for results. Here is how to block until completion:
547
+ # # The returned object is of type Gapic::Operation. You can use it to
548
+ # # check the status of an operation, cancel it, or wait for results.
549
+ # # Here is how to wait for a response.
552
550
  # result.wait_until_done! timeout: 60
553
551
  # if result.response?
554
552
  # p result.response
555
553
  # else
556
- # puts "Error!"
554
+ # puts "No response received."
557
555
  # end
558
556
  #
559
557
  def update_connection_profile request, options = nil
@@ -653,14 +651,14 @@ module Google
653
651
  # # Call the delete_connection_profile method.
654
652
  # result = client.delete_connection_profile request
655
653
  #
656
- # # The returned object is of type Gapic::Operation. You can use this
657
- # # object to check the status of an operation, cancel it, or wait
658
- # # for results. Here is how to block until completion:
654
+ # # The returned object is of type Gapic::Operation. You can use it to
655
+ # # check the status of an operation, cancel it, or wait for results.
656
+ # # Here is how to wait for a response.
659
657
  # result.wait_until_done! timeout: 60
660
658
  # if result.response?
661
659
  # p result.response
662
660
  # else
663
- # puts "Error!"
661
+ # puts "No response received."
664
662
  # end
665
663
  #
666
664
  def delete_connection_profile request, options = nil
@@ -862,13 +860,11 @@ module Google
862
860
  # # Call the list_streams method.
863
861
  # result = client.list_streams request
864
862
  #
865
- # # The returned object is of type Gapic::PagedEnumerable. You can
866
- # # iterate over all elements by calling #each, and the enumerable
867
- # # will lazily make API calls to fetch subsequent pages. Other
868
- # # methods are also available for managing paging directly.
869
- # result.each do |response|
863
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
864
+ # # over elements, and API calls will be issued to fetch pages as needed.
865
+ # result.each do |item|
870
866
  # # Each element is of type ::Google::Cloud::Datastream::V1alpha1::Stream.
871
- # p response
867
+ # p item
872
868
  # end
873
869
  #
874
870
  def list_streams request, options = nil
@@ -1062,14 +1058,14 @@ module Google
1062
1058
  # # Call the create_stream method.
1063
1059
  # result = client.create_stream request
1064
1060
  #
1065
- # # The returned object is of type Gapic::Operation. You can use this
1066
- # # object to check the status of an operation, cancel it, or wait
1067
- # # for results. Here is how to block until completion:
1061
+ # # The returned object is of type Gapic::Operation. You can use it to
1062
+ # # check the status of an operation, cancel it, or wait for results.
1063
+ # # Here is how to wait for a response.
1068
1064
  # result.wait_until_done! timeout: 60
1069
1065
  # if result.response?
1070
1066
  # p result.response
1071
1067
  # else
1072
- # puts "Error!"
1068
+ # puts "No response received."
1073
1069
  # end
1074
1070
  #
1075
1071
  def create_stream request, options = nil
@@ -1180,14 +1176,14 @@ module Google
1180
1176
  # # Call the update_stream method.
1181
1177
  # result = client.update_stream request
1182
1178
  #
1183
- # # The returned object is of type Gapic::Operation. You can use this
1184
- # # object to check the status of an operation, cancel it, or wait
1185
- # # for results. Here is how to block until completion:
1179
+ # # The returned object is of type Gapic::Operation. You can use it to
1180
+ # # check the status of an operation, cancel it, or wait for results.
1181
+ # # Here is how to wait for a response.
1186
1182
  # result.wait_until_done! timeout: 60
1187
1183
  # if result.response?
1188
1184
  # p result.response
1189
1185
  # else
1190
- # puts "Error!"
1186
+ # puts "No response received."
1191
1187
  # end
1192
1188
  #
1193
1189
  def update_stream request, options = nil
@@ -1287,14 +1283,14 @@ module Google
1287
1283
  # # Call the delete_stream method.
1288
1284
  # result = client.delete_stream request
1289
1285
  #
1290
- # # The returned object is of type Gapic::Operation. You can use this
1291
- # # object to check the status of an operation, cancel it, or wait
1292
- # # for results. Here is how to block until completion:
1286
+ # # The returned object is of type Gapic::Operation. You can use it to
1287
+ # # check the status of an operation, cancel it, or wait for results.
1288
+ # # Here is how to wait for a response.
1293
1289
  # result.wait_until_done! timeout: 60
1294
1290
  # if result.response?
1295
1291
  # p result.response
1296
1292
  # else
1297
- # puts "Error!"
1293
+ # puts "No response received."
1298
1294
  # end
1299
1295
  #
1300
1296
  def delete_stream request, options = nil
@@ -1380,14 +1376,14 @@ module Google
1380
1376
  # # Call the fetch_errors method.
1381
1377
  # result = client.fetch_errors request
1382
1378
  #
1383
- # # The returned object is of type Gapic::Operation. You can use this
1384
- # # object to check the status of an operation, cancel it, or wait
1385
- # # for results. Here is how to block until completion:
1379
+ # # The returned object is of type Gapic::Operation. You can use it to
1380
+ # # check the status of an operation, cancel it, or wait for results.
1381
+ # # Here is how to wait for a response.
1386
1382
  # result.wait_until_done! timeout: 60
1387
1383
  # if result.response?
1388
1384
  # p result.response
1389
1385
  # else
1390
- # puts "Error!"
1386
+ # puts "No response received."
1391
1387
  # end
1392
1388
  #
1393
1389
  def fetch_errors request, options = nil
@@ -1584,14 +1580,14 @@ module Google
1584
1580
  # # Call the create_private_connection method.
1585
1581
  # result = client.create_private_connection request
1586
1582
  #
1587
- # # The returned object is of type Gapic::Operation. You can use this
1588
- # # object to check the status of an operation, cancel it, or wait
1589
- # # for results. Here is how to block until completion:
1583
+ # # The returned object is of type Gapic::Operation. You can use it to
1584
+ # # check the status of an operation, cancel it, or wait for results.
1585
+ # # Here is how to wait for a response.
1590
1586
  # result.wait_until_done! timeout: 60
1591
1587
  # if result.response?
1592
1588
  # p result.response
1593
1589
  # else
1594
- # puts "Error!"
1590
+ # puts "No response received."
1595
1591
  # end
1596
1592
  #
1597
1593
  def create_private_connection request, options = nil
@@ -1779,13 +1775,11 @@ module Google
1779
1775
  # # Call the list_private_connections method.
1780
1776
  # result = client.list_private_connections request
1781
1777
  #
1782
- # # The returned object is of type Gapic::PagedEnumerable. You can
1783
- # # iterate over all elements by calling #each, and the enumerable
1784
- # # will lazily make API calls to fetch subsequent pages. Other
1785
- # # methods are also available for managing paging directly.
1786
- # result.each do |response|
1778
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1779
+ # # over elements, and API calls will be issued to fetch pages as needed.
1780
+ # result.each do |item|
1787
1781
  # # Each element is of type ::Google::Cloud::Datastream::V1alpha1::PrivateConnection.
1788
- # p response
1782
+ # p item
1789
1783
  # end
1790
1784
  #
1791
1785
  def list_private_connections request, options = nil
@@ -1888,14 +1882,14 @@ module Google
1888
1882
  # # Call the delete_private_connection method.
1889
1883
  # result = client.delete_private_connection request
1890
1884
  #
1891
- # # The returned object is of type Gapic::Operation. You can use this
1892
- # # object to check the status of an operation, cancel it, or wait
1893
- # # for results. Here is how to block until completion:
1885
+ # # The returned object is of type Gapic::Operation. You can use it to
1886
+ # # check the status of an operation, cancel it, or wait for results.
1887
+ # # Here is how to wait for a response.
1894
1888
  # result.wait_until_done! timeout: 60
1895
1889
  # if result.response?
1896
1890
  # p result.response
1897
1891
  # else
1898
- # puts "Error!"
1892
+ # puts "No response received."
1899
1893
  # end
1900
1894
  #
1901
1895
  def delete_private_connection request, options = nil
@@ -2000,14 +1994,14 @@ module Google
2000
1994
  # # Call the create_route method.
2001
1995
  # result = client.create_route request
2002
1996
  #
2003
- # # The returned object is of type Gapic::Operation. You can use this
2004
- # # object to check the status of an operation, cancel it, or wait
2005
- # # for results. Here is how to block until completion:
1997
+ # # The returned object is of type Gapic::Operation. You can use it to
1998
+ # # check the status of an operation, cancel it, or wait for results.
1999
+ # # Here is how to wait for a response.
2006
2000
  # result.wait_until_done! timeout: 60
2007
2001
  # if result.response?
2008
2002
  # p result.response
2009
2003
  # else
2010
- # puts "Error!"
2004
+ # puts "No response received."
2011
2005
  # end
2012
2006
  #
2013
2007
  def create_route request, options = nil
@@ -2195,13 +2189,11 @@ module Google
2195
2189
  # # Call the list_routes method.
2196
2190
  # result = client.list_routes request
2197
2191
  #
2198
- # # The returned object is of type Gapic::PagedEnumerable. You can
2199
- # # iterate over all elements by calling #each, and the enumerable
2200
- # # will lazily make API calls to fetch subsequent pages. Other
2201
- # # methods are also available for managing paging directly.
2202
- # result.each do |response|
2192
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2193
+ # # over elements, and API calls will be issued to fetch pages as needed.
2194
+ # result.each do |item|
2203
2195
  # # Each element is of type ::Google::Cloud::Datastream::V1alpha1::Route.
2204
- # p response
2196
+ # p item
2205
2197
  # end
2206
2198
  #
2207
2199
  def list_routes request, options = nil
@@ -2301,14 +2293,14 @@ module Google
2301
2293
  # # Call the delete_route method.
2302
2294
  # result = client.delete_route request
2303
2295
  #
2304
- # # The returned object is of type Gapic::Operation. You can use this
2305
- # # object to check the status of an operation, cancel it, or wait
2306
- # # for results. Here is how to block until completion:
2296
+ # # The returned object is of type Gapic::Operation. You can use it to
2297
+ # # check the status of an operation, cancel it, or wait for results.
2298
+ # # Here is how to wait for a response.
2307
2299
  # result.wait_until_done! timeout: 60
2308
2300
  # if result.response?
2309
2301
  # p result.response
2310
2302
  # else
2311
- # puts "Error!"
2303
+ # puts "No response received."
2312
2304
  # end
2313
2305
  #
2314
2306
  def delete_route request, options = nil
@@ -2391,9 +2383,9 @@ module Google
2391
2383
  # * (`String`) The path to a service account key file in JSON format
2392
2384
  # * (`Hash`) A service account key as a Hash
2393
2385
  # * (`Google::Auth::Credentials`) A googleauth credentials object
2394
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
2386
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
2395
2387
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
2396
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
2388
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
2397
2389
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
2398
2390
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
2399
2391
  # * (`nil`) indicating no credentials
@@ -2435,7 +2427,9 @@ module Google
2435
2427
  class Configuration
2436
2428
  extend ::Gapic::Config
2437
2429
 
2438
- config_attr :endpoint, "datastream.googleapis.com", ::String
2430
+ DEFAULT_ENDPOINT = "datastream.googleapis.com"
2431
+
2432
+ config_attr :endpoint, DEFAULT_ENDPOINT, ::String
2439
2433
  config_attr :credentials, nil do |value|
2440
2434
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
2441
2435
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC
@@ -158,13 +158,11 @@ module Google
158
158
  # # Call the list_operations method.
159
159
  # result = client.list_operations request
160
160
  #
161
- # # The returned object is of type Gapic::PagedEnumerable. You can
162
- # # iterate over all elements by calling #each, and the enumerable
163
- # # will lazily make API calls to fetch subsequent pages. Other
164
- # # methods are also available for managing paging directly.
165
- # result.each do |response|
161
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
162
+ # # over elements, and API calls will be issued to fetch pages as needed.
163
+ # result.each do |item|
166
164
  # # Each element is of type ::Google::Longrunning::Operation.
167
- # p response
165
+ # p item
168
166
  # end
169
167
  #
170
168
  def list_operations request, options = nil
@@ -253,14 +251,14 @@ module Google
253
251
  # # Call the get_operation method.
254
252
  # result = client.get_operation request
255
253
  #
256
- # # The returned object is of type Gapic::Operation. You can use this
257
- # # object to check the status of an operation, cancel it, or wait
258
- # # for results. Here is how to block until completion:
254
+ # # The returned object is of type Gapic::Operation. You can use it to
255
+ # # check the status of an operation, cancel it, or wait for results.
256
+ # # Here is how to wait for a response.
259
257
  # result.wait_until_done! timeout: 60
260
258
  # if result.response?
261
259
  # p result.response
262
260
  # else
263
- # puts "Error!"
261
+ # puts "No response received."
264
262
  # end
265
263
  #
266
264
  def get_operation request, options = nil
@@ -540,14 +538,14 @@ module Google
540
538
  # # Call the wait_operation method.
541
539
  # result = client.wait_operation request
542
540
  #
543
- # # The returned object is of type Gapic::Operation. You can use this
544
- # # object to check the status of an operation, cancel it, or wait
545
- # # for results. Here is how to block until completion:
541
+ # # The returned object is of type Gapic::Operation. You can use it to
542
+ # # check the status of an operation, cancel it, or wait for results.
543
+ # # Here is how to wait for a response.
546
544
  # result.wait_until_done! timeout: 60
547
545
  # if result.response?
548
546
  # p result.response
549
547
  # else
550
- # puts "Error!"
548
+ # puts "No response received."
551
549
  # end
552
550
  #
553
551
  def wait_operation request, options = nil
@@ -622,9 +620,9 @@ module Google
622
620
  # * (`String`) The path to a service account key file in JSON format
623
621
  # * (`Hash`) A service account key as a Hash
624
622
  # * (`Google::Auth::Credentials`) A googleauth credentials object
625
- # (see the [googleauth docs](https://googleapis.dev/ruby/googleauth/latest/index.html))
623
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
626
624
  # * (`Signet::OAuth2::Client`) A signet oauth2 client object
627
- # (see the [signet docs](https://googleapis.dev/ruby/signet/latest/Signet/OAuth2/Client.html))
625
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
628
626
  # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
629
627
  # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
630
628
  # * (`nil`) indicating no credentials
@@ -666,7 +664,9 @@ module Google
666
664
  class Configuration
667
665
  extend ::Gapic::Config
668
666
 
669
- config_attr :endpoint, "datastream.googleapis.com", ::String
667
+ DEFAULT_ENDPOINT = "datastream.googleapis.com"
668
+
669
+ config_attr :endpoint, DEFAULT_ENDPOINT, ::String
670
670
  config_attr :credentials, nil do |value|
671
671
  allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
672
672
  allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC