google-api-python-client 2.187.0__py3-none-any.whl → 2.188.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/sqladmin.v1.json

@@ -785,6 +785,38 @@
 },
 "instances": {
 "methods": {
+"ListEntraIdCertificates": {
+"description": "Lists all versions of EntraID certificates for the specified instance. There can be up to three sets of certificates listed: the certificate that is currently in use, a future that has been added but not yet used to sign a certificate, and a certificate that has been rotated out.",
+"flatPath": "v1/projects/{project}/instances/{instance}/listEntraIdCertificates",
+"httpMethod": "GET",
+"id": "sql.instances.ListEntraIdCertificates",
+"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}/listEntraIdCertificates",
+"response": {
+"$ref": "InstancesListEntraIdCertificatesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/sqlservice.admin"
+]
+},
 "ListServerCertificates": {
 "description": "Lists all versions of server certificates and certificate authorities (CAs) for the specified instance. There can be up to three sets of certs listed: the certificate that is currently in use, a future that has been added but not yet used to sign a certificate, and a certificate that has been rotated out. For instances not using Certificate Authority Service (CAS) server CA, use ListServerCas instead.",
 "flatPath": "v1/projects/{project}/instances/{instance}/listServerCertificates",
@@ -817,6 +849,41 @@
 "https://www.googleapis.com/auth/sqlservice.admin"
 ]
 },
+"RotateEntraIdCertificate": {
+"description": "Rotates the server certificate version to one previously added with the addEntraIdCertificate method.",
+"flatPath": "v1/projects/{project}/instances/{instance}/rotateEntraIdCertificate",
+"httpMethod": "POST",
+"id": "sql.instances.RotateEntraIdCertificate",
+"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}/rotateEntraIdCertificate",
+"request": {
+"$ref": "InstancesRotateEntraIdCertificateRequest"
+},
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/sqlservice.admin"
+]
+},
 "RotateServerCertificate": {
 "description": "Rotates the server certificate version to one previously added with the addServerCertificate method. For instances not using Certificate Authority Service (CAS) server CA, use RotateServerCa instead.",
 "flatPath": "v1/projects/{project}/instances/{instance}/rotateServerCertificate",
@@ -887,6 +954,38 @@
 "https://www.googleapis.com/auth/sqlservice.admin"
 ]
 },
+"addEntraIdCertificate": {
+"description": "Adds a new Entra ID certificate for the specified instance. If an Entra ID certificate was previously added but never used in a certificate rotation, this operation replaces that version.",
+"flatPath": "v1/projects/{project}/instances/{instance}/addEntraIdCertificate",
+"httpMethod": "POST",
+"id": "sql.instances.addEntraIdCertificate",
+"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}/addEntraIdCertificate",
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/sqlservice.admin"
+]
+},
 "addServerCa": {
 "description": "Adds a new trusted Certificate Authority (CA) version for the specified instance. Required to prepare for a certificate rotation. If a CA version was previously added but never used in a certificate rotation, this operation replaces that version. There cannot be more than one CA version waiting to be rotated in. For instances that have enabled Certificate Authority Service (CAS) based server CA, use AddServerCertificate to add a new server certificate.",
 "flatPath": "v1/projects/{project}/instances/{instance}/addServerCa",
@@ -2647,6 +2746,12 @@
 "instance"
 ],
 "parameters": {
+"databaseRoles": {
+"description": "Optional. List of database roles to grant to the user. body.database_roles will be ignored for update request.",
+"location": "query",
+"repeated": true,
+"type": "string"
+},
 "host": {
 "description": "Optional. Host of the user in the instance.",
 "location": "query",
@@ -2685,7 +2790,7 @@
 }
 }
 },
-"revision": "20251019",
+"revision": "20251201",
 "rootUrl": "https://sqladmin.googleapis.com/",
 "schemas": {
 "AclEntry": {
@@ -4562,7 +4667,7 @@ false
 ],
 "enumDescriptions": [
 "This is an unknown suspension reason.",
-"The instance is suspended due to billing issues (for example:, GCP account issue)",
+"The instance is suspended due to billing issues (for example:, account issue)",
 "The instance is suspended due to illegal content (for example:, child pornography, copyrighted material, etc.).",
 "The instance is causing operational issues (for example:, causing the database to crash).",
 "The KMS key used by the instance is either revoked or denied access to"
@@ -5472,7 +5577,7 @@ false
 "type": "object"
 },
 "noRecovery": {
-"description": "Whether or not the backup importing will restore database with NORECOVERY option Applies only to Cloud SQL for SQL Server.",
+"description": "Whether or not the backup importing will restore database with NORECOVERY option. Applies only to Cloud SQL for SQL Server.",
 "type": "boolean"
 },
 "recoveryOnly": {
@@ -5741,6 +5846,28 @@ false
 },
 "type": "object"
 },
+"InstancesListEntraIdCertificatesResponse": {
+"description": "Instances ListEntraIdCertificates response.",
+"id": "InstancesListEntraIdCertificatesResponse",
+"properties": {
+"activeVersion": {
+"description": "The `sha1_fingerprint` of the active certificate from `certs`.",
+"type": "string"
+},
+"certs": {
+"description": "List of Entra ID certificates for the instance.",
+"items": {
+"$ref": "SslCert"
+},
+"type": "array"
+},
+"kind": {
+"description": "This is always `sql#instancesListEntraIdCertificates`.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "InstancesListResponse": {
 "description": "Database instances list response.",
 "id": "InstancesListResponse",
@@ -5872,6 +5999,17 @@ false
 },
 "type": "object"
 },
+"InstancesRotateEntraIdCertificateRequest": {
+"description": "Rotate Entra ID certificate request.",
+"id": "InstancesRotateEntraIdCertificateRequest",
+"properties": {
+"rotateEntraIdCertificateContext": {
+"$ref": "RotateEntraIdCertificateContext",
+"description": "Optional. Contains details about the rotate server certificate operation."
+}
+},
+"type": "object"
+},
 "InstancesRotateServerCaRequest": {
 "description": "Rotate server CA request.",
 "id": "InstancesRotateServerCaRequest",
@@ -5984,6 +6122,20 @@ false
 "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/{PROJECT}/locations/{REGION}/caPools/{CA_POOL_ID}",
 "type": "string"
 },
+"serverCertificateRotationMode": {
+"description": "Optional. Controls the automatic server certificate rotation feature. This feature is disabled by default. When enabled, the server certificate will be automatically rotated during Cloud SQL scheduled maintenance or self-service maintenance updates up to six months before it expires. This setting can only be set if server_ca_mode is either GOOGLE_MANAGED_CAS_CA or CUSTOMER_MANAGED_CAS_CA.",
+"enum": [
+"SERVER_CERTIFICATE_ROTATION_MODE_UNSPECIFIED",
+"NO_AUTOMATIC_ROTATION",
+"AUTOMATIC_ROTATION_DURING_MAINTENANCE"
+],
+"enumDescriptions": [
+"Unspecified: no automatic server certificate rotation.",
+"No automatic server certificate rotation. The user must [manage server certificate rotation](/sql/docs/mysql/manage-ssl-instance#rotate-server-certificate-cas) on their side.",
+"Automatic server certificate rotation during Cloud SQL scheduled maintenance or self-service maintenance updates. Requires `server_ca_mode` to be `GOOGLE_MANAGED_CAS_CA` or `CUSTOMER_MANAGED_CAS_CA`."
+],
+"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": [
@@ -6666,7 +6818,7 @@ false
 "type": "object"
 },
 "PasswordValidationPolicy": {
-"description": "Database instance local user password validation policy",
+"description": "Database instance local user password validation policy. This message defines the password policy for local database users. When enabled, it enforces constraints on password complexity, length, and reuse. Keep this policy enabled to help prevent unauthorized access.",
 "id": "PasswordValidationPolicy",
 "properties": {
 "complexity": {
@@ -6691,7 +6843,7 @@ false
 "type": "boolean"
 },
 "enablePasswordPolicy": {
-"description": "Whether the password policy is enabled or not.",
+"description": "Whether to enable the password policy or not. When enabled, passwords must meet complexity requirements. Keep this policy enabled to help prevent unauthorized access. Disabling this policy allows weak passwords.",
 "type": "boolean"
 },
 "minLength": {
@@ -6724,8 +6876,44 @@ false
 },
 "type": "object"
 },
+"PerformanceCaptureConfig": {
+"description": "Performance Capture configuration.",
+"id": "PerformanceCaptureConfig",
+"properties": {
+"enabled": {
+"description": "Optional. Enable or disable the Performance Capture feature.",
+"type": "boolean"
+},
+"probeThreshold": {
+"description": "Optional. The minimum number of consecutive readings above threshold that triggers instance state capture.",
+"format": "int32",
+"type": "integer"
+},
+"probingIntervalSeconds": {
+"description": "Optional. The time interval in seconds between any two probes.",
+"format": "int32",
+"type": "integer"
+},
+"runningThreadsThreshold": {
+"description": "Optional. The minimum number of server threads running to trigger the capture on primary.",
+"format": "int32",
+"type": "integer"
+},
+"secondsBehindSourceThreshold": {
+"description": "Optional. The minimum number of seconds replica must be lagging behind primary to trigger capture on replica.",
+"format": "int32",
+"type": "integer"
+},
+"transactionDurationThreshold": {
+"description": "Optional. The amount of time in seconds that a transaction needs to have been open before the watcher starts recording it.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "PointInTimeRestoreContext": {
-"description": "The context to perform a point-in-time recovery of an instance managed by Google Cloud Backup and Disaster Recovery.",
+"description": "The context to perform a point-in-time recovery of an instance managed by Backup and Disaster Recovery (DR) Service.",
 "id": "PointInTimeRestoreContext",
 "properties": {
 "allocatedIpRange": {
@@ -6733,7 +6921,7 @@ false
 "type": "string"
 },
 "datasource": {
-"description": "The Google Cloud Backup and Disaster Recovery Datasource URI. Format: projects/{project}/locations/{region}/backupVaults/{backupvault}/dataSources/{datasource}.",
+"description": "The Backup and Disaster Recovery (DR) Service Datasource URI. Format: projects/{project}/locations/{region}/backupVaults/{backupvault}/dataSources/{datasource}.",
 "type": "string"
 },
 "pointInTime": {
@@ -6795,6 +6983,19 @@ false
 "readOnly": true,
 "type": "string"
 },
+"pscAutoConnections": {
+"description": "Output only. The list of settings for requested automatically-setup Private Service Connect (PSC) consumer endpoints that can be used to connect to this read pool node.",
+"items": {
+"$ref": "PscAutoConnectionConfig"
+},
+"readOnly": true,
+"type": "array"
+},
+"pscServiceAttachmentLink": {
+"description": "Output only. The Private Service Connect (PSC) service attachment of the read pool node.",
+"readOnly": true,
+"type": "string"
+},
 "state": {
 "description": "Output only. The current state of the read pool node.",
 "enum": [
@@ -7275,6 +7476,21 @@ false
 },
 "type": "object"
 },
+"RotateEntraIdCertificateContext": {
+"description": "Instance rotate Entra ID certificate context.",
+"id": "RotateEntraIdCertificateContext",
+"properties": {
+"kind": {
+"description": "Optional. This is always `sql#rotateEntraIdCertificateContext`.",
+"type": "string"
+},
+"nextVersion": {
+"description": "Optional. The fingerprint of the next version to be rotated to. If left unspecified, will be rotated to the most recently added server certificate version.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "RotateServerCaContext": {
 "description": "Instance rotate server CA context.",
 "id": "RotateServerCaContext",
@@ -7422,7 +7638,7 @@ true
 "type": "boolean"
 },
 "dataApiAccess": {
-"description": "This parameter controls whether to allow using Data API to connect to the instance. Not allowed by default.",
+"description": "This parameter controls whether to allow using ExecuteSql API to connect to the instance. Not allowed by default.",
 "enum": [
 "DATA_API_ACCESS_UNSPECIFIED",
 "DISALLOW_DATA_API",
@@ -7430,8 +7646,8 @@ true
 ],
 "enumDescriptions": [
 "Unspecified, effectively the same as `DISALLOW_DATA_API`.",
-"Disallow using Data API to connect to the instance.",
-"Allow using Data API to connect to the instance. For private IP instances, this will allow authorized users to access the instance from the public internet."
+"Disallow using ExecuteSql API to connect to the instance.",
+"Allow using ExecuteSql API to connect to the instance. For private IP instances, this allows authorized users to access the instance from the public internet using ExecuteSql API."
 ],
 "type": "string"
 },
@@ -7523,6 +7739,10 @@ false
 "description": "Optional. When this parameter is set to true, Cloud SQL instances can connect to Vertex AI to pass requests for real-time predictions and insights to the AI. The default value is false. This applies only to Cloud SQL for MySQL and Cloud SQL for PostgreSQL instances.",
 "type": "boolean"
 },
+"entraidConfig": {
+"$ref": "SqlServerEntraIdConfig",
+"description": "Optional. The Microsoft Entra ID configuration for the SQL Server instance."
+},
 "finalBackupConfig": {
 "$ref": "FinalBackupConfig",
 "description": "Optional. The final backup configuration for the instance."
@@ -7551,6 +7771,10 @@ false
 "$ref": "PasswordValidationPolicy",
 "description": "The local user password validation policy of the instance."
 },
+"performanceCaptureConfig": {
+"$ref": "PerformanceCaptureConfig",
+"description": "Optional. Configuration for Performance Capture, provides diagnostic metrics during high load situations."
+},
 "pricingPlan": {
 "description": "The pricing plan for this instance. This can be either `PER_USE` or `PACKAGE`. Only `PER_USE` is supported for Second Generation instances.",
 "enum": [
@@ -8181,6 +8405,26 @@ false
 },
 "type": "object"
 },
+"SqlServerEntraIdConfig": {
+"description": "SQL Server Entra ID configuration.",
+"id": "SqlServerEntraIdConfig",
+"properties": {
+"applicationId": {
+"description": "Optional. The application ID for the Entra ID configuration.",
+"type": "string"
+},
+"kind": {
+"description": "Output only. This is always sql#sqlServerEntraIdConfig",
+"readOnly": true,
+"type": "string"
+},
+"tenantId": {
+"description": "Optional. The tenant ID for the Entra ID configuration.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "SqlServerUserDetails": {
 "description": "Represents a Sql Server user on the Cloud SQL instance.",
 "id": "SqlServerUserDetails",
@@ -8478,6 +8722,13 @@ false
 "description": "A Cloud SQL user resource.",
 "id": "User",
 "properties": {
+"databaseRoles": {
+"description": "Optional. Role memberships of the user",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "dualPasswordType": {
 "description": "Dual password status for the user.",
 "enum": [
@@ -8555,7 +8806,8 @@ false
 "CLOUD_IAM_SERVICE_ACCOUNT",
 "CLOUD_IAM_GROUP",
 "CLOUD_IAM_GROUP_USER",
-"CLOUD_IAM_GROUP_SERVICE_ACCOUNT"
+"CLOUD_IAM_GROUP_SERVICE_ACCOUNT",
+"ENTRAID_USER"
 ],
 "enumDescriptions": [
 "The database's built-in user type.",
@@ -8563,7 +8815,8 @@ false
 "Cloud IAM service account.",
 "Cloud IAM group. Not used for login.",
 "Read-only. Login for a user that belongs to the Cloud IAM group.",
-"Read-only. Login for a service account that belongs to the Cloud IAM group."
+"Read-only. Login for a service account that belongs to the Cloud IAM group.",
+"Microsoft Entra ID user."
 ],
 "type": "string"
 }