google-apis-sqladmin_v1 0.2.0 → 0.3.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (7) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +4 -0
  3. data/lib/google/apis/sqladmin_v1/classes.rb +1870 -108
  4. data/lib/google/apis/sqladmin_v1/gem_version.rb +2 -2
  5. data/lib/google/apis/sqladmin_v1/representations.rb +836 -27
  6. data/lib/google/apis/sqladmin_v1/service.rb +1687 -50
  7. metadata +3 -3
data/lib/google/apis/sqladmin_v1/service.rb CHANGED
@@ -49,19 +49,124 @@ module Google
49
49
  @batch_path = 'batch'
50
50
  end
51
51
 
52
- # Lists instances under a given project.
52
+ # Deletes the backup taken by a backup run.
53
53
  # @param [String] project
54
- # Project ID of the project for which to list Cloud SQL instances.
55
- # @param [String] filter
56
- # A filter expression that filters resources listed in the response. The
57
- # expression is in the form of field:value. For example, 'instanceType:
58
- # CLOUD_SQL_INSTANCE'. Fields can be nested as needed as per their JSON
59
- # representation, such as 'settings.userLabels.auto_start:true'. Multiple filter
60
- # queries are space-separated. For example. 'state:RUNNABLE instanceType:
61
- # CLOUD_SQL_INSTANCE'. By default, each expression is an AND expression. However,
62
- # you can include AND and OR expressions explicitly.
54
+ # Project ID of the project that contains the instance.
55
+ # @param [String] instance
56
+ # Cloud SQL instance ID. This does not include the project ID.
57
+ # @param [Fixnum] id
58
+ # The ID of the backup run to delete. To find a backup run ID, use the list
59
+ # method.
60
+ # @param [String] fields
61
+ # Selector specifying which fields to include in a partial response.
62
+ # @param [String] quota_user
63
+ # Available to use for quota purposes for server-side applications. Can be any
64
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
65
+ # @param [Google::Apis::RequestOptions] options
66
+ # Request-specific options
67
+ #
68
+ # @yield [result, err] Result & error if block supplied
69
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
70
+ # @yieldparam err [StandardError] error object if request failed
71
+ #
72
+ # @return [Google::Apis::SqladminV1::Operation]
73
+ #
74
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
75
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
76
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
77
+ def delete_backup_run(project, instance, id, fields: nil, quota_user: nil, options: nil, &block)
78
+ command = make_simple_command(:delete, 'v1/projects/{project}/instances/{instance}/backupRuns/{id}', options)
79
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
80
+ command.response_class = Google::Apis::SqladminV1::Operation
81
+ command.params['project'] = project unless project.nil?
82
+ command.params['instance'] = instance unless instance.nil?
83
+ command.params['id'] = id unless id.nil?
84
+ command.query['fields'] = fields unless fields.nil?
85
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
86
+ execute_or_queue_command(command, &block)
87
+ end
88
+
89
+ # Retrieves a resource containing information about a backup run.
90
+ # @param [String] project
91
+ # Project ID of the project that contains the instance.
92
+ # @param [String] instance
93
+ # Cloud SQL instance ID. This does not include the project ID.
94
+ # @param [Fixnum] id
95
+ # The ID of this backup run.
96
+ # @param [String] fields
97
+ # Selector specifying which fields to include in a partial response.
98
+ # @param [String] quota_user
99
+ # Available to use for quota purposes for server-side applications. Can be any
100
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
101
+ # @param [Google::Apis::RequestOptions] options
102
+ # Request-specific options
103
+ #
104
+ # @yield [result, err] Result & error if block supplied
105
+ # @yieldparam result [Google::Apis::SqladminV1::BackupRun] parsed result object
106
+ # @yieldparam err [StandardError] error object if request failed
107
+ #
108
+ # @return [Google::Apis::SqladminV1::BackupRun]
109
+ #
110
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
111
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
112
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
113
+ def get_backup_run(project, instance, id, fields: nil, quota_user: nil, options: nil, &block)
114
+ command = make_simple_command(:get, 'v1/projects/{project}/instances/{instance}/backupRuns/{id}', options)
115
+ command.response_representation = Google::Apis::SqladminV1::BackupRun::Representation
116
+ command.response_class = Google::Apis::SqladminV1::BackupRun
117
+ command.params['project'] = project unless project.nil?
118
+ command.params['instance'] = instance unless instance.nil?
119
+ command.params['id'] = id unless id.nil?
120
+ command.query['fields'] = fields unless fields.nil?
121
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
122
+ execute_or_queue_command(command, &block)
123
+ end
124
+
125
+ # Creates a new backup run on demand.
126
+ # @param [String] project
127
+ # Project ID of the project that contains the instance.
128
+ # @param [String] instance
129
+ # Cloud SQL instance ID. This does not include the project ID.
130
+ # @param [Google::Apis::SqladminV1::BackupRun] backup_run_object
131
+ # @param [String] fields
132
+ # Selector specifying which fields to include in a partial response.
133
+ # @param [String] quota_user
134
+ # Available to use for quota purposes for server-side applications. Can be any
135
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
136
+ # @param [Google::Apis::RequestOptions] options
137
+ # Request-specific options
138
+ #
139
+ # @yield [result, err] Result & error if block supplied
140
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
141
+ # @yieldparam err [StandardError] error object if request failed
142
+ #
143
+ # @return [Google::Apis::SqladminV1::Operation]
144
+ #
145
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
146
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
147
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
148
+ def insert_backup_run(project, instance, backup_run_object = nil, fields: nil, quota_user: nil, options: nil, &block)
149
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/backupRuns', options)
150
+ command.request_representation = Google::Apis::SqladminV1::BackupRun::Representation
151
+ command.request_object = backup_run_object
152
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
153
+ command.response_class = Google::Apis::SqladminV1::Operation
154
+ command.params['project'] = project unless project.nil?
155
+ command.params['instance'] = instance unless instance.nil?
156
+ command.query['fields'] = fields unless fields.nil?
157
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
158
+ execute_or_queue_command(command, &block)
159
+ end
160
+
161
+ # Lists all backup runs associated with the project or a given instance and
162
+ # configuration in the reverse chronological order of the backup initiation time.
163
+ # @param [String] project
164
+ # Project ID of the project that contains the instance.
165
+ # @param [String] instance
166
+ # Cloud SQL instance ID, or "-" for all instances. This does not include the
167
+ # project ID.
63
168
  # @param [Fixnum] max_results
64
- # The maximum number of results to return per response.
169
+ # Maximum number of backup runs per response.
65
170
  # @param [String] page_token
66
171
  # A previously-returned page token representing part of the larger set of
67
172
  # results to view.
@@ -74,20 +179,20 @@ module Google
74
179
  # Request-specific options
75
180
  #
76
181
  # @yield [result, err] Result & error if block supplied
77
- # @yieldparam result [Google::Apis::SqladminV1::InstancesListResponse] parsed result object
182
+ # @yieldparam result [Google::Apis::SqladminV1::BackupRunsListResponse] parsed result object
78
183
  # @yieldparam err [StandardError] error object if request failed
79
184
  #
80
- # @return [Google::Apis::SqladminV1::InstancesListResponse]
185
+ # @return [Google::Apis::SqladminV1::BackupRunsListResponse]
81
186
  #
82
187
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
83
188
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
84
189
  # @raise [Google::Apis::AuthorizationError] Authorization is required
85
- def list_instances(project, filter: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
86
- command = make_simple_command(:get, 'v1/projects/{project}/instances', options)
87
- command.response_representation = Google::Apis::SqladminV1::InstancesListResponse::Representation
88
- command.response_class = Google::Apis::SqladminV1::InstancesListResponse
190
+ def list_backup_runs(project, instance, max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
191
+ command = make_simple_command(:get, 'v1/projects/{project}/instances/{instance}/backupRuns', options)
192
+ command.response_representation = Google::Apis::SqladminV1::BackupRunsListResponse::Representation
193
+ command.response_class = Google::Apis::SqladminV1::BackupRunsListResponse
89
194
  command.params['project'] = project unless project.nil?
90
- command.query['filter'] = filter unless filter.nil?
195
+ command.params['instance'] = instance unless instance.nil?
91
196
  command.query['maxResults'] = max_results unless max_results.nil?
92
197
  command.query['pageToken'] = page_token unless page_token.nil?
93
198
  command.query['fields'] = fields unless fields.nil?
@@ -120,7 +225,7 @@ module Google
120
225
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
121
226
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
122
227
  # @raise [Google::Apis::AuthorizationError] Authorization is required
123
- def generate_instance_ephemeral_cert(project, instance, generate_ephemeral_cert_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
228
+ def generate_connect_ephemeral_cert(project, instance, generate_ephemeral_cert_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
124
229
  command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}:generateEphemeralCert', options)
125
230
  command.request_representation = Google::Apis::SqladminV1::GenerateEphemeralCertRequest::Representation
126
231
  command.request_object = generate_ephemeral_cert_request_object
@@ -133,11 +238,49 @@ module Google
133
238
  execute_or_queue_command(command, &block)
134
239
  end
135
240
 
136
- # Retrieves a resource containing information about a Cloud SQL instance.
241
+ # Retrieves connect settings about a Cloud SQL instance.
242
+ # @param [String] project
243
+ # Project ID of the project that contains the instance.
244
+ # @param [String] instance
245
+ # Cloud SQL instance ID. This does not include the project ID.
246
+ # @param [String] read_time
247
+ # Optional. Optional snapshot read timestamp to trade freshness for performance.
248
+ # @param [String] fields
249
+ # Selector specifying which fields to include in a partial response.
250
+ # @param [String] quota_user
251
+ # Available to use for quota purposes for server-side applications. Can be any
252
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
253
+ # @param [Google::Apis::RequestOptions] options
254
+ # Request-specific options
255
+ #
256
+ # @yield [result, err] Result & error if block supplied
257
+ # @yieldparam result [Google::Apis::SqladminV1::ConnectSettings] parsed result object
258
+ # @yieldparam err [StandardError] error object if request failed
259
+ #
260
+ # @return [Google::Apis::SqladminV1::ConnectSettings]
261
+ #
262
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
263
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
264
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
265
+ def get_connect(project, instance, read_time: nil, fields: nil, quota_user: nil, options: nil, &block)
266
+ command = make_simple_command(:get, 'v1/projects/{project}/instances/{instance}/connectSettings', options)
267
+ command.response_representation = Google::Apis::SqladminV1::ConnectSettings::Representation
268
+ command.response_class = Google::Apis::SqladminV1::ConnectSettings
269
+ command.params['project'] = project unless project.nil?
270
+ command.params['instance'] = instance unless instance.nil?
271
+ command.query['readTime'] = read_time unless read_time.nil?
272
+ command.query['fields'] = fields unless fields.nil?
273
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
274
+ execute_or_queue_command(command, &block)
275
+ end
276
+
277
+ # Deletes a database from a Cloud SQL instance.
137
278
  # @param [String] project
138
279
  # Project ID of the project that contains the instance.
139
280
  # @param [String] instance
140
281
  # Database instance ID. This does not include the project ID.
282
+ # @param [String] database
283
+ # Name of the database to be deleted in the instance.
141
284
  # @param [String] fields
142
285
  # Selector specifying which fields to include in a partial response.
143
286
  # @param [String] quota_user
@@ -147,32 +290,34 @@ module Google
147
290
  # Request-specific options
148
291
  #
149
292
  # @yield [result, err] Result & error if block supplied
150
- # @yieldparam result [Google::Apis::SqladminV1::DatabaseInstance] parsed result object
293
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
151
294
  # @yieldparam err [StandardError] error object if request failed
152
295
  #
153
- # @return [Google::Apis::SqladminV1::DatabaseInstance]
296
+ # @return [Google::Apis::SqladminV1::Operation]
154
297
  #
155
298
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
156
299
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
157
300
  # @raise [Google::Apis::AuthorizationError] Authorization is required
158
- def get_project_instance(project, instance, fields: nil, quota_user: nil, options: nil, &block)
159
- command = make_simple_command(:get, 'v1/projects/{project}/instances/{instance}', options)
160
- command.response_representation = Google::Apis::SqladminV1::DatabaseInstance::Representation
161
- command.response_class = Google::Apis::SqladminV1::DatabaseInstance
301
+ def delete_database(project, instance, database, fields: nil, quota_user: nil, options: nil, &block)
302
+ command = make_simple_command(:delete, 'v1/projects/{project}/instances/{instance}/databases/{database}', options)
303
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
304
+ command.response_class = Google::Apis::SqladminV1::Operation
162
305
  command.params['project'] = project unless project.nil?
163
306
  command.params['instance'] = instance unless instance.nil?
307
+ command.params['database'] = database unless database.nil?
164
308
  command.query['fields'] = fields unless fields.nil?
165
309
  command.query['quotaUser'] = quota_user unless quota_user.nil?
166
310
  execute_or_queue_command(command, &block)
167
311
  end
168
312
 
169
- # Retrieves connect settings about a Cloud SQL instance.
313
+ # Retrieves a resource containing information about a database inside a Cloud
314
+ # SQL instance.
170
315
  # @param [String] project
171
316
  # Project ID of the project that contains the instance.
172
317
  # @param [String] instance
173
- # Cloud SQL instance ID. This does not include the project ID.
174
- # @param [String] read_time
175
- # Optional. Optional snapshot read timestamp to trade freshness for performance.
318
+ # Database instance ID. This does not include the project ID.
319
+ # @param [String] database
320
+ # Name of the database in the instance.
176
321
  # @param [String] fields
177
322
  # Selector specifying which fields to include in a partial response.
178
323
  # @param [String] quota_user
@@ -182,34 +327,68 @@ module Google
182
327
  # Request-specific options
183
328
  #
184
329
  # @yield [result, err] Result & error if block supplied
185
- # @yieldparam result [Google::Apis::SqladminV1::ConnectSettings] parsed result object
330
+ # @yieldparam result [Google::Apis::SqladminV1::Database] parsed result object
186
331
  # @yieldparam err [StandardError] error object if request failed
187
332
  #
188
- # @return [Google::Apis::SqladminV1::ConnectSettings]
333
+ # @return [Google::Apis::SqladminV1::Database]
189
334
  #
190
335
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
191
336
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
192
337
  # @raise [Google::Apis::AuthorizationError] Authorization is required
193
- def get_project_instance_connect_settings(project, instance, read_time: nil, fields: nil, quota_user: nil, options: nil, &block)
194
- command = make_simple_command(:get, 'v1/projects/{project}/instances/{instance}/connectSettings', options)
195
- command.response_representation = Google::Apis::SqladminV1::ConnectSettings::Representation
196
- command.response_class = Google::Apis::SqladminV1::ConnectSettings
338
+ def get_database(project, instance, database, fields: nil, quota_user: nil, options: nil, &block)
339
+ command = make_simple_command(:get, 'v1/projects/{project}/instances/{instance}/databases/{database}', options)
340
+ command.response_representation = Google::Apis::SqladminV1::Database::Representation
341
+ command.response_class = Google::Apis::SqladminV1::Database
197
342
  command.params['project'] = project unless project.nil?
198
343
  command.params['instance'] = instance unless instance.nil?
199
- command.query['readTime'] = read_time unless read_time.nil?
344
+ command.params['database'] = database unless database.nil?
200
345
  command.query['fields'] = fields unless fields.nil?
201
346
  command.query['quotaUser'] = quota_user unless quota_user.nil?
202
347
  execute_or_queue_command(command, &block)
203
348
  end
204
349
 
205
- # Generates a short-lived X509 certificate containing the provided public key
206
- # and signed by a private key specific to the target instance. Users may use the
207
- # certificate to authenticate as themselves when connecting to the database.
350
+ # Inserts a resource containing information about a database inside a Cloud SQL
351
+ # instance.
208
352
  # @param [String] project
209
- # Project ID of the Cloud SQL project.
353
+ # Project ID of the project that contains the instance.
354
+ # @param [String] instance
355
+ # Database instance ID. This does not include the project ID.
356
+ # @param [Google::Apis::SqladminV1::Database] database_object
357
+ # @param [String] fields
358
+ # Selector specifying which fields to include in a partial response.
359
+ # @param [String] quota_user
360
+ # Available to use for quota purposes for server-side applications. Can be any
361
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
362
+ # @param [Google::Apis::RequestOptions] options
363
+ # Request-specific options
364
+ #
365
+ # @yield [result, err] Result & error if block supplied
366
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
367
+ # @yieldparam err [StandardError] error object if request failed
368
+ #
369
+ # @return [Google::Apis::SqladminV1::Operation]
370
+ #
371
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
372
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
373
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
374
+ def insert_database(project, instance, database_object = nil, fields: nil, quota_user: nil, options: nil, &block)
375
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/databases', options)
376
+ command.request_representation = Google::Apis::SqladminV1::Database::Representation
377
+ command.request_object = database_object
378
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
379
+ command.response_class = Google::Apis::SqladminV1::Operation
380
+ command.params['project'] = project unless project.nil?
381
+ command.params['instance'] = instance unless instance.nil?
382
+ command.query['fields'] = fields unless fields.nil?
383
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
384
+ execute_or_queue_command(command, &block)
385
+ end
386
+
387
+ # Lists databases in the specified Cloud SQL instance.
388
+ # @param [String] project
389
+ # Project ID of the project that contains the instance.
210
390
  # @param [String] instance
211
391
  # Cloud SQL instance ID. This does not include the project ID.
212
- # @param [Google::Apis::SqladminV1::SslCertsCreateEphemeralRequest] ssl_certs_create_ephemeral_request_object
213
392
  # @param [String] fields
214
393
  # Selector specifying which fields to include in a partial response.
215
394
  # @param [String] quota_user
@@ -219,22 +398,1480 @@ module Google
219
398
  # Request-specific options
220
399
  #
221
400
  # @yield [result, err] Result & error if block supplied
222
- # @yieldparam result [Google::Apis::SqladminV1::SslCert] parsed result object
401
+ # @yieldparam result [Google::Apis::SqladminV1::DatabasesListResponse] parsed result object
223
402
  # @yieldparam err [StandardError] error object if request failed
224
403
  #
225
- # @return [Google::Apis::SqladminV1::SslCert]
404
+ # @return [Google::Apis::SqladminV1::DatabasesListResponse]
226
405
  #
227
406
  # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
228
407
  # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
229
408
  # @raise [Google::Apis::AuthorizationError] Authorization is required
230
- def create_project_instance_create_ephemeral(project, instance, ssl_certs_create_ephemeral_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
231
- command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/createEphemeral', options)
232
- command.request_representation = Google::Apis::SqladminV1::SslCertsCreateEphemeralRequest::Representation
233
- command.request_object = ssl_certs_create_ephemeral_request_object
234
- command.response_representation = Google::Apis::SqladminV1::SslCert::Representation
235
- command.response_class = Google::Apis::SqladminV1::SslCert
409
+ def list_databases(project, instance, fields: nil, quota_user: nil, options: nil, &block)
410
+ command = make_simple_command(:get, 'v1/projects/{project}/instances/{instance}/databases', options)
411
+ command.response_representation = Google::Apis::SqladminV1::DatabasesListResponse::Representation
412
+ command.response_class = Google::Apis::SqladminV1::DatabasesListResponse
413
+ command.params['project'] = project unless project.nil?
414
+ command.params['instance'] = instance unless instance.nil?
415
+ command.query['fields'] = fields unless fields.nil?
416
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
417
+ execute_or_queue_command(command, &block)
418
+ end
419
+
420
+ # Partially updates a resource containing information about a database inside a
421
+ # Cloud SQL instance. This method supports patch semantics.
422
+ # @param [String] project
423
+ # Project ID of the project that contains the instance.
424
+ # @param [String] instance
425
+ # Database instance ID. This does not include the project ID.
426
+ # @param [String] database
427
+ # Name of the database to be updated in the instance.
428
+ # @param [Google::Apis::SqladminV1::Database] database_object
429
+ # @param [String] fields
430
+ # Selector specifying which fields to include in a partial response.
431
+ # @param [String] quota_user
432
+ # Available to use for quota purposes for server-side applications. Can be any
433
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
434
+ # @param [Google::Apis::RequestOptions] options
435
+ # Request-specific options
436
+ #
437
+ # @yield [result, err] Result & error if block supplied
438
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
439
+ # @yieldparam err [StandardError] error object if request failed
440
+ #
441
+ # @return [Google::Apis::SqladminV1::Operation]
442
+ #
443
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
444
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
445
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
446
+ def patch_database(project, instance, database, database_object = nil, fields: nil, quota_user: nil, options: nil, &block)
447
+ command = make_simple_command(:patch, 'v1/projects/{project}/instances/{instance}/databases/{database}', options)
448
+ command.request_representation = Google::Apis::SqladminV1::Database::Representation
449
+ command.request_object = database_object
450
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
451
+ command.response_class = Google::Apis::SqladminV1::Operation
452
+ command.params['project'] = project unless project.nil?
453
+ command.params['instance'] = instance unless instance.nil?
454
+ command.params['database'] = database unless database.nil?
455
+ command.query['fields'] = fields unless fields.nil?
456
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
457
+ execute_or_queue_command(command, &block)
458
+ end
459
+
460
+ # Updates a resource containing information about a database inside a Cloud SQL
461
+ # instance.
462
+ # @param [String] project
463
+ # Project ID of the project that contains the instance.
464
+ # @param [String] instance
465
+ # Database instance ID. This does not include the project ID.
466
+ # @param [String] database
467
+ # Name of the database to be updated in the instance.
468
+ # @param [Google::Apis::SqladminV1::Database] database_object
469
+ # @param [String] fields
470
+ # Selector specifying which fields to include in a partial response.
471
+ # @param [String] quota_user
472
+ # Available to use for quota purposes for server-side applications. Can be any
473
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
474
+ # @param [Google::Apis::RequestOptions] options
475
+ # Request-specific options
476
+ #
477
+ # @yield [result, err] Result & error if block supplied
478
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
479
+ # @yieldparam err [StandardError] error object if request failed
480
+ #
481
+ # @return [Google::Apis::SqladminV1::Operation]
482
+ #
483
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
484
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
485
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
486
+ def update_database(project, instance, database, database_object = nil, fields: nil, quota_user: nil, options: nil, &block)
487
+ command = make_simple_command(:put, 'v1/projects/{project}/instances/{instance}/databases/{database}', options)
488
+ command.request_representation = Google::Apis::SqladminV1::Database::Representation
489
+ command.request_object = database_object
490
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
491
+ command.response_class = Google::Apis::SqladminV1::Operation
492
+ command.params['project'] = project unless project.nil?
493
+ command.params['instance'] = instance unless instance.nil?
494
+ command.params['database'] = database unless database.nil?
495
+ command.query['fields'] = fields unless fields.nil?
496
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
497
+ execute_or_queue_command(command, &block)
498
+ end
499
+
500
+ # Lists all available database flags for Cloud SQL instances.
501
+ # @param [String] database_version
502
+ # Database type and version you want to retrieve flags for. By default, this
503
+ # method returns flags for all database types and versions.
504
+ # @param [String] fields
505
+ # Selector specifying which fields to include in a partial response.
506
+ # @param [String] quota_user
507
+ # Available to use for quota purposes for server-side applications. Can be any
508
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
509
+ # @param [Google::Apis::RequestOptions] options
510
+ # Request-specific options
511
+ #
512
+ # @yield [result, err] Result & error if block supplied
513
+ # @yieldparam result [Google::Apis::SqladminV1::FlagsListResponse] parsed result object
514
+ # @yieldparam err [StandardError] error object if request failed
515
+ #
516
+ # @return [Google::Apis::SqladminV1::FlagsListResponse]
517
+ #
518
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
519
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
520
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
521
+ def list_flags(database_version: nil, fields: nil, quota_user: nil, options: nil, &block)
522
+ command = make_simple_command(:get, 'v1/flags', options)
523
+ command.response_representation = Google::Apis::SqladminV1::FlagsListResponse::Representation
524
+ command.response_class = Google::Apis::SqladminV1::FlagsListResponse
525
+ command.query['databaseVersion'] = database_version unless database_version.nil?
526
+ command.query['fields'] = fields unless fields.nil?
527
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
528
+ execute_or_queue_command(command, &block)
529
+ end
530
+
531
+ # Adds a new trusted Certificate Authority (CA) version for the specified
532
+ # instance. Required to prepare for a certificate rotation. If a CA version was
533
+ # previously added but never used in a certificate rotation, this operation
534
+ # replaces that version. There cannot be more than one CA version waiting to be
535
+ # rotated in.
536
+ # @param [String] project
537
+ # Project ID of the project that contains the instance.
538
+ # @param [String] instance
539
+ # Cloud SQL instance ID. This does not include the project ID.
540
+ # @param [String] fields
541
+ # Selector specifying which fields to include in a partial response.
542
+ # @param [String] quota_user
543
+ # Available to use for quota purposes for server-side applications. Can be any
544
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
545
+ # @param [Google::Apis::RequestOptions] options
546
+ # Request-specific options
547
+ #
548
+ # @yield [result, err] Result & error if block supplied
549
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
550
+ # @yieldparam err [StandardError] error object if request failed
551
+ #
552
+ # @return [Google::Apis::SqladminV1::Operation]
553
+ #
554
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
555
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
556
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
557
+ def add_instance_server_ca(project, instance, fields: nil, quota_user: nil, options: nil, &block)
558
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/addServerCa', options)
559
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
560
+ command.response_class = Google::Apis::SqladminV1::Operation
561
+ command.params['project'] = project unless project.nil?
562
+ command.params['instance'] = instance unless instance.nil?
563
+ command.query['fields'] = fields unless fields.nil?
564
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
565
+ execute_or_queue_command(command, &block)
566
+ end
567
+
568
+ # Creates a Cloud SQL instance as a clone of the source instance. Using this
569
+ # operation might cause your instance to restart.
570
+ # @param [String] project
571
+ # Project ID of the source as well as the clone Cloud SQL instance.
572
+ # @param [String] instance
573
+ # The ID of the Cloud SQL instance to be cloned (source). This does not include
574
+ # the project ID.
575
+ # @param [Google::Apis::SqladminV1::InstancesCloneRequest] instances_clone_request_object
576
+ # @param [String] fields
577
+ # Selector specifying which fields to include in a partial response.
578
+ # @param [String] quota_user
579
+ # Available to use for quota purposes for server-side applications. Can be any
580
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
581
+ # @param [Google::Apis::RequestOptions] options
582
+ # Request-specific options
583
+ #
584
+ # @yield [result, err] Result & error if block supplied
585
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
586
+ # @yieldparam err [StandardError] error object if request failed
587
+ #
588
+ # @return [Google::Apis::SqladminV1::Operation]
589
+ #
590
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
591
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
592
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
593
+ def clone_instance(project, instance, instances_clone_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
594
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/clone', options)
595
+ command.request_representation = Google::Apis::SqladminV1::InstancesCloneRequest::Representation
596
+ command.request_object = instances_clone_request_object
597
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
598
+ command.response_class = Google::Apis::SqladminV1::Operation
599
+ command.params['project'] = project unless project.nil?
600
+ command.params['instance'] = instance unless instance.nil?
601
+ command.query['fields'] = fields unless fields.nil?
602
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
603
+ execute_or_queue_command(command, &block)
604
+ end
605
+
606
+ # Deletes a Cloud SQL instance.
607
+ # @param [String] project
608
+ # Project ID of the project that contains the instance to be deleted.
609
+ # @param [String] instance
610
+ # Cloud SQL instance ID. This does not include the project ID.
611
+ # @param [String] fields
612
+ # Selector specifying which fields to include in a partial response.
613
+ # @param [String] quota_user
614
+ # Available to use for quota purposes for server-side applications. Can be any
615
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
616
+ # @param [Google::Apis::RequestOptions] options
617
+ # Request-specific options
618
+ #
619
+ # @yield [result, err] Result & error if block supplied
620
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
621
+ # @yieldparam err [StandardError] error object if request failed
622
+ #
623
+ # @return [Google::Apis::SqladminV1::Operation]
624
+ #
625
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
626
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
627
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
628
+ def delete_instance(project, instance, fields: nil, quota_user: nil, options: nil, &block)
629
+ command = make_simple_command(:delete, 'v1/projects/{project}/instances/{instance}', options)
630
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
631
+ command.response_class = Google::Apis::SqladminV1::Operation
632
+ command.params['project'] = project unless project.nil?
633
+ command.params['instance'] = instance unless instance.nil?
634
+ command.query['fields'] = fields unless fields.nil?
635
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
636
+ execute_or_queue_command(command, &block)
637
+ end
638
+
639
+ # Demotes the stand-alone instance to be a Cloud SQL read replica for an
640
+ # external database server.
641
+ # @param [String] project
642
+ # ID of the project that contains the instance.
643
+ # @param [String] instance
644
+ # Cloud SQL instance name.
645
+ # @param [Google::Apis::SqladminV1::InstancesDemoteMasterRequest] instances_demote_master_request_object
646
+ # @param [String] fields
647
+ # Selector specifying which fields to include in a partial response.
648
+ # @param [String] quota_user
649
+ # Available to use for quota purposes for server-side applications. Can be any
650
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
651
+ # @param [Google::Apis::RequestOptions] options
652
+ # Request-specific options
653
+ #
654
+ # @yield [result, err] Result & error if block supplied
655
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
656
+ # @yieldparam err [StandardError] error object if request failed
657
+ #
658
+ # @return [Google::Apis::SqladminV1::Operation]
659
+ #
660
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
661
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
662
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
663
+ def demote_instance_master(project, instance, instances_demote_master_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
664
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/demoteMaster', options)
665
+ command.request_representation = Google::Apis::SqladminV1::InstancesDemoteMasterRequest::Representation
666
+ command.request_object = instances_demote_master_request_object
667
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
668
+ command.response_class = Google::Apis::SqladminV1::Operation
669
+ command.params['project'] = project unless project.nil?
670
+ command.params['instance'] = instance unless instance.nil?
671
+ command.query['fields'] = fields unless fields.nil?
672
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
673
+ execute_or_queue_command(command, &block)
674
+ end
675
+
676
+ # Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL dump
677
+ # or CSV file.
678
+ # @param [String] project
679
+ # Project ID of the project that contains the instance to be exported.
680
+ # @param [String] instance
681
+ # Cloud SQL instance ID. This does not include the project ID.
682
+ # @param [Google::Apis::SqladminV1::InstancesExportRequest] instances_export_request_object
683
+ # @param [String] fields
684
+ # Selector specifying which fields to include in a partial response.
685
+ # @param [String] quota_user
686
+ # Available to use for quota purposes for server-side applications. Can be any
687
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
688
+ # @param [Google::Apis::RequestOptions] options
689
+ # Request-specific options
690
+ #
691
+ # @yield [result, err] Result & error if block supplied
692
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
693
+ # @yieldparam err [StandardError] error object if request failed
694
+ #
695
+ # @return [Google::Apis::SqladminV1::Operation]
696
+ #
697
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
698
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
699
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
700
+ def export_instance(project, instance, instances_export_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
701
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/export', options)
702
+ command.request_representation = Google::Apis::SqladminV1::InstancesExportRequest::Representation
703
+ command.request_object = instances_export_request_object
704
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
705
+ command.response_class = Google::Apis::SqladminV1::Operation
706
+ command.params['project'] = project unless project.nil?
707
+ command.params['instance'] = instance unless instance.nil?
708
+ command.query['fields'] = fields unless fields.nil?
709
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
710
+ execute_or_queue_command(command, &block)
711
+ end
712
+
713
+ # Initiates a manual failover of a high availability (HA) primary instance to a
714
+ # standby instance, which becomes the primary instance. Users are then rerouted
715
+ # to the new primary. For more information, see the Overview of high
716
+ # availability page in the Cloud SQL documentation. If using Legacy HA (MySQL
717
+ # only), this causes the instance to failover to its failover replica instance.
718
+ # @param [String] project
719
+ # ID of the project that contains the read replica.
720
+ # @param [String] instance
721
+ # Cloud SQL instance ID. This does not include the project ID.
722
+ # @param [Google::Apis::SqladminV1::InstancesFailoverRequest] instances_failover_request_object
723
+ # @param [String] fields
724
+ # Selector specifying which fields to include in a partial response.
725
+ # @param [String] quota_user
726
+ # Available to use for quota purposes for server-side applications. Can be any
727
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
728
+ # @param [Google::Apis::RequestOptions] options
729
+ # Request-specific options
730
+ #
731
+ # @yield [result, err] Result & error if block supplied
732
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
733
+ # @yieldparam err [StandardError] error object if request failed
734
+ #
735
+ # @return [Google::Apis::SqladminV1::Operation]
736
+ #
737
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
738
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
739
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
740
+ def failover_instance(project, instance, instances_failover_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
741
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/failover', options)
742
+ command.request_representation = Google::Apis::SqladminV1::InstancesFailoverRequest::Representation
743
+ command.request_object = instances_failover_request_object
744
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
745
+ command.response_class = Google::Apis::SqladminV1::Operation
746
+ command.params['project'] = project unless project.nil?
747
+ command.params['instance'] = instance unless instance.nil?
748
+ command.query['fields'] = fields unless fields.nil?
749
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
750
+ execute_or_queue_command(command, &block)
751
+ end
752
+
753
+ # Retrieves a resource containing information about a Cloud SQL instance.
754
+ # @param [String] project
755
+ # Project ID of the project that contains the instance.
756
+ # @param [String] instance
757
+ # Database instance ID. This does not include the project ID.
758
+ # @param [String] fields
759
+ # Selector specifying which fields to include in a partial response.
760
+ # @param [String] quota_user
761
+ # Available to use for quota purposes for server-side applications. Can be any
762
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
763
+ # @param [Google::Apis::RequestOptions] options
764
+ # Request-specific options
765
+ #
766
+ # @yield [result, err] Result & error if block supplied
767
+ # @yieldparam result [Google::Apis::SqladminV1::DatabaseInstance] parsed result object
768
+ # @yieldparam err [StandardError] error object if request failed
769
+ #
770
+ # @return [Google::Apis::SqladminV1::DatabaseInstance]
771
+ #
772
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
773
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
774
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
775
+ def get_instance(project, instance, fields: nil, quota_user: nil, options: nil, &block)
776
+ command = make_simple_command(:get, 'v1/projects/{project}/instances/{instance}', options)
777
+ command.response_representation = Google::Apis::SqladminV1::DatabaseInstance::Representation
778
+ command.response_class = Google::Apis::SqladminV1::DatabaseInstance
779
+ command.params['project'] = project unless project.nil?
780
+ command.params['instance'] = instance unless instance.nil?
781
+ command.query['fields'] = fields unless fields.nil?
782
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
783
+ execute_or_queue_command(command, &block)
784
+ end
785
+
786
+ # Imports data into a Cloud SQL instance from a SQL dump or CSV file in Cloud
787
+ # Storage.
788
+ # @param [String] project
789
+ # Project ID of the project that contains the instance.
790
+ # @param [String] instance
791
+ # Cloud SQL instance ID. This does not include the project ID.
792
+ # @param [Google::Apis::SqladminV1::InstancesImportRequest] instances_import_request_object
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::SqladminV1::Operation] parsed result object
803
+ # @yieldparam err [StandardError] error object if request failed
804
+ #
805
+ # @return [Google::Apis::SqladminV1::Operation]
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 import_instance(project, instance, instances_import_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
811
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/import', options)
812
+ command.request_representation = Google::Apis::SqladminV1::InstancesImportRequest::Representation
813
+ command.request_object = instances_import_request_object
814
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
815
+ command.response_class = Google::Apis::SqladminV1::Operation
816
+ command.params['project'] = project unless project.nil?
817
+ command.params['instance'] = instance unless instance.nil?
818
+ command.query['fields'] = fields unless fields.nil?
819
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
820
+ execute_or_queue_command(command, &block)
821
+ end
822
+
823
+ # Creates a new Cloud SQL instance.
824
+ # @param [String] project
825
+ # Project ID of the project to which the newly created Cloud SQL instances
826
+ # should belong.
827
+ # @param [Google::Apis::SqladminV1::DatabaseInstance] database_instance_object
828
+ # @param [String] fields
829
+ # Selector specifying which fields to include in a partial response.
830
+ # @param [String] quota_user
831
+ # Available to use for quota purposes for server-side applications. Can be any
832
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
833
+ # @param [Google::Apis::RequestOptions] options
834
+ # Request-specific options
835
+ #
836
+ # @yield [result, err] Result & error if block supplied
837
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
838
+ # @yieldparam err [StandardError] error object if request failed
839
+ #
840
+ # @return [Google::Apis::SqladminV1::Operation]
841
+ #
842
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
843
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
844
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
845
+ def insert_instance(project, database_instance_object = nil, fields: nil, quota_user: nil, options: nil, &block)
846
+ command = make_simple_command(:post, 'v1/projects/{project}/instances', options)
847
+ command.request_representation = Google::Apis::SqladminV1::DatabaseInstance::Representation
848
+ command.request_object = database_instance_object
849
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
850
+ command.response_class = Google::Apis::SqladminV1::Operation
851
+ command.params['project'] = project unless project.nil?
852
+ command.query['fields'] = fields unless fields.nil?
853
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
854
+ execute_or_queue_command(command, &block)
855
+ end
856
+
857
+ # Lists instances under a given project.
858
+ # @param [String] project
859
+ # Project ID of the project for which to list Cloud SQL instances.
860
+ # @param [String] filter
861
+ # A filter expression that filters resources listed in the response. The
862
+ # expression is in the form of field:value. For example, 'instanceType:
863
+ # CLOUD_SQL_INSTANCE'. Fields can be nested as needed as per their JSON
864
+ # representation, such as 'settings.userLabels.auto_start:true'. Multiple filter
865
+ # queries are space-separated. For example. 'state:RUNNABLE instanceType:
866
+ # CLOUD_SQL_INSTANCE'. By default, each expression is an AND expression. However,
867
+ # you can include AND and OR expressions explicitly.
868
+ # @param [Fixnum] max_results
869
+ # The maximum number of results to return per response.
870
+ # @param [String] page_token
871
+ # A previously-returned page token representing part of the larger set of
872
+ # results to view.
873
+ # @param [String] fields
874
+ # Selector specifying which fields to include in a partial response.
875
+ # @param [String] quota_user
876
+ # Available to use for quota purposes for server-side applications. Can be any
877
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
878
+ # @param [Google::Apis::RequestOptions] options
879
+ # Request-specific options
880
+ #
881
+ # @yield [result, err] Result & error if block supplied
882
+ # @yieldparam result [Google::Apis::SqladminV1::InstancesListResponse] parsed result object
883
+ # @yieldparam err [StandardError] error object if request failed
884
+ #
885
+ # @return [Google::Apis::SqladminV1::InstancesListResponse]
886
+ #
887
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
888
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
889
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
890
+ def list_instances(project, filter: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
891
+ command = make_simple_command(:get, 'v1/projects/{project}/instances', options)
892
+ command.response_representation = Google::Apis::SqladminV1::InstancesListResponse::Representation
893
+ command.response_class = Google::Apis::SqladminV1::InstancesListResponse
894
+ command.params['project'] = project unless project.nil?
895
+ command.query['filter'] = filter unless filter.nil?
896
+ command.query['maxResults'] = max_results unless max_results.nil?
897
+ command.query['pageToken'] = page_token unless page_token.nil?
898
+ command.query['fields'] = fields unless fields.nil?
899
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
900
+ execute_or_queue_command(command, &block)
901
+ end
902
+
903
+ # Lists all of the trusted Certificate Authorities (CAs) for the specified
904
+ # instance. There can be up to three CAs listed: the CA that was used to sign
905
+ # the certificate that is currently in use, a CA that has been added but not yet
906
+ # used to sign a certificate, and a CA used to sign a certificate that has
907
+ # previously rotated out.
908
+ # @param [String] project
909
+ # Project ID of the project that contains the instance.
910
+ # @param [String] instance
911
+ # Cloud SQL instance ID. This does not include the project ID.
912
+ # @param [String] fields
913
+ # Selector specifying which fields to include in a partial response.
914
+ # @param [String] quota_user
915
+ # Available to use for quota purposes for server-side applications. Can be any
916
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
917
+ # @param [Google::Apis::RequestOptions] options
918
+ # Request-specific options
919
+ #
920
+ # @yield [result, err] Result & error if block supplied
921
+ # @yieldparam result [Google::Apis::SqladminV1::InstancesListServerCasResponse] parsed result object
922
+ # @yieldparam err [StandardError] error object if request failed
923
+ #
924
+ # @return [Google::Apis::SqladminV1::InstancesListServerCasResponse]
925
+ #
926
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
927
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
928
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
929
+ def list_instance_server_cas(project, instance, fields: nil, quota_user: nil, options: nil, &block)
930
+ command = make_simple_command(:get, 'v1/projects/{project}/instances/{instance}/listServerCas', options)
931
+ command.response_representation = Google::Apis::SqladminV1::InstancesListServerCasResponse::Representation
932
+ command.response_class = Google::Apis::SqladminV1::InstancesListServerCasResponse
933
+ command.params['project'] = project unless project.nil?
934
+ command.params['instance'] = instance unless instance.nil?
935
+ command.query['fields'] = fields unless fields.nil?
936
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
937
+ execute_or_queue_command(command, &block)
938
+ end
939
+
940
+ # Updates settings of a Cloud SQL instance. This method supports patch semantics.
941
+ # @param [String] project
942
+ # Project ID of the project that contains the instance.
943
+ # @param [String] instance
944
+ # Cloud SQL instance ID. This does not include the project ID.
945
+ # @param [Google::Apis::SqladminV1::DatabaseInstance] database_instance_object
946
+ # @param [String] fields
947
+ # Selector specifying which fields to include in a partial response.
948
+ # @param [String] quota_user
949
+ # Available to use for quota purposes for server-side applications. Can be any
950
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
951
+ # @param [Google::Apis::RequestOptions] options
952
+ # Request-specific options
953
+ #
954
+ # @yield [result, err] Result & error if block supplied
955
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
956
+ # @yieldparam err [StandardError] error object if request failed
957
+ #
958
+ # @return [Google::Apis::SqladminV1::Operation]
959
+ #
960
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
961
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
962
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
963
+ def patch_instance(project, instance, database_instance_object = nil, fields: nil, quota_user: nil, options: nil, &block)
964
+ command = make_simple_command(:patch, 'v1/projects/{project}/instances/{instance}', options)
965
+ command.request_representation = Google::Apis::SqladminV1::DatabaseInstance::Representation
966
+ command.request_object = database_instance_object
967
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
968
+ command.response_class = Google::Apis::SqladminV1::Operation
969
+ command.params['project'] = project unless project.nil?
970
+ command.params['instance'] = instance unless instance.nil?
971
+ command.query['fields'] = fields unless fields.nil?
972
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
973
+ execute_or_queue_command(command, &block)
974
+ end
975
+
976
+ # Promotes the read replica instance to be a stand-alone Cloud SQL instance.
977
+ # Using this operation might cause your instance to restart.
978
+ # @param [String] project
979
+ # ID of the project that contains the read replica.
980
+ # @param [String] instance
981
+ # Cloud SQL read replica instance name.
982
+ # @param [String] fields
983
+ # Selector specifying which fields to include in a partial response.
984
+ # @param [String] quota_user
985
+ # Available to use for quota purposes for server-side applications. Can be any
986
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
987
+ # @param [Google::Apis::RequestOptions] options
988
+ # Request-specific options
989
+ #
990
+ # @yield [result, err] Result & error if block supplied
991
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
992
+ # @yieldparam err [StandardError] error object if request failed
993
+ #
994
+ # @return [Google::Apis::SqladminV1::Operation]
995
+ #
996
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
997
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
998
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
999
+ def promote_instance_replica(project, instance, fields: nil, quota_user: nil, options: nil, &block)
1000
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/promoteReplica', options)
1001
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1002
+ command.response_class = Google::Apis::SqladminV1::Operation
1003
+ command.params['project'] = project unless project.nil?
1004
+ command.params['instance'] = instance unless instance.nil?
1005
+ command.query['fields'] = fields unless fields.nil?
1006
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1007
+ execute_or_queue_command(command, &block)
1008
+ end
1009
+
1010
+ # Deletes all client certificates and generates a new server SSL certificate for
1011
+ # the instance.
1012
+ # @param [String] project
1013
+ # Project ID of the project that contains the instance.
1014
+ # @param [String] instance
1015
+ # Cloud SQL instance ID. This does not include the project ID.
1016
+ # @param [String] fields
1017
+ # Selector specifying which fields to include in a partial response.
1018
+ # @param [String] quota_user
1019
+ # Available to use for quota purposes for server-side applications. Can be any
1020
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1021
+ # @param [Google::Apis::RequestOptions] options
1022
+ # Request-specific options
1023
+ #
1024
+ # @yield [result, err] Result & error if block supplied
1025
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1026
+ # @yieldparam err [StandardError] error object if request failed
1027
+ #
1028
+ # @return [Google::Apis::SqladminV1::Operation]
1029
+ #
1030
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1031
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1032
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1033
+ def reset_instance_ssl_config(project, instance, fields: nil, quota_user: nil, options: nil, &block)
1034
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/resetSslConfig', options)
1035
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1036
+ command.response_class = Google::Apis::SqladminV1::Operation
1037
+ command.params['project'] = project unless project.nil?
1038
+ command.params['instance'] = instance unless instance.nil?
1039
+ command.query['fields'] = fields unless fields.nil?
1040
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1041
+ execute_or_queue_command(command, &block)
1042
+ end
1043
+
1044
+ # Restarts a Cloud SQL instance.
1045
+ # @param [String] project
1046
+ # Project ID of the project that contains the instance to be restarted.
1047
+ # @param [String] instance
1048
+ # Cloud SQL instance ID. This does not include the project ID.
1049
+ # @param [String] fields
1050
+ # Selector specifying which fields to include in a partial response.
1051
+ # @param [String] quota_user
1052
+ # Available to use for quota purposes for server-side applications. Can be any
1053
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1054
+ # @param [Google::Apis::RequestOptions] options
1055
+ # Request-specific options
1056
+ #
1057
+ # @yield [result, err] Result & error if block supplied
1058
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1059
+ # @yieldparam err [StandardError] error object if request failed
1060
+ #
1061
+ # @return [Google::Apis::SqladminV1::Operation]
1062
+ #
1063
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1064
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1065
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1066
+ def restart_instance(project, instance, fields: nil, quota_user: nil, options: nil, &block)
1067
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/restart', options)
1068
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1069
+ command.response_class = Google::Apis::SqladminV1::Operation
1070
+ command.params['project'] = project unless project.nil?
1071
+ command.params['instance'] = instance unless instance.nil?
1072
+ command.query['fields'] = fields unless fields.nil?
1073
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1074
+ execute_or_queue_command(command, &block)
1075
+ end
1076
+
1077
+ # Restores a backup of a Cloud SQL instance. Using this operation might cause
1078
+ # your instance to restart.
1079
+ # @param [String] project
1080
+ # Project ID of the project that contains the instance.
1081
+ # @param [String] instance
1082
+ # Cloud SQL instance ID. This does not include the project ID.
1083
+ # @param [Google::Apis::SqladminV1::InstancesRestoreBackupRequest] instances_restore_backup_request_object
1084
+ # @param [String] fields
1085
+ # Selector specifying which fields to include in a partial response.
1086
+ # @param [String] quota_user
1087
+ # Available to use for quota purposes for server-side applications. Can be any
1088
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1089
+ # @param [Google::Apis::RequestOptions] options
1090
+ # Request-specific options
1091
+ #
1092
+ # @yield [result, err] Result & error if block supplied
1093
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1094
+ # @yieldparam err [StandardError] error object if request failed
1095
+ #
1096
+ # @return [Google::Apis::SqladminV1::Operation]
1097
+ #
1098
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1099
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1100
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1101
+ def restore_instance_backup(project, instance, instances_restore_backup_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1102
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/restoreBackup', options)
1103
+ command.request_representation = Google::Apis::SqladminV1::InstancesRestoreBackupRequest::Representation
1104
+ command.request_object = instances_restore_backup_request_object
1105
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1106
+ command.response_class = Google::Apis::SqladminV1::Operation
1107
+ command.params['project'] = project unless project.nil?
1108
+ command.params['instance'] = instance unless instance.nil?
1109
+ command.query['fields'] = fields unless fields.nil?
1110
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1111
+ execute_or_queue_command(command, &block)
1112
+ end
1113
+
1114
+ # Rotates the server certificate to one signed by the Certificate Authority (CA)
1115
+ # version previously added with the addServerCA method.
1116
+ # @param [String] project
1117
+ # Project ID of the project that contains the instance.
1118
+ # @param [String] instance
1119
+ # Cloud SQL instance ID. This does not include the project ID.
1120
+ # @param [Google::Apis::SqladminV1::InstancesRotateServerCaRequest] instances_rotate_server_ca_request_object
1121
+ # @param [String] fields
1122
+ # Selector specifying which fields to include in a partial response.
1123
+ # @param [String] quota_user
1124
+ # Available to use for quota purposes for server-side applications. Can be any
1125
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1126
+ # @param [Google::Apis::RequestOptions] options
1127
+ # Request-specific options
1128
+ #
1129
+ # @yield [result, err] Result & error if block supplied
1130
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1131
+ # @yieldparam err [StandardError] error object if request failed
1132
+ #
1133
+ # @return [Google::Apis::SqladminV1::Operation]
1134
+ #
1135
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1136
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1137
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1138
+ def rotate_instance_server_ca(project, instance, instances_rotate_server_ca_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1139
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/rotateServerCa', options)
1140
+ command.request_representation = Google::Apis::SqladminV1::InstancesRotateServerCaRequest::Representation
1141
+ command.request_object = instances_rotate_server_ca_request_object
1142
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1143
+ command.response_class = Google::Apis::SqladminV1::Operation
1144
+ command.params['project'] = project unless project.nil?
1145
+ command.params['instance'] = instance unless instance.nil?
1146
+ command.query['fields'] = fields unless fields.nil?
1147
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1148
+ execute_or_queue_command(command, &block)
1149
+ end
1150
+
1151
+ # Starts the replication in the read replica instance.
1152
+ # @param [String] project
1153
+ # ID of the project that contains the read replica.
1154
+ # @param [String] instance
1155
+ # Cloud SQL read replica instance name.
1156
+ # @param [String] fields
1157
+ # Selector specifying which fields to include in a partial response.
1158
+ # @param [String] quota_user
1159
+ # Available to use for quota purposes for server-side applications. Can be any
1160
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1161
+ # @param [Google::Apis::RequestOptions] options
1162
+ # Request-specific options
1163
+ #
1164
+ # @yield [result, err] Result & error if block supplied
1165
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1166
+ # @yieldparam err [StandardError] error object if request failed
1167
+ #
1168
+ # @return [Google::Apis::SqladminV1::Operation]
1169
+ #
1170
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1171
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1172
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1173
+ def start_instance_replica(project, instance, fields: nil, quota_user: nil, options: nil, &block)
1174
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/startReplica', options)
1175
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1176
+ command.response_class = Google::Apis::SqladminV1::Operation
1177
+ command.params['project'] = project unless project.nil?
1178
+ command.params['instance'] = instance unless instance.nil?
1179
+ command.query['fields'] = fields unless fields.nil?
1180
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1181
+ execute_or_queue_command(command, &block)
1182
+ end
1183
+
1184
+ # Stops the replication in the read replica instance.
1185
+ # @param [String] project
1186
+ # ID of the project that contains the read replica.
1187
+ # @param [String] instance
1188
+ # Cloud SQL read replica instance name.
1189
+ # @param [String] fields
1190
+ # Selector specifying which fields to include in a partial response.
1191
+ # @param [String] quota_user
1192
+ # Available to use for quota purposes for server-side applications. Can be any
1193
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1194
+ # @param [Google::Apis::RequestOptions] options
1195
+ # Request-specific options
1196
+ #
1197
+ # @yield [result, err] Result & error if block supplied
1198
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1199
+ # @yieldparam err [StandardError] error object if request failed
1200
+ #
1201
+ # @return [Google::Apis::SqladminV1::Operation]
1202
+ #
1203
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1204
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1205
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1206
+ def stop_instance_replica(project, instance, fields: nil, quota_user: nil, options: nil, &block)
1207
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/stopReplica', options)
1208
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1209
+ command.response_class = Google::Apis::SqladminV1::Operation
1210
+ command.params['project'] = project unless project.nil?
1211
+ command.params['instance'] = instance unless instance.nil?
1212
+ command.query['fields'] = fields unless fields.nil?
1213
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1214
+ execute_or_queue_command(command, &block)
1215
+ end
1216
+
1217
+ # Truncate MySQL general and slow query log tables MySQL only.
1218
+ # @param [String] project
1219
+ # Project ID of the Cloud SQL project.
1220
+ # @param [String] instance
1221
+ # Cloud SQL instance ID. This does not include the project ID.
1222
+ # @param [Google::Apis::SqladminV1::InstancesTruncateLogRequest] instances_truncate_log_request_object
1223
+ # @param [String] fields
1224
+ # Selector specifying which fields to include in a partial response.
1225
+ # @param [String] quota_user
1226
+ # Available to use for quota purposes for server-side applications. Can be any
1227
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1228
+ # @param [Google::Apis::RequestOptions] options
1229
+ # Request-specific options
1230
+ #
1231
+ # @yield [result, err] Result & error if block supplied
1232
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1233
+ # @yieldparam err [StandardError] error object if request failed
1234
+ #
1235
+ # @return [Google::Apis::SqladminV1::Operation]
1236
+ #
1237
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1238
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1239
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1240
+ def truncate_instance_log(project, instance, instances_truncate_log_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1241
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/truncateLog', options)
1242
+ command.request_representation = Google::Apis::SqladminV1::InstancesTruncateLogRequest::Representation
1243
+ command.request_object = instances_truncate_log_request_object
1244
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1245
+ command.response_class = Google::Apis::SqladminV1::Operation
1246
+ command.params['project'] = project unless project.nil?
1247
+ command.params['instance'] = instance unless instance.nil?
1248
+ command.query['fields'] = fields unless fields.nil?
1249
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1250
+ execute_or_queue_command(command, &block)
1251
+ end
1252
+
1253
+ # Updates settings of a Cloud SQL instance. Using this operation might cause
1254
+ # your instance to restart.
1255
+ # @param [String] project
1256
+ # Project ID of the project that contains the instance.
1257
+ # @param [String] instance
1258
+ # Cloud SQL instance ID. This does not include the project ID.
1259
+ # @param [Google::Apis::SqladminV1::DatabaseInstance] database_instance_object
1260
+ # @param [String] fields
1261
+ # Selector specifying which fields to include in a partial response.
1262
+ # @param [String] quota_user
1263
+ # Available to use for quota purposes for server-side applications. Can be any
1264
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1265
+ # @param [Google::Apis::RequestOptions] options
1266
+ # Request-specific options
1267
+ #
1268
+ # @yield [result, err] Result & error if block supplied
1269
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1270
+ # @yieldparam err [StandardError] error object if request failed
1271
+ #
1272
+ # @return [Google::Apis::SqladminV1::Operation]
1273
+ #
1274
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1275
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1276
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1277
+ def update_instance(project, instance, database_instance_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1278
+ command = make_simple_command(:put, 'v1/projects/{project}/instances/{instance}', options)
1279
+ command.request_representation = Google::Apis::SqladminV1::DatabaseInstance::Representation
1280
+ command.request_object = database_instance_object
1281
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1282
+ command.response_class = Google::Apis::SqladminV1::Operation
1283
+ command.params['project'] = project unless project.nil?
1284
+ command.params['instance'] = instance unless instance.nil?
1285
+ command.query['fields'] = fields unless fields.nil?
1286
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1287
+ execute_or_queue_command(command, &block)
1288
+ end
1289
+
1290
+ # Retrieves an instance operation that has been performed on an instance.
1291
+ # @param [String] project
1292
+ # Project ID of the project that contains the instance.
1293
+ # @param [String] operation
1294
+ # Instance operation ID.
1295
+ # @param [String] fields
1296
+ # Selector specifying which fields to include in a partial response.
1297
+ # @param [String] quota_user
1298
+ # Available to use for quota purposes for server-side applications. Can be any
1299
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1300
+ # @param [Google::Apis::RequestOptions] options
1301
+ # Request-specific options
1302
+ #
1303
+ # @yield [result, err] Result & error if block supplied
1304
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1305
+ # @yieldparam err [StandardError] error object if request failed
1306
+ #
1307
+ # @return [Google::Apis::SqladminV1::Operation]
1308
+ #
1309
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1310
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1311
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1312
+ def get_operation(project, operation, fields: nil, quota_user: nil, options: nil, &block)
1313
+ command = make_simple_command(:get, 'v1/projects/{project}/operations/{operation}', options)
1314
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1315
+ command.response_class = Google::Apis::SqladminV1::Operation
1316
+ command.params['project'] = project unless project.nil?
1317
+ command.params['operation'] = operation unless operation.nil?
1318
+ command.query['fields'] = fields unless fields.nil?
1319
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1320
+ execute_or_queue_command(command, &block)
1321
+ end
1322
+
1323
+ # Lists all instance operations that have been performed on the given Cloud SQL
1324
+ # instance in the reverse chronological order of the start time.
1325
+ # @param [String] project
1326
+ # Project ID of the project that contains the instance.
1327
+ # @param [String] instance
1328
+ # Cloud SQL instance ID. This does not include the project ID.
1329
+ # @param [Fixnum] max_results
1330
+ # Maximum number of operations per response.
1331
+ # @param [String] page_token
1332
+ # A previously-returned page token representing part of the larger set of
1333
+ # results to view.
1334
+ # @param [String] fields
1335
+ # Selector specifying which fields to include in a partial response.
1336
+ # @param [String] quota_user
1337
+ # Available to use for quota purposes for server-side applications. Can be any
1338
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1339
+ # @param [Google::Apis::RequestOptions] options
1340
+ # Request-specific options
1341
+ #
1342
+ # @yield [result, err] Result & error if block supplied
1343
+ # @yieldparam result [Google::Apis::SqladminV1::OperationsListResponse] parsed result object
1344
+ # @yieldparam err [StandardError] error object if request failed
1345
+ #
1346
+ # @return [Google::Apis::SqladminV1::OperationsListResponse]
1347
+ #
1348
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1349
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1350
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1351
+ def list_operations(project, instance: nil, max_results: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
1352
+ command = make_simple_command(:get, 'v1/projects/{project}/operations', options)
1353
+ command.response_representation = Google::Apis::SqladminV1::OperationsListResponse::Representation
1354
+ command.response_class = Google::Apis::SqladminV1::OperationsListResponse
1355
+ command.params['project'] = project unless project.nil?
1356
+ command.query['instance'] = instance unless instance.nil?
1357
+ command.query['maxResults'] = max_results unless max_results.nil?
1358
+ command.query['pageToken'] = page_token unless page_token.nil?
1359
+ command.query['fields'] = fields unless fields.nil?
1360
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1361
+ execute_or_queue_command(command, &block)
1362
+ end
1363
+
1364
+ # Reschedules the maintenance on the given instance.
1365
+ # @param [String] project
1366
+ # ID of the project that contains the instance.
1367
+ # @param [String] instance
1368
+ # Cloud SQL instance ID. This does not include the project ID.
1369
+ # @param [Google::Apis::SqladminV1::SqlInstancesRescheduleMaintenanceRequestBody] sql_instances_reschedule_maintenance_request_body_object
1370
+ # @param [String] fields
1371
+ # Selector specifying which fields to include in a partial response.
1372
+ # @param [String] quota_user
1373
+ # Available to use for quota purposes for server-side applications. Can be any
1374
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1375
+ # @param [Google::Apis::RequestOptions] options
1376
+ # Request-specific options
1377
+ #
1378
+ # @yield [result, err] Result & error if block supplied
1379
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1380
+ # @yieldparam err [StandardError] error object if request failed
1381
+ #
1382
+ # @return [Google::Apis::SqladminV1::Operation]
1383
+ #
1384
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1385
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1386
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1387
+ def reschedule_project_instance_maintenance(project, instance, sql_instances_reschedule_maintenance_request_body_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1388
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/rescheduleMaintenance', options)
1389
+ command.request_representation = Google::Apis::SqladminV1::SqlInstancesRescheduleMaintenanceRequestBody::Representation
1390
+ command.request_object = sql_instances_reschedule_maintenance_request_body_object
1391
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1392
+ command.response_class = Google::Apis::SqladminV1::Operation
1393
+ command.params['project'] = project unless project.nil?
1394
+ command.params['instance'] = instance unless instance.nil?
1395
+ command.query['fields'] = fields unless fields.nil?
1396
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1397
+ execute_or_queue_command(command, &block)
1398
+ end
1399
+
1400
+ # Start External primary instance migration.
1401
+ # @param [String] project
1402
+ # ID of the project that contains the instance.
1403
+ # @param [String] instance
1404
+ # Cloud SQL instance ID. This does not include the project ID.
1405
+ # @param [Boolean] skip_verification
1406
+ # Whether to skip the verification step (VESS).
1407
+ # @param [String] sync_mode
1408
+ # External sync mode.
1409
+ # @param [String] fields
1410
+ # Selector specifying which fields to include in a partial response.
1411
+ # @param [String] quota_user
1412
+ # Available to use for quota purposes for server-side applications. Can be any
1413
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1414
+ # @param [Google::Apis::RequestOptions] options
1415
+ # Request-specific options
1416
+ #
1417
+ # @yield [result, err] Result & error if block supplied
1418
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1419
+ # @yieldparam err [StandardError] error object if request failed
1420
+ #
1421
+ # @return [Google::Apis::SqladminV1::Operation]
1422
+ #
1423
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1424
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1425
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1426
+ def start_project_instance_external_sync(project, instance, skip_verification: nil, sync_mode: nil, fields: nil, quota_user: nil, options: nil, &block)
1427
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/startExternalSync', options)
1428
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1429
+ command.response_class = Google::Apis::SqladminV1::Operation
1430
+ command.params['project'] = project unless project.nil?
1431
+ command.params['instance'] = instance unless instance.nil?
1432
+ command.query['skipVerification'] = skip_verification unless skip_verification.nil?
1433
+ command.query['syncMode'] = sync_mode unless sync_mode.nil?
1434
+ command.query['fields'] = fields unless fields.nil?
1435
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1436
+ execute_or_queue_command(command, &block)
1437
+ end
1438
+
1439
+ # Verify External primary instance external sync settings.
1440
+ # @param [String] project
1441
+ # Project ID of the project that contains the instance.
1442
+ # @param [String] instance
1443
+ # Cloud SQL instance ID. This does not include the project ID.
1444
+ # @param [String] sync_mode
1445
+ # External sync mode
1446
+ # @param [Boolean] verify_connection_only
1447
+ # Flag to enable verifying connection only
1448
+ # @param [String] fields
1449
+ # Selector specifying which fields to include in a partial response.
1450
+ # @param [String] quota_user
1451
+ # Available to use for quota purposes for server-side applications. Can be any
1452
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1453
+ # @param [Google::Apis::RequestOptions] options
1454
+ # Request-specific options
1455
+ #
1456
+ # @yield [result, err] Result & error if block supplied
1457
+ # @yieldparam result [Google::Apis::SqladminV1::SqlInstancesVerifyExternalSyncSettingsResponse] parsed result object
1458
+ # @yieldparam err [StandardError] error object if request failed
1459
+ #
1460
+ # @return [Google::Apis::SqladminV1::SqlInstancesVerifyExternalSyncSettingsResponse]
1461
+ #
1462
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1463
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1464
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1465
+ def verify_project_instance_external_sync_settings(project, instance, sync_mode: nil, verify_connection_only: nil, fields: nil, quota_user: nil, options: nil, &block)
1466
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/verifyExternalSyncSettings', options)
1467
+ command.response_representation = Google::Apis::SqladminV1::SqlInstancesVerifyExternalSyncSettingsResponse::Representation
1468
+ command.response_class = Google::Apis::SqladminV1::SqlInstancesVerifyExternalSyncSettingsResponse
1469
+ command.params['project'] = project unless project.nil?
1470
+ command.params['instance'] = instance unless instance.nil?
1471
+ command.query['syncMode'] = sync_mode unless sync_mode.nil?
1472
+ command.query['verifyConnectionOnly'] = verify_connection_only unless verify_connection_only.nil?
1473
+ command.query['fields'] = fields unless fields.nil?
1474
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1475
+ execute_or_queue_command(command, &block)
1476
+ end
1477
+
1478
+ # Generates a short-lived X509 certificate containing the provided public key
1479
+ # and signed by a private key specific to the target instance. Users may use the
1480
+ # certificate to authenticate as themselves when connecting to the database.
1481
+ # @param [String] project
1482
+ # Project ID of the Cloud SQL project.
1483
+ # @param [String] instance
1484
+ # Cloud SQL instance ID. This does not include the project ID.
1485
+ # @param [Google::Apis::SqladminV1::SslCertsCreateEphemeralRequest] ssl_certs_create_ephemeral_request_object
1486
+ # @param [String] fields
1487
+ # Selector specifying which fields to include in a partial response.
1488
+ # @param [String] quota_user
1489
+ # Available to use for quota purposes for server-side applications. Can be any
1490
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1491
+ # @param [Google::Apis::RequestOptions] options
1492
+ # Request-specific options
1493
+ #
1494
+ # @yield [result, err] Result & error if block supplied
1495
+ # @yieldparam result [Google::Apis::SqladminV1::SslCert] parsed result object
1496
+ # @yieldparam err [StandardError] error object if request failed
1497
+ #
1498
+ # @return [Google::Apis::SqladminV1::SslCert]
1499
+ #
1500
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1501
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1502
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1503
+ def create_ssl_cert_ephemeral(project, instance, ssl_certs_create_ephemeral_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1504
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/createEphemeral', options)
1505
+ command.request_representation = Google::Apis::SqladminV1::SslCertsCreateEphemeralRequest::Representation
1506
+ command.request_object = ssl_certs_create_ephemeral_request_object
1507
+ command.response_representation = Google::Apis::SqladminV1::SslCert::Representation
1508
+ command.response_class = Google::Apis::SqladminV1::SslCert
1509
+ command.params['project'] = project unless project.nil?
1510
+ command.params['instance'] = instance unless instance.nil?
1511
+ command.query['fields'] = fields unless fields.nil?
1512
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1513
+ execute_or_queue_command(command, &block)
1514
+ end
1515
+
1516
+ # Deletes the SSL certificate. For First Generation instances, the certificate
1517
+ # remains valid until the instance is restarted.
1518
+ # @param [String] project
1519
+ # Project ID of the project that contains the instance.
1520
+ # @param [String] instance
1521
+ # Cloud SQL instance ID. This does not include the project ID.
1522
+ # @param [String] sha1_fingerprint
1523
+ # Sha1 FingerPrint.
1524
+ # @param [String] fields
1525
+ # Selector specifying which fields to include in a partial response.
1526
+ # @param [String] quota_user
1527
+ # Available to use for quota purposes for server-side applications. Can be any
1528
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1529
+ # @param [Google::Apis::RequestOptions] options
1530
+ # Request-specific options
1531
+ #
1532
+ # @yield [result, err] Result & error if block supplied
1533
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1534
+ # @yieldparam err [StandardError] error object if request failed
1535
+ #
1536
+ # @return [Google::Apis::SqladminV1::Operation]
1537
+ #
1538
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1539
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1540
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1541
+ def delete_ssl_cert(project, instance, sha1_fingerprint, fields: nil, quota_user: nil, options: nil, &block)
1542
+ command = make_simple_command(:delete, 'v1/projects/{project}/instances/{instance}/sslCerts/{sha1Fingerprint}', options)
1543
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1544
+ command.response_class = Google::Apis::SqladminV1::Operation
1545
+ command.params['project'] = project unless project.nil?
1546
+ command.params['instance'] = instance unless instance.nil?
1547
+ command.params['sha1Fingerprint'] = sha1_fingerprint unless sha1_fingerprint.nil?
1548
+ command.query['fields'] = fields unless fields.nil?
1549
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1550
+ execute_or_queue_command(command, &block)
1551
+ end
1552
+
1553
+ # Retrieves a particular SSL certificate. Does not include the private key (
1554
+ # required for usage). The private key must be saved from the response to
1555
+ # initial creation.
1556
+ # @param [String] project
1557
+ # Project ID of the project that contains the instance.
1558
+ # @param [String] instance
1559
+ # Cloud SQL instance ID. This does not include the project ID.
1560
+ # @param [String] sha1_fingerprint
1561
+ # Sha1 FingerPrint.
1562
+ # @param [String] fields
1563
+ # Selector specifying which fields to include in a partial response.
1564
+ # @param [String] quota_user
1565
+ # Available to use for quota purposes for server-side applications. Can be any
1566
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1567
+ # @param [Google::Apis::RequestOptions] options
1568
+ # Request-specific options
1569
+ #
1570
+ # @yield [result, err] Result & error if block supplied
1571
+ # @yieldparam result [Google::Apis::SqladminV1::SslCert] parsed result object
1572
+ # @yieldparam err [StandardError] error object if request failed
1573
+ #
1574
+ # @return [Google::Apis::SqladminV1::SslCert]
1575
+ #
1576
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1577
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1578
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1579
+ def get_ssl_cert(project, instance, sha1_fingerprint, fields: nil, quota_user: nil, options: nil, &block)
1580
+ command = make_simple_command(:get, 'v1/projects/{project}/instances/{instance}/sslCerts/{sha1Fingerprint}', options)
1581
+ command.response_representation = Google::Apis::SqladminV1::SslCert::Representation
1582
+ command.response_class = Google::Apis::SqladminV1::SslCert
1583
+ command.params['project'] = project unless project.nil?
1584
+ command.params['instance'] = instance unless instance.nil?
1585
+ command.params['sha1Fingerprint'] = sha1_fingerprint unless sha1_fingerprint.nil?
1586
+ command.query['fields'] = fields unless fields.nil?
1587
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1588
+ execute_or_queue_command(command, &block)
1589
+ end
1590
+
1591
+ # Creates an SSL certificate and returns it along with the private key and
1592
+ # server certificate authority. The new certificate will not be usable until the
1593
+ # instance is restarted.
1594
+ # @param [String] project
1595
+ # Project ID of the project that contains the instance.
1596
+ # @param [String] instance
1597
+ # Cloud SQL instance ID. This does not include the project ID.
1598
+ # @param [Google::Apis::SqladminV1::SslCertsInsertRequest] ssl_certs_insert_request_object
1599
+ # @param [String] fields
1600
+ # Selector specifying which fields to include in a partial response.
1601
+ # @param [String] quota_user
1602
+ # Available to use for quota purposes for server-side applications. Can be any
1603
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1604
+ # @param [Google::Apis::RequestOptions] options
1605
+ # Request-specific options
1606
+ #
1607
+ # @yield [result, err] Result & error if block supplied
1608
+ # @yieldparam result [Google::Apis::SqladminV1::SslCertsInsertResponse] parsed result object
1609
+ # @yieldparam err [StandardError] error object if request failed
1610
+ #
1611
+ # @return [Google::Apis::SqladminV1::SslCertsInsertResponse]
1612
+ #
1613
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1614
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1615
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1616
+ def insert_ssl_cert(project, instance, ssl_certs_insert_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1617
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/sslCerts', options)
1618
+ command.request_representation = Google::Apis::SqladminV1::SslCertsInsertRequest::Representation
1619
+ command.request_object = ssl_certs_insert_request_object
1620
+ command.response_representation = Google::Apis::SqladminV1::SslCertsInsertResponse::Representation
1621
+ command.response_class = Google::Apis::SqladminV1::SslCertsInsertResponse
1622
+ command.params['project'] = project unless project.nil?
1623
+ command.params['instance'] = instance unless instance.nil?
1624
+ command.query['fields'] = fields unless fields.nil?
1625
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1626
+ execute_or_queue_command(command, &block)
1627
+ end
1628
+
1629
+ # Lists all of the current SSL certificates for the instance.
1630
+ # @param [String] project
1631
+ # Project ID of the project that contains the instance.
1632
+ # @param [String] instance
1633
+ # Cloud SQL instance ID. This does not include the project ID.
1634
+ # @param [String] fields
1635
+ # Selector specifying which fields to include in a partial response.
1636
+ # @param [String] quota_user
1637
+ # Available to use for quota purposes for server-side applications. Can be any
1638
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1639
+ # @param [Google::Apis::RequestOptions] options
1640
+ # Request-specific options
1641
+ #
1642
+ # @yield [result, err] Result & error if block supplied
1643
+ # @yieldparam result [Google::Apis::SqladminV1::SslCertsListResponse] parsed result object
1644
+ # @yieldparam err [StandardError] error object if request failed
1645
+ #
1646
+ # @return [Google::Apis::SqladminV1::SslCertsListResponse]
1647
+ #
1648
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1649
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1650
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1651
+ def list_ssl_certs(project, instance, fields: nil, quota_user: nil, options: nil, &block)
1652
+ command = make_simple_command(:get, 'v1/projects/{project}/instances/{instance}/sslCerts', options)
1653
+ command.response_representation = Google::Apis::SqladminV1::SslCertsListResponse::Representation
1654
+ command.response_class = Google::Apis::SqladminV1::SslCertsListResponse
1655
+ command.params['project'] = project unless project.nil?
1656
+ command.params['instance'] = instance unless instance.nil?
1657
+ command.query['fields'] = fields unless fields.nil?
1658
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1659
+ execute_or_queue_command(command, &block)
1660
+ end
1661
+
1662
+ # Lists all available machine types (tiers) for Cloud SQL, for example, db-
1663
+ # custom-1-3840. For more information, see https://cloud.google.com/sql/pricing.
1664
+ # @param [String] project
1665
+ # Project ID of the project for which to list tiers.
1666
+ # @param [String] fields
1667
+ # Selector specifying which fields to include in a partial response.
1668
+ # @param [String] quota_user
1669
+ # Available to use for quota purposes for server-side applications. Can be any
1670
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1671
+ # @param [Google::Apis::RequestOptions] options
1672
+ # Request-specific options
1673
+ #
1674
+ # @yield [result, err] Result & error if block supplied
1675
+ # @yieldparam result [Google::Apis::SqladminV1::TiersListResponse] parsed result object
1676
+ # @yieldparam err [StandardError] error object if request failed
1677
+ #
1678
+ # @return [Google::Apis::SqladminV1::TiersListResponse]
1679
+ #
1680
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1681
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1682
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1683
+ def list_tiers(project, fields: nil, quota_user: nil, options: nil, &block)
1684
+ command = make_simple_command(:get, 'v1/projects/{project}/tiers', options)
1685
+ command.response_representation = Google::Apis::SqladminV1::TiersListResponse::Representation
1686
+ command.response_class = Google::Apis::SqladminV1::TiersListResponse
1687
+ command.params['project'] = project unless project.nil?
1688
+ command.query['fields'] = fields unless fields.nil?
1689
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1690
+ execute_or_queue_command(command, &block)
1691
+ end
1692
+
1693
+ # Deletes a user from a Cloud SQL instance.
1694
+ # @param [String] project
1695
+ # Project ID of the project that contains the instance.
1696
+ # @param [String] instance
1697
+ # Database instance ID. This does not include the project ID.
1698
+ # @param [String] host
1699
+ # Host of the user in the instance.
1700
+ # @param [String] name
1701
+ # Name of the user in the instance.
1702
+ # @param [String] fields
1703
+ # Selector specifying which fields to include in a partial response.
1704
+ # @param [String] quota_user
1705
+ # Available to use for quota purposes for server-side applications. Can be any
1706
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1707
+ # @param [Google::Apis::RequestOptions] options
1708
+ # Request-specific options
1709
+ #
1710
+ # @yield [result, err] Result & error if block supplied
1711
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1712
+ # @yieldparam err [StandardError] error object if request failed
1713
+ #
1714
+ # @return [Google::Apis::SqladminV1::Operation]
1715
+ #
1716
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1717
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1718
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1719
+ def delete_user(project, instance, host: nil, name: nil, fields: nil, quota_user: nil, options: nil, &block)
1720
+ command = make_simple_command(:delete, 'v1/projects/{project}/instances/{instance}/users', options)
1721
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1722
+ command.response_class = Google::Apis::SqladminV1::Operation
1723
+ command.params['project'] = project unless project.nil?
1724
+ command.params['instance'] = instance unless instance.nil?
1725
+ command.query['host'] = host unless host.nil?
1726
+ command.query['name'] = name unless name.nil?
1727
+ command.query['fields'] = fields unless fields.nil?
1728
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1729
+ execute_or_queue_command(command, &block)
1730
+ end
1731
+
1732
+ # Creates a new user in a Cloud SQL instance.
1733
+ # @param [String] project
1734
+ # Project ID of the project that contains the instance.
1735
+ # @param [String] instance
1736
+ # Database instance ID. This does not include the project ID.
1737
+ # @param [Google::Apis::SqladminV1::User] user_object
1738
+ # @param [String] fields
1739
+ # Selector specifying which fields to include in a partial response.
1740
+ # @param [String] quota_user
1741
+ # Available to use for quota purposes for server-side applications. Can be any
1742
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1743
+ # @param [Google::Apis::RequestOptions] options
1744
+ # Request-specific options
1745
+ #
1746
+ # @yield [result, err] Result & error if block supplied
1747
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1748
+ # @yieldparam err [StandardError] error object if request failed
1749
+ #
1750
+ # @return [Google::Apis::SqladminV1::Operation]
1751
+ #
1752
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1753
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1754
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1755
+ def insert_user(project, instance, user_object = nil, fields: nil, quota_user: nil, options: nil, &block)
1756
+ command = make_simple_command(:post, 'v1/projects/{project}/instances/{instance}/users', options)
1757
+ command.request_representation = Google::Apis::SqladminV1::User::Representation
1758
+ command.request_object = user_object
1759
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1760
+ command.response_class = Google::Apis::SqladminV1::Operation
1761
+ command.params['project'] = project unless project.nil?
1762
+ command.params['instance'] = instance unless instance.nil?
1763
+ command.query['fields'] = fields unless fields.nil?
1764
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1765
+ execute_or_queue_command(command, &block)
1766
+ end
1767
+
1768
+ # Lists users in the specified Cloud SQL instance.
1769
+ # @param [String] project
1770
+ # Project ID of the project that contains the instance.
1771
+ # @param [String] instance
1772
+ # Database instance ID. This does not include the project ID.
1773
+ # @param [String] body_etag
1774
+ # This field is deprecated and will be removed from a future version of the API.
1775
+ # @param [String] body_host
1776
+ # The host name from which the user can connect. For *insert* operations, host
1777
+ # defaults to an empty string. For *update* operations, host is specified as
1778
+ # part of the request URL. The host name cannot be updated after insertion.
1779
+ # @param [String] body_instance
1780
+ # The name of the Cloud SQL instance. This does not include the project ID. Can
1781
+ # be omitted for *update* since it is already specified on the URL.
1782
+ # @param [String] body_kind
1783
+ # This is always *sql#user*.
1784
+ # @param [String] body_name
1785
+ # The name of the user in the Cloud SQL instance. Can be omitted for *update*
1786
+ # since it is already specified in the URL.
1787
+ # @param [String] body_password
1788
+ # The password for the user.
1789
+ # @param [String] body_project
1790
+ # The project ID of the project containing the Cloud SQL database. The Google
1791
+ # apps domain is prefixed if applicable. Can be omitted for *update* since it is
1792
+ # already specified on the URL.
1793
+ # @param [Boolean] body_sqlserver_user_details_disabled
1794
+ # If the user has been disabled
1795
+ # @param [Array<String>, String] body_sqlserver_user_details_server_roles
1796
+ # The server roles for this user
1797
+ # @param [String] body_type
1798
+ # The user type. It determines the method to authenticate the user during login.
1799
+ # The default is the database's built-in user type.
1800
+ # @param [String] fields
1801
+ # Selector specifying which fields to include in a partial response.
1802
+ # @param [String] quota_user
1803
+ # Available to use for quota purposes for server-side applications. Can be any
1804
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1805
+ # @param [Google::Apis::RequestOptions] options
1806
+ # Request-specific options
1807
+ #
1808
+ # @yield [result, err] Result & error if block supplied
1809
+ # @yieldparam result [Google::Apis::SqladminV1::UsersListResponse] parsed result object
1810
+ # @yieldparam err [StandardError] error object if request failed
1811
+ #
1812
+ # @return [Google::Apis::SqladminV1::UsersListResponse]
1813
+ #
1814
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1815
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1816
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1817
+ def list_users(project, instance, body_etag: nil, body_host: nil, body_instance: nil, body_kind: nil, body_name: nil, body_password: nil, body_project: nil, body_sqlserver_user_details_disabled: nil, body_sqlserver_user_details_server_roles: nil, body_type: nil, fields: nil, quota_user: nil, options: nil, &block)
1818
+ command = make_simple_command(:get, 'v1/projects/{project}/instances/{instance}/users', options)
1819
+ command.response_representation = Google::Apis::SqladminV1::UsersListResponse::Representation
1820
+ command.response_class = Google::Apis::SqladminV1::UsersListResponse
1821
+ command.params['project'] = project unless project.nil?
1822
+ command.params['instance'] = instance unless instance.nil?
1823
+ command.query['body.etag'] = body_etag unless body_etag.nil?
1824
+ command.query['body.host'] = body_host unless body_host.nil?
1825
+ command.query['body.instance'] = body_instance unless body_instance.nil?
1826
+ command.query['body.kind'] = body_kind unless body_kind.nil?
1827
+ command.query['body.name'] = body_name unless body_name.nil?
1828
+ command.query['body.password'] = body_password unless body_password.nil?
1829
+ command.query['body.project'] = body_project unless body_project.nil?
1830
+ command.query['body.sqlserverUserDetails.disabled'] = body_sqlserver_user_details_disabled unless body_sqlserver_user_details_disabled.nil?
1831
+ command.query['body.sqlserverUserDetails.serverRoles'] = body_sqlserver_user_details_server_roles unless body_sqlserver_user_details_server_roles.nil?
1832
+ command.query['body.type'] = body_type unless body_type.nil?
1833
+ command.query['fields'] = fields unless fields.nil?
1834
+ command.query['quotaUser'] = quota_user unless quota_user.nil?
1835
+ execute_or_queue_command(command, &block)
1836
+ end
1837
+
1838
+ # Updates an existing user in a Cloud SQL instance.
1839
+ # @param [String] project
1840
+ # Project ID of the project that contains the instance.
1841
+ # @param [String] instance
1842
+ # Database instance ID. This does not include the project ID.
1843
+ # @param [Google::Apis::SqladminV1::User] user_object
1844
+ # @param [String] host
1845
+ # Optional. Host of the user in the instance.
1846
+ # @param [String] name
1847
+ # Name of the user in the instance.
1848
+ # @param [String] fields
1849
+ # Selector specifying which fields to include in a partial response.
1850
+ # @param [String] quota_user
1851
+ # Available to use for quota purposes for server-side applications. Can be any
1852
+ # arbitrary string assigned to a user, but should not exceed 40 characters.
1853
+ # @param [Google::Apis::RequestOptions] options
1854
+ # Request-specific options
1855
+ #
1856
+ # @yield [result, err] Result & error if block supplied
1857
+ # @yieldparam result [Google::Apis::SqladminV1::Operation] parsed result object
1858
+ # @yieldparam err [StandardError] error object if request failed
1859
+ #
1860
+ # @return [Google::Apis::SqladminV1::Operation]
1861
+ #
1862
+ # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
1863
+ # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
1864
+ # @raise [Google::Apis::AuthorizationError] Authorization is required
1865
+ def update_user(project, instance, user_object = nil, host: nil, name: nil, fields: nil, quota_user: nil, options: nil, &block)
1866
+ command = make_simple_command(:put, 'v1/projects/{project}/instances/{instance}/users', options)
1867
+ command.request_representation = Google::Apis::SqladminV1::User::Representation
1868
+ command.request_object = user_object
1869
+ command.response_representation = Google::Apis::SqladminV1::Operation::Representation
1870
+ command.response_class = Google::Apis::SqladminV1::Operation
236
1871
  command.params['project'] = project unless project.nil?
237
1872
  command.params['instance'] = instance unless instance.nil?
1873
+ command.query['host'] = host unless host.nil?
1874
+ command.query['name'] = name unless name.nil?
238
1875
  command.query['fields'] = fields unless fields.nil?
239
1876
  command.query['quotaUser'] = quota_user unless quota_user.nil?
240
1877
  execute_or_queue_command(command, &block)