google-cloud-alloy_db-v1alpha 0.7.2 → 0.8.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.
@@ -0,0 +1,4262 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2024 Google LLC
4
+ #
5
+ # Licensed under the Apache License, Version 2.0 (the "License");
6
+ # you may not use this file except in compliance with the License.
7
+ # You may obtain a copy of the License at
8
+ #
9
+ # https://www.apache.org/licenses/LICENSE-2.0
10
+ #
11
+ # Unless required by applicable law or agreed to in writing, software
12
+ # distributed under the License is distributed on an "AS IS" BASIS,
13
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14
+ # See the License for the specific language governing permissions and
15
+ # limitations under the License.
16
+
17
+ # Auto-generated by gapic-generator-ruby. DO NOT EDIT!
18
+
19
+ require "google/cloud/errors"
20
+ require "google/cloud/alloydb/v1alpha/service_pb"
21
+ require "google/cloud/alloy_db/v1alpha/alloy_db_admin/rest/service_stub"
22
+ require "google/cloud/location/rest"
23
+ require "google/iam/v1/rest"
24
+
25
+ module Google
26
+ module Cloud
27
+ module AlloyDB
28
+ module V1alpha
29
+ module AlloyDBAdmin
30
+ module Rest
31
+ ##
32
+ # REST client for the AlloyDBAdmin service.
33
+ #
34
+ # Service describing handlers for resources
35
+ #
36
+ class Client
37
+ # @private
38
+ API_VERSION = ""
39
+
40
+ # @private
41
+ DEFAULT_ENDPOINT_TEMPLATE = "alloydb.$UNIVERSE_DOMAIN$"
42
+
43
+ include Paths
44
+
45
+ # @private
46
+ attr_reader :alloy_db_admin_stub
47
+
48
+ ##
49
+ # Configure the AlloyDBAdmin Client class.
50
+ #
51
+ # See {::Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client::Configuration}
52
+ # for a description of the configuration fields.
53
+ #
54
+ # @example
55
+ #
56
+ # # Modify the configuration for all AlloyDBAdmin clients
57
+ # ::Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.configure do |config|
58
+ # config.timeout = 10.0
59
+ # end
60
+ #
61
+ # @yield [config] Configure the Client client.
62
+ # @yieldparam config [Client::Configuration]
63
+ #
64
+ # @return [Client::Configuration]
65
+ #
66
+ def self.configure
67
+ @configure ||= begin
68
+ namespace = ["Google", "Cloud", "AlloyDB", "V1alpha"]
69
+ parent_config = while namespace.any?
70
+ parent_name = namespace.join "::"
71
+ parent_const = const_get parent_name
72
+ break parent_const.configure if parent_const.respond_to? :configure
73
+ namespace.pop
74
+ end
75
+ default_config = Client::Configuration.new parent_config
76
+
77
+ default_config.timeout = 60.0
78
+
79
+ default_config.rpcs.list_clusters.timeout = 60.0
80
+ default_config.rpcs.list_clusters.retry_policy = {
81
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
82
+ }
83
+
84
+ default_config.rpcs.get_cluster.timeout = 60.0
85
+ default_config.rpcs.get_cluster.retry_policy = {
86
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
87
+ }
88
+
89
+ default_config.rpcs.list_instances.timeout = 60.0
90
+ default_config.rpcs.list_instances.retry_policy = {
91
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
92
+ }
93
+
94
+ default_config.rpcs.get_instance.timeout = 60.0
95
+ default_config.rpcs.get_instance.retry_policy = {
96
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
97
+ }
98
+
99
+ default_config.rpcs.list_backups.timeout = 60.0
100
+ default_config.rpcs.list_backups.retry_policy = {
101
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
102
+ }
103
+
104
+ default_config.rpcs.get_backup.timeout = 60.0
105
+ default_config.rpcs.get_backup.retry_policy = {
106
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
107
+ }
108
+
109
+ default_config.rpcs.list_supported_database_flags.timeout = 60.0
110
+ default_config.rpcs.list_supported_database_flags.retry_policy = {
111
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
112
+ }
113
+
114
+ default_config.rpcs.generate_client_certificate.timeout = 60.0
115
+ default_config.rpcs.generate_client_certificate.retry_policy = {
116
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
117
+ }
118
+
119
+ default_config.rpcs.get_connection_info.timeout = 60.0
120
+ default_config.rpcs.get_connection_info.retry_policy = {
121
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
122
+ }
123
+
124
+ default_config.rpcs.list_users.timeout = 60.0
125
+ default_config.rpcs.list_users.retry_policy = {
126
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
127
+ }
128
+
129
+ default_config.rpcs.get_user.timeout = 60.0
130
+ default_config.rpcs.get_user.retry_policy = {
131
+ initial_delay: 1.0, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
132
+ }
133
+
134
+ default_config
135
+ end
136
+ yield @configure if block_given?
137
+ @configure
138
+ end
139
+
140
+ ##
141
+ # Configure the AlloyDBAdmin Client instance.
142
+ #
143
+ # The configuration is set to the derived mode, meaning that values can be changed,
144
+ # but structural changes (adding new fields, etc.) are not allowed. Structural changes
145
+ # should be made on {Client.configure}.
146
+ #
147
+ # See {::Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client::Configuration}
148
+ # for a description of the configuration fields.
149
+ #
150
+ # @yield [config] Configure the Client client.
151
+ # @yieldparam config [Client::Configuration]
152
+ #
153
+ # @return [Client::Configuration]
154
+ #
155
+ def configure
156
+ yield @config if block_given?
157
+ @config
158
+ end
159
+
160
+ ##
161
+ # The effective universe domain
162
+ #
163
+ # @return [String]
164
+ #
165
+ def universe_domain
166
+ @alloy_db_admin_stub.universe_domain
167
+ end
168
+
169
+ ##
170
+ # Create a new AlloyDBAdmin REST client object.
171
+ #
172
+ # @example
173
+ #
174
+ # # Create a client using the default configuration
175
+ # client = ::Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
176
+ #
177
+ # # Create a client using a custom configuration
178
+ # client = ::Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new do |config|
179
+ # config.timeout = 10.0
180
+ # end
181
+ #
182
+ # @yield [config] Configure the AlloyDBAdmin client.
183
+ # @yieldparam config [Client::Configuration]
184
+ #
185
+ def initialize
186
+ # Create the configuration object
187
+ @config = Configuration.new Client.configure
188
+
189
+ # Yield the configuration if needed
190
+ yield @config if block_given?
191
+
192
+ # Create credentials
193
+ credentials = @config.credentials
194
+ # Use self-signed JWT if the endpoint is unchanged from default,
195
+ # but only if the default endpoint does not have a region prefix.
196
+ enable_self_signed_jwt = @config.endpoint.nil? ||
197
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
198
+ !@config.endpoint.split(".").first.include?("-"))
199
+ credentials ||= Credentials.default scope: @config.scope,
200
+ enable_self_signed_jwt: enable_self_signed_jwt
201
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
202
+ credentials = Credentials.new credentials, scope: @config.scope
203
+ end
204
+
205
+ @quota_project_id = @config.quota_project
206
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
207
+
208
+ @operations_client = ::Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Operations.new do |config|
209
+ config.credentials = credentials
210
+ config.quota_project = @quota_project_id
211
+ config.endpoint = @config.endpoint
212
+ config.universe_domain = @config.universe_domain
213
+ end
214
+
215
+ @alloy_db_admin_stub = ::Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::ServiceStub.new(
216
+ endpoint: @config.endpoint,
217
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
218
+ universe_domain: @config.universe_domain,
219
+ credentials: credentials
220
+ )
221
+
222
+ @location_client = Google::Cloud::Location::Locations::Rest::Client.new do |config|
223
+ config.credentials = credentials
224
+ config.quota_project = @quota_project_id
225
+ config.endpoint = @alloy_db_admin_stub.endpoint
226
+ config.universe_domain = @alloy_db_admin_stub.universe_domain
227
+ config.bindings_override = @config.bindings_override
228
+ end
229
+
230
+ @iam_policy_client = Google::Iam::V1::IAMPolicy::Rest::Client.new do |config|
231
+ config.credentials = credentials
232
+ config.quota_project = @quota_project_id
233
+ config.endpoint = @alloy_db_admin_stub.endpoint
234
+ config.universe_domain = @alloy_db_admin_stub.universe_domain
235
+ end
236
+ end
237
+
238
+ ##
239
+ # Get the associated client for long-running operations.
240
+ #
241
+ # @return [::Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Operations]
242
+ #
243
+ attr_reader :operations_client
244
+
245
+ ##
246
+ # Get the associated client for mix-in of the Locations.
247
+ #
248
+ # @return [Google::Cloud::Location::Locations::Rest::Client]
249
+ #
250
+ attr_reader :location_client
251
+
252
+ ##
253
+ # Get the associated client for mix-in of the IAMPolicy.
254
+ #
255
+ # @return [Google::Iam::V1::IAMPolicy::Rest::Client]
256
+ #
257
+ attr_reader :iam_policy_client
258
+
259
+ # Service calls
260
+
261
+ ##
262
+ # Lists Clusters in a given project and location.
263
+ #
264
+ # @overload list_clusters(request, options = nil)
265
+ # Pass arguments to `list_clusters` via a request object, either of type
266
+ # {::Google::Cloud::AlloyDB::V1alpha::ListClustersRequest} or an equivalent Hash.
267
+ #
268
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::ListClustersRequest, ::Hash]
269
+ # A request object representing the call parameters. Required. To specify no
270
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
271
+ # @param options [::Gapic::CallOptions, ::Hash]
272
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
273
+ #
274
+ # @overload list_clusters(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
275
+ # Pass arguments to `list_clusters` via keyword arguments. Note that at
276
+ # least one keyword argument is required. To specify no parameters, or to keep all
277
+ # the default parameter values, pass an empty Hash as a request object (see above).
278
+ #
279
+ # @param parent [::String]
280
+ # Required. The name of the parent resource. For the required format, see the
281
+ # comment on the Cluster.name field. Additionally, you can perform an
282
+ # aggregated list operation by specifying a value with the following format:
283
+ # * projects/\\{project}/locations/-
284
+ # @param page_size [::Integer]
285
+ # Optional. Requested page size. Server may return fewer items than
286
+ # requested. If unspecified, server will pick an appropriate default.
287
+ # @param page_token [::String]
288
+ # A token identifying a page of results the server should return.
289
+ # @param filter [::String]
290
+ # Optional. Filtering results
291
+ # @param order_by [::String]
292
+ # Optional. Hint for how to order the results
293
+ # @yield [result, operation] Access the result along with the TransportOperation object
294
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::ListClustersResponse]
295
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
296
+ #
297
+ # @return [::Google::Cloud::AlloyDB::V1alpha::ListClustersResponse]
298
+ #
299
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
300
+ #
301
+ # @example Basic example
302
+ # require "google/cloud/alloy_db/v1alpha"
303
+ #
304
+ # # Create a client object. The client can be reused for multiple calls.
305
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
306
+ #
307
+ # # Create a request. To set request fields, pass in keyword arguments.
308
+ # request = Google::Cloud::AlloyDB::V1alpha::ListClustersRequest.new
309
+ #
310
+ # # Call the list_clusters method.
311
+ # result = client.list_clusters request
312
+ #
313
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
314
+ # # over elements, and API calls will be issued to fetch pages as needed.
315
+ # result.each do |item|
316
+ # # Each element is of type ::Google::Cloud::AlloyDB::V1alpha::Cluster.
317
+ # p item
318
+ # end
319
+ #
320
+ def list_clusters request, options = nil
321
+ raise ::ArgumentError, "request must be provided" if request.nil?
322
+
323
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::ListClustersRequest
324
+
325
+ # Converts hash and nil to an options object
326
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
327
+
328
+ # Customize the options with defaults
329
+ call_metadata = @config.rpcs.list_clusters.metadata.to_h
330
+
331
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
332
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
333
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
334
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
335
+ transports_version_send: [:rest]
336
+
337
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
338
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
339
+
340
+ options.apply_defaults timeout: @config.rpcs.list_clusters.timeout,
341
+ metadata: call_metadata,
342
+ retry_policy: @config.rpcs.list_clusters.retry_policy
343
+
344
+ options.apply_defaults timeout: @config.timeout,
345
+ metadata: @config.metadata,
346
+ retry_policy: @config.retry_policy
347
+
348
+ @alloy_db_admin_stub.list_clusters request, options do |result, operation|
349
+ yield result, operation if block_given?
350
+ return result
351
+ end
352
+ rescue ::Gapic::Rest::Error => e
353
+ raise ::Google::Cloud::Error.from_error(e)
354
+ end
355
+
356
+ ##
357
+ # Gets details of a single Cluster.
358
+ #
359
+ # @overload get_cluster(request, options = nil)
360
+ # Pass arguments to `get_cluster` via a request object, either of type
361
+ # {::Google::Cloud::AlloyDB::V1alpha::GetClusterRequest} or an equivalent Hash.
362
+ #
363
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::GetClusterRequest, ::Hash]
364
+ # A request object representing the call parameters. Required. To specify no
365
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
366
+ # @param options [::Gapic::CallOptions, ::Hash]
367
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
368
+ #
369
+ # @overload get_cluster(name: nil, view: nil)
370
+ # Pass arguments to `get_cluster` via keyword arguments. Note that at
371
+ # least one keyword argument is required. To specify no parameters, or to keep all
372
+ # the default parameter values, pass an empty Hash as a request object (see above).
373
+ #
374
+ # @param name [::String]
375
+ # Required. The name of the resource. For the required format, see the
376
+ # comment on the Cluster.name field.
377
+ # @param view [::Google::Cloud::AlloyDB::V1alpha::ClusterView]
378
+ # Optional. The view of the cluster to return. Returns all default fields if
379
+ # not set.
380
+ # @yield [result, operation] Access the result along with the TransportOperation object
381
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::Cluster]
382
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
383
+ #
384
+ # @return [::Google::Cloud::AlloyDB::V1alpha::Cluster]
385
+ #
386
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
387
+ #
388
+ # @example Basic example
389
+ # require "google/cloud/alloy_db/v1alpha"
390
+ #
391
+ # # Create a client object. The client can be reused for multiple calls.
392
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
393
+ #
394
+ # # Create a request. To set request fields, pass in keyword arguments.
395
+ # request = Google::Cloud::AlloyDB::V1alpha::GetClusterRequest.new
396
+ #
397
+ # # Call the get_cluster method.
398
+ # result = client.get_cluster request
399
+ #
400
+ # # The returned object is of type Google::Cloud::AlloyDB::V1alpha::Cluster.
401
+ # p result
402
+ #
403
+ def get_cluster request, options = nil
404
+ raise ::ArgumentError, "request must be provided" if request.nil?
405
+
406
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::GetClusterRequest
407
+
408
+ # Converts hash and nil to an options object
409
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
410
+
411
+ # Customize the options with defaults
412
+ call_metadata = @config.rpcs.get_cluster.metadata.to_h
413
+
414
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
415
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
416
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
417
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
418
+ transports_version_send: [:rest]
419
+
420
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
421
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
422
+
423
+ options.apply_defaults timeout: @config.rpcs.get_cluster.timeout,
424
+ metadata: call_metadata,
425
+ retry_policy: @config.rpcs.get_cluster.retry_policy
426
+
427
+ options.apply_defaults timeout: @config.timeout,
428
+ metadata: @config.metadata,
429
+ retry_policy: @config.retry_policy
430
+
431
+ @alloy_db_admin_stub.get_cluster request, options do |result, operation|
432
+ yield result, operation if block_given?
433
+ return result
434
+ end
435
+ rescue ::Gapic::Rest::Error => e
436
+ raise ::Google::Cloud::Error.from_error(e)
437
+ end
438
+
439
+ ##
440
+ # Creates a new Cluster in a given project and location.
441
+ #
442
+ # @overload create_cluster(request, options = nil)
443
+ # Pass arguments to `create_cluster` via a request object, either of type
444
+ # {::Google::Cloud::AlloyDB::V1alpha::CreateClusterRequest} or an equivalent Hash.
445
+ #
446
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::CreateClusterRequest, ::Hash]
447
+ # A request object representing the call parameters. Required. To specify no
448
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
449
+ # @param options [::Gapic::CallOptions, ::Hash]
450
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
451
+ #
452
+ # @overload create_cluster(parent: nil, cluster_id: nil, cluster: nil, request_id: nil, validate_only: nil)
453
+ # Pass arguments to `create_cluster` via keyword arguments. Note that at
454
+ # least one keyword argument is required. To specify no parameters, or to keep all
455
+ # the default parameter values, pass an empty Hash as a request object (see above).
456
+ #
457
+ # @param parent [::String]
458
+ # Required. The location of the new cluster. For the required format, see the
459
+ # comment on the Cluster.name field.
460
+ # @param cluster_id [::String]
461
+ # Required. ID of the requesting object.
462
+ # @param cluster [::Google::Cloud::AlloyDB::V1alpha::Cluster, ::Hash]
463
+ # Required. The resource being created
464
+ # @param request_id [::String]
465
+ # Optional. An optional request ID to identify requests. Specify a unique
466
+ # request ID so that if you must retry your request, the server ignores the
467
+ # request if it has already been completed. The server guarantees that for at
468
+ # least 60 minutes since the first request.
469
+ #
470
+ # For example, consider a situation where you make an initial request and
471
+ # the request times out. If you make the request again with the same request
472
+ # ID, the server can check if the original operation with the same request ID
473
+ # was received, and if so, ignores the second request. This prevents
474
+ # clients from accidentally creating duplicate commitments.
475
+ #
476
+ # The request ID must be a valid UUID with the exception that zero UUID is
477
+ # not supported (00000000-0000-0000-0000-000000000000).
478
+ # @param validate_only [::Boolean]
479
+ # Optional. If set, performs request validation, for example, permission
480
+ # checks and any other type of validation, but does not actually execute the
481
+ # create request.
482
+ # @yield [result, operation] Access the result along with the TransportOperation object
483
+ # @yieldparam result [::Gapic::Operation]
484
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
485
+ #
486
+ # @return [::Gapic::Operation]
487
+ #
488
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
489
+ #
490
+ # @example Basic example
491
+ # require "google/cloud/alloy_db/v1alpha"
492
+ #
493
+ # # Create a client object. The client can be reused for multiple calls.
494
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
495
+ #
496
+ # # Create a request. To set request fields, pass in keyword arguments.
497
+ # request = Google::Cloud::AlloyDB::V1alpha::CreateClusterRequest.new
498
+ #
499
+ # # Call the create_cluster method.
500
+ # result = client.create_cluster request
501
+ #
502
+ # # The returned object is of type Gapic::Operation. You can use it to
503
+ # # check the status of an operation, cancel it, or wait for results.
504
+ # # Here is how to wait for a response.
505
+ # result.wait_until_done! timeout: 60
506
+ # if result.response?
507
+ # p result.response
508
+ # else
509
+ # puts "No response received."
510
+ # end
511
+ #
512
+ def create_cluster request, options = nil
513
+ raise ::ArgumentError, "request must be provided" if request.nil?
514
+
515
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::CreateClusterRequest
516
+
517
+ # Converts hash and nil to an options object
518
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
519
+
520
+ # Customize the options with defaults
521
+ call_metadata = @config.rpcs.create_cluster.metadata.to_h
522
+
523
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
524
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
525
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
526
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
527
+ transports_version_send: [:rest]
528
+
529
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
530
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
531
+
532
+ options.apply_defaults timeout: @config.rpcs.create_cluster.timeout,
533
+ metadata: call_metadata,
534
+ retry_policy: @config.rpcs.create_cluster.retry_policy
535
+
536
+ options.apply_defaults timeout: @config.timeout,
537
+ metadata: @config.metadata,
538
+ retry_policy: @config.retry_policy
539
+
540
+ @alloy_db_admin_stub.create_cluster request, options do |result, operation|
541
+ result = ::Gapic::Operation.new result, @operations_client, options: options
542
+ yield result, operation if block_given?
543
+ return result
544
+ end
545
+ rescue ::Gapic::Rest::Error => e
546
+ raise ::Google::Cloud::Error.from_error(e)
547
+ end
548
+
549
+ ##
550
+ # Updates the parameters of a single Cluster.
551
+ #
552
+ # @overload update_cluster(request, options = nil)
553
+ # Pass arguments to `update_cluster` via a request object, either of type
554
+ # {::Google::Cloud::AlloyDB::V1alpha::UpdateClusterRequest} or an equivalent Hash.
555
+ #
556
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::UpdateClusterRequest, ::Hash]
557
+ # A request object representing the call parameters. Required. To specify no
558
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
559
+ # @param options [::Gapic::CallOptions, ::Hash]
560
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
561
+ #
562
+ # @overload update_cluster(update_mask: nil, cluster: nil, request_id: nil, validate_only: nil, allow_missing: nil)
563
+ # Pass arguments to `update_cluster` via keyword arguments. Note that at
564
+ # least one keyword argument is required. To specify no parameters, or to keep all
565
+ # the default parameter values, pass an empty Hash as a request object (see above).
566
+ #
567
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
568
+ # Optional. Field mask is used to specify the fields to be overwritten in the
569
+ # Cluster resource by the update.
570
+ # The fields specified in the update_mask are relative to the resource, not
571
+ # the full request. A field will be overwritten if it is in the mask. If the
572
+ # user does not provide a mask then all fields will be overwritten.
573
+ # @param cluster [::Google::Cloud::AlloyDB::V1alpha::Cluster, ::Hash]
574
+ # Required. The resource being updated
575
+ # @param request_id [::String]
576
+ # Optional. An optional request ID to identify requests. Specify a unique
577
+ # request ID so that if you must retry your request, the server ignores the
578
+ # request if it has already been completed. The server guarantees that for at
579
+ # least 60 minutes since the first request.
580
+ #
581
+ # For example, consider a situation where you make an initial request and
582
+ # the request times out. If you make the request again with the same request
583
+ # ID, the server can check if the original operation with the same request ID
584
+ # was received, and if so, ignores the second request. This prevents
585
+ # clients from accidentally creating duplicate commitments.
586
+ #
587
+ # The request ID must be a valid UUID with the exception that zero UUID is
588
+ # not supported (00000000-0000-0000-0000-000000000000).
589
+ # @param validate_only [::Boolean]
590
+ # Optional. If set, performs request validation, for example, permission
591
+ # checks and any other type of validation, but does not actually execute the
592
+ # create request.
593
+ # @param allow_missing [::Boolean]
594
+ # Optional. If set to true, update succeeds even if cluster is not found. In
595
+ # that case, a new cluster is created and `update_mask` is ignored.
596
+ # @yield [result, operation] Access the result along with the TransportOperation object
597
+ # @yieldparam result [::Gapic::Operation]
598
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
599
+ #
600
+ # @return [::Gapic::Operation]
601
+ #
602
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
603
+ #
604
+ # @example Basic example
605
+ # require "google/cloud/alloy_db/v1alpha"
606
+ #
607
+ # # Create a client object. The client can be reused for multiple calls.
608
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
609
+ #
610
+ # # Create a request. To set request fields, pass in keyword arguments.
611
+ # request = Google::Cloud::AlloyDB::V1alpha::UpdateClusterRequest.new
612
+ #
613
+ # # Call the update_cluster method.
614
+ # result = client.update_cluster request
615
+ #
616
+ # # The returned object is of type Gapic::Operation. You can use it to
617
+ # # check the status of an operation, cancel it, or wait for results.
618
+ # # Here is how to wait for a response.
619
+ # result.wait_until_done! timeout: 60
620
+ # if result.response?
621
+ # p result.response
622
+ # else
623
+ # puts "No response received."
624
+ # end
625
+ #
626
+ def update_cluster request, options = nil
627
+ raise ::ArgumentError, "request must be provided" if request.nil?
628
+
629
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::UpdateClusterRequest
630
+
631
+ # Converts hash and nil to an options object
632
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
633
+
634
+ # Customize the options with defaults
635
+ call_metadata = @config.rpcs.update_cluster.metadata.to_h
636
+
637
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
638
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
639
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
640
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
641
+ transports_version_send: [:rest]
642
+
643
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
644
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
645
+
646
+ options.apply_defaults timeout: @config.rpcs.update_cluster.timeout,
647
+ metadata: call_metadata,
648
+ retry_policy: @config.rpcs.update_cluster.retry_policy
649
+
650
+ options.apply_defaults timeout: @config.timeout,
651
+ metadata: @config.metadata,
652
+ retry_policy: @config.retry_policy
653
+
654
+ @alloy_db_admin_stub.update_cluster request, options do |result, operation|
655
+ result = ::Gapic::Operation.new result, @operations_client, options: options
656
+ yield result, operation if block_given?
657
+ return result
658
+ end
659
+ rescue ::Gapic::Rest::Error => e
660
+ raise ::Google::Cloud::Error.from_error(e)
661
+ end
662
+
663
+ ##
664
+ # Upgrades a single Cluster.
665
+ # Imperative only.
666
+ #
667
+ # @overload upgrade_cluster(request, options = nil)
668
+ # Pass arguments to `upgrade_cluster` via a request object, either of type
669
+ # {::Google::Cloud::AlloyDB::V1alpha::UpgradeClusterRequest} or an equivalent Hash.
670
+ #
671
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::UpgradeClusterRequest, ::Hash]
672
+ # A request object representing the call parameters. Required. To specify no
673
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
674
+ # @param options [::Gapic::CallOptions, ::Hash]
675
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
676
+ #
677
+ # @overload upgrade_cluster(name: nil, version: nil, request_id: nil, validate_only: nil, etag: nil)
678
+ # Pass arguments to `upgrade_cluster` via keyword arguments. Note that at
679
+ # least one keyword argument is required. To specify no parameters, or to keep all
680
+ # the default parameter values, pass an empty Hash as a request object (see above).
681
+ #
682
+ # @param name [::String]
683
+ # Required. The resource name of the cluster.
684
+ # @param version [::Google::Cloud::AlloyDB::V1alpha::DatabaseVersion]
685
+ # Required. The version the cluster is going to be upgraded to.
686
+ # @param request_id [::String]
687
+ # Optional. An optional request ID to identify requests. Specify a unique
688
+ # request ID so that if you must retry your request, the server ignores the
689
+ # request if it has already been completed. The server guarantees that for at
690
+ # least 60 minutes since the first request.
691
+ #
692
+ # For example, consider a situation where you make an initial request and
693
+ # the request times out. If you make the request again with the same request
694
+ # ID, the server can check if the original operation with the same request ID
695
+ # was received, and if so, ignores the second request. This prevents
696
+ # clients from accidentally creating duplicate commitments.
697
+ #
698
+ # The request ID must be a valid UUID with the exception that zero UUID is
699
+ # not supported (00000000-0000-0000-0000-000000000000).
700
+ # @param validate_only [::Boolean]
701
+ # Optional. If set, performs request validation, for example, permission
702
+ # checks and any other type of validation, but does not actually execute the
703
+ # create request.
704
+ # @param etag [::String]
705
+ # Optional. The current etag of the Cluster.
706
+ # If an etag is provided and does not match the current etag of the Cluster,
707
+ # upgrade will be blocked and an ABORTED error will be returned.
708
+ # @yield [result, operation] Access the result along with the TransportOperation object
709
+ # @yieldparam result [::Gapic::Operation]
710
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
711
+ #
712
+ # @return [::Gapic::Operation]
713
+ #
714
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
715
+ #
716
+ # @example Basic example
717
+ # require "google/cloud/alloy_db/v1alpha"
718
+ #
719
+ # # Create a client object. The client can be reused for multiple calls.
720
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
721
+ #
722
+ # # Create a request. To set request fields, pass in keyword arguments.
723
+ # request = Google::Cloud::AlloyDB::V1alpha::UpgradeClusterRequest.new
724
+ #
725
+ # # Call the upgrade_cluster method.
726
+ # result = client.upgrade_cluster request
727
+ #
728
+ # # The returned object is of type Gapic::Operation. You can use it to
729
+ # # check the status of an operation, cancel it, or wait for results.
730
+ # # Here is how to wait for a response.
731
+ # result.wait_until_done! timeout: 60
732
+ # if result.response?
733
+ # p result.response
734
+ # else
735
+ # puts "No response received."
736
+ # end
737
+ #
738
+ def upgrade_cluster request, options = nil
739
+ raise ::ArgumentError, "request must be provided" if request.nil?
740
+
741
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::UpgradeClusterRequest
742
+
743
+ # Converts hash and nil to an options object
744
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
745
+
746
+ # Customize the options with defaults
747
+ call_metadata = @config.rpcs.upgrade_cluster.metadata.to_h
748
+
749
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
750
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
751
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
752
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
753
+ transports_version_send: [:rest]
754
+
755
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
756
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
757
+
758
+ options.apply_defaults timeout: @config.rpcs.upgrade_cluster.timeout,
759
+ metadata: call_metadata,
760
+ retry_policy: @config.rpcs.upgrade_cluster.retry_policy
761
+
762
+ options.apply_defaults timeout: @config.timeout,
763
+ metadata: @config.metadata,
764
+ retry_policy: @config.retry_policy
765
+
766
+ @alloy_db_admin_stub.upgrade_cluster request, options do |result, operation|
767
+ result = ::Gapic::Operation.new result, @operations_client, options: options
768
+ yield result, operation if block_given?
769
+ return result
770
+ end
771
+ rescue ::Gapic::Rest::Error => e
772
+ raise ::Google::Cloud::Error.from_error(e)
773
+ end
774
+
775
+ ##
776
+ # Deletes a single Cluster.
777
+ #
778
+ # @overload delete_cluster(request, options = nil)
779
+ # Pass arguments to `delete_cluster` via a request object, either of type
780
+ # {::Google::Cloud::AlloyDB::V1alpha::DeleteClusterRequest} or an equivalent Hash.
781
+ #
782
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::DeleteClusterRequest, ::Hash]
783
+ # A request object representing the call parameters. Required. To specify no
784
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
785
+ # @param options [::Gapic::CallOptions, ::Hash]
786
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
787
+ #
788
+ # @overload delete_cluster(name: nil, request_id: nil, etag: nil, validate_only: nil, force: nil)
789
+ # Pass arguments to `delete_cluster` via keyword arguments. Note that at
790
+ # least one keyword argument is required. To specify no parameters, or to keep all
791
+ # the default parameter values, pass an empty Hash as a request object (see above).
792
+ #
793
+ # @param name [::String]
794
+ # Required. The name of the resource. For the required format, see the
795
+ # comment on the Cluster.name field.
796
+ # @param request_id [::String]
797
+ # Optional. An optional request ID to identify requests. Specify a unique
798
+ # request ID so that if you must retry your request, the server ignores the
799
+ # request if it has already been completed. The server guarantees that for at
800
+ # least 60 minutes since the first request.
801
+ #
802
+ # For example, consider a situation where you make an initial request and
803
+ # the request times out. If you make the request again with the same request
804
+ # ID, the server can check if the original operation with the same request ID
805
+ # was received, and if so, ignores the second request. This prevents
806
+ # clients from accidentally creating duplicate commitments.
807
+ #
808
+ # The request ID must be a valid UUID with the exception that zero UUID is
809
+ # not supported (00000000-0000-0000-0000-000000000000).
810
+ # @param etag [::String]
811
+ # Optional. The current etag of the Cluster.
812
+ # If an etag is provided and does not match the current etag of the Cluster,
813
+ # deletion will be blocked and an ABORTED error will be returned.
814
+ # @param validate_only [::Boolean]
815
+ # Optional. If set, performs request validation, for example, permission
816
+ # checks and any other type of validation, but does not actually execute the
817
+ # create request.
818
+ # @param force [::Boolean]
819
+ # Optional. Whether to cascade delete child instances for given cluster.
820
+ # @yield [result, operation] Access the result along with the TransportOperation object
821
+ # @yieldparam result [::Gapic::Operation]
822
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
823
+ #
824
+ # @return [::Gapic::Operation]
825
+ #
826
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
827
+ #
828
+ # @example Basic example
829
+ # require "google/cloud/alloy_db/v1alpha"
830
+ #
831
+ # # Create a client object. The client can be reused for multiple calls.
832
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
833
+ #
834
+ # # Create a request. To set request fields, pass in keyword arguments.
835
+ # request = Google::Cloud::AlloyDB::V1alpha::DeleteClusterRequest.new
836
+ #
837
+ # # Call the delete_cluster method.
838
+ # result = client.delete_cluster request
839
+ #
840
+ # # The returned object is of type Gapic::Operation. You can use it to
841
+ # # check the status of an operation, cancel it, or wait for results.
842
+ # # Here is how to wait for a response.
843
+ # result.wait_until_done! timeout: 60
844
+ # if result.response?
845
+ # p result.response
846
+ # else
847
+ # puts "No response received."
848
+ # end
849
+ #
850
+ def delete_cluster request, options = nil
851
+ raise ::ArgumentError, "request must be provided" if request.nil?
852
+
853
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::DeleteClusterRequest
854
+
855
+ # Converts hash and nil to an options object
856
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
857
+
858
+ # Customize the options with defaults
859
+ call_metadata = @config.rpcs.delete_cluster.metadata.to_h
860
+
861
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
862
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
863
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
864
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
865
+ transports_version_send: [:rest]
866
+
867
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
868
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
869
+
870
+ options.apply_defaults timeout: @config.rpcs.delete_cluster.timeout,
871
+ metadata: call_metadata,
872
+ retry_policy: @config.rpcs.delete_cluster.retry_policy
873
+
874
+ options.apply_defaults timeout: @config.timeout,
875
+ metadata: @config.metadata,
876
+ retry_policy: @config.retry_policy
877
+
878
+ @alloy_db_admin_stub.delete_cluster request, options do |result, operation|
879
+ result = ::Gapic::Operation.new result, @operations_client, options: options
880
+ yield result, operation if block_given?
881
+ return result
882
+ end
883
+ rescue ::Gapic::Rest::Error => e
884
+ raise ::Google::Cloud::Error.from_error(e)
885
+ end
886
+
887
+ ##
888
+ # Promotes a SECONDARY cluster. This turns down replication
889
+ # from the PRIMARY cluster and promotes a secondary cluster
890
+ # into its own standalone cluster.
891
+ # Imperative only.
892
+ #
893
+ # @overload promote_cluster(request, options = nil)
894
+ # Pass arguments to `promote_cluster` via a request object, either of type
895
+ # {::Google::Cloud::AlloyDB::V1alpha::PromoteClusterRequest} or an equivalent Hash.
896
+ #
897
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::PromoteClusterRequest, ::Hash]
898
+ # A request object representing the call parameters. Required. To specify no
899
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
900
+ # @param options [::Gapic::CallOptions, ::Hash]
901
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
902
+ #
903
+ # @overload promote_cluster(name: nil, request_id: nil, etag: nil, validate_only: nil)
904
+ # Pass arguments to `promote_cluster` via keyword arguments. Note that at
905
+ # least one keyword argument is required. To specify no parameters, or to keep all
906
+ # the default parameter values, pass an empty Hash as a request object (see above).
907
+ #
908
+ # @param name [::String]
909
+ # Required. The name of the resource. For the required format, see the
910
+ # comment on the Cluster.name field
911
+ # @param request_id [::String]
912
+ # Optional. An optional request ID to identify requests. Specify a unique
913
+ # request ID so that if you must retry your request, the server ignores the
914
+ # request if it has already been completed. The server guarantees that for at
915
+ # least 60 minutes since the first request.
916
+ #
917
+ # For example, consider a situation where you make an initial request and
918
+ # the request times out. If you make the request again with the same request
919
+ # ID, the server can check if original operation with the same request ID
920
+ # was received, and if so, will ignore the second request. This prevents
921
+ # clients from accidentally creating duplicate commitments.
922
+ #
923
+ # The request ID must be a valid UUID with the exception that zero UUID is
924
+ # not supported (00000000-0000-0000-0000-000000000000).
925
+ # @param etag [::String]
926
+ # Optional. The current etag of the Cluster.
927
+ # If an etag is provided and does not match the current etag of the Cluster,
928
+ # deletion will be blocked and an ABORTED error will be returned.
929
+ # @param validate_only [::Boolean]
930
+ # Optional. If set, performs request validation, for example, permission
931
+ # checks and any other type of validation, but does not actually execute the
932
+ # create request.
933
+ # @yield [result, operation] Access the result along with the TransportOperation object
934
+ # @yieldparam result [::Gapic::Operation]
935
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
936
+ #
937
+ # @return [::Gapic::Operation]
938
+ #
939
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
940
+ #
941
+ # @example Basic example
942
+ # require "google/cloud/alloy_db/v1alpha"
943
+ #
944
+ # # Create a client object. The client can be reused for multiple calls.
945
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
946
+ #
947
+ # # Create a request. To set request fields, pass in keyword arguments.
948
+ # request = Google::Cloud::AlloyDB::V1alpha::PromoteClusterRequest.new
949
+ #
950
+ # # Call the promote_cluster method.
951
+ # result = client.promote_cluster request
952
+ #
953
+ # # The returned object is of type Gapic::Operation. You can use it to
954
+ # # check the status of an operation, cancel it, or wait for results.
955
+ # # Here is how to wait for a response.
956
+ # result.wait_until_done! timeout: 60
957
+ # if result.response?
958
+ # p result.response
959
+ # else
960
+ # puts "No response received."
961
+ # end
962
+ #
963
+ def promote_cluster request, options = nil
964
+ raise ::ArgumentError, "request must be provided" if request.nil?
965
+
966
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::PromoteClusterRequest
967
+
968
+ # Converts hash and nil to an options object
969
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
970
+
971
+ # Customize the options with defaults
972
+ call_metadata = @config.rpcs.promote_cluster.metadata.to_h
973
+
974
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
975
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
976
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
977
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
978
+ transports_version_send: [:rest]
979
+
980
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
981
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
982
+
983
+ options.apply_defaults timeout: @config.rpcs.promote_cluster.timeout,
984
+ metadata: call_metadata,
985
+ retry_policy: @config.rpcs.promote_cluster.retry_policy
986
+
987
+ options.apply_defaults timeout: @config.timeout,
988
+ metadata: @config.metadata,
989
+ retry_policy: @config.retry_policy
990
+
991
+ @alloy_db_admin_stub.promote_cluster request, options do |result, operation|
992
+ result = ::Gapic::Operation.new result, @operations_client, options: options
993
+ yield result, operation if block_given?
994
+ return result
995
+ end
996
+ rescue ::Gapic::Rest::Error => e
997
+ raise ::Google::Cloud::Error.from_error(e)
998
+ end
999
+
1000
+ ##
1001
+ # Switches the roles of PRIMARY and SECONDARY clusters without any data loss.
1002
+ # This promotes the SECONDARY cluster to PRIMARY and sets up the original
1003
+ # PRIMARY cluster to replicate from this newly promoted cluster.
1004
+ #
1005
+ # @overload switchover_cluster(request, options = nil)
1006
+ # Pass arguments to `switchover_cluster` via a request object, either of type
1007
+ # {::Google::Cloud::AlloyDB::V1alpha::SwitchoverClusterRequest} or an equivalent Hash.
1008
+ #
1009
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::SwitchoverClusterRequest, ::Hash]
1010
+ # A request object representing the call parameters. Required. To specify no
1011
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1012
+ # @param options [::Gapic::CallOptions, ::Hash]
1013
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1014
+ #
1015
+ # @overload switchover_cluster(name: nil, request_id: nil, validate_only: nil)
1016
+ # Pass arguments to `switchover_cluster` via keyword arguments. Note that at
1017
+ # least one keyword argument is required. To specify no parameters, or to keep all
1018
+ # the default parameter values, pass an empty Hash as a request object (see above).
1019
+ #
1020
+ # @param name [::String]
1021
+ # Required. The name of the resource. For the required format, see the
1022
+ # comment on the Cluster.name field
1023
+ # @param request_id [::String]
1024
+ # Optional. An optional request ID to identify requests. Specify a unique
1025
+ # request ID so that if you must retry your request, the server ignores the
1026
+ # request if it has already been completed. The server guarantees that for at
1027
+ # least 60 minutes since the first request.
1028
+ #
1029
+ # For example, consider a situation where you make an initial request and
1030
+ # the request times out. If you make the request again with the same request
1031
+ # ID, the server can check if the original operation with the same request ID
1032
+ # was received, and if so, ignores the second request. This prevents
1033
+ # clients from accidentally creating duplicate commitments.
1034
+ #
1035
+ # The request ID must be a valid UUID with the exception that zero UUID is
1036
+ # not supported (00000000-0000-0000-0000-000000000000).
1037
+ # @param validate_only [::Boolean]
1038
+ # Optional. If set, performs request validation, for example, permission
1039
+ # checks and any other type of validation, but does not actually execute the
1040
+ # create request.
1041
+ # @yield [result, operation] Access the result along with the TransportOperation object
1042
+ # @yieldparam result [::Gapic::Operation]
1043
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1044
+ #
1045
+ # @return [::Gapic::Operation]
1046
+ #
1047
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1048
+ #
1049
+ # @example Basic example
1050
+ # require "google/cloud/alloy_db/v1alpha"
1051
+ #
1052
+ # # Create a client object. The client can be reused for multiple calls.
1053
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
1054
+ #
1055
+ # # Create a request. To set request fields, pass in keyword arguments.
1056
+ # request = Google::Cloud::AlloyDB::V1alpha::SwitchoverClusterRequest.new
1057
+ #
1058
+ # # Call the switchover_cluster method.
1059
+ # result = client.switchover_cluster request
1060
+ #
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.
1064
+ # result.wait_until_done! timeout: 60
1065
+ # if result.response?
1066
+ # p result.response
1067
+ # else
1068
+ # puts "No response received."
1069
+ # end
1070
+ #
1071
+ def switchover_cluster request, options = nil
1072
+ raise ::ArgumentError, "request must be provided" if request.nil?
1073
+
1074
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::SwitchoverClusterRequest
1075
+
1076
+ # Converts hash and nil to an options object
1077
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1078
+
1079
+ # Customize the options with defaults
1080
+ call_metadata = @config.rpcs.switchover_cluster.metadata.to_h
1081
+
1082
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1083
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1084
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1085
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
1086
+ transports_version_send: [:rest]
1087
+
1088
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1089
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1090
+
1091
+ options.apply_defaults timeout: @config.rpcs.switchover_cluster.timeout,
1092
+ metadata: call_metadata,
1093
+ retry_policy: @config.rpcs.switchover_cluster.retry_policy
1094
+
1095
+ options.apply_defaults timeout: @config.timeout,
1096
+ metadata: @config.metadata,
1097
+ retry_policy: @config.retry_policy
1098
+
1099
+ @alloy_db_admin_stub.switchover_cluster request, options do |result, operation|
1100
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1101
+ yield result, operation if block_given?
1102
+ return result
1103
+ end
1104
+ rescue ::Gapic::Rest::Error => e
1105
+ raise ::Google::Cloud::Error.from_error(e)
1106
+ end
1107
+
1108
+ ##
1109
+ # Creates a new Cluster in a given project and location, with a volume
1110
+ # restored from the provided source, either a backup ID or a point-in-time
1111
+ # and a source cluster.
1112
+ #
1113
+ # @overload restore_cluster(request, options = nil)
1114
+ # Pass arguments to `restore_cluster` via a request object, either of type
1115
+ # {::Google::Cloud::AlloyDB::V1alpha::RestoreClusterRequest} or an equivalent Hash.
1116
+ #
1117
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::RestoreClusterRequest, ::Hash]
1118
+ # A request object representing the call parameters. Required. To specify no
1119
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1120
+ # @param options [::Gapic::CallOptions, ::Hash]
1121
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1122
+ #
1123
+ # @overload restore_cluster(backup_source: nil, continuous_backup_source: nil, parent: nil, cluster_id: nil, cluster: nil, request_id: nil, validate_only: nil)
1124
+ # Pass arguments to `restore_cluster` via keyword arguments. Note that at
1125
+ # least one keyword argument is required. To specify no parameters, or to keep all
1126
+ # the default parameter values, pass an empty Hash as a request object (see above).
1127
+ #
1128
+ # @param backup_source [::Google::Cloud::AlloyDB::V1alpha::BackupSource, ::Hash]
1129
+ # Backup source.
1130
+ # @param continuous_backup_source [::Google::Cloud::AlloyDB::V1alpha::ContinuousBackupSource, ::Hash]
1131
+ # ContinuousBackup source. Continuous backup needs to be enabled in the
1132
+ # source cluster for this operation to succeed.
1133
+ # @param parent [::String]
1134
+ # Required. The name of the parent resource. For the required format, see the
1135
+ # comment on the Cluster.name field.
1136
+ # @param cluster_id [::String]
1137
+ # Required. ID of the requesting object.
1138
+ # @param cluster [::Google::Cloud::AlloyDB::V1alpha::Cluster, ::Hash]
1139
+ # Required. The resource being created
1140
+ # @param request_id [::String]
1141
+ # Optional. An optional request ID to identify requests. Specify a unique
1142
+ # request ID so that if you must retry your request, the server ignores the
1143
+ # request if it has already been completed. The server guarantees that for at
1144
+ # least 60 minutes since the first request.
1145
+ #
1146
+ # For example, consider a situation where you make an initial request and
1147
+ # the request times out. If you make the request again with the same request
1148
+ # ID, the server can check if the original operation with the same request ID
1149
+ # was received, and if so, ignores the second request. This prevents
1150
+ # clients from accidentally creating duplicate commitments.
1151
+ #
1152
+ # The request ID must be a valid UUID with the exception that zero UUID is
1153
+ # not supported (00000000-0000-0000-0000-000000000000).
1154
+ # @param validate_only [::Boolean]
1155
+ # Optional. If set, performs request validation, for example, permission
1156
+ # checks and any other type of validation, but does not actually execute the
1157
+ # create request.
1158
+ # @yield [result, operation] Access the result along with the TransportOperation object
1159
+ # @yieldparam result [::Gapic::Operation]
1160
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1161
+ #
1162
+ # @return [::Gapic::Operation]
1163
+ #
1164
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1165
+ #
1166
+ # @example Basic example
1167
+ # require "google/cloud/alloy_db/v1alpha"
1168
+ #
1169
+ # # Create a client object. The client can be reused for multiple calls.
1170
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
1171
+ #
1172
+ # # Create a request. To set request fields, pass in keyword arguments.
1173
+ # request = Google::Cloud::AlloyDB::V1alpha::RestoreClusterRequest.new
1174
+ #
1175
+ # # Call the restore_cluster method.
1176
+ # result = client.restore_cluster request
1177
+ #
1178
+ # # The returned object is of type Gapic::Operation. You can use it to
1179
+ # # check the status of an operation, cancel it, or wait for results.
1180
+ # # Here is how to wait for a response.
1181
+ # result.wait_until_done! timeout: 60
1182
+ # if result.response?
1183
+ # p result.response
1184
+ # else
1185
+ # puts "No response received."
1186
+ # end
1187
+ #
1188
+ def restore_cluster request, options = nil
1189
+ raise ::ArgumentError, "request must be provided" if request.nil?
1190
+
1191
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::RestoreClusterRequest
1192
+
1193
+ # Converts hash and nil to an options object
1194
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1195
+
1196
+ # Customize the options with defaults
1197
+ call_metadata = @config.rpcs.restore_cluster.metadata.to_h
1198
+
1199
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1200
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1201
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1202
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
1203
+ transports_version_send: [:rest]
1204
+
1205
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1206
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1207
+
1208
+ options.apply_defaults timeout: @config.rpcs.restore_cluster.timeout,
1209
+ metadata: call_metadata,
1210
+ retry_policy: @config.rpcs.restore_cluster.retry_policy
1211
+
1212
+ options.apply_defaults timeout: @config.timeout,
1213
+ metadata: @config.metadata,
1214
+ retry_policy: @config.retry_policy
1215
+
1216
+ @alloy_db_admin_stub.restore_cluster request, options do |result, operation|
1217
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1218
+ yield result, operation if block_given?
1219
+ return result
1220
+ end
1221
+ rescue ::Gapic::Rest::Error => e
1222
+ raise ::Google::Cloud::Error.from_error(e)
1223
+ end
1224
+
1225
+ ##
1226
+ # Creates a cluster of type SECONDARY in the given location using
1227
+ # the primary cluster as the source.
1228
+ #
1229
+ # @overload create_secondary_cluster(request, options = nil)
1230
+ # Pass arguments to `create_secondary_cluster` via a request object, either of type
1231
+ # {::Google::Cloud::AlloyDB::V1alpha::CreateSecondaryClusterRequest} or an equivalent Hash.
1232
+ #
1233
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::CreateSecondaryClusterRequest, ::Hash]
1234
+ # A request object representing the call parameters. Required. To specify no
1235
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1236
+ # @param options [::Gapic::CallOptions, ::Hash]
1237
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1238
+ #
1239
+ # @overload create_secondary_cluster(parent: nil, cluster_id: nil, cluster: nil, request_id: nil, validate_only: nil)
1240
+ # Pass arguments to `create_secondary_cluster` via keyword arguments. Note that at
1241
+ # least one keyword argument is required. To specify no parameters, or to keep all
1242
+ # the default parameter values, pass an empty Hash as a request object (see above).
1243
+ #
1244
+ # @param parent [::String]
1245
+ # Required. The location of the new cluster. For the required
1246
+ # format, see the comment on the Cluster.name field.
1247
+ # @param cluster_id [::String]
1248
+ # Required. ID of the requesting object (the secondary cluster).
1249
+ # @param cluster [::Google::Cloud::AlloyDB::V1alpha::Cluster, ::Hash]
1250
+ # Required. Configuration of the requesting object (the secondary cluster).
1251
+ # @param request_id [::String]
1252
+ # Optional. An optional request ID to identify requests. Specify a unique
1253
+ # request ID so that if you must retry your request, the server ignores the
1254
+ # request if it has already been completed. The server guarantees that for at
1255
+ # least 60 minutes since the first request.
1256
+ #
1257
+ # For example, consider a situation where you make an initial request and
1258
+ # the request times out. If you make the request again with the same request
1259
+ # ID, the server can check if the original operation with the same request ID
1260
+ # was received, and if so, ignores the second request. This prevents
1261
+ # clients from accidentally creating duplicate commitments.
1262
+ #
1263
+ # The request ID must be a valid UUID with the exception that zero UUID is
1264
+ # not supported (00000000-0000-0000-0000-000000000000).
1265
+ # @param validate_only [::Boolean]
1266
+ # Optional. If set, performs request validation, for example, permission
1267
+ # checks and any other type of validation, but does not actually execute the
1268
+ # create request.
1269
+ # @yield [result, operation] Access the result along with the TransportOperation object
1270
+ # @yieldparam result [::Gapic::Operation]
1271
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1272
+ #
1273
+ # @return [::Gapic::Operation]
1274
+ #
1275
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1276
+ #
1277
+ # @example Basic example
1278
+ # require "google/cloud/alloy_db/v1alpha"
1279
+ #
1280
+ # # Create a client object. The client can be reused for multiple calls.
1281
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
1282
+ #
1283
+ # # Create a request. To set request fields, pass in keyword arguments.
1284
+ # request = Google::Cloud::AlloyDB::V1alpha::CreateSecondaryClusterRequest.new
1285
+ #
1286
+ # # Call the create_secondary_cluster method.
1287
+ # result = client.create_secondary_cluster request
1288
+ #
1289
+ # # The returned object is of type Gapic::Operation. You can use it to
1290
+ # # check the status of an operation, cancel it, or wait for results.
1291
+ # # Here is how to wait for a response.
1292
+ # result.wait_until_done! timeout: 60
1293
+ # if result.response?
1294
+ # p result.response
1295
+ # else
1296
+ # puts "No response received."
1297
+ # end
1298
+ #
1299
+ def create_secondary_cluster request, options = nil
1300
+ raise ::ArgumentError, "request must be provided" if request.nil?
1301
+
1302
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::CreateSecondaryClusterRequest
1303
+
1304
+ # Converts hash and nil to an options object
1305
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1306
+
1307
+ # Customize the options with defaults
1308
+ call_metadata = @config.rpcs.create_secondary_cluster.metadata.to_h
1309
+
1310
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1311
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1312
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1313
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
1314
+ transports_version_send: [:rest]
1315
+
1316
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1317
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1318
+
1319
+ options.apply_defaults timeout: @config.rpcs.create_secondary_cluster.timeout,
1320
+ metadata: call_metadata,
1321
+ retry_policy: @config.rpcs.create_secondary_cluster.retry_policy
1322
+
1323
+ options.apply_defaults timeout: @config.timeout,
1324
+ metadata: @config.metadata,
1325
+ retry_policy: @config.retry_policy
1326
+
1327
+ @alloy_db_admin_stub.create_secondary_cluster request, options do |result, operation|
1328
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1329
+ yield result, operation if block_given?
1330
+ return result
1331
+ end
1332
+ rescue ::Gapic::Rest::Error => e
1333
+ raise ::Google::Cloud::Error.from_error(e)
1334
+ end
1335
+
1336
+ ##
1337
+ # Lists Instances in a given project and location.
1338
+ #
1339
+ # @overload list_instances(request, options = nil)
1340
+ # Pass arguments to `list_instances` via a request object, either of type
1341
+ # {::Google::Cloud::AlloyDB::V1alpha::ListInstancesRequest} or an equivalent Hash.
1342
+ #
1343
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::ListInstancesRequest, ::Hash]
1344
+ # A request object representing the call parameters. Required. To specify no
1345
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1346
+ # @param options [::Gapic::CallOptions, ::Hash]
1347
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1348
+ #
1349
+ # @overload list_instances(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1350
+ # Pass arguments to `list_instances` via keyword arguments. Note that at
1351
+ # least one keyword argument is required. To specify no parameters, or to keep all
1352
+ # the default parameter values, pass an empty Hash as a request object (see above).
1353
+ #
1354
+ # @param parent [::String]
1355
+ # Required. The name of the parent resource. For the required format, see the
1356
+ # comment on the Instance.name field. Additionally, you can perform an
1357
+ # aggregated list operation by specifying a value with one of the following
1358
+ # formats:
1359
+ # * projects/\\{project}/locations/-/clusters/-
1360
+ # * projects/\\{project}/locations/\\{region}/clusters/-
1361
+ # @param page_size [::Integer]
1362
+ # Optional. Requested page size. Server may return fewer items than
1363
+ # requested. If unspecified, server will pick an appropriate default.
1364
+ # @param page_token [::String]
1365
+ # A token identifying a page of results the server should return.
1366
+ # @param filter [::String]
1367
+ # Optional. Filtering results
1368
+ # @param order_by [::String]
1369
+ # Optional. Hint for how to order the results
1370
+ # @yield [result, operation] Access the result along with the TransportOperation object
1371
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::ListInstancesResponse]
1372
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1373
+ #
1374
+ # @return [::Google::Cloud::AlloyDB::V1alpha::ListInstancesResponse]
1375
+ #
1376
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1377
+ #
1378
+ # @example Basic example
1379
+ # require "google/cloud/alloy_db/v1alpha"
1380
+ #
1381
+ # # Create a client object. The client can be reused for multiple calls.
1382
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
1383
+ #
1384
+ # # Create a request. To set request fields, pass in keyword arguments.
1385
+ # request = Google::Cloud::AlloyDB::V1alpha::ListInstancesRequest.new
1386
+ #
1387
+ # # Call the list_instances method.
1388
+ # result = client.list_instances request
1389
+ #
1390
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1391
+ # # over elements, and API calls will be issued to fetch pages as needed.
1392
+ # result.each do |item|
1393
+ # # Each element is of type ::Google::Cloud::AlloyDB::V1alpha::Instance.
1394
+ # p item
1395
+ # end
1396
+ #
1397
+ def list_instances request, options = nil
1398
+ raise ::ArgumentError, "request must be provided" if request.nil?
1399
+
1400
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::ListInstancesRequest
1401
+
1402
+ # Converts hash and nil to an options object
1403
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1404
+
1405
+ # Customize the options with defaults
1406
+ call_metadata = @config.rpcs.list_instances.metadata.to_h
1407
+
1408
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1409
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1410
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1411
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
1412
+ transports_version_send: [:rest]
1413
+
1414
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1415
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1416
+
1417
+ options.apply_defaults timeout: @config.rpcs.list_instances.timeout,
1418
+ metadata: call_metadata,
1419
+ retry_policy: @config.rpcs.list_instances.retry_policy
1420
+
1421
+ options.apply_defaults timeout: @config.timeout,
1422
+ metadata: @config.metadata,
1423
+ retry_policy: @config.retry_policy
1424
+
1425
+ @alloy_db_admin_stub.list_instances request, options do |result, operation|
1426
+ yield result, operation if block_given?
1427
+ return result
1428
+ end
1429
+ rescue ::Gapic::Rest::Error => e
1430
+ raise ::Google::Cloud::Error.from_error(e)
1431
+ end
1432
+
1433
+ ##
1434
+ # Gets details of a single Instance.
1435
+ #
1436
+ # @overload get_instance(request, options = nil)
1437
+ # Pass arguments to `get_instance` via a request object, either of type
1438
+ # {::Google::Cloud::AlloyDB::V1alpha::GetInstanceRequest} or an equivalent Hash.
1439
+ #
1440
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::GetInstanceRequest, ::Hash]
1441
+ # A request object representing the call parameters. Required. To specify no
1442
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1443
+ # @param options [::Gapic::CallOptions, ::Hash]
1444
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1445
+ #
1446
+ # @overload get_instance(name: nil, view: nil)
1447
+ # Pass arguments to `get_instance` via keyword arguments. Note that at
1448
+ # least one keyword argument is required. To specify no parameters, or to keep all
1449
+ # the default parameter values, pass an empty Hash as a request object (see above).
1450
+ #
1451
+ # @param name [::String]
1452
+ # Required. The name of the resource. For the required format, see the
1453
+ # comment on the Instance.name field.
1454
+ # @param view [::Google::Cloud::AlloyDB::V1alpha::InstanceView]
1455
+ # The view of the instance to return.
1456
+ # @yield [result, operation] Access the result along with the TransportOperation object
1457
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::Instance]
1458
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1459
+ #
1460
+ # @return [::Google::Cloud::AlloyDB::V1alpha::Instance]
1461
+ #
1462
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1463
+ #
1464
+ # @example Basic example
1465
+ # require "google/cloud/alloy_db/v1alpha"
1466
+ #
1467
+ # # Create a client object. The client can be reused for multiple calls.
1468
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
1469
+ #
1470
+ # # Create a request. To set request fields, pass in keyword arguments.
1471
+ # request = Google::Cloud::AlloyDB::V1alpha::GetInstanceRequest.new
1472
+ #
1473
+ # # Call the get_instance method.
1474
+ # result = client.get_instance request
1475
+ #
1476
+ # # The returned object is of type Google::Cloud::AlloyDB::V1alpha::Instance.
1477
+ # p result
1478
+ #
1479
+ def get_instance request, options = nil
1480
+ raise ::ArgumentError, "request must be provided" if request.nil?
1481
+
1482
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::GetInstanceRequest
1483
+
1484
+ # Converts hash and nil to an options object
1485
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1486
+
1487
+ # Customize the options with defaults
1488
+ call_metadata = @config.rpcs.get_instance.metadata.to_h
1489
+
1490
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1491
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1492
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1493
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
1494
+ transports_version_send: [:rest]
1495
+
1496
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1497
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1498
+
1499
+ options.apply_defaults timeout: @config.rpcs.get_instance.timeout,
1500
+ metadata: call_metadata,
1501
+ retry_policy: @config.rpcs.get_instance.retry_policy
1502
+
1503
+ options.apply_defaults timeout: @config.timeout,
1504
+ metadata: @config.metadata,
1505
+ retry_policy: @config.retry_policy
1506
+
1507
+ @alloy_db_admin_stub.get_instance request, options do |result, operation|
1508
+ yield result, operation if block_given?
1509
+ return result
1510
+ end
1511
+ rescue ::Gapic::Rest::Error => e
1512
+ raise ::Google::Cloud::Error.from_error(e)
1513
+ end
1514
+
1515
+ ##
1516
+ # Creates a new Instance in a given project and location.
1517
+ #
1518
+ # @overload create_instance(request, options = nil)
1519
+ # Pass arguments to `create_instance` via a request object, either of type
1520
+ # {::Google::Cloud::AlloyDB::V1alpha::CreateInstanceRequest} or an equivalent Hash.
1521
+ #
1522
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::CreateInstanceRequest, ::Hash]
1523
+ # A request object representing the call parameters. Required. To specify no
1524
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1525
+ # @param options [::Gapic::CallOptions, ::Hash]
1526
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1527
+ #
1528
+ # @overload create_instance(parent: nil, instance_id: nil, instance: nil, request_id: nil, validate_only: nil)
1529
+ # Pass arguments to `create_instance` via keyword arguments. Note that at
1530
+ # least one keyword argument is required. To specify no parameters, or to keep all
1531
+ # the default parameter values, pass an empty Hash as a request object (see above).
1532
+ #
1533
+ # @param parent [::String]
1534
+ # Required. The name of the parent resource. For the required format, see the
1535
+ # comment on the Instance.name field.
1536
+ # @param instance_id [::String]
1537
+ # Required. ID of the requesting object.
1538
+ # @param instance [::Google::Cloud::AlloyDB::V1alpha::Instance, ::Hash]
1539
+ # Required. The resource being created
1540
+ # @param request_id [::String]
1541
+ # Optional. An optional request ID to identify requests. Specify a unique
1542
+ # request ID so that if you must retry your request, the server ignores the
1543
+ # request if it has already been completed. The server guarantees that for at
1544
+ # least 60 minutes since the first request.
1545
+ #
1546
+ # For example, consider a situation where you make an initial request and
1547
+ # the request times out. If you make the request again with the same request
1548
+ # ID, the server can check if the original operation with the same request ID
1549
+ # was received, and if so, ignores the second request. This prevents
1550
+ # clients from accidentally creating duplicate commitments.
1551
+ #
1552
+ # The request ID must be a valid UUID with the exception that zero UUID is
1553
+ # not supported (00000000-0000-0000-0000-000000000000).
1554
+ # @param validate_only [::Boolean]
1555
+ # Optional. If set, performs request validation, for example, permission
1556
+ # checks and any other type of validation, but does not actually execute the
1557
+ # create request.
1558
+ # @yield [result, operation] Access the result along with the TransportOperation object
1559
+ # @yieldparam result [::Gapic::Operation]
1560
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1561
+ #
1562
+ # @return [::Gapic::Operation]
1563
+ #
1564
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1565
+ #
1566
+ # @example Basic example
1567
+ # require "google/cloud/alloy_db/v1alpha"
1568
+ #
1569
+ # # Create a client object. The client can be reused for multiple calls.
1570
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
1571
+ #
1572
+ # # Create a request. To set request fields, pass in keyword arguments.
1573
+ # request = Google::Cloud::AlloyDB::V1alpha::CreateInstanceRequest.new
1574
+ #
1575
+ # # Call the create_instance method.
1576
+ # result = client.create_instance request
1577
+ #
1578
+ # # The returned object is of type Gapic::Operation. You can use it to
1579
+ # # check the status of an operation, cancel it, or wait for results.
1580
+ # # Here is how to wait for a response.
1581
+ # result.wait_until_done! timeout: 60
1582
+ # if result.response?
1583
+ # p result.response
1584
+ # else
1585
+ # puts "No response received."
1586
+ # end
1587
+ #
1588
+ def create_instance request, options = nil
1589
+ raise ::ArgumentError, "request must be provided" if request.nil?
1590
+
1591
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::CreateInstanceRequest
1592
+
1593
+ # Converts hash and nil to an options object
1594
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1595
+
1596
+ # Customize the options with defaults
1597
+ call_metadata = @config.rpcs.create_instance.metadata.to_h
1598
+
1599
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1600
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1601
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1602
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
1603
+ transports_version_send: [:rest]
1604
+
1605
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1606
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1607
+
1608
+ options.apply_defaults timeout: @config.rpcs.create_instance.timeout,
1609
+ metadata: call_metadata,
1610
+ retry_policy: @config.rpcs.create_instance.retry_policy
1611
+
1612
+ options.apply_defaults timeout: @config.timeout,
1613
+ metadata: @config.metadata,
1614
+ retry_policy: @config.retry_policy
1615
+
1616
+ @alloy_db_admin_stub.create_instance request, options do |result, operation|
1617
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1618
+ yield result, operation if block_given?
1619
+ return result
1620
+ end
1621
+ rescue ::Gapic::Rest::Error => e
1622
+ raise ::Google::Cloud::Error.from_error(e)
1623
+ end
1624
+
1625
+ ##
1626
+ # Creates a new SECONDARY Instance in a given project and location.
1627
+ #
1628
+ # @overload create_secondary_instance(request, options = nil)
1629
+ # Pass arguments to `create_secondary_instance` via a request object, either of type
1630
+ # {::Google::Cloud::AlloyDB::V1alpha::CreateSecondaryInstanceRequest} or an equivalent Hash.
1631
+ #
1632
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::CreateSecondaryInstanceRequest, ::Hash]
1633
+ # A request object representing the call parameters. Required. To specify no
1634
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1635
+ # @param options [::Gapic::CallOptions, ::Hash]
1636
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1637
+ #
1638
+ # @overload create_secondary_instance(parent: nil, instance_id: nil, instance: nil, request_id: nil, validate_only: nil)
1639
+ # Pass arguments to `create_secondary_instance` via keyword arguments. Note that at
1640
+ # least one keyword argument is required. To specify no parameters, or to keep all
1641
+ # the default parameter values, pass an empty Hash as a request object (see above).
1642
+ #
1643
+ # @param parent [::String]
1644
+ # Required. The name of the parent resource. For the required format, see the
1645
+ # comment on the Instance.name field.
1646
+ # @param instance_id [::String]
1647
+ # Required. ID of the requesting object.
1648
+ # @param instance [::Google::Cloud::AlloyDB::V1alpha::Instance, ::Hash]
1649
+ # Required. The resource being created
1650
+ # @param request_id [::String]
1651
+ # Optional. An optional request ID to identify requests. Specify a unique
1652
+ # request ID so that if you must retry your request, the server ignores the
1653
+ # request if it has already been completed. The server guarantees that for at
1654
+ # least 60 minutes since the first request.
1655
+ #
1656
+ # For example, consider a situation where you make an initial request and
1657
+ # the request times out. If you make the request again with the same request
1658
+ # ID, the server can check if the original operation with the same request ID
1659
+ # was received, and if so, ignores the second request. This prevents
1660
+ # clients from accidentally creating duplicate commitments.
1661
+ #
1662
+ # The request ID must be a valid UUID with the exception that zero UUID is
1663
+ # not supported (00000000-0000-0000-0000-000000000000).
1664
+ # @param validate_only [::Boolean]
1665
+ # Optional. If set, performs request validation, for example, permission
1666
+ # checks and any other type of validation, but does not actually execute the
1667
+ # create request.
1668
+ # @yield [result, operation] Access the result along with the TransportOperation object
1669
+ # @yieldparam result [::Gapic::Operation]
1670
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1671
+ #
1672
+ # @return [::Gapic::Operation]
1673
+ #
1674
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1675
+ #
1676
+ # @example Basic example
1677
+ # require "google/cloud/alloy_db/v1alpha"
1678
+ #
1679
+ # # Create a client object. The client can be reused for multiple calls.
1680
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
1681
+ #
1682
+ # # Create a request. To set request fields, pass in keyword arguments.
1683
+ # request = Google::Cloud::AlloyDB::V1alpha::CreateSecondaryInstanceRequest.new
1684
+ #
1685
+ # # Call the create_secondary_instance method.
1686
+ # result = client.create_secondary_instance request
1687
+ #
1688
+ # # The returned object is of type Gapic::Operation. You can use it to
1689
+ # # check the status of an operation, cancel it, or wait for results.
1690
+ # # Here is how to wait for a response.
1691
+ # result.wait_until_done! timeout: 60
1692
+ # if result.response?
1693
+ # p result.response
1694
+ # else
1695
+ # puts "No response received."
1696
+ # end
1697
+ #
1698
+ def create_secondary_instance request, options = nil
1699
+ raise ::ArgumentError, "request must be provided" if request.nil?
1700
+
1701
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::CreateSecondaryInstanceRequest
1702
+
1703
+ # Converts hash and nil to an options object
1704
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1705
+
1706
+ # Customize the options with defaults
1707
+ call_metadata = @config.rpcs.create_secondary_instance.metadata.to_h
1708
+
1709
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1710
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1711
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1712
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
1713
+ transports_version_send: [:rest]
1714
+
1715
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1716
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1717
+
1718
+ options.apply_defaults timeout: @config.rpcs.create_secondary_instance.timeout,
1719
+ metadata: call_metadata,
1720
+ retry_policy: @config.rpcs.create_secondary_instance.retry_policy
1721
+
1722
+ options.apply_defaults timeout: @config.timeout,
1723
+ metadata: @config.metadata,
1724
+ retry_policy: @config.retry_policy
1725
+
1726
+ @alloy_db_admin_stub.create_secondary_instance request, options do |result, operation|
1727
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1728
+ yield result, operation if block_given?
1729
+ return result
1730
+ end
1731
+ rescue ::Gapic::Rest::Error => e
1732
+ raise ::Google::Cloud::Error.from_error(e)
1733
+ end
1734
+
1735
+ ##
1736
+ # Creates new instances under the given project, location and cluster.
1737
+ # There can be only one primary instance in a cluster. If the primary
1738
+ # instance exists in the cluster as well as this request, then API will
1739
+ # throw an error.
1740
+ # The primary instance should exist before any read pool instance is
1741
+ # created. If the primary instance is a part of the request payload, then
1742
+ # the API will take care of creating instances in the correct order.
1743
+ # This method is here to support Google-internal use cases, and is not meant
1744
+ # for external customers to consume. Please do not start relying on it; its
1745
+ # behavior is subject to change without notice.
1746
+ #
1747
+ # @overload batch_create_instances(request, options = nil)
1748
+ # Pass arguments to `batch_create_instances` via a request object, either of type
1749
+ # {::Google::Cloud::AlloyDB::V1alpha::BatchCreateInstancesRequest} or an equivalent Hash.
1750
+ #
1751
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::BatchCreateInstancesRequest, ::Hash]
1752
+ # A request object representing the call parameters. Required. To specify no
1753
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1754
+ # @param options [::Gapic::CallOptions, ::Hash]
1755
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1756
+ #
1757
+ # @overload batch_create_instances(parent: nil, requests: nil, request_id: nil)
1758
+ # Pass arguments to `batch_create_instances` via keyword arguments. Note that at
1759
+ # least one keyword argument is required. To specify no parameters, or to keep all
1760
+ # the default parameter values, pass an empty Hash as a request object (see above).
1761
+ #
1762
+ # @param parent [::String]
1763
+ # Required. The name of the parent resource.
1764
+ # @param requests [::Google::Cloud::AlloyDB::V1alpha::CreateInstanceRequests, ::Hash]
1765
+ # Required. Resources being created.
1766
+ # @param request_id [::String]
1767
+ # Optional. An optional request ID to identify requests. Specify a unique
1768
+ # request ID so that if you must retry your request, the server ignores the
1769
+ # request if it has already been completed. The server guarantees that for at
1770
+ # least 60 minutes since the first request.
1771
+ #
1772
+ # For example, consider a situation where you make an initial request and
1773
+ # the request times out. If you make the request again with the same request
1774
+ # ID, the server can check if the original operation with the same request ID
1775
+ # was received, and if so, ignores the second request. This prevents
1776
+ # clients from accidentally creating duplicate commitments.
1777
+ #
1778
+ # The request ID must be a valid UUID with the exception that zero UUID is
1779
+ # not supported (00000000-0000-0000-0000-000000000000).
1780
+ # @yield [result, operation] Access the result along with the TransportOperation object
1781
+ # @yieldparam result [::Gapic::Operation]
1782
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1783
+ #
1784
+ # @return [::Gapic::Operation]
1785
+ #
1786
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1787
+ #
1788
+ # @example Basic example
1789
+ # require "google/cloud/alloy_db/v1alpha"
1790
+ #
1791
+ # # Create a client object. The client can be reused for multiple calls.
1792
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
1793
+ #
1794
+ # # Create a request. To set request fields, pass in keyword arguments.
1795
+ # request = Google::Cloud::AlloyDB::V1alpha::BatchCreateInstancesRequest.new
1796
+ #
1797
+ # # Call the batch_create_instances method.
1798
+ # result = client.batch_create_instances request
1799
+ #
1800
+ # # The returned object is of type Gapic::Operation. You can use it to
1801
+ # # check the status of an operation, cancel it, or wait for results.
1802
+ # # Here is how to wait for a response.
1803
+ # result.wait_until_done! timeout: 60
1804
+ # if result.response?
1805
+ # p result.response
1806
+ # else
1807
+ # puts "No response received."
1808
+ # end
1809
+ #
1810
+ def batch_create_instances request, options = nil
1811
+ raise ::ArgumentError, "request must be provided" if request.nil?
1812
+
1813
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::BatchCreateInstancesRequest
1814
+
1815
+ # Converts hash and nil to an options object
1816
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1817
+
1818
+ # Customize the options with defaults
1819
+ call_metadata = @config.rpcs.batch_create_instances.metadata.to_h
1820
+
1821
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1822
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1823
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1824
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
1825
+ transports_version_send: [:rest]
1826
+
1827
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1828
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1829
+
1830
+ options.apply_defaults timeout: @config.rpcs.batch_create_instances.timeout,
1831
+ metadata: call_metadata,
1832
+ retry_policy: @config.rpcs.batch_create_instances.retry_policy
1833
+
1834
+ options.apply_defaults timeout: @config.timeout,
1835
+ metadata: @config.metadata,
1836
+ retry_policy: @config.retry_policy
1837
+
1838
+ @alloy_db_admin_stub.batch_create_instances request, options do |result, operation|
1839
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1840
+ yield result, operation if block_given?
1841
+ return result
1842
+ end
1843
+ rescue ::Gapic::Rest::Error => e
1844
+ raise ::Google::Cloud::Error.from_error(e)
1845
+ end
1846
+
1847
+ ##
1848
+ # Updates the parameters of a single Instance.
1849
+ #
1850
+ # @overload update_instance(request, options = nil)
1851
+ # Pass arguments to `update_instance` via a request object, either of type
1852
+ # {::Google::Cloud::AlloyDB::V1alpha::UpdateInstanceRequest} or an equivalent Hash.
1853
+ #
1854
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::UpdateInstanceRequest, ::Hash]
1855
+ # A request object representing the call parameters. Required. To specify no
1856
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1857
+ # @param options [::Gapic::CallOptions, ::Hash]
1858
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1859
+ #
1860
+ # @overload update_instance(update_mask: nil, instance: nil, request_id: nil, validate_only: nil, allow_missing: nil)
1861
+ # Pass arguments to `update_instance` via keyword arguments. Note that at
1862
+ # least one keyword argument is required. To specify no parameters, or to keep all
1863
+ # the default parameter values, pass an empty Hash as a request object (see above).
1864
+ #
1865
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
1866
+ # Optional. Field mask is used to specify the fields to be overwritten in the
1867
+ # Instance resource by the update.
1868
+ # The fields specified in the update_mask are relative to the resource, not
1869
+ # the full request. A field will be overwritten if it is in the mask. If the
1870
+ # user does not provide a mask then all fields will be overwritten.
1871
+ # @param instance [::Google::Cloud::AlloyDB::V1alpha::Instance, ::Hash]
1872
+ # Required. The resource being updated
1873
+ # @param request_id [::String]
1874
+ # Optional. An optional request ID to identify requests. Specify a unique
1875
+ # request ID so that if you must retry your request, the server ignores the
1876
+ # request if it has already been completed. The server guarantees that for at
1877
+ # least 60 minutes since the first request.
1878
+ #
1879
+ # For example, consider a situation where you make an initial request and
1880
+ # the request times out. If you make the request again with the same request
1881
+ # ID, the server can check if the original operation with the same request ID
1882
+ # was received, and if so, ignores the second request. This prevents
1883
+ # clients from accidentally creating duplicate commitments.
1884
+ #
1885
+ # The request ID must be a valid UUID with the exception that zero UUID is
1886
+ # not supported (00000000-0000-0000-0000-000000000000).
1887
+ # @param validate_only [::Boolean]
1888
+ # Optional. If set, performs request validation, for example, permission
1889
+ # checks and any other type of validation, but does not actually execute the
1890
+ # create request.
1891
+ # @param allow_missing [::Boolean]
1892
+ # Optional. If set to true, update succeeds even if instance is not found. In
1893
+ # that case, a new instance is created and `update_mask` is ignored.
1894
+ # @yield [result, operation] Access the result along with the TransportOperation object
1895
+ # @yieldparam result [::Gapic::Operation]
1896
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
1897
+ #
1898
+ # @return [::Gapic::Operation]
1899
+ #
1900
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
1901
+ #
1902
+ # @example Basic example
1903
+ # require "google/cloud/alloy_db/v1alpha"
1904
+ #
1905
+ # # Create a client object. The client can be reused for multiple calls.
1906
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
1907
+ #
1908
+ # # Create a request. To set request fields, pass in keyword arguments.
1909
+ # request = Google::Cloud::AlloyDB::V1alpha::UpdateInstanceRequest.new
1910
+ #
1911
+ # # Call the update_instance method.
1912
+ # result = client.update_instance request
1913
+ #
1914
+ # # The returned object is of type Gapic::Operation. You can use it to
1915
+ # # check the status of an operation, cancel it, or wait for results.
1916
+ # # Here is how to wait for a response.
1917
+ # result.wait_until_done! timeout: 60
1918
+ # if result.response?
1919
+ # p result.response
1920
+ # else
1921
+ # puts "No response received."
1922
+ # end
1923
+ #
1924
+ def update_instance request, options = nil
1925
+ raise ::ArgumentError, "request must be provided" if request.nil?
1926
+
1927
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::UpdateInstanceRequest
1928
+
1929
+ # Converts hash and nil to an options object
1930
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1931
+
1932
+ # Customize the options with defaults
1933
+ call_metadata = @config.rpcs.update_instance.metadata.to_h
1934
+
1935
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1936
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1937
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1938
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
1939
+ transports_version_send: [:rest]
1940
+
1941
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1942
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1943
+
1944
+ options.apply_defaults timeout: @config.rpcs.update_instance.timeout,
1945
+ metadata: call_metadata,
1946
+ retry_policy: @config.rpcs.update_instance.retry_policy
1947
+
1948
+ options.apply_defaults timeout: @config.timeout,
1949
+ metadata: @config.metadata,
1950
+ retry_policy: @config.retry_policy
1951
+
1952
+ @alloy_db_admin_stub.update_instance request, options do |result, operation|
1953
+ result = ::Gapic::Operation.new result, @operations_client, options: options
1954
+ yield result, operation if block_given?
1955
+ return result
1956
+ end
1957
+ rescue ::Gapic::Rest::Error => e
1958
+ raise ::Google::Cloud::Error.from_error(e)
1959
+ end
1960
+
1961
+ ##
1962
+ # Deletes a single Instance.
1963
+ #
1964
+ # @overload delete_instance(request, options = nil)
1965
+ # Pass arguments to `delete_instance` via a request object, either of type
1966
+ # {::Google::Cloud::AlloyDB::V1alpha::DeleteInstanceRequest} or an equivalent Hash.
1967
+ #
1968
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::DeleteInstanceRequest, ::Hash]
1969
+ # A request object representing the call parameters. Required. To specify no
1970
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1971
+ # @param options [::Gapic::CallOptions, ::Hash]
1972
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
1973
+ #
1974
+ # @overload delete_instance(name: nil, request_id: nil, etag: nil, validate_only: nil)
1975
+ # Pass arguments to `delete_instance` via keyword arguments. Note that at
1976
+ # least one keyword argument is required. To specify no parameters, or to keep all
1977
+ # the default parameter values, pass an empty Hash as a request object (see above).
1978
+ #
1979
+ # @param name [::String]
1980
+ # Required. The name of the resource. For the required format, see the
1981
+ # comment on the Instance.name field.
1982
+ # @param request_id [::String]
1983
+ # Optional. An optional request ID to identify requests. Specify a unique
1984
+ # request ID so that if you must retry your request, the server ignores the
1985
+ # request if it has already been completed. The server guarantees that for at
1986
+ # least 60 minutes since the first request.
1987
+ #
1988
+ # For example, consider a situation where you make an initial request and
1989
+ # the request times out. If you make the request again with the same request
1990
+ # ID, the server can check if the original operation with the same request ID
1991
+ # was received, and if so, ignores the second request. This prevents
1992
+ # clients from accidentally creating duplicate commitments.
1993
+ #
1994
+ # The request ID must be a valid UUID with the exception that zero UUID is
1995
+ # not supported (00000000-0000-0000-0000-000000000000).
1996
+ # @param etag [::String]
1997
+ # Optional. The current etag of the Instance.
1998
+ # If an etag is provided and does not match the current etag of the Instance,
1999
+ # deletion will be blocked and an ABORTED error will be returned.
2000
+ # @param validate_only [::Boolean]
2001
+ # Optional. If set, performs request validation, for example, permission
2002
+ # checks and any other type of validation, but does not actually execute the
2003
+ # create request.
2004
+ # @yield [result, operation] Access the result along with the TransportOperation object
2005
+ # @yieldparam result [::Gapic::Operation]
2006
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2007
+ #
2008
+ # @return [::Gapic::Operation]
2009
+ #
2010
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2011
+ #
2012
+ # @example Basic example
2013
+ # require "google/cloud/alloy_db/v1alpha"
2014
+ #
2015
+ # # Create a client object. The client can be reused for multiple calls.
2016
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
2017
+ #
2018
+ # # Create a request. To set request fields, pass in keyword arguments.
2019
+ # request = Google::Cloud::AlloyDB::V1alpha::DeleteInstanceRequest.new
2020
+ #
2021
+ # # Call the delete_instance method.
2022
+ # result = client.delete_instance request
2023
+ #
2024
+ # # The returned object is of type Gapic::Operation. You can use it to
2025
+ # # check the status of an operation, cancel it, or wait for results.
2026
+ # # Here is how to wait for a response.
2027
+ # result.wait_until_done! timeout: 60
2028
+ # if result.response?
2029
+ # p result.response
2030
+ # else
2031
+ # puts "No response received."
2032
+ # end
2033
+ #
2034
+ def delete_instance request, options = nil
2035
+ raise ::ArgumentError, "request must be provided" if request.nil?
2036
+
2037
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::DeleteInstanceRequest
2038
+
2039
+ # Converts hash and nil to an options object
2040
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2041
+
2042
+ # Customize the options with defaults
2043
+ call_metadata = @config.rpcs.delete_instance.metadata.to_h
2044
+
2045
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2046
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2047
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2048
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
2049
+ transports_version_send: [:rest]
2050
+
2051
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2052
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2053
+
2054
+ options.apply_defaults timeout: @config.rpcs.delete_instance.timeout,
2055
+ metadata: call_metadata,
2056
+ retry_policy: @config.rpcs.delete_instance.retry_policy
2057
+
2058
+ options.apply_defaults timeout: @config.timeout,
2059
+ metadata: @config.metadata,
2060
+ retry_policy: @config.retry_policy
2061
+
2062
+ @alloy_db_admin_stub.delete_instance request, options do |result, operation|
2063
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2064
+ yield result, operation if block_given?
2065
+ return result
2066
+ end
2067
+ rescue ::Gapic::Rest::Error => e
2068
+ raise ::Google::Cloud::Error.from_error(e)
2069
+ end
2070
+
2071
+ ##
2072
+ # Forces a Failover for a highly available instance.
2073
+ # Failover promotes the HA standby instance as the new primary.
2074
+ # Imperative only.
2075
+ #
2076
+ # @overload failover_instance(request, options = nil)
2077
+ # Pass arguments to `failover_instance` via a request object, either of type
2078
+ # {::Google::Cloud::AlloyDB::V1alpha::FailoverInstanceRequest} or an equivalent Hash.
2079
+ #
2080
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::FailoverInstanceRequest, ::Hash]
2081
+ # A request object representing the call parameters. Required. To specify no
2082
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2083
+ # @param options [::Gapic::CallOptions, ::Hash]
2084
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2085
+ #
2086
+ # @overload failover_instance(name: nil, request_id: nil, validate_only: nil)
2087
+ # Pass arguments to `failover_instance` via keyword arguments. Note that at
2088
+ # least one keyword argument is required. To specify no parameters, or to keep all
2089
+ # the default parameter values, pass an empty Hash as a request object (see above).
2090
+ #
2091
+ # @param name [::String]
2092
+ # Required. The name of the resource. For the required format, see the
2093
+ # comment on the Instance.name field.
2094
+ # @param request_id [::String]
2095
+ # Optional. An optional request ID to identify requests. Specify a unique
2096
+ # request ID so that if you must retry your request, the server ignores the
2097
+ # request if it has already been completed. The server guarantees that for at
2098
+ # least 60 minutes since the first request.
2099
+ #
2100
+ # For example, consider a situation where you make an initial request and
2101
+ # the request times out. If you make the request again with the same request
2102
+ # ID, the server can check if the original operation with the same request ID
2103
+ # was received, and if so, ignores the second request. This prevents
2104
+ # clients from accidentally creating duplicate commitments.
2105
+ #
2106
+ # The request ID must be a valid UUID with the exception that zero UUID is
2107
+ # not supported (00000000-0000-0000-0000-000000000000).
2108
+ # @param validate_only [::Boolean]
2109
+ # Optional. If set, performs request validation, for example, permission
2110
+ # checks and any other type of validation, but does not actually execute the
2111
+ # create request.
2112
+ # @yield [result, operation] Access the result along with the TransportOperation object
2113
+ # @yieldparam result [::Gapic::Operation]
2114
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2115
+ #
2116
+ # @return [::Gapic::Operation]
2117
+ #
2118
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2119
+ #
2120
+ # @example Basic example
2121
+ # require "google/cloud/alloy_db/v1alpha"
2122
+ #
2123
+ # # Create a client object. The client can be reused for multiple calls.
2124
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
2125
+ #
2126
+ # # Create a request. To set request fields, pass in keyword arguments.
2127
+ # request = Google::Cloud::AlloyDB::V1alpha::FailoverInstanceRequest.new
2128
+ #
2129
+ # # Call the failover_instance method.
2130
+ # result = client.failover_instance request
2131
+ #
2132
+ # # The returned object is of type Gapic::Operation. You can use it to
2133
+ # # check the status of an operation, cancel it, or wait for results.
2134
+ # # Here is how to wait for a response.
2135
+ # result.wait_until_done! timeout: 60
2136
+ # if result.response?
2137
+ # p result.response
2138
+ # else
2139
+ # puts "No response received."
2140
+ # end
2141
+ #
2142
+ def failover_instance request, options = nil
2143
+ raise ::ArgumentError, "request must be provided" if request.nil?
2144
+
2145
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::FailoverInstanceRequest
2146
+
2147
+ # Converts hash and nil to an options object
2148
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2149
+
2150
+ # Customize the options with defaults
2151
+ call_metadata = @config.rpcs.failover_instance.metadata.to_h
2152
+
2153
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2154
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2155
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2156
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
2157
+ transports_version_send: [:rest]
2158
+
2159
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2160
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2161
+
2162
+ options.apply_defaults timeout: @config.rpcs.failover_instance.timeout,
2163
+ metadata: call_metadata,
2164
+ retry_policy: @config.rpcs.failover_instance.retry_policy
2165
+
2166
+ options.apply_defaults timeout: @config.timeout,
2167
+ metadata: @config.metadata,
2168
+ retry_policy: @config.retry_policy
2169
+
2170
+ @alloy_db_admin_stub.failover_instance request, options do |result, operation|
2171
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2172
+ yield result, operation if block_given?
2173
+ return result
2174
+ end
2175
+ rescue ::Gapic::Rest::Error => e
2176
+ raise ::Google::Cloud::Error.from_error(e)
2177
+ end
2178
+
2179
+ ##
2180
+ # Injects fault in an instance.
2181
+ # Imperative only.
2182
+ #
2183
+ # @overload inject_fault(request, options = nil)
2184
+ # Pass arguments to `inject_fault` via a request object, either of type
2185
+ # {::Google::Cloud::AlloyDB::V1alpha::InjectFaultRequest} or an equivalent Hash.
2186
+ #
2187
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::InjectFaultRequest, ::Hash]
2188
+ # A request object representing the call parameters. Required. To specify no
2189
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2190
+ # @param options [::Gapic::CallOptions, ::Hash]
2191
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2192
+ #
2193
+ # @overload inject_fault(fault_type: nil, name: nil, request_id: nil, validate_only: nil)
2194
+ # Pass arguments to `inject_fault` via keyword arguments. Note that at
2195
+ # least one keyword argument is required. To specify no parameters, or to keep all
2196
+ # the default parameter values, pass an empty Hash as a request object (see above).
2197
+ #
2198
+ # @param fault_type [::Google::Cloud::AlloyDB::V1alpha::InjectFaultRequest::FaultType]
2199
+ # Required. The type of fault to be injected in an instance.
2200
+ # @param name [::String]
2201
+ # Required. The name of the resource. For the required format, see the
2202
+ # comment on the Instance.name field.
2203
+ # @param request_id [::String]
2204
+ # Optional. An optional request ID to identify requests. Specify a unique
2205
+ # request ID so that if you must retry your request, the server ignores the
2206
+ # request if it has already been completed. The server guarantees that for at
2207
+ # least 60 minutes since the first request.
2208
+ #
2209
+ # For example, consider a situation where you make an initial request and
2210
+ # the request times out. If you make the request again with the same request
2211
+ # ID, the server can check if the original operation with the same request ID
2212
+ # was received, and if so, ignores the second request. This prevents
2213
+ # clients from accidentally creating duplicate commitments.
2214
+ #
2215
+ # The request ID must be a valid UUID with the exception that zero UUID is
2216
+ # not supported (00000000-0000-0000-0000-000000000000).
2217
+ # @param validate_only [::Boolean]
2218
+ # Optional. If set, performs request validation, for example, permission
2219
+ # checks and any other type of validation, but does not actually execute the
2220
+ # create request.
2221
+ # @yield [result, operation] Access the result along with the TransportOperation object
2222
+ # @yieldparam result [::Gapic::Operation]
2223
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2224
+ #
2225
+ # @return [::Gapic::Operation]
2226
+ #
2227
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2228
+ #
2229
+ # @example Basic example
2230
+ # require "google/cloud/alloy_db/v1alpha"
2231
+ #
2232
+ # # Create a client object. The client can be reused for multiple calls.
2233
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
2234
+ #
2235
+ # # Create a request. To set request fields, pass in keyword arguments.
2236
+ # request = Google::Cloud::AlloyDB::V1alpha::InjectFaultRequest.new
2237
+ #
2238
+ # # Call the inject_fault method.
2239
+ # result = client.inject_fault request
2240
+ #
2241
+ # # The returned object is of type Gapic::Operation. You can use it to
2242
+ # # check the status of an operation, cancel it, or wait for results.
2243
+ # # Here is how to wait for a response.
2244
+ # result.wait_until_done! timeout: 60
2245
+ # if result.response?
2246
+ # p result.response
2247
+ # else
2248
+ # puts "No response received."
2249
+ # end
2250
+ #
2251
+ def inject_fault request, options = nil
2252
+ raise ::ArgumentError, "request must be provided" if request.nil?
2253
+
2254
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::InjectFaultRequest
2255
+
2256
+ # Converts hash and nil to an options object
2257
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2258
+
2259
+ # Customize the options with defaults
2260
+ call_metadata = @config.rpcs.inject_fault.metadata.to_h
2261
+
2262
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2263
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2264
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2265
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
2266
+ transports_version_send: [:rest]
2267
+
2268
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2269
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2270
+
2271
+ options.apply_defaults timeout: @config.rpcs.inject_fault.timeout,
2272
+ metadata: call_metadata,
2273
+ retry_policy: @config.rpcs.inject_fault.retry_policy
2274
+
2275
+ options.apply_defaults timeout: @config.timeout,
2276
+ metadata: @config.metadata,
2277
+ retry_policy: @config.retry_policy
2278
+
2279
+ @alloy_db_admin_stub.inject_fault request, options do |result, operation|
2280
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2281
+ yield result, operation if block_given?
2282
+ return result
2283
+ end
2284
+ rescue ::Gapic::Rest::Error => e
2285
+ raise ::Google::Cloud::Error.from_error(e)
2286
+ end
2287
+
2288
+ ##
2289
+ # Restart an Instance in a cluster.
2290
+ # Imperative only.
2291
+ #
2292
+ # @overload restart_instance(request, options = nil)
2293
+ # Pass arguments to `restart_instance` via a request object, either of type
2294
+ # {::Google::Cloud::AlloyDB::V1alpha::RestartInstanceRequest} or an equivalent Hash.
2295
+ #
2296
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::RestartInstanceRequest, ::Hash]
2297
+ # A request object representing the call parameters. Required. To specify no
2298
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2299
+ # @param options [::Gapic::CallOptions, ::Hash]
2300
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2301
+ #
2302
+ # @overload restart_instance(name: nil, request_id: nil, validate_only: nil, node_ids: nil)
2303
+ # Pass arguments to `restart_instance` via keyword arguments. Note that at
2304
+ # least one keyword argument is required. To specify no parameters, or to keep all
2305
+ # the default parameter values, pass an empty Hash as a request object (see above).
2306
+ #
2307
+ # @param name [::String]
2308
+ # Required. The name of the resource. For the required format, see the
2309
+ # comment on the Instance.name field.
2310
+ # @param request_id [::String]
2311
+ # Optional. An optional request ID to identify requests. Specify a unique
2312
+ # request ID so that if you must retry your request, the server ignores the
2313
+ # request if it has already been completed. The server guarantees that for at
2314
+ # least 60 minutes since the first request.
2315
+ #
2316
+ # For example, consider a situation where you make an initial request and
2317
+ # the request times out. If you make the request again with the same request
2318
+ # ID, the server can check if the original operation with the same request ID
2319
+ # was received, and if so, ignores the second request. This prevents
2320
+ # clients from accidentally creating duplicate commitments.
2321
+ #
2322
+ # The request ID must be a valid UUID with the exception that zero UUID is
2323
+ # not supported (00000000-0000-0000-0000-000000000000).
2324
+ # @param validate_only [::Boolean]
2325
+ # Optional. If set, performs request validation, for example, permission
2326
+ # checks and any other type of validation, but does not actually execute the
2327
+ # create request.
2328
+ # @param node_ids [::Array<::String>]
2329
+ # Optional. Full name of the nodes as obtained from INSTANCE_VIEW_FULL to
2330
+ # restart upon. Applicable only to read instances.
2331
+ # @yield [result, operation] Access the result along with the TransportOperation object
2332
+ # @yieldparam result [::Gapic::Operation]
2333
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2334
+ #
2335
+ # @return [::Gapic::Operation]
2336
+ #
2337
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2338
+ #
2339
+ # @example Basic example
2340
+ # require "google/cloud/alloy_db/v1alpha"
2341
+ #
2342
+ # # Create a client object. The client can be reused for multiple calls.
2343
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
2344
+ #
2345
+ # # Create a request. To set request fields, pass in keyword arguments.
2346
+ # request = Google::Cloud::AlloyDB::V1alpha::RestartInstanceRequest.new
2347
+ #
2348
+ # # Call the restart_instance method.
2349
+ # result = client.restart_instance request
2350
+ #
2351
+ # # The returned object is of type Gapic::Operation. You can use it to
2352
+ # # check the status of an operation, cancel it, or wait for results.
2353
+ # # Here is how to wait for a response.
2354
+ # result.wait_until_done! timeout: 60
2355
+ # if result.response?
2356
+ # p result.response
2357
+ # else
2358
+ # puts "No response received."
2359
+ # end
2360
+ #
2361
+ def restart_instance request, options = nil
2362
+ raise ::ArgumentError, "request must be provided" if request.nil?
2363
+
2364
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::RestartInstanceRequest
2365
+
2366
+ # Converts hash and nil to an options object
2367
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2368
+
2369
+ # Customize the options with defaults
2370
+ call_metadata = @config.rpcs.restart_instance.metadata.to_h
2371
+
2372
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2373
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2374
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2375
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
2376
+ transports_version_send: [:rest]
2377
+
2378
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2379
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2380
+
2381
+ options.apply_defaults timeout: @config.rpcs.restart_instance.timeout,
2382
+ metadata: call_metadata,
2383
+ retry_policy: @config.rpcs.restart_instance.retry_policy
2384
+
2385
+ options.apply_defaults timeout: @config.timeout,
2386
+ metadata: @config.metadata,
2387
+ retry_policy: @config.retry_policy
2388
+
2389
+ @alloy_db_admin_stub.restart_instance request, options do |result, operation|
2390
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2391
+ yield result, operation if block_given?
2392
+ return result
2393
+ end
2394
+ rescue ::Gapic::Rest::Error => e
2395
+ raise ::Google::Cloud::Error.from_error(e)
2396
+ end
2397
+
2398
+ ##
2399
+ # Executes a SQL statement in a database inside an AlloyDB instance.
2400
+ #
2401
+ # @overload execute_sql(request, options = nil)
2402
+ # Pass arguments to `execute_sql` via a request object, either of type
2403
+ # {::Google::Cloud::AlloyDB::V1alpha::ExecuteSqlRequest} or an equivalent Hash.
2404
+ #
2405
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::ExecuteSqlRequest, ::Hash]
2406
+ # A request object representing the call parameters. Required. To specify no
2407
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2408
+ # @param options [::Gapic::CallOptions, ::Hash]
2409
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2410
+ #
2411
+ # @overload execute_sql(password: nil, instance: nil, database: nil, user: nil, sql_statement: nil)
2412
+ # Pass arguments to `execute_sql` via keyword arguments. Note that at
2413
+ # least one keyword argument is required. To specify no parameters, or to keep all
2414
+ # the default parameter values, pass an empty Hash as a request object (see above).
2415
+ #
2416
+ # @param password [::String]
2417
+ # Optional. The database native user’s password.
2418
+ # @param instance [::String]
2419
+ # Required. The instance where the SQL will be executed. For the required
2420
+ # format, see the comment on the Instance.name field.
2421
+ # @param database [::String]
2422
+ # Required. Name of the database where the query will be executed.
2423
+ # Note - Value provided should be the same as expected from `SELECT
2424
+ # current_database();` and NOT as a resource reference.
2425
+ # @param user [::String]
2426
+ # Required. Database user to be used for executing the SQL.
2427
+ # Note - Value provided should be the same as expected from
2428
+ # `SELECT current_user;` and NOT as a resource reference.
2429
+ # @param sql_statement [::String]
2430
+ # Required. SQL statement to execute on database. Any valid statement is
2431
+ # permitted, including DDL, DML, DQL statements.
2432
+ # @yield [result, operation] Access the result along with the TransportOperation object
2433
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::ExecuteSqlResponse]
2434
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2435
+ #
2436
+ # @return [::Google::Cloud::AlloyDB::V1alpha::ExecuteSqlResponse]
2437
+ #
2438
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2439
+ #
2440
+ # @example Basic example
2441
+ # require "google/cloud/alloy_db/v1alpha"
2442
+ #
2443
+ # # Create a client object. The client can be reused for multiple calls.
2444
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
2445
+ #
2446
+ # # Create a request. To set request fields, pass in keyword arguments.
2447
+ # request = Google::Cloud::AlloyDB::V1alpha::ExecuteSqlRequest.new
2448
+ #
2449
+ # # Call the execute_sql method.
2450
+ # result = client.execute_sql request
2451
+ #
2452
+ # # The returned object is of type Google::Cloud::AlloyDB::V1alpha::ExecuteSqlResponse.
2453
+ # p result
2454
+ #
2455
+ def execute_sql request, options = nil
2456
+ raise ::ArgumentError, "request must be provided" if request.nil?
2457
+
2458
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::ExecuteSqlRequest
2459
+
2460
+ # Converts hash and nil to an options object
2461
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2462
+
2463
+ # Customize the options with defaults
2464
+ call_metadata = @config.rpcs.execute_sql.metadata.to_h
2465
+
2466
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2467
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2468
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2469
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
2470
+ transports_version_send: [:rest]
2471
+
2472
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2473
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2474
+
2475
+ options.apply_defaults timeout: @config.rpcs.execute_sql.timeout,
2476
+ metadata: call_metadata,
2477
+ retry_policy: @config.rpcs.execute_sql.retry_policy
2478
+
2479
+ options.apply_defaults timeout: @config.timeout,
2480
+ metadata: @config.metadata,
2481
+ retry_policy: @config.retry_policy
2482
+
2483
+ @alloy_db_admin_stub.execute_sql request, options do |result, operation|
2484
+ yield result, operation if block_given?
2485
+ return result
2486
+ end
2487
+ rescue ::Gapic::Rest::Error => e
2488
+ raise ::Google::Cloud::Error.from_error(e)
2489
+ end
2490
+
2491
+ ##
2492
+ # Lists Backups in a given project and location.
2493
+ #
2494
+ # @overload list_backups(request, options = nil)
2495
+ # Pass arguments to `list_backups` via a request object, either of type
2496
+ # {::Google::Cloud::AlloyDB::V1alpha::ListBackupsRequest} or an equivalent Hash.
2497
+ #
2498
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::ListBackupsRequest, ::Hash]
2499
+ # A request object representing the call parameters. Required. To specify no
2500
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2501
+ # @param options [::Gapic::CallOptions, ::Hash]
2502
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2503
+ #
2504
+ # @overload list_backups(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
2505
+ # Pass arguments to `list_backups` via keyword arguments. Note that at
2506
+ # least one keyword argument is required. To specify no parameters, or to keep all
2507
+ # the default parameter values, pass an empty Hash as a request object (see above).
2508
+ #
2509
+ # @param parent [::String]
2510
+ # Required. Parent value for ListBackupsRequest
2511
+ # @param page_size [::Integer]
2512
+ # Requested page size. Server may return fewer items than requested.
2513
+ # If unspecified, server will pick an appropriate default.
2514
+ # @param page_token [::String]
2515
+ # A token identifying a page of results the server should return.
2516
+ # @param filter [::String]
2517
+ # Filtering results
2518
+ # @param order_by [::String]
2519
+ # Hint for how to order the results
2520
+ # @yield [result, operation] Access the result along with the TransportOperation object
2521
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::ListBackupsResponse]
2522
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2523
+ #
2524
+ # @return [::Google::Cloud::AlloyDB::V1alpha::ListBackupsResponse]
2525
+ #
2526
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2527
+ #
2528
+ # @example Basic example
2529
+ # require "google/cloud/alloy_db/v1alpha"
2530
+ #
2531
+ # # Create a client object. The client can be reused for multiple calls.
2532
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
2533
+ #
2534
+ # # Create a request. To set request fields, pass in keyword arguments.
2535
+ # request = Google::Cloud::AlloyDB::V1alpha::ListBackupsRequest.new
2536
+ #
2537
+ # # Call the list_backups method.
2538
+ # result = client.list_backups request
2539
+ #
2540
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2541
+ # # over elements, and API calls will be issued to fetch pages as needed.
2542
+ # result.each do |item|
2543
+ # # Each element is of type ::Google::Cloud::AlloyDB::V1alpha::Backup.
2544
+ # p item
2545
+ # end
2546
+ #
2547
+ def list_backups request, options = nil
2548
+ raise ::ArgumentError, "request must be provided" if request.nil?
2549
+
2550
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::ListBackupsRequest
2551
+
2552
+ # Converts hash and nil to an options object
2553
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2554
+
2555
+ # Customize the options with defaults
2556
+ call_metadata = @config.rpcs.list_backups.metadata.to_h
2557
+
2558
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2559
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2560
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2561
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
2562
+ transports_version_send: [:rest]
2563
+
2564
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2565
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2566
+
2567
+ options.apply_defaults timeout: @config.rpcs.list_backups.timeout,
2568
+ metadata: call_metadata,
2569
+ retry_policy: @config.rpcs.list_backups.retry_policy
2570
+
2571
+ options.apply_defaults timeout: @config.timeout,
2572
+ metadata: @config.metadata,
2573
+ retry_policy: @config.retry_policy
2574
+
2575
+ @alloy_db_admin_stub.list_backups request, options do |result, operation|
2576
+ yield result, operation if block_given?
2577
+ return result
2578
+ end
2579
+ rescue ::Gapic::Rest::Error => e
2580
+ raise ::Google::Cloud::Error.from_error(e)
2581
+ end
2582
+
2583
+ ##
2584
+ # Gets details of a single Backup.
2585
+ #
2586
+ # @overload get_backup(request, options = nil)
2587
+ # Pass arguments to `get_backup` via a request object, either of type
2588
+ # {::Google::Cloud::AlloyDB::V1alpha::GetBackupRequest} or an equivalent Hash.
2589
+ #
2590
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::GetBackupRequest, ::Hash]
2591
+ # A request object representing the call parameters. Required. To specify no
2592
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2593
+ # @param options [::Gapic::CallOptions, ::Hash]
2594
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2595
+ #
2596
+ # @overload get_backup(name: nil)
2597
+ # Pass arguments to `get_backup` via keyword arguments. Note that at
2598
+ # least one keyword argument is required. To specify no parameters, or to keep all
2599
+ # the default parameter values, pass an empty Hash as a request object (see above).
2600
+ #
2601
+ # @param name [::String]
2602
+ # Required. Name of the resource
2603
+ # @yield [result, operation] Access the result along with the TransportOperation object
2604
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::Backup]
2605
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2606
+ #
2607
+ # @return [::Google::Cloud::AlloyDB::V1alpha::Backup]
2608
+ #
2609
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2610
+ #
2611
+ # @example Basic example
2612
+ # require "google/cloud/alloy_db/v1alpha"
2613
+ #
2614
+ # # Create a client object. The client can be reused for multiple calls.
2615
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
2616
+ #
2617
+ # # Create a request. To set request fields, pass in keyword arguments.
2618
+ # request = Google::Cloud::AlloyDB::V1alpha::GetBackupRequest.new
2619
+ #
2620
+ # # Call the get_backup method.
2621
+ # result = client.get_backup request
2622
+ #
2623
+ # # The returned object is of type Google::Cloud::AlloyDB::V1alpha::Backup.
2624
+ # p result
2625
+ #
2626
+ def get_backup request, options = nil
2627
+ raise ::ArgumentError, "request must be provided" if request.nil?
2628
+
2629
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::GetBackupRequest
2630
+
2631
+ # Converts hash and nil to an options object
2632
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2633
+
2634
+ # Customize the options with defaults
2635
+ call_metadata = @config.rpcs.get_backup.metadata.to_h
2636
+
2637
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2638
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2639
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2640
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
2641
+ transports_version_send: [:rest]
2642
+
2643
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2644
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2645
+
2646
+ options.apply_defaults timeout: @config.rpcs.get_backup.timeout,
2647
+ metadata: call_metadata,
2648
+ retry_policy: @config.rpcs.get_backup.retry_policy
2649
+
2650
+ options.apply_defaults timeout: @config.timeout,
2651
+ metadata: @config.metadata,
2652
+ retry_policy: @config.retry_policy
2653
+
2654
+ @alloy_db_admin_stub.get_backup request, options do |result, operation|
2655
+ yield result, operation if block_given?
2656
+ return result
2657
+ end
2658
+ rescue ::Gapic::Rest::Error => e
2659
+ raise ::Google::Cloud::Error.from_error(e)
2660
+ end
2661
+
2662
+ ##
2663
+ # Creates a new Backup in a given project and location.
2664
+ #
2665
+ # @overload create_backup(request, options = nil)
2666
+ # Pass arguments to `create_backup` via a request object, either of type
2667
+ # {::Google::Cloud::AlloyDB::V1alpha::CreateBackupRequest} or an equivalent Hash.
2668
+ #
2669
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::CreateBackupRequest, ::Hash]
2670
+ # A request object representing the call parameters. Required. To specify no
2671
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2672
+ # @param options [::Gapic::CallOptions, ::Hash]
2673
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2674
+ #
2675
+ # @overload create_backup(parent: nil, backup_id: nil, backup: nil, request_id: nil, validate_only: nil)
2676
+ # Pass arguments to `create_backup` via keyword arguments. Note that at
2677
+ # least one keyword argument is required. To specify no parameters, or to keep all
2678
+ # the default parameter values, pass an empty Hash as a request object (see above).
2679
+ #
2680
+ # @param parent [::String]
2681
+ # Required. Value for parent.
2682
+ # @param backup_id [::String]
2683
+ # Required. ID of the requesting object.
2684
+ # @param backup [::Google::Cloud::AlloyDB::V1alpha::Backup, ::Hash]
2685
+ # Required. The resource being created
2686
+ # @param request_id [::String]
2687
+ # Optional. An optional request ID to identify requests. Specify a unique
2688
+ # request ID so that if you must retry your request, the server ignores the
2689
+ # request if it has already been completed. The server guarantees that for at
2690
+ # least 60 minutes since the first request.
2691
+ #
2692
+ # For example, consider a situation where you make an initial request and
2693
+ # the request times out. If you make the request again with the same request
2694
+ # ID, the server can check if the original operation with the same request ID
2695
+ # was received, and if so, ignores the second request. This prevents
2696
+ # clients from accidentally creating duplicate commitments.
2697
+ #
2698
+ # The request ID must be a valid UUID with the exception that zero UUID is
2699
+ # not supported (00000000-0000-0000-0000-000000000000).
2700
+ # @param validate_only [::Boolean]
2701
+ # Optional. If set, the backend validates the request, but doesn't actually
2702
+ # execute it.
2703
+ # @yield [result, operation] Access the result along with the TransportOperation object
2704
+ # @yieldparam result [::Gapic::Operation]
2705
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2706
+ #
2707
+ # @return [::Gapic::Operation]
2708
+ #
2709
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2710
+ #
2711
+ # @example Basic example
2712
+ # require "google/cloud/alloy_db/v1alpha"
2713
+ #
2714
+ # # Create a client object. The client can be reused for multiple calls.
2715
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
2716
+ #
2717
+ # # Create a request. To set request fields, pass in keyword arguments.
2718
+ # request = Google::Cloud::AlloyDB::V1alpha::CreateBackupRequest.new
2719
+ #
2720
+ # # Call the create_backup method.
2721
+ # result = client.create_backup request
2722
+ #
2723
+ # # The returned object is of type Gapic::Operation. You can use it to
2724
+ # # check the status of an operation, cancel it, or wait for results.
2725
+ # # Here is how to wait for a response.
2726
+ # result.wait_until_done! timeout: 60
2727
+ # if result.response?
2728
+ # p result.response
2729
+ # else
2730
+ # puts "No response received."
2731
+ # end
2732
+ #
2733
+ def create_backup request, options = nil
2734
+ raise ::ArgumentError, "request must be provided" if request.nil?
2735
+
2736
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::CreateBackupRequest
2737
+
2738
+ # Converts hash and nil to an options object
2739
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2740
+
2741
+ # Customize the options with defaults
2742
+ call_metadata = @config.rpcs.create_backup.metadata.to_h
2743
+
2744
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2745
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2746
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2747
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
2748
+ transports_version_send: [:rest]
2749
+
2750
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2751
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2752
+
2753
+ options.apply_defaults timeout: @config.rpcs.create_backup.timeout,
2754
+ metadata: call_metadata,
2755
+ retry_policy: @config.rpcs.create_backup.retry_policy
2756
+
2757
+ options.apply_defaults timeout: @config.timeout,
2758
+ metadata: @config.metadata,
2759
+ retry_policy: @config.retry_policy
2760
+
2761
+ @alloy_db_admin_stub.create_backup request, options do |result, operation|
2762
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2763
+ yield result, operation if block_given?
2764
+ return result
2765
+ end
2766
+ rescue ::Gapic::Rest::Error => e
2767
+ raise ::Google::Cloud::Error.from_error(e)
2768
+ end
2769
+
2770
+ ##
2771
+ # Updates the parameters of a single Backup.
2772
+ #
2773
+ # @overload update_backup(request, options = nil)
2774
+ # Pass arguments to `update_backup` via a request object, either of type
2775
+ # {::Google::Cloud::AlloyDB::V1alpha::UpdateBackupRequest} or an equivalent Hash.
2776
+ #
2777
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::UpdateBackupRequest, ::Hash]
2778
+ # A request object representing the call parameters. Required. To specify no
2779
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2780
+ # @param options [::Gapic::CallOptions, ::Hash]
2781
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2782
+ #
2783
+ # @overload update_backup(update_mask: nil, backup: nil, request_id: nil, validate_only: nil, allow_missing: nil)
2784
+ # Pass arguments to `update_backup` via keyword arguments. Note that at
2785
+ # least one keyword argument is required. To specify no parameters, or to keep all
2786
+ # the default parameter values, pass an empty Hash as a request object (see above).
2787
+ #
2788
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
2789
+ # Optional. Field mask is used to specify the fields to be overwritten in the
2790
+ # Backup resource by the update.
2791
+ # The fields specified in the update_mask are relative to the resource, not
2792
+ # the full request. A field will be overwritten if it is in the mask. If the
2793
+ # user does not provide a mask then all fields will be overwritten.
2794
+ # @param backup [::Google::Cloud::AlloyDB::V1alpha::Backup, ::Hash]
2795
+ # Required. The resource being updated
2796
+ # @param request_id [::String]
2797
+ # Optional. An optional request ID to identify requests. Specify a unique
2798
+ # request ID so that if you must retry your request, the server ignores the
2799
+ # request if it has already been completed. The server guarantees that for at
2800
+ # least 60 minutes since the first request.
2801
+ #
2802
+ # For example, consider a situation where you make an initial request and
2803
+ # the request times out. If you make the request again with the same request
2804
+ # ID, the server can check if the original operation with the same request ID
2805
+ # was received, and if so, ignores the second request. This prevents
2806
+ # clients from accidentally creating duplicate commitments.
2807
+ #
2808
+ # The request ID must be a valid UUID with the exception that zero UUID is
2809
+ # not supported (00000000-0000-0000-0000-000000000000).
2810
+ # @param validate_only [::Boolean]
2811
+ # Optional. If set, the backend validates the request, but doesn't actually
2812
+ # execute it.
2813
+ # @param allow_missing [::Boolean]
2814
+ # Optional. If set to true, update succeeds even if instance is not found. In
2815
+ # that case, a new backup is created and `update_mask` is ignored.
2816
+ # @yield [result, operation] Access the result along with the TransportOperation object
2817
+ # @yieldparam result [::Gapic::Operation]
2818
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2819
+ #
2820
+ # @return [::Gapic::Operation]
2821
+ #
2822
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2823
+ #
2824
+ # @example Basic example
2825
+ # require "google/cloud/alloy_db/v1alpha"
2826
+ #
2827
+ # # Create a client object. The client can be reused for multiple calls.
2828
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
2829
+ #
2830
+ # # Create a request. To set request fields, pass in keyword arguments.
2831
+ # request = Google::Cloud::AlloyDB::V1alpha::UpdateBackupRequest.new
2832
+ #
2833
+ # # Call the update_backup method.
2834
+ # result = client.update_backup request
2835
+ #
2836
+ # # The returned object is of type Gapic::Operation. You can use it to
2837
+ # # check the status of an operation, cancel it, or wait for results.
2838
+ # # Here is how to wait for a response.
2839
+ # result.wait_until_done! timeout: 60
2840
+ # if result.response?
2841
+ # p result.response
2842
+ # else
2843
+ # puts "No response received."
2844
+ # end
2845
+ #
2846
+ def update_backup request, options = nil
2847
+ raise ::ArgumentError, "request must be provided" if request.nil?
2848
+
2849
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::UpdateBackupRequest
2850
+
2851
+ # Converts hash and nil to an options object
2852
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2853
+
2854
+ # Customize the options with defaults
2855
+ call_metadata = @config.rpcs.update_backup.metadata.to_h
2856
+
2857
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2858
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2859
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2860
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
2861
+ transports_version_send: [:rest]
2862
+
2863
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2864
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2865
+
2866
+ options.apply_defaults timeout: @config.rpcs.update_backup.timeout,
2867
+ metadata: call_metadata,
2868
+ retry_policy: @config.rpcs.update_backup.retry_policy
2869
+
2870
+ options.apply_defaults timeout: @config.timeout,
2871
+ metadata: @config.metadata,
2872
+ retry_policy: @config.retry_policy
2873
+
2874
+ @alloy_db_admin_stub.update_backup request, options do |result, operation|
2875
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2876
+ yield result, operation if block_given?
2877
+ return result
2878
+ end
2879
+ rescue ::Gapic::Rest::Error => e
2880
+ raise ::Google::Cloud::Error.from_error(e)
2881
+ end
2882
+
2883
+ ##
2884
+ # Deletes a single Backup.
2885
+ #
2886
+ # @overload delete_backup(request, options = nil)
2887
+ # Pass arguments to `delete_backup` via a request object, either of type
2888
+ # {::Google::Cloud::AlloyDB::V1alpha::DeleteBackupRequest} or an equivalent Hash.
2889
+ #
2890
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::DeleteBackupRequest, ::Hash]
2891
+ # A request object representing the call parameters. Required. To specify no
2892
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2893
+ # @param options [::Gapic::CallOptions, ::Hash]
2894
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
2895
+ #
2896
+ # @overload delete_backup(name: nil, request_id: nil, validate_only: nil, etag: nil)
2897
+ # Pass arguments to `delete_backup` via keyword arguments. Note that at
2898
+ # least one keyword argument is required. To specify no parameters, or to keep all
2899
+ # the default parameter values, pass an empty Hash as a request object (see above).
2900
+ #
2901
+ # @param name [::String]
2902
+ # Required. Name of the resource. For the required format, see the comment on
2903
+ # the Backup.name field.
2904
+ # @param request_id [::String]
2905
+ # Optional. An optional request ID to identify requests. Specify a unique
2906
+ # request ID so that if you must retry your request, the server ignores the
2907
+ # request if it has already been completed. The server guarantees that for at
2908
+ # least 60 minutes since the first request.
2909
+ #
2910
+ # For example, consider a situation where you make an initial request and
2911
+ # the request times out. If you make the request again with the same request
2912
+ # ID, the server can check if the original operation with the same request ID
2913
+ # was received, and if so, ignores the second request. This prevents
2914
+ # clients from accidentally creating duplicate commitments.
2915
+ #
2916
+ # The request ID must be a valid UUID with the exception that zero UUID is
2917
+ # not supported (00000000-0000-0000-0000-000000000000).
2918
+ # @param validate_only [::Boolean]
2919
+ # Optional. If set, the backend validates the request, but doesn't actually
2920
+ # execute it.
2921
+ # @param etag [::String]
2922
+ # Optional. The current etag of the Backup.
2923
+ # If an etag is provided and does not match the current etag of the Backup,
2924
+ # deletion will be blocked and an ABORTED error will be returned.
2925
+ # @yield [result, operation] Access the result along with the TransportOperation object
2926
+ # @yieldparam result [::Gapic::Operation]
2927
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
2928
+ #
2929
+ # @return [::Gapic::Operation]
2930
+ #
2931
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
2932
+ #
2933
+ # @example Basic example
2934
+ # require "google/cloud/alloy_db/v1alpha"
2935
+ #
2936
+ # # Create a client object. The client can be reused for multiple calls.
2937
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
2938
+ #
2939
+ # # Create a request. To set request fields, pass in keyword arguments.
2940
+ # request = Google::Cloud::AlloyDB::V1alpha::DeleteBackupRequest.new
2941
+ #
2942
+ # # Call the delete_backup method.
2943
+ # result = client.delete_backup request
2944
+ #
2945
+ # # The returned object is of type Gapic::Operation. You can use it to
2946
+ # # check the status of an operation, cancel it, or wait for results.
2947
+ # # Here is how to wait for a response.
2948
+ # result.wait_until_done! timeout: 60
2949
+ # if result.response?
2950
+ # p result.response
2951
+ # else
2952
+ # puts "No response received."
2953
+ # end
2954
+ #
2955
+ def delete_backup request, options = nil
2956
+ raise ::ArgumentError, "request must be provided" if request.nil?
2957
+
2958
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::DeleteBackupRequest
2959
+
2960
+ # Converts hash and nil to an options object
2961
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2962
+
2963
+ # Customize the options with defaults
2964
+ call_metadata = @config.rpcs.delete_backup.metadata.to_h
2965
+
2966
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2967
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2968
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2969
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
2970
+ transports_version_send: [:rest]
2971
+
2972
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2973
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2974
+
2975
+ options.apply_defaults timeout: @config.rpcs.delete_backup.timeout,
2976
+ metadata: call_metadata,
2977
+ retry_policy: @config.rpcs.delete_backup.retry_policy
2978
+
2979
+ options.apply_defaults timeout: @config.timeout,
2980
+ metadata: @config.metadata,
2981
+ retry_policy: @config.retry_policy
2982
+
2983
+ @alloy_db_admin_stub.delete_backup request, options do |result, operation|
2984
+ result = ::Gapic::Operation.new result, @operations_client, options: options
2985
+ yield result, operation if block_given?
2986
+ return result
2987
+ end
2988
+ rescue ::Gapic::Rest::Error => e
2989
+ raise ::Google::Cloud::Error.from_error(e)
2990
+ end
2991
+
2992
+ ##
2993
+ # Lists SupportedDatabaseFlags for a given project and location.
2994
+ #
2995
+ # @overload list_supported_database_flags(request, options = nil)
2996
+ # Pass arguments to `list_supported_database_flags` via a request object, either of type
2997
+ # {::Google::Cloud::AlloyDB::V1alpha::ListSupportedDatabaseFlagsRequest} or an equivalent Hash.
2998
+ #
2999
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::ListSupportedDatabaseFlagsRequest, ::Hash]
3000
+ # A request object representing the call parameters. Required. To specify no
3001
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3002
+ # @param options [::Gapic::CallOptions, ::Hash]
3003
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
3004
+ #
3005
+ # @overload list_supported_database_flags(parent: nil, page_size: nil, page_token: nil)
3006
+ # Pass arguments to `list_supported_database_flags` via keyword arguments. Note that at
3007
+ # least one keyword argument is required. To specify no parameters, or to keep all
3008
+ # the default parameter values, pass an empty Hash as a request object (see above).
3009
+ #
3010
+ # @param parent [::String]
3011
+ # Required. The name of the parent resource. The required format is:
3012
+ # * projects/\\{project}/locations/\\{location}
3013
+ #
3014
+ # Regardless of the parent specified here, as long it is contains a valid
3015
+ # project and location, the service will return a static list of supported
3016
+ # flags resources. Note that we do not yet support region-specific
3017
+ # flags.
3018
+ # @param page_size [::Integer]
3019
+ # Requested page size. Server may return fewer items than requested.
3020
+ # If unspecified, server will pick an appropriate default.
3021
+ # @param page_token [::String]
3022
+ # A token identifying a page of results the server should return.
3023
+ # @yield [result, operation] Access the result along with the TransportOperation object
3024
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::AlloyDB::V1alpha::SupportedDatabaseFlag>]
3025
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
3026
+ #
3027
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::AlloyDB::V1alpha::SupportedDatabaseFlag>]
3028
+ #
3029
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
3030
+ #
3031
+ # @example Basic example
3032
+ # require "google/cloud/alloy_db/v1alpha"
3033
+ #
3034
+ # # Create a client object. The client can be reused for multiple calls.
3035
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
3036
+ #
3037
+ # # Create a request. To set request fields, pass in keyword arguments.
3038
+ # request = Google::Cloud::AlloyDB::V1alpha::ListSupportedDatabaseFlagsRequest.new
3039
+ #
3040
+ # # Call the list_supported_database_flags method.
3041
+ # result = client.list_supported_database_flags request
3042
+ #
3043
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
3044
+ # # over elements, and API calls will be issued to fetch pages as needed.
3045
+ # result.each do |item|
3046
+ # # Each element is of type ::Google::Cloud::AlloyDB::V1alpha::SupportedDatabaseFlag.
3047
+ # p item
3048
+ # end
3049
+ #
3050
+ def list_supported_database_flags request, options = nil
3051
+ raise ::ArgumentError, "request must be provided" if request.nil?
3052
+
3053
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::ListSupportedDatabaseFlagsRequest
3054
+
3055
+ # Converts hash and nil to an options object
3056
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3057
+
3058
+ # Customize the options with defaults
3059
+ call_metadata = @config.rpcs.list_supported_database_flags.metadata.to_h
3060
+
3061
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3062
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3063
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3064
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
3065
+ transports_version_send: [:rest]
3066
+
3067
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3068
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3069
+
3070
+ options.apply_defaults timeout: @config.rpcs.list_supported_database_flags.timeout,
3071
+ metadata: call_metadata,
3072
+ retry_policy: @config.rpcs.list_supported_database_flags.retry_policy
3073
+
3074
+ options.apply_defaults timeout: @config.timeout,
3075
+ metadata: @config.metadata,
3076
+ retry_policy: @config.retry_policy
3077
+
3078
+ @alloy_db_admin_stub.list_supported_database_flags request, options do |result, operation|
3079
+ result = ::Gapic::Rest::PagedEnumerable.new @alloy_db_admin_stub, :list_supported_database_flags, "supported_database_flags", request, result, options
3080
+ yield result, operation if block_given?
3081
+ return result
3082
+ end
3083
+ rescue ::Gapic::Rest::Error => e
3084
+ raise ::Google::Cloud::Error.from_error(e)
3085
+ end
3086
+
3087
+ ##
3088
+ # Generate a client certificate signed by a Cluster CA.
3089
+ # The sole purpose of this endpoint is to support AlloyDB connectors and the
3090
+ # Auth Proxy client. The endpoint's behavior is subject to change without
3091
+ # notice, so do not rely on its behavior remaining constant. Future changes
3092
+ # will not break AlloyDB connectors or the Auth Proxy client.
3093
+ #
3094
+ # @overload generate_client_certificate(request, options = nil)
3095
+ # Pass arguments to `generate_client_certificate` via a request object, either of type
3096
+ # {::Google::Cloud::AlloyDB::V1alpha::GenerateClientCertificateRequest} or an equivalent Hash.
3097
+ #
3098
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::GenerateClientCertificateRequest, ::Hash]
3099
+ # A request object representing the call parameters. Required. To specify no
3100
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3101
+ # @param options [::Gapic::CallOptions, ::Hash]
3102
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
3103
+ #
3104
+ # @overload generate_client_certificate(parent: nil, request_id: nil, pem_csr: nil, cert_duration: nil, public_key: nil, use_metadata_exchange: nil)
3105
+ # Pass arguments to `generate_client_certificate` via keyword arguments. Note that at
3106
+ # least one keyword argument is required. To specify no parameters, or to keep all
3107
+ # the default parameter values, pass an empty Hash as a request object (see above).
3108
+ #
3109
+ # @param parent [::String]
3110
+ # Required. The name of the parent resource. The required format is:
3111
+ # * projects/\\{project}/locations/\\{location}/clusters/\\{cluster}
3112
+ # @param request_id [::String]
3113
+ # Optional. An optional request ID to identify requests. Specify a unique
3114
+ # request ID so that if you must retry your request, the server ignores the
3115
+ # request if it has already been completed. The server guarantees that for at
3116
+ # least 60 minutes since the first request.
3117
+ #
3118
+ # For example, consider a situation where you make an initial request and
3119
+ # the request times out. If you make the request again with the same request
3120
+ # ID, the server can check if the original operation with the same request ID
3121
+ # was received, and if so, ignores the second request. This prevents
3122
+ # clients from accidentally creating duplicate commitments.
3123
+ #
3124
+ # The request ID must be a valid UUID with the exception that zero UUID is
3125
+ # not supported (00000000-0000-0000-0000-000000000000).
3126
+ # @param pem_csr [::String]
3127
+ # Optional. A pem-encoded X.509 certificate signing request (CSR). It is
3128
+ # recommended to use public_key instead.
3129
+ # @param cert_duration [::Google::Protobuf::Duration, ::Hash]
3130
+ # Optional. An optional hint to the endpoint to generate the client
3131
+ # certificate with the requested duration. The duration can be from 1 hour to
3132
+ # 24 hours. The endpoint may or may not honor the hint. If the hint is left
3133
+ # unspecified or is not honored, then the endpoint will pick an appropriate
3134
+ # default duration.
3135
+ # @param public_key [::String]
3136
+ # Optional. The public key from the client.
3137
+ # @param use_metadata_exchange [::Boolean]
3138
+ # Optional. An optional hint to the endpoint to generate a client
3139
+ # ceritificate that can be used by AlloyDB connectors to exchange additional
3140
+ # metadata with the server after TLS handshake.
3141
+ # @yield [result, operation] Access the result along with the TransportOperation object
3142
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::GenerateClientCertificateResponse]
3143
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
3144
+ #
3145
+ # @return [::Google::Cloud::AlloyDB::V1alpha::GenerateClientCertificateResponse]
3146
+ #
3147
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
3148
+ #
3149
+ # @example Basic example
3150
+ # require "google/cloud/alloy_db/v1alpha"
3151
+ #
3152
+ # # Create a client object. The client can be reused for multiple calls.
3153
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
3154
+ #
3155
+ # # Create a request. To set request fields, pass in keyword arguments.
3156
+ # request = Google::Cloud::AlloyDB::V1alpha::GenerateClientCertificateRequest.new
3157
+ #
3158
+ # # Call the generate_client_certificate method.
3159
+ # result = client.generate_client_certificate request
3160
+ #
3161
+ # # The returned object is of type Google::Cloud::AlloyDB::V1alpha::GenerateClientCertificateResponse.
3162
+ # p result
3163
+ #
3164
+ def generate_client_certificate request, options = nil
3165
+ raise ::ArgumentError, "request must be provided" if request.nil?
3166
+
3167
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::GenerateClientCertificateRequest
3168
+
3169
+ # Converts hash and nil to an options object
3170
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3171
+
3172
+ # Customize the options with defaults
3173
+ call_metadata = @config.rpcs.generate_client_certificate.metadata.to_h
3174
+
3175
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3176
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3177
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3178
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
3179
+ transports_version_send: [:rest]
3180
+
3181
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3182
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3183
+
3184
+ options.apply_defaults timeout: @config.rpcs.generate_client_certificate.timeout,
3185
+ metadata: call_metadata,
3186
+ retry_policy: @config.rpcs.generate_client_certificate.retry_policy
3187
+
3188
+ options.apply_defaults timeout: @config.timeout,
3189
+ metadata: @config.metadata,
3190
+ retry_policy: @config.retry_policy
3191
+
3192
+ @alloy_db_admin_stub.generate_client_certificate request, options do |result, operation|
3193
+ yield result, operation if block_given?
3194
+ return result
3195
+ end
3196
+ rescue ::Gapic::Rest::Error => e
3197
+ raise ::Google::Cloud::Error.from_error(e)
3198
+ end
3199
+
3200
+ ##
3201
+ # Get instance metadata used for a connection.
3202
+ #
3203
+ # @overload get_connection_info(request, options = nil)
3204
+ # Pass arguments to `get_connection_info` via a request object, either of type
3205
+ # {::Google::Cloud::AlloyDB::V1alpha::GetConnectionInfoRequest} or an equivalent Hash.
3206
+ #
3207
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::GetConnectionInfoRequest, ::Hash]
3208
+ # A request object representing the call parameters. Required. To specify no
3209
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3210
+ # @param options [::Gapic::CallOptions, ::Hash]
3211
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
3212
+ #
3213
+ # @overload get_connection_info(parent: nil, request_id: nil)
3214
+ # Pass arguments to `get_connection_info` via keyword arguments. Note that at
3215
+ # least one keyword argument is required. To specify no parameters, or to keep all
3216
+ # the default parameter values, pass an empty Hash as a request object (see above).
3217
+ #
3218
+ # @param parent [::String]
3219
+ # Required. The name of the parent resource. The required format is:
3220
+ # projects/\\{project}/locations/\\{location}/clusters/\\{cluster}/instances/\\{instance}
3221
+ # @param request_id [::String]
3222
+ # Optional. An optional request ID to identify requests. Specify a unique
3223
+ # request ID so that if you must retry your request, the server ignores the
3224
+ # request if it has already been completed. The server guarantees that for at
3225
+ # least 60 minutes since the first request.
3226
+ #
3227
+ # For example, consider a situation where you make an initial request and
3228
+ # the request times out. If you make the request again with the same request
3229
+ # ID, the server can check if the original operation with the same request ID
3230
+ # was received, and if so, ignores the second request. This prevents
3231
+ # clients from accidentally creating duplicate commitments.
3232
+ #
3233
+ # The request ID must be a valid UUID with the exception that zero UUID is
3234
+ # not supported (00000000-0000-0000-0000-000000000000).
3235
+ # @yield [result, operation] Access the result along with the TransportOperation object
3236
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::ConnectionInfo]
3237
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
3238
+ #
3239
+ # @return [::Google::Cloud::AlloyDB::V1alpha::ConnectionInfo]
3240
+ #
3241
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
3242
+ #
3243
+ # @example Basic example
3244
+ # require "google/cloud/alloy_db/v1alpha"
3245
+ #
3246
+ # # Create a client object. The client can be reused for multiple calls.
3247
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
3248
+ #
3249
+ # # Create a request. To set request fields, pass in keyword arguments.
3250
+ # request = Google::Cloud::AlloyDB::V1alpha::GetConnectionInfoRequest.new
3251
+ #
3252
+ # # Call the get_connection_info method.
3253
+ # result = client.get_connection_info request
3254
+ #
3255
+ # # The returned object is of type Google::Cloud::AlloyDB::V1alpha::ConnectionInfo.
3256
+ # p result
3257
+ #
3258
+ def get_connection_info request, options = nil
3259
+ raise ::ArgumentError, "request must be provided" if request.nil?
3260
+
3261
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::GetConnectionInfoRequest
3262
+
3263
+ # Converts hash and nil to an options object
3264
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3265
+
3266
+ # Customize the options with defaults
3267
+ call_metadata = @config.rpcs.get_connection_info.metadata.to_h
3268
+
3269
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3270
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3271
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3272
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
3273
+ transports_version_send: [:rest]
3274
+
3275
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3276
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3277
+
3278
+ options.apply_defaults timeout: @config.rpcs.get_connection_info.timeout,
3279
+ metadata: call_metadata,
3280
+ retry_policy: @config.rpcs.get_connection_info.retry_policy
3281
+
3282
+ options.apply_defaults timeout: @config.timeout,
3283
+ metadata: @config.metadata,
3284
+ retry_policy: @config.retry_policy
3285
+
3286
+ @alloy_db_admin_stub.get_connection_info request, options do |result, operation|
3287
+ yield result, operation if block_given?
3288
+ return result
3289
+ end
3290
+ rescue ::Gapic::Rest::Error => e
3291
+ raise ::Google::Cloud::Error.from_error(e)
3292
+ end
3293
+
3294
+ ##
3295
+ # Lists Users in a given project and location.
3296
+ #
3297
+ # @overload list_users(request, options = nil)
3298
+ # Pass arguments to `list_users` via a request object, either of type
3299
+ # {::Google::Cloud::AlloyDB::V1alpha::ListUsersRequest} or an equivalent Hash.
3300
+ #
3301
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::ListUsersRequest, ::Hash]
3302
+ # A request object representing the call parameters. Required. To specify no
3303
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3304
+ # @param options [::Gapic::CallOptions, ::Hash]
3305
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
3306
+ #
3307
+ # @overload list_users(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
3308
+ # Pass arguments to `list_users` via keyword arguments. Note that at
3309
+ # least one keyword argument is required. To specify no parameters, or to keep all
3310
+ # the default parameter values, pass an empty Hash as a request object (see above).
3311
+ #
3312
+ # @param parent [::String]
3313
+ # Required. Parent value for ListUsersRequest
3314
+ # @param page_size [::Integer]
3315
+ # Optional. Requested page size. Server may return fewer items than
3316
+ # requested. If unspecified, server will pick an appropriate default.
3317
+ # @param page_token [::String]
3318
+ # Optional. A token identifying a page of results the server should return.
3319
+ # @param filter [::String]
3320
+ # Optional. Filtering results
3321
+ # @param order_by [::String]
3322
+ # Optional. Hint for how to order the results
3323
+ # @yield [result, operation] Access the result along with the TransportOperation object
3324
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::ListUsersResponse]
3325
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
3326
+ #
3327
+ # @return [::Google::Cloud::AlloyDB::V1alpha::ListUsersResponse]
3328
+ #
3329
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
3330
+ #
3331
+ # @example Basic example
3332
+ # require "google/cloud/alloy_db/v1alpha"
3333
+ #
3334
+ # # Create a client object. The client can be reused for multiple calls.
3335
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
3336
+ #
3337
+ # # Create a request. To set request fields, pass in keyword arguments.
3338
+ # request = Google::Cloud::AlloyDB::V1alpha::ListUsersRequest.new
3339
+ #
3340
+ # # Call the list_users method.
3341
+ # result = client.list_users request
3342
+ #
3343
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
3344
+ # # over elements, and API calls will be issued to fetch pages as needed.
3345
+ # result.each do |item|
3346
+ # # Each element is of type ::Google::Cloud::AlloyDB::V1alpha::User.
3347
+ # p item
3348
+ # end
3349
+ #
3350
+ def list_users request, options = nil
3351
+ raise ::ArgumentError, "request must be provided" if request.nil?
3352
+
3353
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::ListUsersRequest
3354
+
3355
+ # Converts hash and nil to an options object
3356
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3357
+
3358
+ # Customize the options with defaults
3359
+ call_metadata = @config.rpcs.list_users.metadata.to_h
3360
+
3361
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3362
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3363
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3364
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
3365
+ transports_version_send: [:rest]
3366
+
3367
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3368
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3369
+
3370
+ options.apply_defaults timeout: @config.rpcs.list_users.timeout,
3371
+ metadata: call_metadata,
3372
+ retry_policy: @config.rpcs.list_users.retry_policy
3373
+
3374
+ options.apply_defaults timeout: @config.timeout,
3375
+ metadata: @config.metadata,
3376
+ retry_policy: @config.retry_policy
3377
+
3378
+ @alloy_db_admin_stub.list_users request, options do |result, operation|
3379
+ yield result, operation if block_given?
3380
+ return result
3381
+ end
3382
+ rescue ::Gapic::Rest::Error => e
3383
+ raise ::Google::Cloud::Error.from_error(e)
3384
+ end
3385
+
3386
+ ##
3387
+ # Gets details of a single User.
3388
+ #
3389
+ # @overload get_user(request, options = nil)
3390
+ # Pass arguments to `get_user` via a request object, either of type
3391
+ # {::Google::Cloud::AlloyDB::V1alpha::GetUserRequest} or an equivalent Hash.
3392
+ #
3393
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::GetUserRequest, ::Hash]
3394
+ # A request object representing the call parameters. Required. To specify no
3395
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3396
+ # @param options [::Gapic::CallOptions, ::Hash]
3397
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
3398
+ #
3399
+ # @overload get_user(name: nil)
3400
+ # Pass arguments to `get_user` via keyword arguments. Note that at
3401
+ # least one keyword argument is required. To specify no parameters, or to keep all
3402
+ # the default parameter values, pass an empty Hash as a request object (see above).
3403
+ #
3404
+ # @param name [::String]
3405
+ # Required. The name of the resource. For the required format, see the
3406
+ # comment on the User.name field.
3407
+ # @yield [result, operation] Access the result along with the TransportOperation object
3408
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::User]
3409
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
3410
+ #
3411
+ # @return [::Google::Cloud::AlloyDB::V1alpha::User]
3412
+ #
3413
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
3414
+ #
3415
+ # @example Basic example
3416
+ # require "google/cloud/alloy_db/v1alpha"
3417
+ #
3418
+ # # Create a client object. The client can be reused for multiple calls.
3419
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
3420
+ #
3421
+ # # Create a request. To set request fields, pass in keyword arguments.
3422
+ # request = Google::Cloud::AlloyDB::V1alpha::GetUserRequest.new
3423
+ #
3424
+ # # Call the get_user method.
3425
+ # result = client.get_user request
3426
+ #
3427
+ # # The returned object is of type Google::Cloud::AlloyDB::V1alpha::User.
3428
+ # p result
3429
+ #
3430
+ def get_user request, options = nil
3431
+ raise ::ArgumentError, "request must be provided" if request.nil?
3432
+
3433
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::GetUserRequest
3434
+
3435
+ # Converts hash and nil to an options object
3436
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3437
+
3438
+ # Customize the options with defaults
3439
+ call_metadata = @config.rpcs.get_user.metadata.to_h
3440
+
3441
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3442
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3443
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3444
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
3445
+ transports_version_send: [:rest]
3446
+
3447
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3448
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3449
+
3450
+ options.apply_defaults timeout: @config.rpcs.get_user.timeout,
3451
+ metadata: call_metadata,
3452
+ retry_policy: @config.rpcs.get_user.retry_policy
3453
+
3454
+ options.apply_defaults timeout: @config.timeout,
3455
+ metadata: @config.metadata,
3456
+ retry_policy: @config.retry_policy
3457
+
3458
+ @alloy_db_admin_stub.get_user request, options do |result, operation|
3459
+ yield result, operation if block_given?
3460
+ return result
3461
+ end
3462
+ rescue ::Gapic::Rest::Error => e
3463
+ raise ::Google::Cloud::Error.from_error(e)
3464
+ end
3465
+
3466
+ ##
3467
+ # Creates a new User in a given project, location, and cluster.
3468
+ #
3469
+ # @overload create_user(request, options = nil)
3470
+ # Pass arguments to `create_user` via a request object, either of type
3471
+ # {::Google::Cloud::AlloyDB::V1alpha::CreateUserRequest} or an equivalent Hash.
3472
+ #
3473
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::CreateUserRequest, ::Hash]
3474
+ # A request object representing the call parameters. Required. To specify no
3475
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3476
+ # @param options [::Gapic::CallOptions, ::Hash]
3477
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
3478
+ #
3479
+ # @overload create_user(parent: nil, user_id: nil, user: nil, request_id: nil, validate_only: nil)
3480
+ # Pass arguments to `create_user` via keyword arguments. Note that at
3481
+ # least one keyword argument is required. To specify no parameters, or to keep all
3482
+ # the default parameter values, pass an empty Hash as a request object (see above).
3483
+ #
3484
+ # @param parent [::String]
3485
+ # Required. Value for parent.
3486
+ # @param user_id [::String]
3487
+ # Required. ID of the requesting object.
3488
+ # @param user [::Google::Cloud::AlloyDB::V1alpha::User, ::Hash]
3489
+ # Required. The resource being created
3490
+ # @param request_id [::String]
3491
+ # Optional. An optional request ID to identify requests. Specify a unique
3492
+ # request ID so that if you must retry your request, the server ignores the
3493
+ # request if it has already been completed. The server guarantees that for at
3494
+ # least 60 minutes since the first request.
3495
+ #
3496
+ # For example, consider a situation where you make an initial request and
3497
+ # the request times out. If you make the request again with the same request
3498
+ # ID, the server can check if the original operation with the same request ID
3499
+ # was received, and if so, ignores the second request. This prevents
3500
+ # clients from accidentally creating duplicate commitments.
3501
+ #
3502
+ # The request ID must be a valid UUID with the exception that zero UUID is
3503
+ # not supported (00000000-0000-0000-0000-000000000000).
3504
+ # @param validate_only [::Boolean]
3505
+ # Optional. If set, the backend validates the request, but doesn't actually
3506
+ # execute it.
3507
+ # @yield [result, operation] Access the result along with the TransportOperation object
3508
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::User]
3509
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
3510
+ #
3511
+ # @return [::Google::Cloud::AlloyDB::V1alpha::User]
3512
+ #
3513
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
3514
+ #
3515
+ # @example Basic example
3516
+ # require "google/cloud/alloy_db/v1alpha"
3517
+ #
3518
+ # # Create a client object. The client can be reused for multiple calls.
3519
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
3520
+ #
3521
+ # # Create a request. To set request fields, pass in keyword arguments.
3522
+ # request = Google::Cloud::AlloyDB::V1alpha::CreateUserRequest.new
3523
+ #
3524
+ # # Call the create_user method.
3525
+ # result = client.create_user request
3526
+ #
3527
+ # # The returned object is of type Google::Cloud::AlloyDB::V1alpha::User.
3528
+ # p result
3529
+ #
3530
+ def create_user request, options = nil
3531
+ raise ::ArgumentError, "request must be provided" if request.nil?
3532
+
3533
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::CreateUserRequest
3534
+
3535
+ # Converts hash and nil to an options object
3536
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3537
+
3538
+ # Customize the options with defaults
3539
+ call_metadata = @config.rpcs.create_user.metadata.to_h
3540
+
3541
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3542
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3543
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3544
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
3545
+ transports_version_send: [:rest]
3546
+
3547
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3548
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3549
+
3550
+ options.apply_defaults timeout: @config.rpcs.create_user.timeout,
3551
+ metadata: call_metadata,
3552
+ retry_policy: @config.rpcs.create_user.retry_policy
3553
+
3554
+ options.apply_defaults timeout: @config.timeout,
3555
+ metadata: @config.metadata,
3556
+ retry_policy: @config.retry_policy
3557
+
3558
+ @alloy_db_admin_stub.create_user request, options do |result, operation|
3559
+ yield result, operation if block_given?
3560
+ return result
3561
+ end
3562
+ rescue ::Gapic::Rest::Error => e
3563
+ raise ::Google::Cloud::Error.from_error(e)
3564
+ end
3565
+
3566
+ ##
3567
+ # Updates the parameters of a single User.
3568
+ #
3569
+ # @overload update_user(request, options = nil)
3570
+ # Pass arguments to `update_user` via a request object, either of type
3571
+ # {::Google::Cloud::AlloyDB::V1alpha::UpdateUserRequest} or an equivalent Hash.
3572
+ #
3573
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::UpdateUserRequest, ::Hash]
3574
+ # A request object representing the call parameters. Required. To specify no
3575
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3576
+ # @param options [::Gapic::CallOptions, ::Hash]
3577
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
3578
+ #
3579
+ # @overload update_user(update_mask: nil, user: nil, request_id: nil, validate_only: nil, allow_missing: nil)
3580
+ # Pass arguments to `update_user` via keyword arguments. Note that at
3581
+ # least one keyword argument is required. To specify no parameters, or to keep all
3582
+ # the default parameter values, pass an empty Hash as a request object (see above).
3583
+ #
3584
+ # @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
3585
+ # Optional. Field mask is used to specify the fields to be overwritten in the
3586
+ # User resource by the update.
3587
+ # The fields specified in the update_mask are relative to the resource, not
3588
+ # the full request. A field will be overwritten if it is in the mask. If the
3589
+ # user does not provide a mask then all fields will be overwritten.
3590
+ # @param user [::Google::Cloud::AlloyDB::V1alpha::User, ::Hash]
3591
+ # Required. The resource being updated
3592
+ # @param request_id [::String]
3593
+ # Optional. An optional request ID to identify requests. Specify a unique
3594
+ # request ID so that if you must retry your request, the server ignores the
3595
+ # request if it has already been completed. The server guarantees that for at
3596
+ # least 60 minutes since the first request.
3597
+ #
3598
+ # For example, consider a situation where you make an initial request and
3599
+ # the request times out. If you make the request again with the same request
3600
+ # ID, the server can check if the original operation with the same request ID
3601
+ # was received, and if so, ignores the second request. This prevents
3602
+ # clients from accidentally creating duplicate commitments.
3603
+ #
3604
+ # The request ID must be a valid UUID with the exception that zero UUID is
3605
+ # not supported (00000000-0000-0000-0000-000000000000).
3606
+ # @param validate_only [::Boolean]
3607
+ # Optional. If set, the backend validates the request, but doesn't actually
3608
+ # execute it.
3609
+ # @param allow_missing [::Boolean]
3610
+ # Optional. Allow missing fields in the update mask.
3611
+ # @yield [result, operation] Access the result along with the TransportOperation object
3612
+ # @yieldparam result [::Google::Cloud::AlloyDB::V1alpha::User]
3613
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
3614
+ #
3615
+ # @return [::Google::Cloud::AlloyDB::V1alpha::User]
3616
+ #
3617
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
3618
+ #
3619
+ # @example Basic example
3620
+ # require "google/cloud/alloy_db/v1alpha"
3621
+ #
3622
+ # # Create a client object. The client can be reused for multiple calls.
3623
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
3624
+ #
3625
+ # # Create a request. To set request fields, pass in keyword arguments.
3626
+ # request = Google::Cloud::AlloyDB::V1alpha::UpdateUserRequest.new
3627
+ #
3628
+ # # Call the update_user method.
3629
+ # result = client.update_user request
3630
+ #
3631
+ # # The returned object is of type Google::Cloud::AlloyDB::V1alpha::User.
3632
+ # p result
3633
+ #
3634
+ def update_user request, options = nil
3635
+ raise ::ArgumentError, "request must be provided" if request.nil?
3636
+
3637
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::UpdateUserRequest
3638
+
3639
+ # Converts hash and nil to an options object
3640
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3641
+
3642
+ # Customize the options with defaults
3643
+ call_metadata = @config.rpcs.update_user.metadata.to_h
3644
+
3645
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3646
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3647
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3648
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
3649
+ transports_version_send: [:rest]
3650
+
3651
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3652
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3653
+
3654
+ options.apply_defaults timeout: @config.rpcs.update_user.timeout,
3655
+ metadata: call_metadata,
3656
+ retry_policy: @config.rpcs.update_user.retry_policy
3657
+
3658
+ options.apply_defaults timeout: @config.timeout,
3659
+ metadata: @config.metadata,
3660
+ retry_policy: @config.retry_policy
3661
+
3662
+ @alloy_db_admin_stub.update_user request, options do |result, operation|
3663
+ yield result, operation if block_given?
3664
+ return result
3665
+ end
3666
+ rescue ::Gapic::Rest::Error => e
3667
+ raise ::Google::Cloud::Error.from_error(e)
3668
+ end
3669
+
3670
+ ##
3671
+ # Deletes a single User.
3672
+ #
3673
+ # @overload delete_user(request, options = nil)
3674
+ # Pass arguments to `delete_user` via a request object, either of type
3675
+ # {::Google::Cloud::AlloyDB::V1alpha::DeleteUserRequest} or an equivalent Hash.
3676
+ #
3677
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::DeleteUserRequest, ::Hash]
3678
+ # A request object representing the call parameters. Required. To specify no
3679
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3680
+ # @param options [::Gapic::CallOptions, ::Hash]
3681
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
3682
+ #
3683
+ # @overload delete_user(name: nil, request_id: nil, validate_only: nil)
3684
+ # Pass arguments to `delete_user` via keyword arguments. Note that at
3685
+ # least one keyword argument is required. To specify no parameters, or to keep all
3686
+ # the default parameter values, pass an empty Hash as a request object (see above).
3687
+ #
3688
+ # @param name [::String]
3689
+ # Required. The name of the resource. For the required format, see the
3690
+ # comment on the User.name field.
3691
+ # @param request_id [::String]
3692
+ # Optional. An optional request ID to identify requests. Specify a unique
3693
+ # request ID so that if you must retry your request, the server ignores the
3694
+ # request if it has already been completed. The server guarantees that for at
3695
+ # least 60 minutes since the first request.
3696
+ #
3697
+ # For example, consider a situation where you make an initial request and
3698
+ # the request times out. If you make the request again with the same request
3699
+ # ID, the server can check if the original operation with the same request ID
3700
+ # was received, and if so, ignores the second request. This prevents
3701
+ # clients from accidentally creating duplicate commitments.
3702
+ #
3703
+ # The request ID must be a valid UUID with the exception that zero UUID is
3704
+ # not supported (00000000-0000-0000-0000-000000000000).
3705
+ # @param validate_only [::Boolean]
3706
+ # Optional. If set, the backend validates the request, but doesn't actually
3707
+ # execute it.
3708
+ # @yield [result, operation] Access the result along with the TransportOperation object
3709
+ # @yieldparam result [::Google::Protobuf::Empty]
3710
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
3711
+ #
3712
+ # @return [::Google::Protobuf::Empty]
3713
+ #
3714
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
3715
+ #
3716
+ # @example Basic example
3717
+ # require "google/cloud/alloy_db/v1alpha"
3718
+ #
3719
+ # # Create a client object. The client can be reused for multiple calls.
3720
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
3721
+ #
3722
+ # # Create a request. To set request fields, pass in keyword arguments.
3723
+ # request = Google::Cloud::AlloyDB::V1alpha::DeleteUserRequest.new
3724
+ #
3725
+ # # Call the delete_user method.
3726
+ # result = client.delete_user request
3727
+ #
3728
+ # # The returned object is of type Google::Protobuf::Empty.
3729
+ # p result
3730
+ #
3731
+ def delete_user request, options = nil
3732
+ raise ::ArgumentError, "request must be provided" if request.nil?
3733
+
3734
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::DeleteUserRequest
3735
+
3736
+ # Converts hash and nil to an options object
3737
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3738
+
3739
+ # Customize the options with defaults
3740
+ call_metadata = @config.rpcs.delete_user.metadata.to_h
3741
+
3742
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3743
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3744
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3745
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
3746
+ transports_version_send: [:rest]
3747
+
3748
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3749
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3750
+
3751
+ options.apply_defaults timeout: @config.rpcs.delete_user.timeout,
3752
+ metadata: call_metadata,
3753
+ retry_policy: @config.rpcs.delete_user.retry_policy
3754
+
3755
+ options.apply_defaults timeout: @config.timeout,
3756
+ metadata: @config.metadata,
3757
+ retry_policy: @config.retry_policy
3758
+
3759
+ @alloy_db_admin_stub.delete_user request, options do |result, operation|
3760
+ yield result, operation if block_given?
3761
+ return result
3762
+ end
3763
+ rescue ::Gapic::Rest::Error => e
3764
+ raise ::Google::Cloud::Error.from_error(e)
3765
+ end
3766
+
3767
+ ##
3768
+ # Lists Databases in a given project and location.
3769
+ #
3770
+ # @overload list_databases(request, options = nil)
3771
+ # Pass arguments to `list_databases` via a request object, either of type
3772
+ # {::Google::Cloud::AlloyDB::V1alpha::ListDatabasesRequest} or an equivalent Hash.
3773
+ #
3774
+ # @param request [::Google::Cloud::AlloyDB::V1alpha::ListDatabasesRequest, ::Hash]
3775
+ # A request object representing the call parameters. Required. To specify no
3776
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
3777
+ # @param options [::Gapic::CallOptions, ::Hash]
3778
+ # Overrides the default settings for this call, e.g, timeout, retries etc. Optional.
3779
+ #
3780
+ # @overload list_databases(parent: nil, page_size: nil, page_token: nil, filter: nil)
3781
+ # Pass arguments to `list_databases` via keyword arguments. Note that at
3782
+ # least one keyword argument is required. To specify no parameters, or to keep all
3783
+ # the default parameter values, pass an empty Hash as a request object (see above).
3784
+ #
3785
+ # @param parent [::String]
3786
+ # Required. Parent value for ListDatabasesRequest.
3787
+ # @param page_size [::Integer]
3788
+ # Optional. The maximum number of databases to return. The service may return
3789
+ # fewer than this value. If unspecified, 2000 is the default page_size. The
3790
+ # max value of page_size will be 4000, values above max will be coerced to
3791
+ # max.
3792
+ # @param page_token [::String]
3793
+ # Optional. A page token, received from a previous `ListDatabases` call.
3794
+ # This should be provided to retrieve the subsequent page.
3795
+ # This field is currently not supported, its value will be ignored if passed.
3796
+ # @param filter [::String]
3797
+ # Optional. Filtering results.
3798
+ # This field is currently not supported, its value will be ignored if passed.
3799
+ # @yield [result, operation] Access the result along with the TransportOperation object
3800
+ # @yieldparam result [::Gapic::Rest::PagedEnumerable<::Google::Cloud::AlloyDB::V1alpha::Database>]
3801
+ # @yieldparam operation [::Gapic::Rest::TransportOperation]
3802
+ #
3803
+ # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::AlloyDB::V1alpha::Database>]
3804
+ #
3805
+ # @raise [::Google::Cloud::Error] if the REST call is aborted.
3806
+ #
3807
+ # @example Basic example
3808
+ # require "google/cloud/alloy_db/v1alpha"
3809
+ #
3810
+ # # Create a client object. The client can be reused for multiple calls.
3811
+ # client = Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new
3812
+ #
3813
+ # # Create a request. To set request fields, pass in keyword arguments.
3814
+ # request = Google::Cloud::AlloyDB::V1alpha::ListDatabasesRequest.new
3815
+ #
3816
+ # # Call the list_databases method.
3817
+ # result = client.list_databases request
3818
+ #
3819
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
3820
+ # # over elements, and API calls will be issued to fetch pages as needed.
3821
+ # result.each do |item|
3822
+ # # Each element is of type ::Google::Cloud::AlloyDB::V1alpha::Database.
3823
+ # p item
3824
+ # end
3825
+ #
3826
+ def list_databases request, options = nil
3827
+ raise ::ArgumentError, "request must be provided" if request.nil?
3828
+
3829
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::AlloyDB::V1alpha::ListDatabasesRequest
3830
+
3831
+ # Converts hash and nil to an options object
3832
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
3833
+
3834
+ # Customize the options with defaults
3835
+ call_metadata = @config.rpcs.list_databases.metadata.to_h
3836
+
3837
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
3838
+ call_metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
3839
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
3840
+ gapic_version: ::Google::Cloud::AlloyDB::V1alpha::VERSION,
3841
+ transports_version_send: [:rest]
3842
+
3843
+ call_metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
3844
+ call_metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
3845
+
3846
+ options.apply_defaults timeout: @config.rpcs.list_databases.timeout,
3847
+ metadata: call_metadata,
3848
+ retry_policy: @config.rpcs.list_databases.retry_policy
3849
+
3850
+ options.apply_defaults timeout: @config.timeout,
3851
+ metadata: @config.metadata,
3852
+ retry_policy: @config.retry_policy
3853
+
3854
+ @alloy_db_admin_stub.list_databases request, options do |result, operation|
3855
+ result = ::Gapic::Rest::PagedEnumerable.new @alloy_db_admin_stub, :list_databases, "databases", request, result, options
3856
+ yield result, operation if block_given?
3857
+ return result
3858
+ end
3859
+ rescue ::Gapic::Rest::Error => e
3860
+ raise ::Google::Cloud::Error.from_error(e)
3861
+ end
3862
+
3863
+ ##
3864
+ # Configuration class for the AlloyDBAdmin REST API.
3865
+ #
3866
+ # This class represents the configuration for AlloyDBAdmin REST,
3867
+ # providing control over timeouts, retry behavior, logging, transport
3868
+ # parameters, and other low-level controls. Certain parameters can also be
3869
+ # applied individually to specific RPCs. See
3870
+ # {::Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client::Configuration::Rpcs}
3871
+ # for a list of RPCs that can be configured independently.
3872
+ #
3873
+ # Configuration can be applied globally to all clients, or to a single client
3874
+ # on construction.
3875
+ #
3876
+ # @example
3877
+ #
3878
+ # # Modify the global config, setting the timeout for
3879
+ # # list_clusters to 20 seconds,
3880
+ # # and all remaining timeouts to 10 seconds.
3881
+ # ::Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.configure do |config|
3882
+ # config.timeout = 10.0
3883
+ # config.rpcs.list_clusters.timeout = 20.0
3884
+ # end
3885
+ #
3886
+ # # Apply the above configuration only to a new client.
3887
+ # client = ::Google::Cloud::AlloyDB::V1alpha::AlloyDBAdmin::Rest::Client.new do |config|
3888
+ # config.timeout = 10.0
3889
+ # config.rpcs.list_clusters.timeout = 20.0
3890
+ # end
3891
+ #
3892
+ # @!attribute [rw] endpoint
3893
+ # A custom service endpoint, as a hostname or hostname:port. The default is
3894
+ # nil, indicating to use the default endpoint in the current universe domain.
3895
+ # @return [::String,nil]
3896
+ # @!attribute [rw] credentials
3897
+ # Credentials to send with calls. You may provide any of the following types:
3898
+ # * (`String`) The path to a service account key file in JSON format
3899
+ # * (`Hash`) A service account key as a Hash
3900
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
3901
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
3902
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
3903
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
3904
+ # * (`nil`) indicating no credentials
3905
+ # @return [::Object]
3906
+ # @!attribute [rw] scope
3907
+ # The OAuth scopes
3908
+ # @return [::Array<::String>]
3909
+ # @!attribute [rw] lib_name
3910
+ # The library name as recorded in instrumentation and logging
3911
+ # @return [::String]
3912
+ # @!attribute [rw] lib_version
3913
+ # The library version as recorded in instrumentation and logging
3914
+ # @return [::String]
3915
+ # @!attribute [rw] timeout
3916
+ # The call timeout in seconds.
3917
+ # @return [::Numeric]
3918
+ # @!attribute [rw] metadata
3919
+ # Additional headers to be sent with the call.
3920
+ # @return [::Hash{::Symbol=>::String}]
3921
+ # @!attribute [rw] retry_policy
3922
+ # The retry policy. The value is a hash with the following keys:
3923
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
3924
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
3925
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
3926
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
3927
+ # trigger a retry.
3928
+ # @return [::Hash]
3929
+ # @!attribute [rw] quota_project
3930
+ # A separate project against which to charge quota.
3931
+ # @return [::String]
3932
+ # @!attribute [rw] universe_domain
3933
+ # The universe domain within which to make requests. This determines the
3934
+ # default endpoint URL. The default value of nil uses the environment
3935
+ # universe (usually the default "googleapis.com" universe).
3936
+ # @return [::String,nil]
3937
+ #
3938
+ class Configuration
3939
+ extend ::Gapic::Config
3940
+
3941
+ # @private
3942
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
3943
+ DEFAULT_ENDPOINT = "alloydb.googleapis.com"
3944
+
3945
+ config_attr :endpoint, nil, ::String, nil
3946
+ config_attr :credentials, nil do |value|
3947
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Signet::OAuth2::Client, nil]
3948
+ allowed.any? { |klass| klass === value }
3949
+ end
3950
+ config_attr :scope, nil, ::String, ::Array, nil
3951
+ config_attr :lib_name, nil, ::String, nil
3952
+ config_attr :lib_version, nil, ::String, nil
3953
+ config_attr :timeout, nil, ::Numeric, nil
3954
+ config_attr :metadata, nil, ::Hash, nil
3955
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
3956
+ config_attr :quota_project, nil, ::String, nil
3957
+ config_attr :universe_domain, nil, ::String, nil
3958
+
3959
+ # @private
3960
+ # Overrides for http bindings for the RPCs of this service
3961
+ # are only used when this service is used as mixin, and only
3962
+ # by the host service.
3963
+ # @return [::Hash{::Symbol=>::Array<::Gapic::Rest::GrpcTranscoder::HttpBinding>}]
3964
+ config_attr :bindings_override, {}, ::Hash, nil
3965
+
3966
+ # @private
3967
+ def initialize parent_config = nil
3968
+ @parent_config = parent_config unless parent_config.nil?
3969
+
3970
+ yield self if block_given?
3971
+ end
3972
+
3973
+ ##
3974
+ # Configurations for individual RPCs
3975
+ # @return [Rpcs]
3976
+ #
3977
+ def rpcs
3978
+ @rpcs ||= begin
3979
+ parent_rpcs = nil
3980
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
3981
+ Rpcs.new parent_rpcs
3982
+ end
3983
+ end
3984
+
3985
+ ##
3986
+ # Configuration RPC class for the AlloyDBAdmin API.
3987
+ #
3988
+ # Includes fields providing the configuration for each RPC in this service.
3989
+ # Each configuration object is of type `Gapic::Config::Method` and includes
3990
+ # the following configuration fields:
3991
+ #
3992
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
3993
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional headers
3994
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
3995
+ # include the following keys:
3996
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
3997
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
3998
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
3999
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
4000
+ # trigger a retry.
4001
+ #
4002
+ class Rpcs
4003
+ ##
4004
+ # RPC-specific configuration for `list_clusters`
4005
+ # @return [::Gapic::Config::Method]
4006
+ #
4007
+ attr_reader :list_clusters
4008
+ ##
4009
+ # RPC-specific configuration for `get_cluster`
4010
+ # @return [::Gapic::Config::Method]
4011
+ #
4012
+ attr_reader :get_cluster
4013
+ ##
4014
+ # RPC-specific configuration for `create_cluster`
4015
+ # @return [::Gapic::Config::Method]
4016
+ #
4017
+ attr_reader :create_cluster
4018
+ ##
4019
+ # RPC-specific configuration for `update_cluster`
4020
+ # @return [::Gapic::Config::Method]
4021
+ #
4022
+ attr_reader :update_cluster
4023
+ ##
4024
+ # RPC-specific configuration for `upgrade_cluster`
4025
+ # @return [::Gapic::Config::Method]
4026
+ #
4027
+ attr_reader :upgrade_cluster
4028
+ ##
4029
+ # RPC-specific configuration for `delete_cluster`
4030
+ # @return [::Gapic::Config::Method]
4031
+ #
4032
+ attr_reader :delete_cluster
4033
+ ##
4034
+ # RPC-specific configuration for `promote_cluster`
4035
+ # @return [::Gapic::Config::Method]
4036
+ #
4037
+ attr_reader :promote_cluster
4038
+ ##
4039
+ # RPC-specific configuration for `switchover_cluster`
4040
+ # @return [::Gapic::Config::Method]
4041
+ #
4042
+ attr_reader :switchover_cluster
4043
+ ##
4044
+ # RPC-specific configuration for `restore_cluster`
4045
+ # @return [::Gapic::Config::Method]
4046
+ #
4047
+ attr_reader :restore_cluster
4048
+ ##
4049
+ # RPC-specific configuration for `create_secondary_cluster`
4050
+ # @return [::Gapic::Config::Method]
4051
+ #
4052
+ attr_reader :create_secondary_cluster
4053
+ ##
4054
+ # RPC-specific configuration for `list_instances`
4055
+ # @return [::Gapic::Config::Method]
4056
+ #
4057
+ attr_reader :list_instances
4058
+ ##
4059
+ # RPC-specific configuration for `get_instance`
4060
+ # @return [::Gapic::Config::Method]
4061
+ #
4062
+ attr_reader :get_instance
4063
+ ##
4064
+ # RPC-specific configuration for `create_instance`
4065
+ # @return [::Gapic::Config::Method]
4066
+ #
4067
+ attr_reader :create_instance
4068
+ ##
4069
+ # RPC-specific configuration for `create_secondary_instance`
4070
+ # @return [::Gapic::Config::Method]
4071
+ #
4072
+ attr_reader :create_secondary_instance
4073
+ ##
4074
+ # RPC-specific configuration for `batch_create_instances`
4075
+ # @return [::Gapic::Config::Method]
4076
+ #
4077
+ attr_reader :batch_create_instances
4078
+ ##
4079
+ # RPC-specific configuration for `update_instance`
4080
+ # @return [::Gapic::Config::Method]
4081
+ #
4082
+ attr_reader :update_instance
4083
+ ##
4084
+ # RPC-specific configuration for `delete_instance`
4085
+ # @return [::Gapic::Config::Method]
4086
+ #
4087
+ attr_reader :delete_instance
4088
+ ##
4089
+ # RPC-specific configuration for `failover_instance`
4090
+ # @return [::Gapic::Config::Method]
4091
+ #
4092
+ attr_reader :failover_instance
4093
+ ##
4094
+ # RPC-specific configuration for `inject_fault`
4095
+ # @return [::Gapic::Config::Method]
4096
+ #
4097
+ attr_reader :inject_fault
4098
+ ##
4099
+ # RPC-specific configuration for `restart_instance`
4100
+ # @return [::Gapic::Config::Method]
4101
+ #
4102
+ attr_reader :restart_instance
4103
+ ##
4104
+ # RPC-specific configuration for `execute_sql`
4105
+ # @return [::Gapic::Config::Method]
4106
+ #
4107
+ attr_reader :execute_sql
4108
+ ##
4109
+ # RPC-specific configuration for `list_backups`
4110
+ # @return [::Gapic::Config::Method]
4111
+ #
4112
+ attr_reader :list_backups
4113
+ ##
4114
+ # RPC-specific configuration for `get_backup`
4115
+ # @return [::Gapic::Config::Method]
4116
+ #
4117
+ attr_reader :get_backup
4118
+ ##
4119
+ # RPC-specific configuration for `create_backup`
4120
+ # @return [::Gapic::Config::Method]
4121
+ #
4122
+ attr_reader :create_backup
4123
+ ##
4124
+ # RPC-specific configuration for `update_backup`
4125
+ # @return [::Gapic::Config::Method]
4126
+ #
4127
+ attr_reader :update_backup
4128
+ ##
4129
+ # RPC-specific configuration for `delete_backup`
4130
+ # @return [::Gapic::Config::Method]
4131
+ #
4132
+ attr_reader :delete_backup
4133
+ ##
4134
+ # RPC-specific configuration for `list_supported_database_flags`
4135
+ # @return [::Gapic::Config::Method]
4136
+ #
4137
+ attr_reader :list_supported_database_flags
4138
+ ##
4139
+ # RPC-specific configuration for `generate_client_certificate`
4140
+ # @return [::Gapic::Config::Method]
4141
+ #
4142
+ attr_reader :generate_client_certificate
4143
+ ##
4144
+ # RPC-specific configuration for `get_connection_info`
4145
+ # @return [::Gapic::Config::Method]
4146
+ #
4147
+ attr_reader :get_connection_info
4148
+ ##
4149
+ # RPC-specific configuration for `list_users`
4150
+ # @return [::Gapic::Config::Method]
4151
+ #
4152
+ attr_reader :list_users
4153
+ ##
4154
+ # RPC-specific configuration for `get_user`
4155
+ # @return [::Gapic::Config::Method]
4156
+ #
4157
+ attr_reader :get_user
4158
+ ##
4159
+ # RPC-specific configuration for `create_user`
4160
+ # @return [::Gapic::Config::Method]
4161
+ #
4162
+ attr_reader :create_user
4163
+ ##
4164
+ # RPC-specific configuration for `update_user`
4165
+ # @return [::Gapic::Config::Method]
4166
+ #
4167
+ attr_reader :update_user
4168
+ ##
4169
+ # RPC-specific configuration for `delete_user`
4170
+ # @return [::Gapic::Config::Method]
4171
+ #
4172
+ attr_reader :delete_user
4173
+ ##
4174
+ # RPC-specific configuration for `list_databases`
4175
+ # @return [::Gapic::Config::Method]
4176
+ #
4177
+ attr_reader :list_databases
4178
+
4179
+ # @private
4180
+ def initialize parent_rpcs = nil
4181
+ list_clusters_config = parent_rpcs.list_clusters if parent_rpcs.respond_to? :list_clusters
4182
+ @list_clusters = ::Gapic::Config::Method.new list_clusters_config
4183
+ get_cluster_config = parent_rpcs.get_cluster if parent_rpcs.respond_to? :get_cluster
4184
+ @get_cluster = ::Gapic::Config::Method.new get_cluster_config
4185
+ create_cluster_config = parent_rpcs.create_cluster if parent_rpcs.respond_to? :create_cluster
4186
+ @create_cluster = ::Gapic::Config::Method.new create_cluster_config
4187
+ update_cluster_config = parent_rpcs.update_cluster if parent_rpcs.respond_to? :update_cluster
4188
+ @update_cluster = ::Gapic::Config::Method.new update_cluster_config
4189
+ upgrade_cluster_config = parent_rpcs.upgrade_cluster if parent_rpcs.respond_to? :upgrade_cluster
4190
+ @upgrade_cluster = ::Gapic::Config::Method.new upgrade_cluster_config
4191
+ delete_cluster_config = parent_rpcs.delete_cluster if parent_rpcs.respond_to? :delete_cluster
4192
+ @delete_cluster = ::Gapic::Config::Method.new delete_cluster_config
4193
+ promote_cluster_config = parent_rpcs.promote_cluster if parent_rpcs.respond_to? :promote_cluster
4194
+ @promote_cluster = ::Gapic::Config::Method.new promote_cluster_config
4195
+ switchover_cluster_config = parent_rpcs.switchover_cluster if parent_rpcs.respond_to? :switchover_cluster
4196
+ @switchover_cluster = ::Gapic::Config::Method.new switchover_cluster_config
4197
+ restore_cluster_config = parent_rpcs.restore_cluster if parent_rpcs.respond_to? :restore_cluster
4198
+ @restore_cluster = ::Gapic::Config::Method.new restore_cluster_config
4199
+ create_secondary_cluster_config = parent_rpcs.create_secondary_cluster if parent_rpcs.respond_to? :create_secondary_cluster
4200
+ @create_secondary_cluster = ::Gapic::Config::Method.new create_secondary_cluster_config
4201
+ list_instances_config = parent_rpcs.list_instances if parent_rpcs.respond_to? :list_instances
4202
+ @list_instances = ::Gapic::Config::Method.new list_instances_config
4203
+ get_instance_config = parent_rpcs.get_instance if parent_rpcs.respond_to? :get_instance
4204
+ @get_instance = ::Gapic::Config::Method.new get_instance_config
4205
+ create_instance_config = parent_rpcs.create_instance if parent_rpcs.respond_to? :create_instance
4206
+ @create_instance = ::Gapic::Config::Method.new create_instance_config
4207
+ create_secondary_instance_config = parent_rpcs.create_secondary_instance if parent_rpcs.respond_to? :create_secondary_instance
4208
+ @create_secondary_instance = ::Gapic::Config::Method.new create_secondary_instance_config
4209
+ batch_create_instances_config = parent_rpcs.batch_create_instances if parent_rpcs.respond_to? :batch_create_instances
4210
+ @batch_create_instances = ::Gapic::Config::Method.new batch_create_instances_config
4211
+ update_instance_config = parent_rpcs.update_instance if parent_rpcs.respond_to? :update_instance
4212
+ @update_instance = ::Gapic::Config::Method.new update_instance_config
4213
+ delete_instance_config = parent_rpcs.delete_instance if parent_rpcs.respond_to? :delete_instance
4214
+ @delete_instance = ::Gapic::Config::Method.new delete_instance_config
4215
+ failover_instance_config = parent_rpcs.failover_instance if parent_rpcs.respond_to? :failover_instance
4216
+ @failover_instance = ::Gapic::Config::Method.new failover_instance_config
4217
+ inject_fault_config = parent_rpcs.inject_fault if parent_rpcs.respond_to? :inject_fault
4218
+ @inject_fault = ::Gapic::Config::Method.new inject_fault_config
4219
+ restart_instance_config = parent_rpcs.restart_instance if parent_rpcs.respond_to? :restart_instance
4220
+ @restart_instance = ::Gapic::Config::Method.new restart_instance_config
4221
+ execute_sql_config = parent_rpcs.execute_sql if parent_rpcs.respond_to? :execute_sql
4222
+ @execute_sql = ::Gapic::Config::Method.new execute_sql_config
4223
+ list_backups_config = parent_rpcs.list_backups if parent_rpcs.respond_to? :list_backups
4224
+ @list_backups = ::Gapic::Config::Method.new list_backups_config
4225
+ get_backup_config = parent_rpcs.get_backup if parent_rpcs.respond_to? :get_backup
4226
+ @get_backup = ::Gapic::Config::Method.new get_backup_config
4227
+ create_backup_config = parent_rpcs.create_backup if parent_rpcs.respond_to? :create_backup
4228
+ @create_backup = ::Gapic::Config::Method.new create_backup_config
4229
+ update_backup_config = parent_rpcs.update_backup if parent_rpcs.respond_to? :update_backup
4230
+ @update_backup = ::Gapic::Config::Method.new update_backup_config
4231
+ delete_backup_config = parent_rpcs.delete_backup if parent_rpcs.respond_to? :delete_backup
4232
+ @delete_backup = ::Gapic::Config::Method.new delete_backup_config
4233
+ list_supported_database_flags_config = parent_rpcs.list_supported_database_flags if parent_rpcs.respond_to? :list_supported_database_flags
4234
+ @list_supported_database_flags = ::Gapic::Config::Method.new list_supported_database_flags_config
4235
+ generate_client_certificate_config = parent_rpcs.generate_client_certificate if parent_rpcs.respond_to? :generate_client_certificate
4236
+ @generate_client_certificate = ::Gapic::Config::Method.new generate_client_certificate_config
4237
+ get_connection_info_config = parent_rpcs.get_connection_info if parent_rpcs.respond_to? :get_connection_info
4238
+ @get_connection_info = ::Gapic::Config::Method.new get_connection_info_config
4239
+ list_users_config = parent_rpcs.list_users if parent_rpcs.respond_to? :list_users
4240
+ @list_users = ::Gapic::Config::Method.new list_users_config
4241
+ get_user_config = parent_rpcs.get_user if parent_rpcs.respond_to? :get_user
4242
+ @get_user = ::Gapic::Config::Method.new get_user_config
4243
+ create_user_config = parent_rpcs.create_user if parent_rpcs.respond_to? :create_user
4244
+ @create_user = ::Gapic::Config::Method.new create_user_config
4245
+ update_user_config = parent_rpcs.update_user if parent_rpcs.respond_to? :update_user
4246
+ @update_user = ::Gapic::Config::Method.new update_user_config
4247
+ delete_user_config = parent_rpcs.delete_user if parent_rpcs.respond_to? :delete_user
4248
+ @delete_user = ::Gapic::Config::Method.new delete_user_config
4249
+ list_databases_config = parent_rpcs.list_databases if parent_rpcs.respond_to? :list_databases
4250
+ @list_databases = ::Gapic::Config::Method.new list_databases_config
4251
+
4252
+ yield self if block_given?
4253
+ end
4254
+ end
4255
+ end
4256
+ end
4257
+ end
4258
+ end
4259
+ end
4260
+ end
4261
+ end
4262
+ end