@googleapis/sqladmin 3.2.0 → 3.3.0

package/v1beta4.ts

@@ -148,11 +148,11 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$AclEntry {
     /**
-     * The time when this access control entry expires in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+     * The time when this access control entry expires in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
      */
     expirationTime?: string | null;
     /**
-     * This is always **sql#aclEntry**.
+     * This is always `sql#aclEntry`.
      */
     kind?: string | null;
     /**
@@ -198,7 +198,7 @@ export namespace sqladmin_v1beta4 {
      */
     enabled?: boolean | null;
     /**
-     * This is always **sql#backupConfiguration**.
+     * This is always `sql#backupConfiguration`.
      */
     kind?: string | null;
     /**
@@ -214,7 +214,7 @@ export namespace sqladmin_v1beta4 {
      */
     replicationLogArchivingEnabled?: boolean | null;
     /**
-     * Start time for the daily backup configuration in UTC timezone in the 24 hour format - **HH:MM**.
+     * Start time for the daily backup configuration in UTC timezone in the 24 hour format - `HH:MM`.
      */
     startTime?: string | null;
     /**
@@ -231,7 +231,7 @@ export namespace sqladmin_v1beta4 {
      */
     backupId?: string | null;
     /**
-     * This is always **sql#backupContext**.
+     * This is always `sql#backupContext`.
      */
     kind?: string | null;
   }
@@ -269,11 +269,11 @@ export namespace sqladmin_v1beta4 {
      */
     diskEncryptionStatus?: Schema$DiskEncryptionStatus;
     /**
-     * The time the backup operation completed in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+     * The time the backup operation completed in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
      */
     endTime?: string | null;
     /**
-     * The time the run was enqueued in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+     * The time the run was enqueued in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
      */
     enqueuedTime?: string | null;
     /**
@@ -289,7 +289,7 @@ export namespace sqladmin_v1beta4 {
      */
     instance?: string | null;
     /**
-     * This is always **sql#backupRun**.
+     * This is always `sql#backupRun`.
      */
     kind?: string | null;
     /**
@@ -301,7 +301,7 @@ export namespace sqladmin_v1beta4 {
      */
     selfLink?: string | null;
     /**
-     * The time the backup operation actually started in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+     * The time the backup operation actually started in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
      */
     startTime?: string | null;
     /**
@@ -313,7 +313,7 @@ export namespace sqladmin_v1beta4 {
      */
     type?: string | null;
     /**
-     * The start time of the backup window during which this the backup was attempted in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+     * The start time of the backup window during which this the backup was attempted in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
      */
     windowStartTime?: string | null;
   }
@@ -326,7 +326,7 @@ export namespace sqladmin_v1beta4 {
      */
     items?: Schema$BackupRun[];
     /**
-     * This is always **sql#backupRunsList**.
+     * This is always `sql#backupRunsList`.
      */
     kind?: string | null;
     /**
@@ -347,7 +347,7 @@ export namespace sqladmin_v1beta4 {
      */
     binLogPosition?: string | null;
     /**
-     * This is always **sql#binLogCoordinates**.
+     * This is always `sql#binLogCoordinates`.
      */
     kind?: string | null;
   }
@@ -355,6 +355,10 @@ export namespace sqladmin_v1beta4 {
    * Database instance clone context.
    */
   export interface Schema$CloneContext {
+    /**
+     * The name of the allocated ip range for the private ip CloudSQL instance. For example: "google-managed-services-default". If set, the cloned instance ip will be created in the allocated range. The range name must comply with [RFC 1035](https://tools.ietf.org/html/rfc1035). Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. Reserved for future use.
+     */
+    allocatedIpRange?: string | null;
     /**
      * Binary log coordinates, if specified, identify the position up to which the source instance is cloned. If not specified, the source instance is cloned up to the most recent binary log coordinates.
      */
@@ -364,7 +368,7 @@ export namespace sqladmin_v1beta4 {
      */
     destinationInstanceName?: string | null;
     /**
-     * This is always **sql#cloneContext**.
+     * This is always `sql#cloneContext`.
      */
     kind?: string | null;
     /**
@@ -381,11 +385,11 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$ConnectSettings {
     /**
-     * **SECOND_GEN**: Cloud SQL database instance. **EXTERNAL**: A database server that is not managed by Google. This property is read-only; use the **tier** property in the **settings** object to determine the database type.
+     * `SECOND_GEN`: Cloud SQL database instance. `EXTERNAL`: A database server that is not managed by Google. This property is read-only; use the `tier` property in the `settings` object to determine the database type.
      */
     backendType?: string | null;
     /**
-     * The database engine type and version. The **databaseVersion** field cannot be changed after instance creation. MySQL instances: **MYSQL_8_0**, **MYSQL_5_7** (default), or **MYSQL_5_6**. PostgreSQL instances: **POSTGRES_9_6**, **POSTGRES_10**, **POSTGRES_11** or **POSTGRES_12** (default). SQL Server instances: **SQLSERVER_2017_STANDARD** (default), **SQLSERVER_2017_ENTERPRISE**, **SQLSERVER_2017_EXPRESS**, or **SQLSERVER_2017_WEB**.
+     * The database engine type and version. The `databaseVersion` field cannot be changed after instance creation. MySQL instances: `MYSQL_8_0`, `MYSQL_5_7` (default), or `MYSQL_5_6`. PostgreSQL instances: `POSTGRES_9_6`, `POSTGRES_10`, `POSTGRES_11` or `POSTGRES_12` (default), `POSTGRES_13`, or `POSTGRES_14`. SQL Server instances: `SQLSERVER_2017_STANDARD` (default), `SQLSERVER_2017_ENTERPRISE`, `SQLSERVER_2017_EXPRESS`, `SQLSERVER_2017_WEB`, `SQLSERVER_2019_STANDARD`, `SQLSERVER_2019_ENTERPRISE`, `SQLSERVER_2019_EXPRESS`, or `SQLSERVER_2019_WEB`.
      */
     databaseVersion?: string | null;
     /**
@@ -397,7 +401,7 @@ export namespace sqladmin_v1beta4 {
      */
     kind?: string | null;
     /**
-     * The cloud region for the instance. e.g. **us-central1**, **europe-west1**. The region cannot be changed after instance creation.
+     * The cloud region for the instance. e.g. `us-central1`, `europe-west1`. The region cannot be changed after instance creation.
      */
     region?: string | null;
     /**
@@ -426,7 +430,7 @@ export namespace sqladmin_v1beta4 {
      */
     instance?: string | null;
     /**
-     * This is always **sql#database**.
+     * This is always `sql#database`.
      */
     kind?: string | null;
     /**
@@ -452,7 +456,7 @@ export namespace sqladmin_v1beta4 {
      */
     name?: string | null;
     /**
-     * The value of the flag. Booleans are set to **on** for true and **off** for false. This field must be omitted if the flag doesn't take a value.
+     * The value of the flag. Boolean flags are set to `on` for true and `off` for false. This field must be omitted if the flag doesn't take a value.
      */
     value?: string | null;
   }
@@ -461,7 +465,11 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$DatabaseInstance {
     /**
-     * The backend type. **SECOND_GEN**: Cloud SQL database instance. **EXTERNAL**: A database server that is not managed by Google. This property is read-only; use the **tier** property in the **settings** object to determine the database type.
+     * List all maintenance versions applicable on the instance
+     */
+    availableMaintenanceVersions?: string[] | null;
+    /**
+     * The backend type. `SECOND_GEN`: Cloud SQL database instance. `EXTERNAL`: A database server that is not managed by Google. This property is read-only; use the `tier` property in the `settings` object to determine the database type.
      */
     backendType?: string | null;
     /**
@@ -469,7 +477,7 @@ export namespace sqladmin_v1beta4 {
      */
     connectionName?: string | null;
     /**
-     * Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+     * Output only. The time when the instance was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
      */
     createTime?: string | null;
     /**
@@ -477,11 +485,11 @@ export namespace sqladmin_v1beta4 {
      */
     currentDiskSize?: string | null;
     /**
-     * Output only. The databaseInstalledVersion stores the current fully resolved database version running on the instance including minor version such as MYSQL_5_6_50
+     * Output only. Stores the current database version running on the instance including minor version such as `MYSQL_8_0_18`.
      */
     databaseInstalledVersion?: string | null;
     /**
-     * The database engine type and version. The **databaseVersion** field cannot be changed after instance creation.
+     * The database engine type and version. The `databaseVersion` field cannot be changed after instance creation.
      */
     databaseVersion?: string | null;
     /**
@@ -493,7 +501,7 @@ export namespace sqladmin_v1beta4 {
      */
     diskEncryptionStatus?: Schema$DiskEncryptionStatus;
     /**
-     * This field is deprecated and will be removed from a future version of the API. Use the **settings.settingsVersion** field instead.
+     * This field is deprecated and will be removed from a future version of the API. Use the `settings.settingsVersion` field instead.
      */
     etag?: string | null;
     /**
@@ -501,7 +509,7 @@ export namespace sqladmin_v1beta4 {
      */
     failoverReplica?: {available?: boolean; name?: string} | null;
     /**
-     * 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.
+     * 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. WARNING: Changing this might restart the instance.
      */
     gceZone?: string | null;
     /**
@@ -517,9 +525,13 @@ export namespace sqladmin_v1beta4 {
      */
     ipv6Address?: string | null;
     /**
-     * This is always **sql#instance**.
+     * This is always `sql#instance`.
      */
     kind?: string | null;
+    /**
+     * The current software version on the instance.
+     */
+    maintenanceVersion?: string | null;
     /**
      * The name of the instance which will act as primary in the replication setup.
      */
@@ -545,7 +557,7 @@ export namespace sqladmin_v1beta4 {
      */
     project?: string | null;
     /**
-     * The geographical region. Can be: * **us-central** (**FIRST_GEN** instances only) * **us-central1** (**SECOND_GEN** instances only) * **asia-east1** or **europe-west1**. Defaults to **us-central** or **us-central1** depending on the instance type. The region cannot be changed after instance creation.
+     * The geographical region. Can be: * `us-central` (`FIRST_GEN` instances only) * `us-central1` (`SECOND_GEN` instances only) * `asia-east1` or `europe-west1`. Defaults to `us-central` or `us-central1` depending on the instance type. The region cannot be changed after instance creation.
      */
     region?: string | null;
     /**
@@ -581,7 +593,7 @@ export namespace sqladmin_v1beta4 {
      */
     serverCaCert?: Schema$SslCert;
     /**
-     * The service account email address assigned to the instance. This property is read-only.
+     * The service account email address assigned to the instance. \This property is read-only.
      */
     serviceAccountEmailAddress?: string | null;
     /**
@@ -606,7 +618,7 @@ export namespace sqladmin_v1beta4 {
      */
     items?: Schema$Database[];
     /**
-     * This is always **sql#databasesList**.
+     * This is always `sql#databasesList`.
      */
     kind?: string | null;
   }
@@ -615,11 +627,11 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$DemoteMasterConfiguration {
     /**
-     * This is always **sql#demoteMasterConfiguration**.
+     * This is always `sql#demoteMasterConfiguration`.
      */
     kind?: string | null;
     /**
-     * MySQL specific configuration when replicating from a MySQL on-premises primary instance. 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 **master.info** in the data directory.
+     * MySQL specific configuration when replicating from a MySQL on-premises primary instance. 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 `master.info` in the data directory.
      */
     mysqlReplicaConfiguration?: Schema$DemoteMasterMySqlReplicaConfiguration;
   }
@@ -628,7 +640,7 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$DemoteMasterContext {
     /**
-     * This is always **sql#demoteMasterContext**.
+     * This is always `sql#demoteMasterContext`.
      */
     kind?: string | null;
     /**
@@ -644,7 +656,7 @@ export namespace sqladmin_v1beta4 {
      */
     skipReplicationSetup?: boolean | null;
     /**
-     * Verify GTID consistency for demote operation. Default value: **True**. Setting this flag to false enables you to bypass GTID consistency check between on-premises primary instance 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.
+     * Verify the GTID consistency for demote operation. Default value: `True`. Setting this flag to `false` enables you to bypass the GTID consistency check between on-premises primary instance 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.
      */
     verifyGtidConsistency?: boolean | null;
   }
@@ -665,7 +677,7 @@ export namespace sqladmin_v1beta4 {
      */
     clientKey?: string | null;
     /**
-     * This is always **sql#demoteMasterMysqlReplicaConfiguration**.
+     * This is always `sql#demoteMasterMysqlReplicaConfiguration`.
      */
     kind?: string | null;
     /**
@@ -699,7 +711,7 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$DiskEncryptionConfiguration {
     /**
-     * This is always **sql#diskEncryptionConfiguration**.
+     * This is always `sql#diskEncryptionConfiguration`.
      */
     kind?: string | null;
     /**
@@ -712,7 +724,7 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$DiskEncryptionStatus {
     /**
-     * This is always **sql#diskEncryptionStatus**.
+     * This is always `sql#diskEncryptionStatus`.
      */
     kind?: string | null;
     /**
@@ -725,7 +737,7 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$ExportContext {
     /**
-     * Options for exporting data as CSV. **MySQL** and **PostgreSQL** instances only.
+     * Options for exporting data as CSV. `MySQL` and `PostgreSQL` instances only.
      */
     csvExportOptions?: {
       escapeCharacter?: string;
@@ -735,7 +747,7 @@ export namespace sqladmin_v1beta4 {
       selectQuery?: string;
     } | null;
     /**
-     * Databases to be exported. **MySQL instances:** If **fileType** is **SQL** and no database is specified, all databases are exported, except for the **mysql** system database. If **fileType** is **CSV**, you can specify one database, either by using this property or by using the **csvExportOptions.selectQuery** property, which takes precedence over this property. **PostgreSQL instances:** You must specify one database to be exported. If **fileType** is **CSV**, this database must match the one specified in the **csvExportOptions.selectQuery** property. **SQL Server instances:** You must specify one database to be exported, and the **fileType** must be **BAK**.
+     * Databases to be exported. `MySQL instances:` If `fileType` is `SQL` and no database is specified, all databases are exported, except for the `mysql` system database. If `fileType` is `CSV`, you can specify one database, either by using this property or by using the `csvExportOptions.selectQuery` property, which takes precedence over this property. `PostgreSQL instances:` You must specify one database to be exported. If `fileType` is `CSV`, this database must match the one specified in the `csvExportOptions.selectQuery` property. `SQL Server instances:` You must specify one database to be exported, and the `fileType` must be `BAK`.
      */
     databases?: string[] | null;
     /**
@@ -743,7 +755,7 @@ export namespace sqladmin_v1beta4 {
      */
     fileType?: string | null;
     /**
-     * This is always **sql#exportContext**.
+     * This is always `sql#exportContext`.
      */
     kind?: string | null;
     /**
@@ -759,7 +771,7 @@ export namespace sqladmin_v1beta4 {
       tables?: string[];
     } | null;
     /**
-     * The path to the file in Google Cloud Storage where the export will be stored. The URI is in the form **gs://bucketName/fileName**. If the file already exists, the request succeeds, but the operation fails. If **fileType** is **SQL** and the filename ends with .gz, the contents are compressed.
+     * The path to the file in Google Cloud Storage where the export will be stored. The URI is in the form `gs://bucketName/fileName`. If the file already exists, the request succeeds, but the operation fails. If `fileType` is `SQL` and the filename ends with .gz, the contents are compressed.
      */
     uri?: string | null;
   }
@@ -768,7 +780,7 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$FailoverContext {
     /**
-     * This is always **sql#failoverContext**.
+     * This is always `sql#failoverContext`.
      */
     kind?: string | null;
     /**
@@ -785,11 +797,11 @@ export namespace sqladmin_v1beta4 {
      */
     allowedIntValues?: string[] | null;
     /**
-     * For **STRING** flags, a list of strings that the value can be set to.
+     * For `STRING` flags, a list of strings that the value can be set to.
      */
     allowedStringValues?: string[] | null;
     /**
-     * The database version this flag applies to. Can be **MYSQL_8_0**, **MYSQL_5_6**, or **MYSQL_5_7**.
+     * The database version this flag applies to. Can be MySQL instances: `MYSQL_8_0`, `MYSQL_8_0_18`, `MYSQL_8_0_26`, `MYSQL_5_7`, or `MYSQL_5_6`. PostgreSQL instances: `POSTGRES_9_6`, `POSTGRES_10`, `POSTGRES_11` or `POSTGRES_12`. SQL Server instances: `SQLSERVER_2017_STANDARD`, `SQLSERVER_2017_ENTERPRISE`, `SQLSERVER_2017_EXPRESS`, `SQLSERVER_2017_WEB`, `SQLSERVER_2019_STANDARD`, `SQLSERVER_2019_ENTERPRISE`, `SQLSERVER_2019_EXPRESS`, or `SQLSERVER_2019_WEB`. See [the complete list](/sql/docs/mysql/admin-api/rest/v1/SqlDatabaseVersion).
      */
     appliesTo?: string[] | null;
     /**
@@ -797,19 +809,19 @@ export namespace sqladmin_v1beta4 {
      */
     inBeta?: boolean | null;
     /**
-     * This is always **sql#flag**.
+     * This is always `sql#flag`.
      */
     kind?: string | null;
     /**
-     * For **INTEGER** flags, the maximum allowed value.
+     * For `INTEGER` flags, the maximum allowed value.
      */
     maxValue?: string | null;
     /**
-     * For **INTEGER** flags, the minimum allowed value.
+     * For `INTEGER` flags, the minimum allowed value.
      */
     minValue?: string | null;
     /**
-     * This is the name of the flag. Flag names always use underscores, not hyphens, for example: **max_allowed_packet**
+     * This is the name of the flag. Flag names always use underscores, not hyphens, for example: `max_allowed_packet`
      */
     name?: string | null;
     /**
@@ -817,7 +829,7 @@ export namespace sqladmin_v1beta4 {
      */
     requiresRestart?: boolean | null;
     /**
-     * The type of the flag. Flags are typed to being **BOOLEAN**, **STRING**, **INTEGER** or **NONE**. **NONE** is used for flags which do not take a value, such as **skip_grant_tables**.
+     * The type of the flag. Flags are typed to being `BOOLEAN`, `STRING`, `INTEGER` or `NONE`. `NONE` is used for flags which do not take a value, such as `skip_grant_tables`.
      */
     type?: string | null;
   }
@@ -830,7 +842,7 @@ export namespace sqladmin_v1beta4 {
      */
     items?: Schema$Flag[];
     /**
-     * This is always **sql#flagsList**.
+     * This is always `sql#flagsList`.
      */
     kind?: string | null;
   }
@@ -890,11 +902,11 @@ export namespace sqladmin_v1beta4 {
       table?: string;
     } | null;
     /**
-     * The target database for the import. If **fileType** is **SQL**, 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 **fileType** is **CSV**, one database must be specified.
+     * The target database for the import. If `fileType` is `SQL`, 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 `fileType` is `CSV`, one database must be specified.
      */
     database?: string | null;
     /**
-     * The file type for the specified uri. * **SQL**: The file contains SQL statements. * **CSV**: The file contains CSV data. * **BAK**: The file contains backup data for a SQL Server instance.
+     * The file type for the specified uri. * `SQL`: The file contains SQL statements. * `CSV`: The file contains CSV data. * `BAK`: The file contains backup data for a SQL Server instance.
      */
     fileType?: string | null;
     /**
@@ -902,11 +914,11 @@ export namespace sqladmin_v1beta4 {
      */
     importUser?: string | null;
     /**
-     * This is always **sql#importContext**.
+     * This is always `sql#importContext`.
      */
     kind?: string | null;
     /**
-     * Path to the import file in Cloud Storage, in the form **gs://bucketName/fileName**. Compressed gzip files (.gz) are supported when **fileType** is **SQL**. The instance must have write permissions to the bucket and read access to the file.
+     * Path to the import file in Cloud Storage, in the form `gs://bucketName/fileName`. Compressed gzip files (.gz) are supported when `fileType` is `SQL`. The instance must have write permissions to the bucket and read access to the file.
      */
     uri?: string | null;
   }
@@ -1006,7 +1018,7 @@ export namespace sqladmin_v1beta4 {
      */
     items?: Schema$DatabaseInstance[];
     /**
-     * This is always **sql#instancesList**.
+     * This is always `sql#instancesList`.
      */
     kind?: string | null;
     /**
@@ -1028,7 +1040,7 @@ export namespace sqladmin_v1beta4 {
      */
     certs?: Schema$SslCert[];
     /**
-     * This is always **sql#instancesListServerCas**.
+     * This is always `sql#instancesListServerCas`.
      */
     kind?: string | null;
   }
@@ -1068,7 +1080,7 @@ export namespace sqladmin_v1beta4 {
      */
     allocatedIpRange?: string | null;
     /**
-     * The list of external networks that are allowed to connect to the instance using the IP. In 'CIDR' notation, also known as 'slash' notation (for example: **192.168.100.0/24**).
+     * The list of external networks that are allowed to connect to the instance using the IP. In 'CIDR' notation, also known as 'slash' notation (for example: `157.197.200.0/24`).
      */
     authorizedNetworks?: Schema$AclEntry[];
     /**
@@ -1076,7 +1088,7 @@ export namespace sqladmin_v1beta4 {
      */
     ipv4Enabled?: boolean | null;
     /**
-     * The resource link for the VPC network from which the Cloud SQL instance is accessible for private IP. For example, *x/projects/myProject/global/networks/default**. This setting can be updated, but it cannot be removed after it is set.
+     * The resource link for the VPC network from which the Cloud SQL instance is accessible for private IP. For example, `/projects/myProject/global/networks/default`. This setting can be updated, but it cannot be removed after it is set.
      */
     privateNetwork?: string | null;
     /**
@@ -1093,11 +1105,11 @@ export namespace sqladmin_v1beta4 {
      */
     ipAddress?: string | null;
     /**
-     * The due time for this IP to be retired in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**. This field is only available when the IP is scheduled to be retired.
+     * The due time for this IP to be retired in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`. This field is only available when the IP is scheduled to be retired.
      */
     timeToRetire?: string | null;
     /**
-     * The type of this IP address. A **PRIMARY** address is a public address that can accept incoming connections. A **PRIVATE** address is a private address that can accept incoming connections. An **OUTGOING** address is the source address of connections originating from the instance, if supported.
+     * The type of this IP address. A `PRIMARY` address is a public address that can accept incoming connections. A `PRIVATE` address is a private address that can accept incoming connections. An `OUTGOING` address is the source address of connections originating from the instance, if supported.
      */
     type?: string | null;
   }
@@ -1106,11 +1118,11 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$LocationPreference {
     /**
-     * The App Engine application to follow, it must be in the same region as the Cloud SQL instance.
+     * The App Engine application to follow, it must be in the same region as the Cloud SQL instance. WARNING: Changing this might restart the instance.
      */
     followGaeApplication?: string | null;
     /**
-     * This is always **sql#locationPreference**.
+     * This is always `sql#locationPreference`.
      */
     kind?: string | null;
     /**
@@ -1118,7 +1130,7 @@ export namespace sqladmin_v1beta4 {
      */
     secondaryZone?: string | null;
     /**
-     * The preferred Compute Engine zone (for example: us-central1-a, us-central1-b, etc.).
+     * The preferred Compute Engine zone (for example: us-central1-a, us-central1-b, etc.). WARNING: Changing this might restart the instance.
      */
     zone?: string | null;
   }
@@ -1135,11 +1147,11 @@ export namespace sqladmin_v1beta4 {
      */
     hour?: number | null;
     /**
-     * This is always **sql#maintenanceWindow**.
+     * This is always `sql#maintenanceWindow`.
      */
     kind?: string | null;
     /**
-     * Maintenance timing setting: **canary** (Earlier) or **stable** (Later). [Learn more](https://cloud.google.com/sql/docs/mysql/instance-settings#maintenance-timing-2ndgen).
+     * Maintenance timing setting: `canary` (Earlier) or `stable` (Later). [Learn more](https://cloud.google.com/sql/docs/mysql/instance-settings#maintenance-timing-2ndgen).
      */
     updateTrack?: string | null;
   }
@@ -1168,7 +1180,7 @@ export namespace sqladmin_v1beta4 {
      */
     dumpFilePath?: string | null;
     /**
-     * This is always **sql#mysqlReplicaConfiguration**.
+     * This is always `sql#mysqlReplicaConfiguration`.
      */
     kind?: string | null;
     /**
@@ -1226,7 +1238,7 @@ export namespace sqladmin_v1beta4 {
      */
     hostPort?: string | null;
     /**
-     * This is always **sql#onPremisesConfiguration**.
+     * This is always `sql#onPremisesConfiguration`.
      */
     kind?: string | null;
     /**
@@ -1251,7 +1263,7 @@ export namespace sqladmin_v1beta4 {
      */
     backupContext?: Schema$BackupContext;
     /**
-     * The time this operation finished in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+     * The time this operation finished in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
      */
     endTime?: string | null;
     /**
@@ -1267,11 +1279,11 @@ export namespace sqladmin_v1beta4 {
      */
     importContext?: Schema$ImportContext;
     /**
-     * The time this operation was enqueued in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+     * The time this operation was enqueued in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
      */
     insertTime?: string | null;
     /**
-     * This is always **sql#operation**.
+     * This is always `sql#operation`.
      */
     kind?: string | null;
     /**
@@ -1279,7 +1291,7 @@ export namespace sqladmin_v1beta4 {
      */
     name?: string | null;
     /**
-     * The type of the operation. Valid values are: * **CREATE** * **DELETE** * **UPDATE** * **RESTART** * **IMPORT** * **EXPORT** * **BACKUP_VOLUME** * **RESTORE_VOLUME** * **CREATE_USER** * **DELETE_USER** * **CREATE_DATABASE** * **DELETE_DATABASE**
+     * The type of the operation. Valid values are: * `CREATE` * `DELETE` * `UPDATE` * `RESTART` * `IMPORT` * `EXPORT` * `BACKUP_VOLUME` * `RESTORE_VOLUME` * `CREATE_USER` * `DELETE_USER` * `CREATE_DATABASE` * `DELETE_DATABASE`
      */
     operationType?: string | null;
     /**
@@ -1287,7 +1299,7 @@ export namespace sqladmin_v1beta4 {
      */
     selfLink?: string | null;
     /**
-     * The time this operation actually started in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+     * The time this operation actually started in UTC timezone in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
      */
     startTime?: string | null;
     /**
@@ -1317,7 +1329,7 @@ export namespace sqladmin_v1beta4 {
      */
     code?: string | null;
     /**
-     * This is always **sql#operationError**.
+     * This is always `sql#operationError`.
      */
     kind?: string | null;
     /**
@@ -1334,7 +1346,7 @@ export namespace sqladmin_v1beta4 {
      */
     errors?: Schema$OperationError[];
     /**
-     * This is always **sql#operationErrors**.
+     * This is always `sql#operationErrors`.
      */
     kind?: string | null;
   }
@@ -1347,7 +1359,7 @@ export namespace sqladmin_v1beta4 {
      */
     items?: Schema$Operation[];
     /**
-     * This is always **sql#operationsList**.
+     * This is always `sql#operationsList`.
      */
     kind?: string | null;
     /**
@@ -1385,7 +1397,7 @@ export namespace sqladmin_v1beta4 {
      */
     minLength?: number | null;
     /**
-     * Minimum interval after which the password can be changed.
+     * Minimum interval after which the password can be changed. This flag is only supported for PostgresSQL.
      */
     passwordChangeInterval?: string | null;
     /**
@@ -1398,15 +1410,15 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$ReplicaConfiguration {
     /**
-     * Specifies if the replica is the failover target. If the field is set to **true** the replica will be designated as a failover replica. In case the primary instance fails, the replica instance will be promoted as the new primary instance. Only one replica can be specified as failover target, and the replica has to be in different zone with the primary instance.
+     * Specifies if the replica is the failover target. If the field is set to `true` the replica will be designated as a failover replica. In case the primary instance fails, the replica instance will be promoted as the new primary instance. Only one replica can be specified as failover target, and the replica has to be in different zone with the primary instance.
      */
     failoverTarget?: boolean | null;
     /**
-     * This is always **sql#replicaConfiguration**.
+     * This is always `sql#replicaConfiguration`.
      */
     kind?: string | null;
     /**
-     * MySQL specific configuration when replicating from a MySQL on-premises primary instance. 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 **master.info** in the data directory.
+     * MySQL specific configuration when replicating from a MySQL on-premises primary instance. 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 `master.info` in the data directory.
      */
     mysqlReplicaConfiguration?: Schema$MySqlReplicaConfiguration;
   }
@@ -1416,7 +1428,7 @@ export namespace sqladmin_v1beta4 {
      */
     rescheduleType?: string | null;
     /**
-     * Optional. Timestamp when the maintenance shall be rescheduled to if reschedule_type=SPECIFIC_TIME, in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+     * Optional. Timestamp when the maintenance shall be rescheduled to if reschedule_type=SPECIFIC_TIME, in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
      */
     scheduleTime?: string | null;
   }
@@ -1433,7 +1445,7 @@ export namespace sqladmin_v1beta4 {
      */
     instanceId?: string | null;
     /**
-     * This is always **sql#restoreBackupContext**.
+     * This is always `sql#restoreBackupContext`.
      */
     kind?: string | null;
     /**
@@ -1446,7 +1458,7 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$RotateServerCaContext {
     /**
-     * This is always **sql#rotateServerCaContext**.
+     * This is always `sql#rotateServerCaContext`.
      */
     kind?: string | null;
     /**
@@ -1459,7 +1471,7 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$Settings {
     /**
-     * The activation policy specifies when the instance is activated; it is applicable only when the instance state is RUNNABLE. Valid values: * **ALWAYS**: The instance is on, and remains so even in the absence of connection requests. * **NEVER**: The instance is off; it is not activated, even if a connection request arrives.
+     * The activation policy specifies when the instance is activated; it is applicable only when the instance state is RUNNABLE. Valid values: * `ALWAYS`: The instance is on, and remains so even in the absence of connection requests. * `NEVER`: The instance is off; it is not activated, even if a connection request arrives.
      */
     activationPolicy?: string | null;
     /**
@@ -1471,7 +1483,7 @@ export namespace sqladmin_v1beta4 {
      */
     authorizedGaeApplications?: string[] | null;
     /**
-     * Availability type. Potential values: * **ZONAL**: The instance serves data from only one zone. Outages in that zone affect data accessibility. * **REGIONAL**: The instance can serve data from more than one zone in a region (it is highly available)./ For more information, see [Overview of the High Availability Configuration](https://cloud.google.com/sql/docs/mysql/high-availability).
+     * Availability type. Potential values: * `ZONAL`: The instance serves data from only one zone. Outages in that zone affect data accessibility. * `REGIONAL`: The instance can serve data from more than one zone in a region (it is highly available)./ For more information, see [Overview of the High Availability Configuration](https://cloud.google.com/sql/docs/mysql/high-availability).
      */
     availabilityType?: string | null;
     /**
@@ -1491,7 +1503,7 @@ export namespace sqladmin_v1beta4 {
      */
     databaseFlags?: Schema$DatabaseFlags[];
     /**
-     * Configuration specific to read replica instances. Indicates whether replication is enabled or not.
+     * Configuration specific to read replica instances. Indicates whether replication is enabled or not. WARNING: Changing this restarts the instance.
      */
     databaseReplicationEnabled?: boolean | null;
     /**
@@ -1499,7 +1511,7 @@ export namespace sqladmin_v1beta4 {
      */
     dataDiskSizeGb?: string | null;
     /**
-     * The type of data disk: **PD_SSD** (default) or **PD_HDD**. Not used for First Generation instances.
+     * The type of data disk: `PD_SSD` (default) or `PD_HDD`. Not used for First Generation instances.
      */
     dataDiskType?: string | null;
     /**
@@ -1515,7 +1527,7 @@ export namespace sqladmin_v1beta4 {
      */
     ipConfiguration?: Schema$IpConfiguration;
     /**
-     * This is always **sql#settings**.
+     * This is always `sql#settings`.
      */
     kind?: string | null;
     /**
@@ -1531,11 +1543,11 @@ export namespace sqladmin_v1beta4 {
      */
     passwordValidationPolicy?: Schema$PasswordValidationPolicy;
     /**
-     * The pricing plan for this instance. This can be either **PER_USE** or **PACKAGE**. Only **PER_USE** is supported for Second Generation instances.
+     * The pricing plan for this instance. This can be either `PER_USE` or `PACKAGE`. Only `PER_USE` is supported for Second Generation instances.
      */
     pricingPlan?: string | null;
     /**
-     * The type of replication this instance uses. This can be either **ASYNCHRONOUS** or **SYNCHRONOUS**. (Deprecated) This property was only applicable to First Generation instances.
+     * The type of replication this instance uses. This can be either `ASYNCHRONOUS` or `SYNCHRONOUS`. (Deprecated) This property was only applicable to First Generation instances.
      */
     replicationType?: string | null;
     /**
@@ -1555,7 +1567,7 @@ export namespace sqladmin_v1beta4 {
      */
     storageAutoResizeLimit?: string | null;
     /**
-     * The tier (or machine type) for this instance, for example **db-custom-1-3840**.
+     * The tier (or machine type) for this instance, for example `db-custom-1-3840`. WARNING: Changing this restarts the instance.
      */
     tier?: string | null;
     /**
@@ -1585,7 +1597,7 @@ export namespace sqladmin_v1beta4 {
      */
     detail?: string | null;
     /**
-     * Can be **sql#externalSyncSettingError** or **sql#externalSyncSettingWarning**.
+     * Can be `sql#externalSyncSettingError` or `sql#externalSyncSettingWarning`.
      */
     kind?: string | null;
     /**
@@ -1643,7 +1655,7 @@ export namespace sqladmin_v1beta4 {
      */
     errors?: Schema$SqlExternalSyncSettingError[];
     /**
-     * This is always **sql#migrationSettingErrorList**.
+     * This is always `sql#migrationSettingErrorList`.
      */
     kind?: string | null;
     /**
@@ -1738,11 +1750,11 @@ export namespace sqladmin_v1beta4 {
      */
     commonName?: string | null;
     /**
-     * The time when the certificate was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+     * The time when the certificate was created in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
      */
     createTime?: string | null;
     /**
-     * The time when the certificate expires in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example **2012-11-15T16:19:00.094Z**.
+     * The time when the certificate expires in [RFC 3339](https://tools.ietf.org/html/rfc3339) format, for example `2012-11-15T16:19:00.094Z`.
      */
     expirationTime?: string | null;
     /**
@@ -1750,7 +1762,7 @@ export namespace sqladmin_v1beta4 {
      */
     instance?: string | null;
     /**
-     * This is always **sql#sslCert**.
+     * This is always `sql#sslCert`.
      */
     kind?: string | null;
     /**
@@ -1806,7 +1818,7 @@ export namespace sqladmin_v1beta4 {
      */
     clientCert?: Schema$SslCertDetail;
     /**
-     * This is always **sql#sslCertsInsert**.
+     * This is always `sql#sslCertsInsert`.
      */
     kind?: string | null;
     /**
@@ -1827,7 +1839,7 @@ export namespace sqladmin_v1beta4 {
      */
     items?: Schema$SslCert[];
     /**
-     * This is always **sql#sslCertsList**.
+     * This is always `sql#sslCertsList`.
      */
     kind?: string | null;
   }
@@ -1853,7 +1865,7 @@ export namespace sqladmin_v1beta4 {
      */
     DiskQuota?: string | null;
     /**
-     * This is always *sql#tier*.
+     * This is always `sql#tier`.
      */
     kind?: string | null;
     /**
@@ -1865,7 +1877,7 @@ export namespace sqladmin_v1beta4 {
      */
     region?: string[] | null;
     /**
-     * An identifier for the machine type, for example, db-custom-1-3840. For related information, see Pricing.
+     * An identifier for the machine type, for example, `db-custom-1-3840`. For related information, see [Pricing](/sql/pricing).
      */
     tier?: string | null;
   }
@@ -1878,7 +1890,7 @@ export namespace sqladmin_v1beta4 {
      */
     items?: Schema$Tier[];
     /**
-     * This is always *sql#tiersList*.
+     * This is always `sql#tiersList`.
      */
     kind?: string | null;
   }
@@ -1887,11 +1899,11 @@ export namespace sqladmin_v1beta4 {
    */
   export interface Schema$TruncateLogContext {
     /**
-     * This is always **sql#truncateLogContext**.
+     * This is always `sql#truncateLogContext`.
      */
     kind?: string | null;
     /**
-     * The type of log to truncate. Valid values are **MYSQL_GENERAL_TABLE** and **MYSQL_SLOW_TABLE**.
+     * The type of log to truncate. Valid values are `MYSQL_GENERAL_TABLE` and `MYSQL_SLOW_TABLE`.
      */
     logType?: string | null;
   }
@@ -1904,19 +1916,19 @@ export namespace sqladmin_v1beta4 {
      */
     etag?: string | null;
     /**
-     * Optional. The host name from which the user can connect. For **insert** operations, host defaults to an empty string. For **update** operations, host is specified as part of the request URL. The host name cannot be updated after insertion. For a MySQL instance, it's required; for a PostgreSQL or SQL Server instance, it's optional.
+     * Optional. The host from which the user can connect. For `insert` operations, host defaults to an empty string. For `update` operations, host is specified as part of the request URL. The host name cannot be updated after insertion. For a MySQL instance, it's required; for a PostgreSQL or SQL Server instance, it's optional.
      */
     host?: string | null;
     /**
-     * The name of the Cloud SQL instance. This does not include the project ID. Can be omitted for *update* since it is already specified on the URL.
+     * The name of the Cloud SQL instance. This does not include the project ID. Can be omitted for *update* because it is already specified on the URL.
      */
     instance?: string | null;
     /**
-     * This is always *sql#user*.
+     * This is always `sql#user`.
      */
     kind?: string | null;
     /**
-     * The name of the user in the Cloud SQL instance. Can be omitted for **update** since it is already specified in the URL.
+     * The name of the user in the Cloud SQL instance. Can be omitted for `update` because it is already specified in the URL.
      */
     name?: string | null;
     /**
@@ -1928,7 +1940,7 @@ export namespace sqladmin_v1beta4 {
      */
     passwordPolicy?: Schema$UserPasswordValidationPolicy;
     /**
-     * The project ID of the project containing the Cloud SQL database. The Google apps domain is prefixed if applicable. Can be omitted for *update* since it is already specified on the URL.
+     * The project ID of the project containing the Cloud SQL database. The Google apps domain is prefixed if applicable. Can be omitted for *update* because it is already specified on the URL.
      */
     project?: string | null;
     sqlserverUserDetails?: Schema$SqlServerUserDetails;
@@ -5133,6 +5145,7 @@ export namespace sqladmin_v1beta4 {
      *
      *   // Example response
      *   // {
+     *   //   "availableMaintenanceVersions": [],
      *   //   "backendType": "my_backendType",
      *   //   "connectionName": "my_connectionName",
      *   //   "createTime": "my_createTime",
@@ -5148,6 +5161,7 @@ export namespace sqladmin_v1beta4 {
      *   //   "ipAddresses": [],
      *   //   "ipv6Address": "my_ipv6Address",
      *   //   "kind": "my_kind",
+     *   //   "maintenanceVersion": "my_maintenanceVersion",
      *   //   "masterInstanceName": "my_masterInstanceName",
      *   //   "maxDiskSize": "my_maxDiskSize",
      *   //   "name": "my_name",
@@ -5449,6 +5463,7 @@ export namespace sqladmin_v1beta4 {
      *     requestBody: {
      *       // request body parameters
      *       // {
+     *       //   "availableMaintenanceVersions": [],
      *       //   "backendType": "my_backendType",
      *       //   "connectionName": "my_connectionName",
      *       //   "createTime": "my_createTime",
@@ -5464,6 +5479,7 @@ export namespace sqladmin_v1beta4 {
      *       //   "ipAddresses": [],
      *       //   "ipv6Address": "my_ipv6Address",
      *       //   "kind": "my_kind",
+     *       //   "maintenanceVersion": "my_maintenanceVersion",
      *       //   "masterInstanceName": "my_masterInstanceName",
      *       //   "maxDiskSize": "my_maxDiskSize",
      *       //   "name": "my_name",
@@ -5926,6 +5942,7 @@ export namespace sqladmin_v1beta4 {
      *     requestBody: {
      *       // request body parameters
      *       // {
+     *       //   "availableMaintenanceVersions": [],
      *       //   "backendType": "my_backendType",
      *       //   "connectionName": "my_connectionName",
      *       //   "createTime": "my_createTime",
@@ -5941,6 +5958,7 @@ export namespace sqladmin_v1beta4 {
      *       //   "ipAddresses": [],
      *       //   "ipv6Address": "my_ipv6Address",
      *       //   "kind": "my_kind",
+     *       //   "maintenanceVersion": "my_maintenanceVersion",
      *       //   "masterInstanceName": "my_masterInstanceName",
      *       //   "maxDiskSize": "my_maxDiskSize",
      *       //   "name": "my_name",
@@ -7330,6 +7348,7 @@ export namespace sqladmin_v1beta4 {
      *     requestBody: {
      *       // request body parameters
      *       // {
+     *       //   "availableMaintenanceVersions": [],
      *       //   "backendType": "my_backendType",
      *       //   "connectionName": "my_connectionName",
      *       //   "createTime": "my_createTime",
@@ -7345,6 +7364,7 @@ export namespace sqladmin_v1beta4 {
      *       //   "ipAddresses": [],
      *       //   "ipv6Address": "my_ipv6Address",
      *       //   "kind": "my_kind",
+     *       //   "maintenanceVersion": "my_maintenanceVersion",
      *       //   "masterInstanceName": "my_masterInstanceName",
      *       //   "maxDiskSize": "my_maxDiskSize",
      *       //   "name": "my_name",
@@ -9444,7 +9464,7 @@ export namespace sqladmin_v1beta4 {
     }
 
     /**
-     * Lists all available machine types (tiers) for Cloud SQL, for example, db-custom-1-3840. For related information, see Pricing.
+     * Lists all available machine types (tiers) for Cloud SQL, for example, `db-custom-1-3840`. For related information, see [Pricing](/sql/pricing).
      * @example
      * ```js
      * // Before running the sample: