Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 956c12065419c74cd788bc3e51e40ce4a53223b0 / . / docs / dyn / sqladmin_v1beta1.instances.html
blob: f99ea80d3de90302bbe81a8d9927bafadd276163 [file] [log] [blame]
Joe Gregorio37802c32013-08-06 12:24:05 -0400[diff] [blame]1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="sqladmin_v1beta1.html">Cloud SQL Administration API</a> . <a href="sqladmin_v1beta1.instances.html">instances</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="#delete">delete(project, instance)</a></code></p>
79<p class="firstline">Deletes a database instance.</p>
80<p class="toc_element">
81 <code><a href="#export">export(project, instance, body)</a></code></p>
82<p class="firstline">Exports data from a database instance to a Google Cloud Storage bucket as a MySQL dump file.</p>
83<p class="toc_element">
84 <code><a href="#get">get(project, instance)</a></code></p>
85<p class="firstline">Retrieves a resource containing information about a database instance.</p>
86<p class="toc_element">
87 <code><a href="#import_">import_(project, instance, body)</a></code></p>
88<p class="firstline">Imports data into a database instance from a MySQL dump file in Google Cloud Storage.</p>
89<p class="toc_element">
90 <code><a href="#insert">insert(project, body)</a></code></p>
91<p class="firstline">Creates a new database instance.</p>
92<p class="toc_element">
93 <code><a href="#list">list(project, pageToken=None, maxResults=None)</a></code></p>
94<p class="firstline">Lists instances under a given project in the alphabetical order of the instance name.</p>
95<p class="toc_element">
96 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
97<p class="firstline">Retrieves the next page of results.</p>
98<p class="toc_element">
99 <code><a href="#patch">patch(project, instance, body)</a></code></p>
100<p class="firstline">Updates settings of a database instance. Caution: This is not a partial update, so you must include values for all the settings that you want to retain. For partial updates, use patch.. This method supports patch semantics.</p>
101<p class="toc_element">
102 <code><a href="#restart">restart(project, instance)</a></code></p>
103<p class="firstline">Restarts a database instance.</p>
104<p class="toc_element">
105 <code><a href="#restoreBackup">restoreBackup(project, instance, backupConfiguration, dueTime)</a></code></p>
106<p class="firstline">Restores a backup of a database instance.</p>
107<p class="toc_element">
108 <code><a href="#update">update(project, instance, body)</a></code></p>
109<p class="firstline">Updates settings of a database instance. Caution: This is not a partial update, so you must include values for all the settings that you want to retain. For partial updates, use patch.</p>
110<h3>Method Details</h3>
111<div class="method">
112 <code class="details" id="delete">delete(project, instance)</code>
113 <pre>Deletes a database instance.
114
115Args:
116 project: string, Project ID of the project that contains the instance to be deleted. You can find this on the project summary page of the Google APIs Console. (required)
117 instance: string, Database instance ID. This does not include the project ID. (required)
118
119Returns:
120 An object of the form:
121
122 { # Database instance delete response.
123 "kind": "sql#instancesDelete", # This is always sql#instancesDelete.
124 "operation": "A String", # An identifier that uniquely identifies the operation. You can use this identifier to retrieve the Operations resource that has information about the operation.
125 }</pre>
126</div>
127
128<div class="method">
129 <code class="details" id="export">export(project, instance, body)</code>
130 <pre>Exports data from a database instance to a Google Cloud Storage bucket as a MySQL dump file.
131
132Args:
133 project: string, Project ID of the project that contains the instance to be exported. You can find this on the project summary page of the Google APIs Console. (required)
134 instance: string, Database instance ID. This does not include the project ID. (required)
135 body: object, The request body. (required)
136 The object takes the form of:
137
138{ # Database instance export request.
139 "exportContext": { # Database instance export context. # Contains details about the export operation.
140 "table": [ # Tables to export, or that were exported, from the specified database. If you specify tables, specify one and only one database.
141 "A String",
142 ],
143 "kind": "sql#exportContext", # This is always sql#exportContext.
144 "uri": "A String", # The path to the file in Google Cloud Storage where the export will be stored, or where it was already stored. The URI is in the form gs://bucketName/fileName. If the file already exists, the operation fails. If the filename ends with .gz, the contents are compressed.
145 "database": [ # Databases (for example, guestbook) from which the export is made. If unspecified, all databases are exported.
146 "A String",
147 ],
148 },
149 }
150
151
152Returns:
153 An object of the form:
154
155 { # Database instance export response.
156 "kind": "sql#instancesExport", # This is always sql#instancesExport.
157 "operation": "A String", # An identifier that uniquely identifies the operation. You can use this identifier to retrieve the Operations resource that has information about the operation.
158 }</pre>
159</div>
160
161<div class="method">
162 <code class="details" id="get">get(project, instance)</code>
163 <pre>Retrieves a resource containing information about a database instance.
164
165Args:
166 project: string, Project ID of the project that contains the instance. You can find this on the project summary page of the Google APIs Console. (required)
167 instance: string, Database instance ID. This does not include the project ID. (required)
168
169Returns:
170 An object of the form:
171
172 { # A database instance resource.
173 "project": "A String", # The project ID of the project containing the database instance. The Google apps domain is prefixed if applicable. You can find this on the project summary page of the Google APIs Console.
174 "kind": "sql#instance", # This is always sql#instance.
175 "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
176 "settings": { # Database instance settings. # The user settings.
177 "kind": "sql#settings", # This is always sql#settings.
178 "authorizedGaeApplications": [ # The AppEngine app ids that can access this instance.
179 "A String",
180 ],
181 "activationPolicy": "A String", # The activation policy for this instance. This specifies when the instance should be activated and is applicable only when the instance state is RUNNABLE. This can be one of the following.
182 # ALWAYS: The instance should always be active.
183 # NEVER: The instance should never be activated.
184 # ON_DEMAND: The instance is activated upon receiving requests.
185 "backupConfiguration": [ # The daily backup configuration for the instance.
186 { # Database instance backup configuration.
187 "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
188 "enabled": True or False, # Whether this configuration is enabled.
189 "id": "A String", # Identifier for this configuration. This gets generated automatically when a backup configuration is created.
190 "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
191 },
192 ],
193 "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE.
194 "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS.
195 "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
196 },
197 "region": "A String", # The geographical region. Can be us-east1 or europe-west1. Defaults to us-east1. The region can not be changed after instance creation.
198 "currentDiskSize": "A String", # The current disk usage of the instance in bytes.
199 "instance": "A String", # Name of the database instance. This does not include the project ID.
200 "state": "A String", # The current serving state of the database instance. This can be one of the following.
201 # RUNNABLE: The instance is running, or is ready to run when accessed.
202 # SUSPENDED: The instance is not available, for example due to problems with billing.
203 # PENDING_CREATE: The instance is being created.
204 # MAINTENANCE: The instance is down for maintenance.
205 # UNKNOWN_STATE: The state of the instance is unknown.
206 "etag": "A String", # Etag for this resource - a version number for the settings object in this resource. This field has no effect when passed as a request parameter. Instead, the contents of this field should be passed in an 'If-Match' http header for use in optimistic locking.
207 "databaseVersion": "A String", # The database engine type and version, for example MYSQL_5_5 for MySQL 5.5.
208 }</pre>
209</div>
210
211<div class="method">
212 <code class="details" id="import_">import_(project, instance, body)</code>
213 <pre>Imports data into a database instance from a MySQL dump file in Google Cloud Storage.
214
215Args:
216 project: string, Project ID of the project that contains the instance. You can find this on the project summary page of the Google APIs Console. (required)
217 instance: string, Database instance ID. This does not include the project ID. (required)
218 body: object, The request body. (required)
219 The object takes the form of:
220
221{ # Database instance import request.
222 "importContext": { # Database instance import context. # Contains details about the import operation.
223 "kind": "sql#importContext", # This is always sql#importContext.
224 "uri": [ # A path to the MySQL dump file in Google Cloud Storage from which the import is made. The URI is in the form gs://bucketName/fileName. Compressed gzip files (.gz) are also supported.
225 "A String",
226 ],
227 "database": "A String", # The database (for example, guestbook) to which the import is made. If not set, it is assumed that the database is specified in the file to be imported.
228 },
229 }
230
231
232Returns:
233 An object of the form:
234
235 { # Database instance import response.
236 "kind": "sql#instancesImport", # This is always sql#instancesImport.
237 "operation": "A String", # An identifier that uniquely identifies the operation. You can use this identifier to retrieve the Operations resource that has information about the operation.
238 }</pre>
239</div>
240
241<div class="method">
242 <code class="details" id="insert">insert(project, body)</code>
243 <pre>Creates a new database instance.
244
245Args:
246 project: string, Project ID of the project to which the newly created database instances should belong. You can find this on the project summary page of the Google APIs Console. (required)
247 body: object, The request body. (required)
248 The object takes the form of:
249
250{ # A database instance resource.
251 "project": "A String", # The project ID of the project containing the database instance. The Google apps domain is prefixed if applicable. You can find this on the project summary page of the Google APIs Console.
252 "kind": "sql#instance", # This is always sql#instance.
253 "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
254 "settings": { # Database instance settings. # The user settings.
255 "kind": "sql#settings", # This is always sql#settings.
256 "authorizedGaeApplications": [ # The AppEngine app ids that can access this instance.
257 "A String",
258 ],
259 "activationPolicy": "A String", # The activation policy for this instance. This specifies when the instance should be activated and is applicable only when the instance state is RUNNABLE. This can be one of the following.
260 # ALWAYS: The instance should always be active.
261 # NEVER: The instance should never be activated.
262 # ON_DEMAND: The instance is activated upon receiving requests.
263 "backupConfiguration": [ # The daily backup configuration for the instance.
264 { # Database instance backup configuration.
265 "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
266 "enabled": True or False, # Whether this configuration is enabled.
267 "id": "A String", # Identifier for this configuration. This gets generated automatically when a backup configuration is created.
268 "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
269 },
270 ],
271 "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE.
272 "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS.
273 "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
274 },
275 "region": "A String", # The geographical region. Can be us-east1 or europe-west1. Defaults to us-east1. The region can not be changed after instance creation.
276 "currentDiskSize": "A String", # The current disk usage of the instance in bytes.
277 "instance": "A String", # Name of the database instance. This does not include the project ID.
278 "state": "A String", # The current serving state of the database instance. This can be one of the following.
279 # RUNNABLE: The instance is running, or is ready to run when accessed.
280 # SUSPENDED: The instance is not available, for example due to problems with billing.
281 # PENDING_CREATE: The instance is being created.
282 # MAINTENANCE: The instance is down for maintenance.
283 # UNKNOWN_STATE: The state of the instance is unknown.
284 "etag": "A String", # Etag for this resource - a version number for the settings object in this resource. This field has no effect when passed as a request parameter. Instead, the contents of this field should be passed in an 'If-Match' http header for use in optimistic locking.
285 "databaseVersion": "A String", # The database engine type and version, for example MYSQL_5_5 for MySQL 5.5.
286 }
287
288
289Returns:
290 An object of the form:
291
292 { # Database instance insert response.
293 "kind": "sql#instancesInsert", # This is always sql#instancesInsert.
294 "operation": "A String", # An identifier that uniquely identifies the operation. You can use this identifier to retrieve the Operations resource that has information about the operation.
295 }</pre>
296</div>
297
298<div class="method">
299 <code class="details" id="list">list(project, pageToken=None, maxResults=None)</code>
300 <pre>Lists instances under a given project in the alphabetical order of the instance name.
301
302Args:
303 project: string, Project ID of the project for which to list database instances. You can find this on the project summary page of the Google APIs Console. (required)
304 pageToken: string, A previously-returned page token representing part of the larger set of results to view.
305 maxResults: integer, The maximum number of results to return per response.
306
307Returns:
308 An object of the form:
309
310 { # Database instances list response.
311 "nextPageToken": "A String", # The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results.
312 "items": [ # List of database instance resources.
313 { # A database instance resource.
314 "project": "A String", # The project ID of the project containing the database instance. The Google apps domain is prefixed if applicable. You can find this on the project summary page of the Google APIs Console.
315 "kind": "sql#instance", # This is always sql#instance.
316 "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
317 "settings": { # Database instance settings. # The user settings.
318 "kind": "sql#settings", # This is always sql#settings.
319 "authorizedGaeApplications": [ # The AppEngine app ids that can access this instance.
320 "A String",
321 ],
322 "activationPolicy": "A String", # The activation policy for this instance. This specifies when the instance should be activated and is applicable only when the instance state is RUNNABLE. This can be one of the following.
323 # ALWAYS: The instance should always be active.
324 # NEVER: The instance should never be activated.
325 # ON_DEMAND: The instance is activated upon receiving requests.
326 "backupConfiguration": [ # The daily backup configuration for the instance.
327 { # Database instance backup configuration.
328 "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
329 "enabled": True or False, # Whether this configuration is enabled.
330 "id": "A String", # Identifier for this configuration. This gets generated automatically when a backup configuration is created.
331 "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
332 },
333 ],
334 "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE.
335 "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS.
336 "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
337 },
338 "region": "A String", # The geographical region. Can be us-east1 or europe-west1. Defaults to us-east1. The region can not be changed after instance creation.
339 "currentDiskSize": "A String", # The current disk usage of the instance in bytes.
340 "instance": "A String", # Name of the database instance. This does not include the project ID.
341 "state": "A String", # The current serving state of the database instance. This can be one of the following.
342 # RUNNABLE: The instance is running, or is ready to run when accessed.
343 # SUSPENDED: The instance is not available, for example due to problems with billing.
344 # PENDING_CREATE: The instance is being created.
345 # MAINTENANCE: The instance is down for maintenance.
346 # UNKNOWN_STATE: The state of the instance is unknown.
347 "etag": "A String", # Etag for this resource - a version number for the settings object in this resource. This field has no effect when passed as a request parameter. Instead, the contents of this field should be passed in an 'If-Match' http header for use in optimistic locking.
348 "databaseVersion": "A String", # The database engine type and version, for example MYSQL_5_5 for MySQL 5.5.
349 },
350 ],
351 "kind": "sql#instancesList", # This is always sql#instancesList.
352 }</pre>
353</div>
354
355<div class="method">
356 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
357 <pre>Retrieves the next page of results.
358
359Args:
360 previous_request: The request for the previous page. (required)
361 previous_response: The response from the request for the previous page. (required)
362
363Returns:
364 A request object that you can call 'execute()' on to request the next
365 page. Returns None if there are no more items in the collection.
366 </pre>
367</div>
368
369<div class="method">
370 <code class="details" id="patch">patch(project, instance, body)</code>
371 <pre>Updates settings of a database instance. Caution: This is not a partial update, so you must include values for all the settings that you want to retain. For partial updates, use patch.. This method supports patch semantics.
372
373Args:
374 project: string, Project ID of the project that contains the instance. You can find this on the project summary page of the Google APIs Console. (required)
375 instance: string, Database instance ID. This does not include the project ID. (required)
376 body: object, The request body. (required)
377 The object takes the form of:
378
379{ # A database instance resource.
380 "project": "A String", # The project ID of the project containing the database instance. The Google apps domain is prefixed if applicable. You can find this on the project summary page of the Google APIs Console.
381 "kind": "sql#instance", # This is always sql#instance.
382 "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
383 "settings": { # Database instance settings. # The user settings.
384 "kind": "sql#settings", # This is always sql#settings.
385 "authorizedGaeApplications": [ # The AppEngine app ids that can access this instance.
386 "A String",
387 ],
388 "activationPolicy": "A String", # The activation policy for this instance. This specifies when the instance should be activated and is applicable only when the instance state is RUNNABLE. This can be one of the following.
389 # ALWAYS: The instance should always be active.
390 # NEVER: The instance should never be activated.
391 # ON_DEMAND: The instance is activated upon receiving requests.
392 "backupConfiguration": [ # The daily backup configuration for the instance.
393 { # Database instance backup configuration.
394 "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
395 "enabled": True or False, # Whether this configuration is enabled.
396 "id": "A String", # Identifier for this configuration. This gets generated automatically when a backup configuration is created.
397 "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
398 },
399 ],
400 "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE.
401 "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS.
402 "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
403 },
404 "region": "A String", # The geographical region. Can be us-east1 or europe-west1. Defaults to us-east1. The region can not be changed after instance creation.
405 "currentDiskSize": "A String", # The current disk usage of the instance in bytes.
406 "instance": "A String", # Name of the database instance. This does not include the project ID.
407 "state": "A String", # The current serving state of the database instance. This can be one of the following.
408 # RUNNABLE: The instance is running, or is ready to run when accessed.
409 # SUSPENDED: The instance is not available, for example due to problems with billing.
410 # PENDING_CREATE: The instance is being created.
411 # MAINTENANCE: The instance is down for maintenance.
412 # UNKNOWN_STATE: The state of the instance is unknown.
413 "etag": "A String", # Etag for this resource - a version number for the settings object in this resource. This field has no effect when passed as a request parameter. Instead, the contents of this field should be passed in an 'If-Match' http header for use in optimistic locking.
414 "databaseVersion": "A String", # The database engine type and version, for example MYSQL_5_5 for MySQL 5.5.
415 }
416
417
418Returns:
419 An object of the form:
420
421 { # Database instance update response.
422 "kind": "sql#instancesUpdate", # This is always sql#instancesUpdate.
423 "operation": "A String", # An identifier that uniquely identifies the operation. You can use this identifier to retrieve information about the operation.
424 }</pre>
425</div>
426
427<div class="method">
428 <code class="details" id="restart">restart(project, instance)</code>
429 <pre>Restarts a database instance.
430
431Args:
432 project: string, Project ID of the project that contains the instance to be restarted. You can find this on the project summary page of the Google APIs Console. (required)
433 instance: string, Database instance ID. This does not include the project ID. (required)
434
435Returns:
436 An object of the form:
437
438 { # Database instance restart response.
439 "kind": "sql#instancesRestart", # This is always sql#instancesRestart.
440 "operation": "A String", # An identifier that uniquely identifies the operation. You can use this identifier to retrieve the Operations resource that has information about the operation.
441 }</pre>
442</div>
443
444<div class="method">
445 <code class="details" id="restoreBackup">restoreBackup(project, instance, backupConfiguration, dueTime)</code>
446 <pre>Restores a backup of a database instance.
447
448Args:
449 project: string, Project ID of the project that contains the instance. You can find this on the project summary page of the Google APIs Console. (required)
450 instance: string, Database instance ID. This does not include the project ID. (required)
451 backupConfiguration: string, The identifier of the backup configuration. This gets generated automatically when a backup configuration is created. (required)
452 dueTime: string, The time when this run is due to start in RFC 3339 format, for example 2012-11-15T16:19:00.094Z. (required)
453
454Returns:
455 An object of the form:
456
457 { # Database instance restore backup response.
458 "kind": "sql#instancesRestoreBackup", # This is always sql#instancesRestoreBackup.
459 "operation": "A String", # An identifier that uniquely identifies the operation. You can use this identifier to retrieve the Operations resource that has information about the operation.
460 }</pre>
461</div>
462
463<div class="method">
464 <code class="details" id="update">update(project, instance, body)</code>
465 <pre>Updates settings of a database instance. Caution: This is not a partial update, so you must include values for all the settings that you want to retain. For partial updates, use patch.
466
467Args:
468 project: string, Project ID of the project that contains the instance. You can find this on the project summary page of the Google APIs Console. (required)
469 instance: string, Database instance ID. This does not include the project ID. (required)
470 body: object, The request body. (required)
471 The object takes the form of:
472
473{ # A database instance resource.
474 "project": "A String", # The project ID of the project containing the database instance. The Google apps domain is prefixed if applicable. You can find this on the project summary page of the Google APIs Console.
475 "kind": "sql#instance", # This is always sql#instance.
476 "maxDiskSize": "A String", # The maximum disk size of the instance in bytes.
477 "settings": { # Database instance settings. # The user settings.
478 "kind": "sql#settings", # This is always sql#settings.
479 "authorizedGaeApplications": [ # The AppEngine app ids that can access this instance.
480 "A String",
481 ],
482 "activationPolicy": "A String", # The activation policy for this instance. This specifies when the instance should be activated and is applicable only when the instance state is RUNNABLE. This can be one of the following.
483 # ALWAYS: The instance should always be active.
484 # NEVER: The instance should never be activated.
485 # ON_DEMAND: The instance is activated upon receiving requests.
486 "backupConfiguration": [ # The daily backup configuration for the instance.
487 { # Database instance backup configuration.
488 "kind": "sql#backupConfiguration", # This is always sql#backupConfiguration.
489 "enabled": True or False, # Whether this configuration is enabled.
490 "id": "A String", # Identifier for this configuration. This gets generated automatically when a backup configuration is created.
491 "startTime": "A String", # Start time for the daily backup configuration in UTC timezone in the 24 hour format - HH:MM.
492 },
493 ],
494 "pricingPlan": "A String", # The pricing plan for this instance. This can be either PER_USE or PACKAGE.
495 "replicationType": "A String", # The type of replication this instance uses. This can be either ASYNCHRONOUS or SYNCHRONOUS.
496 "tier": "A String", # The tier of service for this instance, for example D1, D2. For more information, see pricing.
497 },
498 "region": "A String", # The geographical region. Can be us-east1 or europe-west1. Defaults to us-east1. The region can not be changed after instance creation.
499 "currentDiskSize": "A String", # The current disk usage of the instance in bytes.
500 "instance": "A String", # Name of the database instance. This does not include the project ID.
501 "state": "A String", # The current serving state of the database instance. This can be one of the following.
502 # RUNNABLE: The instance is running, or is ready to run when accessed.
503 # SUSPENDED: The instance is not available, for example due to problems with billing.
504 # PENDING_CREATE: The instance is being created.
505 # MAINTENANCE: The instance is down for maintenance.
506 # UNKNOWN_STATE: The state of the instance is unknown.
507 "etag": "A String", # Etag for this resource - a version number for the settings object in this resource. This field has no effect when passed as a request parameter. Instead, the contents of this field should be passed in an 'If-Match' http header for use in optimistic locking.
508 "databaseVersion": "A String", # The database engine type and version, for example MYSQL_5_5 for MySQL 5.5.
509 }
510
511
512Returns:
513 An object of the form:
514
515 { # Database instance update response.
516 "kind": "sql#instancesUpdate", # This is always sql#instancesUpdate.
517 "operation": "A String", # An identifier that uniquely identifies the operation. You can use this identifier to retrieve information about the operation.
518 }</pre>
519</div>
520
521</body></html>