google-cloud-oracle_database-v1 0.6.0 → 0.7.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,3132 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Copyright 2025 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/oracledatabase/v1/oracledatabase_pb"
21
+ require "google/cloud/location"
22
+
23
+ module Google
24
+ module Cloud
25
+ module OracleDatabase
26
+ module V1
27
+ module OracleDatabase
28
+ ##
29
+ # Client for the OracleDatabase service.
30
+ #
31
+ # Service describing handlers for resources
32
+ #
33
+ class Client
34
+ # @private
35
+ API_VERSION = ""
36
+
37
+ # @private
38
+ DEFAULT_ENDPOINT_TEMPLATE = "oracledatabase.$UNIVERSE_DOMAIN$"
39
+
40
+ include Paths
41
+
42
+ # @private
43
+ attr_reader :oracle_database_stub
44
+
45
+ ##
46
+ # Configure the OracleDatabase Client class.
47
+ #
48
+ # See {::Google::Cloud::OracleDatabase::V1::OracleDatabase::Client::Configuration}
49
+ # for a description of the configuration fields.
50
+ #
51
+ # @example
52
+ #
53
+ # # Modify the configuration for all OracleDatabase clients
54
+ # ::Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.configure do |config|
55
+ # config.timeout = 10.0
56
+ # end
57
+ #
58
+ # @yield [config] Configure the Client client.
59
+ # @yieldparam config [Client::Configuration]
60
+ #
61
+ # @return [Client::Configuration]
62
+ #
63
+ def self.configure
64
+ @configure ||= begin
65
+ namespace = ["Google", "Cloud", "OracleDatabase", "V1"]
66
+ parent_config = while namespace.any?
67
+ parent_name = namespace.join "::"
68
+ parent_const = const_get parent_name
69
+ break parent_const.configure if parent_const.respond_to? :configure
70
+ namespace.pop
71
+ end
72
+ default_config = Client::Configuration.new parent_config
73
+
74
+ default_config.timeout = 60.0
75
+
76
+ default_config.rpcs.list_cloud_exadata_infrastructures.timeout = 60.0
77
+ default_config.rpcs.list_cloud_exadata_infrastructures.retry_policy = {
78
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
79
+ }
80
+
81
+ default_config.rpcs.get_cloud_exadata_infrastructure.timeout = 60.0
82
+ default_config.rpcs.get_cloud_exadata_infrastructure.retry_policy = {
83
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
84
+ }
85
+
86
+ default_config.rpcs.list_cloud_vm_clusters.timeout = 60.0
87
+ default_config.rpcs.list_cloud_vm_clusters.retry_policy = {
88
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
89
+ }
90
+
91
+ default_config.rpcs.get_cloud_vm_cluster.timeout = 60.0
92
+ default_config.rpcs.get_cloud_vm_cluster.retry_policy = {
93
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
94
+ }
95
+
96
+ default_config.rpcs.list_entitlements.timeout = 60.0
97
+ default_config.rpcs.list_entitlements.retry_policy = {
98
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
99
+ }
100
+
101
+ default_config.rpcs.list_db_servers.timeout = 60.0
102
+ default_config.rpcs.list_db_servers.retry_policy = {
103
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
104
+ }
105
+
106
+ default_config.rpcs.list_db_nodes.timeout = 60.0
107
+ default_config.rpcs.list_db_nodes.retry_policy = {
108
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
109
+ }
110
+
111
+ default_config.rpcs.list_gi_versions.timeout = 60.0
112
+ default_config.rpcs.list_gi_versions.retry_policy = {
113
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
114
+ }
115
+
116
+ default_config.rpcs.list_db_system_shapes.timeout = 60.0
117
+ default_config.rpcs.list_db_system_shapes.retry_policy = {
118
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
119
+ }
120
+
121
+ default_config.rpcs.list_autonomous_databases.timeout = 60.0
122
+ default_config.rpcs.list_autonomous_databases.retry_policy = {
123
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
124
+ }
125
+
126
+ default_config.rpcs.get_autonomous_database.timeout = 60.0
127
+ default_config.rpcs.get_autonomous_database.retry_policy = {
128
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
129
+ }
130
+
131
+ default_config.rpcs.list_autonomous_db_versions.timeout = 60.0
132
+ default_config.rpcs.list_autonomous_db_versions.retry_policy = {
133
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
134
+ }
135
+
136
+ default_config.rpcs.list_autonomous_database_character_sets.timeout = 60.0
137
+ default_config.rpcs.list_autonomous_database_character_sets.retry_policy = {
138
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
139
+ }
140
+
141
+ default_config.rpcs.list_autonomous_database_backups.timeout = 60.0
142
+ default_config.rpcs.list_autonomous_database_backups.retry_policy = {
143
+ initial_delay: 1.0, max_delay: 10.0, multiplier: 1.3, retry_codes: [8, 14, 13, 4]
144
+ }
145
+
146
+ default_config
147
+ end
148
+ yield @configure if block_given?
149
+ @configure
150
+ end
151
+
152
+ ##
153
+ # Configure the OracleDatabase Client instance.
154
+ #
155
+ # The configuration is set to the derived mode, meaning that values can be changed,
156
+ # but structural changes (adding new fields, etc.) are not allowed. Structural changes
157
+ # should be made on {Client.configure}.
158
+ #
159
+ # See {::Google::Cloud::OracleDatabase::V1::OracleDatabase::Client::Configuration}
160
+ # for a description of the configuration fields.
161
+ #
162
+ # @yield [config] Configure the Client client.
163
+ # @yieldparam config [Client::Configuration]
164
+ #
165
+ # @return [Client::Configuration]
166
+ #
167
+ def configure
168
+ yield @config if block_given?
169
+ @config
170
+ end
171
+
172
+ ##
173
+ # The effective universe domain
174
+ #
175
+ # @return [String]
176
+ #
177
+ def universe_domain
178
+ @oracle_database_stub.universe_domain
179
+ end
180
+
181
+ ##
182
+ # Create a new OracleDatabase client object.
183
+ #
184
+ # @example
185
+ #
186
+ # # Create a client using the default configuration
187
+ # client = ::Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
188
+ #
189
+ # # Create a client using a custom configuration
190
+ # client = ::Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new do |config|
191
+ # config.timeout = 10.0
192
+ # end
193
+ #
194
+ # @yield [config] Configure the OracleDatabase client.
195
+ # @yieldparam config [Client::Configuration]
196
+ #
197
+ def initialize
198
+ # These require statements are intentionally placed here to initialize
199
+ # the gRPC module only when it's required.
200
+ # See https://github.com/googleapis/toolkit/issues/446
201
+ require "gapic/grpc"
202
+ require "google/cloud/oracledatabase/v1/oracledatabase_services_pb"
203
+
204
+ # Create the configuration object
205
+ @config = Configuration.new Client.configure
206
+
207
+ # Yield the configuration if needed
208
+ yield @config if block_given?
209
+
210
+ # Create credentials
211
+ credentials = @config.credentials
212
+ # Use self-signed JWT if the endpoint is unchanged from default,
213
+ # but only if the default endpoint does not have a region prefix.
214
+ enable_self_signed_jwt = @config.endpoint.nil? ||
215
+ (@config.endpoint == Configuration::DEFAULT_ENDPOINT &&
216
+ !@config.endpoint.split(".").first.include?("-"))
217
+ credentials ||= Credentials.default scope: @config.scope,
218
+ enable_self_signed_jwt: enable_self_signed_jwt
219
+ if credentials.is_a?(::String) || credentials.is_a?(::Hash)
220
+ credentials = Credentials.new credentials, scope: @config.scope
221
+ end
222
+ @quota_project_id = @config.quota_project
223
+ @quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
224
+
225
+ @operations_client = Operations.new do |config|
226
+ config.credentials = credentials
227
+ config.quota_project = @quota_project_id
228
+ config.endpoint = @config.endpoint
229
+ config.universe_domain = @config.universe_domain
230
+ end
231
+
232
+ @oracle_database_stub = ::Gapic::ServiceStub.new(
233
+ ::Google::Cloud::OracleDatabase::V1::OracleDatabase::Stub,
234
+ credentials: credentials,
235
+ endpoint: @config.endpoint,
236
+ endpoint_template: DEFAULT_ENDPOINT_TEMPLATE,
237
+ universe_domain: @config.universe_domain,
238
+ channel_args: @config.channel_args,
239
+ interceptors: @config.interceptors,
240
+ channel_pool_config: @config.channel_pool,
241
+ logger: @config.logger
242
+ )
243
+
244
+ @oracle_database_stub.stub_logger&.info do |entry|
245
+ entry.set_system_name
246
+ entry.set_service
247
+ entry.message = "Created client for #{entry.service}"
248
+ entry.set_credentials_fields credentials
249
+ entry.set "customEndpoint", @config.endpoint if @config.endpoint
250
+ entry.set "defaultTimeout", @config.timeout if @config.timeout
251
+ entry.set "quotaProject", @quota_project_id if @quota_project_id
252
+ end
253
+
254
+ @location_client = Google::Cloud::Location::Locations::Client.new do |config|
255
+ config.credentials = credentials
256
+ config.quota_project = @quota_project_id
257
+ config.endpoint = @oracle_database_stub.endpoint
258
+ config.universe_domain = @oracle_database_stub.universe_domain
259
+ config.logger = @oracle_database_stub.logger if config.respond_to? :logger=
260
+ end
261
+ end
262
+
263
+ ##
264
+ # Get the associated client for long-running operations.
265
+ #
266
+ # @return [::Google::Cloud::OracleDatabase::V1::OracleDatabase::Operations]
267
+ #
268
+ attr_reader :operations_client
269
+
270
+ ##
271
+ # Get the associated client for mix-in of the Locations.
272
+ #
273
+ # @return [Google::Cloud::Location::Locations::Client]
274
+ #
275
+ attr_reader :location_client
276
+
277
+ ##
278
+ # The logger used for request/response debug logging.
279
+ #
280
+ # @return [Logger]
281
+ #
282
+ def logger
283
+ @oracle_database_stub.logger
284
+ end
285
+
286
+ # Service calls
287
+
288
+ ##
289
+ # Lists Exadata Infrastructures in a given project and location.
290
+ #
291
+ # @overload list_cloud_exadata_infrastructures(request, options = nil)
292
+ # Pass arguments to `list_cloud_exadata_infrastructures` via a request object, either of type
293
+ # {::Google::Cloud::OracleDatabase::V1::ListCloudExadataInfrastructuresRequest} or an equivalent Hash.
294
+ #
295
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListCloudExadataInfrastructuresRequest, ::Hash]
296
+ # A request object representing the call parameters. Required. To specify no
297
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
298
+ # @param options [::Gapic::CallOptions, ::Hash]
299
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
300
+ #
301
+ # @overload list_cloud_exadata_infrastructures(parent: nil, page_size: nil, page_token: nil)
302
+ # Pass arguments to `list_cloud_exadata_infrastructures` via keyword arguments. Note that at
303
+ # least one keyword argument is required. To specify no parameters, or to keep all
304
+ # the default parameter values, pass an empty Hash as a request object (see above).
305
+ #
306
+ # @param parent [::String]
307
+ # Required. The parent value for CloudExadataInfrastructure in the following
308
+ # format: projects/\\{project}/locations/\\{location}.
309
+ # @param page_size [::Integer]
310
+ # Optional. The maximum number of items to return.
311
+ # If unspecified, at most 50 Exadata infrastructures will be returned.
312
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
313
+ # @param page_token [::String]
314
+ # Optional. A token identifying a page of results the server should return.
315
+ #
316
+ # @yield [response, operation] Access the result along with the RPC operation
317
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::CloudExadataInfrastructure>]
318
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
319
+ #
320
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::CloudExadataInfrastructure>]
321
+ #
322
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
323
+ #
324
+ # @example Basic example
325
+ # require "google/cloud/oracle_database/v1"
326
+ #
327
+ # # Create a client object. The client can be reused for multiple calls.
328
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
329
+ #
330
+ # # Create a request. To set request fields, pass in keyword arguments.
331
+ # request = Google::Cloud::OracleDatabase::V1::ListCloudExadataInfrastructuresRequest.new
332
+ #
333
+ # # Call the list_cloud_exadata_infrastructures method.
334
+ # result = client.list_cloud_exadata_infrastructures request
335
+ #
336
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
337
+ # # over elements, and API calls will be issued to fetch pages as needed.
338
+ # result.each do |item|
339
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::CloudExadataInfrastructure.
340
+ # p item
341
+ # end
342
+ #
343
+ def list_cloud_exadata_infrastructures request, options = nil
344
+ raise ::ArgumentError, "request must be provided" if request.nil?
345
+
346
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListCloudExadataInfrastructuresRequest
347
+
348
+ # Converts hash and nil to an options object
349
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
350
+
351
+ # Customize the options with defaults
352
+ metadata = @config.rpcs.list_cloud_exadata_infrastructures.metadata.to_h
353
+
354
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
355
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
356
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
357
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
358
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
359
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
360
+
361
+ header_params = {}
362
+ if request.parent
363
+ header_params["parent"] = request.parent
364
+ end
365
+
366
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
367
+ metadata[:"x-goog-request-params"] ||= request_params_header
368
+
369
+ options.apply_defaults timeout: @config.rpcs.list_cloud_exadata_infrastructures.timeout,
370
+ metadata: metadata,
371
+ retry_policy: @config.rpcs.list_cloud_exadata_infrastructures.retry_policy
372
+
373
+ options.apply_defaults timeout: @config.timeout,
374
+ metadata: @config.metadata,
375
+ retry_policy: @config.retry_policy
376
+
377
+ @oracle_database_stub.call_rpc :list_cloud_exadata_infrastructures, request, options: options do |response, operation|
378
+ response = ::Gapic::PagedEnumerable.new @oracle_database_stub, :list_cloud_exadata_infrastructures, request, response, operation, options
379
+ yield response, operation if block_given?
380
+ throw :response, response
381
+ end
382
+ rescue ::GRPC::BadStatus => e
383
+ raise ::Google::Cloud::Error.from_error(e)
384
+ end
385
+
386
+ ##
387
+ # Gets details of a single Exadata Infrastructure.
388
+ #
389
+ # @overload get_cloud_exadata_infrastructure(request, options = nil)
390
+ # Pass arguments to `get_cloud_exadata_infrastructure` via a request object, either of type
391
+ # {::Google::Cloud::OracleDatabase::V1::GetCloudExadataInfrastructureRequest} or an equivalent Hash.
392
+ #
393
+ # @param request [::Google::Cloud::OracleDatabase::V1::GetCloudExadataInfrastructureRequest, ::Hash]
394
+ # A request object representing the call parameters. Required. To specify no
395
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
396
+ # @param options [::Gapic::CallOptions, ::Hash]
397
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
398
+ #
399
+ # @overload get_cloud_exadata_infrastructure(name: nil)
400
+ # Pass arguments to `get_cloud_exadata_infrastructure` via keyword arguments. Note that at
401
+ # least one keyword argument is required. To specify no parameters, or to keep all
402
+ # the default parameter values, pass an empty Hash as a request object (see above).
403
+ #
404
+ # @param name [::String]
405
+ # Required. The name of the Cloud Exadata Infrastructure in the following
406
+ # format:
407
+ # projects/\\{project}/locations/\\{location}/cloudExadataInfrastructures/\\{cloud_exadata_infrastructure}.
408
+ #
409
+ # @yield [response, operation] Access the result along with the RPC operation
410
+ # @yieldparam response [::Google::Cloud::OracleDatabase::V1::CloudExadataInfrastructure]
411
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
412
+ #
413
+ # @return [::Google::Cloud::OracleDatabase::V1::CloudExadataInfrastructure]
414
+ #
415
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
416
+ #
417
+ # @example Basic example
418
+ # require "google/cloud/oracle_database/v1"
419
+ #
420
+ # # Create a client object. The client can be reused for multiple calls.
421
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
422
+ #
423
+ # # Create a request. To set request fields, pass in keyword arguments.
424
+ # request = Google::Cloud::OracleDatabase::V1::GetCloudExadataInfrastructureRequest.new
425
+ #
426
+ # # Call the get_cloud_exadata_infrastructure method.
427
+ # result = client.get_cloud_exadata_infrastructure request
428
+ #
429
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::CloudExadataInfrastructure.
430
+ # p result
431
+ #
432
+ def get_cloud_exadata_infrastructure request, options = nil
433
+ raise ::ArgumentError, "request must be provided" if request.nil?
434
+
435
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::GetCloudExadataInfrastructureRequest
436
+
437
+ # Converts hash and nil to an options object
438
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
439
+
440
+ # Customize the options with defaults
441
+ metadata = @config.rpcs.get_cloud_exadata_infrastructure.metadata.to_h
442
+
443
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
444
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
445
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
446
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
447
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
448
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
449
+
450
+ header_params = {}
451
+ if request.name
452
+ header_params["name"] = request.name
453
+ end
454
+
455
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
456
+ metadata[:"x-goog-request-params"] ||= request_params_header
457
+
458
+ options.apply_defaults timeout: @config.rpcs.get_cloud_exadata_infrastructure.timeout,
459
+ metadata: metadata,
460
+ retry_policy: @config.rpcs.get_cloud_exadata_infrastructure.retry_policy
461
+
462
+ options.apply_defaults timeout: @config.timeout,
463
+ metadata: @config.metadata,
464
+ retry_policy: @config.retry_policy
465
+
466
+ @oracle_database_stub.call_rpc :get_cloud_exadata_infrastructure, request, options: options do |response, operation|
467
+ yield response, operation if block_given?
468
+ end
469
+ rescue ::GRPC::BadStatus => e
470
+ raise ::Google::Cloud::Error.from_error(e)
471
+ end
472
+
473
+ ##
474
+ # Creates a new Exadata Infrastructure in a given project and location.
475
+ #
476
+ # @overload create_cloud_exadata_infrastructure(request, options = nil)
477
+ # Pass arguments to `create_cloud_exadata_infrastructure` via a request object, either of type
478
+ # {::Google::Cloud::OracleDatabase::V1::CreateCloudExadataInfrastructureRequest} or an equivalent Hash.
479
+ #
480
+ # @param request [::Google::Cloud::OracleDatabase::V1::CreateCloudExadataInfrastructureRequest, ::Hash]
481
+ # A request object representing the call parameters. Required. To specify no
482
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
483
+ # @param options [::Gapic::CallOptions, ::Hash]
484
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
485
+ #
486
+ # @overload create_cloud_exadata_infrastructure(parent: nil, cloud_exadata_infrastructure_id: nil, cloud_exadata_infrastructure: nil, request_id: nil)
487
+ # Pass arguments to `create_cloud_exadata_infrastructure` via keyword arguments. Note that at
488
+ # least one keyword argument is required. To specify no parameters, or to keep all
489
+ # the default parameter values, pass an empty Hash as a request object (see above).
490
+ #
491
+ # @param parent [::String]
492
+ # Required. The parent value for CloudExadataInfrastructure in the following
493
+ # format: projects/\\{project}/locations/\\{location}.
494
+ # @param cloud_exadata_infrastructure_id [::String]
495
+ # Required. The ID of the Exadata Infrastructure to create. This value is
496
+ # restricted to (^[a-z]([a-z0-9-]\\{0,61}[a-z0-9])?$) and must be a maximum of
497
+ # 63 characters in length. The value must start with a letter and end with a
498
+ # letter or a number.
499
+ # @param cloud_exadata_infrastructure [::Google::Cloud::OracleDatabase::V1::CloudExadataInfrastructure, ::Hash]
500
+ # Required. Details of the Exadata Infrastructure instance to create.
501
+ # @param request_id [::String]
502
+ # Optional. An optional ID to identify the request. This value is used to
503
+ # identify duplicate requests. If you make a request with the same request ID
504
+ # and the original request is still in progress or completed, the server
505
+ # ignores the second request. This prevents clients from
506
+ # accidentally creating duplicate commitments.
507
+ #
508
+ # The request ID must be a valid UUID with the exception that zero UUID is
509
+ # not supported (00000000-0000-0000-0000-000000000000).
510
+ #
511
+ # @yield [response, operation] Access the result along with the RPC operation
512
+ # @yieldparam response [::Gapic::Operation]
513
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
514
+ #
515
+ # @return [::Gapic::Operation]
516
+ #
517
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
518
+ #
519
+ # @example Basic example
520
+ # require "google/cloud/oracle_database/v1"
521
+ #
522
+ # # Create a client object. The client can be reused for multiple calls.
523
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
524
+ #
525
+ # # Create a request. To set request fields, pass in keyword arguments.
526
+ # request = Google::Cloud::OracleDatabase::V1::CreateCloudExadataInfrastructureRequest.new
527
+ #
528
+ # # Call the create_cloud_exadata_infrastructure method.
529
+ # result = client.create_cloud_exadata_infrastructure request
530
+ #
531
+ # # The returned object is of type Gapic::Operation. You can use it to
532
+ # # check the status of an operation, cancel it, or wait for results.
533
+ # # Here is how to wait for a response.
534
+ # result.wait_until_done! timeout: 60
535
+ # if result.response?
536
+ # p result.response
537
+ # else
538
+ # puts "No response received."
539
+ # end
540
+ #
541
+ def create_cloud_exadata_infrastructure request, options = nil
542
+ raise ::ArgumentError, "request must be provided" if request.nil?
543
+
544
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::CreateCloudExadataInfrastructureRequest
545
+
546
+ # Converts hash and nil to an options object
547
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
548
+
549
+ # Customize the options with defaults
550
+ metadata = @config.rpcs.create_cloud_exadata_infrastructure.metadata.to_h
551
+
552
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
553
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
554
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
555
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
556
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
557
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
558
+
559
+ header_params = {}
560
+ if request.parent
561
+ header_params["parent"] = request.parent
562
+ end
563
+
564
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
565
+ metadata[:"x-goog-request-params"] ||= request_params_header
566
+
567
+ options.apply_defaults timeout: @config.rpcs.create_cloud_exadata_infrastructure.timeout,
568
+ metadata: metadata,
569
+ retry_policy: @config.rpcs.create_cloud_exadata_infrastructure.retry_policy
570
+
571
+ options.apply_defaults timeout: @config.timeout,
572
+ metadata: @config.metadata,
573
+ retry_policy: @config.retry_policy
574
+
575
+ @oracle_database_stub.call_rpc :create_cloud_exadata_infrastructure, request, options: options do |response, operation|
576
+ response = ::Gapic::Operation.new response, @operations_client, options: options
577
+ yield response, operation if block_given?
578
+ throw :response, response
579
+ end
580
+ rescue ::GRPC::BadStatus => e
581
+ raise ::Google::Cloud::Error.from_error(e)
582
+ end
583
+
584
+ ##
585
+ # Deletes a single Exadata Infrastructure.
586
+ #
587
+ # @overload delete_cloud_exadata_infrastructure(request, options = nil)
588
+ # Pass arguments to `delete_cloud_exadata_infrastructure` via a request object, either of type
589
+ # {::Google::Cloud::OracleDatabase::V1::DeleteCloudExadataInfrastructureRequest} or an equivalent Hash.
590
+ #
591
+ # @param request [::Google::Cloud::OracleDatabase::V1::DeleteCloudExadataInfrastructureRequest, ::Hash]
592
+ # A request object representing the call parameters. Required. To specify no
593
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
594
+ # @param options [::Gapic::CallOptions, ::Hash]
595
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
596
+ #
597
+ # @overload delete_cloud_exadata_infrastructure(name: nil, request_id: nil, force: nil)
598
+ # Pass arguments to `delete_cloud_exadata_infrastructure` via keyword arguments. Note that at
599
+ # least one keyword argument is required. To specify no parameters, or to keep all
600
+ # the default parameter values, pass an empty Hash as a request object (see above).
601
+ #
602
+ # @param name [::String]
603
+ # Required. The name of the Cloud Exadata Infrastructure in the following
604
+ # format:
605
+ # projects/\\{project}/locations/\\{location}/cloudExadataInfrastructures/\\{cloud_exadata_infrastructure}.
606
+ # @param request_id [::String]
607
+ # Optional. An optional ID to identify the request. This value is used to
608
+ # identify duplicate requests. If you make a request with the same request ID
609
+ # and the original request is still in progress or completed, the server
610
+ # ignores the second request. This prevents clients from
611
+ # accidentally creating duplicate commitments.
612
+ #
613
+ # The request ID must be a valid UUID with the exception that zero UUID is
614
+ # not supported (00000000-0000-0000-0000-000000000000).
615
+ # @param force [::Boolean]
616
+ # Optional. If set to true, all VM clusters for this Exadata Infrastructure
617
+ # will be deleted. An Exadata Infrastructure can only be deleted once all its
618
+ # VM clusters have been deleted.
619
+ #
620
+ # @yield [response, operation] Access the result along with the RPC operation
621
+ # @yieldparam response [::Gapic::Operation]
622
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
623
+ #
624
+ # @return [::Gapic::Operation]
625
+ #
626
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
627
+ #
628
+ # @example Basic example
629
+ # require "google/cloud/oracle_database/v1"
630
+ #
631
+ # # Create a client object. The client can be reused for multiple calls.
632
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
633
+ #
634
+ # # Create a request. To set request fields, pass in keyword arguments.
635
+ # request = Google::Cloud::OracleDatabase::V1::DeleteCloudExadataInfrastructureRequest.new
636
+ #
637
+ # # Call the delete_cloud_exadata_infrastructure method.
638
+ # result = client.delete_cloud_exadata_infrastructure request
639
+ #
640
+ # # The returned object is of type Gapic::Operation. You can use it to
641
+ # # check the status of an operation, cancel it, or wait for results.
642
+ # # Here is how to wait for a response.
643
+ # result.wait_until_done! timeout: 60
644
+ # if result.response?
645
+ # p result.response
646
+ # else
647
+ # puts "No response received."
648
+ # end
649
+ #
650
+ def delete_cloud_exadata_infrastructure request, options = nil
651
+ raise ::ArgumentError, "request must be provided" if request.nil?
652
+
653
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::DeleteCloudExadataInfrastructureRequest
654
+
655
+ # Converts hash and nil to an options object
656
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
657
+
658
+ # Customize the options with defaults
659
+ metadata = @config.rpcs.delete_cloud_exadata_infrastructure.metadata.to_h
660
+
661
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
662
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
663
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
664
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
665
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
666
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
667
+
668
+ header_params = {}
669
+ if request.name
670
+ header_params["name"] = request.name
671
+ end
672
+
673
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
674
+ metadata[:"x-goog-request-params"] ||= request_params_header
675
+
676
+ options.apply_defaults timeout: @config.rpcs.delete_cloud_exadata_infrastructure.timeout,
677
+ metadata: metadata,
678
+ retry_policy: @config.rpcs.delete_cloud_exadata_infrastructure.retry_policy
679
+
680
+ options.apply_defaults timeout: @config.timeout,
681
+ metadata: @config.metadata,
682
+ retry_policy: @config.retry_policy
683
+
684
+ @oracle_database_stub.call_rpc :delete_cloud_exadata_infrastructure, request, options: options do |response, operation|
685
+ response = ::Gapic::Operation.new response, @operations_client, options: options
686
+ yield response, operation if block_given?
687
+ throw :response, response
688
+ end
689
+ rescue ::GRPC::BadStatus => e
690
+ raise ::Google::Cloud::Error.from_error(e)
691
+ end
692
+
693
+ ##
694
+ # Lists the VM Clusters in a given project and location.
695
+ #
696
+ # @overload list_cloud_vm_clusters(request, options = nil)
697
+ # Pass arguments to `list_cloud_vm_clusters` via a request object, either of type
698
+ # {::Google::Cloud::OracleDatabase::V1::ListCloudVmClustersRequest} or an equivalent Hash.
699
+ #
700
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListCloudVmClustersRequest, ::Hash]
701
+ # A request object representing the call parameters. Required. To specify no
702
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
703
+ # @param options [::Gapic::CallOptions, ::Hash]
704
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
705
+ #
706
+ # @overload list_cloud_vm_clusters(parent: nil, page_size: nil, page_token: nil, filter: nil)
707
+ # Pass arguments to `list_cloud_vm_clusters` via keyword arguments. Note that at
708
+ # least one keyword argument is required. To specify no parameters, or to keep all
709
+ # the default parameter values, pass an empty Hash as a request object (see above).
710
+ #
711
+ # @param parent [::String]
712
+ # Required. The name of the parent in the following format:
713
+ # projects/\\{project}/locations/\\{location}.
714
+ # @param page_size [::Integer]
715
+ # Optional. The number of VM clusters to return.
716
+ # If unspecified, at most 50 VM clusters will be returned.
717
+ # The maximum value is 1,000.
718
+ # @param page_token [::String]
719
+ # Optional. A token identifying the page of results the server returns.
720
+ # @param filter [::String]
721
+ # Optional. An expression for filtering the results of the request.
722
+ #
723
+ # @yield [response, operation] Access the result along with the RPC operation
724
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::CloudVmCluster>]
725
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
726
+ #
727
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::CloudVmCluster>]
728
+ #
729
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
730
+ #
731
+ # @example Basic example
732
+ # require "google/cloud/oracle_database/v1"
733
+ #
734
+ # # Create a client object. The client can be reused for multiple calls.
735
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
736
+ #
737
+ # # Create a request. To set request fields, pass in keyword arguments.
738
+ # request = Google::Cloud::OracleDatabase::V1::ListCloudVmClustersRequest.new
739
+ #
740
+ # # Call the list_cloud_vm_clusters method.
741
+ # result = client.list_cloud_vm_clusters request
742
+ #
743
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
744
+ # # over elements, and API calls will be issued to fetch pages as needed.
745
+ # result.each do |item|
746
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::CloudVmCluster.
747
+ # p item
748
+ # end
749
+ #
750
+ def list_cloud_vm_clusters request, options = nil
751
+ raise ::ArgumentError, "request must be provided" if request.nil?
752
+
753
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListCloudVmClustersRequest
754
+
755
+ # Converts hash and nil to an options object
756
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
757
+
758
+ # Customize the options with defaults
759
+ metadata = @config.rpcs.list_cloud_vm_clusters.metadata.to_h
760
+
761
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
762
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
763
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
764
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
765
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
766
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
767
+
768
+ header_params = {}
769
+ if request.parent
770
+ header_params["parent"] = request.parent
771
+ end
772
+
773
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
774
+ metadata[:"x-goog-request-params"] ||= request_params_header
775
+
776
+ options.apply_defaults timeout: @config.rpcs.list_cloud_vm_clusters.timeout,
777
+ metadata: metadata,
778
+ retry_policy: @config.rpcs.list_cloud_vm_clusters.retry_policy
779
+
780
+ options.apply_defaults timeout: @config.timeout,
781
+ metadata: @config.metadata,
782
+ retry_policy: @config.retry_policy
783
+
784
+ @oracle_database_stub.call_rpc :list_cloud_vm_clusters, request, options: options do |response, operation|
785
+ response = ::Gapic::PagedEnumerable.new @oracle_database_stub, :list_cloud_vm_clusters, request, response, operation, options
786
+ yield response, operation if block_given?
787
+ throw :response, response
788
+ end
789
+ rescue ::GRPC::BadStatus => e
790
+ raise ::Google::Cloud::Error.from_error(e)
791
+ end
792
+
793
+ ##
794
+ # Gets details of a single VM Cluster.
795
+ #
796
+ # @overload get_cloud_vm_cluster(request, options = nil)
797
+ # Pass arguments to `get_cloud_vm_cluster` via a request object, either of type
798
+ # {::Google::Cloud::OracleDatabase::V1::GetCloudVmClusterRequest} or an equivalent Hash.
799
+ #
800
+ # @param request [::Google::Cloud::OracleDatabase::V1::GetCloudVmClusterRequest, ::Hash]
801
+ # A request object representing the call parameters. Required. To specify no
802
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
803
+ # @param options [::Gapic::CallOptions, ::Hash]
804
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
805
+ #
806
+ # @overload get_cloud_vm_cluster(name: nil)
807
+ # Pass arguments to `get_cloud_vm_cluster` via keyword arguments. Note that at
808
+ # least one keyword argument is required. To specify no parameters, or to keep all
809
+ # the default parameter values, pass an empty Hash as a request object (see above).
810
+ #
811
+ # @param name [::String]
812
+ # Required. The name of the Cloud VM Cluster in the following format:
813
+ # projects/\\{project}/locations/\\{location}/cloudVmClusters/\\{cloud_vm_cluster}.
814
+ #
815
+ # @yield [response, operation] Access the result along with the RPC operation
816
+ # @yieldparam response [::Google::Cloud::OracleDatabase::V1::CloudVmCluster]
817
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
818
+ #
819
+ # @return [::Google::Cloud::OracleDatabase::V1::CloudVmCluster]
820
+ #
821
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
822
+ #
823
+ # @example Basic example
824
+ # require "google/cloud/oracle_database/v1"
825
+ #
826
+ # # Create a client object. The client can be reused for multiple calls.
827
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
828
+ #
829
+ # # Create a request. To set request fields, pass in keyword arguments.
830
+ # request = Google::Cloud::OracleDatabase::V1::GetCloudVmClusterRequest.new
831
+ #
832
+ # # Call the get_cloud_vm_cluster method.
833
+ # result = client.get_cloud_vm_cluster request
834
+ #
835
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::CloudVmCluster.
836
+ # p result
837
+ #
838
+ def get_cloud_vm_cluster request, options = nil
839
+ raise ::ArgumentError, "request must be provided" if request.nil?
840
+
841
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::GetCloudVmClusterRequest
842
+
843
+ # Converts hash and nil to an options object
844
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
845
+
846
+ # Customize the options with defaults
847
+ metadata = @config.rpcs.get_cloud_vm_cluster.metadata.to_h
848
+
849
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
850
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
851
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
852
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
853
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
854
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
855
+
856
+ header_params = {}
857
+ if request.name
858
+ header_params["name"] = request.name
859
+ end
860
+
861
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
862
+ metadata[:"x-goog-request-params"] ||= request_params_header
863
+
864
+ options.apply_defaults timeout: @config.rpcs.get_cloud_vm_cluster.timeout,
865
+ metadata: metadata,
866
+ retry_policy: @config.rpcs.get_cloud_vm_cluster.retry_policy
867
+
868
+ options.apply_defaults timeout: @config.timeout,
869
+ metadata: @config.metadata,
870
+ retry_policy: @config.retry_policy
871
+
872
+ @oracle_database_stub.call_rpc :get_cloud_vm_cluster, request, options: options do |response, operation|
873
+ yield response, operation if block_given?
874
+ end
875
+ rescue ::GRPC::BadStatus => e
876
+ raise ::Google::Cloud::Error.from_error(e)
877
+ end
878
+
879
+ ##
880
+ # Creates a new VM Cluster in a given project and location.
881
+ #
882
+ # @overload create_cloud_vm_cluster(request, options = nil)
883
+ # Pass arguments to `create_cloud_vm_cluster` via a request object, either of type
884
+ # {::Google::Cloud::OracleDatabase::V1::CreateCloudVmClusterRequest} or an equivalent Hash.
885
+ #
886
+ # @param request [::Google::Cloud::OracleDatabase::V1::CreateCloudVmClusterRequest, ::Hash]
887
+ # A request object representing the call parameters. Required. To specify no
888
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
889
+ # @param options [::Gapic::CallOptions, ::Hash]
890
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
891
+ #
892
+ # @overload create_cloud_vm_cluster(parent: nil, cloud_vm_cluster_id: nil, cloud_vm_cluster: nil, request_id: nil)
893
+ # Pass arguments to `create_cloud_vm_cluster` via keyword arguments. Note that at
894
+ # least one keyword argument is required. To specify no parameters, or to keep all
895
+ # the default parameter values, pass an empty Hash as a request object (see above).
896
+ #
897
+ # @param parent [::String]
898
+ # Required. The name of the parent in the following format:
899
+ # projects/\\{project}/locations/\\{location}.
900
+ # @param cloud_vm_cluster_id [::String]
901
+ # Required. The ID of the VM Cluster to create. This value is restricted
902
+ # to (^[a-z]([a-z0-9-]\\{0,61}[a-z0-9])?$) and must be a maximum of 63
903
+ # characters in length. The value must start with a letter and end with
904
+ # a letter or a number.
905
+ # @param cloud_vm_cluster [::Google::Cloud::OracleDatabase::V1::CloudVmCluster, ::Hash]
906
+ # Required. The resource being created
907
+ # @param request_id [::String]
908
+ # Optional. An optional ID to identify the request. This value is used to
909
+ # identify duplicate requests. If you make a request with the same request ID
910
+ # and the original request is still in progress or completed, the server
911
+ # ignores the second request. This prevents clients from
912
+ # accidentally creating duplicate commitments.
913
+ #
914
+ # The request ID must be a valid UUID with the exception that zero UUID is
915
+ # not supported (00000000-0000-0000-0000-000000000000).
916
+ #
917
+ # @yield [response, operation] Access the result along with the RPC operation
918
+ # @yieldparam response [::Gapic::Operation]
919
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
920
+ #
921
+ # @return [::Gapic::Operation]
922
+ #
923
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
924
+ #
925
+ # @example Basic example
926
+ # require "google/cloud/oracle_database/v1"
927
+ #
928
+ # # Create a client object. The client can be reused for multiple calls.
929
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
930
+ #
931
+ # # Create a request. To set request fields, pass in keyword arguments.
932
+ # request = Google::Cloud::OracleDatabase::V1::CreateCloudVmClusterRequest.new
933
+ #
934
+ # # Call the create_cloud_vm_cluster method.
935
+ # result = client.create_cloud_vm_cluster request
936
+ #
937
+ # # The returned object is of type Gapic::Operation. You can use it to
938
+ # # check the status of an operation, cancel it, or wait for results.
939
+ # # Here is how to wait for a response.
940
+ # result.wait_until_done! timeout: 60
941
+ # if result.response?
942
+ # p result.response
943
+ # else
944
+ # puts "No response received."
945
+ # end
946
+ #
947
+ def create_cloud_vm_cluster request, options = nil
948
+ raise ::ArgumentError, "request must be provided" if request.nil?
949
+
950
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::CreateCloudVmClusterRequest
951
+
952
+ # Converts hash and nil to an options object
953
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
954
+
955
+ # Customize the options with defaults
956
+ metadata = @config.rpcs.create_cloud_vm_cluster.metadata.to_h
957
+
958
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
959
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
960
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
961
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
962
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
963
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
964
+
965
+ header_params = {}
966
+ if request.parent
967
+ header_params["parent"] = request.parent
968
+ end
969
+
970
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
971
+ metadata[:"x-goog-request-params"] ||= request_params_header
972
+
973
+ options.apply_defaults timeout: @config.rpcs.create_cloud_vm_cluster.timeout,
974
+ metadata: metadata,
975
+ retry_policy: @config.rpcs.create_cloud_vm_cluster.retry_policy
976
+
977
+ options.apply_defaults timeout: @config.timeout,
978
+ metadata: @config.metadata,
979
+ retry_policy: @config.retry_policy
980
+
981
+ @oracle_database_stub.call_rpc :create_cloud_vm_cluster, request, options: options do |response, operation|
982
+ response = ::Gapic::Operation.new response, @operations_client, options: options
983
+ yield response, operation if block_given?
984
+ throw :response, response
985
+ end
986
+ rescue ::GRPC::BadStatus => e
987
+ raise ::Google::Cloud::Error.from_error(e)
988
+ end
989
+
990
+ ##
991
+ # Deletes a single VM Cluster.
992
+ #
993
+ # @overload delete_cloud_vm_cluster(request, options = nil)
994
+ # Pass arguments to `delete_cloud_vm_cluster` via a request object, either of type
995
+ # {::Google::Cloud::OracleDatabase::V1::DeleteCloudVmClusterRequest} or an equivalent Hash.
996
+ #
997
+ # @param request [::Google::Cloud::OracleDatabase::V1::DeleteCloudVmClusterRequest, ::Hash]
998
+ # A request object representing the call parameters. Required. To specify no
999
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1000
+ # @param options [::Gapic::CallOptions, ::Hash]
1001
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1002
+ #
1003
+ # @overload delete_cloud_vm_cluster(name: nil, request_id: nil, force: nil)
1004
+ # Pass arguments to `delete_cloud_vm_cluster` via keyword arguments. Note that at
1005
+ # least one keyword argument is required. To specify no parameters, or to keep all
1006
+ # the default parameter values, pass an empty Hash as a request object (see above).
1007
+ #
1008
+ # @param name [::String]
1009
+ # Required. The name of the Cloud VM Cluster in the following format:
1010
+ # projects/\\{project}/locations/\\{location}/cloudVmClusters/\\{cloud_vm_cluster}.
1011
+ # @param request_id [::String]
1012
+ # Optional. An optional ID to identify the request. This value is used to
1013
+ # identify duplicate requests. If you make a request with the same request ID
1014
+ # and the original request is still in progress or completed, the server
1015
+ # ignores the second request. This prevents clients from
1016
+ # accidentally creating duplicate commitments.
1017
+ #
1018
+ # The request ID must be a valid UUID with the exception that zero UUID is
1019
+ # not supported (00000000-0000-0000-0000-000000000000).
1020
+ # @param force [::Boolean]
1021
+ # Optional. If set to true, all child resources for the VM Cluster will be
1022
+ # deleted. A VM Cluster can only be deleted once all its child resources have
1023
+ # been deleted.
1024
+ #
1025
+ # @yield [response, operation] Access the result along with the RPC operation
1026
+ # @yieldparam response [::Gapic::Operation]
1027
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1028
+ #
1029
+ # @return [::Gapic::Operation]
1030
+ #
1031
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1032
+ #
1033
+ # @example Basic example
1034
+ # require "google/cloud/oracle_database/v1"
1035
+ #
1036
+ # # Create a client object. The client can be reused for multiple calls.
1037
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
1038
+ #
1039
+ # # Create a request. To set request fields, pass in keyword arguments.
1040
+ # request = Google::Cloud::OracleDatabase::V1::DeleteCloudVmClusterRequest.new
1041
+ #
1042
+ # # Call the delete_cloud_vm_cluster method.
1043
+ # result = client.delete_cloud_vm_cluster request
1044
+ #
1045
+ # # The returned object is of type Gapic::Operation. You can use it to
1046
+ # # check the status of an operation, cancel it, or wait for results.
1047
+ # # Here is how to wait for a response.
1048
+ # result.wait_until_done! timeout: 60
1049
+ # if result.response?
1050
+ # p result.response
1051
+ # else
1052
+ # puts "No response received."
1053
+ # end
1054
+ #
1055
+ def delete_cloud_vm_cluster request, options = nil
1056
+ raise ::ArgumentError, "request must be provided" if request.nil?
1057
+
1058
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::DeleteCloudVmClusterRequest
1059
+
1060
+ # Converts hash and nil to an options object
1061
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1062
+
1063
+ # Customize the options with defaults
1064
+ metadata = @config.rpcs.delete_cloud_vm_cluster.metadata.to_h
1065
+
1066
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1067
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1068
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1069
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
1070
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1071
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1072
+
1073
+ header_params = {}
1074
+ if request.name
1075
+ header_params["name"] = request.name
1076
+ end
1077
+
1078
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1079
+ metadata[:"x-goog-request-params"] ||= request_params_header
1080
+
1081
+ options.apply_defaults timeout: @config.rpcs.delete_cloud_vm_cluster.timeout,
1082
+ metadata: metadata,
1083
+ retry_policy: @config.rpcs.delete_cloud_vm_cluster.retry_policy
1084
+
1085
+ options.apply_defaults timeout: @config.timeout,
1086
+ metadata: @config.metadata,
1087
+ retry_policy: @config.retry_policy
1088
+
1089
+ @oracle_database_stub.call_rpc :delete_cloud_vm_cluster, request, options: options do |response, operation|
1090
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1091
+ yield response, operation if block_given?
1092
+ throw :response, response
1093
+ end
1094
+ rescue ::GRPC::BadStatus => e
1095
+ raise ::Google::Cloud::Error.from_error(e)
1096
+ end
1097
+
1098
+ ##
1099
+ # Lists the entitlements in a given project.
1100
+ #
1101
+ # @overload list_entitlements(request, options = nil)
1102
+ # Pass arguments to `list_entitlements` via a request object, either of type
1103
+ # {::Google::Cloud::OracleDatabase::V1::ListEntitlementsRequest} or an equivalent Hash.
1104
+ #
1105
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListEntitlementsRequest, ::Hash]
1106
+ # A request object representing the call parameters. Required. To specify no
1107
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1108
+ # @param options [::Gapic::CallOptions, ::Hash]
1109
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1110
+ #
1111
+ # @overload list_entitlements(parent: nil, page_size: nil, page_token: nil)
1112
+ # Pass arguments to `list_entitlements` via keyword arguments. Note that at
1113
+ # least one keyword argument is required. To specify no parameters, or to keep all
1114
+ # the default parameter values, pass an empty Hash as a request object (see above).
1115
+ #
1116
+ # @param parent [::String]
1117
+ # Required. The parent value for the entitlement in the following format:
1118
+ # projects/\\{project}/locations/\\{location}.
1119
+ # @param page_size [::Integer]
1120
+ # Optional. The maximum number of items to return.
1121
+ # If unspecified, a maximum of 50 entitlements will be returned.
1122
+ # The maximum value is 1000.
1123
+ # @param page_token [::String]
1124
+ # Optional. A token identifying a page of results the server should return.
1125
+ #
1126
+ # @yield [response, operation] Access the result along with the RPC operation
1127
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::Entitlement>]
1128
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1129
+ #
1130
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::Entitlement>]
1131
+ #
1132
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1133
+ #
1134
+ # @example Basic example
1135
+ # require "google/cloud/oracle_database/v1"
1136
+ #
1137
+ # # Create a client object. The client can be reused for multiple calls.
1138
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
1139
+ #
1140
+ # # Create a request. To set request fields, pass in keyword arguments.
1141
+ # request = Google::Cloud::OracleDatabase::V1::ListEntitlementsRequest.new
1142
+ #
1143
+ # # Call the list_entitlements method.
1144
+ # result = client.list_entitlements request
1145
+ #
1146
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1147
+ # # over elements, and API calls will be issued to fetch pages as needed.
1148
+ # result.each do |item|
1149
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::Entitlement.
1150
+ # p item
1151
+ # end
1152
+ #
1153
+ def list_entitlements request, options = nil
1154
+ raise ::ArgumentError, "request must be provided" if request.nil?
1155
+
1156
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListEntitlementsRequest
1157
+
1158
+ # Converts hash and nil to an options object
1159
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1160
+
1161
+ # Customize the options with defaults
1162
+ metadata = @config.rpcs.list_entitlements.metadata.to_h
1163
+
1164
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1165
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1166
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1167
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
1168
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1169
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1170
+
1171
+ header_params = {}
1172
+ if request.parent
1173
+ header_params["parent"] = request.parent
1174
+ end
1175
+
1176
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1177
+ metadata[:"x-goog-request-params"] ||= request_params_header
1178
+
1179
+ options.apply_defaults timeout: @config.rpcs.list_entitlements.timeout,
1180
+ metadata: metadata,
1181
+ retry_policy: @config.rpcs.list_entitlements.retry_policy
1182
+
1183
+ options.apply_defaults timeout: @config.timeout,
1184
+ metadata: @config.metadata,
1185
+ retry_policy: @config.retry_policy
1186
+
1187
+ @oracle_database_stub.call_rpc :list_entitlements, request, options: options do |response, operation|
1188
+ response = ::Gapic::PagedEnumerable.new @oracle_database_stub, :list_entitlements, request, response, operation, options
1189
+ yield response, operation if block_given?
1190
+ throw :response, response
1191
+ end
1192
+ rescue ::GRPC::BadStatus => e
1193
+ raise ::Google::Cloud::Error.from_error(e)
1194
+ end
1195
+
1196
+ ##
1197
+ # Lists the database servers of an Exadata Infrastructure instance.
1198
+ #
1199
+ # @overload list_db_servers(request, options = nil)
1200
+ # Pass arguments to `list_db_servers` via a request object, either of type
1201
+ # {::Google::Cloud::OracleDatabase::V1::ListDbServersRequest} or an equivalent Hash.
1202
+ #
1203
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListDbServersRequest, ::Hash]
1204
+ # A request object representing the call parameters. Required. To specify no
1205
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1206
+ # @param options [::Gapic::CallOptions, ::Hash]
1207
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1208
+ #
1209
+ # @overload list_db_servers(parent: nil, page_size: nil, page_token: nil)
1210
+ # Pass arguments to `list_db_servers` via keyword arguments. Note that at
1211
+ # least one keyword argument is required. To specify no parameters, or to keep all
1212
+ # the default parameter values, pass an empty Hash as a request object (see above).
1213
+ #
1214
+ # @param parent [::String]
1215
+ # Required. The parent value for database server in the following format:
1216
+ # projects/\\{project}/locations/\\{location}/cloudExadataInfrastructures/\\{cloudExadataInfrastructure}.
1217
+ # @param page_size [::Integer]
1218
+ # Optional. The maximum number of items to return.
1219
+ # If unspecified, a maximum of 50 db servers will be returned.
1220
+ # The maximum value is 1000; values above 1000 will be reset to 1000.
1221
+ # @param page_token [::String]
1222
+ # Optional. A token identifying a page of results the server should return.
1223
+ #
1224
+ # @yield [response, operation] Access the result along with the RPC operation
1225
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DbServer>]
1226
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1227
+ #
1228
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DbServer>]
1229
+ #
1230
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1231
+ #
1232
+ # @example Basic example
1233
+ # require "google/cloud/oracle_database/v1"
1234
+ #
1235
+ # # Create a client object. The client can be reused for multiple calls.
1236
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
1237
+ #
1238
+ # # Create a request. To set request fields, pass in keyword arguments.
1239
+ # request = Google::Cloud::OracleDatabase::V1::ListDbServersRequest.new
1240
+ #
1241
+ # # Call the list_db_servers method.
1242
+ # result = client.list_db_servers request
1243
+ #
1244
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1245
+ # # over elements, and API calls will be issued to fetch pages as needed.
1246
+ # result.each do |item|
1247
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::DbServer.
1248
+ # p item
1249
+ # end
1250
+ #
1251
+ def list_db_servers request, options = nil
1252
+ raise ::ArgumentError, "request must be provided" if request.nil?
1253
+
1254
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListDbServersRequest
1255
+
1256
+ # Converts hash and nil to an options object
1257
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1258
+
1259
+ # Customize the options with defaults
1260
+ metadata = @config.rpcs.list_db_servers.metadata.to_h
1261
+
1262
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1263
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1264
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1265
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
1266
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1267
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1268
+
1269
+ header_params = {}
1270
+ if request.parent
1271
+ header_params["parent"] = request.parent
1272
+ end
1273
+
1274
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1275
+ metadata[:"x-goog-request-params"] ||= request_params_header
1276
+
1277
+ options.apply_defaults timeout: @config.rpcs.list_db_servers.timeout,
1278
+ metadata: metadata,
1279
+ retry_policy: @config.rpcs.list_db_servers.retry_policy
1280
+
1281
+ options.apply_defaults timeout: @config.timeout,
1282
+ metadata: @config.metadata,
1283
+ retry_policy: @config.retry_policy
1284
+
1285
+ @oracle_database_stub.call_rpc :list_db_servers, request, options: options do |response, operation|
1286
+ response = ::Gapic::PagedEnumerable.new @oracle_database_stub, :list_db_servers, request, response, operation, options
1287
+ yield response, operation if block_given?
1288
+ throw :response, response
1289
+ end
1290
+ rescue ::GRPC::BadStatus => e
1291
+ raise ::Google::Cloud::Error.from_error(e)
1292
+ end
1293
+
1294
+ ##
1295
+ # Lists the database nodes of a VM Cluster.
1296
+ #
1297
+ # @overload list_db_nodes(request, options = nil)
1298
+ # Pass arguments to `list_db_nodes` via a request object, either of type
1299
+ # {::Google::Cloud::OracleDatabase::V1::ListDbNodesRequest} or an equivalent Hash.
1300
+ #
1301
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListDbNodesRequest, ::Hash]
1302
+ # A request object representing the call parameters. Required. To specify no
1303
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1304
+ # @param options [::Gapic::CallOptions, ::Hash]
1305
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1306
+ #
1307
+ # @overload list_db_nodes(parent: nil, page_size: nil, page_token: nil)
1308
+ # Pass arguments to `list_db_nodes` via keyword arguments. Note that at
1309
+ # least one keyword argument is required. To specify no parameters, or to keep all
1310
+ # the default parameter values, pass an empty Hash as a request object (see above).
1311
+ #
1312
+ # @param parent [::String]
1313
+ # Required. The parent value for database node in the following format:
1314
+ # projects/\\{project}/locations/\\{location}/cloudVmClusters/\\{cloudVmCluster}.
1315
+ # @param page_size [::Integer]
1316
+ # Optional. The maximum number of items to return.
1317
+ # If unspecified, at most 50 db nodes will be returned.
1318
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
1319
+ # @param page_token [::String]
1320
+ # Optional. A token identifying a page of results the node should return.
1321
+ #
1322
+ # @yield [response, operation] Access the result along with the RPC operation
1323
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DbNode>]
1324
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1325
+ #
1326
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DbNode>]
1327
+ #
1328
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1329
+ #
1330
+ # @example Basic example
1331
+ # require "google/cloud/oracle_database/v1"
1332
+ #
1333
+ # # Create a client object. The client can be reused for multiple calls.
1334
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
1335
+ #
1336
+ # # Create a request. To set request fields, pass in keyword arguments.
1337
+ # request = Google::Cloud::OracleDatabase::V1::ListDbNodesRequest.new
1338
+ #
1339
+ # # Call the list_db_nodes method.
1340
+ # result = client.list_db_nodes request
1341
+ #
1342
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1343
+ # # over elements, and API calls will be issued to fetch pages as needed.
1344
+ # result.each do |item|
1345
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::DbNode.
1346
+ # p item
1347
+ # end
1348
+ #
1349
+ def list_db_nodes request, options = nil
1350
+ raise ::ArgumentError, "request must be provided" if request.nil?
1351
+
1352
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListDbNodesRequest
1353
+
1354
+ # Converts hash and nil to an options object
1355
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1356
+
1357
+ # Customize the options with defaults
1358
+ metadata = @config.rpcs.list_db_nodes.metadata.to_h
1359
+
1360
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1361
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1362
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1363
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
1364
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1365
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1366
+
1367
+ header_params = {}
1368
+ if request.parent
1369
+ header_params["parent"] = request.parent
1370
+ end
1371
+
1372
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1373
+ metadata[:"x-goog-request-params"] ||= request_params_header
1374
+
1375
+ options.apply_defaults timeout: @config.rpcs.list_db_nodes.timeout,
1376
+ metadata: metadata,
1377
+ retry_policy: @config.rpcs.list_db_nodes.retry_policy
1378
+
1379
+ options.apply_defaults timeout: @config.timeout,
1380
+ metadata: @config.metadata,
1381
+ retry_policy: @config.retry_policy
1382
+
1383
+ @oracle_database_stub.call_rpc :list_db_nodes, request, options: options do |response, operation|
1384
+ response = ::Gapic::PagedEnumerable.new @oracle_database_stub, :list_db_nodes, request, response, operation, options
1385
+ yield response, operation if block_given?
1386
+ throw :response, response
1387
+ end
1388
+ rescue ::GRPC::BadStatus => e
1389
+ raise ::Google::Cloud::Error.from_error(e)
1390
+ end
1391
+
1392
+ ##
1393
+ # Lists all the valid Oracle Grid Infrastructure (GI) versions for the given
1394
+ # project and location.
1395
+ #
1396
+ # @overload list_gi_versions(request, options = nil)
1397
+ # Pass arguments to `list_gi_versions` via a request object, either of type
1398
+ # {::Google::Cloud::OracleDatabase::V1::ListGiVersionsRequest} or an equivalent Hash.
1399
+ #
1400
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListGiVersionsRequest, ::Hash]
1401
+ # A request object representing the call parameters. Required. To specify no
1402
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1403
+ # @param options [::Gapic::CallOptions, ::Hash]
1404
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1405
+ #
1406
+ # @overload list_gi_versions(parent: nil, page_size: nil, page_token: nil)
1407
+ # Pass arguments to `list_gi_versions` via keyword arguments. Note that at
1408
+ # least one keyword argument is required. To specify no parameters, or to keep all
1409
+ # the default parameter values, pass an empty Hash as a request object (see above).
1410
+ #
1411
+ # @param parent [::String]
1412
+ # Required. The parent value for Grid Infrastructure Version in the following
1413
+ # format: Format: projects/\\{project}/locations/\\{location}.
1414
+ # @param page_size [::Integer]
1415
+ # Optional. The maximum number of items to return.
1416
+ # If unspecified, a maximum of 50 Oracle Grid Infrastructure (GI) versions
1417
+ # will be returned. The maximum value is 1000; values above 1000 will be
1418
+ # reset to 1000.
1419
+ # @param page_token [::String]
1420
+ # Optional. A token identifying a page of results the server should return.
1421
+ #
1422
+ # @yield [response, operation] Access the result along with the RPC operation
1423
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GiVersion>]
1424
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1425
+ #
1426
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::GiVersion>]
1427
+ #
1428
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1429
+ #
1430
+ # @example Basic example
1431
+ # require "google/cloud/oracle_database/v1"
1432
+ #
1433
+ # # Create a client object. The client can be reused for multiple calls.
1434
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
1435
+ #
1436
+ # # Create a request. To set request fields, pass in keyword arguments.
1437
+ # request = Google::Cloud::OracleDatabase::V1::ListGiVersionsRequest.new
1438
+ #
1439
+ # # Call the list_gi_versions method.
1440
+ # result = client.list_gi_versions request
1441
+ #
1442
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1443
+ # # over elements, and API calls will be issued to fetch pages as needed.
1444
+ # result.each do |item|
1445
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::GiVersion.
1446
+ # p item
1447
+ # end
1448
+ #
1449
+ def list_gi_versions request, options = nil
1450
+ raise ::ArgumentError, "request must be provided" if request.nil?
1451
+
1452
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListGiVersionsRequest
1453
+
1454
+ # Converts hash and nil to an options object
1455
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1456
+
1457
+ # Customize the options with defaults
1458
+ metadata = @config.rpcs.list_gi_versions.metadata.to_h
1459
+
1460
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1461
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1462
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1463
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
1464
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1465
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1466
+
1467
+ header_params = {}
1468
+ if request.parent
1469
+ header_params["parent"] = request.parent
1470
+ end
1471
+
1472
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1473
+ metadata[:"x-goog-request-params"] ||= request_params_header
1474
+
1475
+ options.apply_defaults timeout: @config.rpcs.list_gi_versions.timeout,
1476
+ metadata: metadata,
1477
+ retry_policy: @config.rpcs.list_gi_versions.retry_policy
1478
+
1479
+ options.apply_defaults timeout: @config.timeout,
1480
+ metadata: @config.metadata,
1481
+ retry_policy: @config.retry_policy
1482
+
1483
+ @oracle_database_stub.call_rpc :list_gi_versions, request, options: options do |response, operation|
1484
+ response = ::Gapic::PagedEnumerable.new @oracle_database_stub, :list_gi_versions, request, response, operation, options
1485
+ yield response, operation if block_given?
1486
+ throw :response, response
1487
+ end
1488
+ rescue ::GRPC::BadStatus => e
1489
+ raise ::Google::Cloud::Error.from_error(e)
1490
+ end
1491
+
1492
+ ##
1493
+ # Lists the database system shapes available for the project and location.
1494
+ #
1495
+ # @overload list_db_system_shapes(request, options = nil)
1496
+ # Pass arguments to `list_db_system_shapes` via a request object, either of type
1497
+ # {::Google::Cloud::OracleDatabase::V1::ListDbSystemShapesRequest} or an equivalent Hash.
1498
+ #
1499
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListDbSystemShapesRequest, ::Hash]
1500
+ # A request object representing the call parameters. Required. To specify no
1501
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1502
+ # @param options [::Gapic::CallOptions, ::Hash]
1503
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1504
+ #
1505
+ # @overload list_db_system_shapes(parent: nil, page_size: nil, page_token: nil)
1506
+ # Pass arguments to `list_db_system_shapes` via keyword arguments. Note that at
1507
+ # least one keyword argument is required. To specify no parameters, or to keep all
1508
+ # the default parameter values, pass an empty Hash as a request object (see above).
1509
+ #
1510
+ # @param parent [::String]
1511
+ # Required. The parent value for Database System Shapes in the following
1512
+ # format: projects/\\{project}/locations/\\{location}.
1513
+ # @param page_size [::Integer]
1514
+ # Optional. The maximum number of items to return.
1515
+ # If unspecified, at most 50 database system shapes will be returned.
1516
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
1517
+ # @param page_token [::String]
1518
+ # Optional. A token identifying a page of results the server should return.
1519
+ #
1520
+ # @yield [response, operation] Access the result along with the RPC operation
1521
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DbSystemShape>]
1522
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1523
+ #
1524
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::DbSystemShape>]
1525
+ #
1526
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1527
+ #
1528
+ # @example Basic example
1529
+ # require "google/cloud/oracle_database/v1"
1530
+ #
1531
+ # # Create a client object. The client can be reused for multiple calls.
1532
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
1533
+ #
1534
+ # # Create a request. To set request fields, pass in keyword arguments.
1535
+ # request = Google::Cloud::OracleDatabase::V1::ListDbSystemShapesRequest.new
1536
+ #
1537
+ # # Call the list_db_system_shapes method.
1538
+ # result = client.list_db_system_shapes request
1539
+ #
1540
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1541
+ # # over elements, and API calls will be issued to fetch pages as needed.
1542
+ # result.each do |item|
1543
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::DbSystemShape.
1544
+ # p item
1545
+ # end
1546
+ #
1547
+ def list_db_system_shapes request, options = nil
1548
+ raise ::ArgumentError, "request must be provided" if request.nil?
1549
+
1550
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListDbSystemShapesRequest
1551
+
1552
+ # Converts hash and nil to an options object
1553
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1554
+
1555
+ # Customize the options with defaults
1556
+ metadata = @config.rpcs.list_db_system_shapes.metadata.to_h
1557
+
1558
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1559
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1560
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1561
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
1562
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1563
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1564
+
1565
+ header_params = {}
1566
+ if request.parent
1567
+ header_params["parent"] = request.parent
1568
+ end
1569
+
1570
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1571
+ metadata[:"x-goog-request-params"] ||= request_params_header
1572
+
1573
+ options.apply_defaults timeout: @config.rpcs.list_db_system_shapes.timeout,
1574
+ metadata: metadata,
1575
+ retry_policy: @config.rpcs.list_db_system_shapes.retry_policy
1576
+
1577
+ options.apply_defaults timeout: @config.timeout,
1578
+ metadata: @config.metadata,
1579
+ retry_policy: @config.retry_policy
1580
+
1581
+ @oracle_database_stub.call_rpc :list_db_system_shapes, request, options: options do |response, operation|
1582
+ response = ::Gapic::PagedEnumerable.new @oracle_database_stub, :list_db_system_shapes, request, response, operation, options
1583
+ yield response, operation if block_given?
1584
+ throw :response, response
1585
+ end
1586
+ rescue ::GRPC::BadStatus => e
1587
+ raise ::Google::Cloud::Error.from_error(e)
1588
+ end
1589
+
1590
+ ##
1591
+ # Lists the Autonomous Databases in a given project and location.
1592
+ #
1593
+ # @overload list_autonomous_databases(request, options = nil)
1594
+ # Pass arguments to `list_autonomous_databases` via a request object, either of type
1595
+ # {::Google::Cloud::OracleDatabase::V1::ListAutonomousDatabasesRequest} or an equivalent Hash.
1596
+ #
1597
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListAutonomousDatabasesRequest, ::Hash]
1598
+ # A request object representing the call parameters. Required. To specify no
1599
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1600
+ # @param options [::Gapic::CallOptions, ::Hash]
1601
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1602
+ #
1603
+ # @overload list_autonomous_databases(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil)
1604
+ # Pass arguments to `list_autonomous_databases` via keyword arguments. Note that at
1605
+ # least one keyword argument is required. To specify no parameters, or to keep all
1606
+ # the default parameter values, pass an empty Hash as a request object (see above).
1607
+ #
1608
+ # @param parent [::String]
1609
+ # Required. The parent value for the Autonomous Database in the following
1610
+ # format: projects/\\{project}/locations/\\{location}.
1611
+ # @param page_size [::Integer]
1612
+ # Optional. The maximum number of items to return.
1613
+ # If unspecified, at most 50 Autonomous Database will be returned.
1614
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
1615
+ # @param page_token [::String]
1616
+ # Optional. A token identifying a page of results the server should return.
1617
+ # @param filter [::String]
1618
+ # Optional. An expression for filtering the results of the request.
1619
+ # @param order_by [::String]
1620
+ # Optional. An expression for ordering the results of the request.
1621
+ #
1622
+ # @yield [response, operation] Access the result along with the RPC operation
1623
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::AutonomousDatabase>]
1624
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1625
+ #
1626
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::AutonomousDatabase>]
1627
+ #
1628
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1629
+ #
1630
+ # @example Basic example
1631
+ # require "google/cloud/oracle_database/v1"
1632
+ #
1633
+ # # Create a client object. The client can be reused for multiple calls.
1634
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
1635
+ #
1636
+ # # Create a request. To set request fields, pass in keyword arguments.
1637
+ # request = Google::Cloud::OracleDatabase::V1::ListAutonomousDatabasesRequest.new
1638
+ #
1639
+ # # Call the list_autonomous_databases method.
1640
+ # result = client.list_autonomous_databases request
1641
+ #
1642
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
1643
+ # # over elements, and API calls will be issued to fetch pages as needed.
1644
+ # result.each do |item|
1645
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::AutonomousDatabase.
1646
+ # p item
1647
+ # end
1648
+ #
1649
+ def list_autonomous_databases request, options = nil
1650
+ raise ::ArgumentError, "request must be provided" if request.nil?
1651
+
1652
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListAutonomousDatabasesRequest
1653
+
1654
+ # Converts hash and nil to an options object
1655
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1656
+
1657
+ # Customize the options with defaults
1658
+ metadata = @config.rpcs.list_autonomous_databases.metadata.to_h
1659
+
1660
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1661
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1662
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1663
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
1664
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1665
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1666
+
1667
+ header_params = {}
1668
+ if request.parent
1669
+ header_params["parent"] = request.parent
1670
+ end
1671
+
1672
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1673
+ metadata[:"x-goog-request-params"] ||= request_params_header
1674
+
1675
+ options.apply_defaults timeout: @config.rpcs.list_autonomous_databases.timeout,
1676
+ metadata: metadata,
1677
+ retry_policy: @config.rpcs.list_autonomous_databases.retry_policy
1678
+
1679
+ options.apply_defaults timeout: @config.timeout,
1680
+ metadata: @config.metadata,
1681
+ retry_policy: @config.retry_policy
1682
+
1683
+ @oracle_database_stub.call_rpc :list_autonomous_databases, request, options: options do |response, operation|
1684
+ response = ::Gapic::PagedEnumerable.new @oracle_database_stub, :list_autonomous_databases, request, response, operation, options
1685
+ yield response, operation if block_given?
1686
+ throw :response, response
1687
+ end
1688
+ rescue ::GRPC::BadStatus => e
1689
+ raise ::Google::Cloud::Error.from_error(e)
1690
+ end
1691
+
1692
+ ##
1693
+ # Gets the details of a single Autonomous Database.
1694
+ #
1695
+ # @overload get_autonomous_database(request, options = nil)
1696
+ # Pass arguments to `get_autonomous_database` via a request object, either of type
1697
+ # {::Google::Cloud::OracleDatabase::V1::GetAutonomousDatabaseRequest} or an equivalent Hash.
1698
+ #
1699
+ # @param request [::Google::Cloud::OracleDatabase::V1::GetAutonomousDatabaseRequest, ::Hash]
1700
+ # A request object representing the call parameters. Required. To specify no
1701
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1702
+ # @param options [::Gapic::CallOptions, ::Hash]
1703
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1704
+ #
1705
+ # @overload get_autonomous_database(name: nil)
1706
+ # Pass arguments to `get_autonomous_database` via keyword arguments. Note that at
1707
+ # least one keyword argument is required. To specify no parameters, or to keep all
1708
+ # the default parameter values, pass an empty Hash as a request object (see above).
1709
+ #
1710
+ # @param name [::String]
1711
+ # Required. The name of the Autonomous Database in the following format:
1712
+ # projects/\\{project}/locations/\\{location}/autonomousDatabases/\\{autonomous_database}.
1713
+ #
1714
+ # @yield [response, operation] Access the result along with the RPC operation
1715
+ # @yieldparam response [::Google::Cloud::OracleDatabase::V1::AutonomousDatabase]
1716
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1717
+ #
1718
+ # @return [::Google::Cloud::OracleDatabase::V1::AutonomousDatabase]
1719
+ #
1720
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1721
+ #
1722
+ # @example Basic example
1723
+ # require "google/cloud/oracle_database/v1"
1724
+ #
1725
+ # # Create a client object. The client can be reused for multiple calls.
1726
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
1727
+ #
1728
+ # # Create a request. To set request fields, pass in keyword arguments.
1729
+ # request = Google::Cloud::OracleDatabase::V1::GetAutonomousDatabaseRequest.new
1730
+ #
1731
+ # # Call the get_autonomous_database method.
1732
+ # result = client.get_autonomous_database request
1733
+ #
1734
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::AutonomousDatabase.
1735
+ # p result
1736
+ #
1737
+ def get_autonomous_database request, options = nil
1738
+ raise ::ArgumentError, "request must be provided" if request.nil?
1739
+
1740
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::GetAutonomousDatabaseRequest
1741
+
1742
+ # Converts hash and nil to an options object
1743
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1744
+
1745
+ # Customize the options with defaults
1746
+ metadata = @config.rpcs.get_autonomous_database.metadata.to_h
1747
+
1748
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1749
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1750
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1751
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
1752
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1753
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1754
+
1755
+ header_params = {}
1756
+ if request.name
1757
+ header_params["name"] = request.name
1758
+ end
1759
+
1760
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1761
+ metadata[:"x-goog-request-params"] ||= request_params_header
1762
+
1763
+ options.apply_defaults timeout: @config.rpcs.get_autonomous_database.timeout,
1764
+ metadata: metadata,
1765
+ retry_policy: @config.rpcs.get_autonomous_database.retry_policy
1766
+
1767
+ options.apply_defaults timeout: @config.timeout,
1768
+ metadata: @config.metadata,
1769
+ retry_policy: @config.retry_policy
1770
+
1771
+ @oracle_database_stub.call_rpc :get_autonomous_database, request, options: options do |response, operation|
1772
+ yield response, operation if block_given?
1773
+ end
1774
+ rescue ::GRPC::BadStatus => e
1775
+ raise ::Google::Cloud::Error.from_error(e)
1776
+ end
1777
+
1778
+ ##
1779
+ # Creates a new Autonomous Database in a given project and location.
1780
+ #
1781
+ # @overload create_autonomous_database(request, options = nil)
1782
+ # Pass arguments to `create_autonomous_database` via a request object, either of type
1783
+ # {::Google::Cloud::OracleDatabase::V1::CreateAutonomousDatabaseRequest} or an equivalent Hash.
1784
+ #
1785
+ # @param request [::Google::Cloud::OracleDatabase::V1::CreateAutonomousDatabaseRequest, ::Hash]
1786
+ # A request object representing the call parameters. Required. To specify no
1787
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1788
+ # @param options [::Gapic::CallOptions, ::Hash]
1789
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1790
+ #
1791
+ # @overload create_autonomous_database(parent: nil, autonomous_database_id: nil, autonomous_database: nil, request_id: nil)
1792
+ # Pass arguments to `create_autonomous_database` via keyword arguments. Note that at
1793
+ # least one keyword argument is required. To specify no parameters, or to keep all
1794
+ # the default parameter values, pass an empty Hash as a request object (see above).
1795
+ #
1796
+ # @param parent [::String]
1797
+ # Required. The name of the parent in the following format:
1798
+ # projects/\\{project}/locations/\\{location}.
1799
+ # @param autonomous_database_id [::String]
1800
+ # Required. The ID of the Autonomous Database to create. This value is
1801
+ # restricted to (^[a-z]([a-z0-9-]\\{0,61}[a-z0-9])?$) and must be a maximum of
1802
+ # 63 characters in length. The value must start with a letter and end with a
1803
+ # letter or a number.
1804
+ # @param autonomous_database [::Google::Cloud::OracleDatabase::V1::AutonomousDatabase, ::Hash]
1805
+ # Required. The Autonomous Database being created.
1806
+ # @param request_id [::String]
1807
+ # Optional. An optional ID to identify the request. This value is used to
1808
+ # identify duplicate requests. If you make a request with the same request ID
1809
+ # and the original request is still in progress or completed, the server
1810
+ # ignores the second request. This prevents clients from
1811
+ # accidentally creating duplicate commitments.
1812
+ #
1813
+ # The request ID must be a valid UUID with the exception that zero UUID is
1814
+ # not supported (00000000-0000-0000-0000-000000000000).
1815
+ #
1816
+ # @yield [response, operation] Access the result along with the RPC operation
1817
+ # @yieldparam response [::Gapic::Operation]
1818
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1819
+ #
1820
+ # @return [::Gapic::Operation]
1821
+ #
1822
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1823
+ #
1824
+ # @example Basic example
1825
+ # require "google/cloud/oracle_database/v1"
1826
+ #
1827
+ # # Create a client object. The client can be reused for multiple calls.
1828
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
1829
+ #
1830
+ # # Create a request. To set request fields, pass in keyword arguments.
1831
+ # request = Google::Cloud::OracleDatabase::V1::CreateAutonomousDatabaseRequest.new
1832
+ #
1833
+ # # Call the create_autonomous_database method.
1834
+ # result = client.create_autonomous_database request
1835
+ #
1836
+ # # The returned object is of type Gapic::Operation. You can use it to
1837
+ # # check the status of an operation, cancel it, or wait for results.
1838
+ # # Here is how to wait for a response.
1839
+ # result.wait_until_done! timeout: 60
1840
+ # if result.response?
1841
+ # p result.response
1842
+ # else
1843
+ # puts "No response received."
1844
+ # end
1845
+ #
1846
+ def create_autonomous_database request, options = nil
1847
+ raise ::ArgumentError, "request must be provided" if request.nil?
1848
+
1849
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::CreateAutonomousDatabaseRequest
1850
+
1851
+ # Converts hash and nil to an options object
1852
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1853
+
1854
+ # Customize the options with defaults
1855
+ metadata = @config.rpcs.create_autonomous_database.metadata.to_h
1856
+
1857
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1858
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1859
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1860
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
1861
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1862
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1863
+
1864
+ header_params = {}
1865
+ if request.parent
1866
+ header_params["parent"] = request.parent
1867
+ end
1868
+
1869
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1870
+ metadata[:"x-goog-request-params"] ||= request_params_header
1871
+
1872
+ options.apply_defaults timeout: @config.rpcs.create_autonomous_database.timeout,
1873
+ metadata: metadata,
1874
+ retry_policy: @config.rpcs.create_autonomous_database.retry_policy
1875
+
1876
+ options.apply_defaults timeout: @config.timeout,
1877
+ metadata: @config.metadata,
1878
+ retry_policy: @config.retry_policy
1879
+
1880
+ @oracle_database_stub.call_rpc :create_autonomous_database, request, options: options do |response, operation|
1881
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1882
+ yield response, operation if block_given?
1883
+ throw :response, response
1884
+ end
1885
+ rescue ::GRPC::BadStatus => e
1886
+ raise ::Google::Cloud::Error.from_error(e)
1887
+ end
1888
+
1889
+ ##
1890
+ # Deletes a single Autonomous Database.
1891
+ #
1892
+ # @overload delete_autonomous_database(request, options = nil)
1893
+ # Pass arguments to `delete_autonomous_database` via a request object, either of type
1894
+ # {::Google::Cloud::OracleDatabase::V1::DeleteAutonomousDatabaseRequest} or an equivalent Hash.
1895
+ #
1896
+ # @param request [::Google::Cloud::OracleDatabase::V1::DeleteAutonomousDatabaseRequest, ::Hash]
1897
+ # A request object representing the call parameters. Required. To specify no
1898
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
1899
+ # @param options [::Gapic::CallOptions, ::Hash]
1900
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
1901
+ #
1902
+ # @overload delete_autonomous_database(name: nil, request_id: nil)
1903
+ # Pass arguments to `delete_autonomous_database` via keyword arguments. Note that at
1904
+ # least one keyword argument is required. To specify no parameters, or to keep all
1905
+ # the default parameter values, pass an empty Hash as a request object (see above).
1906
+ #
1907
+ # @param name [::String]
1908
+ # Required. The name of the resource in the following format:
1909
+ # projects/\\{project}/locations/\\{location}/autonomousDatabases/\\{autonomous_database}.
1910
+ # @param request_id [::String]
1911
+ # Optional. An optional ID to identify the request. This value is used to
1912
+ # identify duplicate requests. If you make a request with the same request ID
1913
+ # and the original request is still in progress or completed, the server
1914
+ # ignores the second request. This prevents clients from
1915
+ # accidentally creating duplicate commitments.
1916
+ #
1917
+ # The request ID must be a valid UUID with the exception that zero UUID is
1918
+ # not supported (00000000-0000-0000-0000-000000000000).
1919
+ #
1920
+ # @yield [response, operation] Access the result along with the RPC operation
1921
+ # @yieldparam response [::Gapic::Operation]
1922
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
1923
+ #
1924
+ # @return [::Gapic::Operation]
1925
+ #
1926
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
1927
+ #
1928
+ # @example Basic example
1929
+ # require "google/cloud/oracle_database/v1"
1930
+ #
1931
+ # # Create a client object. The client can be reused for multiple calls.
1932
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
1933
+ #
1934
+ # # Create a request. To set request fields, pass in keyword arguments.
1935
+ # request = Google::Cloud::OracleDatabase::V1::DeleteAutonomousDatabaseRequest.new
1936
+ #
1937
+ # # Call the delete_autonomous_database method.
1938
+ # result = client.delete_autonomous_database request
1939
+ #
1940
+ # # The returned object is of type Gapic::Operation. You can use it to
1941
+ # # check the status of an operation, cancel it, or wait for results.
1942
+ # # Here is how to wait for a response.
1943
+ # result.wait_until_done! timeout: 60
1944
+ # if result.response?
1945
+ # p result.response
1946
+ # else
1947
+ # puts "No response received."
1948
+ # end
1949
+ #
1950
+ def delete_autonomous_database request, options = nil
1951
+ raise ::ArgumentError, "request must be provided" if request.nil?
1952
+
1953
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::DeleteAutonomousDatabaseRequest
1954
+
1955
+ # Converts hash and nil to an options object
1956
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
1957
+
1958
+ # Customize the options with defaults
1959
+ metadata = @config.rpcs.delete_autonomous_database.metadata.to_h
1960
+
1961
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
1962
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
1963
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
1964
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
1965
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
1966
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
1967
+
1968
+ header_params = {}
1969
+ if request.name
1970
+ header_params["name"] = request.name
1971
+ end
1972
+
1973
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
1974
+ metadata[:"x-goog-request-params"] ||= request_params_header
1975
+
1976
+ options.apply_defaults timeout: @config.rpcs.delete_autonomous_database.timeout,
1977
+ metadata: metadata,
1978
+ retry_policy: @config.rpcs.delete_autonomous_database.retry_policy
1979
+
1980
+ options.apply_defaults timeout: @config.timeout,
1981
+ metadata: @config.metadata,
1982
+ retry_policy: @config.retry_policy
1983
+
1984
+ @oracle_database_stub.call_rpc :delete_autonomous_database, request, options: options do |response, operation|
1985
+ response = ::Gapic::Operation.new response, @operations_client, options: options
1986
+ yield response, operation if block_given?
1987
+ throw :response, response
1988
+ end
1989
+ rescue ::GRPC::BadStatus => e
1990
+ raise ::Google::Cloud::Error.from_error(e)
1991
+ end
1992
+
1993
+ ##
1994
+ # Restores a single Autonomous Database.
1995
+ #
1996
+ # @overload restore_autonomous_database(request, options = nil)
1997
+ # Pass arguments to `restore_autonomous_database` via a request object, either of type
1998
+ # {::Google::Cloud::OracleDatabase::V1::RestoreAutonomousDatabaseRequest} or an equivalent Hash.
1999
+ #
2000
+ # @param request [::Google::Cloud::OracleDatabase::V1::RestoreAutonomousDatabaseRequest, ::Hash]
2001
+ # A request object representing the call parameters. Required. To specify no
2002
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2003
+ # @param options [::Gapic::CallOptions, ::Hash]
2004
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2005
+ #
2006
+ # @overload restore_autonomous_database(name: nil, restore_time: nil)
2007
+ # Pass arguments to `restore_autonomous_database` via keyword arguments. Note that at
2008
+ # least one keyword argument is required. To specify no parameters, or to keep all
2009
+ # the default parameter values, pass an empty Hash as a request object (see above).
2010
+ #
2011
+ # @param name [::String]
2012
+ # Required. The name of the Autonomous Database in the following format:
2013
+ # projects/\\{project}/locations/\\{location}/autonomousDatabases/\\{autonomous_database}.
2014
+ # @param restore_time [::Google::Protobuf::Timestamp, ::Hash]
2015
+ # Required. The time and date to restore the database to.
2016
+ #
2017
+ # @yield [response, operation] Access the result along with the RPC operation
2018
+ # @yieldparam response [::Gapic::Operation]
2019
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2020
+ #
2021
+ # @return [::Gapic::Operation]
2022
+ #
2023
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2024
+ #
2025
+ # @example Basic example
2026
+ # require "google/cloud/oracle_database/v1"
2027
+ #
2028
+ # # Create a client object. The client can be reused for multiple calls.
2029
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
2030
+ #
2031
+ # # Create a request. To set request fields, pass in keyword arguments.
2032
+ # request = Google::Cloud::OracleDatabase::V1::RestoreAutonomousDatabaseRequest.new
2033
+ #
2034
+ # # Call the restore_autonomous_database method.
2035
+ # result = client.restore_autonomous_database request
2036
+ #
2037
+ # # The returned object is of type Gapic::Operation. You can use it to
2038
+ # # check the status of an operation, cancel it, or wait for results.
2039
+ # # Here is how to wait for a response.
2040
+ # result.wait_until_done! timeout: 60
2041
+ # if result.response?
2042
+ # p result.response
2043
+ # else
2044
+ # puts "No response received."
2045
+ # end
2046
+ #
2047
+ def restore_autonomous_database request, options = nil
2048
+ raise ::ArgumentError, "request must be provided" if request.nil?
2049
+
2050
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::RestoreAutonomousDatabaseRequest
2051
+
2052
+ # Converts hash and nil to an options object
2053
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2054
+
2055
+ # Customize the options with defaults
2056
+ metadata = @config.rpcs.restore_autonomous_database.metadata.to_h
2057
+
2058
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2059
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2060
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2061
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
2062
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2063
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2064
+
2065
+ header_params = {}
2066
+ if request.name
2067
+ header_params["name"] = request.name
2068
+ end
2069
+
2070
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2071
+ metadata[:"x-goog-request-params"] ||= request_params_header
2072
+
2073
+ options.apply_defaults timeout: @config.rpcs.restore_autonomous_database.timeout,
2074
+ metadata: metadata,
2075
+ retry_policy: @config.rpcs.restore_autonomous_database.retry_policy
2076
+
2077
+ options.apply_defaults timeout: @config.timeout,
2078
+ metadata: @config.metadata,
2079
+ retry_policy: @config.retry_policy
2080
+
2081
+ @oracle_database_stub.call_rpc :restore_autonomous_database, request, options: options do |response, operation|
2082
+ response = ::Gapic::Operation.new response, @operations_client, options: options
2083
+ yield response, operation if block_given?
2084
+ throw :response, response
2085
+ end
2086
+ rescue ::GRPC::BadStatus => e
2087
+ raise ::Google::Cloud::Error.from_error(e)
2088
+ end
2089
+
2090
+ ##
2091
+ # Generates a wallet for an Autonomous Database.
2092
+ #
2093
+ # @overload generate_autonomous_database_wallet(request, options = nil)
2094
+ # Pass arguments to `generate_autonomous_database_wallet` via a request object, either of type
2095
+ # {::Google::Cloud::OracleDatabase::V1::GenerateAutonomousDatabaseWalletRequest} or an equivalent Hash.
2096
+ #
2097
+ # @param request [::Google::Cloud::OracleDatabase::V1::GenerateAutonomousDatabaseWalletRequest, ::Hash]
2098
+ # A request object representing the call parameters. Required. To specify no
2099
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2100
+ # @param options [::Gapic::CallOptions, ::Hash]
2101
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2102
+ #
2103
+ # @overload generate_autonomous_database_wallet(name: nil, type: nil, is_regional: nil, password: nil)
2104
+ # Pass arguments to `generate_autonomous_database_wallet` via keyword arguments. Note that at
2105
+ # least one keyword argument is required. To specify no parameters, or to keep all
2106
+ # the default parameter values, pass an empty Hash as a request object (see above).
2107
+ #
2108
+ # @param name [::String]
2109
+ # Required. The name of the Autonomous Database in the following format:
2110
+ # projects/\\{project}/locations/\\{location}/autonomousDatabases/\\{autonomous_database}.
2111
+ # @param type [::Google::Cloud::OracleDatabase::V1::GenerateType]
2112
+ # Optional. The type of wallet generation for the Autonomous Database. The
2113
+ # default value is SINGLE.
2114
+ # @param is_regional [::Boolean]
2115
+ # Optional. True when requesting regional connection strings in PDB connect
2116
+ # info, applicable to cross-region Data Guard only.
2117
+ # @param password [::String]
2118
+ # Required. The password used to encrypt the keys inside the wallet. The
2119
+ # password must be a minimum of 8 characters.
2120
+ #
2121
+ # @yield [response, operation] Access the result along with the RPC operation
2122
+ # @yieldparam response [::Google::Cloud::OracleDatabase::V1::GenerateAutonomousDatabaseWalletResponse]
2123
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2124
+ #
2125
+ # @return [::Google::Cloud::OracleDatabase::V1::GenerateAutonomousDatabaseWalletResponse]
2126
+ #
2127
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2128
+ #
2129
+ # @example Basic example
2130
+ # require "google/cloud/oracle_database/v1"
2131
+ #
2132
+ # # Create a client object. The client can be reused for multiple calls.
2133
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
2134
+ #
2135
+ # # Create a request. To set request fields, pass in keyword arguments.
2136
+ # request = Google::Cloud::OracleDatabase::V1::GenerateAutonomousDatabaseWalletRequest.new
2137
+ #
2138
+ # # Call the generate_autonomous_database_wallet method.
2139
+ # result = client.generate_autonomous_database_wallet request
2140
+ #
2141
+ # # The returned object is of type Google::Cloud::OracleDatabase::V1::GenerateAutonomousDatabaseWalletResponse.
2142
+ # p result
2143
+ #
2144
+ def generate_autonomous_database_wallet request, options = nil
2145
+ raise ::ArgumentError, "request must be provided" if request.nil?
2146
+
2147
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::GenerateAutonomousDatabaseWalletRequest
2148
+
2149
+ # Converts hash and nil to an options object
2150
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2151
+
2152
+ # Customize the options with defaults
2153
+ metadata = @config.rpcs.generate_autonomous_database_wallet.metadata.to_h
2154
+
2155
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2156
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2157
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2158
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
2159
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2160
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2161
+
2162
+ header_params = {}
2163
+ if request.name
2164
+ header_params["name"] = request.name
2165
+ end
2166
+
2167
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2168
+ metadata[:"x-goog-request-params"] ||= request_params_header
2169
+
2170
+ options.apply_defaults timeout: @config.rpcs.generate_autonomous_database_wallet.timeout,
2171
+ metadata: metadata,
2172
+ retry_policy: @config.rpcs.generate_autonomous_database_wallet.retry_policy
2173
+
2174
+ options.apply_defaults timeout: @config.timeout,
2175
+ metadata: @config.metadata,
2176
+ retry_policy: @config.retry_policy
2177
+
2178
+ @oracle_database_stub.call_rpc :generate_autonomous_database_wallet, request, options: options do |response, operation|
2179
+ yield response, operation if block_given?
2180
+ end
2181
+ rescue ::GRPC::BadStatus => e
2182
+ raise ::Google::Cloud::Error.from_error(e)
2183
+ end
2184
+
2185
+ ##
2186
+ # Lists all the available Autonomous Database versions for a project and
2187
+ # location.
2188
+ #
2189
+ # @overload list_autonomous_db_versions(request, options = nil)
2190
+ # Pass arguments to `list_autonomous_db_versions` via a request object, either of type
2191
+ # {::Google::Cloud::OracleDatabase::V1::ListAutonomousDbVersionsRequest} or an equivalent Hash.
2192
+ #
2193
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListAutonomousDbVersionsRequest, ::Hash]
2194
+ # A request object representing the call parameters. Required. To specify no
2195
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2196
+ # @param options [::Gapic::CallOptions, ::Hash]
2197
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2198
+ #
2199
+ # @overload list_autonomous_db_versions(parent: nil, page_size: nil, page_token: nil)
2200
+ # Pass arguments to `list_autonomous_db_versions` via keyword arguments. Note that at
2201
+ # least one keyword argument is required. To specify no parameters, or to keep all
2202
+ # the default parameter values, pass an empty Hash as a request object (see above).
2203
+ #
2204
+ # @param parent [::String]
2205
+ # Required. The parent value for the Autonomous Database in the following
2206
+ # format: projects/\\{project}/locations/\\{location}.
2207
+ # @param page_size [::Integer]
2208
+ # Optional. The maximum number of items to return.
2209
+ # If unspecified, at most 50 Autonomous DB Versions will be returned.
2210
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
2211
+ # @param page_token [::String]
2212
+ # Optional. A token identifying a page of results the server should return.
2213
+ #
2214
+ # @yield [response, operation] Access the result along with the RPC operation
2215
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::AutonomousDbVersion>]
2216
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2217
+ #
2218
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::AutonomousDbVersion>]
2219
+ #
2220
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2221
+ #
2222
+ # @example Basic example
2223
+ # require "google/cloud/oracle_database/v1"
2224
+ #
2225
+ # # Create a client object. The client can be reused for multiple calls.
2226
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
2227
+ #
2228
+ # # Create a request. To set request fields, pass in keyword arguments.
2229
+ # request = Google::Cloud::OracleDatabase::V1::ListAutonomousDbVersionsRequest.new
2230
+ #
2231
+ # # Call the list_autonomous_db_versions method.
2232
+ # result = client.list_autonomous_db_versions request
2233
+ #
2234
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2235
+ # # over elements, and API calls will be issued to fetch pages as needed.
2236
+ # result.each do |item|
2237
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::AutonomousDbVersion.
2238
+ # p item
2239
+ # end
2240
+ #
2241
+ def list_autonomous_db_versions request, options = nil
2242
+ raise ::ArgumentError, "request must be provided" if request.nil?
2243
+
2244
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListAutonomousDbVersionsRequest
2245
+
2246
+ # Converts hash and nil to an options object
2247
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2248
+
2249
+ # Customize the options with defaults
2250
+ metadata = @config.rpcs.list_autonomous_db_versions.metadata.to_h
2251
+
2252
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2253
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2254
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2255
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
2256
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2257
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2258
+
2259
+ header_params = {}
2260
+ if request.parent
2261
+ header_params["parent"] = request.parent
2262
+ end
2263
+
2264
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2265
+ metadata[:"x-goog-request-params"] ||= request_params_header
2266
+
2267
+ options.apply_defaults timeout: @config.rpcs.list_autonomous_db_versions.timeout,
2268
+ metadata: metadata,
2269
+ retry_policy: @config.rpcs.list_autonomous_db_versions.retry_policy
2270
+
2271
+ options.apply_defaults timeout: @config.timeout,
2272
+ metadata: @config.metadata,
2273
+ retry_policy: @config.retry_policy
2274
+
2275
+ @oracle_database_stub.call_rpc :list_autonomous_db_versions, request, options: options do |response, operation|
2276
+ response = ::Gapic::PagedEnumerable.new @oracle_database_stub, :list_autonomous_db_versions, request, response, operation, options
2277
+ yield response, operation if block_given?
2278
+ throw :response, response
2279
+ end
2280
+ rescue ::GRPC::BadStatus => e
2281
+ raise ::Google::Cloud::Error.from_error(e)
2282
+ end
2283
+
2284
+ ##
2285
+ # Lists Autonomous Database Character Sets in a given project and location.
2286
+ #
2287
+ # @overload list_autonomous_database_character_sets(request, options = nil)
2288
+ # Pass arguments to `list_autonomous_database_character_sets` via a request object, either of type
2289
+ # {::Google::Cloud::OracleDatabase::V1::ListAutonomousDatabaseCharacterSetsRequest} or an equivalent Hash.
2290
+ #
2291
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListAutonomousDatabaseCharacterSetsRequest, ::Hash]
2292
+ # A request object representing the call parameters. Required. To specify no
2293
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2294
+ # @param options [::Gapic::CallOptions, ::Hash]
2295
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2296
+ #
2297
+ # @overload list_autonomous_database_character_sets(parent: nil, page_size: nil, page_token: nil, filter: nil)
2298
+ # Pass arguments to `list_autonomous_database_character_sets` via keyword arguments. Note that at
2299
+ # least one keyword argument is required. To specify no parameters, or to keep all
2300
+ # the default parameter values, pass an empty Hash as a request object (see above).
2301
+ #
2302
+ # @param parent [::String]
2303
+ # Required. The parent value for the Autonomous Database in the following
2304
+ # format: projects/\\{project}/locations/\\{location}.
2305
+ # @param page_size [::Integer]
2306
+ # Optional. The maximum number of items to return.
2307
+ # If unspecified, at most 50 Autonomous DB Character Sets will be returned.
2308
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
2309
+ # @param page_token [::String]
2310
+ # Optional. A token identifying a page of results the server should return.
2311
+ # @param filter [::String]
2312
+ # Optional. An expression for filtering the results of the request. Only the
2313
+ # **character_set_type** field is supported in the following format:
2314
+ # `character_set_type="{characterSetType}"`. Accepted values include
2315
+ # `DATABASE` and `NATIONAL`.
2316
+ #
2317
+ # @yield [response, operation] Access the result along with the RPC operation
2318
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::AutonomousDatabaseCharacterSet>]
2319
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2320
+ #
2321
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::AutonomousDatabaseCharacterSet>]
2322
+ #
2323
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2324
+ #
2325
+ # @example Basic example
2326
+ # require "google/cloud/oracle_database/v1"
2327
+ #
2328
+ # # Create a client object. The client can be reused for multiple calls.
2329
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
2330
+ #
2331
+ # # Create a request. To set request fields, pass in keyword arguments.
2332
+ # request = Google::Cloud::OracleDatabase::V1::ListAutonomousDatabaseCharacterSetsRequest.new
2333
+ #
2334
+ # # Call the list_autonomous_database_character_sets method.
2335
+ # result = client.list_autonomous_database_character_sets request
2336
+ #
2337
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2338
+ # # over elements, and API calls will be issued to fetch pages as needed.
2339
+ # result.each do |item|
2340
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::AutonomousDatabaseCharacterSet.
2341
+ # p item
2342
+ # end
2343
+ #
2344
+ def list_autonomous_database_character_sets request, options = nil
2345
+ raise ::ArgumentError, "request must be provided" if request.nil?
2346
+
2347
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListAutonomousDatabaseCharacterSetsRequest
2348
+
2349
+ # Converts hash and nil to an options object
2350
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2351
+
2352
+ # Customize the options with defaults
2353
+ metadata = @config.rpcs.list_autonomous_database_character_sets.metadata.to_h
2354
+
2355
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2356
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2357
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2358
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
2359
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2360
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2361
+
2362
+ header_params = {}
2363
+ if request.parent
2364
+ header_params["parent"] = request.parent
2365
+ end
2366
+
2367
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2368
+ metadata[:"x-goog-request-params"] ||= request_params_header
2369
+
2370
+ options.apply_defaults timeout: @config.rpcs.list_autonomous_database_character_sets.timeout,
2371
+ metadata: metadata,
2372
+ retry_policy: @config.rpcs.list_autonomous_database_character_sets.retry_policy
2373
+
2374
+ options.apply_defaults timeout: @config.timeout,
2375
+ metadata: @config.metadata,
2376
+ retry_policy: @config.retry_policy
2377
+
2378
+ @oracle_database_stub.call_rpc :list_autonomous_database_character_sets, request, options: options do |response, operation|
2379
+ response = ::Gapic::PagedEnumerable.new @oracle_database_stub, :list_autonomous_database_character_sets, request, response, operation, options
2380
+ yield response, operation if block_given?
2381
+ throw :response, response
2382
+ end
2383
+ rescue ::GRPC::BadStatus => e
2384
+ raise ::Google::Cloud::Error.from_error(e)
2385
+ end
2386
+
2387
+ ##
2388
+ # Lists the long-term and automatic backups of an Autonomous Database.
2389
+ #
2390
+ # @overload list_autonomous_database_backups(request, options = nil)
2391
+ # Pass arguments to `list_autonomous_database_backups` via a request object, either of type
2392
+ # {::Google::Cloud::OracleDatabase::V1::ListAutonomousDatabaseBackupsRequest} or an equivalent Hash.
2393
+ #
2394
+ # @param request [::Google::Cloud::OracleDatabase::V1::ListAutonomousDatabaseBackupsRequest, ::Hash]
2395
+ # A request object representing the call parameters. Required. To specify no
2396
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2397
+ # @param options [::Gapic::CallOptions, ::Hash]
2398
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2399
+ #
2400
+ # @overload list_autonomous_database_backups(parent: nil, filter: nil, page_size: nil, page_token: nil)
2401
+ # Pass arguments to `list_autonomous_database_backups` via keyword arguments. Note that at
2402
+ # least one keyword argument is required. To specify no parameters, or to keep all
2403
+ # the default parameter values, pass an empty Hash as a request object (see above).
2404
+ #
2405
+ # @param parent [::String]
2406
+ # Required. The parent value for ListAutonomousDatabaseBackups in the
2407
+ # following format: projects/\\{project}/locations/\\{location}.
2408
+ # @param filter [::String]
2409
+ # Optional. An expression for filtering the results of the request. Only the
2410
+ # **autonomous_database_id** field is supported in the following format:
2411
+ # `autonomous_database_id="{autonomous_database_id}"`. The accepted values
2412
+ # must be a valid Autonomous Database ID, limited to the naming
2413
+ # restrictions of the ID: ^[a-z]([a-z0-9-]\\{0,61}[a-z0-9])?$).
2414
+ # The ID must start with a letter, end with a letter or a number, and be
2415
+ # a maximum of 63 characters.
2416
+ # @param page_size [::Integer]
2417
+ # Optional. The maximum number of items to return.
2418
+ # If unspecified, at most 50 Autonomous DB Backups will be returned.
2419
+ # The maximum value is 1000; values above 1000 will be coerced to 1000.
2420
+ # @param page_token [::String]
2421
+ # Optional. A token identifying a page of results the server should return.
2422
+ #
2423
+ # @yield [response, operation] Access the result along with the RPC operation
2424
+ # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::AutonomousDatabaseBackup>]
2425
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2426
+ #
2427
+ # @return [::Gapic::PagedEnumerable<::Google::Cloud::OracleDatabase::V1::AutonomousDatabaseBackup>]
2428
+ #
2429
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2430
+ #
2431
+ # @example Basic example
2432
+ # require "google/cloud/oracle_database/v1"
2433
+ #
2434
+ # # Create a client object. The client can be reused for multiple calls.
2435
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
2436
+ #
2437
+ # # Create a request. To set request fields, pass in keyword arguments.
2438
+ # request = Google::Cloud::OracleDatabase::V1::ListAutonomousDatabaseBackupsRequest.new
2439
+ #
2440
+ # # Call the list_autonomous_database_backups method.
2441
+ # result = client.list_autonomous_database_backups request
2442
+ #
2443
+ # # The returned object is of type Gapic::PagedEnumerable. You can iterate
2444
+ # # over elements, and API calls will be issued to fetch pages as needed.
2445
+ # result.each do |item|
2446
+ # # Each element is of type ::Google::Cloud::OracleDatabase::V1::AutonomousDatabaseBackup.
2447
+ # p item
2448
+ # end
2449
+ #
2450
+ def list_autonomous_database_backups request, options = nil
2451
+ raise ::ArgumentError, "request must be provided" if request.nil?
2452
+
2453
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::ListAutonomousDatabaseBackupsRequest
2454
+
2455
+ # Converts hash and nil to an options object
2456
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2457
+
2458
+ # Customize the options with defaults
2459
+ metadata = @config.rpcs.list_autonomous_database_backups.metadata.to_h
2460
+
2461
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2462
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2463
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2464
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
2465
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2466
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2467
+
2468
+ header_params = {}
2469
+ if request.parent
2470
+ header_params["parent"] = request.parent
2471
+ end
2472
+
2473
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2474
+ metadata[:"x-goog-request-params"] ||= request_params_header
2475
+
2476
+ options.apply_defaults timeout: @config.rpcs.list_autonomous_database_backups.timeout,
2477
+ metadata: metadata,
2478
+ retry_policy: @config.rpcs.list_autonomous_database_backups.retry_policy
2479
+
2480
+ options.apply_defaults timeout: @config.timeout,
2481
+ metadata: @config.metadata,
2482
+ retry_policy: @config.retry_policy
2483
+
2484
+ @oracle_database_stub.call_rpc :list_autonomous_database_backups, request, options: options do |response, operation|
2485
+ response = ::Gapic::PagedEnumerable.new @oracle_database_stub, :list_autonomous_database_backups, request, response, operation, options
2486
+ yield response, operation if block_given?
2487
+ throw :response, response
2488
+ end
2489
+ rescue ::GRPC::BadStatus => e
2490
+ raise ::Google::Cloud::Error.from_error(e)
2491
+ end
2492
+
2493
+ ##
2494
+ # Stops an Autonomous Database.
2495
+ #
2496
+ # @overload stop_autonomous_database(request, options = nil)
2497
+ # Pass arguments to `stop_autonomous_database` via a request object, either of type
2498
+ # {::Google::Cloud::OracleDatabase::V1::StopAutonomousDatabaseRequest} or an equivalent Hash.
2499
+ #
2500
+ # @param request [::Google::Cloud::OracleDatabase::V1::StopAutonomousDatabaseRequest, ::Hash]
2501
+ # A request object representing the call parameters. Required. To specify no
2502
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2503
+ # @param options [::Gapic::CallOptions, ::Hash]
2504
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2505
+ #
2506
+ # @overload stop_autonomous_database(name: nil)
2507
+ # Pass arguments to `stop_autonomous_database` via keyword arguments. Note that at
2508
+ # least one keyword argument is required. To specify no parameters, or to keep all
2509
+ # the default parameter values, pass an empty Hash as a request object (see above).
2510
+ #
2511
+ # @param name [::String]
2512
+ # Required. The name of the Autonomous Database in the following format:
2513
+ # projects/\\{project}/locations/\\{location}/autonomousDatabases/\\{autonomous_database}.
2514
+ #
2515
+ # @yield [response, operation] Access the result along with the RPC operation
2516
+ # @yieldparam response [::Gapic::Operation]
2517
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2518
+ #
2519
+ # @return [::Gapic::Operation]
2520
+ #
2521
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2522
+ #
2523
+ # @example Basic example
2524
+ # require "google/cloud/oracle_database/v1"
2525
+ #
2526
+ # # Create a client object. The client can be reused for multiple calls.
2527
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
2528
+ #
2529
+ # # Create a request. To set request fields, pass in keyword arguments.
2530
+ # request = Google::Cloud::OracleDatabase::V1::StopAutonomousDatabaseRequest.new
2531
+ #
2532
+ # # Call the stop_autonomous_database method.
2533
+ # result = client.stop_autonomous_database request
2534
+ #
2535
+ # # The returned object is of type Gapic::Operation. You can use it to
2536
+ # # check the status of an operation, cancel it, or wait for results.
2537
+ # # Here is how to wait for a response.
2538
+ # result.wait_until_done! timeout: 60
2539
+ # if result.response?
2540
+ # p result.response
2541
+ # else
2542
+ # puts "No response received."
2543
+ # end
2544
+ #
2545
+ def stop_autonomous_database request, options = nil
2546
+ raise ::ArgumentError, "request must be provided" if request.nil?
2547
+
2548
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::StopAutonomousDatabaseRequest
2549
+
2550
+ # Converts hash and nil to an options object
2551
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2552
+
2553
+ # Customize the options with defaults
2554
+ metadata = @config.rpcs.stop_autonomous_database.metadata.to_h
2555
+
2556
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2557
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2558
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2559
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
2560
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2561
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2562
+
2563
+ header_params = {}
2564
+ if request.name
2565
+ header_params["name"] = request.name
2566
+ end
2567
+
2568
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2569
+ metadata[:"x-goog-request-params"] ||= request_params_header
2570
+
2571
+ options.apply_defaults timeout: @config.rpcs.stop_autonomous_database.timeout,
2572
+ metadata: metadata,
2573
+ retry_policy: @config.rpcs.stop_autonomous_database.retry_policy
2574
+
2575
+ options.apply_defaults timeout: @config.timeout,
2576
+ metadata: @config.metadata,
2577
+ retry_policy: @config.retry_policy
2578
+
2579
+ @oracle_database_stub.call_rpc :stop_autonomous_database, request, options: options do |response, operation|
2580
+ response = ::Gapic::Operation.new response, @operations_client, options: options
2581
+ yield response, operation if block_given?
2582
+ throw :response, response
2583
+ end
2584
+ rescue ::GRPC::BadStatus => e
2585
+ raise ::Google::Cloud::Error.from_error(e)
2586
+ end
2587
+
2588
+ ##
2589
+ # Starts an Autonomous Database.
2590
+ #
2591
+ # @overload start_autonomous_database(request, options = nil)
2592
+ # Pass arguments to `start_autonomous_database` via a request object, either of type
2593
+ # {::Google::Cloud::OracleDatabase::V1::StartAutonomousDatabaseRequest} or an equivalent Hash.
2594
+ #
2595
+ # @param request [::Google::Cloud::OracleDatabase::V1::StartAutonomousDatabaseRequest, ::Hash]
2596
+ # A request object representing the call parameters. Required. To specify no
2597
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2598
+ # @param options [::Gapic::CallOptions, ::Hash]
2599
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2600
+ #
2601
+ # @overload start_autonomous_database(name: nil)
2602
+ # Pass arguments to `start_autonomous_database` via keyword arguments. Note that at
2603
+ # least one keyword argument is required. To specify no parameters, or to keep all
2604
+ # the default parameter values, pass an empty Hash as a request object (see above).
2605
+ #
2606
+ # @param name [::String]
2607
+ # Required. The name of the Autonomous Database in the following format:
2608
+ # projects/\\{project}/locations/\\{location}/autonomousDatabases/\\{autonomous_database}.
2609
+ #
2610
+ # @yield [response, operation] Access the result along with the RPC operation
2611
+ # @yieldparam response [::Gapic::Operation]
2612
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2613
+ #
2614
+ # @return [::Gapic::Operation]
2615
+ #
2616
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2617
+ #
2618
+ # @example Basic example
2619
+ # require "google/cloud/oracle_database/v1"
2620
+ #
2621
+ # # Create a client object. The client can be reused for multiple calls.
2622
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
2623
+ #
2624
+ # # Create a request. To set request fields, pass in keyword arguments.
2625
+ # request = Google::Cloud::OracleDatabase::V1::StartAutonomousDatabaseRequest.new
2626
+ #
2627
+ # # Call the start_autonomous_database method.
2628
+ # result = client.start_autonomous_database request
2629
+ #
2630
+ # # The returned object is of type Gapic::Operation. You can use it to
2631
+ # # check the status of an operation, cancel it, or wait for results.
2632
+ # # Here is how to wait for a response.
2633
+ # result.wait_until_done! timeout: 60
2634
+ # if result.response?
2635
+ # p result.response
2636
+ # else
2637
+ # puts "No response received."
2638
+ # end
2639
+ #
2640
+ def start_autonomous_database request, options = nil
2641
+ raise ::ArgumentError, "request must be provided" if request.nil?
2642
+
2643
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::StartAutonomousDatabaseRequest
2644
+
2645
+ # Converts hash and nil to an options object
2646
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2647
+
2648
+ # Customize the options with defaults
2649
+ metadata = @config.rpcs.start_autonomous_database.metadata.to_h
2650
+
2651
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2652
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2653
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2654
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
2655
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2656
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2657
+
2658
+ header_params = {}
2659
+ if request.name
2660
+ header_params["name"] = request.name
2661
+ end
2662
+
2663
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2664
+ metadata[:"x-goog-request-params"] ||= request_params_header
2665
+
2666
+ options.apply_defaults timeout: @config.rpcs.start_autonomous_database.timeout,
2667
+ metadata: metadata,
2668
+ retry_policy: @config.rpcs.start_autonomous_database.retry_policy
2669
+
2670
+ options.apply_defaults timeout: @config.timeout,
2671
+ metadata: @config.metadata,
2672
+ retry_policy: @config.retry_policy
2673
+
2674
+ @oracle_database_stub.call_rpc :start_autonomous_database, request, options: options do |response, operation|
2675
+ response = ::Gapic::Operation.new response, @operations_client, options: options
2676
+ yield response, operation if block_given?
2677
+ throw :response, response
2678
+ end
2679
+ rescue ::GRPC::BadStatus => e
2680
+ raise ::Google::Cloud::Error.from_error(e)
2681
+ end
2682
+
2683
+ ##
2684
+ # Restarts an Autonomous Database.
2685
+ #
2686
+ # @overload restart_autonomous_database(request, options = nil)
2687
+ # Pass arguments to `restart_autonomous_database` via a request object, either of type
2688
+ # {::Google::Cloud::OracleDatabase::V1::RestartAutonomousDatabaseRequest} or an equivalent Hash.
2689
+ #
2690
+ # @param request [::Google::Cloud::OracleDatabase::V1::RestartAutonomousDatabaseRequest, ::Hash]
2691
+ # A request object representing the call parameters. Required. To specify no
2692
+ # parameters, or to keep all the default parameter values, pass an empty Hash.
2693
+ # @param options [::Gapic::CallOptions, ::Hash]
2694
+ # Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
2695
+ #
2696
+ # @overload restart_autonomous_database(name: nil)
2697
+ # Pass arguments to `restart_autonomous_database` via keyword arguments. Note that at
2698
+ # least one keyword argument is required. To specify no parameters, or to keep all
2699
+ # the default parameter values, pass an empty Hash as a request object (see above).
2700
+ #
2701
+ # @param name [::String]
2702
+ # Required. The name of the Autonomous Database in the following format:
2703
+ # projects/\\{project}/locations/\\{location}/autonomousDatabases/\\{autonomous_database}.
2704
+ #
2705
+ # @yield [response, operation] Access the result along with the RPC operation
2706
+ # @yieldparam response [::Gapic::Operation]
2707
+ # @yieldparam operation [::GRPC::ActiveCall::Operation]
2708
+ #
2709
+ # @return [::Gapic::Operation]
2710
+ #
2711
+ # @raise [::Google::Cloud::Error] if the RPC is aborted.
2712
+ #
2713
+ # @example Basic example
2714
+ # require "google/cloud/oracle_database/v1"
2715
+ #
2716
+ # # Create a client object. The client can be reused for multiple calls.
2717
+ # client = Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new
2718
+ #
2719
+ # # Create a request. To set request fields, pass in keyword arguments.
2720
+ # request = Google::Cloud::OracleDatabase::V1::RestartAutonomousDatabaseRequest.new
2721
+ #
2722
+ # # Call the restart_autonomous_database method.
2723
+ # result = client.restart_autonomous_database request
2724
+ #
2725
+ # # The returned object is of type Gapic::Operation. You can use it to
2726
+ # # check the status of an operation, cancel it, or wait for results.
2727
+ # # Here is how to wait for a response.
2728
+ # result.wait_until_done! timeout: 60
2729
+ # if result.response?
2730
+ # p result.response
2731
+ # else
2732
+ # puts "No response received."
2733
+ # end
2734
+ #
2735
+ def restart_autonomous_database request, options = nil
2736
+ raise ::ArgumentError, "request must be provided" if request.nil?
2737
+
2738
+ request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::OracleDatabase::V1::RestartAutonomousDatabaseRequest
2739
+
2740
+ # Converts hash and nil to an options object
2741
+ options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
2742
+
2743
+ # Customize the options with defaults
2744
+ metadata = @config.rpcs.restart_autonomous_database.metadata.to_h
2745
+
2746
+ # Set x-goog-api-client, x-goog-user-project and x-goog-api-version headers
2747
+ metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
2748
+ lib_name: @config.lib_name, lib_version: @config.lib_version,
2749
+ gapic_version: ::Google::Cloud::OracleDatabase::V1::VERSION
2750
+ metadata[:"x-goog-api-version"] = API_VERSION unless API_VERSION.empty?
2751
+ metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
2752
+
2753
+ header_params = {}
2754
+ if request.name
2755
+ header_params["name"] = request.name
2756
+ end
2757
+
2758
+ request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
2759
+ metadata[:"x-goog-request-params"] ||= request_params_header
2760
+
2761
+ options.apply_defaults timeout: @config.rpcs.restart_autonomous_database.timeout,
2762
+ metadata: metadata,
2763
+ retry_policy: @config.rpcs.restart_autonomous_database.retry_policy
2764
+
2765
+ options.apply_defaults timeout: @config.timeout,
2766
+ metadata: @config.metadata,
2767
+ retry_policy: @config.retry_policy
2768
+
2769
+ @oracle_database_stub.call_rpc :restart_autonomous_database, request, options: options do |response, operation|
2770
+ response = ::Gapic::Operation.new response, @operations_client, options: options
2771
+ yield response, operation if block_given?
2772
+ throw :response, response
2773
+ end
2774
+ rescue ::GRPC::BadStatus => e
2775
+ raise ::Google::Cloud::Error.from_error(e)
2776
+ end
2777
+
2778
+ ##
2779
+ # Configuration class for the OracleDatabase API.
2780
+ #
2781
+ # This class represents the configuration for OracleDatabase,
2782
+ # providing control over timeouts, retry behavior, logging, transport
2783
+ # parameters, and other low-level controls. Certain parameters can also be
2784
+ # applied individually to specific RPCs. See
2785
+ # {::Google::Cloud::OracleDatabase::V1::OracleDatabase::Client::Configuration::Rpcs}
2786
+ # for a list of RPCs that can be configured independently.
2787
+ #
2788
+ # Configuration can be applied globally to all clients, or to a single client
2789
+ # on construction.
2790
+ #
2791
+ # @example
2792
+ #
2793
+ # # Modify the global config, setting the timeout for
2794
+ # # list_cloud_exadata_infrastructures to 20 seconds,
2795
+ # # and all remaining timeouts to 10 seconds.
2796
+ # ::Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.configure do |config|
2797
+ # config.timeout = 10.0
2798
+ # config.rpcs.list_cloud_exadata_infrastructures.timeout = 20.0
2799
+ # end
2800
+ #
2801
+ # # Apply the above configuration only to a new client.
2802
+ # client = ::Google::Cloud::OracleDatabase::V1::OracleDatabase::Client.new do |config|
2803
+ # config.timeout = 10.0
2804
+ # config.rpcs.list_cloud_exadata_infrastructures.timeout = 20.0
2805
+ # end
2806
+ #
2807
+ # @!attribute [rw] endpoint
2808
+ # A custom service endpoint, as a hostname or hostname:port. The default is
2809
+ # nil, indicating to use the default endpoint in the current universe domain.
2810
+ # @return [::String,nil]
2811
+ # @!attribute [rw] credentials
2812
+ # Credentials to send with calls. You may provide any of the following types:
2813
+ # * (`String`) The path to a service account key file in JSON format
2814
+ # * (`Hash`) A service account key as a Hash
2815
+ # * (`Google::Auth::Credentials`) A googleauth credentials object
2816
+ # (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
2817
+ # * (`Signet::OAuth2::Client`) A signet oauth2 client object
2818
+ # (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
2819
+ # * (`GRPC::Core::Channel`) a gRPC channel with included credentials
2820
+ # * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
2821
+ # * (`nil`) indicating no credentials
2822
+ #
2823
+ # Warning: If you accept a credential configuration (JSON file or Hash) from an
2824
+ # external source for authentication to Google Cloud, you must validate it before
2825
+ # providing it to a Google API client library. Providing an unvalidated credential
2826
+ # configuration to Google APIs can compromise the security of your systems and data.
2827
+ # For more information, refer to [Validate credential configurations from external
2828
+ # sources](https://cloud.google.com/docs/authentication/external/externally-sourced-credentials).
2829
+ # @return [::Object]
2830
+ # @!attribute [rw] scope
2831
+ # The OAuth scopes
2832
+ # @return [::Array<::String>]
2833
+ # @!attribute [rw] lib_name
2834
+ # The library name as recorded in instrumentation and logging
2835
+ # @return [::String]
2836
+ # @!attribute [rw] lib_version
2837
+ # The library version as recorded in instrumentation and logging
2838
+ # @return [::String]
2839
+ # @!attribute [rw] channel_args
2840
+ # Extra parameters passed to the gRPC channel. Note: this is ignored if a
2841
+ # `GRPC::Core::Channel` object is provided as the credential.
2842
+ # @return [::Hash]
2843
+ # @!attribute [rw] interceptors
2844
+ # An array of interceptors that are run before calls are executed.
2845
+ # @return [::Array<::GRPC::ClientInterceptor>]
2846
+ # @!attribute [rw] timeout
2847
+ # The call timeout in seconds.
2848
+ # @return [::Numeric]
2849
+ # @!attribute [rw] metadata
2850
+ # Additional gRPC headers to be sent with the call.
2851
+ # @return [::Hash{::Symbol=>::String}]
2852
+ # @!attribute [rw] retry_policy
2853
+ # The retry policy. The value is a hash with the following keys:
2854
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
2855
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
2856
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
2857
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
2858
+ # trigger a retry.
2859
+ # @return [::Hash]
2860
+ # @!attribute [rw] quota_project
2861
+ # A separate project against which to charge quota.
2862
+ # @return [::String]
2863
+ # @!attribute [rw] universe_domain
2864
+ # The universe domain within which to make requests. This determines the
2865
+ # default endpoint URL. The default value of nil uses the environment
2866
+ # universe (usually the default "googleapis.com" universe).
2867
+ # @return [::String,nil]
2868
+ # @!attribute [rw] logger
2869
+ # A custom logger to use for request/response debug logging, or the value
2870
+ # `:default` (the default) to construct a default logger, or `nil` to
2871
+ # explicitly disable logging.
2872
+ # @return [::Logger,:default,nil]
2873
+ #
2874
+ class Configuration
2875
+ extend ::Gapic::Config
2876
+
2877
+ # @private
2878
+ # The endpoint specific to the default "googleapis.com" universe. Deprecated.
2879
+ DEFAULT_ENDPOINT = "oracledatabase.googleapis.com"
2880
+
2881
+ config_attr :endpoint, nil, ::String, nil
2882
+ config_attr :credentials, nil do |value|
2883
+ allowed = [::String, ::Hash, ::Proc, ::Symbol, ::Google::Auth::Credentials, ::Google::Auth::BaseClient, ::Signet::OAuth2::Client, nil]
2884
+ allowed += [::GRPC::Core::Channel, ::GRPC::Core::ChannelCredentials] if defined? ::GRPC::Core::Channel
2885
+ allowed.any? { |klass| klass === value }
2886
+ end
2887
+ config_attr :scope, nil, ::String, ::Array, nil
2888
+ config_attr :lib_name, nil, ::String, nil
2889
+ config_attr :lib_version, nil, ::String, nil
2890
+ config_attr(:channel_args, { "grpc.service_config_disable_resolution" => 1 }, ::Hash, nil)
2891
+ config_attr :interceptors, nil, ::Array, nil
2892
+ config_attr :timeout, nil, ::Numeric, nil
2893
+ config_attr :metadata, nil, ::Hash, nil
2894
+ config_attr :retry_policy, nil, ::Hash, ::Proc, nil
2895
+ config_attr :quota_project, nil, ::String, nil
2896
+ config_attr :universe_domain, nil, ::String, nil
2897
+ config_attr :logger, :default, ::Logger, nil, :default
2898
+
2899
+ # @private
2900
+ def initialize parent_config = nil
2901
+ @parent_config = parent_config unless parent_config.nil?
2902
+
2903
+ yield self if block_given?
2904
+ end
2905
+
2906
+ ##
2907
+ # Configurations for individual RPCs
2908
+ # @return [Rpcs]
2909
+ #
2910
+ def rpcs
2911
+ @rpcs ||= begin
2912
+ parent_rpcs = nil
2913
+ parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config.respond_to?(:rpcs)
2914
+ Rpcs.new parent_rpcs
2915
+ end
2916
+ end
2917
+
2918
+ ##
2919
+ # Configuration for the channel pool
2920
+ # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
2921
+ #
2922
+ def channel_pool
2923
+ @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
2924
+ end
2925
+
2926
+ ##
2927
+ # Configuration RPC class for the OracleDatabase API.
2928
+ #
2929
+ # Includes fields providing the configuration for each RPC in this service.
2930
+ # Each configuration object is of type `Gapic::Config::Method` and includes
2931
+ # the following configuration fields:
2932
+ #
2933
+ # * `timeout` (*type:* `Numeric`) - The call timeout in seconds
2934
+ # * `metadata` (*type:* `Hash{Symbol=>String}`) - Additional gRPC headers
2935
+ # * `retry_policy (*type:* `Hash`) - The retry policy. The policy fields
2936
+ # include the following keys:
2937
+ # * `:initial_delay` (*type:* `Numeric`) - The initial delay in seconds.
2938
+ # * `:max_delay` (*type:* `Numeric`) - The max delay in seconds.
2939
+ # * `:multiplier` (*type:* `Numeric`) - The incremental backoff multiplier.
2940
+ # * `:retry_codes` (*type:* `Array<String>`) - The error codes that should
2941
+ # trigger a retry.
2942
+ #
2943
+ class Rpcs
2944
+ ##
2945
+ # RPC-specific configuration for `list_cloud_exadata_infrastructures`
2946
+ # @return [::Gapic::Config::Method]
2947
+ #
2948
+ attr_reader :list_cloud_exadata_infrastructures
2949
+ ##
2950
+ # RPC-specific configuration for `get_cloud_exadata_infrastructure`
2951
+ # @return [::Gapic::Config::Method]
2952
+ #
2953
+ attr_reader :get_cloud_exadata_infrastructure
2954
+ ##
2955
+ # RPC-specific configuration for `create_cloud_exadata_infrastructure`
2956
+ # @return [::Gapic::Config::Method]
2957
+ #
2958
+ attr_reader :create_cloud_exadata_infrastructure
2959
+ ##
2960
+ # RPC-specific configuration for `delete_cloud_exadata_infrastructure`
2961
+ # @return [::Gapic::Config::Method]
2962
+ #
2963
+ attr_reader :delete_cloud_exadata_infrastructure
2964
+ ##
2965
+ # RPC-specific configuration for `list_cloud_vm_clusters`
2966
+ # @return [::Gapic::Config::Method]
2967
+ #
2968
+ attr_reader :list_cloud_vm_clusters
2969
+ ##
2970
+ # RPC-specific configuration for `get_cloud_vm_cluster`
2971
+ # @return [::Gapic::Config::Method]
2972
+ #
2973
+ attr_reader :get_cloud_vm_cluster
2974
+ ##
2975
+ # RPC-specific configuration for `create_cloud_vm_cluster`
2976
+ # @return [::Gapic::Config::Method]
2977
+ #
2978
+ attr_reader :create_cloud_vm_cluster
2979
+ ##
2980
+ # RPC-specific configuration for `delete_cloud_vm_cluster`
2981
+ # @return [::Gapic::Config::Method]
2982
+ #
2983
+ attr_reader :delete_cloud_vm_cluster
2984
+ ##
2985
+ # RPC-specific configuration for `list_entitlements`
2986
+ # @return [::Gapic::Config::Method]
2987
+ #
2988
+ attr_reader :list_entitlements
2989
+ ##
2990
+ # RPC-specific configuration for `list_db_servers`
2991
+ # @return [::Gapic::Config::Method]
2992
+ #
2993
+ attr_reader :list_db_servers
2994
+ ##
2995
+ # RPC-specific configuration for `list_db_nodes`
2996
+ # @return [::Gapic::Config::Method]
2997
+ #
2998
+ attr_reader :list_db_nodes
2999
+ ##
3000
+ # RPC-specific configuration for `list_gi_versions`
3001
+ # @return [::Gapic::Config::Method]
3002
+ #
3003
+ attr_reader :list_gi_versions
3004
+ ##
3005
+ # RPC-specific configuration for `list_db_system_shapes`
3006
+ # @return [::Gapic::Config::Method]
3007
+ #
3008
+ attr_reader :list_db_system_shapes
3009
+ ##
3010
+ # RPC-specific configuration for `list_autonomous_databases`
3011
+ # @return [::Gapic::Config::Method]
3012
+ #
3013
+ attr_reader :list_autonomous_databases
3014
+ ##
3015
+ # RPC-specific configuration for `get_autonomous_database`
3016
+ # @return [::Gapic::Config::Method]
3017
+ #
3018
+ attr_reader :get_autonomous_database
3019
+ ##
3020
+ # RPC-specific configuration for `create_autonomous_database`
3021
+ # @return [::Gapic::Config::Method]
3022
+ #
3023
+ attr_reader :create_autonomous_database
3024
+ ##
3025
+ # RPC-specific configuration for `delete_autonomous_database`
3026
+ # @return [::Gapic::Config::Method]
3027
+ #
3028
+ attr_reader :delete_autonomous_database
3029
+ ##
3030
+ # RPC-specific configuration for `restore_autonomous_database`
3031
+ # @return [::Gapic::Config::Method]
3032
+ #
3033
+ attr_reader :restore_autonomous_database
3034
+ ##
3035
+ # RPC-specific configuration for `generate_autonomous_database_wallet`
3036
+ # @return [::Gapic::Config::Method]
3037
+ #
3038
+ attr_reader :generate_autonomous_database_wallet
3039
+ ##
3040
+ # RPC-specific configuration for `list_autonomous_db_versions`
3041
+ # @return [::Gapic::Config::Method]
3042
+ #
3043
+ attr_reader :list_autonomous_db_versions
3044
+ ##
3045
+ # RPC-specific configuration for `list_autonomous_database_character_sets`
3046
+ # @return [::Gapic::Config::Method]
3047
+ #
3048
+ attr_reader :list_autonomous_database_character_sets
3049
+ ##
3050
+ # RPC-specific configuration for `list_autonomous_database_backups`
3051
+ # @return [::Gapic::Config::Method]
3052
+ #
3053
+ attr_reader :list_autonomous_database_backups
3054
+ ##
3055
+ # RPC-specific configuration for `stop_autonomous_database`
3056
+ # @return [::Gapic::Config::Method]
3057
+ #
3058
+ attr_reader :stop_autonomous_database
3059
+ ##
3060
+ # RPC-specific configuration for `start_autonomous_database`
3061
+ # @return [::Gapic::Config::Method]
3062
+ #
3063
+ attr_reader :start_autonomous_database
3064
+ ##
3065
+ # RPC-specific configuration for `restart_autonomous_database`
3066
+ # @return [::Gapic::Config::Method]
3067
+ #
3068
+ attr_reader :restart_autonomous_database
3069
+
3070
+ # @private
3071
+ def initialize parent_rpcs = nil
3072
+ list_cloud_exadata_infrastructures_config = parent_rpcs.list_cloud_exadata_infrastructures if parent_rpcs.respond_to? :list_cloud_exadata_infrastructures
3073
+ @list_cloud_exadata_infrastructures = ::Gapic::Config::Method.new list_cloud_exadata_infrastructures_config
3074
+ get_cloud_exadata_infrastructure_config = parent_rpcs.get_cloud_exadata_infrastructure if parent_rpcs.respond_to? :get_cloud_exadata_infrastructure
3075
+ @get_cloud_exadata_infrastructure = ::Gapic::Config::Method.new get_cloud_exadata_infrastructure_config
3076
+ create_cloud_exadata_infrastructure_config = parent_rpcs.create_cloud_exadata_infrastructure if parent_rpcs.respond_to? :create_cloud_exadata_infrastructure
3077
+ @create_cloud_exadata_infrastructure = ::Gapic::Config::Method.new create_cloud_exadata_infrastructure_config
3078
+ delete_cloud_exadata_infrastructure_config = parent_rpcs.delete_cloud_exadata_infrastructure if parent_rpcs.respond_to? :delete_cloud_exadata_infrastructure
3079
+ @delete_cloud_exadata_infrastructure = ::Gapic::Config::Method.new delete_cloud_exadata_infrastructure_config
3080
+ list_cloud_vm_clusters_config = parent_rpcs.list_cloud_vm_clusters if parent_rpcs.respond_to? :list_cloud_vm_clusters
3081
+ @list_cloud_vm_clusters = ::Gapic::Config::Method.new list_cloud_vm_clusters_config
3082
+ get_cloud_vm_cluster_config = parent_rpcs.get_cloud_vm_cluster if parent_rpcs.respond_to? :get_cloud_vm_cluster
3083
+ @get_cloud_vm_cluster = ::Gapic::Config::Method.new get_cloud_vm_cluster_config
3084
+ create_cloud_vm_cluster_config = parent_rpcs.create_cloud_vm_cluster if parent_rpcs.respond_to? :create_cloud_vm_cluster
3085
+ @create_cloud_vm_cluster = ::Gapic::Config::Method.new create_cloud_vm_cluster_config
3086
+ delete_cloud_vm_cluster_config = parent_rpcs.delete_cloud_vm_cluster if parent_rpcs.respond_to? :delete_cloud_vm_cluster
3087
+ @delete_cloud_vm_cluster = ::Gapic::Config::Method.new delete_cloud_vm_cluster_config
3088
+ list_entitlements_config = parent_rpcs.list_entitlements if parent_rpcs.respond_to? :list_entitlements
3089
+ @list_entitlements = ::Gapic::Config::Method.new list_entitlements_config
3090
+ list_db_servers_config = parent_rpcs.list_db_servers if parent_rpcs.respond_to? :list_db_servers
3091
+ @list_db_servers = ::Gapic::Config::Method.new list_db_servers_config
3092
+ list_db_nodes_config = parent_rpcs.list_db_nodes if parent_rpcs.respond_to? :list_db_nodes
3093
+ @list_db_nodes = ::Gapic::Config::Method.new list_db_nodes_config
3094
+ list_gi_versions_config = parent_rpcs.list_gi_versions if parent_rpcs.respond_to? :list_gi_versions
3095
+ @list_gi_versions = ::Gapic::Config::Method.new list_gi_versions_config
3096
+ list_db_system_shapes_config = parent_rpcs.list_db_system_shapes if parent_rpcs.respond_to? :list_db_system_shapes
3097
+ @list_db_system_shapes = ::Gapic::Config::Method.new list_db_system_shapes_config
3098
+ list_autonomous_databases_config = parent_rpcs.list_autonomous_databases if parent_rpcs.respond_to? :list_autonomous_databases
3099
+ @list_autonomous_databases = ::Gapic::Config::Method.new list_autonomous_databases_config
3100
+ get_autonomous_database_config = parent_rpcs.get_autonomous_database if parent_rpcs.respond_to? :get_autonomous_database
3101
+ @get_autonomous_database = ::Gapic::Config::Method.new get_autonomous_database_config
3102
+ create_autonomous_database_config = parent_rpcs.create_autonomous_database if parent_rpcs.respond_to? :create_autonomous_database
3103
+ @create_autonomous_database = ::Gapic::Config::Method.new create_autonomous_database_config
3104
+ delete_autonomous_database_config = parent_rpcs.delete_autonomous_database if parent_rpcs.respond_to? :delete_autonomous_database
3105
+ @delete_autonomous_database = ::Gapic::Config::Method.new delete_autonomous_database_config
3106
+ restore_autonomous_database_config = parent_rpcs.restore_autonomous_database if parent_rpcs.respond_to? :restore_autonomous_database
3107
+ @restore_autonomous_database = ::Gapic::Config::Method.new restore_autonomous_database_config
3108
+ generate_autonomous_database_wallet_config = parent_rpcs.generate_autonomous_database_wallet if parent_rpcs.respond_to? :generate_autonomous_database_wallet
3109
+ @generate_autonomous_database_wallet = ::Gapic::Config::Method.new generate_autonomous_database_wallet_config
3110
+ list_autonomous_db_versions_config = parent_rpcs.list_autonomous_db_versions if parent_rpcs.respond_to? :list_autonomous_db_versions
3111
+ @list_autonomous_db_versions = ::Gapic::Config::Method.new list_autonomous_db_versions_config
3112
+ list_autonomous_database_character_sets_config = parent_rpcs.list_autonomous_database_character_sets if parent_rpcs.respond_to? :list_autonomous_database_character_sets
3113
+ @list_autonomous_database_character_sets = ::Gapic::Config::Method.new list_autonomous_database_character_sets_config
3114
+ list_autonomous_database_backups_config = parent_rpcs.list_autonomous_database_backups if parent_rpcs.respond_to? :list_autonomous_database_backups
3115
+ @list_autonomous_database_backups = ::Gapic::Config::Method.new list_autonomous_database_backups_config
3116
+ stop_autonomous_database_config = parent_rpcs.stop_autonomous_database if parent_rpcs.respond_to? :stop_autonomous_database
3117
+ @stop_autonomous_database = ::Gapic::Config::Method.new stop_autonomous_database_config
3118
+ start_autonomous_database_config = parent_rpcs.start_autonomous_database if parent_rpcs.respond_to? :start_autonomous_database
3119
+ @start_autonomous_database = ::Gapic::Config::Method.new start_autonomous_database_config
3120
+ restart_autonomous_database_config = parent_rpcs.restart_autonomous_database if parent_rpcs.respond_to? :restart_autonomous_database
3121
+ @restart_autonomous_database = ::Gapic::Config::Method.new restart_autonomous_database_config
3122
+
3123
+ yield self if block_given?
3124
+ end
3125
+ end
3126
+ end
3127
+ end
3128
+ end
3129
+ end
3130
+ end
3131
+ end
3132
+ end