google-apis-oracledatabase_v1 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,1170 @@
1
+ # Copyright 2020 Google LLC
2
+ #
3
+ # Licensed under the Apache License, Version 2.0 (the "License");
4
+ # you may not use this file except in compliance with the License.
5
+ # You may obtain a copy of the License at
6
+ #
7
+ # http://www.apache.org/licenses/LICENSE-2.0
8
+ #
9
+ # Unless required by applicable law or agreed to in writing, software
10
+ # distributed under the License is distributed on an "AS IS" BASIS,
11
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
+ # See the License for the specific language governing permissions and
13
+ # limitations under the License.
14
+
15
+ require 'google/apis/core/base_service'
16
+ require 'google/apis/core/json_representation'
17
+ require 'google/apis/core/hashable'
18
+ require 'google/apis/errors'
19
+
20
+ module Google
21
+ module Apis
22
+ module OracledatabaseV1
23
+ # Oracle Database@Google Cloud API
24
+ #
25
+ # The Oracle Database@Google Cloud API provides set of APIs to manage Oracle
26
+ # databases such as Exadata and Autonomous Databases.
27
+ #
28
+ # @example
29
+ # require 'google/apis/oracledatabase_v1'
30
+ #
31
+ # Oracledatabase = Google::Apis::OracledatabaseV1 # Alias the module
32
+ # service = Oracledatabase::OracleDatabaseService.new
33
+ #
34
+ # @see https://cloud.google.com/oracle/database/docs
35
+ class OracleDatabaseService < Google::Apis::Core::BaseService
36
+ DEFAULT_ENDPOINT_TEMPLATE = "https://oracledatabase.$UNIVERSE_DOMAIN$/"
37
+
38
+ # @return [String]
39
+ # API key. Your API key identifies your project and provides you with API access,
40
+ # quota, and reports. Required unless you provide an OAuth 2.0 token.
41
+ attr_accessor :key
42
+
43
+ # @return [String]
44
+ # Available to use for quota purposes for server-side applications. Can be any
45
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
46
+ attr_accessor :quota_user
47
+
48
+ def initialize
49
+ super(DEFAULT_ENDPOINT_TEMPLATE, '',
50
+ client_name: 'google-apis-oracledatabase_v1',
51
+ client_version: Google::Apis::OracledatabaseV1::GEM_VERSION)
52
+ @batch_path = 'batch'
53
+ end
54
+
55
+ # Gets information about a location.
56
+ # @param [String] name
57
+ # Resource name for the location.
58
+ # @param [String] fields
59
+ # Selector specifying which fields to include in a partial response.
60
+ # @param [String] quota_user
61
+ # Available to use for quota purposes for server-side applications. Can be any
62
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
63
+ # @param [Google::Apis::RequestOptions] options
64
+ # Request-specific options
65
+ #
66
+ # @yield [result, err] Result & error if block supplied
67
+ # @yieldparam result [Google::Apis::OracledatabaseV1::Location] parsed result object
68
+ # @yieldparam err [StandardError] error object if request failed
69
+ #
70
+ # @return [Google::Apis::OracledatabaseV1::Location]
71
+ #
72
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
73
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
74
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
75
+ def get_project_location(name, fields: nil, quota_user: nil, options: nil, &block)
76
+ command = make_simple_command(:get, 'v1/{+name}', options)
77
+ command.response_representation = Google::Apis::OracledatabaseV1::Location::Representation
78
+ command.response_class = Google::Apis::OracledatabaseV1::Location
79
+ command.params['name'] = name unless name.nil?
80
+ command.query['fields'] = fields unless fields.nil?
81
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
82
+ execute_or_queue_command(command, &block)
83
+ end
84
+
85
+ # Lists information about the supported locations for this service.
86
+ # @param [String] name
87
+ # The resource that owns the locations collection, if applicable.
88
+ # @param [String] filter
89
+ # A filter to narrow down results to a preferred subset. The filtering language
90
+ # accepts strings like `"displayName=tokyo"`, and is documented in more detail
91
+ # in [AIP-160](https://google.aip.dev/160).
92
+ # @param [Fixnum] page_size
93
+ # The maximum number of results to return. If not set, the service selects a
94
+ # default.
95
+ # @param [String] page_token
96
+ # A page token received from the `next_page_token` field in the response. Send
97
+ # that page token to receive the subsequent page.
98
+ # @param [String] fields
99
+ # Selector specifying which fields to include in a partial response.
100
+ # @param [String] quota_user
101
+ # Available to use for quota purposes for server-side applications. Can be any
102
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
103
+ # @param [Google::Apis::RequestOptions] options
104
+ # Request-specific options
105
+ #
106
+ # @yield [result, err] Result & error if block supplied
107
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListLocationsResponse] parsed result object
108
+ # @yieldparam err [StandardError] error object if request failed
109
+ #
110
+ # @return [Google::Apis::OracledatabaseV1::ListLocationsResponse]
111
+ #
112
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
113
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
114
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
115
+ def list_project_locations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
116
+ command = make_simple_command(:get, 'v1/{+name}/locations', options)
117
+ command.response_representation = Google::Apis::OracledatabaseV1::ListLocationsResponse::Representation
118
+ command.response_class = Google::Apis::OracledatabaseV1::ListLocationsResponse
119
+ command.params['name'] = name unless name.nil?
120
+ command.query['filter'] = filter unless filter.nil?
121
+ command.query['pageSize'] = page_size unless page_size.nil?
122
+ command.query['pageToken'] = page_token unless page_token.nil?
123
+ command.query['fields'] = fields unless fields.nil?
124
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
125
+ execute_or_queue_command(command, &block)
126
+ end
127
+
128
+ # Lists the long term and automatic backups of an Autonomous Database.
129
+ # @param [String] parent
130
+ # Required. The parent value for ListAutonomousDatabaseBackups in the following
131
+ # format: projects/`project`/locations/`location`.
132
+ # @param [String] filter
133
+ # Optional. An expression for filtering the results of the request. Only the **
134
+ # autonomous_database_id** field is supported in the following format: `
135
+ # autonomous_database_id="`autonomous_database_id`"`. The accepted values must
136
+ # be a valid Autonomous Database ID, limited to the naming restrictions of the
137
+ # ID: ^[a-z]([a-z0-9-]`0,61`[a-z0-9])?$). The ID must start with a letter, end
138
+ # with a letter or a number, and be a maximum of 63 characters.
139
+ # @param [Fixnum] page_size
140
+ # Optional. The maximum number of items to return. If unspecified, at most 50
141
+ # Autonomous DB Backups will be returned. The maximum value is 1000; values
142
+ # above 1000 will be coerced to 1000.
143
+ # @param [String] page_token
144
+ # Optional. A token identifying a page of results the server should return.
145
+ # @param [String] fields
146
+ # Selector specifying which fields to include in a partial response.
147
+ # @param [String] quota_user
148
+ # Available to use for quota purposes for server-side applications. Can be any
149
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
150
+ # @param [Google::Apis::RequestOptions] options
151
+ # Request-specific options
152
+ #
153
+ # @yield [result, err] Result & error if block supplied
154
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListAutonomousDatabaseBackupsResponse] parsed result object
155
+ # @yieldparam err [StandardError] error object if request failed
156
+ #
157
+ # @return [Google::Apis::OracledatabaseV1::ListAutonomousDatabaseBackupsResponse]
158
+ #
159
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
160
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
161
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
162
+ def list_project_location_autonomous_database_backups(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
163
+ command = make_simple_command(:get, 'v1/{+parent}/autonomousDatabaseBackups', options)
164
+ command.response_representation = Google::Apis::OracledatabaseV1::ListAutonomousDatabaseBackupsResponse::Representation
165
+ command.response_class = Google::Apis::OracledatabaseV1::ListAutonomousDatabaseBackupsResponse
166
+ command.params['parent'] = parent unless parent.nil?
167
+ command.query['filter'] = filter unless filter.nil?
168
+ command.query['pageSize'] = page_size unless page_size.nil?
169
+ command.query['pageToken'] = page_token unless page_token.nil?
170
+ command.query['fields'] = fields unless fields.nil?
171
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
172
+ execute_or_queue_command(command, &block)
173
+ end
174
+
175
+ # Lists Autonomous Database Character Sets in a given project and location.
176
+ # @param [String] parent
177
+ # Required. The parent value for the Autonomous Database in the following format:
178
+ # projects/`project`/locations/`location`.
179
+ # @param [String] filter
180
+ # Optional. An expression for filtering the results of the request. Only the **
181
+ # character_set_type** field is supported in the following format: `
182
+ # character_set_type="`characterSetType`"`. Accepted values include `DATABASE`
183
+ # and `NATIONAL`.
184
+ # @param [Fixnum] page_size
185
+ # Optional. The maximum number of items to return. If unspecified, at most 50
186
+ # Autonomous DB Character Sets will be returned. The maximum value is 1000;
187
+ # values above 1000 will be coerced to 1000.
188
+ # @param [String] page_token
189
+ # Optional. A token identifying a page of results the server should return.
190
+ # @param [String] fields
191
+ # Selector specifying which fields to include in a partial response.
192
+ # @param [String] quota_user
193
+ # Available to use for quota purposes for server-side applications. Can be any
194
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
195
+ # @param [Google::Apis::RequestOptions] options
196
+ # Request-specific options
197
+ #
198
+ # @yield [result, err] Result & error if block supplied
199
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListAutonomousDatabaseCharacterSetsResponse] parsed result object
200
+ # @yieldparam err [StandardError] error object if request failed
201
+ #
202
+ # @return [Google::Apis::OracledatabaseV1::ListAutonomousDatabaseCharacterSetsResponse]
203
+ #
204
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
205
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
206
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
207
+ def list_project_location_autonomous_database_character_sets(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
208
+ command = make_simple_command(:get, 'v1/{+parent}/autonomousDatabaseCharacterSets', options)
209
+ command.response_representation = Google::Apis::OracledatabaseV1::ListAutonomousDatabaseCharacterSetsResponse::Representation
210
+ command.response_class = Google::Apis::OracledatabaseV1::ListAutonomousDatabaseCharacterSetsResponse
211
+ command.params['parent'] = parent unless parent.nil?
212
+ command.query['filter'] = filter unless filter.nil?
213
+ command.query['pageSize'] = page_size unless page_size.nil?
214
+ command.query['pageToken'] = page_token unless page_token.nil?
215
+ command.query['fields'] = fields unless fields.nil?
216
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
217
+ execute_or_queue_command(command, &block)
218
+ end
219
+
220
+ # Creates a new Autonomous Database in a given project and location.
221
+ # @param [String] parent
222
+ # Required. The name of the parent in the following format: projects/`project`/
223
+ # locations/`location`.
224
+ # @param [Google::Apis::OracledatabaseV1::AutonomousDatabase] autonomous_database_object
225
+ # @param [String] autonomous_database_id
226
+ # Required. The ID of the Autonomous Database to create. This value is
227
+ # restricted to (^[a-z]([a-z0-9-]`0,61`[a-z0-9])?$) and must be a maximum of 63
228
+ # characters in length. The value must start with a letter and end with a letter
229
+ # or a number.
230
+ # @param [String] request_id
231
+ # Optional. An optional ID to identify the request. This value is used to
232
+ # identify duplicate requests. If you make a request with the same request ID
233
+ # and the original request is still in progress or completed, the server ignores
234
+ # the second request. This prevents clients from accidentally creating duplicate
235
+ # commitments. The request ID must be a valid UUID with the exception that zero
236
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
237
+ # @param [String] fields
238
+ # Selector specifying which fields to include in a partial response.
239
+ # @param [String] quota_user
240
+ # Available to use for quota purposes for server-side applications. Can be any
241
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
242
+ # @param [Google::Apis::RequestOptions] options
243
+ # Request-specific options
244
+ #
245
+ # @yield [result, err] Result & error if block supplied
246
+ # @yieldparam result [Google::Apis::OracledatabaseV1::Operation] parsed result object
247
+ # @yieldparam err [StandardError] error object if request failed
248
+ #
249
+ # @return [Google::Apis::OracledatabaseV1::Operation]
250
+ #
251
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
252
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
253
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
254
+ def create_project_location_autonomous_database(parent, autonomous_database_object = nil, autonomous_database_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
255
+ command = make_simple_command(:post, 'v1/{+parent}/autonomousDatabases', options)
256
+ command.request_representation = Google::Apis::OracledatabaseV1::AutonomousDatabase::Representation
257
+ command.request_object = autonomous_database_object
258
+ command.response_representation = Google::Apis::OracledatabaseV1::Operation::Representation
259
+ command.response_class = Google::Apis::OracledatabaseV1::Operation
260
+ command.params['parent'] = parent unless parent.nil?
261
+ command.query['autonomousDatabaseId'] = autonomous_database_id unless autonomous_database_id.nil?
262
+ command.query['requestId'] = request_id unless request_id.nil?
263
+ command.query['fields'] = fields unless fields.nil?
264
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
265
+ execute_or_queue_command(command, &block)
266
+ end
267
+
268
+ # Deletes a single Autonomous Database.
269
+ # @param [String] name
270
+ # Required. The name of the resource in the following format: projects/`project`/
271
+ # locations/`location`/autonomousDatabases/`autonomous_database`.
272
+ # @param [String] request_id
273
+ # Optional. An optional ID to identify the request. This value is used to
274
+ # identify duplicate requests. If you make a request with the same request ID
275
+ # and the original request is still in progress or completed, the server ignores
276
+ # the second request. This prevents clients from accidentally creating duplicate
277
+ # commitments. The request ID must be a valid UUID with the exception that zero
278
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
279
+ # @param [String] fields
280
+ # Selector specifying which fields to include in a partial response.
281
+ # @param [String] quota_user
282
+ # Available to use for quota purposes for server-side applications. Can be any
283
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
284
+ # @param [Google::Apis::RequestOptions] options
285
+ # Request-specific options
286
+ #
287
+ # @yield [result, err] Result & error if block supplied
288
+ # @yieldparam result [Google::Apis::OracledatabaseV1::Operation] parsed result object
289
+ # @yieldparam err [StandardError] error object if request failed
290
+ #
291
+ # @return [Google::Apis::OracledatabaseV1::Operation]
292
+ #
293
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
294
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
295
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
296
+ def delete_project_location_autonomous_database(name, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
297
+ command = make_simple_command(:delete, 'v1/{+name}', options)
298
+ command.response_representation = Google::Apis::OracledatabaseV1::Operation::Representation
299
+ command.response_class = Google::Apis::OracledatabaseV1::Operation
300
+ command.params['name'] = name unless name.nil?
301
+ command.query['requestId'] = request_id unless request_id.nil?
302
+ command.query['fields'] = fields unless fields.nil?
303
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
304
+ execute_or_queue_command(command, &block)
305
+ end
306
+
307
+ # Generates a wallet for a single Autonomous Database.
308
+ # @param [String] name
309
+ # Required. The name of the Autonomous Database in the following format:
310
+ # projects/`project`/locations/`location`/autonomousDatabases/`
311
+ # autonomous_database`.
312
+ # @param [Google::Apis::OracledatabaseV1::GenerateAutonomousDatabaseWalletRequest] generate_autonomous_database_wallet_request_object
313
+ # @param [String] fields
314
+ # Selector specifying which fields to include in a partial response.
315
+ # @param [String] quota_user
316
+ # Available to use for quota purposes for server-side applications. Can be any
317
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
318
+ # @param [Google::Apis::RequestOptions] options
319
+ # Request-specific options
320
+ #
321
+ # @yield [result, err] Result & error if block supplied
322
+ # @yieldparam result [Google::Apis::OracledatabaseV1::GenerateAutonomousDatabaseWalletResponse] parsed result object
323
+ # @yieldparam err [StandardError] error object if request failed
324
+ #
325
+ # @return [Google::Apis::OracledatabaseV1::GenerateAutonomousDatabaseWalletResponse]
326
+ #
327
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
328
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
329
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
330
+ def generate_project_location_autonomous_database_wallet(name, generate_autonomous_database_wallet_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
331
+ command = make_simple_command(:post, 'v1/{+name}:generateWallet', options)
332
+ command.request_representation = Google::Apis::OracledatabaseV1::GenerateAutonomousDatabaseWalletRequest::Representation
333
+ command.request_object = generate_autonomous_database_wallet_request_object
334
+ command.response_representation = Google::Apis::OracledatabaseV1::GenerateAutonomousDatabaseWalletResponse::Representation
335
+ command.response_class = Google::Apis::OracledatabaseV1::GenerateAutonomousDatabaseWalletResponse
336
+ command.params['name'] = name unless name.nil?
337
+ command.query['fields'] = fields unless fields.nil?
338
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
339
+ execute_or_queue_command(command, &block)
340
+ end
341
+
342
+ # Gets the details of a single Autonomous Database.
343
+ # @param [String] name
344
+ # Required. The name of the Autonomous Database in the following format:
345
+ # projects/`project`/locations/`location`/autonomousDatabases/`
346
+ # autonomous_database`.
347
+ # @param [String] fields
348
+ # Selector specifying which fields to include in a partial response.
349
+ # @param [String] quota_user
350
+ # Available to use for quota purposes for server-side applications. Can be any
351
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
352
+ # @param [Google::Apis::RequestOptions] options
353
+ # Request-specific options
354
+ #
355
+ # @yield [result, err] Result & error if block supplied
356
+ # @yieldparam result [Google::Apis::OracledatabaseV1::AutonomousDatabase] parsed result object
357
+ # @yieldparam err [StandardError] error object if request failed
358
+ #
359
+ # @return [Google::Apis::OracledatabaseV1::AutonomousDatabase]
360
+ #
361
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
362
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
363
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
364
+ def get_project_location_autonomous_database(name, fields: nil, quota_user: nil, options: nil, &block)
365
+ command = make_simple_command(:get, 'v1/{+name}', options)
366
+ command.response_representation = Google::Apis::OracledatabaseV1::AutonomousDatabase::Representation
367
+ command.response_class = Google::Apis::OracledatabaseV1::AutonomousDatabase
368
+ command.params['name'] = name unless name.nil?
369
+ command.query['fields'] = fields unless fields.nil?
370
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
371
+ execute_or_queue_command(command, &block)
372
+ end
373
+
374
+ # Lists the Autonomous Databases in a given project and location.
375
+ # @param [String] parent
376
+ # Required. The parent value for the Autonomous Database in the following format:
377
+ # projects/`project`/locations/`location`.
378
+ # @param [String] filter
379
+ # Optional. An expression for filtering the results of the request.
380
+ # @param [String] order_by
381
+ # Optional. An expression for ordering the results of the request.
382
+ # @param [Fixnum] page_size
383
+ # Optional. The maximum number of items to return. If unspecified, at most 50
384
+ # Autonomous Database will be returned. The maximum value is 1000; values above
385
+ # 1000 will be coerced to 1000.
386
+ # @param [String] page_token
387
+ # Optional. A token identifying a page of results the server should return.
388
+ # @param [String] fields
389
+ # Selector specifying which fields to include in a partial response.
390
+ # @param [String] quota_user
391
+ # Available to use for quota purposes for server-side applications. Can be any
392
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
393
+ # @param [Google::Apis::RequestOptions] options
394
+ # Request-specific options
395
+ #
396
+ # @yield [result, err] Result & error if block supplied
397
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListAutonomousDatabasesResponse] parsed result object
398
+ # @yieldparam err [StandardError] error object if request failed
399
+ #
400
+ # @return [Google::Apis::OracledatabaseV1::ListAutonomousDatabasesResponse]
401
+ #
402
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
403
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
404
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
405
+ def list_project_location_autonomous_databases(parent, filter: nil, order_by: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
406
+ command = make_simple_command(:get, 'v1/{+parent}/autonomousDatabases', options)
407
+ command.response_representation = Google::Apis::OracledatabaseV1::ListAutonomousDatabasesResponse::Representation
408
+ command.response_class = Google::Apis::OracledatabaseV1::ListAutonomousDatabasesResponse
409
+ command.params['parent'] = parent unless parent.nil?
410
+ command.query['filter'] = filter unless filter.nil?
411
+ command.query['orderBy'] = order_by unless order_by.nil?
412
+ command.query['pageSize'] = page_size unless page_size.nil?
413
+ command.query['pageToken'] = page_token unless page_token.nil?
414
+ command.query['fields'] = fields unless fields.nil?
415
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
416
+ execute_or_queue_command(command, &block)
417
+ end
418
+
419
+ # Restores a single Autonomous Database.
420
+ # @param [String] name
421
+ # Required. The name of the Autonomous Database in the following format:
422
+ # projects/`project`/locations/`location`/autonomousDatabases/`
423
+ # autonomous_database`.
424
+ # @param [Google::Apis::OracledatabaseV1::RestoreAutonomousDatabaseRequest] restore_autonomous_database_request_object
425
+ # @param [String] fields
426
+ # Selector specifying which fields to include in a partial response.
427
+ # @param [String] quota_user
428
+ # Available to use for quota purposes for server-side applications. Can be any
429
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
430
+ # @param [Google::Apis::RequestOptions] options
431
+ # Request-specific options
432
+ #
433
+ # @yield [result, err] Result & error if block supplied
434
+ # @yieldparam result [Google::Apis::OracledatabaseV1::Operation] parsed result object
435
+ # @yieldparam err [StandardError] error object if request failed
436
+ #
437
+ # @return [Google::Apis::OracledatabaseV1::Operation]
438
+ #
439
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
440
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
441
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
442
+ def restore_autonomous_database(name, restore_autonomous_database_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
443
+ command = make_simple_command(:post, 'v1/{+name}:restore', options)
444
+ command.request_representation = Google::Apis::OracledatabaseV1::RestoreAutonomousDatabaseRequest::Representation
445
+ command.request_object = restore_autonomous_database_request_object
446
+ command.response_representation = Google::Apis::OracledatabaseV1::Operation::Representation
447
+ command.response_class = Google::Apis::OracledatabaseV1::Operation
448
+ command.params['name'] = name unless name.nil?
449
+ command.query['fields'] = fields unless fields.nil?
450
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
451
+ execute_or_queue_command(command, &block)
452
+ end
453
+
454
+ # Lists all the available Autonomous Database versions for a project and
455
+ # location.
456
+ # @param [String] parent
457
+ # Required. The parent value for the Autonomous Database in the following format:
458
+ # projects/`project`/locations/`location`.
459
+ # @param [Fixnum] page_size
460
+ # Optional. The maximum number of items to return. If unspecified, at most 50
461
+ # Autonomous DB Versions will be returned. The maximum value is 1000; values
462
+ # above 1000 will be coerced to 1000.
463
+ # @param [String] page_token
464
+ # Optional. A token identifying a page of results the server should return.
465
+ # @param [String] fields
466
+ # Selector specifying which fields to include in a partial response.
467
+ # @param [String] quota_user
468
+ # Available to use for quota purposes for server-side applications. Can be any
469
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
470
+ # @param [Google::Apis::RequestOptions] options
471
+ # Request-specific options
472
+ #
473
+ # @yield [result, err] Result & error if block supplied
474
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListAutonomousDbVersionsResponse] parsed result object
475
+ # @yieldparam err [StandardError] error object if request failed
476
+ #
477
+ # @return [Google::Apis::OracledatabaseV1::ListAutonomousDbVersionsResponse]
478
+ #
479
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
480
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
481
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
482
+ def list_project_location_autonomous_db_versions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
483
+ command = make_simple_command(:get, 'v1/{+parent}/autonomousDbVersions', options)
484
+ command.response_representation = Google::Apis::OracledatabaseV1::ListAutonomousDbVersionsResponse::Representation
485
+ command.response_class = Google::Apis::OracledatabaseV1::ListAutonomousDbVersionsResponse
486
+ command.params['parent'] = parent unless parent.nil?
487
+ command.query['pageSize'] = page_size unless page_size.nil?
488
+ command.query['pageToken'] = page_token unless page_token.nil?
489
+ command.query['fields'] = fields unless fields.nil?
490
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
491
+ execute_or_queue_command(command, &block)
492
+ end
493
+
494
+ # Creates a new Exadata Infrastructure in a given project and location.
495
+ # @param [String] parent
496
+ # Required. The parent value for CloudExadataInfrastructure in the following
497
+ # format: projects/`project`/locations/`location`.
498
+ # @param [Google::Apis::OracledatabaseV1::CloudExadataInfrastructure] cloud_exadata_infrastructure_object
499
+ # @param [String] cloud_exadata_infrastructure_id
500
+ # Required. The ID of the Exadata Infrastructure to create. This value is
501
+ # restricted to (^[a-z]([a-z0-9-]`0,61`[a-z0-9])?$) and must be a maximum of 63
502
+ # characters in length. The value must start with a letter and end with a letter
503
+ # or a number.
504
+ # @param [String] request_id
505
+ # Optional. An optional ID to identify the request. This value is used to
506
+ # identify duplicate requests. If you make a request with the same request ID
507
+ # and the original request is still in progress or completed, the server ignores
508
+ # the second request. This prevents clients from accidentally creating duplicate
509
+ # commitments. The request ID must be a valid UUID with the exception that zero
510
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
511
+ # @param [String] fields
512
+ # Selector specifying which fields to include in a partial response.
513
+ # @param [String] quota_user
514
+ # Available to use for quota purposes for server-side applications. Can be any
515
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
516
+ # @param [Google::Apis::RequestOptions] options
517
+ # Request-specific options
518
+ #
519
+ # @yield [result, err] Result & error if block supplied
520
+ # @yieldparam result [Google::Apis::OracledatabaseV1::Operation] parsed result object
521
+ # @yieldparam err [StandardError] error object if request failed
522
+ #
523
+ # @return [Google::Apis::OracledatabaseV1::Operation]
524
+ #
525
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
526
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
527
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
528
+ def create_project_location_cloud_exadata_infrastructure(parent, cloud_exadata_infrastructure_object = nil, cloud_exadata_infrastructure_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
529
+ command = make_simple_command(:post, 'v1/{+parent}/cloudExadataInfrastructures', options)
530
+ command.request_representation = Google::Apis::OracledatabaseV1::CloudExadataInfrastructure::Representation
531
+ command.request_object = cloud_exadata_infrastructure_object
532
+ command.response_representation = Google::Apis::OracledatabaseV1::Operation::Representation
533
+ command.response_class = Google::Apis::OracledatabaseV1::Operation
534
+ command.params['parent'] = parent unless parent.nil?
535
+ command.query['cloudExadataInfrastructureId'] = cloud_exadata_infrastructure_id unless cloud_exadata_infrastructure_id.nil?
536
+ command.query['requestId'] = request_id unless request_id.nil?
537
+ command.query['fields'] = fields unless fields.nil?
538
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
539
+ execute_or_queue_command(command, &block)
540
+ end
541
+
542
+ # Deletes a single Exadata Infrastructure.
543
+ # @param [String] name
544
+ # Required. The name of the Cloud Exadata Infrastructure in the following format:
545
+ # projects/`project`/locations/`location`/cloudExadataInfrastructures/`
546
+ # cloud_exadata_infrastructure`.
547
+ # @param [Boolean] force
548
+ # Optional. If set to true, all VM clusters for this Exadata Infrastructure will
549
+ # be deleted. An Exadata Infrastructure can only be deleted once all its VM
550
+ # clusters have been deleted.
551
+ # @param [String] request_id
552
+ # Optional. An optional ID to identify the request. This value is used to
553
+ # identify duplicate requests. If you make a request with the same request ID
554
+ # and the original request is still in progress or completed, the server ignores
555
+ # the second request. This prevents clients from accidentally creating duplicate
556
+ # commitments. The request ID must be a valid UUID with the exception that zero
557
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
558
+ # @param [String] fields
559
+ # Selector specifying which fields to include in a partial response.
560
+ # @param [String] quota_user
561
+ # Available to use for quota purposes for server-side applications. Can be any
562
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
563
+ # @param [Google::Apis::RequestOptions] options
564
+ # Request-specific options
565
+ #
566
+ # @yield [result, err] Result & error if block supplied
567
+ # @yieldparam result [Google::Apis::OracledatabaseV1::Operation] parsed result object
568
+ # @yieldparam err [StandardError] error object if request failed
569
+ #
570
+ # @return [Google::Apis::OracledatabaseV1::Operation]
571
+ #
572
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
573
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
574
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
575
+ def delete_project_location_cloud_exadata_infrastructure(name, force: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
576
+ command = make_simple_command(:delete, 'v1/{+name}', options)
577
+ command.response_representation = Google::Apis::OracledatabaseV1::Operation::Representation
578
+ command.response_class = Google::Apis::OracledatabaseV1::Operation
579
+ command.params['name'] = name unless name.nil?
580
+ command.query['force'] = force unless force.nil?
581
+ command.query['requestId'] = request_id unless request_id.nil?
582
+ command.query['fields'] = fields unless fields.nil?
583
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
584
+ execute_or_queue_command(command, &block)
585
+ end
586
+
587
+ # Gets details of a single Exadata Infrastructure.
588
+ # @param [String] name
589
+ # Required. The name of the Cloud Exadata Infrastructure in the following format:
590
+ # projects/`project`/locations/`location`/cloudExadataInfrastructures/`
591
+ # cloud_exadata_infrastructure`.
592
+ # @param [String] fields
593
+ # Selector specifying which fields to include in a partial response.
594
+ # @param [String] quota_user
595
+ # Available to use for quota purposes for server-side applications. Can be any
596
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
597
+ # @param [Google::Apis::RequestOptions] options
598
+ # Request-specific options
599
+ #
600
+ # @yield [result, err] Result & error if block supplied
601
+ # @yieldparam result [Google::Apis::OracledatabaseV1::CloudExadataInfrastructure] parsed result object
602
+ # @yieldparam err [StandardError] error object if request failed
603
+ #
604
+ # @return [Google::Apis::OracledatabaseV1::CloudExadataInfrastructure]
605
+ #
606
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
607
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
608
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
609
+ def get_project_location_cloud_exadata_infrastructure(name, fields: nil, quota_user: nil, options: nil, &block)
610
+ command = make_simple_command(:get, 'v1/{+name}', options)
611
+ command.response_representation = Google::Apis::OracledatabaseV1::CloudExadataInfrastructure::Representation
612
+ command.response_class = Google::Apis::OracledatabaseV1::CloudExadataInfrastructure
613
+ command.params['name'] = name unless name.nil?
614
+ command.query['fields'] = fields unless fields.nil?
615
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
616
+ execute_or_queue_command(command, &block)
617
+ end
618
+
619
+ # Lists Exadata Infrastructures in a given project and location.
620
+ # @param [String] parent
621
+ # Required. The parent value for CloudExadataInfrastructure in the following
622
+ # format: projects/`project`/locations/`location`.
623
+ # @param [Fixnum] page_size
624
+ # Optional. The maximum number of items to return. If unspecified, at most 50
625
+ # Exadata infrastructures will be returned. The maximum value is 1000; values
626
+ # above 1000 will be coerced to 1000.
627
+ # @param [String] page_token
628
+ # Optional. A token identifying a page of results the server should return.
629
+ # @param [String] fields
630
+ # Selector specifying which fields to include in a partial response.
631
+ # @param [String] quota_user
632
+ # Available to use for quota purposes for server-side applications. Can be any
633
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
634
+ # @param [Google::Apis::RequestOptions] options
635
+ # Request-specific options
636
+ #
637
+ # @yield [result, err] Result & error if block supplied
638
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListCloudExadataInfrastructuresResponse] parsed result object
639
+ # @yieldparam err [StandardError] error object if request failed
640
+ #
641
+ # @return [Google::Apis::OracledatabaseV1::ListCloudExadataInfrastructuresResponse]
642
+ #
643
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
644
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
645
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
646
+ def list_project_location_cloud_exadata_infrastructures(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
647
+ command = make_simple_command(:get, 'v1/{+parent}/cloudExadataInfrastructures', options)
648
+ command.response_representation = Google::Apis::OracledatabaseV1::ListCloudExadataInfrastructuresResponse::Representation
649
+ command.response_class = Google::Apis::OracledatabaseV1::ListCloudExadataInfrastructuresResponse
650
+ command.params['parent'] = parent unless parent.nil?
651
+ command.query['pageSize'] = page_size unless page_size.nil?
652
+ command.query['pageToken'] = page_token unless page_token.nil?
653
+ command.query['fields'] = fields unless fields.nil?
654
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
655
+ execute_or_queue_command(command, &block)
656
+ end
657
+
658
+ # Lists the database servers of an Exadata Infrastructure instance.
659
+ # @param [String] parent
660
+ # Required. The parent value for database server in the following format:
661
+ # projects/`project`/locations/`location`/cloudExadataInfrastructures/`
662
+ # cloudExadataInfrastructure`.
663
+ # @param [Fixnum] page_size
664
+ # Optional. The maximum number of items to return. If unspecified, a maximum of
665
+ # 50 db servers will be returned. The maximum value is 1000; values above 1000
666
+ # will be reset to 1000.
667
+ # @param [String] page_token
668
+ # Optional. A token identifying a page of results the server should return.
669
+ # @param [String] fields
670
+ # Selector specifying which fields to include in a partial response.
671
+ # @param [String] quota_user
672
+ # Available to use for quota purposes for server-side applications. Can be any
673
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
674
+ # @param [Google::Apis::RequestOptions] options
675
+ # Request-specific options
676
+ #
677
+ # @yield [result, err] Result & error if block supplied
678
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListDbServersResponse] parsed result object
679
+ # @yieldparam err [StandardError] error object if request failed
680
+ #
681
+ # @return [Google::Apis::OracledatabaseV1::ListDbServersResponse]
682
+ #
683
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
684
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
685
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
686
+ def list_project_location_cloud_exadata_infrastructure_db_servers(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
687
+ command = make_simple_command(:get, 'v1/{+parent}/dbServers', options)
688
+ command.response_representation = Google::Apis::OracledatabaseV1::ListDbServersResponse::Representation
689
+ command.response_class = Google::Apis::OracledatabaseV1::ListDbServersResponse
690
+ command.params['parent'] = parent unless parent.nil?
691
+ command.query['pageSize'] = page_size unless page_size.nil?
692
+ command.query['pageToken'] = page_token unless page_token.nil?
693
+ command.query['fields'] = fields unless fields.nil?
694
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
695
+ execute_or_queue_command(command, &block)
696
+ end
697
+
698
+ # Creates a new VM Cluster in a given project and location.
699
+ # @param [String] parent
700
+ # Required. The name of the parent in the following format: projects/`project`/
701
+ # locations/`location`.
702
+ # @param [Google::Apis::OracledatabaseV1::CloudVmCluster] cloud_vm_cluster_object
703
+ # @param [String] cloud_vm_cluster_id
704
+ # Required. The ID of the VM Cluster to create. This value is restricted to (^[a-
705
+ # z]([a-z0-9-]`0,61`[a-z0-9])?$) and must be a maximum of 63 characters in
706
+ # length. The value must start with a letter and end with a letter or a number.
707
+ # @param [String] request_id
708
+ # Optional. An optional ID to identify the request. This value is used to
709
+ # identify duplicate requests. If you make a request with the same request ID
710
+ # and the original request is still in progress or completed, the server ignores
711
+ # the second request. This prevents clients from accidentally creating duplicate
712
+ # commitments. The request ID must be a valid UUID with the exception that zero
713
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
714
+ # @param [String] fields
715
+ # Selector specifying which fields to include in a partial response.
716
+ # @param [String] quota_user
717
+ # Available to use for quota purposes for server-side applications. Can be any
718
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
719
+ # @param [Google::Apis::RequestOptions] options
720
+ # Request-specific options
721
+ #
722
+ # @yield [result, err] Result & error if block supplied
723
+ # @yieldparam result [Google::Apis::OracledatabaseV1::Operation] parsed result object
724
+ # @yieldparam err [StandardError] error object if request failed
725
+ #
726
+ # @return [Google::Apis::OracledatabaseV1::Operation]
727
+ #
728
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
729
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
730
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
731
+ def create_project_location_cloud_vm_cluster(parent, cloud_vm_cluster_object = nil, cloud_vm_cluster_id: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
732
+ command = make_simple_command(:post, 'v1/{+parent}/cloudVmClusters', options)
733
+ command.request_representation = Google::Apis::OracledatabaseV1::CloudVmCluster::Representation
734
+ command.request_object = cloud_vm_cluster_object
735
+ command.response_representation = Google::Apis::OracledatabaseV1::Operation::Representation
736
+ command.response_class = Google::Apis::OracledatabaseV1::Operation
737
+ command.params['parent'] = parent unless parent.nil?
738
+ command.query['cloudVmClusterId'] = cloud_vm_cluster_id unless cloud_vm_cluster_id.nil?
739
+ command.query['requestId'] = request_id unless request_id.nil?
740
+ command.query['fields'] = fields unless fields.nil?
741
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
742
+ execute_or_queue_command(command, &block)
743
+ end
744
+
745
+ # Deletes a single VM Cluster.
746
+ # @param [String] name
747
+ # Required. The name of the Cloud VM Cluster in the following format: projects/`
748
+ # project`/locations/`location`/cloudVmClusters/`cloud_vm_cluster`.
749
+ # @param [Boolean] force
750
+ # Optional. If set to true, all child resources for the VM Cluster will be
751
+ # deleted. A VM Cluster can only be deleted once all its child resources have
752
+ # been deleted.
753
+ # @param [String] request_id
754
+ # Optional. An optional ID to identify the request. This value is used to
755
+ # identify duplicate requests. If you make a request with the same request ID
756
+ # and the original request is still in progress or completed, the server ignores
757
+ # the second request. This prevents clients from accidentally creating duplicate
758
+ # commitments. The request ID must be a valid UUID with the exception that zero
759
+ # UUID is not supported (00000000-0000-0000-0000-000000000000).
760
+ # @param [String] fields
761
+ # Selector specifying which fields to include in a partial response.
762
+ # @param [String] quota_user
763
+ # Available to use for quota purposes for server-side applications. Can be any
764
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
765
+ # @param [Google::Apis::RequestOptions] options
766
+ # Request-specific options
767
+ #
768
+ # @yield [result, err] Result & error if block supplied
769
+ # @yieldparam result [Google::Apis::OracledatabaseV1::Operation] parsed result object
770
+ # @yieldparam err [StandardError] error object if request failed
771
+ #
772
+ # @return [Google::Apis::OracledatabaseV1::Operation]
773
+ #
774
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
775
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
776
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
777
+ def delete_project_location_cloud_vm_cluster(name, force: nil, request_id: nil, fields: nil, quota_user: nil, options: nil, &block)
778
+ command = make_simple_command(:delete, 'v1/{+name}', options)
779
+ command.response_representation = Google::Apis::OracledatabaseV1::Operation::Representation
780
+ command.response_class = Google::Apis::OracledatabaseV1::Operation
781
+ command.params['name'] = name unless name.nil?
782
+ command.query['force'] = force unless force.nil?
783
+ command.query['requestId'] = request_id unless request_id.nil?
784
+ command.query['fields'] = fields unless fields.nil?
785
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
786
+ execute_or_queue_command(command, &block)
787
+ end
788
+
789
+ # Gets details of a single VM Cluster.
790
+ # @param [String] name
791
+ # Required. The name of the Cloud VM Cluster in the following format: projects/`
792
+ # project`/locations/`location`/cloudVmClusters/`cloud_vm_cluster`.
793
+ # @param [String] fields
794
+ # Selector specifying which fields to include in a partial response.
795
+ # @param [String] quota_user
796
+ # Available to use for quota purposes for server-side applications. Can be any
797
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
798
+ # @param [Google::Apis::RequestOptions] options
799
+ # Request-specific options
800
+ #
801
+ # @yield [result, err] Result & error if block supplied
802
+ # @yieldparam result [Google::Apis::OracledatabaseV1::CloudVmCluster] parsed result object
803
+ # @yieldparam err [StandardError] error object if request failed
804
+ #
805
+ # @return [Google::Apis::OracledatabaseV1::CloudVmCluster]
806
+ #
807
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
808
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
809
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
810
+ def get_project_location_cloud_vm_cluster(name, fields: nil, quota_user: nil, options: nil, &block)
811
+ command = make_simple_command(:get, 'v1/{+name}', options)
812
+ command.response_representation = Google::Apis::OracledatabaseV1::CloudVmCluster::Representation
813
+ command.response_class = Google::Apis::OracledatabaseV1::CloudVmCluster
814
+ command.params['name'] = name unless name.nil?
815
+ command.query['fields'] = fields unless fields.nil?
816
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
817
+ execute_or_queue_command(command, &block)
818
+ end
819
+
820
+ # Lists the VM Clusters in a given project and location.
821
+ # @param [String] parent
822
+ # Required. The name of the parent in the following format: projects/`project`/
823
+ # locations/`location`.
824
+ # @param [String] filter
825
+ # Optional. An expression for filtering the results of the request.
826
+ # @param [Fixnum] page_size
827
+ # Optional. The number of VM clusters to return. If unspecified, at most 50 VM
828
+ # clusters will be returned. The maximum value is 1,000.
829
+ # @param [String] page_token
830
+ # Optional. A token identifying the page of results the server returns.
831
+ # @param [String] fields
832
+ # Selector specifying which fields to include in a partial response.
833
+ # @param [String] quota_user
834
+ # Available to use for quota purposes for server-side applications. Can be any
835
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
836
+ # @param [Google::Apis::RequestOptions] options
837
+ # Request-specific options
838
+ #
839
+ # @yield [result, err] Result & error if block supplied
840
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListCloudVmClustersResponse] parsed result object
841
+ # @yieldparam err [StandardError] error object if request failed
842
+ #
843
+ # @return [Google::Apis::OracledatabaseV1::ListCloudVmClustersResponse]
844
+ #
845
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
846
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
847
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
848
+ def list_project_location_cloud_vm_clusters(parent, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
849
+ command = make_simple_command(:get, 'v1/{+parent}/cloudVmClusters', options)
850
+ command.response_representation = Google::Apis::OracledatabaseV1::ListCloudVmClustersResponse::Representation
851
+ command.response_class = Google::Apis::OracledatabaseV1::ListCloudVmClustersResponse
852
+ command.params['parent'] = parent unless parent.nil?
853
+ command.query['filter'] = filter unless filter.nil?
854
+ command.query['pageSize'] = page_size unless page_size.nil?
855
+ command.query['pageToken'] = page_token unless page_token.nil?
856
+ command.query['fields'] = fields unless fields.nil?
857
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
858
+ execute_or_queue_command(command, &block)
859
+ end
860
+
861
+ # Lists the database nodes of a VM Cluster.
862
+ # @param [String] parent
863
+ # Required. The parent value for database node in the following format: projects/
864
+ # `project`/locations/`location`/cloudVmClusters/`cloudVmCluster`.
865
+ # @param [Fixnum] page_size
866
+ # Optional. The maximum number of items to return. If unspecified, at most 50 db
867
+ # nodes will be returned. The maximum value is 1000; values above 1000 will be
868
+ # coerced to 1000.
869
+ # @param [String] page_token
870
+ # Optional. A token identifying a page of results the node should return.
871
+ # @param [String] fields
872
+ # Selector specifying which fields to include in a partial response.
873
+ # @param [String] quota_user
874
+ # Available to use for quota purposes for server-side applications. Can be any
875
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
876
+ # @param [Google::Apis::RequestOptions] options
877
+ # Request-specific options
878
+ #
879
+ # @yield [result, err] Result & error if block supplied
880
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListDbNodesResponse] parsed result object
881
+ # @yieldparam err [StandardError] error object if request failed
882
+ #
883
+ # @return [Google::Apis::OracledatabaseV1::ListDbNodesResponse]
884
+ #
885
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
886
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
887
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
888
+ def list_project_location_cloud_vm_cluster_db_nodes(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
889
+ command = make_simple_command(:get, 'v1/{+parent}/dbNodes', options)
890
+ command.response_representation = Google::Apis::OracledatabaseV1::ListDbNodesResponse::Representation
891
+ command.response_class = Google::Apis::OracledatabaseV1::ListDbNodesResponse
892
+ command.params['parent'] = parent unless parent.nil?
893
+ command.query['pageSize'] = page_size unless page_size.nil?
894
+ command.query['pageToken'] = page_token unless page_token.nil?
895
+ command.query['fields'] = fields unless fields.nil?
896
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
897
+ execute_or_queue_command(command, &block)
898
+ end
899
+
900
+ # Lists the database system shapes available for the project and location.
901
+ # @param [String] parent
902
+ # Required. The parent value for Database System Shapes in the following format:
903
+ # projects/`project`/locations/`location`.
904
+ # @param [Fixnum] page_size
905
+ # Optional. The maximum number of items to return. If unspecified, at most 50
906
+ # database system shapes will be returned. The maximum value is 1000; values
907
+ # above 1000 will be coerced to 1000.
908
+ # @param [String] page_token
909
+ # Optional. A token identifying a page of results the server should return.
910
+ # @param [String] fields
911
+ # Selector specifying which fields to include in a partial response.
912
+ # @param [String] quota_user
913
+ # Available to use for quota purposes for server-side applications. Can be any
914
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
915
+ # @param [Google::Apis::RequestOptions] options
916
+ # Request-specific options
917
+ #
918
+ # @yield [result, err] Result & error if block supplied
919
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListDbSystemShapesResponse] parsed result object
920
+ # @yieldparam err [StandardError] error object if request failed
921
+ #
922
+ # @return [Google::Apis::OracledatabaseV1::ListDbSystemShapesResponse]
923
+ #
924
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
925
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
926
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
927
+ def list_project_location_db_system_shapes(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
928
+ command = make_simple_command(:get, 'v1/{+parent}/dbSystemShapes', options)
929
+ command.response_representation = Google::Apis::OracledatabaseV1::ListDbSystemShapesResponse::Representation
930
+ command.response_class = Google::Apis::OracledatabaseV1::ListDbSystemShapesResponse
931
+ command.params['parent'] = parent unless parent.nil?
932
+ command.query['pageSize'] = page_size unless page_size.nil?
933
+ command.query['pageToken'] = page_token unless page_token.nil?
934
+ command.query['fields'] = fields unless fields.nil?
935
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
936
+ execute_or_queue_command(command, &block)
937
+ end
938
+
939
+ # Lists the entitlements in a given project.
940
+ # @param [String] parent
941
+ # Required. The parent value for Entitlement in the following format: projects/`
942
+ # project`/locations/`location`.
943
+ # @param [Fixnum] page_size
944
+ # Optional. The maximum number of items to return. If unspecified, a maximum of
945
+ # 50 entitlements will be returned. The maximum value is 1000.
946
+ # @param [String] page_token
947
+ # Optional. A token identifying a page of results the server should return.
948
+ # @param [String] fields
949
+ # Selector specifying which fields to include in a partial response.
950
+ # @param [String] quota_user
951
+ # Available to use for quota purposes for server-side applications. Can be any
952
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
953
+ # @param [Google::Apis::RequestOptions] options
954
+ # Request-specific options
955
+ #
956
+ # @yield [result, err] Result & error if block supplied
957
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListEntitlementsResponse] parsed result object
958
+ # @yieldparam err [StandardError] error object if request failed
959
+ #
960
+ # @return [Google::Apis::OracledatabaseV1::ListEntitlementsResponse]
961
+ #
962
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
963
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
964
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
965
+ def list_project_location_entitlements(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
966
+ command = make_simple_command(:get, 'v1/{+parent}/entitlements', options)
967
+ command.response_representation = Google::Apis::OracledatabaseV1::ListEntitlementsResponse::Representation
968
+ command.response_class = Google::Apis::OracledatabaseV1::ListEntitlementsResponse
969
+ command.params['parent'] = parent unless parent.nil?
970
+ command.query['pageSize'] = page_size unless page_size.nil?
971
+ command.query['pageToken'] = page_token unless page_token.nil?
972
+ command.query['fields'] = fields unless fields.nil?
973
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
974
+ execute_or_queue_command(command, &block)
975
+ end
976
+
977
+ # Lists all the valid Oracle Grid Infrastructure (GI) versions for the given
978
+ # project and location.
979
+ # @param [String] parent
980
+ # Required. The parent value for Grid Infrastructure Version in the following
981
+ # format: Format: projects/`project`/locations/`location`.
982
+ # @param [Fixnum] page_size
983
+ # Optional. The maximum number of items to return. If unspecified, a maximum of
984
+ # 50 Oracle Grid Infrastructure (GI) versions will be returned. The maximum
985
+ # value is 1000; values above 1000 will be reset to 1000.
986
+ # @param [String] page_token
987
+ # Optional. A token identifying a page of results the server should return.
988
+ # @param [String] fields
989
+ # Selector specifying which fields to include in a partial response.
990
+ # @param [String] quota_user
991
+ # Available to use for quota purposes for server-side applications. Can be any
992
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
993
+ # @param [Google::Apis::RequestOptions] options
994
+ # Request-specific options
995
+ #
996
+ # @yield [result, err] Result & error if block supplied
997
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListGiVersionsResponse] parsed result object
998
+ # @yieldparam err [StandardError] error object if request failed
999
+ #
1000
+ # @return [Google::Apis::OracledatabaseV1::ListGiVersionsResponse]
1001
+ #
1002
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1003
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1004
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1005
+ def list_project_location_gi_versions(parent, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1006
+ command = make_simple_command(:get, 'v1/{+parent}/giVersions', options)
1007
+ command.response_representation = Google::Apis::OracledatabaseV1::ListGiVersionsResponse::Representation
1008
+ command.response_class = Google::Apis::OracledatabaseV1::ListGiVersionsResponse
1009
+ command.params['parent'] = parent unless parent.nil?
1010
+ command.query['pageSize'] = page_size unless page_size.nil?
1011
+ command.query['pageToken'] = page_token unless page_token.nil?
1012
+ command.query['fields'] = fields unless fields.nil?
1013
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1014
+ execute_or_queue_command(command, &block)
1015
+ end
1016
+
1017
+ # Starts asynchronous cancellation on a long-running operation. The server makes
1018
+ # a best effort to cancel the operation, but success is not guaranteed. If the
1019
+ # server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
1020
+ # Clients can use Operations.GetOperation or other methods to check whether the
1021
+ # cancellation succeeded or whether the operation completed despite cancellation.
1022
+ # On successful cancellation, the operation is not deleted; instead, it becomes
1023
+ # an operation with an Operation.error value with a google.rpc.Status.code of 1,
1024
+ # corresponding to `Code.CANCELLED`.
1025
+ # @param [String] name
1026
+ # The name of the operation resource to be cancelled.
1027
+ # @param [Google::Apis::OracledatabaseV1::CancelOperationRequest] cancel_operation_request_object
1028
+ # @param [String] fields
1029
+ # Selector specifying which fields to include in a partial response.
1030
+ # @param [String] quota_user
1031
+ # Available to use for quota purposes for server-side applications. Can be any
1032
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1033
+ # @param [Google::Apis::RequestOptions] options
1034
+ # Request-specific options
1035
+ #
1036
+ # @yield [result, err] Result & error if block supplied
1037
+ # @yieldparam result [Google::Apis::OracledatabaseV1::Empty] parsed result object
1038
+ # @yieldparam err [StandardError] error object if request failed
1039
+ #
1040
+ # @return [Google::Apis::OracledatabaseV1::Empty]
1041
+ #
1042
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1043
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1044
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1045
+ def cancel_operation(name, cancel_operation_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1046
+ command = make_simple_command(:post, 'v1/{+name}:cancel', options)
1047
+ command.request_representation = Google::Apis::OracledatabaseV1::CancelOperationRequest::Representation
1048
+ command.request_object = cancel_operation_request_object
1049
+ command.response_representation = Google::Apis::OracledatabaseV1::Empty::Representation
1050
+ command.response_class = Google::Apis::OracledatabaseV1::Empty
1051
+ command.params['name'] = name unless name.nil?
1052
+ command.query['fields'] = fields unless fields.nil?
1053
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1054
+ execute_or_queue_command(command, &block)
1055
+ end
1056
+
1057
+ # Deletes a long-running operation. This method indicates that the client is no
1058
+ # longer interested in the operation result. It does not cancel the operation.
1059
+ # If the server doesn't support this method, it returns `google.rpc.Code.
1060
+ # UNIMPLEMENTED`.
1061
+ # @param [String] name
1062
+ # The name of the operation resource to be deleted.
1063
+ # @param [String] fields
1064
+ # Selector specifying which fields to include in a partial response.
1065
+ # @param [String] quota_user
1066
+ # Available to use for quota purposes for server-side applications. Can be any
1067
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1068
+ # @param [Google::Apis::RequestOptions] options
1069
+ # Request-specific options
1070
+ #
1071
+ # @yield [result, err] Result & error if block supplied
1072
+ # @yieldparam result [Google::Apis::OracledatabaseV1::Empty] parsed result object
1073
+ # @yieldparam err [StandardError] error object if request failed
1074
+ #
1075
+ # @return [Google::Apis::OracledatabaseV1::Empty]
1076
+ #
1077
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1078
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1079
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1080
+ def delete_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1081
+ command = make_simple_command(:delete, 'v1/{+name}', options)
1082
+ command.response_representation = Google::Apis::OracledatabaseV1::Empty::Representation
1083
+ command.response_class = Google::Apis::OracledatabaseV1::Empty
1084
+ command.params['name'] = name unless name.nil?
1085
+ command.query['fields'] = fields unless fields.nil?
1086
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1087
+ execute_or_queue_command(command, &block)
1088
+ end
1089
+
1090
+ # Gets the latest state of a long-running operation. Clients can use this method
1091
+ # to poll the operation result at intervals as recommended by the API service.
1092
+ # @param [String] name
1093
+ # The name of the operation resource.
1094
+ # @param [String] fields
1095
+ # Selector specifying which fields to include in a partial response.
1096
+ # @param [String] quota_user
1097
+ # Available to use for quota purposes for server-side applications. Can be any
1098
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1099
+ # @param [Google::Apis::RequestOptions] options
1100
+ # Request-specific options
1101
+ #
1102
+ # @yield [result, err] Result & error if block supplied
1103
+ # @yieldparam result [Google::Apis::OracledatabaseV1::Operation] parsed result object
1104
+ # @yieldparam err [StandardError] error object if request failed
1105
+ #
1106
+ # @return [Google::Apis::OracledatabaseV1::Operation]
1107
+ #
1108
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1109
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1110
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1111
+ def get_project_location_operation(name, fields: nil, quota_user: nil, options: nil, &block)
1112
+ command = make_simple_command(:get, 'v1/{+name}', options)
1113
+ command.response_representation = Google::Apis::OracledatabaseV1::Operation::Representation
1114
+ command.response_class = Google::Apis::OracledatabaseV1::Operation
1115
+ command.params['name'] = name unless name.nil?
1116
+ command.query['fields'] = fields unless fields.nil?
1117
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1118
+ execute_or_queue_command(command, &block)
1119
+ end
1120
+
1121
+ # Lists operations that match the specified filter in the request. If the server
1122
+ # doesn't support this method, it returns `UNIMPLEMENTED`.
1123
+ # @param [String] name
1124
+ # The name of the operation's parent resource.
1125
+ # @param [String] filter
1126
+ # The standard list filter.
1127
+ # @param [Fixnum] page_size
1128
+ # The standard list page size.
1129
+ # @param [String] page_token
1130
+ # The standard list page token.
1131
+ # @param [String] fields
1132
+ # Selector specifying which fields to include in a partial response.
1133
+ # @param [String] quota_user
1134
+ # Available to use for quota purposes for server-side applications. Can be any
1135
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1136
+ # @param [Google::Apis::RequestOptions] options
1137
+ # Request-specific options
1138
+ #
1139
+ # @yield [result, err] Result & error if block supplied
1140
+ # @yieldparam result [Google::Apis::OracledatabaseV1::ListOperationsResponse] parsed result object
1141
+ # @yieldparam err [StandardError] error object if request failed
1142
+ #
1143
+ # @return [Google::Apis::OracledatabaseV1::ListOperationsResponse]
1144
+ #
1145
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1146
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1147
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1148
+ def list_project_location_operations(name, filter: nil, page_size: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1149
+ command = make_simple_command(:get, 'v1/{+name}/operations', options)
1150
+ command.response_representation = Google::Apis::OracledatabaseV1::ListOperationsResponse::Representation
1151
+ command.response_class = Google::Apis::OracledatabaseV1::ListOperationsResponse
1152
+ command.params['name'] = name unless name.nil?
1153
+ command.query['filter'] = filter unless filter.nil?
1154
+ command.query['pageSize'] = page_size unless page_size.nil?
1155
+ command.query['pageToken'] = page_token unless page_token.nil?
1156
+ command.query['fields'] = fields unless fields.nil?
1157
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1158
+ execute_or_queue_command(command, &block)
1159
+ end
1160
+
1161
+ protected
1162
+
1163
+ def apply_command_defaults(command)
1164
+ command.query['key'] = key unless key.nil?
1165
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1166
+ end
1167
+ end
1168
+ end
1169
+ end
1170
+ end