docs/dyn/sql_v1beta4.instances.html

<html><body>
<style>

body, h1, h2, h3, div, span, p, pre, a {
  margin: 0;
  padding: 0;
  border: 0;
  font-weight: inherit;
  font-style: inherit;
  font-size: 100%;
  font-family: inherit;
  vertical-align: baseline;
}

body {
  font-size: 13px;
  padding: 1em;
}

h1 {
  font-size: 26px;
  margin-bottom: 1em;
}

h2 {
  font-size: 24px;
  margin-bottom: 1em;
}

h3 {
  font-size: 20px;
  margin-bottom: 1em;
  margin-top: 1em;
}

pre, code {
  line-height: 1.5;
  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}

pre {
  margin-top: 0.5em;
}

h1, h2, h3, p {
  font-family: Arial, sans serif;
}

h1, h2, h3 {
  border-bottom: solid #CCC 1px;
}

.toc_element {
  margin-top: 0.5em;
}

.firstline {
  margin-left: 2 em;
}

.method  {
  margin-top: 1em;
  border: solid 1px #CCC;
  padding: 1em;
  background: #EEE;
}

.details {
  font-weight: bold;
  font-size: 14px;
}

</style>

<h1><a href="sql_v1beta4.html">Cloud SQL Admin API</a> . <a href="sql_v1beta4.instances.html">instances</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
  <code><a href="#addServerCa">addServerCa(project, instance, x__xgafv=None)</a></code></p>
<p class="firstline">Add a new trusted Certificate Authority (CA) version for the specified</p>
<p class="toc_element">
  <code><a href="#clone">clone(project, instance, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a Cloud SQL instance as a clone of the source instance. Using this</p>
<p class="toc_element">
  <code><a href="#delete">delete(project, instance, x__xgafv=None)</a></code></p>
<p class="firstline">Deletes a Cloud SQL instance.</p>
<p class="toc_element">
  <code><a href="#demoteMaster">demoteMaster(project, instance, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Demotes the stand-alone instance to be a Cloud SQL read replica for an</p>
<p class="toc_element">
  <code><a href="#export">export(project, instance, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL</p>
<p class="toc_element">
  <code><a href="#failover">failover(project, instance, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Failover the instance to its failover replica instance. Using this</p>
<p class="toc_element">
  <code><a href="#get">get(project, instance, x__xgafv=None)</a></code></p>
<p class="firstline">Retrieves a resource containing information about a Cloud SQL instance.</p>
<p class="toc_element">
  <code><a href="#import_">import_(project, instance, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Imports data into a Cloud SQL instance from a SQL dump  or CSV file in</p>
<p class="toc_element">
  <code><a href="#insert">insert(project, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a new Cloud SQL instance.</p>
<p class="toc_element">
  <code><a href="#list">list(project, pageToken=None, maxResults=None, filter=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists instances under a given project.</p>
<p class="toc_element">
  <code><a href="#listServerCas">listServerCas(project, instance, x__xgafv=None)</a></code></p>
<p class="firstline">Lists all of the trusted Certificate Authorities (CAs) for the specified</p>
<p class="toc_element">
  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<p class="toc_element">
  <code><a href="#patch">patch(project, instance, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Updates settings of a Cloud SQL instance.</p>
<p class="toc_element">
  <code><a href="#promoteReplica">promoteReplica(project, instance, x__xgafv=None)</a></code></p>
<p class="firstline">Promotes the read replica instance to be a stand-alone Cloud SQL instance.</p>
<p class="toc_element">
  <code><a href="#resetSslConfig">resetSslConfig(project, instance, x__xgafv=None)</a></code></p>
<p class="firstline">Deletes all client certificates and generates a new server SSL certificate</p>
<p class="toc_element">
  <code><a href="#restart">restart(project, instance, x__xgafv=None)</a></code></p>
<p class="firstline">Restarts a Cloud SQL instance.</p>
<p class="toc_element">
  <code><a href="#restoreBackup">restoreBackup(project, instance, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Restores a backup of a Cloud SQL instance. Using this operation might cause</p>
<p class="toc_element">
  <code><a href="#rotateServerCa">rotateServerCa(project, instance, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Rotates the server certificate to one signed by the Certificate Authority</p>
<p class="toc_element">
  <code><a href="#startReplica">startReplica(project, instance, x__xgafv=None)</a></code></p>
<p class="firstline">Starts the replication in the read replica instance.</p>
<p class="toc_element">
  <code><a href="#stopReplica">stopReplica(project, instance, x__xgafv=None)</a></code></p>
<p class="firstline">Stops the replication in the read replica instance.</p>
<p class="toc_element">
  <code><a href="#truncateLog">truncateLog(project, instance, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Truncate MySQL general and slow query log tables</p>
<p class="toc_element">
  <code><a href="#update">update(project, instance, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Updates settings of a Cloud SQL instance. Using this operation might cause</p>
<h3>Method Details</h3>
<div class="method">
    <code class="details" id="addServerCa">addServerCa(project, instance, x__xgafv=None)</code>
  <pre>Add a new trusted Certificate Authority (CA) version for the specified
instance. Required to prepare for a certificate rotation. If a CA version
was previously added but never used in a certificate rotation, this
operation replaces that version. There cannot be more than one CA version
waiting to be rotated in.

Args:
  project: string, Project ID of the project that contains the instance. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="clone">clone(project, instance, body=None, x__xgafv=None)</code>
  <pre>Creates a Cloud SQL instance as a clone of the source instance. Using this
operation might cause your instance to restart.

Args:
  project: string, Project ID of the source as well as the clone Cloud SQL instance. (required)
  instance: string, The ID of the Cloud SQL instance to be cloned (source). This does not
include the project ID. (required)
  body: object, The request body.
    The object takes the form of:

{ # Database instance clone request.
    &quot;cloneContext&quot;: { # Database instance clone context. # Contains details about the clone operation.
      &quot;destinationInstanceName&quot;: &quot;A String&quot;, # Name of the Cloud SQL instance to be created as a clone.
      &quot;pitrTimestampMs&quot;: &quot;A String&quot;, # Reserved for future use.
      &quot;binLogCoordinates&quot;: { # Binary log coordinates. # Binary log coordinates, if specified, identify the position up to which the
          # source instance should be cloned. If not specified, the source instance is
          # cloned up to the most recent binary log coordinates.
        &quot;binLogFileName&quot;: &quot;A String&quot;, # Name of the binary log file for a Cloud SQL instance.
        &quot;binLogPosition&quot;: &quot;A String&quot;, # Position (offset) within the binary log file.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#binLogCoordinates&lt;/code&gt;.
      },
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#cloneContext&lt;/code&gt;.
      &quot;pointInTime&quot;: &quot;A String&quot;, # Reserved for future use.
    },
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="delete">delete(project, instance, x__xgafv=None)</code>
  <pre>Deletes a Cloud SQL instance.

Args:
  project: string, Project ID of the project that contains the instance to be deleted. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="demoteMaster">demoteMaster(project, instance, body=None, x__xgafv=None)</code>
  <pre>Demotes the stand-alone instance to be a Cloud SQL read replica for an
external database server.

Args:
  project: string, ID of the project that contains the instance. (required)
  instance: string, Cloud SQL instance name. (required)
  body: object, The request body.
    The object takes the form of:

{ # Database demote master request.
    &quot;demoteMasterContext&quot;: { # Database instance demote master context. # Contains details about the demoteMaster operation.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#demoteMasterContext&lt;/code&gt;.
      &quot;masterInstanceName&quot;: &quot;A String&quot;, # The name of the instance which will act as on-premises master in the
          # replication setup.
      &quot;verifyGtidConsistency&quot;: True or False, # Verify GTID consistency for demote operation. Default value:
          # &lt;code&gt;True&lt;/code&gt;. Second Generation instances only.  Setting this flag to
          # false enables you to bypass GTID consistency check between on-premises
          # master and Cloud SQL instance during the demotion operation but also
          # exposes you to the risk of future replication failures. Change the value
          # only if you know the reason for the GTID divergence and are confident that
          # doing so will not cause any replication issues.
      &quot;replicaConfiguration&quot;: { # Read-replica configuration for connecting to the on-premises master. # Configuration specific to read-replicas replicating from the on-premises
          # master.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#demoteMasterConfiguration&lt;/code&gt;.
        &quot;mysqlReplicaConfiguration&quot;: { # Read-replica configuration specific to MySQL databases. # MySQL specific configuration when replicating from a MySQL on-premises
            # master. Replication configuration information such as the username,
            # password, certificates, and keys are not stored in the instance metadata.
            # The configuration information is used only to set up the replication
            # connection and is stored by MySQL in a file named &lt;code&gt;master.info&lt;/code&gt;
            # in the data directory.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#demoteMasterMysqlReplicaConfiguration&lt;/code&gt;.
          &quot;password&quot;: &quot;A String&quot;, # The password for the replication connection.
          &quot;clientKey&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s private key. The corresponsing public key
              # is encoded in the client&#x27;s certificate. The format of the slave&#x27;s private
              # key can be either PKCS #1 or PKCS #8.
          &quot;clientCertificate&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s x509 certificate.
          &quot;username&quot;: &quot;A String&quot;, # The username for the replication connection.
          &quot;caCertificate&quot;: &quot;A String&quot;, # PEM representation of the trusted CA&#x27;s x509 certificate.
        },
      },
    },
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="export">export(project, instance, body=None, x__xgafv=None)</code>
  <pre>Exports data from a Cloud SQL instance to a Cloud Storage bucket as a SQL
dump or CSV file.

Args:
  project: string, Project ID of the project that contains the instance to be exported. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  body: object, The request body.
    The object takes the form of:

{ # Database instance export request.
    &quot;exportContext&quot;: { # Database instance export context. # Contains details about the export operation.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="failover">failover(project, instance, body=None, x__xgafv=None)</code>
  <pre>Failover the instance to its failover replica instance. Using this
operation might cause your instance to restart.

Args:
  project: string, ID of the project that contains the read replica. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  body: object, The request body.
    The object takes the form of:

{ # Instance failover request.
    &quot;failoverContext&quot;: { # Database instance failover context. # Failover Context.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#failoverContext&lt;/code&gt;.
      &quot;settingsVersion&quot;: &quot;A String&quot;, # The current settings version of this instance. Request will be rejected if
          # this version doesn&#x27;t match the current settings version.
    },
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="get">get(project, instance, x__xgafv=None)</code>
  <pre>Retrieves a resource containing information about a Cloud SQL instance.

Args:
  project: string, Project ID of the project that contains the instance. (required)
  instance: string, Database instance ID. This does not include the project ID. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A Cloud SQL instance resource.
      &quot;databaseVersion&quot;: &quot;A String&quot;, # The database engine type and version. The &lt;code&gt;databaseVersion&lt;/code&gt;
          # field can not be changed after instance creation.  MySQL Second Generation
          # instances: &lt;code&gt;MYSQL_5_7&lt;/code&gt; (default) or &lt;code&gt;MYSQL_5_6&lt;/code&gt;.
          # PostgreSQL instances: &lt;code&gt;POSTGRES_9_6&lt;/code&gt; (default) or
          # &lt;code&gt;POSTGRES_11 Beta&lt;/code&gt; MySQL First Generation
          # instances: &lt;code&gt;MYSQL_5_6&lt;/code&gt; (default) or &lt;code&gt;MYSQL_5_5&lt;/code&gt;
      &quot;suspensionReason&quot;: [ # If the instance state is SUSPENDED, the reason for the suspension.
        &quot;A String&quot;,
      ],
      &quot;settings&quot;: { # Database instance settings. # The user settings.
        &quot;backupConfiguration&quot;: { # Database instance backup configuration. # The daily backup configuration for the instance.
          &quot;binaryLogEnabled&quot;: True or False, # (MySQL only) Whether binary log is enabled. If backup configuration is
              # disabled, binarylog must be disabled as well.
          &quot;replicationLogArchivingEnabled&quot;: True or False, # Reserved for future use.
          &quot;location&quot;: &quot;A String&quot;, # Location of the backup
          &quot;pointInTimeRecoveryEnabled&quot;: True or False, # Reserved for future use.
          &quot;startTime&quot;: &quot;A String&quot;, # Start time for the daily backup configuration in UTC timezone in the 24
              # hour format - &lt;code&gt;HH:MM&lt;/code&gt;.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#backupConfiguration&lt;/code&gt;.
          &quot;enabled&quot;: True or False, # Whether this configuration is enabled.
        },
        &quot;userLabels&quot;: { # User-provided labels, represented as a dictionary where each label is a
            # single key value pair.
          &quot;a_key&quot;: &quot;A String&quot;,
        },
        &quot;locationPreference&quot;: { # Preferred location. This specifies where a Cloud SQL instance should # The location preference settings. This allows the instance to be located as
            # near as possible to either an App Engine app or Compute Engine zone for
            # better performance. App Engine co-location is only applicable to First
            # Generation instances.
            # preferably be located, either in a specific Compute Engine zone, or
            # co-located with an App Engine application. Note that if the preferred
            # location is not available, the instance will be located as close as possible
            # within the region. Only one location may be specified.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#locationPreference&lt;/code&gt;.
          &quot;zone&quot;: &quot;A String&quot;, # The preferred Compute Engine zone (e.g. us-central1-a, us-central1-b,
              # etc.).
          &quot;followGaeApplication&quot;: &quot;A String&quot;, # The AppEngine application to follow, it must be in the same region as the
              # Cloud SQL instance.
        },
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#settings&lt;/code&gt;.
        &quot;replicationType&quot;: &quot;A String&quot;, # The type of replication this instance uses. This can be either
            # &lt;code&gt;ASYNCHRONOUS&lt;/code&gt; or &lt;code&gt;SYNCHRONOUS&lt;/code&gt;. This property is
            # only applicable to First Generation instances.
        &quot;activationPolicy&quot;: &quot;A String&quot;, # The activation policy specifies when the instance is activated; it is
            # applicable only when the instance state is &lt;code&gt;RUNNABLE&lt;/code&gt;. Valid
            # values: &lt;br&gt;&lt;code&gt;ALWAYS&lt;/code&gt;: The instance is on, and remains so even in
            # the absence of connection requests. &lt;br&gt;&lt;code&gt;NEVER&lt;/code&gt;: The instance is
            # off; it is not activated, even if a connection request arrives.
            # &lt;br&gt;&lt;code&gt;ON_DEMAND&lt;/code&gt;: First Generation instances only. The instance
            # responds to incoming requests, and turns itself off when not in use.
            # Instances with &lt;code&gt;PER_USE&lt;/code&gt; pricing turn off after 15 minutes of
            # inactivity. Instances with &lt;code&gt;PER_PACKAGE&lt;/code&gt; pricing turn off after
            # 12 hours of inactivity.
        &quot;ipConfiguration&quot;: { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the
            # instance IP and manage which external networks can connect to the instance.
            # The IPv4 address cannot be disabled for Second Generation instances.
          &quot;authorizedNetworks&quot;: [ # The list of external networks that are allowed to connect to the instance
              # using the IP. In &lt;a
              # href=&quot;http://en.wikipedia.org/wiki/CIDR_notation#CIDR_notation&quot;&gt;CIDR
              # notation&lt;/a&gt;, also known as &#x27;slash&#x27; notation (e.g.
              # &lt;code&gt;192.168.100.0/24&lt;/code&gt;).
            { # An entry for an Access Control list.
              &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#aclEntry&lt;/code&gt;.
              &quot;value&quot;: &quot;A String&quot;, # The whitelisted value for the access control list.
              &quot;expirationTime&quot;: &quot;A String&quot;, # The time when this access control entry expires in &lt;a
                  # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
                  # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
              &quot;name&quot;: &quot;A String&quot;, # Optional. A label to identify this entry.
            },
          ],
          &quot;requireSsl&quot;: True or False, # Whether SSL connections over IP should be enforced or not.
          &quot;privateNetwork&quot;: &quot;A String&quot;, # The resource link for the VPC network from which the Cloud SQL instance is
              # accessible for private IP. For example,
              # &lt;code&gt;/projects/myProject/global/networks/default&lt;/code&gt;. This setting can
              # be updated, but it cannot be removed after it is set.
          &quot;ipv4Enabled&quot;: True or False, # Whether the instance should be assigned an IP address or not.
        },
        &quot;availabilityType&quot;: &quot;A String&quot;, # Availability type (PostgreSQL and MySQL instances only). Potential values:
            # &lt;br&gt;&lt;code&gt;ZONAL&lt;/code&gt;: The instance serves data from only one zone.
            # Outages in that zone affect data accessibility. &lt;br&gt;&lt;code&gt;REGIONAL&lt;/code&gt;:
            # The instance can serve data from more than one zone in a region (it is
            # highly available). &lt;br&gt;For more information, see &lt;a
            # href=&quot;https://cloud.google.com/sql/docs/postgres/high-availability&quot;&gt;Overview
            # of the High Availability Configuration&lt;/a&gt;.
        &quot;settingsVersion&quot;: &quot;A String&quot;, # The version of instance settings. This is a required field for update
            # method to make sure concurrent updates are handled properly. During update,
            # use the most recent settingsVersion value for this instance and do not try
            # to update this value.
        &quot;databaseFlags&quot;: [ # The database flags passed to the instance at startup.
          { # Database flags for Cloud SQL instances.
            &quot;name&quot;: &quot;A String&quot;, # The name of the flag. These flags are passed at instance startup, so
                # include both server options and system variables for MySQL. Flags should be
                # specified with underscores, not hyphens. For more information, see &lt;a
                # href=&quot;/sql/docs/mysql/flags&quot;&gt;Configuring Database Flags&lt;/a&gt; in the Cloud
                # SQL documentation.
            &quot;value&quot;: &quot;A String&quot;, # The value of the flag. Booleans should be set to &lt;code&gt;on&lt;/code&gt; for true
                # and &lt;code&gt;off&lt;/code&gt; for false. This field must be omitted if the flag
                # doesn&#x27;t take a value.
          },
        ],
        &quot;maintenanceWindow&quot;: { # Maintenance window. This specifies when a v2 Cloud SQL instance should # The maintenance window for this instance. This specifies when the instance
            # can be restarted for maintenance purposes. Not used for First Generation
            # instances.
            # preferably be restarted for system maintenance purposes.
          &quot;hour&quot;: 42, # hour of day - 0 to 23.
          &quot;day&quot;: 42, # day of week (1-7), starting on Monday.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#maintenanceWindow&lt;/code&gt;.
          &quot;updateTrack&quot;: &quot;A String&quot;, # Maintenance timing setting: &lt;code&gt;canary&lt;/code&gt; (Earlier) or
              # &lt;code&gt;stable&lt;/code&gt; (Later). &lt;br /&gt;&lt;a
              # href=&quot;/sql/docs/db_path/instance-settings#maintenance-timing-2ndgen&quot;&gt;
              # Learn more&lt;/a&gt;.
        },
        &quot;pricingPlan&quot;: &quot;A String&quot;, # The pricing plan for this instance. This can be either &lt;code&gt;PER_USE&lt;/code&gt;
            # or &lt;code&gt;PACKAGE&lt;/code&gt;. Only &lt;code&gt;PER_USE&lt;/code&gt; is supported for Second
            # Generation instances.
        &quot;storageAutoResize&quot;: True or False, # Configuration to increase storage size automatically. The default value is
            # true. Not used for First Generation instances.
        &quot;storageAutoResizeLimit&quot;: &quot;A String&quot;, # The maximum size to which storage capacity can be automatically increased.
            # The default value is 0, which specifies that there is no limit. Not used
            # for First Generation instances.
        &quot;authorizedGaeApplications&quot;: [ # The App Engine app IDs that can access this instance. First Generation
            # instances only.
          &quot;A String&quot;,
        ],
        &quot;tier&quot;: &quot;A String&quot;, # The tier (or machine type) for this instance, for example
            # &lt;code&gt;db-n1-standard-1&lt;/code&gt; (MySQL instances) or
            # &lt;code&gt;db-custom-1-3840&lt;/code&gt; (PostgreSQL instances). For MySQL instances,
            # this property determines whether the instance is First or Second
            # Generation. For more information, see &lt;a
            # href=&quot;/sql/docs/db_path/instance-settings&quot;&gt;Instance Settings&lt;/a&gt;.
        &quot;dataDiskSizeGb&quot;: &quot;A String&quot;, # The size of data disk, in GB. The data disk size minimum is 10GB. Not used
            # for First Generation instances.
        &quot;dataDiskType&quot;: &quot;A String&quot;, # The type of data disk: &lt;code&gt;PD_SSD&lt;/code&gt; (default) or
            # &lt;code&gt;PD_HDD&lt;/code&gt;. Not used for First Generation instances.
        &quot;databaseReplicationEnabled&quot;: True or False, # Configuration specific to read replica instances. Indicates whether
            # replication is enabled or not.
        &quot;crashSafeReplicationEnabled&quot;: True or False, # Configuration specific to read replica instances. Indicates whether
            # database flags for crash-safe replication are enabled. This property is
            # only applicable to First Generation instances.
      },
      &quot;replicaNames&quot;: [ # The replicas of the instance.
        &quot;A String&quot;,
      ],
      &quot;diskEncryptionConfiguration&quot;: { # Disk encryption configuration for an instance. # Disk encryption configuration specific to an instance.
          # Applies only to Second Generation instances.
        &quot;kmsKeyName&quot;: &quot;A String&quot;, # Resource name of KMS key for disk encryption
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#diskEncryptionConfiguration&lt;/code&gt;.
      },
      &quot;scheduledMaintenance&quot;: { # Any scheduled maintenancce for this instance. # The start time of any upcoming scheduled maintenance for this instance.
        &quot;canReschedule&quot;: True or False, # If the scheduled maintenance can be rescheduled.
        &quot;canDefer&quot;: True or False,
        &quot;startTime&quot;: &quot;A String&quot;, # The start time of any upcoming scheduled maintenance for this instance.
      },
      &quot;rootPassword&quot;: &quot;A String&quot;, # Initial root password. Use only on creation.
      &quot;etag&quot;: &quot;A String&quot;, # This field is deprecated and will be removed from a future version of the
          # API. Use the &lt;code&gt;settings.settingsVersion&lt;/code&gt; field instead.
      &quot;serverCaCert&quot;: { # SslCerts Resource # SSL configuration.
        &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
        &quot;expirationTime&quot;: &quot;A String&quot;, # The time when the certificate expires in &lt;a
            # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
            # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
        &quot;sha1Fingerprint&quot;: &quot;A String&quot;, # Sha1 Fingerprint.
        &quot;certSerialNumber&quot;: &quot;A String&quot;, # Serial number, as extracted from the certificate.
        &quot;cert&quot;: &quot;A String&quot;, # PEM representation.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#sslCert&lt;/code&gt;.
        &quot;commonName&quot;: &quot;A String&quot;, # User supplied name.  Constrained to [a-zA-Z.-_ ]+.
        &quot;createTime&quot;: &quot;A String&quot;, # The time when the certificate was created in &lt;a
            # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
            # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;
        &quot;instance&quot;: &quot;A String&quot;, # Name of the database instance.
      },
      &quot;maxDiskSize&quot;: &quot;A String&quot;, # The maximum disk size of the instance in bytes.
      &quot;name&quot;: &quot;A String&quot;, # Name of the Cloud SQL instance. This does not include the project ID.
      &quot;masterInstanceName&quot;: &quot;A String&quot;, # The name of the instance which will act as master in the replication setup.
      &quot;instanceType&quot;: &quot;A String&quot;, # The instance type. This can be one of the following.
          # &lt;br&gt;&lt;code&gt;CLOUD_SQL_INSTANCE&lt;/code&gt;: A Cloud SQL instance that is not
          # replicating from a master. &lt;br&gt;&lt;code&gt;ON_PREMISES_INSTANCE&lt;/code&gt;: An
          # instance running on the
          # customer&#x27;s premises. &lt;br&gt;&lt;code&gt;READ_REPLICA_INSTANCE&lt;/code&gt;: A Cloud SQL
          # instance configured as a read-replica.
      &quot;gceZone&quot;: &quot;A String&quot;, # The Compute Engine zone that the instance is currently serving from. This
          # value could be different from the zone that was specified when the instance
          # was created if the instance has failed over to its secondary zone.
      &quot;currentDiskSize&quot;: &quot;A String&quot;, # The current disk usage of the instance in bytes. This property has been
          # deprecated. Users should use the
          # &quot;cloudsql.googleapis.com/database/disk/bytes_used&quot; metric in Cloud
          # Monitoring API instead. Please see &lt;a
          # href=&quot;https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ&quot;&gt;this
          # announcement&lt;/a&gt; for details.
      &quot;replicaConfiguration&quot;: { # Read-replica configuration for connecting to the master. # Configuration specific to failover replicas and read replicas.
        &quot;mysqlReplicaConfiguration&quot;: { # Read-replica configuration specific to MySQL databases. # MySQL specific configuration when replicating from a MySQL on-premises
            # master. Replication configuration information such as the username,
            # password, certificates, and keys are not stored in the instance metadata.
            # The configuration information is used only to set up the replication
            # connection and is stored by MySQL in a file named &lt;code&gt;master.info&lt;/code&gt;
            # in the data directory.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#mysqlReplicaConfiguration&lt;/code&gt;.
          &quot;password&quot;: &quot;A String&quot;, # The password for the replication connection.
          &quot;verifyServerCertificate&quot;: True or False, # Whether or not to check the master&#x27;s Common Name value in the certificate
              # that it sends during the SSL handshake.
          &quot;clientKey&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s private key. The corresponsing public key
              # is encoded in the client&#x27;s certificate.
          &quot;sslCipher&quot;: &quot;A String&quot;, # A list of permissible ciphers to use for SSL encryption.
          &quot;masterHeartbeatPeriod&quot;: &quot;A String&quot;, # Interval in milliseconds between replication heartbeats.
          &quot;connectRetryInterval&quot;: 42, # Seconds to wait between connect retries. MySQL&#x27;s default is 60 seconds.
          &quot;dumpFilePath&quot;: &quot;A String&quot;, # Path to a SQL dump file in Google Cloud Storage from which the slave
              # instance is to be created. The URI is in the form gs:
              # //bucketName/fileName. Compressed gzip files (.gz) are also supported.
              # // Dumps should have the binlog co-ordinates from which replication should
              # // begin. This can be accomplished by setting --master-data to 1 when using
              # // mysqldump.
          &quot;clientCertificate&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s x509 certificate.
          &quot;username&quot;: &quot;A String&quot;, # The username for the replication connection.
          &quot;caCertificate&quot;: &quot;A String&quot;, # PEM representation of the trusted CA&#x27;s x509 certificate.
        },
        &quot;failoverTarget&quot;: True or False, # Specifies if the replica is the failover target. If the field is set to
            # &lt;code&gt;true&lt;/code&gt; the replica will be designated as a failover replica. In
            # case the master instance fails, the replica instance will be promoted as
            # the new master instance.  &lt;p&gt;Only one replica can be specified as failover
            # target, and the replica has to be in different zone with the master
            # instance.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#replicaConfiguration&lt;/code&gt;.
      },
      &quot;connectionName&quot;: &quot;A String&quot;, # Connection name of the Cloud SQL instance used in connection strings.
      &quot;failoverReplica&quot;: { # The name and status of the failover replica. This property is applicable
          # only to Second Generation instances.
        &quot;name&quot;: &quot;A String&quot;, # The name of the failover replica. If specified at instance creation, a
            # failover replica is created for the instance. The name
            # doesn&#x27;t include the project ID. This property is applicable only to
            # Second Generation instances.
        &quot;available&quot;: True or False, # The availability status of the failover replica. A false status indicates
            # that the failover replica is out of sync. The master can only failover to
            # the failover replica when the status is true.
      },
      &quot;ipAddresses&quot;: [ # The assigned IP addresses for the instance.
        { # Database instance IP Mapping.
          &quot;type&quot;: &quot;A String&quot;, # The type of this IP address. A &lt;code&gt;PRIMARY&lt;/code&gt; address is a public
              # address that can accept incoming connections. A &lt;code&gt;PRIVATE&lt;/code&gt;
              # address is a private address that can accept incoming connections. An
              # &lt;code&gt;OUTGOING&lt;/code&gt; address is the source address of connections
              # originating from the instance, if supported.
          &quot;ipAddress&quot;: &quot;A String&quot;, # The IP address assigned.
          &quot;timeToRetire&quot;: &quot;A String&quot;, # The due time for this IP to be retired in &lt;a
              # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
              # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;. This field is only available when
              # the IP is scheduled to be retired.
        },
      ],
      &quot;ipv6Address&quot;: &quot;A String&quot;, # The IPv6 address assigned to the instance. This property is applicable only
          # to First Generation instances.
      &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
      &quot;diskEncryptionStatus&quot;: { # Disk encryption status for an instance. # Disk encryption status specific to an instance.
          # Applies only to Second Generation instances.
        &quot;kmsKeyVersionName&quot;: &quot;A String&quot;, # KMS key version used to encrypt the Cloud SQL instance resource
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#diskEncryptionStatus&lt;/code&gt;.
      },
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#instance&lt;/code&gt;.
      &quot;region&quot;: &quot;A String&quot;, # The geographical region. Can be &lt;code&gt;us-central&lt;/code&gt;
          # (&lt;code&gt;FIRST_GEN&lt;/code&gt; instances only), &lt;code&gt;us-central1&lt;/code&gt;
          # (&lt;code&gt;SECOND_GEN&lt;/code&gt; instances only), &lt;code&gt;asia-east1&lt;/code&gt; or
          # &lt;code&gt;europe-west1&lt;/code&gt;. Defaults to &lt;code&gt;us-central&lt;/code&gt; or
          # &lt;code&gt;us-central1&lt;/code&gt; depending on the instance type (First Generation
          # or Second Generation). The region can not be changed after instance
          # creation.
      &quot;state&quot;: &quot;A String&quot;, # The current serving state of the Cloud SQL instance. This can be one of the
          # following. &lt;br&gt;&lt;code&gt;RUNNABLE&lt;/code&gt;: The instance is running, or is ready
          # to run when accessed. &lt;br&gt;&lt;code&gt;SUSPENDED&lt;/code&gt;: The instance is not
          # available, for example due to problems with billing.
          # &lt;br&gt;&lt;code&gt;PENDING_CREATE&lt;/code&gt;: The instance is being created.
          # &lt;br&gt;&lt;code&gt;MAINTENANCE&lt;/code&gt;: The instance is down for maintenance.
          # &lt;br&gt;&lt;code&gt;FAILED&lt;/code&gt;: The instance creation failed.
          # &lt;br&gt;&lt;code&gt;UNKNOWN_STATE&lt;/code&gt;: The state of the instance is unknown.
      &quot;backendType&quot;: &quot;A String&quot;, # &lt;code&gt;FIRST_GEN&lt;/code&gt;: First Generation instance. MySQL only. &lt;br
          # /&gt;&lt;code&gt;SECOND_GEN&lt;/code&gt;: Second Generation instance or PostgreSQL
          # instance. &lt;br /&gt;&lt;code&gt;EXTERNAL&lt;/code&gt;: A database server that is not
          # managed by Google. &lt;br&gt;This property is read-only; use the
          # &lt;code&gt;tier&lt;/code&gt; property in the &lt;code&gt;settings&lt;/code&gt; object to determine
          # the database type and Second or First Generation.
      &quot;onPremisesConfiguration&quot;: { # On-premises instance configuration. # Configuration specific to on-premises instances.
        &quot;dumpFilePath&quot;: &quot;A String&quot;, # The dump file to create the Cloud SQL replica.
        &quot;hostPort&quot;: &quot;A String&quot;, # The host and port of the on-premises instance in host:port format
        &quot;clientCertificate&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s x509 certificate.
        &quot;username&quot;: &quot;A String&quot;, # The username for connecting to on-premises instance.
        &quot;caCertificate&quot;: &quot;A String&quot;, # PEM representation of the trusted CA&#x27;s x509 certificate.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#onPremisesConfiguration&lt;/code&gt;.
        &quot;password&quot;: &quot;A String&quot;, # The password for connecting to on-premises instance.
        &quot;clientKey&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s private key. The corresponsing public key
            # is encoded in the client&#x27;s certificate.
      },
      &quot;project&quot;: &quot;A String&quot;, # The project ID of the project containing the Cloud SQL instance. The Google
          # apps domain is prefixed if applicable.
      &quot;serviceAccountEmailAddress&quot;: &quot;A String&quot;, # The service account email address assigned to the instance. This property
          # is applicable only to Second Generation instances.
    }</pre>
</div>

<div class="method">
    <code class="details" id="import_">import_(project, instance, body=None, x__xgafv=None)</code>
  <pre>Imports data into a Cloud SQL instance from a SQL dump  or CSV file in
Cloud Storage.

Args:
  project: string, Project ID of the project that contains the instance. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  body: object, The request body.
    The object takes the form of:

{ # Database instance import request.
    &quot;importContext&quot;: { # Database instance import context. # Contains details about the import operation.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="insert">insert(project, body=None, x__xgafv=None)</code>
  <pre>Creates a new Cloud SQL instance.

Args:
  project: string, Project ID of the project to which the newly created Cloud SQL instances
should belong. (required)
  body: object, The request body.
    The object takes the form of:

{ # A Cloud SQL instance resource.
    &quot;databaseVersion&quot;: &quot;A String&quot;, # The database engine type and version. The &lt;code&gt;databaseVersion&lt;/code&gt;
        # field can not be changed after instance creation.  MySQL Second Generation
        # instances: &lt;code&gt;MYSQL_5_7&lt;/code&gt; (default) or &lt;code&gt;MYSQL_5_6&lt;/code&gt;.
        # PostgreSQL instances: &lt;code&gt;POSTGRES_9_6&lt;/code&gt; (default) or
        # &lt;code&gt;POSTGRES_11 Beta&lt;/code&gt; MySQL First Generation
        # instances: &lt;code&gt;MYSQL_5_6&lt;/code&gt; (default) or &lt;code&gt;MYSQL_5_5&lt;/code&gt;
    &quot;suspensionReason&quot;: [ # If the instance state is SUSPENDED, the reason for the suspension.
      &quot;A String&quot;,
    ],
    &quot;settings&quot;: { # Database instance settings. # The user settings.
      &quot;backupConfiguration&quot;: { # Database instance backup configuration. # The daily backup configuration for the instance.
        &quot;binaryLogEnabled&quot;: True or False, # (MySQL only) Whether binary log is enabled. If backup configuration is
            # disabled, binarylog must be disabled as well.
        &quot;replicationLogArchivingEnabled&quot;: True or False, # Reserved for future use.
        &quot;location&quot;: &quot;A String&quot;, # Location of the backup
        &quot;pointInTimeRecoveryEnabled&quot;: True or False, # Reserved for future use.
        &quot;startTime&quot;: &quot;A String&quot;, # Start time for the daily backup configuration in UTC timezone in the 24
            # hour format - &lt;code&gt;HH:MM&lt;/code&gt;.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#backupConfiguration&lt;/code&gt;.
        &quot;enabled&quot;: True or False, # Whether this configuration is enabled.
      },
      &quot;userLabels&quot;: { # User-provided labels, represented as a dictionary where each label is a
          # single key value pair.
        &quot;a_key&quot;: &quot;A String&quot;,
      },
      &quot;locationPreference&quot;: { # Preferred location. This specifies where a Cloud SQL instance should # The location preference settings. This allows the instance to be located as
          # near as possible to either an App Engine app or Compute Engine zone for
          # better performance. App Engine co-location is only applicable to First
          # Generation instances.
          # preferably be located, either in a specific Compute Engine zone, or
          # co-located with an App Engine application. Note that if the preferred
          # location is not available, the instance will be located as close as possible
          # within the region. Only one location may be specified.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#locationPreference&lt;/code&gt;.
        &quot;zone&quot;: &quot;A String&quot;, # The preferred Compute Engine zone (e.g. us-central1-a, us-central1-b,
            # etc.).
        &quot;followGaeApplication&quot;: &quot;A String&quot;, # The AppEngine application to follow, it must be in the same region as the
            # Cloud SQL instance.
      },
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#settings&lt;/code&gt;.
      &quot;replicationType&quot;: &quot;A String&quot;, # The type of replication this instance uses. This can be either
          # &lt;code&gt;ASYNCHRONOUS&lt;/code&gt; or &lt;code&gt;SYNCHRONOUS&lt;/code&gt;. This property is
          # only applicable to First Generation instances.
      &quot;activationPolicy&quot;: &quot;A String&quot;, # The activation policy specifies when the instance is activated; it is
          # applicable only when the instance state is &lt;code&gt;RUNNABLE&lt;/code&gt;. Valid
          # values: &lt;br&gt;&lt;code&gt;ALWAYS&lt;/code&gt;: The instance is on, and remains so even in
          # the absence of connection requests. &lt;br&gt;&lt;code&gt;NEVER&lt;/code&gt;: The instance is
          # off; it is not activated, even if a connection request arrives.
          # &lt;br&gt;&lt;code&gt;ON_DEMAND&lt;/code&gt;: First Generation instances only. The instance
          # responds to incoming requests, and turns itself off when not in use.
          # Instances with &lt;code&gt;PER_USE&lt;/code&gt; pricing turn off after 15 minutes of
          # inactivity. Instances with &lt;code&gt;PER_PACKAGE&lt;/code&gt; pricing turn off after
          # 12 hours of inactivity.
      &quot;ipConfiguration&quot;: { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the
          # instance IP and manage which external networks can connect to the instance.
          # The IPv4 address cannot be disabled for Second Generation instances.
        &quot;authorizedNetworks&quot;: [ # The list of external networks that are allowed to connect to the instance
            # using the IP. In &lt;a
            # href=&quot;http://en.wikipedia.org/wiki/CIDR_notation#CIDR_notation&quot;&gt;CIDR
            # notation&lt;/a&gt;, also known as &#x27;slash&#x27; notation (e.g.
            # &lt;code&gt;192.168.100.0/24&lt;/code&gt;).
          { # An entry for an Access Control list.
            &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#aclEntry&lt;/code&gt;.
            &quot;value&quot;: &quot;A String&quot;, # The whitelisted value for the access control list.
            &quot;expirationTime&quot;: &quot;A String&quot;, # The time when this access control entry expires in &lt;a
                # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
                # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
            &quot;name&quot;: &quot;A String&quot;, # Optional. A label to identify this entry.
          },
        ],
        &quot;requireSsl&quot;: True or False, # Whether SSL connections over IP should be enforced or not.
        &quot;privateNetwork&quot;: &quot;A String&quot;, # The resource link for the VPC network from which the Cloud SQL instance is
            # accessible for private IP. For example,
            # &lt;code&gt;/projects/myProject/global/networks/default&lt;/code&gt;. This setting can
            # be updated, but it cannot be removed after it is set.
        &quot;ipv4Enabled&quot;: True or False, # Whether the instance should be assigned an IP address or not.
      },
      &quot;availabilityType&quot;: &quot;A String&quot;, # Availability type (PostgreSQL and MySQL instances only). Potential values:
          # &lt;br&gt;&lt;code&gt;ZONAL&lt;/code&gt;: The instance serves data from only one zone.
          # Outages in that zone affect data accessibility. &lt;br&gt;&lt;code&gt;REGIONAL&lt;/code&gt;:
          # The instance can serve data from more than one zone in a region (it is
          # highly available). &lt;br&gt;For more information, see &lt;a
          # href=&quot;https://cloud.google.com/sql/docs/postgres/high-availability&quot;&gt;Overview
          # of the High Availability Configuration&lt;/a&gt;.
      &quot;settingsVersion&quot;: &quot;A String&quot;, # The version of instance settings. This is a required field for update
          # method to make sure concurrent updates are handled properly. During update,
          # use the most recent settingsVersion value for this instance and do not try
          # to update this value.
      &quot;databaseFlags&quot;: [ # The database flags passed to the instance at startup.
        { # Database flags for Cloud SQL instances.
          &quot;name&quot;: &quot;A String&quot;, # The name of the flag. These flags are passed at instance startup, so
              # include both server options and system variables for MySQL. Flags should be
              # specified with underscores, not hyphens. For more information, see &lt;a
              # href=&quot;/sql/docs/mysql/flags&quot;&gt;Configuring Database Flags&lt;/a&gt; in the Cloud
              # SQL documentation.
          &quot;value&quot;: &quot;A String&quot;, # The value of the flag. Booleans should be set to &lt;code&gt;on&lt;/code&gt; for true
              # and &lt;code&gt;off&lt;/code&gt; for false. This field must be omitted if the flag
              # doesn&#x27;t take a value.
        },
      ],
      &quot;maintenanceWindow&quot;: { # Maintenance window. This specifies when a v2 Cloud SQL instance should # The maintenance window for this instance. This specifies when the instance
          # can be restarted for maintenance purposes. Not used for First Generation
          # instances.
          # preferably be restarted for system maintenance purposes.
        &quot;hour&quot;: 42, # hour of day - 0 to 23.
        &quot;day&quot;: 42, # day of week (1-7), starting on Monday.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#maintenanceWindow&lt;/code&gt;.
        &quot;updateTrack&quot;: &quot;A String&quot;, # Maintenance timing setting: &lt;code&gt;canary&lt;/code&gt; (Earlier) or
            # &lt;code&gt;stable&lt;/code&gt; (Later). &lt;br /&gt;&lt;a
            # href=&quot;/sql/docs/db_path/instance-settings#maintenance-timing-2ndgen&quot;&gt;
            # Learn more&lt;/a&gt;.
      },
      &quot;pricingPlan&quot;: &quot;A String&quot;, # The pricing plan for this instance. This can be either &lt;code&gt;PER_USE&lt;/code&gt;
          # or &lt;code&gt;PACKAGE&lt;/code&gt;. Only &lt;code&gt;PER_USE&lt;/code&gt; is supported for Second
          # Generation instances.
      &quot;storageAutoResize&quot;: True or False, # Configuration to increase storage size automatically. The default value is
          # true. Not used for First Generation instances.
      &quot;storageAutoResizeLimit&quot;: &quot;A String&quot;, # The maximum size to which storage capacity can be automatically increased.
          # The default value is 0, which specifies that there is no limit. Not used
          # for First Generation instances.
      &quot;authorizedGaeApplications&quot;: [ # The App Engine app IDs that can access this instance. First Generation
          # instances only.
        &quot;A String&quot;,
      ],
      &quot;tier&quot;: &quot;A String&quot;, # The tier (or machine type) for this instance, for example
          # &lt;code&gt;db-n1-standard-1&lt;/code&gt; (MySQL instances) or
          # &lt;code&gt;db-custom-1-3840&lt;/code&gt; (PostgreSQL instances). For MySQL instances,
          # this property determines whether the instance is First or Second
          # Generation. For more information, see &lt;a
          # href=&quot;/sql/docs/db_path/instance-settings&quot;&gt;Instance Settings&lt;/a&gt;.
      &quot;dataDiskSizeGb&quot;: &quot;A String&quot;, # The size of data disk, in GB. The data disk size minimum is 10GB. Not used
          # for First Generation instances.
      &quot;dataDiskType&quot;: &quot;A String&quot;, # The type of data disk: &lt;code&gt;PD_SSD&lt;/code&gt; (default) or
          # &lt;code&gt;PD_HDD&lt;/code&gt;. Not used for First Generation instances.
      &quot;databaseReplicationEnabled&quot;: True or False, # Configuration specific to read replica instances. Indicates whether
          # replication is enabled or not.
      &quot;crashSafeReplicationEnabled&quot;: True or False, # Configuration specific to read replica instances. Indicates whether
          # database flags for crash-safe replication are enabled. This property is
          # only applicable to First Generation instances.
    },
    &quot;replicaNames&quot;: [ # The replicas of the instance.
      &quot;A String&quot;,
    ],
    &quot;diskEncryptionConfiguration&quot;: { # Disk encryption configuration for an instance. # Disk encryption configuration specific to an instance.
        # Applies only to Second Generation instances.
      &quot;kmsKeyName&quot;: &quot;A String&quot;, # Resource name of KMS key for disk encryption
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#diskEncryptionConfiguration&lt;/code&gt;.
    },
    &quot;scheduledMaintenance&quot;: { # Any scheduled maintenancce for this instance. # The start time of any upcoming scheduled maintenance for this instance.
      &quot;canReschedule&quot;: True or False, # If the scheduled maintenance can be rescheduled.
      &quot;canDefer&quot;: True or False,
      &quot;startTime&quot;: &quot;A String&quot;, # The start time of any upcoming scheduled maintenance for this instance.
    },
    &quot;rootPassword&quot;: &quot;A String&quot;, # Initial root password. Use only on creation.
    &quot;etag&quot;: &quot;A String&quot;, # This field is deprecated and will be removed from a future version of the
        # API. Use the &lt;code&gt;settings.settingsVersion&lt;/code&gt; field instead.
    &quot;serverCaCert&quot;: { # SslCerts Resource # SSL configuration.
      &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
      &quot;expirationTime&quot;: &quot;A String&quot;, # The time when the certificate expires in &lt;a
          # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
          # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
      &quot;sha1Fingerprint&quot;: &quot;A String&quot;, # Sha1 Fingerprint.
      &quot;certSerialNumber&quot;: &quot;A String&quot;, # Serial number, as extracted from the certificate.
      &quot;cert&quot;: &quot;A String&quot;, # PEM representation.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#sslCert&lt;/code&gt;.
      &quot;commonName&quot;: &quot;A String&quot;, # User supplied name.  Constrained to [a-zA-Z.-_ ]+.
      &quot;createTime&quot;: &quot;A String&quot;, # The time when the certificate was created in &lt;a
          # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
          # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;
      &quot;instance&quot;: &quot;A String&quot;, # Name of the database instance.
    },
    &quot;maxDiskSize&quot;: &quot;A String&quot;, # The maximum disk size of the instance in bytes.
    &quot;name&quot;: &quot;A String&quot;, # Name of the Cloud SQL instance. This does not include the project ID.
    &quot;masterInstanceName&quot;: &quot;A String&quot;, # The name of the instance which will act as master in the replication setup.
    &quot;instanceType&quot;: &quot;A String&quot;, # The instance type. This can be one of the following.
        # &lt;br&gt;&lt;code&gt;CLOUD_SQL_INSTANCE&lt;/code&gt;: A Cloud SQL instance that is not
        # replicating from a master. &lt;br&gt;&lt;code&gt;ON_PREMISES_INSTANCE&lt;/code&gt;: An
        # instance running on the
        # customer&#x27;s premises. &lt;br&gt;&lt;code&gt;READ_REPLICA_INSTANCE&lt;/code&gt;: A Cloud SQL
        # instance configured as a read-replica.
    &quot;gceZone&quot;: &quot;A String&quot;, # The Compute Engine zone that the instance is currently serving from. This
        # value could be different from the zone that was specified when the instance
        # was created if the instance has failed over to its secondary zone.
    &quot;currentDiskSize&quot;: &quot;A String&quot;, # The current disk usage of the instance in bytes. This property has been
        # deprecated. Users should use the
        # &quot;cloudsql.googleapis.com/database/disk/bytes_used&quot; metric in Cloud
        # Monitoring API instead. Please see &lt;a
        # href=&quot;https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ&quot;&gt;this
        # announcement&lt;/a&gt; for details.
    &quot;replicaConfiguration&quot;: { # Read-replica configuration for connecting to the master. # Configuration specific to failover replicas and read replicas.
      &quot;mysqlReplicaConfiguration&quot;: { # Read-replica configuration specific to MySQL databases. # MySQL specific configuration when replicating from a MySQL on-premises
          # master. Replication configuration information such as the username,
          # password, certificates, and keys are not stored in the instance metadata.
          # The configuration information is used only to set up the replication
          # connection and is stored by MySQL in a file named &lt;code&gt;master.info&lt;/code&gt;
          # in the data directory.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#mysqlReplicaConfiguration&lt;/code&gt;.
        &quot;password&quot;: &quot;A String&quot;, # The password for the replication connection.
        &quot;verifyServerCertificate&quot;: True or False, # Whether or not to check the master&#x27;s Common Name value in the certificate
            # that it sends during the SSL handshake.
        &quot;clientKey&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s private key. The corresponsing public key
            # is encoded in the client&#x27;s certificate.
        &quot;sslCipher&quot;: &quot;A String&quot;, # A list of permissible ciphers to use for SSL encryption.
        &quot;masterHeartbeatPeriod&quot;: &quot;A String&quot;, # Interval in milliseconds between replication heartbeats.
        &quot;connectRetryInterval&quot;: 42, # Seconds to wait between connect retries. MySQL&#x27;s default is 60 seconds.
        &quot;dumpFilePath&quot;: &quot;A String&quot;, # Path to a SQL dump file in Google Cloud Storage from which the slave
            # instance is to be created. The URI is in the form gs:
            # //bucketName/fileName. Compressed gzip files (.gz) are also supported.
            # // Dumps should have the binlog co-ordinates from which replication should
            # // begin. This can be accomplished by setting --master-data to 1 when using
            # // mysqldump.
        &quot;clientCertificate&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s x509 certificate.
        &quot;username&quot;: &quot;A String&quot;, # The username for the replication connection.
        &quot;caCertificate&quot;: &quot;A String&quot;, # PEM representation of the trusted CA&#x27;s x509 certificate.
      },
      &quot;failoverTarget&quot;: True or False, # Specifies if the replica is the failover target. If the field is set to
          # &lt;code&gt;true&lt;/code&gt; the replica will be designated as a failover replica. In
          # case the master instance fails, the replica instance will be promoted as
          # the new master instance.  &lt;p&gt;Only one replica can be specified as failover
          # target, and the replica has to be in different zone with the master
          # instance.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#replicaConfiguration&lt;/code&gt;.
    },
    &quot;connectionName&quot;: &quot;A String&quot;, # Connection name of the Cloud SQL instance used in connection strings.
    &quot;failoverReplica&quot;: { # The name and status of the failover replica. This property is applicable
        # only to Second Generation instances.
      &quot;name&quot;: &quot;A String&quot;, # The name of the failover replica. If specified at instance creation, a
          # failover replica is created for the instance. The name
          # doesn&#x27;t include the project ID. This property is applicable only to
          # Second Generation instances.
      &quot;available&quot;: True or False, # The availability status of the failover replica. A false status indicates
          # that the failover replica is out of sync. The master can only failover to
          # the failover replica when the status is true.
    },
    &quot;ipAddresses&quot;: [ # The assigned IP addresses for the instance.
      { # Database instance IP Mapping.
        &quot;type&quot;: &quot;A String&quot;, # The type of this IP address. A &lt;code&gt;PRIMARY&lt;/code&gt; address is a public
            # address that can accept incoming connections. A &lt;code&gt;PRIVATE&lt;/code&gt;
            # address is a private address that can accept incoming connections. An
            # &lt;code&gt;OUTGOING&lt;/code&gt; address is the source address of connections
            # originating from the instance, if supported.
        &quot;ipAddress&quot;: &quot;A String&quot;, # The IP address assigned.
        &quot;timeToRetire&quot;: &quot;A String&quot;, # The due time for this IP to be retired in &lt;a
            # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
            # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;. This field is only available when
            # the IP is scheduled to be retired.
      },
    ],
    &quot;ipv6Address&quot;: &quot;A String&quot;, # The IPv6 address assigned to the instance. This property is applicable only
        # to First Generation instances.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;diskEncryptionStatus&quot;: { # Disk encryption status for an instance. # Disk encryption status specific to an instance.
        # Applies only to Second Generation instances.
      &quot;kmsKeyVersionName&quot;: &quot;A String&quot;, # KMS key version used to encrypt the Cloud SQL instance resource
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#diskEncryptionStatus&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#instance&lt;/code&gt;.
    &quot;region&quot;: &quot;A String&quot;, # The geographical region. Can be &lt;code&gt;us-central&lt;/code&gt;
        # (&lt;code&gt;FIRST_GEN&lt;/code&gt; instances only), &lt;code&gt;us-central1&lt;/code&gt;
        # (&lt;code&gt;SECOND_GEN&lt;/code&gt; instances only), &lt;code&gt;asia-east1&lt;/code&gt; or
        # &lt;code&gt;europe-west1&lt;/code&gt;. Defaults to &lt;code&gt;us-central&lt;/code&gt; or
        # &lt;code&gt;us-central1&lt;/code&gt; depending on the instance type (First Generation
        # or Second Generation). The region can not be changed after instance
        # creation.
    &quot;state&quot;: &quot;A String&quot;, # The current serving state of the Cloud SQL instance. This can be one of the
        # following. &lt;br&gt;&lt;code&gt;RUNNABLE&lt;/code&gt;: The instance is running, or is ready
        # to run when accessed. &lt;br&gt;&lt;code&gt;SUSPENDED&lt;/code&gt;: The instance is not
        # available, for example due to problems with billing.
        # &lt;br&gt;&lt;code&gt;PENDING_CREATE&lt;/code&gt;: The instance is being created.
        # &lt;br&gt;&lt;code&gt;MAINTENANCE&lt;/code&gt;: The instance is down for maintenance.
        # &lt;br&gt;&lt;code&gt;FAILED&lt;/code&gt;: The instance creation failed.
        # &lt;br&gt;&lt;code&gt;UNKNOWN_STATE&lt;/code&gt;: The state of the instance is unknown.
    &quot;backendType&quot;: &quot;A String&quot;, # &lt;code&gt;FIRST_GEN&lt;/code&gt;: First Generation instance. MySQL only. &lt;br
        # /&gt;&lt;code&gt;SECOND_GEN&lt;/code&gt;: Second Generation instance or PostgreSQL
        # instance. &lt;br /&gt;&lt;code&gt;EXTERNAL&lt;/code&gt;: A database server that is not
        # managed by Google. &lt;br&gt;This property is read-only; use the
        # &lt;code&gt;tier&lt;/code&gt; property in the &lt;code&gt;settings&lt;/code&gt; object to determine
        # the database type and Second or First Generation.
    &quot;onPremisesConfiguration&quot;: { # On-premises instance configuration. # Configuration specific to on-premises instances.
      &quot;dumpFilePath&quot;: &quot;A String&quot;, # The dump file to create the Cloud SQL replica.
      &quot;hostPort&quot;: &quot;A String&quot;, # The host and port of the on-premises instance in host:port format
      &quot;clientCertificate&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s x509 certificate.
      &quot;username&quot;: &quot;A String&quot;, # The username for connecting to on-premises instance.
      &quot;caCertificate&quot;: &quot;A String&quot;, # PEM representation of the trusted CA&#x27;s x509 certificate.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#onPremisesConfiguration&lt;/code&gt;.
      &quot;password&quot;: &quot;A String&quot;, # The password for connecting to on-premises instance.
      &quot;clientKey&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s private key. The corresponsing public key
          # is encoded in the client&#x27;s certificate.
    },
    &quot;project&quot;: &quot;A String&quot;, # The project ID of the project containing the Cloud SQL instance. The Google
        # apps domain is prefixed if applicable.
    &quot;serviceAccountEmailAddress&quot;: &quot;A String&quot;, # The service account email address assigned to the instance. This property
        # is applicable only to Second Generation instances.
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="list">list(project, pageToken=None, maxResults=None, filter=None, x__xgafv=None)</code>
  <pre>Lists instances under a given project.

Args:
  project: string, Project ID of the project for which to list Cloud SQL instances. (required)
  pageToken: string, A previously-returned page token representing part of the larger set of
results to view.
  maxResults: integer, The maximum number of results to return per response.
  filter: string, A filter expression that filters resources listed in the response.
The expression is in the form of field:value. For example,
&#x27;instanceType:CLOUD_SQL_INSTANCE&#x27;. Fields can be nested as needed as per
their JSON representation, such as &#x27;settings.userLabels.auto_start:true&#x27;.

Multiple filter queries are space-separated. For example.
&#x27;state:RUNNABLE instanceType:CLOUD_SQL_INSTANCE&#x27;. By default, each
expression is an AND expression. However, you can include AND and OR
expressions explicitly.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Database instances list response.
    &quot;items&quot;: [ # List of database instance resources.
      { # A Cloud SQL instance resource.
          &quot;databaseVersion&quot;: &quot;A String&quot;, # The database engine type and version. The &lt;code&gt;databaseVersion&lt;/code&gt;
              # field can not be changed after instance creation.  MySQL Second Generation
              # instances: &lt;code&gt;MYSQL_5_7&lt;/code&gt; (default) or &lt;code&gt;MYSQL_5_6&lt;/code&gt;.
              # PostgreSQL instances: &lt;code&gt;POSTGRES_9_6&lt;/code&gt; (default) or
              # &lt;code&gt;POSTGRES_11 Beta&lt;/code&gt; MySQL First Generation
              # instances: &lt;code&gt;MYSQL_5_6&lt;/code&gt; (default) or &lt;code&gt;MYSQL_5_5&lt;/code&gt;
          &quot;suspensionReason&quot;: [ # If the instance state is SUSPENDED, the reason for the suspension.
            &quot;A String&quot;,
          ],
          &quot;settings&quot;: { # Database instance settings. # The user settings.
            &quot;backupConfiguration&quot;: { # Database instance backup configuration. # The daily backup configuration for the instance.
              &quot;binaryLogEnabled&quot;: True or False, # (MySQL only) Whether binary log is enabled. If backup configuration is
                  # disabled, binarylog must be disabled as well.
              &quot;replicationLogArchivingEnabled&quot;: True or False, # Reserved for future use.
              &quot;location&quot;: &quot;A String&quot;, # Location of the backup
              &quot;pointInTimeRecoveryEnabled&quot;: True or False, # Reserved for future use.
              &quot;startTime&quot;: &quot;A String&quot;, # Start time for the daily backup configuration in UTC timezone in the 24
                  # hour format - &lt;code&gt;HH:MM&lt;/code&gt;.
              &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#backupConfiguration&lt;/code&gt;.
              &quot;enabled&quot;: True or False, # Whether this configuration is enabled.
            },
            &quot;userLabels&quot;: { # User-provided labels, represented as a dictionary where each label is a
                # single key value pair.
              &quot;a_key&quot;: &quot;A String&quot;,
            },
            &quot;locationPreference&quot;: { # Preferred location. This specifies where a Cloud SQL instance should # The location preference settings. This allows the instance to be located as
                # near as possible to either an App Engine app or Compute Engine zone for
                # better performance. App Engine co-location is only applicable to First
                # Generation instances.
                # preferably be located, either in a specific Compute Engine zone, or
                # co-located with an App Engine application. Note that if the preferred
                # location is not available, the instance will be located as close as possible
                # within the region. Only one location may be specified.
              &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#locationPreference&lt;/code&gt;.
              &quot;zone&quot;: &quot;A String&quot;, # The preferred Compute Engine zone (e.g. us-central1-a, us-central1-b,
                  # etc.).
              &quot;followGaeApplication&quot;: &quot;A String&quot;, # The AppEngine application to follow, it must be in the same region as the
                  # Cloud SQL instance.
            },
            &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#settings&lt;/code&gt;.
            &quot;replicationType&quot;: &quot;A String&quot;, # The type of replication this instance uses. This can be either
                # &lt;code&gt;ASYNCHRONOUS&lt;/code&gt; or &lt;code&gt;SYNCHRONOUS&lt;/code&gt;. This property is
                # only applicable to First Generation instances.
            &quot;activationPolicy&quot;: &quot;A String&quot;, # The activation policy specifies when the instance is activated; it is
                # applicable only when the instance state is &lt;code&gt;RUNNABLE&lt;/code&gt;. Valid
                # values: &lt;br&gt;&lt;code&gt;ALWAYS&lt;/code&gt;: The instance is on, and remains so even in
                # the absence of connection requests. &lt;br&gt;&lt;code&gt;NEVER&lt;/code&gt;: The instance is
                # off; it is not activated, even if a connection request arrives.
                # &lt;br&gt;&lt;code&gt;ON_DEMAND&lt;/code&gt;: First Generation instances only. The instance
                # responds to incoming requests, and turns itself off when not in use.
                # Instances with &lt;code&gt;PER_USE&lt;/code&gt; pricing turn off after 15 minutes of
                # inactivity. Instances with &lt;code&gt;PER_PACKAGE&lt;/code&gt; pricing turn off after
                # 12 hours of inactivity.
            &quot;ipConfiguration&quot;: { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the
                # instance IP and manage which external networks can connect to the instance.
                # The IPv4 address cannot be disabled for Second Generation instances.
              &quot;authorizedNetworks&quot;: [ # The list of external networks that are allowed to connect to the instance
                  # using the IP. In &lt;a
                  # href=&quot;http://en.wikipedia.org/wiki/CIDR_notation#CIDR_notation&quot;&gt;CIDR
                  # notation&lt;/a&gt;, also known as &#x27;slash&#x27; notation (e.g.
                  # &lt;code&gt;192.168.100.0/24&lt;/code&gt;).
                { # An entry for an Access Control list.
                  &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#aclEntry&lt;/code&gt;.
                  &quot;value&quot;: &quot;A String&quot;, # The whitelisted value for the access control list.
                  &quot;expirationTime&quot;: &quot;A String&quot;, # The time when this access control entry expires in &lt;a
                      # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
                      # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
                  &quot;name&quot;: &quot;A String&quot;, # Optional. A label to identify this entry.
                },
              ],
              &quot;requireSsl&quot;: True or False, # Whether SSL connections over IP should be enforced or not.
              &quot;privateNetwork&quot;: &quot;A String&quot;, # The resource link for the VPC network from which the Cloud SQL instance is
                  # accessible for private IP. For example,
                  # &lt;code&gt;/projects/myProject/global/networks/default&lt;/code&gt;. This setting can
                  # be updated, but it cannot be removed after it is set.
              &quot;ipv4Enabled&quot;: True or False, # Whether the instance should be assigned an IP address or not.
            },
            &quot;availabilityType&quot;: &quot;A String&quot;, # Availability type (PostgreSQL and MySQL instances only). Potential values:
                # &lt;br&gt;&lt;code&gt;ZONAL&lt;/code&gt;: The instance serves data from only one zone.
                # Outages in that zone affect data accessibility. &lt;br&gt;&lt;code&gt;REGIONAL&lt;/code&gt;:
                # The instance can serve data from more than one zone in a region (it is
                # highly available). &lt;br&gt;For more information, see &lt;a
                # href=&quot;https://cloud.google.com/sql/docs/postgres/high-availability&quot;&gt;Overview
                # of the High Availability Configuration&lt;/a&gt;.
            &quot;settingsVersion&quot;: &quot;A String&quot;, # The version of instance settings. This is a required field for update
                # method to make sure concurrent updates are handled properly. During update,
                # use the most recent settingsVersion value for this instance and do not try
                # to update this value.
            &quot;databaseFlags&quot;: [ # The database flags passed to the instance at startup.
              { # Database flags for Cloud SQL instances.
                &quot;name&quot;: &quot;A String&quot;, # The name of the flag. These flags are passed at instance startup, so
                    # include both server options and system variables for MySQL. Flags should be
                    # specified with underscores, not hyphens. For more information, see &lt;a
                    # href=&quot;/sql/docs/mysql/flags&quot;&gt;Configuring Database Flags&lt;/a&gt; in the Cloud
                    # SQL documentation.
                &quot;value&quot;: &quot;A String&quot;, # The value of the flag. Booleans should be set to &lt;code&gt;on&lt;/code&gt; for true
                    # and &lt;code&gt;off&lt;/code&gt; for false. This field must be omitted if the flag
                    # doesn&#x27;t take a value.
              },
            ],
            &quot;maintenanceWindow&quot;: { # Maintenance window. This specifies when a v2 Cloud SQL instance should # The maintenance window for this instance. This specifies when the instance
                # can be restarted for maintenance purposes. Not used for First Generation
                # instances.
                # preferably be restarted for system maintenance purposes.
              &quot;hour&quot;: 42, # hour of day - 0 to 23.
              &quot;day&quot;: 42, # day of week (1-7), starting on Monday.
              &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#maintenanceWindow&lt;/code&gt;.
              &quot;updateTrack&quot;: &quot;A String&quot;, # Maintenance timing setting: &lt;code&gt;canary&lt;/code&gt; (Earlier) or
                  # &lt;code&gt;stable&lt;/code&gt; (Later). &lt;br /&gt;&lt;a
                  # href=&quot;/sql/docs/db_path/instance-settings#maintenance-timing-2ndgen&quot;&gt;
                  # Learn more&lt;/a&gt;.
            },
            &quot;pricingPlan&quot;: &quot;A String&quot;, # The pricing plan for this instance. This can be either &lt;code&gt;PER_USE&lt;/code&gt;
                # or &lt;code&gt;PACKAGE&lt;/code&gt;. Only &lt;code&gt;PER_USE&lt;/code&gt; is supported for Second
                # Generation instances.
            &quot;storageAutoResize&quot;: True or False, # Configuration to increase storage size automatically. The default value is
                # true. Not used for First Generation instances.
            &quot;storageAutoResizeLimit&quot;: &quot;A String&quot;, # The maximum size to which storage capacity can be automatically increased.
                # The default value is 0, which specifies that there is no limit. Not used
                # for First Generation instances.
            &quot;authorizedGaeApplications&quot;: [ # The App Engine app IDs that can access this instance. First Generation
                # instances only.
              &quot;A String&quot;,
            ],
            &quot;tier&quot;: &quot;A String&quot;, # The tier (or machine type) for this instance, for example
                # &lt;code&gt;db-n1-standard-1&lt;/code&gt; (MySQL instances) or
                # &lt;code&gt;db-custom-1-3840&lt;/code&gt; (PostgreSQL instances). For MySQL instances,
                # this property determines whether the instance is First or Second
                # Generation. For more information, see &lt;a
                # href=&quot;/sql/docs/db_path/instance-settings&quot;&gt;Instance Settings&lt;/a&gt;.
            &quot;dataDiskSizeGb&quot;: &quot;A String&quot;, # The size of data disk, in GB. The data disk size minimum is 10GB. Not used
                # for First Generation instances.
            &quot;dataDiskType&quot;: &quot;A String&quot;, # The type of data disk: &lt;code&gt;PD_SSD&lt;/code&gt; (default) or
                # &lt;code&gt;PD_HDD&lt;/code&gt;. Not used for First Generation instances.
            &quot;databaseReplicationEnabled&quot;: True or False, # Configuration specific to read replica instances. Indicates whether
                # replication is enabled or not.
            &quot;crashSafeReplicationEnabled&quot;: True or False, # Configuration specific to read replica instances. Indicates whether
                # database flags for crash-safe replication are enabled. This property is
                # only applicable to First Generation instances.
          },
          &quot;replicaNames&quot;: [ # The replicas of the instance.
            &quot;A String&quot;,
          ],
          &quot;diskEncryptionConfiguration&quot;: { # Disk encryption configuration for an instance. # Disk encryption configuration specific to an instance.
              # Applies only to Second Generation instances.
            &quot;kmsKeyName&quot;: &quot;A String&quot;, # Resource name of KMS key for disk encryption
            &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#diskEncryptionConfiguration&lt;/code&gt;.
          },
          &quot;scheduledMaintenance&quot;: { # Any scheduled maintenancce for this instance. # The start time of any upcoming scheduled maintenance for this instance.
            &quot;canReschedule&quot;: True or False, # If the scheduled maintenance can be rescheduled.
            &quot;canDefer&quot;: True or False,
            &quot;startTime&quot;: &quot;A String&quot;, # The start time of any upcoming scheduled maintenance for this instance.
          },
          &quot;rootPassword&quot;: &quot;A String&quot;, # Initial root password. Use only on creation.
          &quot;etag&quot;: &quot;A String&quot;, # This field is deprecated and will be removed from a future version of the
              # API. Use the &lt;code&gt;settings.settingsVersion&lt;/code&gt; field instead.
          &quot;serverCaCert&quot;: { # SslCerts Resource # SSL configuration.
            &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
            &quot;expirationTime&quot;: &quot;A String&quot;, # The time when the certificate expires in &lt;a
                # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
                # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
            &quot;sha1Fingerprint&quot;: &quot;A String&quot;, # Sha1 Fingerprint.
            &quot;certSerialNumber&quot;: &quot;A String&quot;, # Serial number, as extracted from the certificate.
            &quot;cert&quot;: &quot;A String&quot;, # PEM representation.
            &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#sslCert&lt;/code&gt;.
            &quot;commonName&quot;: &quot;A String&quot;, # User supplied name.  Constrained to [a-zA-Z.-_ ]+.
            &quot;createTime&quot;: &quot;A String&quot;, # The time when the certificate was created in &lt;a
                # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
                # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;
            &quot;instance&quot;: &quot;A String&quot;, # Name of the database instance.
          },
          &quot;maxDiskSize&quot;: &quot;A String&quot;, # The maximum disk size of the instance in bytes.
          &quot;name&quot;: &quot;A String&quot;, # Name of the Cloud SQL instance. This does not include the project ID.
          &quot;masterInstanceName&quot;: &quot;A String&quot;, # The name of the instance which will act as master in the replication setup.
          &quot;instanceType&quot;: &quot;A String&quot;, # The instance type. This can be one of the following.
              # &lt;br&gt;&lt;code&gt;CLOUD_SQL_INSTANCE&lt;/code&gt;: A Cloud SQL instance that is not
              # replicating from a master. &lt;br&gt;&lt;code&gt;ON_PREMISES_INSTANCE&lt;/code&gt;: An
              # instance running on the
              # customer&#x27;s premises. &lt;br&gt;&lt;code&gt;READ_REPLICA_INSTANCE&lt;/code&gt;: A Cloud SQL
              # instance configured as a read-replica.
          &quot;gceZone&quot;: &quot;A String&quot;, # The Compute Engine zone that the instance is currently serving from. This
              # value could be different from the zone that was specified when the instance
              # was created if the instance has failed over to its secondary zone.
          &quot;currentDiskSize&quot;: &quot;A String&quot;, # The current disk usage of the instance in bytes. This property has been
              # deprecated. Users should use the
              # &quot;cloudsql.googleapis.com/database/disk/bytes_used&quot; metric in Cloud
              # Monitoring API instead. Please see &lt;a
              # href=&quot;https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ&quot;&gt;this
              # announcement&lt;/a&gt; for details.
          &quot;replicaConfiguration&quot;: { # Read-replica configuration for connecting to the master. # Configuration specific to failover replicas and read replicas.
            &quot;mysqlReplicaConfiguration&quot;: { # Read-replica configuration specific to MySQL databases. # MySQL specific configuration when replicating from a MySQL on-premises
                # master. Replication configuration information such as the username,
                # password, certificates, and keys are not stored in the instance metadata.
                # The configuration information is used only to set up the replication
                # connection and is stored by MySQL in a file named &lt;code&gt;master.info&lt;/code&gt;
                # in the data directory.
              &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#mysqlReplicaConfiguration&lt;/code&gt;.
              &quot;password&quot;: &quot;A String&quot;, # The password for the replication connection.
              &quot;verifyServerCertificate&quot;: True or False, # Whether or not to check the master&#x27;s Common Name value in the certificate
                  # that it sends during the SSL handshake.
              &quot;clientKey&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s private key. The corresponsing public key
                  # is encoded in the client&#x27;s certificate.
              &quot;sslCipher&quot;: &quot;A String&quot;, # A list of permissible ciphers to use for SSL encryption.
              &quot;masterHeartbeatPeriod&quot;: &quot;A String&quot;, # Interval in milliseconds between replication heartbeats.
              &quot;connectRetryInterval&quot;: 42, # Seconds to wait between connect retries. MySQL&#x27;s default is 60 seconds.
              &quot;dumpFilePath&quot;: &quot;A String&quot;, # Path to a SQL dump file in Google Cloud Storage from which the slave
                  # instance is to be created. The URI is in the form gs:
                  # //bucketName/fileName. Compressed gzip files (.gz) are also supported.
                  # // Dumps should have the binlog co-ordinates from which replication should
                  # // begin. This can be accomplished by setting --master-data to 1 when using
                  # // mysqldump.
              &quot;clientCertificate&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s x509 certificate.
              &quot;username&quot;: &quot;A String&quot;, # The username for the replication connection.
              &quot;caCertificate&quot;: &quot;A String&quot;, # PEM representation of the trusted CA&#x27;s x509 certificate.
            },
            &quot;failoverTarget&quot;: True or False, # Specifies if the replica is the failover target. If the field is set to
                # &lt;code&gt;true&lt;/code&gt; the replica will be designated as a failover replica. In
                # case the master instance fails, the replica instance will be promoted as
                # the new master instance.  &lt;p&gt;Only one replica can be specified as failover
                # target, and the replica has to be in different zone with the master
                # instance.
            &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#replicaConfiguration&lt;/code&gt;.
          },
          &quot;connectionName&quot;: &quot;A String&quot;, # Connection name of the Cloud SQL instance used in connection strings.
          &quot;failoverReplica&quot;: { # The name and status of the failover replica. This property is applicable
              # only to Second Generation instances.
            &quot;name&quot;: &quot;A String&quot;, # The name of the failover replica. If specified at instance creation, a
                # failover replica is created for the instance. The name
                # doesn&#x27;t include the project ID. This property is applicable only to
                # Second Generation instances.
            &quot;available&quot;: True or False, # The availability status of the failover replica. A false status indicates
                # that the failover replica is out of sync. The master can only failover to
                # the failover replica when the status is true.
          },
          &quot;ipAddresses&quot;: [ # The assigned IP addresses for the instance.
            { # Database instance IP Mapping.
              &quot;type&quot;: &quot;A String&quot;, # The type of this IP address. A &lt;code&gt;PRIMARY&lt;/code&gt; address is a public
                  # address that can accept incoming connections. A &lt;code&gt;PRIVATE&lt;/code&gt;
                  # address is a private address that can accept incoming connections. An
                  # &lt;code&gt;OUTGOING&lt;/code&gt; address is the source address of connections
                  # originating from the instance, if supported.
              &quot;ipAddress&quot;: &quot;A String&quot;, # The IP address assigned.
              &quot;timeToRetire&quot;: &quot;A String&quot;, # The due time for this IP to be retired in &lt;a
                  # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
                  # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;. This field is only available when
                  # the IP is scheduled to be retired.
            },
          ],
          &quot;ipv6Address&quot;: &quot;A String&quot;, # The IPv6 address assigned to the instance. This property is applicable only
              # to First Generation instances.
          &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
          &quot;diskEncryptionStatus&quot;: { # Disk encryption status for an instance. # Disk encryption status specific to an instance.
              # Applies only to Second Generation instances.
            &quot;kmsKeyVersionName&quot;: &quot;A String&quot;, # KMS key version used to encrypt the Cloud SQL instance resource
            &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#diskEncryptionStatus&lt;/code&gt;.
          },
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#instance&lt;/code&gt;.
          &quot;region&quot;: &quot;A String&quot;, # The geographical region. Can be &lt;code&gt;us-central&lt;/code&gt;
              # (&lt;code&gt;FIRST_GEN&lt;/code&gt; instances only), &lt;code&gt;us-central1&lt;/code&gt;
              # (&lt;code&gt;SECOND_GEN&lt;/code&gt; instances only), &lt;code&gt;asia-east1&lt;/code&gt; or
              # &lt;code&gt;europe-west1&lt;/code&gt;. Defaults to &lt;code&gt;us-central&lt;/code&gt; or
              # &lt;code&gt;us-central1&lt;/code&gt; depending on the instance type (First Generation
              # or Second Generation). The region can not be changed after instance
              # creation.
          &quot;state&quot;: &quot;A String&quot;, # The current serving state of the Cloud SQL instance. This can be one of the
              # following. &lt;br&gt;&lt;code&gt;RUNNABLE&lt;/code&gt;: The instance is running, or is ready
              # to run when accessed. &lt;br&gt;&lt;code&gt;SUSPENDED&lt;/code&gt;: The instance is not
              # available, for example due to problems with billing.
              # &lt;br&gt;&lt;code&gt;PENDING_CREATE&lt;/code&gt;: The instance is being created.
              # &lt;br&gt;&lt;code&gt;MAINTENANCE&lt;/code&gt;: The instance is down for maintenance.
              # &lt;br&gt;&lt;code&gt;FAILED&lt;/code&gt;: The instance creation failed.
              # &lt;br&gt;&lt;code&gt;UNKNOWN_STATE&lt;/code&gt;: The state of the instance is unknown.
          &quot;backendType&quot;: &quot;A String&quot;, # &lt;code&gt;FIRST_GEN&lt;/code&gt;: First Generation instance. MySQL only. &lt;br
              # /&gt;&lt;code&gt;SECOND_GEN&lt;/code&gt;: Second Generation instance or PostgreSQL
              # instance. &lt;br /&gt;&lt;code&gt;EXTERNAL&lt;/code&gt;: A database server that is not
              # managed by Google. &lt;br&gt;This property is read-only; use the
              # &lt;code&gt;tier&lt;/code&gt; property in the &lt;code&gt;settings&lt;/code&gt; object to determine
              # the database type and Second or First Generation.
          &quot;onPremisesConfiguration&quot;: { # On-premises instance configuration. # Configuration specific to on-premises instances.
            &quot;dumpFilePath&quot;: &quot;A String&quot;, # The dump file to create the Cloud SQL replica.
            &quot;hostPort&quot;: &quot;A String&quot;, # The host and port of the on-premises instance in host:port format
            &quot;clientCertificate&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s x509 certificate.
            &quot;username&quot;: &quot;A String&quot;, # The username for connecting to on-premises instance.
            &quot;caCertificate&quot;: &quot;A String&quot;, # PEM representation of the trusted CA&#x27;s x509 certificate.
            &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#onPremisesConfiguration&lt;/code&gt;.
            &quot;password&quot;: &quot;A String&quot;, # The password for connecting to on-premises instance.
            &quot;clientKey&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s private key. The corresponsing public key
                # is encoded in the client&#x27;s certificate.
          },
          &quot;project&quot;: &quot;A String&quot;, # The project ID of the project containing the Cloud SQL instance. The Google
              # apps domain is prefixed if applicable.
          &quot;serviceAccountEmailAddress&quot;: &quot;A String&quot;, # The service account email address assigned to the instance. This property
              # is applicable only to Second Generation instances.
        },
    ],
    &quot;warnings&quot;: [ # List of warnings that occurred while handling the request.
      { # An Admin API warning message.
        &quot;code&quot;: &quot;A String&quot;, # Code to uniquely identify the warning type.
        &quot;message&quot;: &quot;A String&quot;, # The warning message.
      },
    ],
    &quot;nextPageToken&quot;: &quot;A String&quot;, # The continuation token, used to page through large result sets. Provide
        # this value in a subsequent request to return the next page of results.
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#instancesList&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="listServerCas">listServerCas(project, instance, x__xgafv=None)</code>
  <pre>Lists all of the trusted Certificate Authorities (CAs) for the specified
instance. There can be up to three CAs listed: the CA that was used to sign
the certificate that is currently in use, a CA that has been added but not
yet used to sign a certificate, and a CA used to sign a certificate that
has previously rotated out.

Args:
  project: string, Project ID of the project that contains the instance. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Instances ListServerCas response.
    &quot;activeVersion&quot;: &quot;A String&quot;,
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#instancesListServerCas&lt;/code&gt;.
    &quot;certs&quot;: [ # List of server CA certificates for the instance.
      { # SslCerts Resource
        &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
        &quot;expirationTime&quot;: &quot;A String&quot;, # The time when the certificate expires in &lt;a
            # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
            # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
        &quot;sha1Fingerprint&quot;: &quot;A String&quot;, # Sha1 Fingerprint.
        &quot;certSerialNumber&quot;: &quot;A String&quot;, # Serial number, as extracted from the certificate.
        &quot;cert&quot;: &quot;A String&quot;, # PEM representation.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#sslCert&lt;/code&gt;.
        &quot;commonName&quot;: &quot;A String&quot;, # User supplied name.  Constrained to [a-zA-Z.-_ ]+.
        &quot;createTime&quot;: &quot;A String&quot;, # The time when the certificate was created in &lt;a
            # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
            # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;
        &quot;instance&quot;: &quot;A String&quot;, # Name of the database instance.
      },
    ],
  }</pre>
</div>

<div class="method">
    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
  <pre>Retrieves the next page of results.

Args:
  previous_request: The request for the previous page. (required)
  previous_response: The response from the request for the previous page. (required)

Returns:
  A request object that you can call &#x27;execute()&#x27; on to request the next
  page. Returns None if there are no more items in the collection.
    </pre>
</div>

<div class="method">
    <code class="details" id="patch">patch(project, instance, body=None, x__xgafv=None)</code>
  <pre>Updates settings of a Cloud SQL instance.
This method supports patch semantics.

Args:
  project: string, Project ID of the project that contains the instance. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  body: object, The request body.
    The object takes the form of:

{ # A Cloud SQL instance resource.
    &quot;databaseVersion&quot;: &quot;A String&quot;, # The database engine type and version. The &lt;code&gt;databaseVersion&lt;/code&gt;
        # field can not be changed after instance creation.  MySQL Second Generation
        # instances: &lt;code&gt;MYSQL_5_7&lt;/code&gt; (default) or &lt;code&gt;MYSQL_5_6&lt;/code&gt;.
        # PostgreSQL instances: &lt;code&gt;POSTGRES_9_6&lt;/code&gt; (default) or
        # &lt;code&gt;POSTGRES_11 Beta&lt;/code&gt; MySQL First Generation
        # instances: &lt;code&gt;MYSQL_5_6&lt;/code&gt; (default) or &lt;code&gt;MYSQL_5_5&lt;/code&gt;
    &quot;suspensionReason&quot;: [ # If the instance state is SUSPENDED, the reason for the suspension.
      &quot;A String&quot;,
    ],
    &quot;settings&quot;: { # Database instance settings. # The user settings.
      &quot;backupConfiguration&quot;: { # Database instance backup configuration. # The daily backup configuration for the instance.
        &quot;binaryLogEnabled&quot;: True or False, # (MySQL only) Whether binary log is enabled. If backup configuration is
            # disabled, binarylog must be disabled as well.
        &quot;replicationLogArchivingEnabled&quot;: True or False, # Reserved for future use.
        &quot;location&quot;: &quot;A String&quot;, # Location of the backup
        &quot;pointInTimeRecoveryEnabled&quot;: True or False, # Reserved for future use.
        &quot;startTime&quot;: &quot;A String&quot;, # Start time for the daily backup configuration in UTC timezone in the 24
            # hour format - &lt;code&gt;HH:MM&lt;/code&gt;.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#backupConfiguration&lt;/code&gt;.
        &quot;enabled&quot;: True or False, # Whether this configuration is enabled.
      },
      &quot;userLabels&quot;: { # User-provided labels, represented as a dictionary where each label is a
          # single key value pair.
        &quot;a_key&quot;: &quot;A String&quot;,
      },
      &quot;locationPreference&quot;: { # Preferred location. This specifies where a Cloud SQL instance should # The location preference settings. This allows the instance to be located as
          # near as possible to either an App Engine app or Compute Engine zone for
          # better performance. App Engine co-location is only applicable to First
          # Generation instances.
          # preferably be located, either in a specific Compute Engine zone, or
          # co-located with an App Engine application. Note that if the preferred
          # location is not available, the instance will be located as close as possible
          # within the region. Only one location may be specified.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#locationPreference&lt;/code&gt;.
        &quot;zone&quot;: &quot;A String&quot;, # The preferred Compute Engine zone (e.g. us-central1-a, us-central1-b,
            # etc.).
        &quot;followGaeApplication&quot;: &quot;A String&quot;, # The AppEngine application to follow, it must be in the same region as the
            # Cloud SQL instance.
      },
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#settings&lt;/code&gt;.
      &quot;replicationType&quot;: &quot;A String&quot;, # The type of replication this instance uses. This can be either
          # &lt;code&gt;ASYNCHRONOUS&lt;/code&gt; or &lt;code&gt;SYNCHRONOUS&lt;/code&gt;. This property is
          # only applicable to First Generation instances.
      &quot;activationPolicy&quot;: &quot;A String&quot;, # The activation policy specifies when the instance is activated; it is
          # applicable only when the instance state is &lt;code&gt;RUNNABLE&lt;/code&gt;. Valid
          # values: &lt;br&gt;&lt;code&gt;ALWAYS&lt;/code&gt;: The instance is on, and remains so even in
          # the absence of connection requests. &lt;br&gt;&lt;code&gt;NEVER&lt;/code&gt;: The instance is
          # off; it is not activated, even if a connection request arrives.
          # &lt;br&gt;&lt;code&gt;ON_DEMAND&lt;/code&gt;: First Generation instances only. The instance
          # responds to incoming requests, and turns itself off when not in use.
          # Instances with &lt;code&gt;PER_USE&lt;/code&gt; pricing turn off after 15 minutes of
          # inactivity. Instances with &lt;code&gt;PER_PACKAGE&lt;/code&gt; pricing turn off after
          # 12 hours of inactivity.
      &quot;ipConfiguration&quot;: { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the
          # instance IP and manage which external networks can connect to the instance.
          # The IPv4 address cannot be disabled for Second Generation instances.
        &quot;authorizedNetworks&quot;: [ # The list of external networks that are allowed to connect to the instance
            # using the IP. In &lt;a
            # href=&quot;http://en.wikipedia.org/wiki/CIDR_notation#CIDR_notation&quot;&gt;CIDR
            # notation&lt;/a&gt;, also known as &#x27;slash&#x27; notation (e.g.
            # &lt;code&gt;192.168.100.0/24&lt;/code&gt;).
          { # An entry for an Access Control list.
            &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#aclEntry&lt;/code&gt;.
            &quot;value&quot;: &quot;A String&quot;, # The whitelisted value for the access control list.
            &quot;expirationTime&quot;: &quot;A String&quot;, # The time when this access control entry expires in &lt;a
                # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
                # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
            &quot;name&quot;: &quot;A String&quot;, # Optional. A label to identify this entry.
          },
        ],
        &quot;requireSsl&quot;: True or False, # Whether SSL connections over IP should be enforced or not.
        &quot;privateNetwork&quot;: &quot;A String&quot;, # The resource link for the VPC network from which the Cloud SQL instance is
            # accessible for private IP. For example,
            # &lt;code&gt;/projects/myProject/global/networks/default&lt;/code&gt;. This setting can
            # be updated, but it cannot be removed after it is set.
        &quot;ipv4Enabled&quot;: True or False, # Whether the instance should be assigned an IP address or not.
      },
      &quot;availabilityType&quot;: &quot;A String&quot;, # Availability type (PostgreSQL and MySQL instances only). Potential values:
          # &lt;br&gt;&lt;code&gt;ZONAL&lt;/code&gt;: The instance serves data from only one zone.
          # Outages in that zone affect data accessibility. &lt;br&gt;&lt;code&gt;REGIONAL&lt;/code&gt;:
          # The instance can serve data from more than one zone in a region (it is
          # highly available). &lt;br&gt;For more information, see &lt;a
          # href=&quot;https://cloud.google.com/sql/docs/postgres/high-availability&quot;&gt;Overview
          # of the High Availability Configuration&lt;/a&gt;.
      &quot;settingsVersion&quot;: &quot;A String&quot;, # The version of instance settings. This is a required field for update
          # method to make sure concurrent updates are handled properly. During update,
          # use the most recent settingsVersion value for this instance and do not try
          # to update this value.
      &quot;databaseFlags&quot;: [ # The database flags passed to the instance at startup.
        { # Database flags for Cloud SQL instances.
          &quot;name&quot;: &quot;A String&quot;, # The name of the flag. These flags are passed at instance startup, so
              # include both server options and system variables for MySQL. Flags should be
              # specified with underscores, not hyphens. For more information, see &lt;a
              # href=&quot;/sql/docs/mysql/flags&quot;&gt;Configuring Database Flags&lt;/a&gt; in the Cloud
              # SQL documentation.
          &quot;value&quot;: &quot;A String&quot;, # The value of the flag. Booleans should be set to &lt;code&gt;on&lt;/code&gt; for true
              # and &lt;code&gt;off&lt;/code&gt; for false. This field must be omitted if the flag
              # doesn&#x27;t take a value.
        },
      ],
      &quot;maintenanceWindow&quot;: { # Maintenance window. This specifies when a v2 Cloud SQL instance should # The maintenance window for this instance. This specifies when the instance
          # can be restarted for maintenance purposes. Not used for First Generation
          # instances.
          # preferably be restarted for system maintenance purposes.
        &quot;hour&quot;: 42, # hour of day - 0 to 23.
        &quot;day&quot;: 42, # day of week (1-7), starting on Monday.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#maintenanceWindow&lt;/code&gt;.
        &quot;updateTrack&quot;: &quot;A String&quot;, # Maintenance timing setting: &lt;code&gt;canary&lt;/code&gt; (Earlier) or
            # &lt;code&gt;stable&lt;/code&gt; (Later). &lt;br /&gt;&lt;a
            # href=&quot;/sql/docs/db_path/instance-settings#maintenance-timing-2ndgen&quot;&gt;
            # Learn more&lt;/a&gt;.
      },
      &quot;pricingPlan&quot;: &quot;A String&quot;, # The pricing plan for this instance. This can be either &lt;code&gt;PER_USE&lt;/code&gt;
          # or &lt;code&gt;PACKAGE&lt;/code&gt;. Only &lt;code&gt;PER_USE&lt;/code&gt; is supported for Second
          # Generation instances.
      &quot;storageAutoResize&quot;: True or False, # Configuration to increase storage size automatically. The default value is
          # true. Not used for First Generation instances.
      &quot;storageAutoResizeLimit&quot;: &quot;A String&quot;, # The maximum size to which storage capacity can be automatically increased.
          # The default value is 0, which specifies that there is no limit. Not used
          # for First Generation instances.
      &quot;authorizedGaeApplications&quot;: [ # The App Engine app IDs that can access this instance. First Generation
          # instances only.
        &quot;A String&quot;,
      ],
      &quot;tier&quot;: &quot;A String&quot;, # The tier (or machine type) for this instance, for example
          # &lt;code&gt;db-n1-standard-1&lt;/code&gt; (MySQL instances) or
          # &lt;code&gt;db-custom-1-3840&lt;/code&gt; (PostgreSQL instances). For MySQL instances,
          # this property determines whether the instance is First or Second
          # Generation. For more information, see &lt;a
          # href=&quot;/sql/docs/db_path/instance-settings&quot;&gt;Instance Settings&lt;/a&gt;.
      &quot;dataDiskSizeGb&quot;: &quot;A String&quot;, # The size of data disk, in GB. The data disk size minimum is 10GB. Not used
          # for First Generation instances.
      &quot;dataDiskType&quot;: &quot;A String&quot;, # The type of data disk: &lt;code&gt;PD_SSD&lt;/code&gt; (default) or
          # &lt;code&gt;PD_HDD&lt;/code&gt;. Not used for First Generation instances.
      &quot;databaseReplicationEnabled&quot;: True or False, # Configuration specific to read replica instances. Indicates whether
          # replication is enabled or not.
      &quot;crashSafeReplicationEnabled&quot;: True or False, # Configuration specific to read replica instances. Indicates whether
          # database flags for crash-safe replication are enabled. This property is
          # only applicable to First Generation instances.
    },
    &quot;replicaNames&quot;: [ # The replicas of the instance.
      &quot;A String&quot;,
    ],
    &quot;diskEncryptionConfiguration&quot;: { # Disk encryption configuration for an instance. # Disk encryption configuration specific to an instance.
        # Applies only to Second Generation instances.
      &quot;kmsKeyName&quot;: &quot;A String&quot;, # Resource name of KMS key for disk encryption
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#diskEncryptionConfiguration&lt;/code&gt;.
    },
    &quot;scheduledMaintenance&quot;: { # Any scheduled maintenancce for this instance. # The start time of any upcoming scheduled maintenance for this instance.
      &quot;canReschedule&quot;: True or False, # If the scheduled maintenance can be rescheduled.
      &quot;canDefer&quot;: True or False,
      &quot;startTime&quot;: &quot;A String&quot;, # The start time of any upcoming scheduled maintenance for this instance.
    },
    &quot;rootPassword&quot;: &quot;A String&quot;, # Initial root password. Use only on creation.
    &quot;etag&quot;: &quot;A String&quot;, # This field is deprecated and will be removed from a future version of the
        # API. Use the &lt;code&gt;settings.settingsVersion&lt;/code&gt; field instead.
    &quot;serverCaCert&quot;: { # SslCerts Resource # SSL configuration.
      &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
      &quot;expirationTime&quot;: &quot;A String&quot;, # The time when the certificate expires in &lt;a
          # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
          # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
      &quot;sha1Fingerprint&quot;: &quot;A String&quot;, # Sha1 Fingerprint.
      &quot;certSerialNumber&quot;: &quot;A String&quot;, # Serial number, as extracted from the certificate.
      &quot;cert&quot;: &quot;A String&quot;, # PEM representation.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#sslCert&lt;/code&gt;.
      &quot;commonName&quot;: &quot;A String&quot;, # User supplied name.  Constrained to [a-zA-Z.-_ ]+.
      &quot;createTime&quot;: &quot;A String&quot;, # The time when the certificate was created in &lt;a
          # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
          # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;
      &quot;instance&quot;: &quot;A String&quot;, # Name of the database instance.
    },
    &quot;maxDiskSize&quot;: &quot;A String&quot;, # The maximum disk size of the instance in bytes.
    &quot;name&quot;: &quot;A String&quot;, # Name of the Cloud SQL instance. This does not include the project ID.
    &quot;masterInstanceName&quot;: &quot;A String&quot;, # The name of the instance which will act as master in the replication setup.
    &quot;instanceType&quot;: &quot;A String&quot;, # The instance type. This can be one of the following.
        # &lt;br&gt;&lt;code&gt;CLOUD_SQL_INSTANCE&lt;/code&gt;: A Cloud SQL instance that is not
        # replicating from a master. &lt;br&gt;&lt;code&gt;ON_PREMISES_INSTANCE&lt;/code&gt;: An
        # instance running on the
        # customer&#x27;s premises. &lt;br&gt;&lt;code&gt;READ_REPLICA_INSTANCE&lt;/code&gt;: A Cloud SQL
        # instance configured as a read-replica.
    &quot;gceZone&quot;: &quot;A String&quot;, # The Compute Engine zone that the instance is currently serving from. This
        # value could be different from the zone that was specified when the instance
        # was created if the instance has failed over to its secondary zone.
    &quot;currentDiskSize&quot;: &quot;A String&quot;, # The current disk usage of the instance in bytes. This property has been
        # deprecated. Users should use the
        # &quot;cloudsql.googleapis.com/database/disk/bytes_used&quot; metric in Cloud
        # Monitoring API instead. Please see &lt;a
        # href=&quot;https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ&quot;&gt;this
        # announcement&lt;/a&gt; for details.
    &quot;replicaConfiguration&quot;: { # Read-replica configuration for connecting to the master. # Configuration specific to failover replicas and read replicas.
      &quot;mysqlReplicaConfiguration&quot;: { # Read-replica configuration specific to MySQL databases. # MySQL specific configuration when replicating from a MySQL on-premises
          # master. Replication configuration information such as the username,
          # password, certificates, and keys are not stored in the instance metadata.
          # The configuration information is used only to set up the replication
          # connection and is stored by MySQL in a file named &lt;code&gt;master.info&lt;/code&gt;
          # in the data directory.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#mysqlReplicaConfiguration&lt;/code&gt;.
        &quot;password&quot;: &quot;A String&quot;, # The password for the replication connection.
        &quot;verifyServerCertificate&quot;: True or False, # Whether or not to check the master&#x27;s Common Name value in the certificate
            # that it sends during the SSL handshake.
        &quot;clientKey&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s private key. The corresponsing public key
            # is encoded in the client&#x27;s certificate.
        &quot;sslCipher&quot;: &quot;A String&quot;, # A list of permissible ciphers to use for SSL encryption.
        &quot;masterHeartbeatPeriod&quot;: &quot;A String&quot;, # Interval in milliseconds between replication heartbeats.
        &quot;connectRetryInterval&quot;: 42, # Seconds to wait between connect retries. MySQL&#x27;s default is 60 seconds.
        &quot;dumpFilePath&quot;: &quot;A String&quot;, # Path to a SQL dump file in Google Cloud Storage from which the slave
            # instance is to be created. The URI is in the form gs:
            # //bucketName/fileName. Compressed gzip files (.gz) are also supported.
            # // Dumps should have the binlog co-ordinates from which replication should
            # // begin. This can be accomplished by setting --master-data to 1 when using
            # // mysqldump.
        &quot;clientCertificate&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s x509 certificate.
        &quot;username&quot;: &quot;A String&quot;, # The username for the replication connection.
        &quot;caCertificate&quot;: &quot;A String&quot;, # PEM representation of the trusted CA&#x27;s x509 certificate.
      },
      &quot;failoverTarget&quot;: True or False, # Specifies if the replica is the failover target. If the field is set to
          # &lt;code&gt;true&lt;/code&gt; the replica will be designated as a failover replica. In
          # case the master instance fails, the replica instance will be promoted as
          # the new master instance.  &lt;p&gt;Only one replica can be specified as failover
          # target, and the replica has to be in different zone with the master
          # instance.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#replicaConfiguration&lt;/code&gt;.
    },
    &quot;connectionName&quot;: &quot;A String&quot;, # Connection name of the Cloud SQL instance used in connection strings.
    &quot;failoverReplica&quot;: { # The name and status of the failover replica. This property is applicable
        # only to Second Generation instances.
      &quot;name&quot;: &quot;A String&quot;, # The name of the failover replica. If specified at instance creation, a
          # failover replica is created for the instance. The name
          # doesn&#x27;t include the project ID. This property is applicable only to
          # Second Generation instances.
      &quot;available&quot;: True or False, # The availability status of the failover replica. A false status indicates
          # that the failover replica is out of sync. The master can only failover to
          # the failover replica when the status is true.
    },
    &quot;ipAddresses&quot;: [ # The assigned IP addresses for the instance.
      { # Database instance IP Mapping.
        &quot;type&quot;: &quot;A String&quot;, # The type of this IP address. A &lt;code&gt;PRIMARY&lt;/code&gt; address is a public
            # address that can accept incoming connections. A &lt;code&gt;PRIVATE&lt;/code&gt;
            # address is a private address that can accept incoming connections. An
            # &lt;code&gt;OUTGOING&lt;/code&gt; address is the source address of connections
            # originating from the instance, if supported.
        &quot;ipAddress&quot;: &quot;A String&quot;, # The IP address assigned.
        &quot;timeToRetire&quot;: &quot;A String&quot;, # The due time for this IP to be retired in &lt;a
            # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
            # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;. This field is only available when
            # the IP is scheduled to be retired.
      },
    ],
    &quot;ipv6Address&quot;: &quot;A String&quot;, # The IPv6 address assigned to the instance. This property is applicable only
        # to First Generation instances.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;diskEncryptionStatus&quot;: { # Disk encryption status for an instance. # Disk encryption status specific to an instance.
        # Applies only to Second Generation instances.
      &quot;kmsKeyVersionName&quot;: &quot;A String&quot;, # KMS key version used to encrypt the Cloud SQL instance resource
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#diskEncryptionStatus&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#instance&lt;/code&gt;.
    &quot;region&quot;: &quot;A String&quot;, # The geographical region. Can be &lt;code&gt;us-central&lt;/code&gt;
        # (&lt;code&gt;FIRST_GEN&lt;/code&gt; instances only), &lt;code&gt;us-central1&lt;/code&gt;
        # (&lt;code&gt;SECOND_GEN&lt;/code&gt; instances only), &lt;code&gt;asia-east1&lt;/code&gt; or
        # &lt;code&gt;europe-west1&lt;/code&gt;. Defaults to &lt;code&gt;us-central&lt;/code&gt; or
        # &lt;code&gt;us-central1&lt;/code&gt; depending on the instance type (First Generation
        # or Second Generation). The region can not be changed after instance
        # creation.
    &quot;state&quot;: &quot;A String&quot;, # The current serving state of the Cloud SQL instance. This can be one of the
        # following. &lt;br&gt;&lt;code&gt;RUNNABLE&lt;/code&gt;: The instance is running, or is ready
        # to run when accessed. &lt;br&gt;&lt;code&gt;SUSPENDED&lt;/code&gt;: The instance is not
        # available, for example due to problems with billing.
        # &lt;br&gt;&lt;code&gt;PENDING_CREATE&lt;/code&gt;: The instance is being created.
        # &lt;br&gt;&lt;code&gt;MAINTENANCE&lt;/code&gt;: The instance is down for maintenance.
        # &lt;br&gt;&lt;code&gt;FAILED&lt;/code&gt;: The instance creation failed.
        # &lt;br&gt;&lt;code&gt;UNKNOWN_STATE&lt;/code&gt;: The state of the instance is unknown.
    &quot;backendType&quot;: &quot;A String&quot;, # &lt;code&gt;FIRST_GEN&lt;/code&gt;: First Generation instance. MySQL only. &lt;br
        # /&gt;&lt;code&gt;SECOND_GEN&lt;/code&gt;: Second Generation instance or PostgreSQL
        # instance. &lt;br /&gt;&lt;code&gt;EXTERNAL&lt;/code&gt;: A database server that is not
        # managed by Google. &lt;br&gt;This property is read-only; use the
        # &lt;code&gt;tier&lt;/code&gt; property in the &lt;code&gt;settings&lt;/code&gt; object to determine
        # the database type and Second or First Generation.
    &quot;onPremisesConfiguration&quot;: { # On-premises instance configuration. # Configuration specific to on-premises instances.
      &quot;dumpFilePath&quot;: &quot;A String&quot;, # The dump file to create the Cloud SQL replica.
      &quot;hostPort&quot;: &quot;A String&quot;, # The host and port of the on-premises instance in host:port format
      &quot;clientCertificate&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s x509 certificate.
      &quot;username&quot;: &quot;A String&quot;, # The username for connecting to on-premises instance.
      &quot;caCertificate&quot;: &quot;A String&quot;, # PEM representation of the trusted CA&#x27;s x509 certificate.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#onPremisesConfiguration&lt;/code&gt;.
      &quot;password&quot;: &quot;A String&quot;, # The password for connecting to on-premises instance.
      &quot;clientKey&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s private key. The corresponsing public key
          # is encoded in the client&#x27;s certificate.
    },
    &quot;project&quot;: &quot;A String&quot;, # The project ID of the project containing the Cloud SQL instance. The Google
        # apps domain is prefixed if applicable.
    &quot;serviceAccountEmailAddress&quot;: &quot;A String&quot;, # The service account email address assigned to the instance. This property
        # is applicable only to Second Generation instances.
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="promoteReplica">promoteReplica(project, instance, x__xgafv=None)</code>
  <pre>Promotes the read replica instance to be a stand-alone Cloud SQL instance.
Using this operation might cause your instance to restart.

Args:
  project: string, ID of the project that contains the read replica. (required)
  instance: string, Cloud SQL read replica instance name. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="resetSslConfig">resetSslConfig(project, instance, x__xgafv=None)</code>
  <pre>Deletes all client certificates and generates a new server SSL certificate
for the instance.

Args:
  project: string, Project ID of the project that contains the instance. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="restart">restart(project, instance, x__xgafv=None)</code>
  <pre>Restarts a Cloud SQL instance.

Args:
  project: string, Project ID of the project that contains the instance to be restarted. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="restoreBackup">restoreBackup(project, instance, body=None, x__xgafv=None)</code>
  <pre>Restores a backup of a Cloud SQL instance. Using this operation might cause
your instance to restart.

Args:
  project: string, Project ID of the project that contains the instance. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  body: object, The request body.
    The object takes the form of:

{ # Database instance restore backup request.
    &quot;restoreBackupContext&quot;: { # Database instance restore from backup context. # Parameters required to perform the restore backup operation.
        # Backup context contains source instance id and project id.
      &quot;instanceId&quot;: &quot;A String&quot;, # The ID of the instance that the backup was taken from.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#restoreBackupContext&lt;/code&gt;.
      &quot;project&quot;: &quot;A String&quot;, # The full project ID of the source instance.
      &quot;backupRunId&quot;: &quot;A String&quot;, # The ID of the backup run to restore from.
    },
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="rotateServerCa">rotateServerCa(project, instance, body=None, x__xgafv=None)</code>
  <pre>Rotates the server certificate to one signed by the Certificate Authority
(CA) version previously added with the addServerCA method.

Args:
  project: string, Project ID of the project that contains the instance. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  body: object, The request body.
    The object takes the form of:

{ # Rotate Server CA request.
    &quot;rotateServerCaContext&quot;: { # Instance rotate server CA context. # Contains details about the rotate server CA operation.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#rotateServerCaContext&lt;/code&gt;.
      &quot;nextVersion&quot;: &quot;A String&quot;, # The fingerprint of the next version to be rotated to. If left unspecified,
          # will be rotated to the most recently added server CA version.
    },
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="startReplica">startReplica(project, instance, x__xgafv=None)</code>
  <pre>Starts the replication in the read replica instance.

Args:
  project: string, ID of the project that contains the read replica. (required)
  instance: string, Cloud SQL read replica instance name. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="stopReplica">stopReplica(project, instance, x__xgafv=None)</code>
  <pre>Stops the replication in the read replica instance.

Args:
  project: string, ID of the project that contains the read replica. (required)
  instance: string, Cloud SQL read replica instance name. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="truncateLog">truncateLog(project, instance, body=None, x__xgafv=None)</code>
  <pre>Truncate MySQL general and slow query log tables

Args:
  project: string, Project ID of the Cloud SQL project. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  body: object, The request body.
    The object takes the form of:

{ # Instance truncate log request.
    &quot;truncateLogContext&quot;: { # Database Instance truncate log context. # Contains details about the truncate log operation.
      &quot;logType&quot;: &quot;A String&quot;, # The type of log to truncate. Valid values are
          # &lt;code&gt;MYSQL_GENERAL_TABLE&lt;/code&gt; and &lt;code&gt;MYSQL_SLOW_TABLE&lt;/code&gt;.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#truncateLogContext&lt;/code&gt;.
    },
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

<div class="method">
    <code class="details" id="update">update(project, instance, body=None, x__xgafv=None)</code>
  <pre>Updates settings of a Cloud SQL instance. Using this operation might cause
your instance to restart.

Args:
  project: string, Project ID of the project that contains the instance. (required)
  instance: string, Cloud SQL instance ID. This does not include the project ID. (required)
  body: object, The request body.
    The object takes the form of:

{ # A Cloud SQL instance resource.
    &quot;databaseVersion&quot;: &quot;A String&quot;, # The database engine type and version. The &lt;code&gt;databaseVersion&lt;/code&gt;
        # field can not be changed after instance creation.  MySQL Second Generation
        # instances: &lt;code&gt;MYSQL_5_7&lt;/code&gt; (default) or &lt;code&gt;MYSQL_5_6&lt;/code&gt;.
        # PostgreSQL instances: &lt;code&gt;POSTGRES_9_6&lt;/code&gt; (default) or
        # &lt;code&gt;POSTGRES_11 Beta&lt;/code&gt; MySQL First Generation
        # instances: &lt;code&gt;MYSQL_5_6&lt;/code&gt; (default) or &lt;code&gt;MYSQL_5_5&lt;/code&gt;
    &quot;suspensionReason&quot;: [ # If the instance state is SUSPENDED, the reason for the suspension.
      &quot;A String&quot;,
    ],
    &quot;settings&quot;: { # Database instance settings. # The user settings.
      &quot;backupConfiguration&quot;: { # Database instance backup configuration. # The daily backup configuration for the instance.
        &quot;binaryLogEnabled&quot;: True or False, # (MySQL only) Whether binary log is enabled. If backup configuration is
            # disabled, binarylog must be disabled as well.
        &quot;replicationLogArchivingEnabled&quot;: True or False, # Reserved for future use.
        &quot;location&quot;: &quot;A String&quot;, # Location of the backup
        &quot;pointInTimeRecoveryEnabled&quot;: True or False, # Reserved for future use.
        &quot;startTime&quot;: &quot;A String&quot;, # Start time for the daily backup configuration in UTC timezone in the 24
            # hour format - &lt;code&gt;HH:MM&lt;/code&gt;.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#backupConfiguration&lt;/code&gt;.
        &quot;enabled&quot;: True or False, # Whether this configuration is enabled.
      },
      &quot;userLabels&quot;: { # User-provided labels, represented as a dictionary where each label is a
          # single key value pair.
        &quot;a_key&quot;: &quot;A String&quot;,
      },
      &quot;locationPreference&quot;: { # Preferred location. This specifies where a Cloud SQL instance should # The location preference settings. This allows the instance to be located as
          # near as possible to either an App Engine app or Compute Engine zone for
          # better performance. App Engine co-location is only applicable to First
          # Generation instances.
          # preferably be located, either in a specific Compute Engine zone, or
          # co-located with an App Engine application. Note that if the preferred
          # location is not available, the instance will be located as close as possible
          # within the region. Only one location may be specified.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#locationPreference&lt;/code&gt;.
        &quot;zone&quot;: &quot;A String&quot;, # The preferred Compute Engine zone (e.g. us-central1-a, us-central1-b,
            # etc.).
        &quot;followGaeApplication&quot;: &quot;A String&quot;, # The AppEngine application to follow, it must be in the same region as the
            # Cloud SQL instance.
      },
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#settings&lt;/code&gt;.
      &quot;replicationType&quot;: &quot;A String&quot;, # The type of replication this instance uses. This can be either
          # &lt;code&gt;ASYNCHRONOUS&lt;/code&gt; or &lt;code&gt;SYNCHRONOUS&lt;/code&gt;. This property is
          # only applicable to First Generation instances.
      &quot;activationPolicy&quot;: &quot;A String&quot;, # The activation policy specifies when the instance is activated; it is
          # applicable only when the instance state is &lt;code&gt;RUNNABLE&lt;/code&gt;. Valid
          # values: &lt;br&gt;&lt;code&gt;ALWAYS&lt;/code&gt;: The instance is on, and remains so even in
          # the absence of connection requests. &lt;br&gt;&lt;code&gt;NEVER&lt;/code&gt;: The instance is
          # off; it is not activated, even if a connection request arrives.
          # &lt;br&gt;&lt;code&gt;ON_DEMAND&lt;/code&gt;: First Generation instances only. The instance
          # responds to incoming requests, and turns itself off when not in use.
          # Instances with &lt;code&gt;PER_USE&lt;/code&gt; pricing turn off after 15 minutes of
          # inactivity. Instances with &lt;code&gt;PER_PACKAGE&lt;/code&gt; pricing turn off after
          # 12 hours of inactivity.
      &quot;ipConfiguration&quot;: { # IP Management configuration. # The settings for IP Management. This allows to enable or disable the
          # instance IP and manage which external networks can connect to the instance.
          # The IPv4 address cannot be disabled for Second Generation instances.
        &quot;authorizedNetworks&quot;: [ # The list of external networks that are allowed to connect to the instance
            # using the IP. In &lt;a
            # href=&quot;http://en.wikipedia.org/wiki/CIDR_notation#CIDR_notation&quot;&gt;CIDR
            # notation&lt;/a&gt;, also known as &#x27;slash&#x27; notation (e.g.
            # &lt;code&gt;192.168.100.0/24&lt;/code&gt;).
          { # An entry for an Access Control list.
            &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#aclEntry&lt;/code&gt;.
            &quot;value&quot;: &quot;A String&quot;, # The whitelisted value for the access control list.
            &quot;expirationTime&quot;: &quot;A String&quot;, # The time when this access control entry expires in &lt;a
                # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
                # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
            &quot;name&quot;: &quot;A String&quot;, # Optional. A label to identify this entry.
          },
        ],
        &quot;requireSsl&quot;: True or False, # Whether SSL connections over IP should be enforced or not.
        &quot;privateNetwork&quot;: &quot;A String&quot;, # The resource link for the VPC network from which the Cloud SQL instance is
            # accessible for private IP. For example,
            # &lt;code&gt;/projects/myProject/global/networks/default&lt;/code&gt;. This setting can
            # be updated, but it cannot be removed after it is set.
        &quot;ipv4Enabled&quot;: True or False, # Whether the instance should be assigned an IP address or not.
      },
      &quot;availabilityType&quot;: &quot;A String&quot;, # Availability type (PostgreSQL and MySQL instances only). Potential values:
          # &lt;br&gt;&lt;code&gt;ZONAL&lt;/code&gt;: The instance serves data from only one zone.
          # Outages in that zone affect data accessibility. &lt;br&gt;&lt;code&gt;REGIONAL&lt;/code&gt;:
          # The instance can serve data from more than one zone in a region (it is
          # highly available). &lt;br&gt;For more information, see &lt;a
          # href=&quot;https://cloud.google.com/sql/docs/postgres/high-availability&quot;&gt;Overview
          # of the High Availability Configuration&lt;/a&gt;.
      &quot;settingsVersion&quot;: &quot;A String&quot;, # The version of instance settings. This is a required field for update
          # method to make sure concurrent updates are handled properly. During update,
          # use the most recent settingsVersion value for this instance and do not try
          # to update this value.
      &quot;databaseFlags&quot;: [ # The database flags passed to the instance at startup.
        { # Database flags for Cloud SQL instances.
          &quot;name&quot;: &quot;A String&quot;, # The name of the flag. These flags are passed at instance startup, so
              # include both server options and system variables for MySQL. Flags should be
              # specified with underscores, not hyphens. For more information, see &lt;a
              # href=&quot;/sql/docs/mysql/flags&quot;&gt;Configuring Database Flags&lt;/a&gt; in the Cloud
              # SQL documentation.
          &quot;value&quot;: &quot;A String&quot;, # The value of the flag. Booleans should be set to &lt;code&gt;on&lt;/code&gt; for true
              # and &lt;code&gt;off&lt;/code&gt; for false. This field must be omitted if the flag
              # doesn&#x27;t take a value.
        },
      ],
      &quot;maintenanceWindow&quot;: { # Maintenance window. This specifies when a v2 Cloud SQL instance should # The maintenance window for this instance. This specifies when the instance
          # can be restarted for maintenance purposes. Not used for First Generation
          # instances.
          # preferably be restarted for system maintenance purposes.
        &quot;hour&quot;: 42, # hour of day - 0 to 23.
        &quot;day&quot;: 42, # day of week (1-7), starting on Monday.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#maintenanceWindow&lt;/code&gt;.
        &quot;updateTrack&quot;: &quot;A String&quot;, # Maintenance timing setting: &lt;code&gt;canary&lt;/code&gt; (Earlier) or
            # &lt;code&gt;stable&lt;/code&gt; (Later). &lt;br /&gt;&lt;a
            # href=&quot;/sql/docs/db_path/instance-settings#maintenance-timing-2ndgen&quot;&gt;
            # Learn more&lt;/a&gt;.
      },
      &quot;pricingPlan&quot;: &quot;A String&quot;, # The pricing plan for this instance. This can be either &lt;code&gt;PER_USE&lt;/code&gt;
          # or &lt;code&gt;PACKAGE&lt;/code&gt;. Only &lt;code&gt;PER_USE&lt;/code&gt; is supported for Second
          # Generation instances.
      &quot;storageAutoResize&quot;: True or False, # Configuration to increase storage size automatically. The default value is
          # true. Not used for First Generation instances.
      &quot;storageAutoResizeLimit&quot;: &quot;A String&quot;, # The maximum size to which storage capacity can be automatically increased.
          # The default value is 0, which specifies that there is no limit. Not used
          # for First Generation instances.
      &quot;authorizedGaeApplications&quot;: [ # The App Engine app IDs that can access this instance. First Generation
          # instances only.
        &quot;A String&quot;,
      ],
      &quot;tier&quot;: &quot;A String&quot;, # The tier (or machine type) for this instance, for example
          # &lt;code&gt;db-n1-standard-1&lt;/code&gt; (MySQL instances) or
          # &lt;code&gt;db-custom-1-3840&lt;/code&gt; (PostgreSQL instances). For MySQL instances,
          # this property determines whether the instance is First or Second
          # Generation. For more information, see &lt;a
          # href=&quot;/sql/docs/db_path/instance-settings&quot;&gt;Instance Settings&lt;/a&gt;.
      &quot;dataDiskSizeGb&quot;: &quot;A String&quot;, # The size of data disk, in GB. The data disk size minimum is 10GB. Not used
          # for First Generation instances.
      &quot;dataDiskType&quot;: &quot;A String&quot;, # The type of data disk: &lt;code&gt;PD_SSD&lt;/code&gt; (default) or
          # &lt;code&gt;PD_HDD&lt;/code&gt;. Not used for First Generation instances.
      &quot;databaseReplicationEnabled&quot;: True or False, # Configuration specific to read replica instances. Indicates whether
          # replication is enabled or not.
      &quot;crashSafeReplicationEnabled&quot;: True or False, # Configuration specific to read replica instances. Indicates whether
          # database flags for crash-safe replication are enabled. This property is
          # only applicable to First Generation instances.
    },
    &quot;replicaNames&quot;: [ # The replicas of the instance.
      &quot;A String&quot;,
    ],
    &quot;diskEncryptionConfiguration&quot;: { # Disk encryption configuration for an instance. # Disk encryption configuration specific to an instance.
        # Applies only to Second Generation instances.
      &quot;kmsKeyName&quot;: &quot;A String&quot;, # Resource name of KMS key for disk encryption
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#diskEncryptionConfiguration&lt;/code&gt;.
    },
    &quot;scheduledMaintenance&quot;: { # Any scheduled maintenancce for this instance. # The start time of any upcoming scheduled maintenance for this instance.
      &quot;canReschedule&quot;: True or False, # If the scheduled maintenance can be rescheduled.
      &quot;canDefer&quot;: True or False,
      &quot;startTime&quot;: &quot;A String&quot;, # The start time of any upcoming scheduled maintenance for this instance.
    },
    &quot;rootPassword&quot;: &quot;A String&quot;, # Initial root password. Use only on creation.
    &quot;etag&quot;: &quot;A String&quot;, # This field is deprecated and will be removed from a future version of the
        # API. Use the &lt;code&gt;settings.settingsVersion&lt;/code&gt; field instead.
    &quot;serverCaCert&quot;: { # SslCerts Resource # SSL configuration.
      &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
      &quot;expirationTime&quot;: &quot;A String&quot;, # The time when the certificate expires in &lt;a
          # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
          # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
      &quot;sha1Fingerprint&quot;: &quot;A String&quot;, # Sha1 Fingerprint.
      &quot;certSerialNumber&quot;: &quot;A String&quot;, # Serial number, as extracted from the certificate.
      &quot;cert&quot;: &quot;A String&quot;, # PEM representation.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#sslCert&lt;/code&gt;.
      &quot;commonName&quot;: &quot;A String&quot;, # User supplied name.  Constrained to [a-zA-Z.-_ ]+.
      &quot;createTime&quot;: &quot;A String&quot;, # The time when the certificate was created in &lt;a
          # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
          # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;
      &quot;instance&quot;: &quot;A String&quot;, # Name of the database instance.
    },
    &quot;maxDiskSize&quot;: &quot;A String&quot;, # The maximum disk size of the instance in bytes.
    &quot;name&quot;: &quot;A String&quot;, # Name of the Cloud SQL instance. This does not include the project ID.
    &quot;masterInstanceName&quot;: &quot;A String&quot;, # The name of the instance which will act as master in the replication setup.
    &quot;instanceType&quot;: &quot;A String&quot;, # The instance type. This can be one of the following.
        # &lt;br&gt;&lt;code&gt;CLOUD_SQL_INSTANCE&lt;/code&gt;: A Cloud SQL instance that is not
        # replicating from a master. &lt;br&gt;&lt;code&gt;ON_PREMISES_INSTANCE&lt;/code&gt;: An
        # instance running on the
        # customer&#x27;s premises. &lt;br&gt;&lt;code&gt;READ_REPLICA_INSTANCE&lt;/code&gt;: A Cloud SQL
        # instance configured as a read-replica.
    &quot;gceZone&quot;: &quot;A String&quot;, # The Compute Engine zone that the instance is currently serving from. This
        # value could be different from the zone that was specified when the instance
        # was created if the instance has failed over to its secondary zone.
    &quot;currentDiskSize&quot;: &quot;A String&quot;, # The current disk usage of the instance in bytes. This property has been
        # deprecated. Users should use the
        # &quot;cloudsql.googleapis.com/database/disk/bytes_used&quot; metric in Cloud
        # Monitoring API instead. Please see &lt;a
        # href=&quot;https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ&quot;&gt;this
        # announcement&lt;/a&gt; for details.
    &quot;replicaConfiguration&quot;: { # Read-replica configuration for connecting to the master. # Configuration specific to failover replicas and read replicas.
      &quot;mysqlReplicaConfiguration&quot;: { # Read-replica configuration specific to MySQL databases. # MySQL specific configuration when replicating from a MySQL on-premises
          # master. Replication configuration information such as the username,
          # password, certificates, and keys are not stored in the instance metadata.
          # The configuration information is used only to set up the replication
          # connection and is stored by MySQL in a file named &lt;code&gt;master.info&lt;/code&gt;
          # in the data directory.
        &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#mysqlReplicaConfiguration&lt;/code&gt;.
        &quot;password&quot;: &quot;A String&quot;, # The password for the replication connection.
        &quot;verifyServerCertificate&quot;: True or False, # Whether or not to check the master&#x27;s Common Name value in the certificate
            # that it sends during the SSL handshake.
        &quot;clientKey&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s private key. The corresponsing public key
            # is encoded in the client&#x27;s certificate.
        &quot;sslCipher&quot;: &quot;A String&quot;, # A list of permissible ciphers to use for SSL encryption.
        &quot;masterHeartbeatPeriod&quot;: &quot;A String&quot;, # Interval in milliseconds between replication heartbeats.
        &quot;connectRetryInterval&quot;: 42, # Seconds to wait between connect retries. MySQL&#x27;s default is 60 seconds.
        &quot;dumpFilePath&quot;: &quot;A String&quot;, # Path to a SQL dump file in Google Cloud Storage from which the slave
            # instance is to be created. The URI is in the form gs:
            # //bucketName/fileName. Compressed gzip files (.gz) are also supported.
            # // Dumps should have the binlog co-ordinates from which replication should
            # // begin. This can be accomplished by setting --master-data to 1 when using
            # // mysqldump.
        &quot;clientCertificate&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s x509 certificate.
        &quot;username&quot;: &quot;A String&quot;, # The username for the replication connection.
        &quot;caCertificate&quot;: &quot;A String&quot;, # PEM representation of the trusted CA&#x27;s x509 certificate.
      },
      &quot;failoverTarget&quot;: True or False, # Specifies if the replica is the failover target. If the field is set to
          # &lt;code&gt;true&lt;/code&gt; the replica will be designated as a failover replica. In
          # case the master instance fails, the replica instance will be promoted as
          # the new master instance.  &lt;p&gt;Only one replica can be specified as failover
          # target, and the replica has to be in different zone with the master
          # instance.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#replicaConfiguration&lt;/code&gt;.
    },
    &quot;connectionName&quot;: &quot;A String&quot;, # Connection name of the Cloud SQL instance used in connection strings.
    &quot;failoverReplica&quot;: { # The name and status of the failover replica. This property is applicable
        # only to Second Generation instances.
      &quot;name&quot;: &quot;A String&quot;, # The name of the failover replica. If specified at instance creation, a
          # failover replica is created for the instance. The name
          # doesn&#x27;t include the project ID. This property is applicable only to
          # Second Generation instances.
      &quot;available&quot;: True or False, # The availability status of the failover replica. A false status indicates
          # that the failover replica is out of sync. The master can only failover to
          # the failover replica when the status is true.
    },
    &quot;ipAddresses&quot;: [ # The assigned IP addresses for the instance.
      { # Database instance IP Mapping.
        &quot;type&quot;: &quot;A String&quot;, # The type of this IP address. A &lt;code&gt;PRIMARY&lt;/code&gt; address is a public
            # address that can accept incoming connections. A &lt;code&gt;PRIVATE&lt;/code&gt;
            # address is a private address that can accept incoming connections. An
            # &lt;code&gt;OUTGOING&lt;/code&gt; address is the source address of connections
            # originating from the instance, if supported.
        &quot;ipAddress&quot;: &quot;A String&quot;, # The IP address assigned.
        &quot;timeToRetire&quot;: &quot;A String&quot;, # The due time for this IP to be retired in &lt;a
            # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
            # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;. This field is only available when
            # the IP is scheduled to be retired.
      },
    ],
    &quot;ipv6Address&quot;: &quot;A String&quot;, # The IPv6 address assigned to the instance. This property is applicable only
        # to First Generation instances.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;diskEncryptionStatus&quot;: { # Disk encryption status for an instance. # Disk encryption status specific to an instance.
        # Applies only to Second Generation instances.
      &quot;kmsKeyVersionName&quot;: &quot;A String&quot;, # KMS key version used to encrypt the Cloud SQL instance resource
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#diskEncryptionStatus&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#instance&lt;/code&gt;.
    &quot;region&quot;: &quot;A String&quot;, # The geographical region. Can be &lt;code&gt;us-central&lt;/code&gt;
        # (&lt;code&gt;FIRST_GEN&lt;/code&gt; instances only), &lt;code&gt;us-central1&lt;/code&gt;
        # (&lt;code&gt;SECOND_GEN&lt;/code&gt; instances only), &lt;code&gt;asia-east1&lt;/code&gt; or
        # &lt;code&gt;europe-west1&lt;/code&gt;. Defaults to &lt;code&gt;us-central&lt;/code&gt; or
        # &lt;code&gt;us-central1&lt;/code&gt; depending on the instance type (First Generation
        # or Second Generation). The region can not be changed after instance
        # creation.
    &quot;state&quot;: &quot;A String&quot;, # The current serving state of the Cloud SQL instance. This can be one of the
        # following. &lt;br&gt;&lt;code&gt;RUNNABLE&lt;/code&gt;: The instance is running, or is ready
        # to run when accessed. &lt;br&gt;&lt;code&gt;SUSPENDED&lt;/code&gt;: The instance is not
        # available, for example due to problems with billing.
        # &lt;br&gt;&lt;code&gt;PENDING_CREATE&lt;/code&gt;: The instance is being created.
        # &lt;br&gt;&lt;code&gt;MAINTENANCE&lt;/code&gt;: The instance is down for maintenance.
        # &lt;br&gt;&lt;code&gt;FAILED&lt;/code&gt;: The instance creation failed.
        # &lt;br&gt;&lt;code&gt;UNKNOWN_STATE&lt;/code&gt;: The state of the instance is unknown.
    &quot;backendType&quot;: &quot;A String&quot;, # &lt;code&gt;FIRST_GEN&lt;/code&gt;: First Generation instance. MySQL only. &lt;br
        # /&gt;&lt;code&gt;SECOND_GEN&lt;/code&gt;: Second Generation instance or PostgreSQL
        # instance. &lt;br /&gt;&lt;code&gt;EXTERNAL&lt;/code&gt;: A database server that is not
        # managed by Google. &lt;br&gt;This property is read-only; use the
        # &lt;code&gt;tier&lt;/code&gt; property in the &lt;code&gt;settings&lt;/code&gt; object to determine
        # the database type and Second or First Generation.
    &quot;onPremisesConfiguration&quot;: { # On-premises instance configuration. # Configuration specific to on-premises instances.
      &quot;dumpFilePath&quot;: &quot;A String&quot;, # The dump file to create the Cloud SQL replica.
      &quot;hostPort&quot;: &quot;A String&quot;, # The host and port of the on-premises instance in host:port format
      &quot;clientCertificate&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s x509 certificate.
      &quot;username&quot;: &quot;A String&quot;, # The username for connecting to on-premises instance.
      &quot;caCertificate&quot;: &quot;A String&quot;, # PEM representation of the trusted CA&#x27;s x509 certificate.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#onPremisesConfiguration&lt;/code&gt;.
      &quot;password&quot;: &quot;A String&quot;, # The password for connecting to on-premises instance.
      &quot;clientKey&quot;: &quot;A String&quot;, # PEM representation of the slave&#x27;s private key. The corresponsing public key
          # is encoded in the client&#x27;s certificate.
    },
    &quot;project&quot;: &quot;A String&quot;, # The project ID of the project containing the Cloud SQL instance. The Google
        # apps domain is prefixed if applicable.
    &quot;serviceAccountEmailAddress&quot;: &quot;A String&quot;, # The service account email address assigned to the instance. This property
        # is applicable only to Second Generation instances.
  }

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # An Operation resource.&amp;nbsp;For successful operations that return an
      # Operation resource, only the fields relevant to the operation are populated
      # in the resource.
    &quot;name&quot;: &quot;A String&quot;, # An identifier that uniquely identifies the operation. You can use this
        # identifier to retrieve the Operations resource that has information about
        # the operation.
    &quot;exportContext&quot;: { # Database instance export context. # The context for export operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#exportContext&lt;/code&gt;.
      &quot;databases&quot;: [ # Databases to be exported. &lt;br /&gt; &lt;b&gt;MySQL instances:&lt;/b&gt; If
          # &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt; and no database is specified, all
          # databases are exported, except for the &lt;code&gt;mysql&lt;/code&gt; system database.
          # If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, you can specify one database,
          # either by using this property or by using the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property, which takes precedence
          # over this property. &lt;br /&gt; &lt;b&gt;PostgreSQL instances:&lt;/b&gt; You must specify
          # one database to be exported. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;,
          # this database must match the one specified in the
          # &lt;code&gt;csvExportOptions.selectQuery&lt;/code&gt; property.
        &quot;A String&quot;,
      ],
      &quot;sqlExportOptions&quot;: { # Options for exporting data as SQL statements.
        &quot;schemaOnly&quot;: True or False, # Export only schemas.
        &quot;mysqlExportOptions&quot;: { # Options for exporting from MySQL.
          &quot;masterData&quot;: 42, # Option to include SQL statement required to set up replication.
              # If set to &lt;code&gt;1&lt;/code&gt;, the dump file includes
              #  a CHANGE MASTER TO statement with the binary log coordinates.
              # If set to &lt;code&gt;2&lt;/code&gt;, the CHANGE MASTER TO statement is written as
              #  a SQL comment, and has no effect.
              # All other values are ignored.
        },
        &quot;tables&quot;: [ # Tables to export, or that were exported, from the specified database. If
            # you specify tables, specify one and only one database. For PostgreSQL
            # instances, you can specify only one table.
          &quot;A String&quot;,
        ],
      },
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
      &quot;uri&quot;: &quot;A String&quot;, # The path to the file in Google Cloud Storage where the export will be
          # stored. The URI is in the form &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. If the file already exists, the requests
          # // succeeds, but the operation fails. If &lt;code&gt;fileType&lt;/code&gt; is
          # // &lt;code&gt;SQL&lt;/code&gt; and the filename ends with .gz, the contents are
          # // compressed.
      &quot;csvExportOptions&quot;: { # Options for exporting data as CSV.
        &quot;selectQuery&quot;: &quot;A String&quot;, # The select query used to extract the data.
      },
    },
    &quot;targetId&quot;: &quot;A String&quot;, # Name of the database instance related to this operation.
    &quot;endTime&quot;: &quot;A String&quot;, # The time this operation finished in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;startTime&quot;: &quot;A String&quot;, # The time this operation actually started in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;insertTime&quot;: &quot;A String&quot;, # The time this operation was enqueued in UTC timezone in &lt;a
        # href=&quot;https://tools.ietf.org/html/rfc3339&quot;&gt;RFC 3339&lt;/a&gt; format, for example
        # &lt;code&gt;2012-11-15T16:19:00.094Z&lt;/code&gt;.
    &quot;user&quot;: &quot;A String&quot;, # The email address of the user who initiated this operation.
    &quot;targetProject&quot;: &quot;A String&quot;, # The project ID of the target instance related to this operation.
    &quot;selfLink&quot;: &quot;A String&quot;, # The URI of this resource.
    &quot;targetLink&quot;: &quot;A String&quot;,
    &quot;operationType&quot;: &quot;A String&quot;, # The type of the operation. Valid values are &lt;code&gt;CREATE&lt;/code&gt;,
        # &lt;code&gt;DELETE&lt;/code&gt;, &lt;code&gt;UPDATE&lt;/code&gt;, &lt;code&gt;RESTART&lt;/code&gt;,
        # &lt;code&gt;IMPORT&lt;/code&gt;, &lt;code&gt;EXPORT&lt;/code&gt;, &lt;code&gt;BACKUP_VOLUME&lt;/code&gt;,
        # &lt;code&gt;RESTORE_VOLUME&lt;/code&gt;, &lt;code&gt;CREATE_USER&lt;/code&gt;,
        # &lt;code&gt;DELETE_USER&lt;/code&gt;, &lt;code&gt;CREATE_DATABASE&lt;/code&gt;,
        # &lt;code&gt;DELETE_DATABASE&lt;/code&gt; .
    &quot;error&quot;: { # Database instance operation errors list wrapper. # If errors occurred during processing of this operation, this field will be
        # populated.
      &quot;errors&quot;: [ # The list of errors encountered while processing this operation.
        { # Database instance operation error.
          &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationError&lt;/code&gt;.
          &quot;code&quot;: &quot;A String&quot;, # Identifies the specific error that occurred.
          &quot;message&quot;: &quot;A String&quot;, # Additional information about the error encountered.
        },
      ],
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operationErrors&lt;/code&gt;.
    },
    &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#operation&lt;/code&gt;.
    &quot;importContext&quot;: { # Database instance import context. # The context for import operation, if applicable.
      &quot;kind&quot;: &quot;A String&quot;, # This is always &lt;code&gt;sql#importContext&lt;/code&gt;.
      &quot;csvImportOptions&quot;: { # Options for importing data as CSV.
        &quot;columns&quot;: [ # The columns to which CSV data is imported. If not specified, all columns
            # of the database table are loaded with CSV data.
          &quot;A String&quot;,
        ],
        &quot;table&quot;: &quot;A String&quot;, # The table to which CSV data is imported.
      },
      &quot;database&quot;: &quot;A String&quot;, # The target database for the import. If &lt;code&gt;fileType&lt;/code&gt; is
          # &lt;code&gt;SQL&lt;/code&gt;, this field is required only if the import file does not
          # specify a database, and is overridden by any database specification in the
          # import file. If &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;CSV&lt;/code&gt;, one database
          # must be specified.
      &quot;importUser&quot;: &quot;A String&quot;, # The PostgreSQL user for this import operation. PostgreSQL instances only.
      &quot;bakImportOptions&quot;: { # Import parameters specific to SQL Server .BAK files
        &quot;encryptionOptions&quot;: {
          &quot;pvkPassword&quot;: &quot;A String&quot;, # Password that encrypts the private key
          &quot;certPath&quot;: &quot;A String&quot;, # Path to the Certificate (.cer) in Cloud Storage, in the form
              # &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
          &quot;pvkPath&quot;: &quot;A String&quot;, # Path to the Certificate Private Key (.pvk)  in Cloud Storage, in the
              # form &lt;code&gt;gs://bucketName/fileName&lt;/code&gt;. The instance must have
              # write permissions to the bucket and read access to the file.
        },
      },
      &quot;uri&quot;: &quot;A String&quot;, # Path to the import file in Cloud Storage, in the form
          # &lt;code&gt;gs:
          # //bucketName/fileName&lt;/code&gt;. Compressed gzip files (.gz) are supported
          # // when &lt;code&gt;fileType&lt;/code&gt; is &lt;code&gt;SQL&lt;/code&gt;. The instance must have
          # // write permissions to the bucket and read access to the file.
      &quot;fileType&quot;: &quot;A String&quot;, # The file type for the specified uri. &lt;br&gt;&lt;code&gt;SQL&lt;/code&gt;: The file
          # contains SQL statements. &lt;br&gt;&lt;code&gt;CSV&lt;/code&gt;: The file contains CSV data.
    },
    &quot;status&quot;: &quot;A String&quot;, # The status of an operation. Valid values are &lt;code&gt;PENDING&lt;/code&gt;,
        # &lt;code&gt;RUNNING&lt;/code&gt;, &lt;code&gt;DONE&lt;/code&gt;,
        # &lt;code&gt;SQL_OPERATION_STATUS_UNSPECIFIED&lt;/code&gt;.
  }</pre>
</div>

</body></html>