google-apis-oracledatabase_v1 0.1.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,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