google-api-python-client 2.182.0__py3-none-any.whl → 2.184.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/sqladmin.v1.json

@@ -17,7 +17,7 @@
 "canonicalName": "SQL Admin",
 "description": "API for Cloud SQL database instance management",
 "discoveryVersion": "v1",
-"documentationLink": "https://developers.google.com/cloud-sql/",
+"documentationLink": "https://cloud.google.com/sql/docs",
 "fullyEncodeReservedExpansion": true,
 "icons": {
 "x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -1445,6 +1445,41 @@
 "https://www.googleapis.com/auth/sqlservice.admin"
 ]
 },
+"preCheckMajorVersionUpgrade": {
+"description": "Execute MVU Pre-checks",
+"flatPath": "v1/projects/{project}/instances/{instance}/preCheckMajorVersionUpgrade",
+"httpMethod": "POST",
+"id": "sql.instances.preCheckMajorVersionUpgrade",
+"parameterOrder": [
+"project",
+"instance"
+],
+"parameters": {
+"instance": {
+"description": "Required. Cloud SQL instance ID. This does not include the project ID.",
+"location": "path",
+"required": true,
+"type": "string"
+},
+"project": {
+"description": "Required. Project ID of the project that contains the instance.",
+"location": "path",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/projects/{project}/instances/{instance}/preCheckMajorVersionUpgrade",
+"request": {
+"$ref": "InstancesPreCheckMajorVersionUpgradeRequest"
+},
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/sqlservice.admin"
+]
+},
 "promoteReplica": {
 "description": "Promotes the read replica instance to be an independent Cloud SQL primary instance. Using this operation might cause your instance to restart.",
 "flatPath": "v1/projects/{project}/instances/{instance}/promoteReplica",
@@ -1565,6 +1600,21 @@
 "required": true,
 "type": "string"
 },
+"mode": {
+"description": "Optional. Reset SSL mode to use.",
+"enum": [
+"RESET_SSL_MODE_UNSPECIFIED",
+"ALL",
+"SYNC_FROM_PRIMARY"
+],
+"enumDescriptions": [
+"Reset SSL mode is not specified.",
+"Refresh all TLS configs. This is the default behaviour.",
+"Refreshes the replication-related TLS configuration settings provided by the primary instance. Not applicable to on-premises replication instances."
+],
+"location": "query",
+"type": "string"
+},
 "project": {
 "description": "Project ID of the project that contains the instance.",
 "location": "path",
@@ -2635,7 +2685,7 @@
 }
 }
 },
-"revision": "20250823",
+"revision": "20250925",
 "rootUrl": "https://sqladmin.googleapis.com/",
 "schemas": {
 "AclEntry": {
@@ -2751,7 +2801,7 @@
 "type": "object"
 },
 "Backup": {
-"description": "A backup resource. Next ID: 30",
+"description": "A backup resource.",
 "id": "Backup",
 "properties": {
 "backupInterval": {
@@ -2823,6 +2873,7 @@
 "POSTGRES_15",
 "POSTGRES_16",
 "POSTGRES_17",
+"POSTGRES_18",
 "SQLSERVER_2019_STANDARD",
 "SQLSERVER_2019_ENTERPRISE",
 "SQLSERVER_2019_EXPRESS",
@@ -2881,6 +2932,7 @@ false,
 false,
 false,
 false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -2925,6 +2977,7 @@ false
 "The database version is PostgreSQL 15.",
 "The database version is PostgreSQL 16.",
 "The database version is PostgreSQL 17.",
+"The database version is PostgreSQL 18.",
 "The database version is SQL Server 2019 Standard.",
 "The database version is SQL Server 2019 Enterprise.",
 "The database version is SQL Server 2019 Express.",
@@ -3282,6 +3335,7 @@ false
 "POSTGRES_15",
 "POSTGRES_16",
 "POSTGRES_17",
+"POSTGRES_18",
 "SQLSERVER_2019_STANDARD",
 "SQLSERVER_2019_ENTERPRISE",
 "SQLSERVER_2019_EXPRESS",
@@ -3340,6 +3394,7 @@ false,
 false,
 false,
 false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -3384,6 +3439,7 @@ false
 "The database version is PostgreSQL 15.",
 "The database version is PostgreSQL 16.",
 "The database version is PostgreSQL 17.",
+"The database version is PostgreSQL 18.",
 "The database version is SQL Server 2019 Standard.",
 "The database version is SQL Server 2019 Enterprise.",
 "The database version is SQL Server 2019 Express.",
@@ -3728,6 +3784,7 @@ false
 "POSTGRES_15",
 "POSTGRES_16",
 "POSTGRES_17",
+"POSTGRES_18",
 "SQLSERVER_2019_STANDARD",
 "SQLSERVER_2019_ENTERPRISE",
 "SQLSERVER_2019_EXPRESS",
@@ -3786,6 +3843,7 @@ false,
 false,
 false,
 false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -3830,6 +3888,7 @@ false
 "The database version is PostgreSQL 15.",
 "The database version is PostgreSQL 16.",
 "The database version is PostgreSQL 17.",
+"The database version is PostgreSQL 18.",
 "The database version is SQL Server 2019 Standard.",
 "The database version is SQL Server 2019 Enterprise.",
 "The database version is SQL Server 2019 Express.",
@@ -4130,6 +4189,7 @@ false
 "POSTGRES_15",
 "POSTGRES_16",
 "POSTGRES_17",
+"POSTGRES_18",
 "SQLSERVER_2019_STANDARD",
 "SQLSERVER_2019_ENTERPRISE",
 "SQLSERVER_2019_EXPRESS",
@@ -4188,6 +4248,7 @@ false,
 false,
 false,
 false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -4232,6 +4293,7 @@ false
 "The database version is PostgreSQL 15.",
 "The database version is PostgreSQL 16.",
 "The database version is PostgreSQL 17.",
+"The database version is PostgreSQL 18.",
 "The database version is SQL Server 2019 Standard.",
 "The database version is SQL Server 2019 Enterprise.",
 "The database version is SQL Server 2019 Express.",
@@ -5080,6 +5142,7 @@ false
 "POSTGRES_15",
 "POSTGRES_16",
 "POSTGRES_17",
+"POSTGRES_18",
 "SQLSERVER_2019_STANDARD",
 "SQLSERVER_2019_ENTERPRISE",
 "SQLSERVER_2019_EXPRESS",
@@ -5138,6 +5201,7 @@ false,
 false,
 false,
 false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -5182,6 +5246,7 @@ false
 "The database version is PostgreSQL 15.",
 "The database version is PostgreSQL 16.",
 "The database version is PostgreSQL 17.",
+"The database version is PostgreSQL 18.",
 "The database version is SQL Server 2019 Standard.",
 "The database version is SQL Server 2019 Enterprise.",
 "The database version is SQL Server 2019 Express.",
@@ -5755,6 +5820,17 @@ false
 },
 "type": "object"
 },
+"InstancesPreCheckMajorVersionUpgradeRequest": {
+"description": "Request for Pre-checks for MVU",
+"id": "InstancesPreCheckMajorVersionUpgradeRequest",
+"properties": {
+"preCheckMajorVersionUpgradeContext": {
+"$ref": "PreCheckMajorVersionUpgradeContext",
+"description": "Required. Contains details about the pre-check major version upgrade operation."
+}
+},
+"type": "object"
+},
 "InstancesReencryptRequest": {
 "description": "Database Instance reencrypt request.",
 "id": "InstancesReencryptRequest",
@@ -6047,6 +6123,21 @@ false
 },
 "type": "object"
 },
+"Message": {
+"description": "Represents a notice or warning message from the database.",
+"id": "Message",
+"properties": {
+"message": {
+"description": "The full message string. For PostgreSQL, this is a formatted string that may include severity, code, and the notice/warning message. For MySQL, this contains the warning message.",
+"type": "string"
+},
+"severity": {
+"description": "The severity of the message (e.g., \"NOTICE\" for PostgreSQL, \"WARNING\" for MySQL).",
+"type": "string"
+}
+},
+"type": "object"
+},
 "Metadata": {
 "description": "The additional metadata information regarding the execution of the SQL statements.",
 "id": "Metadata",
@@ -6404,6 +6495,10 @@ false
 ],
 "type": "string"
 },
+"preCheckMajorVersionUpgradeContext": {
+"$ref": "PreCheckMajorVersionUpgradeContext",
+"description": "This field is only populated when the operation_type is PRE_CHECK_MAJOR_VERSION_UPGRADE. The PreCheckMajorVersionUpgradeContext message itself contains the details for that pre-check, such as the target database version for the upgrade and the results of the check (including any warnings or errors found)."
+},
 "selfLink": {
 "description": "The URI of this resource.",
 "type": "string"
@@ -6741,6 +6836,219 @@ false
 },
 "type": "object"
 },
+"PreCheckMajorVersionUpgradeContext": {
+"description": "Pre-check major version upgrade context.",
+"id": "PreCheckMajorVersionUpgradeContext",
+"properties": {
+"kind": {
+"description": "Optional. This is always `sql#preCheckMajorVersionUpgradeContext`.",
+"type": "string"
+},
+"preCheckResponse": {
+"description": "Output only. The responses from the precheck operation.",
+"items": {
+"$ref": "PreCheckResponse"
+},
+"readOnly": true,
+"type": "array"
+},
+"targetDatabaseVersion": {
+"description": "Required. The target database version to upgrade to.",
+"enum": [
+"SQL_DATABASE_VERSION_UNSPECIFIED",
+"MYSQL_5_1",
+"MYSQL_5_5",
+"MYSQL_5_6",
+"MYSQL_5_7",
+"MYSQL_8_0",
+"MYSQL_8_0_18",
+"MYSQL_8_0_26",
+"MYSQL_8_0_27",
+"MYSQL_8_0_28",
+"MYSQL_8_0_29",
+"MYSQL_8_0_30",
+"MYSQL_8_0_31",
+"MYSQL_8_0_32",
+"MYSQL_8_0_33",
+"MYSQL_8_0_34",
+"MYSQL_8_0_35",
+"MYSQL_8_0_36",
+"MYSQL_8_0_37",
+"MYSQL_8_0_39",
+"MYSQL_8_0_40",
+"MYSQL_8_0_41",
+"MYSQL_8_0_42",
+"MYSQL_8_0_43",
+"MYSQL_8_0_44",
+"MYSQL_8_0_45",
+"MYSQL_8_0_46",
+"MYSQL_8_4",
+"SQLSERVER_2017_STANDARD",
+"SQLSERVER_2017_ENTERPRISE",
+"SQLSERVER_2017_EXPRESS",
+"SQLSERVER_2017_WEB",
+"POSTGRES_9_6",
+"POSTGRES_10",
+"POSTGRES_11",
+"POSTGRES_12",
+"POSTGRES_13",
+"POSTGRES_14",
+"POSTGRES_15",
+"POSTGRES_16",
+"POSTGRES_17",
+"POSTGRES_18",
+"SQLSERVER_2019_STANDARD",
+"SQLSERVER_2019_ENTERPRISE",
+"SQLSERVER_2019_EXPRESS",
+"SQLSERVER_2019_WEB",
+"SQLSERVER_2022_STANDARD",
+"SQLSERVER_2022_ENTERPRISE",
+"SQLSERVER_2022_EXPRESS",
+"SQLSERVER_2022_WEB"
+],
+"enumDeprecated": [
+false,
+true,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+true,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+false,
+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.",
+"The database version is MySQL 5.5.",
+"The database version is MySQL 5.6.",
+"The database version is MySQL 5.7.",
+"The database version is MySQL 8.",
+"The database major version is MySQL 8.0 and the minor version is 18.",
+"The database major version is MySQL 8.0 and the minor version is 26.",
+"The database major version is MySQL 8.0 and the minor version is 27.",
+"The database major version is MySQL 8.0 and the minor version is 28.",
+"The database major version is MySQL 8.0 and the minor version is 29.",
+"The database major version is MySQL 8.0 and the minor version is 30.",
+"The database major version is MySQL 8.0 and the minor version is 31.",
+"The database major version is MySQL 8.0 and the minor version is 32.",
+"The database major version is MySQL 8.0 and the minor version is 33.",
+"The database major version is MySQL 8.0 and the minor version is 34.",
+"The database major version is MySQL 8.0 and the minor version is 35.",
+"The database major version is MySQL 8.0 and the minor version is 36.",
+"The database major version is MySQL 8.0 and the minor version is 37.",
+"The database major version is MySQL 8.0 and the minor version is 39.",
+"The database major version is MySQL 8.0 and the minor version is 40.",
+"The database major version is MySQL 8.0 and the minor version is 41.",
+"The database major version is MySQL 8.0 and the minor version is 42.",
+"The database major version is MySQL 8.0 and the minor version is 43.",
+"The database major version is MySQL 8.0 and the minor version is 44.",
+"The database major version is MySQL 8.0 and the minor version is 45.",
+"The database major version is MySQL 8.0 and the minor version is 46.",
+"The database version is MySQL 8.4.",
+"The database version is SQL Server 2017 Standard.",
+"The database version is SQL Server 2017 Enterprise.",
+"The database version is SQL Server 2017 Express.",
+"The database version is SQL Server 2017 Web.",
+"The database version is PostgreSQL 9.6.",
+"The database version is PostgreSQL 10.",
+"The database version is PostgreSQL 11.",
+"The database version is PostgreSQL 12.",
+"The database version is PostgreSQL 13.",
+"The database version is PostgreSQL 14.",
+"The database version is PostgreSQL 15.",
+"The database version is PostgreSQL 16.",
+"The database version is PostgreSQL 17.",
+"The database version is PostgreSQL 18.",
+"The database version is SQL Server 2019 Standard.",
+"The database version is SQL Server 2019 Enterprise.",
+"The database version is SQL Server 2019 Express.",
+"The database version is SQL Server 2019 Web.",
+"The database version is SQL Server 2022 Standard.",
+"The database version is SQL Server 2022 Enterprise.",
+"The database version is SQL Server 2022 Express.",
+"The database version is SQL Server 2022 Web."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"PreCheckResponse": {
+"description": "Structured PreCheckResponse containing message, type, and required actions.",
+"id": "PreCheckResponse",
+"properties": {
+"actionsRequired": {
+"description": "The actions that the user needs to take. Use repeated for multiple actions.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"message": {
+"description": "The message to be displayed to the user.",
+"type": "string"
+},
+"messageType": {
+"description": "The type of message whether it is an info, warning, or error.",
+"enum": [
+"MESSAGE_TYPE_UNSPECIFIED",
+"INFO",
+"WARNING",
+"ERROR"
+],
+"enumDescriptions": [
+"Default unspecified value to prevent unintended behavior changes.",
+"General informational messages that don't require action.",
+"Warnings that might impact the upgrade but don't block it.",
+"Errors that a user must resolve before proceeding with the upgrade."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "PscAutoConnectionConfig": {
 "description": "Settings for an automatically-setup Private Service Connect consumer endpoint that is used to connect to a Cloud SQL instance.",
 "id": "PscAutoConnectionConfig",
@@ -6826,6 +7134,48 @@ false
 },
 "type": "object"
 },
+"ReadPoolAutoScaleConfig": {
+"description": "The read pool auto-scale configuration.",
+"id": "ReadPoolAutoScaleConfig",
+"properties": {
+"disableScaleIn": {
+"description": "Indicates whether read pool auto scaling supports scale in operations (removing nodes).",
+"type": "boolean"
+},
+"enabled": {
+"description": "Indicates whether read pool auto scaling is enabled.",
+"type": "boolean"
+},
+"maxNodeCount": {
+"description": "Maximum number of read pool nodes to be maintained.",
+"format": "int32",
+"type": "integer"
+},
+"minNodeCount": {
+"description": "Minimum number of read pool nodes to be maintained.",
+"format": "int32",
+"type": "integer"
+},
+"scaleInCooldownSeconds": {
+"description": "The cooldown period for scale-in operations.",
+"format": "int32",
+"type": "integer"
+},
+"scaleOutCooldownSeconds": {
+"description": "The cooldown period for scale-out operations.",
+"format": "int32",
+"type": "integer"
+},
+"targetMetrics": {
+"description": "Optional. Target metrics for read pool auto scaling.",
+"items": {
+"$ref": "TargetMetric"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "ReplicaConfiguration": {
 "description": "Read-replica configuration for connecting to the primary instance.",
 "id": "ReplicaConfiguration",
@@ -7193,6 +7543,10 @@ false
 ],
 "type": "string"
 },
+"readPoolAutoScaleConfig": {
+"$ref": "ReadPoolAutoScaleConfig",
+"description": "Optional. The read pool auto-scale configuration for the instance."
+},
 "replicationLagMaxSeconds": {
 "description": "Optional. Configuration value for recreation of replica after certain replication lag",
 "format": "int32",
@@ -7369,7 +7723,8 @@ false
 "PSC_ONLY_INSTANCE_WITH_NO_NETWORK_ATTACHMENT_URI",
 "SELECTED_OBJECTS_REFERENCE_UNSELECTED_OBJECTS",
 "PROMPT_DELETE_EXISTING",
-"WILL_DELETE_EXISTING"
+"WILL_DELETE_EXISTING",
+"PG_DDL_REPLICATION_INSUFFICIENT_PRIVILEGE"
 ],
 "enumDescriptions": [
 "",
@@ -7429,7 +7784,8 @@ false
 "PSC only destination instance does not have a network attachment URI.",
 "Selected objects reference unselected objects. Based on their object type (foreign key constraint or view), selected objects will fail during migration.",
 "The migration will delete existing data in the replica; set replica_overwrite_enabled in the request to acknowledge this. This is an error. MySQL only.",
-"The migration will delete existing data in the replica; replica_overwrite_enabled was set in the request acknowledging this. This is a warning rather than an error. MySQL only."
+"The migration will delete existing data in the replica; replica_overwrite_enabled was set in the request acknowledging this. This is a warning rather than an error. MySQL only.",
+"The replication user is missing specific privileges to setup DDL replication. (e.g. CREATE EVENT TRIGGER, CREATE SCHEMA) for PostgreSQL."
 ],
 "type": "string"
 }
@@ -7451,6 +7807,13 @@ false
 "description": "Execute SQL statements response.",
 "id": "SqlInstancesExecuteSqlResponse",
 "properties": {
+"messages": {
+"description": "A list of notices and warnings generated during query execution. For PostgreSQL, this includes all notices and warnings. For MySQL, this includes warnings generated by the last executed statement. To retrieve all warnings for a multi-statement query, `SHOW WARNINGS` must be executed after each statement.",
+"items": {
+"$ref": "Message"
+},
+"type": "array"
+},
 "metadata": {
 "$ref": "Metadata",
 "description": "The additional metadata information regarding the execution of the SQL statements."
@@ -7969,6 +8332,22 @@ false
 },
 "type": "object"
 },
+"TargetMetric": {
+"description": "Target metric for read pool auto scaling.",
+"id": "TargetMetric",
+"properties": {
+"metric": {
+"description": "The metric name to be used for auto scaling.",
+"type": "string"
+},
+"targetValue": {
+"description": "The target value for the metric.",
+"format": "float",
+"type": "number"
+}
+},
+"type": "object"
+},
 "Tier": {
 "description": "A Google Cloud SQL service tier resource.",
 "id": "Tier",
@@ -8062,6 +8441,20 @@ false
 "description": "Optional. The host from which the user can connect. For `insert` operations, host defaults to an empty string. For `update` operations, host is specified as part of the request URL. The host name cannot be updated after insertion. For a MySQL instance, it's required; for a PostgreSQL or SQL Server instance, it's optional.",
 "type": "string"
 },
+"iamStatus": {
+"description": "Indicates if a group is active or inactive for IAM database authentication.",
+"enum": [
+"IAM_STATUS_UNSPECIFIED",
+"INACTIVE",
+"ACTIVE"
+],
+"enumDescriptions": [
+"The default value for users that are not of type CLOUD_IAM_GROUP. Only CLOUD_IAM_GROUP users will be inactive or active. Users with an IamStatus of IAM_STATUS_UNSPECIFIED will not display whether they are active or inactive as that is not applicable to them.",
+"INACTIVE indicates a group is not available for IAM database authentication.",
+"ACTIVE indicates a group is available for IAM database authentication."
+],
+"type": "string"
+},
 "instance": {
 "description": "The name of the Cloud SQL instance. This does not include the project ID. Can be omitted for `update` because it is already specified on the URL.",
 "type": "string"