google-cloud-bigquery-connection-v1 0.4.2 → 0.5.3

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 2286cbd9fa1266a75410195e5ce163e86787f64279eb0ba9b9a953128a6cf8f9
4
- data.tar.gz: '061490d9beb41fead63177ff3d3400c81911c51718876f54210de10c9fb49506'
3
+ metadata.gz: 88ce725b50ba120d8c4036cd4dcd431d74c7a94c4591e087395be2d68bef0474
4
+ data.tar.gz: 727b79ad86cab8f37336bebc4932b950cb075cc68c167f2c2d9d2e710b86cfad
5
5
  SHA512:
6
- metadata.gz: 22aa5389bd482b44e66654930587c937b23b6f576f847890a98d7444366c3ef866552fbc73a6cce7892b0bf2859a3af3bf0719b14885b7f563c719ac834a70ed
7
- data.tar.gz: f4b3307c28ccc09edb5a68220887512782785e63c7cb440be7e23bdb6a155a5702b45dd4aa7e844f239f61ce274bb5e4c18f7d823cee33ec877f8c5c234961ad
6
+ metadata.gz: 8257691493dfe99fd4d43248929935569b8abbca0cc87b69a55d36a49000c0f5a06857b9825a5850f222ba2635c413570c625865fb4159246c5379f2592f5b4b
7
+ data.tar.gz: 694cead673625367cf27c9ba867c842627223221cf5e91dc6b0221cbbdb19f06f10a26b2557b46f4341d695d946ecb3a0b2a94c5a229275908bde54aee0d0971
data/.yardopts CHANGED
@@ -1,5 +1,5 @@
1
1
  --no-private
2
- --title=BigQuery Connection V1 API
2
+ --title="BigQuery Connection V1 API"
3
3
  --exclude _pb\.rb$
4
4
  --markup markdown
5
5
  --markup-provider redcarpet
data/AUTHENTICATION.md CHANGED
@@ -120,15 +120,6 @@ To configure your system for this, simply:
120
120
  **NOTE:** This is _not_ recommended for running in production. The Cloud SDK
121
121
  *should* only be used during development.
122
122
 
123
- [gce-how-to]: https://cloud.google.com/compute/docs/authentication#using
124
- [dev-console]: https://console.cloud.google.com/project
125
-
126
- [enable-apis]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/enable-apis.png
127
-
128
- [create-new-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account.png
129
- [create-new-service-account-existing-keys]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/create-new-service-account-existing-keys.png
130
- [reuse-service-account]: https://raw.githubusercontent.com/GoogleCloudPlatform/gcloud-common/master/authentication/reuse-service-account.png
131
-
132
123
  ## Creating a Service Account
133
124
 
134
125
  Google Cloud requires **Service Account Credentials** to
@@ -139,31 +130,22 @@ If you are not running this client within
139
130
  [Google Cloud Platform environments](#google-cloud-platform-environments), you
140
131
  need a Google Developers service account.
141
132
 
142
- 1. Visit the [Google Developers Console][dev-console].
133
+ 1. Visit the [Google Cloud Console](https://console.cloud.google.com/project).
143
134
  2. Create a new project or click on an existing project.
144
- 3. Activate the slide-out navigation tray and select **API Manager**. From
135
+ 3. Activate the menu in the upper left and select **APIs & Services**. From
145
136
  here, you will enable the APIs that your application requires.
146
137
 
147
- ![Enable the APIs that your application requires][enable-apis]
148
-
149
138
  *Note: You may need to enable billing in order to use these services.*
150
139
 
151
140
  4. Select **Credentials** from the side navigation.
152
141
 
153
- You should see a screen like one of the following.
154
-
155
- ![Create a new service account][create-new-service-account]
156
-
157
- ![Create a new service account With Existing Keys][create-new-service-account-existing-keys]
158
-
159
- Find the "Add credentials" drop down and select "Service account" to be
160
- guided through downloading a new JSON key file.
142
+ Find the "Create credentials" drop down near the top of the page, and select
143
+ "Service account" to be guided through downloading a new JSON key file.
161
144
 
162
145
  If you want to re-use an existing service account, you can easily generate a
163
- new key file. Just select the account you wish to re-use, and click "Generate
164
- new JSON key":
165
-
166
- ![Re-use an existing service account][reuse-service-account]
146
+ new key file. Just select the account you wish to re-use, click the pencil
147
+ tool on the right side to edit the service account, select the **Keys** tab,
148
+ and then select **Add Key**.
167
149
 
168
150
  The key file you download will be used by this library to authenticate API
169
151
  requests and should be stored in a secure location.
@@ -1,8 +1,6 @@
1
1
  # Generated by the protocol buffer compiler. DO NOT EDIT!
2
2
  # source: google/cloud/bigquery/connection/v1/connection.proto
3
3
 
4
- require 'google/protobuf'
5
-
6
4
  require 'google/api/annotations_pb'
7
5
  require 'google/api/client_pb'
8
6
  require 'google/api/field_behavior_pb'
@@ -12,6 +10,8 @@ require 'google/iam/v1/policy_pb'
12
10
  require 'google/protobuf/empty_pb'
13
11
  require 'google/protobuf/field_mask_pb'
14
12
  require 'google/protobuf/wrappers_pb'
13
+ require 'google/protobuf'
14
+
15
15
  Google::Protobuf::DescriptorPool.generated_pool.build do
16
16
  add_file("google/cloud/bigquery/connection/v1/connection.proto", :syntax => :proto3) do
17
17
  add_message "google.cloud.bigquery.connection.v1.CreateConnectionRequest" do
@@ -49,6 +49,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
49
49
  oneof :properties do
50
50
  optional :cloud_sql, :message, 4, "google.cloud.bigquery.connection.v1.CloudSqlProperties"
51
51
  optional :aws, :message, 8, "google.cloud.bigquery.connection.v1.AwsProperties"
52
+ optional :cloud_spanner, :message, 21, "google.cloud.bigquery.connection.v1.CloudSpannerProperties"
52
53
  end
53
54
  end
54
55
  add_message "google.cloud.bigquery.connection.v1.CloudSqlProperties" do
@@ -66,9 +67,14 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
66
67
  optional :username, :string, 1
67
68
  optional :password, :string, 2
68
69
  end
70
+ add_message "google.cloud.bigquery.connection.v1.CloudSpannerProperties" do
71
+ optional :database, :string, 1
72
+ optional :use_parallelism, :bool, 2
73
+ end
69
74
  add_message "google.cloud.bigquery.connection.v1.AwsProperties" do
70
75
  oneof :authentication_method do
71
76
  optional :cross_account_role, :message, 2, "google.cloud.bigquery.connection.v1.AwsCrossAccountRole"
77
+ optional :access_role, :message, 3, "google.cloud.bigquery.connection.v1.AwsAccessRole"
72
78
  end
73
79
  end
74
80
  add_message "google.cloud.bigquery.connection.v1.AwsCrossAccountRole" do
@@ -76,6 +82,10 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
76
82
  optional :iam_user_id, :string, 2
77
83
  optional :external_id, :string, 3
78
84
  end
85
+ add_message "google.cloud.bigquery.connection.v1.AwsAccessRole" do
86
+ optional :iam_role_id, :string, 1
87
+ optional :identity, :string, 2
88
+ end
79
89
  end
80
90
  end
81
91
 
@@ -94,8 +104,10 @@ module Google
94
104
  CloudSqlProperties = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.CloudSqlProperties").msgclass
95
105
  CloudSqlProperties::DatabaseType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.CloudSqlProperties.DatabaseType").enummodule
96
106
  CloudSqlCredential = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.CloudSqlCredential").msgclass
107
+ CloudSpannerProperties = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.CloudSpannerProperties").msgclass
97
108
  AwsProperties = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.AwsProperties").msgclass
98
109
  AwsCrossAccountRole = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.AwsCrossAccountRole").msgclass
110
+ AwsAccessRole = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.bigquery.connection.v1.AwsAccessRole").msgclass
99
111
  end
100
112
  end
101
113
  end
@@ -42,13 +42,12 @@ module Google
42
42
  # See {::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client::Configuration}
43
43
  # for a description of the configuration fields.
44
44
  #
45
- # ## Example
45
+ # @example
46
46
  #
47
- # To modify the configuration for all ConnectionService clients:
48
- #
49
- # ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.configure do |config|
50
- # config.timeout = 10.0
51
- # end
47
+ # # Modify the configuration for all ConnectionService clients
48
+ # ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.configure do |config|
49
+ # config.timeout = 10.0
50
+ # end
52
51
  #
53
52
  # @yield [config] Configure the Client client.
54
53
  # @yieldparam config [Client::Configuration]
@@ -120,19 +119,15 @@ module Google
120
119
  ##
121
120
  # Create a new ConnectionService client object.
122
121
  #
123
- # ## Examples
124
- #
125
- # To create a new ConnectionService client with the default
126
- # configuration:
127
- #
128
- # client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
122
+ # @example
129
123
  #
130
- # To create a new ConnectionService client with a custom
131
- # configuration:
124
+ # # Create a client using the default configuration
125
+ # client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
132
126
  #
133
- # client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new do |config|
134
- # config.timeout = 10.0
135
- # end
127
+ # # Create a client using a custom configuration
128
+ # client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new do |config|
129
+ # config.timeout = 10.0
130
+ # end
136
131
  #
137
132
  # @yield [config] Configure the ConnectionService client.
138
133
  # @yieldparam config [Client::Configuration]
@@ -152,10 +147,9 @@ module Google
152
147
 
153
148
  # Create credentials
154
149
  credentials = @config.credentials
155
- # Use self-signed JWT if the scope and endpoint are unchanged from default,
150
+ # Use self-signed JWT if the endpoint is unchanged from default,
156
151
  # but only if the default endpoint does not have a region prefix.
157
- enable_self_signed_jwt = @config.scope == Client.configure.scope &&
158
- @config.endpoint == Client.configure.endpoint &&
152
+ enable_self_signed_jwt = @config.endpoint == Client.configure.endpoint &&
159
153
  !@config.endpoint.split(".").first.include?("-")
160
154
  credentials ||= Credentials.default scope: @config.scope,
161
155
  enable_self_signed_jwt: enable_self_signed_jwt
@@ -210,6 +204,21 @@ module Google
210
204
  #
211
205
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
212
206
  #
207
+ # @example Basic example
208
+ # require "google/cloud/bigquery/connection/v1"
209
+ #
210
+ # # Create a client object. The client can be reused for multiple calls.
211
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
212
+ #
213
+ # # Create a request. To set request fields, pass in keyword arguments.
214
+ # request = Google::Cloud::Bigquery::Connection::V1::CreateConnectionRequest.new
215
+ #
216
+ # # Call the create_connection method.
217
+ # result = client.create_connection request
218
+ #
219
+ # # The returned object is of type Google::Cloud::Bigquery::Connection::V1::Connection.
220
+ # p result
221
+ #
213
222
  def create_connection request, options = nil
214
223
  raise ::ArgumentError, "request must be provided" if request.nil?
215
224
 
@@ -227,16 +236,20 @@ module Google
227
236
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
228
237
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
229
238
 
230
- header_params = {
231
- "parent" => request.parent
232
- }
239
+ header_params = {}
240
+ if request.parent
241
+ header_params["parent"] = request.parent
242
+ end
243
+
233
244
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
234
245
  metadata[:"x-goog-request-params"] ||= request_params_header
235
246
 
236
247
  options.apply_defaults timeout: @config.rpcs.create_connection.timeout,
237
248
  metadata: metadata,
238
249
  retry_policy: @config.rpcs.create_connection.retry_policy
239
- options.apply_defaults metadata: @config.metadata,
250
+
251
+ options.apply_defaults timeout: @config.timeout,
252
+ metadata: @config.metadata,
240
253
  retry_policy: @config.retry_policy
241
254
 
242
255
  @connection_service_stub.call_rpc :create_connection, request, options: options do |response, operation|
@@ -277,6 +290,21 @@ module Google
277
290
  #
278
291
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
279
292
  #
293
+ # @example Basic example
294
+ # require "google/cloud/bigquery/connection/v1"
295
+ #
296
+ # # Create a client object. The client can be reused for multiple calls.
297
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
298
+ #
299
+ # # Create a request. To set request fields, pass in keyword arguments.
300
+ # request = Google::Cloud::Bigquery::Connection::V1::GetConnectionRequest.new
301
+ #
302
+ # # Call the get_connection method.
303
+ # result = client.get_connection request
304
+ #
305
+ # # The returned object is of type Google::Cloud::Bigquery::Connection::V1::Connection.
306
+ # p result
307
+ #
280
308
  def get_connection request, options = nil
281
309
  raise ::ArgumentError, "request must be provided" if request.nil?
282
310
 
@@ -294,16 +322,20 @@ module Google
294
322
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
295
323
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
296
324
 
297
- header_params = {
298
- "name" => request.name
299
- }
325
+ header_params = {}
326
+ if request.name
327
+ header_params["name"] = request.name
328
+ end
329
+
300
330
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
301
331
  metadata[:"x-goog-request-params"] ||= request_params_header
302
332
 
303
333
  options.apply_defaults timeout: @config.rpcs.get_connection.timeout,
304
334
  metadata: metadata,
305
335
  retry_policy: @config.rpcs.get_connection.retry_policy
306
- options.apply_defaults metadata: @config.metadata,
336
+
337
+ options.apply_defaults timeout: @config.timeout,
338
+ metadata: @config.metadata,
307
339
  retry_policy: @config.retry_policy
308
340
 
309
341
  @connection_service_stub.call_rpc :get_connection, request, options: options do |response, operation|
@@ -348,6 +380,27 @@ module Google
348
380
  #
349
381
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
350
382
  #
383
+ # @example Basic example
384
+ # require "google/cloud/bigquery/connection/v1"
385
+ #
386
+ # # Create a client object. The client can be reused for multiple calls.
387
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
388
+ #
389
+ # # Create a request. To set request fields, pass in keyword arguments.
390
+ # request = Google::Cloud::Bigquery::Connection::V1::ListConnectionsRequest.new
391
+ #
392
+ # # Call the list_connections method.
393
+ # result = client.list_connections request
394
+ #
395
+ # # The returned object is of type Gapic::PagedEnumerable. You can
396
+ # # iterate over all elements by calling #each, and the enumerable
397
+ # # will lazily make API calls to fetch subsequent pages. Other
398
+ # # methods are also available for managing paging directly.
399
+ # result.each do |response|
400
+ # # Each element is of type ::Google::Cloud::Bigquery::Connection::V1::Connection.
401
+ # p response
402
+ # end
403
+ #
351
404
  def list_connections request, options = nil
352
405
  raise ::ArgumentError, "request must be provided" if request.nil?
353
406
 
@@ -365,16 +418,20 @@ module Google
365
418
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
366
419
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
367
420
 
368
- header_params = {
369
- "parent" => request.parent
370
- }
421
+ header_params = {}
422
+ if request.parent
423
+ header_params["parent"] = request.parent
424
+ end
425
+
371
426
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
372
427
  metadata[:"x-goog-request-params"] ||= request_params_header
373
428
 
374
429
  options.apply_defaults timeout: @config.rpcs.list_connections.timeout,
375
430
  metadata: metadata,
376
431
  retry_policy: @config.rpcs.list_connections.retry_policy
377
- options.apply_defaults metadata: @config.metadata,
432
+
433
+ options.apply_defaults timeout: @config.timeout,
434
+ metadata: @config.metadata,
378
435
  retry_policy: @config.retry_policy
379
436
 
380
437
  @connection_service_stub.call_rpc :list_connections, request, options: options do |response, operation|
@@ -421,6 +478,21 @@ module Google
421
478
  #
422
479
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
423
480
  #
481
+ # @example Basic example
482
+ # require "google/cloud/bigquery/connection/v1"
483
+ #
484
+ # # Create a client object. The client can be reused for multiple calls.
485
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
486
+ #
487
+ # # Create a request. To set request fields, pass in keyword arguments.
488
+ # request = Google::Cloud::Bigquery::Connection::V1::UpdateConnectionRequest.new
489
+ #
490
+ # # Call the update_connection method.
491
+ # result = client.update_connection request
492
+ #
493
+ # # The returned object is of type Google::Cloud::Bigquery::Connection::V1::Connection.
494
+ # p result
495
+ #
424
496
  def update_connection request, options = nil
425
497
  raise ::ArgumentError, "request must be provided" if request.nil?
426
498
 
@@ -438,16 +510,20 @@ module Google
438
510
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
439
511
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
440
512
 
441
- header_params = {
442
- "name" => request.name
443
- }
513
+ header_params = {}
514
+ if request.name
515
+ header_params["name"] = request.name
516
+ end
517
+
444
518
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
445
519
  metadata[:"x-goog-request-params"] ||= request_params_header
446
520
 
447
521
  options.apply_defaults timeout: @config.rpcs.update_connection.timeout,
448
522
  metadata: metadata,
449
523
  retry_policy: @config.rpcs.update_connection.retry_policy
450
- options.apply_defaults metadata: @config.metadata,
524
+
525
+ options.apply_defaults timeout: @config.timeout,
526
+ metadata: @config.metadata,
451
527
  retry_policy: @config.retry_policy
452
528
 
453
529
  @connection_service_stub.call_rpc :update_connection, request, options: options do |response, operation|
@@ -488,6 +564,21 @@ module Google
488
564
  #
489
565
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
490
566
  #
567
+ # @example Basic example
568
+ # require "google/cloud/bigquery/connection/v1"
569
+ #
570
+ # # Create a client object. The client can be reused for multiple calls.
571
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
572
+ #
573
+ # # Create a request. To set request fields, pass in keyword arguments.
574
+ # request = Google::Cloud::Bigquery::Connection::V1::DeleteConnectionRequest.new
575
+ #
576
+ # # Call the delete_connection method.
577
+ # result = client.delete_connection request
578
+ #
579
+ # # The returned object is of type Google::Protobuf::Empty.
580
+ # p result
581
+ #
491
582
  def delete_connection request, options = nil
492
583
  raise ::ArgumentError, "request must be provided" if request.nil?
493
584
 
@@ -505,16 +596,20 @@ module Google
505
596
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
506
597
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
507
598
 
508
- header_params = {
509
- "name" => request.name
510
- }
599
+ header_params = {}
600
+ if request.name
601
+ header_params["name"] = request.name
602
+ end
603
+
511
604
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
512
605
  metadata[:"x-goog-request-params"] ||= request_params_header
513
606
 
514
607
  options.apply_defaults timeout: @config.rpcs.delete_connection.timeout,
515
608
  metadata: metadata,
516
609
  retry_policy: @config.rpcs.delete_connection.retry_policy
517
- options.apply_defaults metadata: @config.metadata,
610
+
611
+ options.apply_defaults timeout: @config.timeout,
612
+ metadata: @config.metadata,
518
613
  retry_policy: @config.retry_policy
519
614
 
520
615
  @connection_service_stub.call_rpc :delete_connection, request, options: options do |response, operation|
@@ -560,6 +655,21 @@ module Google
560
655
  #
561
656
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
562
657
  #
658
+ # @example Basic example
659
+ # require "google/cloud/bigquery/connection/v1"
660
+ #
661
+ # # Create a client object. The client can be reused for multiple calls.
662
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
663
+ #
664
+ # # Create a request. To set request fields, pass in keyword arguments.
665
+ # request = Google::Iam::V1::GetIamPolicyRequest.new
666
+ #
667
+ # # Call the get_iam_policy method.
668
+ # result = client.get_iam_policy request
669
+ #
670
+ # # The returned object is of type Google::Iam::V1::Policy.
671
+ # p result
672
+ #
563
673
  def get_iam_policy request, options = nil
564
674
  raise ::ArgumentError, "request must be provided" if request.nil?
565
675
 
@@ -577,16 +687,20 @@ module Google
577
687
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
578
688
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
579
689
 
580
- header_params = {
581
- "resource" => request.resource
582
- }
690
+ header_params = {}
691
+ if request.resource
692
+ header_params["resource"] = request.resource
693
+ end
694
+
583
695
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
584
696
  metadata[:"x-goog-request-params"] ||= request_params_header
585
697
 
586
698
  options.apply_defaults timeout: @config.rpcs.get_iam_policy.timeout,
587
699
  metadata: metadata,
588
700
  retry_policy: @config.rpcs.get_iam_policy.retry_policy
589
- options.apply_defaults metadata: @config.metadata,
701
+
702
+ options.apply_defaults timeout: @config.timeout,
703
+ metadata: @config.metadata,
590
704
  retry_policy: @config.retry_policy
591
705
 
592
706
  @connection_service_stub.call_rpc :get_iam_policy, request, options: options do |response, operation|
@@ -635,6 +749,21 @@ module Google
635
749
  #
636
750
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
637
751
  #
752
+ # @example Basic example
753
+ # require "google/cloud/bigquery/connection/v1"
754
+ #
755
+ # # Create a client object. The client can be reused for multiple calls.
756
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
757
+ #
758
+ # # Create a request. To set request fields, pass in keyword arguments.
759
+ # request = Google::Iam::V1::SetIamPolicyRequest.new
760
+ #
761
+ # # Call the set_iam_policy method.
762
+ # result = client.set_iam_policy request
763
+ #
764
+ # # The returned object is of type Google::Iam::V1::Policy.
765
+ # p result
766
+ #
638
767
  def set_iam_policy request, options = nil
639
768
  raise ::ArgumentError, "request must be provided" if request.nil?
640
769
 
@@ -652,16 +781,20 @@ module Google
652
781
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
653
782
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
654
783
 
655
- header_params = {
656
- "resource" => request.resource
657
- }
784
+ header_params = {}
785
+ if request.resource
786
+ header_params["resource"] = request.resource
787
+ end
788
+
658
789
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
659
790
  metadata[:"x-goog-request-params"] ||= request_params_header
660
791
 
661
792
  options.apply_defaults timeout: @config.rpcs.set_iam_policy.timeout,
662
793
  metadata: metadata,
663
794
  retry_policy: @config.rpcs.set_iam_policy.retry_policy
664
- options.apply_defaults metadata: @config.metadata,
795
+
796
+ options.apply_defaults timeout: @config.timeout,
797
+ metadata: @config.metadata,
665
798
  retry_policy: @config.retry_policy
666
799
 
667
800
  @connection_service_stub.call_rpc :set_iam_policy, request, options: options do |response, operation|
@@ -713,6 +846,21 @@ module Google
713
846
  #
714
847
  # @raise [::Google::Cloud::Error] if the RPC is aborted.
715
848
  #
849
+ # @example Basic example
850
+ # require "google/cloud/bigquery/connection/v1"
851
+ #
852
+ # # Create a client object. The client can be reused for multiple calls.
853
+ # client = Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new
854
+ #
855
+ # # Create a request. To set request fields, pass in keyword arguments.
856
+ # request = Google::Iam::V1::TestIamPermissionsRequest.new
857
+ #
858
+ # # Call the test_iam_permissions method.
859
+ # result = client.test_iam_permissions request
860
+ #
861
+ # # The returned object is of type Google::Iam::V1::TestIamPermissionsResponse.
862
+ # p result
863
+ #
716
864
  def test_iam_permissions request, options = nil
717
865
  raise ::ArgumentError, "request must be provided" if request.nil?
718
866
 
@@ -730,16 +878,20 @@ module Google
730
878
  gapic_version: ::Google::Cloud::Bigquery::Connection::V1::VERSION
731
879
  metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
732
880
 
733
- header_params = {
734
- "resource" => request.resource
735
- }
881
+ header_params = {}
882
+ if request.resource
883
+ header_params["resource"] = request.resource
884
+ end
885
+
736
886
  request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
737
887
  metadata[:"x-goog-request-params"] ||= request_params_header
738
888
 
739
889
  options.apply_defaults timeout: @config.rpcs.test_iam_permissions.timeout,
740
890
  metadata: metadata,
741
891
  retry_policy: @config.rpcs.test_iam_permissions.retry_policy
742
- options.apply_defaults metadata: @config.metadata,
892
+
893
+ options.apply_defaults timeout: @config.timeout,
894
+ metadata: @config.metadata,
743
895
  retry_policy: @config.retry_policy
744
896
 
745
897
  @connection_service_stub.call_rpc :test_iam_permissions, request, options: options do |response, operation|
@@ -763,22 +915,21 @@ module Google
763
915
  # Configuration can be applied globally to all clients, or to a single client
764
916
  # on construction.
765
917
  #
766
- # # Examples
767
- #
768
- # To modify the global config, setting the timeout for create_connection
769
- # to 20 seconds, and all remaining timeouts to 10 seconds:
770
- #
771
- # ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.configure do |config|
772
- # config.timeout = 10.0
773
- # config.rpcs.create_connection.timeout = 20.0
774
- # end
775
- #
776
- # To apply the above configuration only to a new client:
777
- #
778
- # client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new do |config|
779
- # config.timeout = 10.0
780
- # config.rpcs.create_connection.timeout = 20.0
781
- # end
918
+ # @example
919
+ #
920
+ # # Modify the global config, setting the timeout for
921
+ # # create_connection to 20 seconds,
922
+ # # and all remaining timeouts to 10 seconds.
923
+ # ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.configure do |config|
924
+ # config.timeout = 10.0
925
+ # config.rpcs.create_connection.timeout = 20.0
926
+ # end
927
+ #
928
+ # # Apply the above configuration only to a new client.
929
+ # client = ::Google::Cloud::Bigquery::Connection::V1::ConnectionService::Client.new do |config|
930
+ # config.timeout = 10.0
931
+ # config.rpcs.create_connection.timeout = 20.0
932
+ # end
782
933
  #
783
934
  # @!attribute [rw] endpoint
784
935
  # The hostname or hostname:port of the service endpoint.
@@ -28,7 +28,7 @@ module Google
28
28
  # Manages external data source connections and credentials.
29
29
  class Service
30
30
 
31
- include GRPC::GenericService
31
+ include ::GRPC::GenericService
32
32
 
33
33
  self.marshal_class_method = :encode
34
34
  self.unmarshal_class_method = :decode
@@ -22,7 +22,7 @@ module Google
22
22
  module Bigquery
23
23
  module Connection
24
24
  module V1
25
- VERSION = "0.4.2"
25
+ VERSION = "0.5.3"
26
26
  end
27
27
  end
28
28
  end
@@ -33,11 +33,7 @@ module Google
33
33
  # // For Kubernetes resources, the format is {api group}/{kind}.
34
34
  # option (google.api.resource) = {
35
35
  # type: "pubsub.googleapis.com/Topic"
36
- # name_descriptor: {
37
- # pattern: "projects/{project}/topics/{topic}"
38
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
39
- # parent_name_extractor: "projects/{project}"
40
- # }
36
+ # pattern: "projects/{project}/topics/{topic}"
41
37
  # };
42
38
  # }
43
39
  #
@@ -45,10 +41,7 @@ module Google
45
41
  #
46
42
  # resources:
47
43
  # - type: "pubsub.googleapis.com/Topic"
48
- # name_descriptor:
49
- # - pattern: "projects/{project}/topics/{topic}"
50
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
51
- # parent_name_extractor: "projects/{project}"
44
+ # pattern: "projects/{project}/topics/{topic}"
52
45
  #
53
46
  # Sometimes, resources have multiple patterns, typically because they can
54
47
  # live under multiple parents.
@@ -58,26 +51,10 @@ module Google
58
51
  # message LogEntry {
59
52
  # option (google.api.resource) = {
60
53
  # type: "logging.googleapis.com/LogEntry"
61
- # name_descriptor: {
62
- # pattern: "projects/{project}/logs/{log}"
63
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
64
- # parent_name_extractor: "projects/{project}"
65
- # }
66
- # name_descriptor: {
67
- # pattern: "folders/{folder}/logs/{log}"
68
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
69
- # parent_name_extractor: "folders/{folder}"
70
- # }
71
- # name_descriptor: {
72
- # pattern: "organizations/{organization}/logs/{log}"
73
- # parent_type: "cloudresourcemanager.googleapis.com/Organization"
74
- # parent_name_extractor: "organizations/{organization}"
75
- # }
76
- # name_descriptor: {
77
- # pattern: "billingAccounts/{billing_account}/logs/{log}"
78
- # parent_type: "billing.googleapis.com/BillingAccount"
79
- # parent_name_extractor: "billingAccounts/{billing_account}"
80
- # }
54
+ # pattern: "projects/{project}/logs/{log}"
55
+ # pattern: "folders/{folder}/logs/{log}"
56
+ # pattern: "organizations/{organization}/logs/{log}"
57
+ # pattern: "billingAccounts/{billing_account}/logs/{log}"
81
58
  # };
82
59
  # }
83
60
  #
@@ -85,48 +62,10 @@ module Google
85
62
  #
86
63
  # resources:
87
64
  # - type: 'logging.googleapis.com/LogEntry'
88
- # name_descriptor:
89
- # - pattern: "projects/{project}/logs/{log}"
90
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
91
- # parent_name_extractor: "projects/{project}"
92
- # - pattern: "folders/{folder}/logs/{log}"
93
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
94
- # parent_name_extractor: "folders/{folder}"
95
- # - pattern: "organizations/{organization}/logs/{log}"
96
- # parent_type: "cloudresourcemanager.googleapis.com/Organization"
97
- # parent_name_extractor: "organizations/{organization}"
98
- # - pattern: "billingAccounts/{billing_account}/logs/{log}"
99
- # parent_type: "billing.googleapis.com/BillingAccount"
100
- # parent_name_extractor: "billingAccounts/{billing_account}"
101
- #
102
- # For flexible resources, the resource name doesn't contain parent names, but
103
- # the resource itself has parents for policy evaluation.
104
- #
105
- # Example:
106
- #
107
- # message Shelf {
108
- # option (google.api.resource) = {
109
- # type: "library.googleapis.com/Shelf"
110
- # name_descriptor: {
111
- # pattern: "shelves/{shelf}"
112
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
113
- # }
114
- # name_descriptor: {
115
- # pattern: "shelves/{shelf}"
116
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
117
- # }
118
- # };
119
- # }
120
- #
121
- # The ResourceDescriptor Yaml config will look like:
122
- #
123
- # resources:
124
- # - type: 'library.googleapis.com/Shelf'
125
- # name_descriptor:
126
- # - pattern: "shelves/{shelf}"
127
- # parent_type: "cloudresourcemanager.googleapis.com/Project"
128
- # - pattern: "shelves/{shelf}"
129
- # parent_type: "cloudresourcemanager.googleapis.com/Folder"
65
+ # pattern: "projects/{project}/logs/{log}"
66
+ # pattern: "folders/{folder}/logs/{log}"
67
+ # pattern: "organizations/{organization}/logs/{log}"
68
+ # pattern: "billingAccounts/{billing_account}/logs/{log}"
130
69
  # @!attribute [rw] type
131
70
  # @return [::String]
132
71
  # The resource type. It must be in the format of
@@ -120,6 +120,9 @@ module Google
120
120
  # @!attribute [rw] aws
121
121
  # @return [::Google::Cloud::Bigquery::Connection::V1::AwsProperties]
122
122
  # Amazon Web Services (AWS) properties.
123
+ # @!attribute [rw] cloud_spanner
124
+ # @return [::Google::Cloud::Bigquery::Connection::V1::CloudSpannerProperties]
125
+ # Cloud Spanner properties.
123
126
  # @!attribute [r] creation_time
124
127
  # @return [::Integer]
125
128
  # Output only. The creation timestamp of the connection.
@@ -176,11 +179,27 @@ module Google
176
179
  extend ::Google::Protobuf::MessageExts::ClassMethods
177
180
  end
178
181
 
182
+ # Connection properties specific to Cloud Spanner.
183
+ # @!attribute [rw] database
184
+ # @return [::String]
185
+ # Cloud Spanner database in the form `project/instance/database'
186
+ # @!attribute [rw] use_parallelism
187
+ # @return [::Boolean]
188
+ # If parallelism should be used when reading from Cloud Spanner
189
+ class CloudSpannerProperties
190
+ include ::Google::Protobuf::MessageExts
191
+ extend ::Google::Protobuf::MessageExts::ClassMethods
192
+ end
193
+
179
194
  # Connection properties specific to Amazon Web Services (AWS).
180
195
  # @!attribute [rw] cross_account_role
181
196
  # @return [::Google::Cloud::Bigquery::Connection::V1::AwsCrossAccountRole]
182
197
  # Authentication using Google owned AWS IAM user's access key to assume
183
198
  # into customer's AWS IAM Role.
199
+ # @!attribute [rw] access_role
200
+ # @return [::Google::Cloud::Bigquery::Connection::V1::AwsAccessRole]
201
+ # Authentication using Google owned service account to assume into
202
+ # customer's AWS IAM Role.
184
203
  class AwsProperties
185
204
  include ::Google::Protobuf::MessageExts
186
205
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -204,6 +223,21 @@ module Google
204
223
  include ::Google::Protobuf::MessageExts
205
224
  extend ::Google::Protobuf::MessageExts::ClassMethods
206
225
  end
226
+
227
+ # Authentication method for Amazon Web Services (AWS) that uses Google owned
228
+ # Google service account to assume into customer's AWS IAM Role.
229
+ # @!attribute [rw] iam_role_id
230
+ # @return [::String]
231
+ # The user’s AWS IAM Role that trusts the Google-owned AWS IAM user
232
+ # Connection.
233
+ # @!attribute [rw] identity
234
+ # @return [::String]
235
+ # A unique Google-owned and Google-generated identity for the Connection.
236
+ # This identity will be used to access the user's AWS IAM Role.
237
+ class AwsAccessRole
238
+ include ::Google::Protobuf::MessageExts
239
+ extend ::Google::Protobuf::MessageExts::ClassMethods
240
+ end
207
241
  end
208
242
  end
209
243
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-bigquery-connection-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.2
4
+ version: 0.5.3
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-07-12 00:00:00.000000000 Z
11
+ date: 2022-01-11 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.5'
19
+ version: '0.7'
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.5'
29
+ version: '0.7'
30
30
  - - "<"
31
31
  - !ruby/object:Gem::Version
32
32
  version: 2.a
@@ -228,7 +228,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
228
228
  - !ruby/object:Gem::Version
229
229
  version: '0'
230
230
  requirements: []
231
- rubygems_version: 3.2.17
231
+ rubygems_version: 3.3.4
232
232
  signing_key:
233
233
  specification_version: 4
234
234
  summary: API Client library for the BigQuery Connection V1 API