diff --git a/docs/dyn/sqladmin_v1.backupRuns.html b/docs/dyn/sqladmin_v1.backupRuns.html index f4b197eaaa..f249eb4198 100644 --- a/docs/dyn/sqladmin_v1.backupRuns.html +++ b/docs/dyn/sqladmin_v1.backupRuns.html @@ -226,6 +226,9 @@
Stops the replication in the read replica instance.
switchover(project, instance, dbTimeout=None, x__xgafv=None)
Switches over from the primary instance to the designated DR replica instance.
+Switches over from the primary instance to the DR replica instance.
truncateLog(project, instance, body=None, x__xgafv=None)
Truncate MySQL general and slow query log tables MySQL only.
@@ -352,6 +352,9 @@switchover(project, instance, dbTimeout=None, x__xgafv=None)
- Switches over from the primary instance to the designated DR replica instance. +Switches over from the primary instance to the DR replica instance. Args: project: string, ID of the project that contains the replica. (required) instance: string, Cloud SQL read replica instance name. (required) - dbTimeout: string, Optional. (MySQL only) Cloud SQL instance operations timeout, which is a sum of all database operations. Default value is 10 minutes and can be modified to a maximum value of 24 hours. + dbTimeout: string, Optional. (MySQL and PostgreSQL only) Cloud SQL instance operations timeout, which is a sum of all database operations. Default value is 10 minutes and can be modified to a maximum value of 24 hours. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -4471,6 +4559,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -4615,6 +4706,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -4729,10 +4823,10 @@Method Details
"replicaNames": [ # The replicas of the instance. "A String", ], - "replicationCluster": { # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL. # Optional. A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL. + "replicationCluster": { # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Applicable to MySQL and PostgreSQL. # Optional. A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Applicable to MySQL and PostgreSQL. "drReplica": True or False, # Output only. Read-only field that indicates whether the replica is a DR replica. This field is not set if the instance is a primary instance. "failoverDrReplicaName": "A String", # Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Set this field to a replica name to designate a DR replica for a primary instance. Remove the replica name to remove the DR replica designation. - "psaWriteEndpoint": "A String", # Output only. If set, it indicates this instance has a private service access (PSA) dns endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, the dns should be pointing to this instance. After Switchover or Replica failover, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance does not yet have a replica, or had a DR replica that was deleted. + "psaWriteEndpoint": "A String", # Output only. If set, this field indicates this instance has a private service access (PSA) DNS endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, then the DNS endpoint points to this instance. After a switchover or replica failover operation, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance doesn't have a DR replica yet or the DR replica is deleted. }, "rootPassword": "A String", # Initial root password. Use only on creation. You must set root passwords before you can connect to PostgreSQL instances. "satisfiesPzi": True or False, # Output only. This status indicates whether the instance satisfies PZI. The status is reserved for future use. @@ -4828,6 +4922,9 @@Method Details
"value": "A String", # The allowlisted value for the access control list. }, ], + "customSubjectAlternativeNames": [ # Optional. Custom Subject Alternative Name(SAN)s for a Cloud SQL instance. + "A String", + ], "enablePrivatePathForGoogleCloudServices": True or False, # Controls connectivity to private IP instances from Google services, such as BigQuery. "ipv4Enabled": True or False, # Whether the instance is assigned a public IP address or not. "privateNetwork": "A String", # 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. @@ -4848,6 +4945,7 @@Method Details
}, "requireSsl": True or False, # Use `ssl_mode` instead. Whether SSL/TLS connections over IP are enforced. If set to false, then allow both non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the client certificate won't be verified. If set to true, then only allow connections encrypted with SSL/TLS and with valid client certificates. If you want to enforce SSL/TLS without enforcing the requirement for valid client certificates, then use the `ssl_mode` flag instead of the `require_ssl` flag. "serverCaMode": "A String", # Specify what type of CA is used for the server certificate. + "serverCaPool": "A String", # Optional. The resource name of the server CA pool for an instance with `CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects//locations//caPools/ "sslMode": "A String", # Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections. }, "kind": "A String", # This is always `sql#settings`. @@ -4895,6 +4993,9 @@Method Details
"A String", ], "switchTransactionLogsToCloudStorageEnabled": True or False, # Input only. Whether Cloud SQL is enabled to switch storing point-in-time recovery log files from a data disk to Cloud Storage. + "tags": { # Optional. Input only. Immutable. Tag keys and tag values that are bound to this instance. You must represent each item in the map as: `"" : ""`. For example, a single resource can have the following tags: ``` "123/environment": "production", "123/costCenter": "marketing", ``` For more information on tag creation and management, see https://cloud.google.com/resource-manager/docs/tags/tags-overview. + "a_key": "A String", + }, "upgradableDatabaseVersions": [ # Output only. All database versions that are available for upgrade. { # An available database version. It can be a major or a minor version. "displayName": "A String", # The database version's display name. @@ -5025,6 +5126,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. diff --git a/docs/dyn/sqladmin_v1.operations.html b/docs/dyn/sqladmin_v1.operations.html index 6517699c57..fb1be4aefa 100644 --- a/docs/dyn/sqladmin_v1.operations.html +++ b/docs/dyn/sqladmin_v1.operations.html @@ -241,6 +241,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -379,6 +382,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. diff --git a/docs/dyn/sqladmin_v1.projects.instances.html b/docs/dyn/sqladmin_v1.projects.instances.html index e2796e8bba..246d230869 100644 --- a/docs/dyn/sqladmin_v1.projects.instances.html +++ b/docs/dyn/sqladmin_v1.projects.instances.html @@ -281,6 +281,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -425,6 +428,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -565,6 +571,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -717,6 +726,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. diff --git a/docs/dyn/sqladmin_v1.sslCerts.html b/docs/dyn/sqladmin_v1.sslCerts.html index 2e6a4c3f6b..28522b997f 100644 --- a/docs/dyn/sqladmin_v1.sslCerts.html +++ b/docs/dyn/sqladmin_v1.sslCerts.html @@ -262,6 +262,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -448,6 +451,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. diff --git a/docs/dyn/sqladmin_v1.users.html b/docs/dyn/sqladmin_v1.users.html index 7e796b4e12..baf8b0239a 100644 --- a/docs/dyn/sqladmin_v1.users.html +++ b/docs/dyn/sqladmin_v1.users.html @@ -227,6 +227,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -438,6 +441,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -655,6 +661,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. diff --git a/docs/dyn/sqladmin_v1beta4.backupRuns.html b/docs/dyn/sqladmin_v1beta4.backupRuns.html index 9a09281e9d..64b2652af2 100644 --- a/docs/dyn/sqladmin_v1beta4.backupRuns.html +++ b/docs/dyn/sqladmin_v1beta4.backupRuns.html @@ -226,6 +226,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -442,6 +445,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. diff --git a/docs/dyn/sqladmin_v1beta4.connect.html b/docs/dyn/sqladmin_v1beta4.connect.html index c56b9f5ea1..239390ff3b 100644 --- a/docs/dyn/sqladmin_v1beta4.connect.html +++ b/docs/dyn/sqladmin_v1beta4.connect.html @@ -147,6 +147,9 @@Method Details
{ # Connect settings retrieval response. "backendType": "A String", # `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. + "customSubjectAlternativeNames": [ # Custom subject alternative names for the server certificate. + "A String", + ], "databaseVersion": "A String", # 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`. "dnsName": "A String", # The dns name of the instance. "ipAddresses": [ # The assigned IP addresses for the instance. diff --git a/docs/dyn/sqladmin_v1beta4.databases.html b/docs/dyn/sqladmin_v1beta4.databases.html index e4f7e27486..3e3fb46d22 100644 --- a/docs/dyn/sqladmin_v1beta4.databases.html +++ b/docs/dyn/sqladmin_v1beta4.databases.html @@ -229,6 +229,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -413,6 +416,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -602,6 +608,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -755,6 +764,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. diff --git a/docs/dyn/sqladmin_v1beta4.instances.html b/docs/dyn/sqladmin_v1beta4.instances.html index c65e86732a..7ddd350d23 100644 --- a/docs/dyn/sqladmin_v1beta4.instances.html +++ b/docs/dyn/sqladmin_v1beta4.instances.html @@ -160,7 +160,7 @@Instance Methods
Stops the replication in the read replica instance.
-
switchover(project, instance, dbTimeout=None, x__xgafv=None)
Switches over from the primary instance to the designated DR replica instance.
+Switches over from the primary instance to the DR replica instance.
truncateLog(project, instance, body=None, x__xgafv=None)
Truncate MySQL general and slow query log tables MySQL only.
@@ -352,6 +352,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -518,6 +521,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -652,6 +658,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -809,6 +818,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -948,6 +960,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -1092,6 +1107,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -1249,6 +1267,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -1429,6 +1450,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -1573,6 +1597,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -1692,10 +1719,10 @@Method Details
"replicaNames": [ # The replicas of the instance. "A String", ], - "replicationCluster": { # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Only applicable to MySQL. # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL. + "replicationCluster": { # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Applicable to MySQL and PostgreSQL. # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Applicable to MySQL and PostgreSQL. "drReplica": True or False, # Output only. Read-only field that indicates whether the replica is a DR replica. This field is not set if the instance is a primary instance. "failoverDrReplicaName": "A String", # Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Set this field to a replica name to designate a DR replica for a primary instance. Remove the replica name to remove the DR replica designation. - "psaWriteEndpoint": "A String", # Output only. If set, it indicates this instance has a private service access (PSA) dns endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, the dns should be pointing to this instance. After Switchover or Replica failover, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance does not yet have a replica, or had a DR replica that was deleted. + "psaWriteEndpoint": "A String", # Output only. If set, this field indicates this instance has a private service access (PSA) DNS endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, then the DNS endpoint points to this instance. After a switchover or replica failover operation, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance doesn't have a DR replica yet or the DR replica is deleted. }, "rootPassword": "A String", # Initial root password. Use only on creation. You must set root passwords before you can connect to PostgreSQL instances. "satisfiesPzi": True or False, # Output only. This status indicates whether the instance satisfies PZI. The status is reserved for future use. @@ -1791,6 +1818,9 @@Method Details
"value": "A String", # The allowlisted value for the access control list. }, ], + "customSubjectAlternativeNames": [ # Optional. Custom Subject Alternative Name(SAN)s for a Cloud SQL instance. + "A String", + ], "enablePrivatePathForGoogleCloudServices": True or False, # Controls connectivity to private IP instances from Google services, such as BigQuery. "ipv4Enabled": True or False, # Whether the instance is assigned a public IP address or not. "privateNetwork": "A String", # 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. @@ -1811,6 +1841,7 @@Method Details
}, "requireSsl": True or False, # Use `ssl_mode` instead. Whether SSL/TLS connections over IP are enforced. If set to false, then allow both non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the client certificate won't be verified. If set to true, then only allow connections encrypted with SSL/TLS and with valid client certificates. If you want to enforce SSL/TLS without enforcing the requirement for valid client certificates, then use the `ssl_mode` flag instead of the legacy `require_ssl` flag. "serverCaMode": "A String", # Specify what type of CA is used for the server certificate. + "serverCaPool": "A String", # Optional. The resource name of the server CA pool for an instance with `CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects//locations//caPools/ "sslMode": "A String", # Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections. }, "kind": "A String", # This is always `sql#settings`. @@ -1858,6 +1889,9 @@Method Details
"A String", ], "switchTransactionLogsToCloudStorageEnabled": True or False, # Input only. Whether Cloud SQL is enabled to switch storing point-in-time recovery log files from a data disk to Cloud Storage. + "tags": { # Optional. Input only. Immutable. Tag keys and tag values that are bound to this instance. You must represent each item in the map as: `"" : ""`. For example, a single resource can have the following tags: ``` "123/environment": "production", "123/costCenter": "marketing", ``` For more information on tag creation and management, see https://cloud.google.com/resource-manager/docs/tags/tags-overview. + "a_key": "A String", + }, "upgradableDatabaseVersions": [ # Output only. All database versions that are available for upgrade. { # An available database version. It can be a major or a minor version. "displayName": "A String", # The database version's display name. @@ -2040,6 +2074,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -2153,10 +2190,10 @@Method Details
"replicaNames": [ # The replicas of the instance. "A String", ], - "replicationCluster": { # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Only applicable to MySQL. # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL. + "replicationCluster": { # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Applicable to MySQL and PostgreSQL. # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Applicable to MySQL and PostgreSQL. "drReplica": True or False, # Output only. Read-only field that indicates whether the replica is a DR replica. This field is not set if the instance is a primary instance. "failoverDrReplicaName": "A String", # Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Set this field to a replica name to designate a DR replica for a primary instance. Remove the replica name to remove the DR replica designation. - "psaWriteEndpoint": "A String", # Output only. If set, it indicates this instance has a private service access (PSA) dns endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, the dns should be pointing to this instance. After Switchover or Replica failover, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance does not yet have a replica, or had a DR replica that was deleted. + "psaWriteEndpoint": "A String", # Output only. If set, this field indicates this instance has a private service access (PSA) DNS endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, then the DNS endpoint points to this instance. After a switchover or replica failover operation, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance doesn't have a DR replica yet or the DR replica is deleted. }, "rootPassword": "A String", # Initial root password. Use only on creation. You must set root passwords before you can connect to PostgreSQL instances. "satisfiesPzi": True or False, # Output only. This status indicates whether the instance satisfies PZI. The status is reserved for future use. @@ -2252,6 +2289,9 @@Method Details
"value": "A String", # The allowlisted value for the access control list. }, ], + "customSubjectAlternativeNames": [ # Optional. Custom Subject Alternative Name(SAN)s for a Cloud SQL instance. + "A String", + ], "enablePrivatePathForGoogleCloudServices": True or False, # Controls connectivity to private IP instances from Google services, such as BigQuery. "ipv4Enabled": True or False, # Whether the instance is assigned a public IP address or not. "privateNetwork": "A String", # 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. @@ -2272,6 +2312,7 @@Method Details
}, "requireSsl": True or False, # Use `ssl_mode` instead. Whether SSL/TLS connections over IP are enforced. If set to false, then allow both non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the client certificate won't be verified. If set to true, then only allow connections encrypted with SSL/TLS and with valid client certificates. If you want to enforce SSL/TLS without enforcing the requirement for valid client certificates, then use the `ssl_mode` flag instead of the legacy `require_ssl` flag. "serverCaMode": "A String", # Specify what type of CA is used for the server certificate. + "serverCaPool": "A String", # Optional. The resource name of the server CA pool for an instance with `CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects//locations//caPools/ "sslMode": "A String", # Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections. }, "kind": "A String", # This is always `sql#settings`. @@ -2319,6 +2360,9 @@Method Details
"A String", ], "switchTransactionLogsToCloudStorageEnabled": True or False, # Input only. Whether Cloud SQL is enabled to switch storing point-in-time recovery log files from a data disk to Cloud Storage. + "tags": { # Optional. Input only. Immutable. Tag keys and tag values that are bound to this instance. You must represent each item in the map as: `"" : ""`. For example, a single resource can have the following tags: ``` "123/environment": "production", "123/costCenter": "marketing", ``` For more information on tag creation and management, see https://cloud.google.com/resource-manager/docs/tags/tags-overview. + "a_key": "A String", + }, "upgradableDatabaseVersions": [ # Output only. All database versions that are available for upgrade. { # An available database version. It can be a major or a minor version. "displayName": "A String", # The database version's display name. @@ -2449,6 +2493,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -2572,10 +2619,10 @@Method Details
"replicaNames": [ # The replicas of the instance. "A String", ], - "replicationCluster": { # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Only applicable to MySQL. # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL. + "replicationCluster": { # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Applicable to MySQL and PostgreSQL. # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Applicable to MySQL and PostgreSQL. "drReplica": True or False, # Output only. Read-only field that indicates whether the replica is a DR replica. This field is not set if the instance is a primary instance. "failoverDrReplicaName": "A String", # Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Set this field to a replica name to designate a DR replica for a primary instance. Remove the replica name to remove the DR replica designation. - "psaWriteEndpoint": "A String", # Output only. If set, it indicates this instance has a private service access (PSA) dns endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, the dns should be pointing to this instance. After Switchover or Replica failover, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance does not yet have a replica, or had a DR replica that was deleted. + "psaWriteEndpoint": "A String", # Output only. If set, this field indicates this instance has a private service access (PSA) DNS endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, then the DNS endpoint points to this instance. After a switchover or replica failover operation, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance doesn't have a DR replica yet or the DR replica is deleted. }, "rootPassword": "A String", # Initial root password. Use only on creation. You must set root passwords before you can connect to PostgreSQL instances. "satisfiesPzi": True or False, # Output only. This status indicates whether the instance satisfies PZI. The status is reserved for future use. @@ -2671,6 +2718,9 @@Method Details
"value": "A String", # The allowlisted value for the access control list. }, ], + "customSubjectAlternativeNames": [ # Optional. Custom Subject Alternative Name(SAN)s for a Cloud SQL instance. + "A String", + ], "enablePrivatePathForGoogleCloudServices": True or False, # Controls connectivity to private IP instances from Google services, such as BigQuery. "ipv4Enabled": True or False, # Whether the instance is assigned a public IP address or not. "privateNetwork": "A String", # 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. @@ -2691,6 +2741,7 @@Method Details
}, "requireSsl": True or False, # Use `ssl_mode` instead. Whether SSL/TLS connections over IP are enforced. If set to false, then allow both non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the client certificate won't be verified. If set to true, then only allow connections encrypted with SSL/TLS and with valid client certificates. If you want to enforce SSL/TLS without enforcing the requirement for valid client certificates, then use the `ssl_mode` flag instead of the legacy `require_ssl` flag. "serverCaMode": "A String", # Specify what type of CA is used for the server certificate. + "serverCaPool": "A String", # Optional. The resource name of the server CA pool for an instance with `CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects//locations//caPools/ "sslMode": "A String", # Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections. }, "kind": "A String", # This is always `sql#settings`. @@ -2738,6 +2789,9 @@Method Details
"A String", ], "switchTransactionLogsToCloudStorageEnabled": True or False, # Input only. Whether Cloud SQL is enabled to switch storing point-in-time recovery log files from a data disk to Cloud Storage. + "tags": { # Optional. Input only. Immutable. Tag keys and tag values that are bound to this instance. You must represent each item in the map as: `"" : ""`. For example, a single resource can have the following tags: ``` "123/environment": "production", "123/costCenter": "marketing", ``` For more information on tag creation and management, see https://cloud.google.com/resource-manager/docs/tags/tags-overview. + "a_key": "A String", + }, "upgradableDatabaseVersions": [ # Output only. All database versions that are available for upgrade. { # An available database version. It can be a major or a minor version. "displayName": "A String", # The database version's display name. @@ -2915,10 +2969,10 @@Method Details
"replicaNames": [ # The replicas of the instance. "A String", ], - "replicationCluster": { # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Only applicable to MySQL. # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL. + "replicationCluster": { # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Applicable to MySQL and PostgreSQL. # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Applicable to MySQL and PostgreSQL. "drReplica": True or False, # Output only. Read-only field that indicates whether the replica is a DR replica. This field is not set if the instance is a primary instance. "failoverDrReplicaName": "A String", # Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Set this field to a replica name to designate a DR replica for a primary instance. Remove the replica name to remove the DR replica designation. - "psaWriteEndpoint": "A String", # Output only. If set, it indicates this instance has a private service access (PSA) dns endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, the dns should be pointing to this instance. After Switchover or Replica failover, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance does not yet have a replica, or had a DR replica that was deleted. + "psaWriteEndpoint": "A String", # Output only. If set, this field indicates this instance has a private service access (PSA) DNS endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, then the DNS endpoint points to this instance. After a switchover or replica failover operation, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance doesn't have a DR replica yet or the DR replica is deleted. }, "rootPassword": "A String", # Initial root password. Use only on creation. You must set root passwords before you can connect to PostgreSQL instances. "satisfiesPzi": True or False, # Output only. This status indicates whether the instance satisfies PZI. The status is reserved for future use. @@ -3014,6 +3068,9 @@Method Details
"value": "A String", # The allowlisted value for the access control list. }, ], + "customSubjectAlternativeNames": [ # Optional. Custom Subject Alternative Name(SAN)s for a Cloud SQL instance. + "A String", + ], "enablePrivatePathForGoogleCloudServices": True or False, # Controls connectivity to private IP instances from Google services, such as BigQuery. "ipv4Enabled": True or False, # Whether the instance is assigned a public IP address or not. "privateNetwork": "A String", # 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. @@ -3034,6 +3091,7 @@Method Details
}, "requireSsl": True or False, # Use `ssl_mode` instead. Whether SSL/TLS connections over IP are enforced. If set to false, then allow both non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the client certificate won't be verified. If set to true, then only allow connections encrypted with SSL/TLS and with valid client certificates. If you want to enforce SSL/TLS without enforcing the requirement for valid client certificates, then use the `ssl_mode` flag instead of the legacy `require_ssl` flag. "serverCaMode": "A String", # Specify what type of CA is used for the server certificate. + "serverCaPool": "A String", # Optional. The resource name of the server CA pool for an instance with `CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects//locations//caPools/ "sslMode": "A String", # Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections. }, "kind": "A String", # This is always `sql#settings`. @@ -3081,6 +3139,9 @@Method Details
"A String", ], "switchTransactionLogsToCloudStorageEnabled": True or False, # Input only. Whether Cloud SQL is enabled to switch storing point-in-time recovery log files from a data disk to Cloud Storage. + "tags": { # Optional. Input only. Immutable. Tag keys and tag values that are bound to this instance. You must represent each item in the map as: `"" : ""`. For example, a single resource can have the following tags: ``` "123/environment": "production", "123/costCenter": "marketing", ``` For more information on tag creation and management, see https://cloud.google.com/resource-manager/docs/tags/tags-overview. + "a_key": "A String", + }, "upgradableDatabaseVersions": [ # Output only. All database versions that are available for upgrade. { # An available database version. It can be a major or a minor version. "displayName": "A String", # The database version's display name. @@ -3211,6 +3272,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -3225,7 +3289,7 @@Method Details
Args: project: string, ID of the project that contains the read replica. (required) instance: string, Cloud SQL read replica instance name. (required) - failover: boolean, Set to true to invoke a replica failover to the designated DR replica. As part of replica failover, the promote operation attempts to add the original primary instance as a replica of the promoted DR replica when the original primary instance comes back online. If set to false or not specified, then the original primary instance becomes an independent Cloud SQL primary instance. Only applicable to MySQL. + failover: boolean, Set to true to invoke a replica failover to the DR replica. As part of replica failover, the promote operation attempts to add the original primary instance as a replica of the promoted DR replica when the original primary instance comes back online. If set to false or not specified, then the original primary instance becomes an independent Cloud SQL primary instance. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -3346,6 +3410,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -3490,6 +3557,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -3644,6 +3714,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -3778,6 +3851,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -3924,6 +4000,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -4068,6 +4147,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -4202,6 +4284,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -4336,6 +4421,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -4345,12 +4433,12 @@Method Details
switchover(project, instance, dbTimeout=None, x__xgafv=None)
-Switches over from the primary instance to the designated DR replica instance. +Switches over from the primary instance to the DR replica instance. Args: project: string, ID of the project that contains the replica. (required) instance: string, Cloud SQL read replica instance name. (required) - dbTimeout: string, Optional. (MySQL only) Cloud SQL instance operations timeout, which is a sum of all database operations. Default value is 10 minutes and can be modified to a maximum value of 24 hours. + dbTimeout: string, Optional. (MySQL and PostgreSQL only) Cloud SQL instance operations timeout, which is a sum of all database operations. Default value is 10 minutes and can be modified to a maximum value of 24 hours. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -4471,6 +4559,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -4615,6 +4706,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -4729,10 +4823,10 @@Method Details
"replicaNames": [ # The replicas of the instance. "A String", ], - "replicationCluster": { # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Only applicable to MySQL. # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL. + "replicationCluster": { # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Applicable to MySQL and PostgreSQL. # A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Applicable to MySQL and PostgreSQL. "drReplica": True or False, # Output only. Read-only field that indicates whether the replica is a DR replica. This field is not set if the instance is a primary instance. "failoverDrReplicaName": "A String", # Optional. If the instance is a primary instance, then this field identifies the disaster recovery (DR) replica. A DR replica is an optional configuration for Enterprise Plus edition instances. If the instance is a read replica, then the field is not set. Set this field to a replica name to designate a DR replica for a primary instance. Remove the replica name to remove the DR replica designation. - "psaWriteEndpoint": "A String", # Output only. If set, it indicates this instance has a private service access (PSA) dns endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, the dns should be pointing to this instance. After Switchover or Replica failover, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance does not yet have a replica, or had a DR replica that was deleted. + "psaWriteEndpoint": "A String", # Output only. If set, this field indicates this instance has a private service access (PSA) DNS endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, then the DNS endpoint points to this instance. After a switchover or replica failover operation, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance doesn't have a DR replica yet or the DR replica is deleted. }, "rootPassword": "A String", # Initial root password. Use only on creation. You must set root passwords before you can connect to PostgreSQL instances. "satisfiesPzi": True or False, # Output only. This status indicates whether the instance satisfies PZI. The status is reserved for future use. @@ -4828,6 +4922,9 @@Method Details
"value": "A String", # The allowlisted value for the access control list. }, ], + "customSubjectAlternativeNames": [ # Optional. Custom Subject Alternative Name(SAN)s for a Cloud SQL instance. + "A String", + ], "enablePrivatePathForGoogleCloudServices": True or False, # Controls connectivity to private IP instances from Google services, such as BigQuery. "ipv4Enabled": True or False, # Whether the instance is assigned a public IP address or not. "privateNetwork": "A String", # 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. @@ -4848,6 +4945,7 @@Method Details
}, "requireSsl": True or False, # Use `ssl_mode` instead. Whether SSL/TLS connections over IP are enforced. If set to false, then allow both non-SSL/non-TLS and SSL/TLS connections. For SSL/TLS connections, the client certificate won't be verified. If set to true, then only allow connections encrypted with SSL/TLS and with valid client certificates. If you want to enforce SSL/TLS without enforcing the requirement for valid client certificates, then use the `ssl_mode` flag instead of the legacy `require_ssl` flag. "serverCaMode": "A String", # Specify what type of CA is used for the server certificate. + "serverCaPool": "A String", # Optional. The resource name of the server CA pool for an instance with `CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects//locations//caPools/ "sslMode": "A String", # Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections. }, "kind": "A String", # This is always `sql#settings`. @@ -4895,6 +4993,9 @@Method Details
"A String", ], "switchTransactionLogsToCloudStorageEnabled": True or False, # Input only. Whether Cloud SQL is enabled to switch storing point-in-time recovery log files from a data disk to Cloud Storage. + "tags": { # Optional. Input only. Immutable. Tag keys and tag values that are bound to this instance. You must represent each item in the map as: `"" : ""`. For example, a single resource can have the following tags: ``` "123/environment": "production", "123/costCenter": "marketing", ``` For more information on tag creation and management, see https://cloud.google.com/resource-manager/docs/tags/tags-overview. + "a_key": "A String", + }, "upgradableDatabaseVersions": [ # Output only. All database versions that are available for upgrade. { # An available database version. It can be a major or a minor version. "displayName": "A String", # The database version's display name. @@ -5025,6 +5126,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. diff --git a/docs/dyn/sqladmin_v1beta4.operations.html b/docs/dyn/sqladmin_v1beta4.operations.html index b852bcb8c5..f4746fdea0 100644 --- a/docs/dyn/sqladmin_v1beta4.operations.html +++ b/docs/dyn/sqladmin_v1beta4.operations.html @@ -241,6 +241,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -379,6 +382,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. diff --git a/docs/dyn/sqladmin_v1beta4.projects.instances.html b/docs/dyn/sqladmin_v1beta4.projects.instances.html index 0fa764266b..8739bcb344 100644 --- a/docs/dyn/sqladmin_v1beta4.projects.instances.html +++ b/docs/dyn/sqladmin_v1beta4.projects.instances.html @@ -281,6 +281,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -425,6 +428,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -565,6 +571,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -717,6 +726,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. diff --git a/docs/dyn/sqladmin_v1beta4.sslCerts.html b/docs/dyn/sqladmin_v1beta4.sslCerts.html index 76e5f54720..e43191d3be 100644 --- a/docs/dyn/sqladmin_v1beta4.sslCerts.html +++ b/docs/dyn/sqladmin_v1beta4.sslCerts.html @@ -262,6 +262,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -448,6 +451,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. diff --git a/docs/dyn/sqladmin_v1beta4.users.html b/docs/dyn/sqladmin_v1beta4.users.html index 0861689ffe..ba47958255 100644 --- a/docs/dyn/sqladmin_v1beta4.users.html +++ b/docs/dyn/sqladmin_v1beta4.users.html @@ -227,6 +227,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -438,6 +441,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. @@ -655,6 +661,9 @@Method Details
"selfLink": "A String", # The URI of this resource. "startTime": "A String", # 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`. "status": "A String", # The status of an operation. + "subOperationType": { # The sub operation type based on the operation type. # Optional. The sub operation based on the operation type. + "maintenanceType": "A String", # The type of maintenance to be performed on the instance. + }, "targetId": "A String", # Name of the database instance related to this operation. "targetLink": "A String", "targetProject": "A String", # The project ID of the target instance related to this operation. diff --git a/googleapiclient/discovery_cache/documents/sqladmin.v1.json b/googleapiclient/discovery_cache/documents/sqladmin.v1.json index 9528e7183f..8c56935f39 100644 --- a/googleapiclient/discovery_cache/documents/sqladmin.v1.json +++ b/googleapiclient/discovery_cache/documents/sqladmin.v1.json @@ -1193,7 +1193,7 @@ ], "parameters": { "failover": { -"description": "Set to true to invoke a replica failover to the designated DR replica. As part of replica failover, the promote operation attempts to add the original primary instance as a replica of the promoted DR replica when the original primary instance comes back online. If set to false or not specified, then the original primary instance becomes an independent Cloud SQL primary instance. Only applicable to MySQL.", +"description": "Set to true to invoke a replica failover to the DR replica. As part of replica failover, the promote operation attempts to add the original primary instance as a replica of the promoted DR replica when the original primary instance comes back online. If set to false or not specified, then the original primary instance becomes an independent Cloud SQL primary instance.", "location": "query", "type": "boolean" }, @@ -1485,7 +1485,7 @@ ] }, "switchover": { -"description": "Switches over from the primary instance to the designated DR replica instance.", +"description": "Switches over from the primary instance to the DR replica instance.", "flatPath": "v1/projects/{project}/instances/{instance}/switchover", "httpMethod": "POST", "id": "sql.instances.switchover", @@ -1495,7 +1495,7 @@ ], "parameters": { "dbTimeout": { -"description": "Optional. (MySQL only) Cloud SQL instance operations timeout, which is a sum of all database operations. Default value is 10 minutes and can be modified to a maximum value of 24 hours.", +"description": "Optional. (MySQL and PostgreSQL only) Cloud SQL instance operations timeout, which is a sum of all database operations. Default value is 10 minutes and can be modified to a maximum value of 24 hours.", "format": "google-duration", "location": "query", "type": "string" @@ -2366,7 +2366,7 @@ } } }, -"revision": "20241108", +"revision": "20241204", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2856,6 +2856,13 @@ false ], "type": "string" }, +"customSubjectAlternativeNames": { +"description": "Custom subject alternative names for the server certificate.", +"items": { +"type": "string" +}, +"type": "array" +}, "databaseVersion": { "description": "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`, `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`.", "enum": [ @@ -3448,7 +3455,7 @@ false }, "replicationCluster": { "$ref": "ReplicationCluster", -"description": "Optional. A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL." +"description": "Optional. A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Applicable to MySQL and PostgreSQL." }, "rootPassword": { "description": "Initial root password. Use only on creation. You must set root passwords before you can connect to PostgreSQL instances.", @@ -3559,6 +3566,13 @@ true "description": "Input only. Whether Cloud SQL is enabled to switch storing point-in-time recovery log files from a data disk to Cloud Storage.", "type": "boolean" }, +"tags": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Input only. Immutable. Tag keys and tag values that are bound to this instance. You must represent each item in the map as: `\"\" : \"\"`. For example, a single resource can have the following tags: ``` \"123/environment\": \"production\", \"123/costCenter\": \"marketing\", ``` For more information on tag creation and management, see https://cloud.google.com/resource-manager/docs/tags/tags-overview.", +"type": "object" +}, "upgradableDatabaseVersions": { "description": "Output only. All database versions that are available for upgrade.", "items": { @@ -4681,6 +4695,13 @@ false }, "type": "array" }, +"customSubjectAlternativeNames": { +"description": "Optional. Custom Subject Alternative Name(SAN)s for a Cloud SQL instance.", +"items": { +"type": "string" +}, +"type": "array" +}, "enablePrivatePathForGoogleCloudServices": { "description": "Controls connectivity to private IP instances from Google services, such as BigQuery.", "type": "boolean" @@ -4706,15 +4727,21 @@ false "enum": [ "CA_MODE_UNSPECIFIED", "GOOGLE_MANAGED_INTERNAL_CA", -"GOOGLE_MANAGED_CAS_CA" +"GOOGLE_MANAGED_CAS_CA", +"CUSTOMER_MANAGED_CAS_CA" ], "enumDescriptions": [ "CA mode is unspecified. It is effectively the same as `GOOGLE_MANAGED_INTERNAL_CA`.", "Google-managed self-signed internal CA.", -"Google-managed regional CA part of root CA hierarchy hosted on Google Cloud's Certificate Authority Service (CAS)." +"Google-managed regional CA part of root CA hierarchy hosted on Google Cloud's Certificate Authority Service (CAS).", +"Customer-managed CA hosted on Google Cloud's Certificate Authority Service (CAS)." ], "type": "string" }, +"serverCaPool": { +"description": "Optional. The resource name of the server CA pool for an instance with `CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects//locations//caPools/", +"type": "string" +}, "sslMode": { "description": "Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections.", "enum": [ @@ -5184,6 +5211,10 @@ false ], "type": "string" }, +"subOperationType": { +"$ref": "SqlSubOperationType", +"description": "Optional. The sub operation based on the operation type." +}, "targetId": { "description": "Name of the database instance related to this operation.", "type": "string" @@ -5249,7 +5280,7 @@ false "type": "string" }, "cancelRequested": { -"description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", +"description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have google.longrunning.Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "readOnly": true, "type": "boolean" }, @@ -5456,7 +5487,7 @@ false "type": "object" }, "ReplicationCluster": { -"description": "A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL.", +"description": "A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Applicable to MySQL and PostgreSQL.", "id": "ReplicationCluster", "properties": { "drReplica": { @@ -5469,7 +5500,7 @@ false "type": "string" }, "psaWriteEndpoint": { -"description": "Output only. If set, it indicates this instance has a private service access (PSA) dns endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, the dns should be pointing to this instance. After Switchover or Replica failover, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance does not yet have a replica, or had a DR replica that was deleted.", +"description": "Output only. If set, this field indicates this instance has a private service access (PSA) DNS endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, then the DNS endpoint points to this instance. After a switchover or replica failover operation, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance doesn't have a DR replica yet or the DR replica is deleted.", "readOnly": true, "type": "string" } @@ -6300,6 +6331,31 @@ true }, "type": "object" }, +"SqlSubOperationType": { +"description": "The sub operation type based on the operation type.", +"id": "SqlSubOperationType", +"properties": { +"maintenanceType": { +"description": "The type of maintenance to be performed on the instance.", +"enum": [ +"SQL_MAINTENANCE_TYPE_UNSPECIFIED", +"INSTANCE_MAINTENANCE", +"REPLICA_INCLUDED_MAINTENANCE", +"INSTANCE_SELF_SERVICE_MAINTENANCE", +"REPLICA_INCLUDED_SELF_SERVICE_MAINTENANCE" +], +"enumDescriptions": [ +"Maintenance type is unspecified.", +"Indicates that a standalone instance is undergoing maintenance. The instance can be either a primary instance or a replica.", +"Indicates that the primary instance and all of its replicas, including cascading replicas, are undergoing maintenance. Maintenance is performed on groups of replicas first, followed by the primary instance.", +"Indicates that the standalone instance is undergoing maintenance, initiated by self-service. The instance can be either a primary instance or a replica.", +"Indicates that the primary instance and all of its replicas are undergoing maintenance, initiated by self-service. Maintenance is performed on groups of replicas first, followed by the primary instance." +], +"type": "string" +} +}, +"type": "object" +}, "SslCert": { "description": "SslCerts Resource", "id": "SslCert", diff --git a/googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json b/googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json index a652cd2a6b..8146456edd 100644 --- a/googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json +++ b/googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json @@ -1193,7 +1193,7 @@ ], "parameters": { "failover": { -"description": "Set to true to invoke a replica failover to the designated DR replica. As part of replica failover, the promote operation attempts to add the original primary instance as a replica of the promoted DR replica when the original primary instance comes back online. If set to false or not specified, then the original primary instance becomes an independent Cloud SQL primary instance. Only applicable to MySQL.", +"description": "Set to true to invoke a replica failover to the DR replica. As part of replica failover, the promote operation attempts to add the original primary instance as a replica of the promoted DR replica when the original primary instance comes back online. If set to false or not specified, then the original primary instance becomes an independent Cloud SQL primary instance.", "location": "query", "type": "boolean" }, @@ -1485,7 +1485,7 @@ ] }, "switchover": { -"description": "Switches over from the primary instance to the designated DR replica instance.", +"description": "Switches over from the primary instance to the DR replica instance.", "flatPath": "sql/v1beta4/projects/{project}/instances/{instance}/switchover", "httpMethod": "POST", "id": "sql.instances.switchover", @@ -1495,7 +1495,7 @@ ], "parameters": { "dbTimeout": { -"description": "Optional. (MySQL only) Cloud SQL instance operations timeout, which is a sum of all database operations. Default value is 10 minutes and can be modified to a maximum value of 24 hours.", +"description": "Optional. (MySQL and PostgreSQL only) Cloud SQL instance operations timeout, which is a sum of all database operations. Default value is 10 minutes and can be modified to a maximum value of 24 hours.", "format": "google-duration", "location": "query", "type": "string" @@ -2366,7 +2366,7 @@ } } }, -"revision": "20241108", +"revision": "20241204", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2856,6 +2856,13 @@ false ], "type": "string" }, +"customSubjectAlternativeNames": { +"description": "Custom subject alternative names for the server certificate.", +"items": { +"type": "string" +}, +"type": "array" +}, "databaseVersion": { "description": "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`.", "enum": [ @@ -3448,7 +3455,7 @@ false }, "replicationCluster": { "$ref": "ReplicationCluster", -"description": "A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Only applicable to MySQL." +"description": "A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance experiences regional failure. Applicable to MySQL and PostgreSQL." }, "rootPassword": { "description": "Initial root password. Use only on creation. You must set root passwords before you can connect to PostgreSQL instances.", @@ -3560,6 +3567,13 @@ true "description": "Input only. Whether Cloud SQL is enabled to switch storing point-in-time recovery log files from a data disk to Cloud Storage.", "type": "boolean" }, +"tags": { +"additionalProperties": { +"type": "string" +}, +"description": "Optional. Input only. Immutable. Tag keys and tag values that are bound to this instance. You must represent each item in the map as: `\"\" : \"\"`. For example, a single resource can have the following tags: ``` \"123/environment\": \"production\", \"123/costCenter\": \"marketing\", ``` For more information on tag creation and management, see https://cloud.google.com/resource-manager/docs/tags/tags-overview.", +"type": "object" +}, "upgradableDatabaseVersions": { "description": "Output only. All database versions that are available for upgrade.", "items": { @@ -4682,6 +4696,13 @@ false }, "type": "array" }, +"customSubjectAlternativeNames": { +"description": "Optional. Custom Subject Alternative Name(SAN)s for a Cloud SQL instance.", +"items": { +"type": "string" +}, +"type": "array" +}, "enablePrivatePathForGoogleCloudServices": { "description": "Controls connectivity to private IP instances from Google services, such as BigQuery.", "type": "boolean" @@ -4707,15 +4728,21 @@ false "enum": [ "CA_MODE_UNSPECIFIED", "GOOGLE_MANAGED_INTERNAL_CA", -"GOOGLE_MANAGED_CAS_CA" +"GOOGLE_MANAGED_CAS_CA", +"CUSTOMER_MANAGED_CAS_CA" ], "enumDescriptions": [ "CA mode is unspecified. It is effectively the same as `GOOGLE_MANAGED_INTERNAL_CA`.", "Google-managed self-signed internal CA.", -"Google-managed regional CA part of root CA hierarchy hosted on Google Cloud's Certificate Authority Service (CAS)." +"Google-managed regional CA part of root CA hierarchy hosted on Google Cloud's Certificate Authority Service (CAS).", +"Customer-managed CA hosted on Google Cloud's Certificate Authority Service (CAS)." ], "type": "string" }, +"serverCaPool": { +"description": "Optional. The resource name of the server CA pool for an instance with `CUSTOMER_MANAGED_CAS_CA` as the `server_ca_mode`. Format: projects//locations//caPools/", +"type": "string" +}, "sslMode": { "description": "Specify how SSL/TLS is enforced in database connections. If you must use the `require_ssl` flag for backward compatibility, then only the following value pairs are valid: For PostgreSQL and MySQL: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false` * `ssl_mode=TRUSTED_CLIENT_CERTIFICATE_REQUIRED` and `require_ssl=true` For SQL Server: * `ssl_mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED` and `require_ssl=false` * `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=true` The value of `ssl_mode` has priority over the value of `require_ssl`. For example, for the pair `ssl_mode=ENCRYPTED_ONLY` and `require_ssl=false`, `ssl_mode=ENCRYPTED_ONLY` means accept only SSL connections, while `require_ssl=false` means accept both non-SSL and SSL connections. In this case, MySQL and PostgreSQL databases respect `ssl_mode` and accepts only SSL connections.", "enum": [ @@ -5185,6 +5212,10 @@ false ], "type": "string" }, +"subOperationType": { +"$ref": "SqlSubOperationType", +"description": "Optional. The sub operation based on the operation type." +}, "targetId": { "description": "Name of the database instance related to this operation.", "type": "string" @@ -5250,7 +5281,7 @@ false "type": "string" }, "cancelRequested": { -"description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.", +"description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have google.longrunning.Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "readOnly": true, "type": "boolean" }, @@ -5457,7 +5488,7 @@ false "type": "object" }, "ReplicationCluster": { -"description": "A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Only applicable to MySQL.", +"description": "A primary instance and disaster recovery (DR) replica pair. A DR replica is a cross-region replica that you designate for failover in the event that the primary instance has regional failure. Applicable to MySQL and PostgreSQL.", "id": "ReplicationCluster", "properties": { "drReplica": { @@ -5470,7 +5501,7 @@ false "type": "string" }, "psaWriteEndpoint": { -"description": "Output only. If set, it indicates this instance has a private service access (PSA) dns endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, the dns should be pointing to this instance. After Switchover or Replica failover, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance does not yet have a replica, or had a DR replica that was deleted.", +"description": "Output only. If set, this field indicates this instance has a private service access (PSA) DNS endpoint that is pointing to the primary instance of the cluster. If this instance is the primary, then the DNS endpoint points to this instance. After a switchover or replica failover operation, this DNS endpoint points to the promoted instance. This is a read-only field, returned to the user as information. This field can exist even if a standalone instance doesn't have a DR replica yet or the DR replica is deleted.", "readOnly": true, "type": "string" } @@ -6299,6 +6330,31 @@ true }, "type": "object" }, +"SqlSubOperationType": { +"description": "The sub operation type based on the operation type.", +"id": "SqlSubOperationType", +"properties": { +"maintenanceType": { +"description": "The type of maintenance to be performed on the instance.", +"enum": [ +"SQL_MAINTENANCE_TYPE_UNSPECIFIED", +"INSTANCE_MAINTENANCE", +"REPLICA_INCLUDED_MAINTENANCE", +"INSTANCE_SELF_SERVICE_MAINTENANCE", +"REPLICA_INCLUDED_SELF_SERVICE_MAINTENANCE" +], +"enumDescriptions": [ +"Maintenance type is unspecified.", +"Indicates that a standalone instance is undergoing maintenance. The instance can be either a primary instance or a replica.", +"Indicates that the primary instance and all of its replicas, including cascading replicas, are undergoing maintenance. Maintenance is performed on groups of replicas first, followed by the primary instance.", +"Indicates that the standalone instance is undergoing maintenance, initiated by self-service. The instance can be either a primary instance or a replica.", +"Indicates that the primary instance and all of its replicas are undergoing maintenance, initiated by self-service. Maintenance is performed on groups of replicas first, followed by the primary instance." +], +"type": "string" +} +}, +"type": "object" +}, "SslCert": { "description": "SslCerts Resource", "id": "SslCert",