diff --git a/docs/dyn/sqladmin_v1.instances.html b/docs/dyn/sqladmin_v1.instances.html index cddc77734e6..575e2e87f59 100644 --- a/docs/dyn/sqladmin_v1.instances.html +++ b/docs/dyn/sqladmin_v1.instances.html @@ -277,6 +277,7 @@
getDiskShrinkConfig(project, instance, x__xgafv=None)
Get Disk Shrink Config for a given instance.
+
+ getLatestRecoveryTime(project, instance, x__xgafv=None)
Get Latest Recovery Time for a given instance.
performDiskShrink(project, instance, body=None, x__xgafv=None)
Perform Disk Shrink on primary instance.
@@ -123,6 +126,27 @@getLatestRecoveryTime(project, instance, x__xgafv=None)
+ Get Latest Recovery Time for a given instance. + +Args: + project: string, Project ID of the project that contains the instance. (required) + instance: string, Cloud SQL instance ID. This does not include the project ID. (required) + x__xgafv: string, V1 error format. + Allowed values + 1 - v1 error format + 2 - v2 error format + +Returns: + An object of the form: + + { # Instance get latest recovery time response. + "kind": "A String", # This is always `sql#getLatestRecoveryTime`. + "latestRecoveryTime": "A String", # Timestamp, identifies the latest recovery time of the source instance. +}+
performDiskShrink(project, instance, body=None, x__xgafv=None)
Perform Disk Shrink on primary instance. diff --git a/docs/dyn/sqladmin_v1beta4.instances.html b/docs/dyn/sqladmin_v1beta4.instances.html index e5d8f904639..767af262ff5 100644 --- a/docs/dyn/sqladmin_v1beta4.instances.html +++ b/docs/dyn/sqladmin_v1beta4.instances.html @@ -277,6 +277,7 @@Method Details
"kind": "A String", # This is always `sql#cloneContext`. "pitrTimestampMs": "A String", # Reserved for future use. "pointInTime": "A String", # Timestamp, if specified, identifies the time to which the source instance is cloned. + "preferredZone": "A String", # Optional. (Point-in-time recovery for PostgreSQL only) Clone to an instance in the specified zone. If no zone is specified, clone to the same zone as the source instance. }, } @@ -1020,6 +1021,9 @@Method Details
"collation": "A String", # The name of server Instance collation. "connectorEnforcement": "A String", # Specifies if connections must use Cloud SQL connectors. Option values include the following: `NOT_REQUIRED` (Cloud SQL instances can be connected without Cloud SQL Connectors) and `REQUIRED` (Only allow connections that use Cloud SQL Connectors) Note that using REQUIRED disables all existing authorized networks. If this field is not specified when creating a new instance, NOT_REQUIRED is used. If this field is not specified when patching or updating an existing instance, it is left unchanged in the instance. "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property was only applicable to First Generation instances. + "dataCacheConfig": { # Data cache configurations. # Configuration for data cache. + "dataCacheEnabled": True or False, # Whether data cache is enabled for the instance. + }, "dataDiskSizeGb": "A String", # The size of data disk, in GB. The data disk size minimum is 10GB. "dataDiskType": "A String", # The type of data disk: `PD_SSD` (default) or `PD_HDD`. Not used for First Generation instances. "databaseFlags": [ # The database flags passed to the instance at startup. @@ -1037,6 +1041,7 @@Method Details
"time": "A String", # Time in UTC when the "deny maintenance period" starts on start_date and ends on end_date. The time is in format: HH:mm:SS, i.e., 00:00:00 }, ], + "edition": "A String", # Optional. The edition of the instance. "insightsConfig": { # Insights configuration. This specifies when Cloud SQL Insights feature is enabled and optional configuration. # Insights configuration, for now relevant only for Postgres. "queryInsightsEnabled": True or False, # Whether Query Insights feature is enabled. "queryPlansPerMinute": 42, # Number of query execution plans captured by Insights per minute for all queries combined. Default is 5. @@ -1383,6 +1388,9 @@Method Details
"collation": "A String", # The name of server Instance collation. "connectorEnforcement": "A String", # Specifies if connections must use Cloud SQL connectors. Option values include the following: `NOT_REQUIRED` (Cloud SQL instances can be connected without Cloud SQL Connectors) and `REQUIRED` (Only allow connections that use Cloud SQL Connectors) Note that using REQUIRED disables all existing authorized networks. If this field is not specified when creating a new instance, NOT_REQUIRED is used. If this field is not specified when patching or updating an existing instance, it is left unchanged in the instance. "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property was only applicable to First Generation instances. + "dataCacheConfig": { # Data cache configurations. # Configuration for data cache. + "dataCacheEnabled": True or False, # Whether data cache is enabled for the instance. + }, "dataDiskSizeGb": "A String", # The size of data disk, in GB. The data disk size minimum is 10GB. "dataDiskType": "A String", # The type of data disk: `PD_SSD` (default) or `PD_HDD`. Not used for First Generation instances. "databaseFlags": [ # The database flags passed to the instance at startup. @@ -1400,6 +1408,7 @@Method Details
"time": "A String", # Time in UTC when the "deny maintenance period" starts on start_date and ends on end_date. The time is in format: HH:mm:SS, i.e., 00:00:00 }, ], + "edition": "A String", # Optional. The edition of the instance. "insightsConfig": { # Insights configuration. This specifies when Cloud SQL Insights feature is enabled and optional configuration. # Insights configuration, for now relevant only for Postgres. "queryInsightsEnabled": True or False, # Whether Query Insights feature is enabled. "queryPlansPerMinute": 42, # Number of query execution plans captured by Insights per minute for all queries combined. Default is 5. @@ -1714,6 +1723,9 @@Method Details
"collation": "A String", # The name of server Instance collation. "connectorEnforcement": "A String", # Specifies if connections must use Cloud SQL connectors. Option values include the following: `NOT_REQUIRED` (Cloud SQL instances can be connected without Cloud SQL Connectors) and `REQUIRED` (Only allow connections that use Cloud SQL Connectors) Note that using REQUIRED disables all existing authorized networks. If this field is not specified when creating a new instance, NOT_REQUIRED is used. If this field is not specified when patching or updating an existing instance, it is left unchanged in the instance. "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property was only applicable to First Generation instances. + "dataCacheConfig": { # Data cache configurations. # Configuration for data cache. + "dataCacheEnabled": True or False, # Whether data cache is enabled for the instance. + }, "dataDiskSizeGb": "A String", # The size of data disk, in GB. The data disk size minimum is 10GB. "dataDiskType": "A String", # The type of data disk: `PD_SSD` (default) or `PD_HDD`. Not used for First Generation instances. "databaseFlags": [ # The database flags passed to the instance at startup. @@ -1731,6 +1743,7 @@Method Details
"time": "A String", # Time in UTC when the "deny maintenance period" starts on start_date and ends on end_date. The time is in format: HH:mm:SS, i.e., 00:00:00 }, ], + "edition": "A String", # Optional. The edition of the instance. "insightsConfig": { # Insights configuration. This specifies when Cloud SQL Insights feature is enabled and optional configuration. # Insights configuration, for now relevant only for Postgres. "queryInsightsEnabled": True or False, # Whether Query Insights feature is enabled. "queryPlansPerMinute": 42, # Number of query execution plans captured by Insights per minute for all queries combined. Default is 5. @@ -1998,6 +2011,9 @@Method Details
"collation": "A String", # The name of server Instance collation. "connectorEnforcement": "A String", # Specifies if connections must use Cloud SQL connectors. Option values include the following: `NOT_REQUIRED` (Cloud SQL instances can be connected without Cloud SQL Connectors) and `REQUIRED` (Only allow connections that use Cloud SQL Connectors) Note that using REQUIRED disables all existing authorized networks. If this field is not specified when creating a new instance, NOT_REQUIRED is used. If this field is not specified when patching or updating an existing instance, it is left unchanged in the instance. "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property was only applicable to First Generation instances. + "dataCacheConfig": { # Data cache configurations. # Configuration for data cache. + "dataCacheEnabled": True or False, # Whether data cache is enabled for the instance. + }, "dataDiskSizeGb": "A String", # The size of data disk, in GB. The data disk size minimum is 10GB. "dataDiskType": "A String", # The type of data disk: `PD_SSD` (default) or `PD_HDD`. Not used for First Generation instances. "databaseFlags": [ # The database flags passed to the instance at startup. @@ -2015,6 +2031,7 @@Method Details
"time": "A String", # Time in UTC when the "deny maintenance period" starts on start_date and ends on end_date. The time is in format: HH:mm:SS, i.e., 00:00:00 }, ], + "edition": "A String", # Optional. The edition of the instance. "insightsConfig": { # Insights configuration. This specifies when Cloud SQL Insights feature is enabled and optional configuration. # Insights configuration, for now relevant only for Postgres. "queryInsightsEnabled": True or False, # Whether Query Insights feature is enabled. "queryPlansPerMinute": 42, # Number of query execution plans captured by Insights per minute for all queries combined. Default is 5. @@ -3307,6 +3324,9 @@Method Details
"collation": "A String", # The name of server Instance collation. "connectorEnforcement": "A String", # Specifies if connections must use Cloud SQL connectors. Option values include the following: `NOT_REQUIRED` (Cloud SQL instances can be connected without Cloud SQL Connectors) and `REQUIRED` (Only allow connections that use Cloud SQL Connectors) Note that using REQUIRED disables all existing authorized networks. If this field is not specified when creating a new instance, NOT_REQUIRED is used. If this field is not specified when patching or updating an existing instance, it is left unchanged in the instance. "crashSafeReplicationEnabled": True or False, # Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property was only applicable to First Generation instances. + "dataCacheConfig": { # Data cache configurations. # Configuration for data cache. + "dataCacheEnabled": True or False, # Whether data cache is enabled for the instance. + }, "dataDiskSizeGb": "A String", # The size of data disk, in GB. The data disk size minimum is 10GB. "dataDiskType": "A String", # The type of data disk: `PD_SSD` (default) or `PD_HDD`. Not used for First Generation instances. "databaseFlags": [ # The database flags passed to the instance at startup. @@ -3324,6 +3344,7 @@Method Details
"time": "A String", # Time in UTC when the "deny maintenance period" starts on start_date and ends on end_date. The time is in format: HH:mm:SS, i.e., 00:00:00 }, ], + "edition": "A String", # Optional. The edition of the instance. "insightsConfig": { # Insights configuration. This specifies when Cloud SQL Insights feature is enabled and optional configuration. # Insights configuration, for now relevant only for Postgres. "queryInsightsEnabled": True or False, # Whether Query Insights feature is enabled. "queryPlansPerMinute": 42, # Number of query execution plans captured by Insights per minute for all queries combined. Default is 5. diff --git a/docs/dyn/sqladmin_v1beta4.projects.instances.html b/docs/dyn/sqladmin_v1beta4.projects.instances.html index 19ac36cd1e9..9a696cf2be4 100644 --- a/docs/dyn/sqladmin_v1beta4.projects.instances.html +++ b/docs/dyn/sqladmin_v1beta4.projects.instances.html @@ -80,6 +80,9 @@Instance Methods
getDiskShrinkConfig(project, instance, x__xgafv=None)
Get Disk Shrink Config for a given instance.
++
+getLatestRecoveryTime(project, instance, x__xgafv=None)
Get Latest Recovery Time for a given instance.
performDiskShrink(project, instance, body=None, x__xgafv=None)
Perform Disk Shrink on primary instance.
@@ -123,6 +126,27 @@Method Details
}
getLatestRecoveryTime(project, instance, x__xgafv=None)
+ Get Latest Recovery Time for a given instance. + +Args: + project: string, Project ID of the project that contains the instance. (required) + instance: string, Cloud SQL instance ID. This does not include the project ID. (required) + x__xgafv: string, V1 error format. + Allowed values + 1 - v1 error format + 2 - v2 error format + +Returns: + An object of the form: + + { # Instance get latest recovery time response. + "kind": "A String", # This is always `sql#getLatestRecoveryTime`. + "latestRecoveryTime": "A String", # Timestamp, identifies the latest recovery time of the source instance. +}+
performDiskShrink(project, instance, body=None, x__xgafv=None)
Perform Disk Shrink on primary instance. diff --git a/googleapiclient/discovery_cache/documents/sqladmin.v1.json b/googleapiclient/discovery_cache/documents/sqladmin.v1.json index 05c2ea68bd8..204e4891620 100644 --- a/googleapiclient/discovery_cache/documents/sqladmin.v1.json +++ b/googleapiclient/discovery_cache/documents/sqladmin.v1.json @@ -1495,6 +1495,38 @@ "https://www.googleapis.com/auth/sqlservice.admin" ] }, + "getLatestRecoveryTime": { + "description": "Get Latest Recovery Time for a given instance.", + "flatPath": "v1/projects/{project}/instances/{instance}/getLatestRecoveryTime", + "httpMethod": "GET", + "id": "sql.projects.instances.getLatestRecoveryTime", + "parameterOrder": [ + "project", + "instance" + ], + "parameters": { + "instance": { + "description": "Cloud SQL instance ID. This does not include the project ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID of the project that contains the instance.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "v1/projects/{project}/instances/{instance}/getLatestRecoveryTime", + "response": { + "$ref": "SqlInstancesGetLatestRecoveryTimeResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/sqlservice.admin" + ] + }, "performDiskShrink": { "description": "Perform Disk Shrink on primary instance.", "flatPath": "v1/projects/{project}/instances/{instance}/performDiskShrink", @@ -2090,7 +2122,7 @@ } } }, - "revision": "20230607", + "revision": "20230627", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2470,6 +2502,10 @@ "description": "Timestamp, if specified, identifies the time to which the source instance is cloned.", "format": "google-datetime", "type": "string" + }, + "preferredZone": { + "description": "Optional. (Point-in-time recovery for PostgreSQL only) Clone to an instance in the specified zone. If no zone is specified, clone to the same zone as the source instance.", + "type": "string" } }, "type": "object" @@ -2486,6 +2522,12 @@ "SECOND_GEN", "EXTERNAL" ], + "enumDeprecated": [ + false, + true, + false, + false + ], "enumDescriptions": [ "This is an unknown backend type for instance.", "V1 speckle instance.", @@ -2535,6 +2577,45 @@ "SQLSERVER_2022_EXPRESS", "SQLSERVER_2022_WEB" ], + "enumDeprecated": [ + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "This is an unknown database version.", "The database version is MySQL 5.1.", @@ -2602,6 +2683,17 @@ }, "type": "object" }, + "DataCacheConfig": { + "description": "Data cache configurations.", + "id": "DataCacheConfig", + "properties": { + "dataCacheEnabled": { + "description": "Whether data cache is enabled for the instance.", + "type": "boolean" + } + }, + "type": "object" + }, "Database": { "description": "Represents a SQL database on the Cloud SQL instance.", "id": "Database", @@ -2679,6 +2771,12 @@ "SECOND_GEN", "EXTERNAL" ], + "enumDeprecated": [ + false, + true, + false, + false + ], "enumDescriptions": [ "This is an unknown backend type for instance.", "V1 speckle instance.", @@ -2698,6 +2796,7 @@ "type": "string" }, "currentDiskSize": { + "deprecated": true, "description": "The current disk usage of the instance in bytes. This property has been deprecated. Use the \"cloudsql.googleapis.com/database/disk/bytes_used\" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details.", "format": "int64", "type": "string" @@ -2748,6 +2847,45 @@ "SQLSERVER_2022_EXPRESS", "SQLSERVER_2022_WEB" ], + "enumDeprecated": [ + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "This is an unknown database version.", "The database version is MySQL 5.1.", @@ -2843,6 +2981,7 @@ "type": "array" }, "ipv6Address": { + "deprecated": true, "description": "The IPv6 address assigned to the instance. (Deprecated) This property was applicable only to First Generation instances.", "type": "string" }, @@ -2859,6 +2998,7 @@ "type": "string" }, "maxDiskSize": { + "deprecated": true, "description": "The maximum disk size of the instance in bytes.", "format": "int64", "type": "string" @@ -2938,6 +3078,16 @@ "FAILED", "ONLINE_MAINTENANCE" ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + false, + true + ], "enumDescriptions": [ "The state of the instance is unknown.", "The instance is running, or has been stopped by owner.", @@ -3142,6 +3292,7 @@ "type": "string" }, "copyOnly": { + "deprecated": true, "description": "Deprecated: copy_only is deprecated. Use differential_base instead", "type": "boolean" }, @@ -3330,6 +3481,45 @@ "SQLSERVER_2022_EXPRESS", "SQLSERVER_2022_WEB" ], + "enumDeprecated": [ + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "This is an unknown database version.", "The database version is MySQL 5.1.", @@ -3871,6 +4061,7 @@ "id": "LocationPreference", "properties": { "followGaeApplication": { + "deprecated": true, "description": "The App Engine application to follow, it must be in the same region as the Cloud SQL instance. WARNING: Changing this might restart the instance.", "type": "string" }, @@ -4115,6 +4306,47 @@ "REENCRYPT", "SWITCHOVER" ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + true, + true, + true, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "Unknown operation type.", "Imports data into a Cloud SQL instance.", @@ -4471,6 +4703,12 @@ "NEVER", "ON_DEMAND" ], + "enumDeprecated": [ + false, + false, + false, + true + ], "enumDescriptions": [ "Unknown activation plan.", "The instance is always up and running.", @@ -4488,6 +4726,7 @@ "description": "Specifies advance machine configuration for the instance relevant only for SQL Server." }, "authorizedGaeApplications": { + "deprecated": true, "description": "The App Engine app IDs that can access this instance. (Deprecated) Applied to First Generation instances only.", "items": { "type": "string" @@ -4531,9 +4770,14 @@ "type": "string" }, "crashSafeReplicationEnabled": { + "deprecated": true, "description": "Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property was only applicable to First Generation instances.", "type": "boolean" }, + "dataCacheConfig": { + "$ref": "DataCacheConfig", + "description": "Configuration for data cache." + }, "dataDiskSizeGb": { "description": "The size of data disk, in GB. The data disk size minimum is 10GB.", "format": "int64", @@ -4547,6 +4791,12 @@ "PD_HDD", "OBSOLETE_LOCAL_SSD" ], + "enumDeprecated": [ + false, + false, + false, + true + ], "enumDescriptions": [ "This is an unknown data disk type.", "An SSD data disk.", @@ -4577,6 +4827,20 @@ }, "type": "array" }, + "edition": { + "description": "Optional. The edition of the instance.", + "enum": [ + "EDITION_UNSPECIFIED", + "ENTERPRISE", + "ENTERPRISE_PLUS" + ], + "enumDescriptions": [ + "The instance did not specify the edition.", + "The instance is an enterprise edition.", + "The instance is an Enterprise Plus edition." + ], + "type": "string" + }, "insightsConfig": { "$ref": "InsightsConfig", "description": "Insights configuration, for now relevant only for Postgres." @@ -4616,6 +4880,7 @@ "type": "string" }, "replicationType": { + "deprecated": true, "description": "The type of replication this instance uses. This can be either `ASYNCHRONOUS` or `SYNCHRONOUS`. (Deprecated) This property was only applicable to First Generation instances.", "enum": [ "SQL_REPLICATION_TYPE_UNSPECIFIED", @@ -4728,7 +4993,8 @@ "RISKY_BACKUP_ADMIN_PRIVILEGE", "INSUFFICIENT_GCS_PERMISSIONS", "INVALID_FILE_INFO", - "UNSUPPORTED_DATABASE_SETTINGS" + "UNSUPPORTED_DATABASE_SETTINGS", + "MYSQL_PARALLEL_IMPORT_INSUFFICIENT_PRIVILEGE" ], "enumDescriptions": [ "", @@ -4764,7 +5030,8 @@ "Additional BACKUP_ADMIN privilege is granted to the replication user which may lock source MySQL 8 instance for DDLs during initial sync.", "The Cloud Storage bucket is missing necessary permissions.", "The Cloud Storage bucket has an error in the file or contains invalid file information.", - "The source instance has unsupported database settings for migration." + "The source instance has unsupported database settings for migration.", + "The replication user is missing parallel import specific privileges. (e.g. LOCK TABLES) for MySQL." ], "type": "string" } @@ -4791,6 +5058,22 @@ }, "type": "object" }, + "SqlInstancesGetLatestRecoveryTimeResponse": { + "description": "Instance get latest recovery time response.", + "id": "SqlInstancesGetLatestRecoveryTimeResponse", + "properties": { + "kind": { + "description": "This is always `sql#getLatestRecoveryTime`.", + "type": "string" + }, + "latestRecoveryTime": { + "description": "Timestamp, identifies the latest recovery time of the source instance.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "SqlInstancesRescheduleMaintenanceRequestBody": { "description": "Reschedule options for maintenance windows.", "id": "SqlInstancesRescheduleMaintenanceRequestBody", @@ -4942,6 +5225,7 @@ "id": "SqlScheduledMaintenance", "properties": { "canDefer": { + "deprecated": true, "type": "boolean" }, "canReschedule": { @@ -5345,6 +5629,7 @@ "type": "string" }, "nextPageToken": { + "deprecated": true, "description": "Unused.", "type": "string" } diff --git a/googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json b/googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json index 2b0cd6721ca..7885a612e47 100644 --- a/googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json +++ b/googleapiclient/discovery_cache/documents/sqladmin.v1beta4.json @@ -1495,6 +1495,38 @@ "https://www.googleapis.com/auth/sqlservice.admin" ] }, + "getLatestRecoveryTime": { + "description": "Get Latest Recovery Time for a given instance.", + "flatPath": "sql/v1beta4/projects/{project}/instances/{instance}/getLatestRecoveryTime", + "httpMethod": "GET", + "id": "sql.projects.instances.getLatestRecoveryTime", + "parameterOrder": [ + "project", + "instance" + ], + "parameters": { + "instance": { + "description": "Cloud SQL instance ID. This does not include the project ID.", + "location": "path", + "required": true, + "type": "string" + }, + "project": { + "description": "Project ID of the project that contains the instance.", + "location": "path", + "required": true, + "type": "string" + } + }, + "path": "sql/v1beta4/projects/{project}/instances/{instance}/getLatestRecoveryTime", + "response": { + "$ref": "SqlInstancesGetLatestRecoveryTimeResponse" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform", + "https://www.googleapis.com/auth/sqlservice.admin" + ] + }, "performDiskShrink": { "description": "Perform Disk Shrink on primary instance.", "flatPath": "sql/v1beta4/projects/{project}/instances/{instance}/performDiskShrink", @@ -2090,7 +2122,7 @@ } } }, - "revision": "20230607", + "revision": "20230627", "rootUrl": "https://sqladmin.googleapis.com/", "schemas": { "AclEntry": { @@ -2470,6 +2502,10 @@ "description": "Timestamp, if specified, identifies the time to which the source instance is cloned.", "format": "google-datetime", "type": "string" + }, + "preferredZone": { + "description": "Optional. (Point-in-time recovery for PostgreSQL only) Clone to an instance in the specified zone. If no zone is specified, clone to the same zone as the source instance.", + "type": "string" } }, "type": "object" @@ -2486,6 +2522,12 @@ "SECOND_GEN", "EXTERNAL" ], + "enumDeprecated": [ + false, + true, + false, + false + ], "enumDescriptions": [ "This is an unknown backend type for instance.", "V1 speckle instance.", @@ -2535,6 +2577,45 @@ "SQLSERVER_2022_EXPRESS", "SQLSERVER_2022_WEB" ], + "enumDeprecated": [ + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "This is an unknown database version.", "The database version is MySQL 5.1.", @@ -2602,6 +2683,17 @@ }, "type": "object" }, + "DataCacheConfig": { + "description": "Data cache configurations.", + "id": "DataCacheConfig", + "properties": { + "dataCacheEnabled": { + "description": "Whether data cache is enabled for the instance.", + "type": "boolean" + } + }, + "type": "object" + }, "Database": { "description": "Represents a SQL database on the Cloud SQL instance.", "id": "Database", @@ -2679,6 +2771,12 @@ "SECOND_GEN", "EXTERNAL" ], + "enumDeprecated": [ + false, + true, + false, + false + ], "enumDescriptions": [ "This is an unknown backend type for instance.", "V1 speckle instance.", @@ -2698,6 +2796,7 @@ "type": "string" }, "currentDiskSize": { + "deprecated": true, "description": "The current disk usage of the instance in bytes. This property has been deprecated. Use the \"cloudsql.googleapis.com/database/disk/bytes_used\" metric in Cloud Monitoring API instead. Please see [this announcement](https://groups.google.com/d/msg/google-cloud-sql-announce/I_7-F9EBhT0/BtvFtdFeAgAJ) for details.", "format": "int64", "type": "string" @@ -2748,6 +2847,45 @@ "SQLSERVER_2022_EXPRESS", "SQLSERVER_2022_WEB" ], + "enumDeprecated": [ + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "This is an unknown database version.", "The database version is MySQL 5.1.", @@ -2843,6 +2981,7 @@ "type": "array" }, "ipv6Address": { + "deprecated": true, "description": "The IPv6 address assigned to the instance. (Deprecated) This property was applicable only to First Generation instances.", "type": "string" }, @@ -2859,6 +2998,7 @@ "type": "string" }, "maxDiskSize": { + "deprecated": true, "description": "The maximum disk size of the instance in bytes.", "format": "int64", "type": "string" @@ -2938,6 +3078,16 @@ "FAILED", "ONLINE_MAINTENANCE" ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + false, + true + ], "enumDescriptions": [ "The state of the instance is unknown.", "The instance is running, or has been stopped by owner.", @@ -3142,6 +3292,7 @@ "type": "string" }, "copyOnly": { + "deprecated": true, "description": "Deprecated: copy_only is deprecated. Use differential_base instead", "type": "boolean" }, @@ -3330,6 +3481,45 @@ "SQLSERVER_2022_EXPRESS", "SQLSERVER_2022_WEB" ], + "enumDeprecated": [ + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "This is an unknown database version.", "The database version is MySQL 5.1.", @@ -3871,6 +4061,7 @@ "id": "LocationPreference", "properties": { "followGaeApplication": { + "deprecated": true, "description": "The App Engine application to follow, it must be in the same region as the Cloud SQL instance. WARNING: Changing this might restart the instance.", "type": "string" }, @@ -4115,6 +4306,47 @@ "REENCRYPT", "SWITCHOVER" ], + "enumDeprecated": [ + false, + false, + false, + false, + false, + false, + false, + true, + true, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + false, + true, + true, + true, + false, + false, + false, + false, + false, + false + ], "enumDescriptions": [ "Unknown operation type.", "Imports data into a Cloud SQL instance.", @@ -4471,6 +4703,12 @@ "NEVER", "ON_DEMAND" ], + "enumDeprecated": [ + false, + false, + false, + true + ], "enumDescriptions": [ "Unknown activation plan.", "The instance is always up and running.", @@ -4488,6 +4726,7 @@ "description": "Specifies advance machine configuration for the instance relevant only for SQL Server." }, "authorizedGaeApplications": { + "deprecated": true, "description": "The App Engine app IDs that can access this instance. (Deprecated) Applied to First Generation instances only.", "items": { "type": "string" @@ -4531,9 +4770,14 @@ "type": "string" }, "crashSafeReplicationEnabled": { + "deprecated": true, "description": "Configuration specific to read replica instances. Indicates whether database flags for crash-safe replication are enabled. This property was only applicable to First Generation instances.", "type": "boolean" }, + "dataCacheConfig": { + "$ref": "DataCacheConfig", + "description": "Configuration for data cache." + }, "dataDiskSizeGb": { "description": "The size of data disk, in GB. The data disk size minimum is 10GB.", "format": "int64", @@ -4547,6 +4791,12 @@ "PD_HDD", "OBSOLETE_LOCAL_SSD" ], + "enumDeprecated": [ + false, + false, + false, + true + ], "enumDescriptions": [ "This is an unknown data disk type.", "An SSD data disk.", @@ -4577,6 +4827,20 @@ }, "type": "array" }, + "edition": { + "description": "Optional. The edition of the instance.", + "enum": [ + "EDITION_UNSPECIFIED", + "ENTERPRISE", + "ENTERPRISE_PLUS" + ], + "enumDescriptions": [ + "The instance did not specify the edition.", + "The instance is an enterprise edition.", + "The instance is an Enterprise Plus edition." + ], + "type": "string" + }, "insightsConfig": { "$ref": "InsightsConfig", "description": "Insights configuration, for now relevant only for Postgres." @@ -4616,6 +4880,7 @@ "type": "string" }, "replicationType": { + "deprecated": true, "description": "The type of replication this instance uses. This can be either `ASYNCHRONOUS` or `SYNCHRONOUS`. (Deprecated) This property was only applicable to First Generation instances.", "enum": [ "SQL_REPLICATION_TYPE_UNSPECIFIED", @@ -4728,7 +4993,8 @@ "RISKY_BACKUP_ADMIN_PRIVILEGE", "INSUFFICIENT_GCS_PERMISSIONS", "INVALID_FILE_INFO", - "UNSUPPORTED_DATABASE_SETTINGS" + "UNSUPPORTED_DATABASE_SETTINGS", + "MYSQL_PARALLEL_IMPORT_INSUFFICIENT_PRIVILEGE" ], "enumDescriptions": [ "", @@ -4764,7 +5030,8 @@ "Additional BACKUP_ADMIN privilege is granted to the replication user which may lock source MySQL 8 instance for DDLs during initial sync.", "The Cloud Storage bucket is missing necessary permissions.", "The Cloud Storage bucket has an error in the file or contains invalid file information.", - "The source instance has unsupported database settings for migration." + "The source instance has unsupported database settings for migration.", + "The replication user is missing parallel import specific privileges. (e.g. LOCK TABLES) for MySQL." ], "type": "string" } @@ -4791,6 +5058,22 @@ }, "type": "object" }, + "SqlInstancesGetLatestRecoveryTimeResponse": { + "description": "Instance get latest recovery time response.", + "id": "SqlInstancesGetLatestRecoveryTimeResponse", + "properties": { + "kind": { + "description": "This is always `sql#getLatestRecoveryTime`.", + "type": "string" + }, + "latestRecoveryTime": { + "description": "Timestamp, identifies the latest recovery time of the source instance.", + "format": "google-datetime", + "type": "string" + } + }, + "type": "object" + }, "SqlInstancesRescheduleMaintenanceRequestBody": { "description": "Reschedule options for maintenance windows.", "id": "SqlInstancesRescheduleMaintenanceRequestBody", @@ -4940,6 +5223,7 @@ "id": "SqlScheduledMaintenance", "properties": { "canDefer": { + "deprecated": true, "type": "boolean" }, "canReschedule": { @@ -5343,6 +5627,7 @@ "type": "string" }, "nextPageToken": { + "deprecated": true, "description": "Unused.", "type": "string" }