google-api-python-client 2.162.0__py2.py3-none-any.whl → 2.164.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/alloydb.v1.json

@@ -764,6 +764,34 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"restoreFromCloudSQL": {
+"description": "Restores an AlloyDB cluster from a CloudSQL resource.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters:restoreFromCloudSQL",
+"httpMethod": "POST",
+"id": "alloydb.projects.locations.clusters.restoreFromCloudSQL",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The location of the new cluster. For the required format, see the comment on Cluster.name field.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+parent}/clusters:restoreFromCloudSQL",
+"request": {
+"$ref": "RestoreFromCloudSQLRequest"
+},
+"response": {
+"$ref": "Operation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "switchover": {
 "description": "Switches the roles of PRIMARY and SECONDARY clusters without any data loss. This promotes the SECONDARY cluster to PRIMARY and sets up the original PRIMARY cluster to replicate from this newly promoted cluster.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/clusters/{clustersId}:switchover",
@@ -1556,6 +1584,21 @@
 "pattern": "^projects/[^/]+/locations/[^/]+$",
 "required": true,
 "type": "string"
+},
+"scope": {
+"description": "Optional. The scope for which supported flags are requested. If not specified, default is DATABASE.",
+"enum": [
+"SCOPE_UNSPECIFIED",
+"DATABASE",
+"CONNECTION_POOL"
+],
+"enumDescriptions": [
+"The scope of the flag is not specified. Default is DATABASE.",
+"The flag is a database flag.",
+"The flag is a connection pool flag."
+],
+"location": "query",
+"type": "string"
 }
 },
 "path": "v1/{+parent}/supportedDatabaseFlags",
@@ -1573,7 +1616,7 @@
 }
 }
 },
-"revision": "20250205",
+"revision": "20250227",
 "rootUrl": "https://alloydb.googleapis.com/",
 "schemas": {
 "AuthorizedNetwork": {
@@ -1602,7 +1645,7 @@
 },
 "encryptionConfig": {
 "$ref": "EncryptionConfig",
-"description": "Optional. The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will then use default encryption scheme to protect the user data."
+"description": "Optional. The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will use the cluster's encryption config."
 },
 "labels": {
 "additionalProperties": {
@@ -2254,7 +2297,7 @@ false
 },
 "encryptionConfig": {
 "$ref": "EncryptionConfig",
-"description": "The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will then use default encryption scheme to protect the user data."
+"description": "The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will use the cluster's encryption config."
 },
 "recoveryWindowDays": {
 "description": "The number of days that are eligible to restore from using PITR. To support the entire recovery window, backups and logs are retained for one day more than the recovery window. If not set, defaults to 14 days.",
@@ -2746,6 +2789,10 @@ false
 "readOnly": true,
 "type": "array"
 },
+"observabilityConfig": {
+"$ref": "ObservabilityInstanceConfig",
+"description": "Configuration for observability."
+},
 "outboundPublicIpAddresses": {
 "description": "Output only. All outbound public IP addresses configured for the instance.",
 "items": {
@@ -3173,7 +3220,7 @@ false
 "type": "object"
 },
 "Node": {
-"description": "Details of a single node in the instance. Nodes in an AlloyDB instance are ephemereal, they can change during update, failover, autohealing and resize operations.",
+"description": "Details of a single node in the instance. Nodes in an AlloyDB instance are ephemeral, they can change during update, failover, autohealing and resize operations.",
 "id": "Node",
 "properties": {
 "id": {
@@ -3199,6 +3246,48 @@ false
 },
 "type": "object"
 },
+"ObservabilityInstanceConfig": {
+"description": "Observability Instance specific configuration.",
+"id": "ObservabilityInstanceConfig",
+"properties": {
+"enabled": {
+"description": "Observability feature status for an instance. This flag is turned \"off\" by default.",
+"type": "boolean"
+},
+"maxQueryStringLength": {
+"description": "Query string length. The default value is 10k.",
+"format": "int32",
+"type": "integer"
+},
+"preserveComments": {
+"description": "Preserve comments in query string for an instance. This flag is turned \"off\" by default.",
+"type": "boolean"
+},
+"queryPlansPerMinute": {
+"description": "Number of query execution plans captured by Insights per minute for all queries combined. The default value is 200. Any integer between 0 to 200 is considered valid.",
+"format": "int32",
+"type": "integer"
+},
+"recordApplicationTags": {
+"description": "Record application tags for an instance. This flag is turned \"off\" by default.",
+"type": "boolean"
+},
+"trackActiveQueries": {
+"description": "Track actively running queries on the instance. If not set, this flag is \"off\" by default.",
+"type": "boolean"
+},
+"trackWaitEventTypes": {
+"description": "Output only. Track wait event types during query execution for an instance. This flag is turned \"on\" by default but tracking is enabled only after observability enabled flag is also turned on. This is read-only flag and only modifiable by internal API.",
+"readOnly": true,
+"type": "boolean"
+},
+"trackWaitEvents": {
+"description": "Track wait events during query execution for an instance. This flag is turned \"on\" by default but tracking is enabled only after observability enabled flag is also turned on.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "Operation": {
 "description": "This resource represents a long-running operation that is the result of a network API call.",
 "id": "Operation",
@@ -3270,6 +3359,11 @@ false
 "readOnly": true,
 "type": "string"
 },
+"upgradeClusterStatus": {
+"$ref": "UpgradeClusterStatus",
+"description": "Output only. UpgradeClusterStatus related metadata.",
+"readOnly": true
+},
 "verb": {
 "description": "Output only. Name of the verb executed by the operation.",
 "readOnly": true,
@@ -3312,6 +3406,36 @@ false
 },
 "type": "object"
 },
+"PscAutoConnectionConfig": {
+"description": "Configuration for setting up PSC service automation. Consumer projects in the configs will be allowlisted automatically for the instance.",
+"id": "PscAutoConnectionConfig",
+"properties": {
+"consumerNetwork": {
+"description": "The consumer network for the PSC service automation, example: \"projects/vpc-host-project/global/networks/default\". The consumer network might be hosted a different project than the consumer project.",
+"type": "string"
+},
+"consumerNetworkStatus": {
+"description": "Output only. The status of the service connection policy.",
+"readOnly": true,
+"type": "string"
+},
+"consumerProject": {
+"description": "The consumer project to which the PSC service automation endpoint will be created.",
+"type": "string"
+},
+"ipAddress": {
+"description": "Output only. The IP address of the PSC service automation endpoint.",
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"description": "Output only. The status of the PSC service automation connection.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "PscConfig": {
 "description": "PscConfig contains PSC related configuration at a cluster level.",
 "id": "PscConfig",
@@ -3340,6 +3464,13 @@ false
 },
 "type": "array"
 },
+"pscAutoConnections": {
+"description": "Optional. Configurations for setting up PSC service automation.",
+"items": {
+"$ref": "PscAutoConnectionConfig"
+},
+"type": "array"
+},
 "pscDnsName": {
 "description": "Output only. The DNS name of the instance for PSC connectivity. Name convention: ...alloydb-psc.goog",
 "readOnly": true,
@@ -3439,6 +3570,17 @@ false
 },
 "type": "object"
 },
+"ReadPoolInstancesUpgradeStageStatus": {
+"description": "Read pool instances upgrade specific status.",
+"id": "ReadPoolInstancesUpgradeStageStatus",
+"properties": {
+"upgradeStats": {
+"$ref": "Stats",
+"description": "Read pool instances upgrade statistics."
+}
+},
+"type": "object"
+},
 "RestartInstanceRequest": {
 "id": "RestartInstanceRequest",
 "properties": {
@@ -3491,6 +3633,25 @@ false
 },
 "type": "object"
 },
+"RestoreFromCloudSQLRequest": {
+"description": "Message for registering Restoring from CloudSQL resource.",
+"id": "RestoreFromCloudSQLRequest",
+"properties": {
+"cloudsqlBackupRunSource": {
+"$ref": "CloudSQLBackupRunSource",
+"description": "Cluster created from CloudSQL backup run."
+},
+"cluster": {
+"$ref": "Cluster",
+"description": "Required. The resource being created"
+},
+"clusterId": {
+"description": "Required. ID of the requesting object.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "SecondaryConfig": {
 "description": "Configuration information for the secondary cluster. This should be set if and only if the cluster is of type SECONDARY.",
 "id": "SecondaryConfig",
@@ -3640,6 +3801,92 @@ false
 },
 "type": "object"
 },
+"StageStatus": {
+"description": "Status of an upgrade stage.",
+"id": "StageStatus",
+"properties": {
+"readPoolInstancesUpgrade": {
+"$ref": "ReadPoolInstancesUpgradeStageStatus",
+"description": "Read pool instances upgrade metadata."
+},
+"stage": {
+"description": "Upgrade stage.",
+"enum": [
+"STAGE_UNSPECIFIED",
+"ALLOYDB_PRECHECK",
+"PG_UPGRADE_CHECK",
+"PREPARE_FOR_UPGRADE",
+"PRIMARY_INSTANCE_UPGRADE",
+"READ_POOL_INSTANCES_UPGRADE",
+"ROLLBACK",
+"CLEANUP"
+],
+"enumDescriptions": [
+"Unspecified stage.",
+"Pre-upgrade custom checks, not covered by pg_upgrade.",
+"Pre-upgrade pg_upgrade checks.",
+"Clone the original cluster.",
+"Upgrade the primary instance(downtime).",
+"This stage is read pool upgrade.",
+"Rollback in case of critical failures.",
+"Cleanup."
+],
+"type": "string"
+},
+"state": {
+"description": "State of this stage.",
+"enum": [
+"STATUS_UNSPECIFIED",
+"NOT_STARTED",
+"IN_PROGRESS",
+"SUCCESS",
+"FAILED",
+"PARTIAL_SUCCESS",
+"CANCEL_IN_PROGRESS",
+"CANCELLED"
+],
+"enumDescriptions": [
+"Unspecified status.",
+"Not started.",
+"In progress.",
+"Operation succeeded.",
+"Operation failed.",
+"Operation partially succeeded.",
+"Cancel is in progress.",
+"Cancellation complete."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"Stats": {
+"description": "Upgrade stats for read pool instances.",
+"id": "Stats",
+"properties": {
+"failed": {
+"description": "Number of read pool instances which failed to upgrade.",
+"format": "int32",
+"type": "integer"
+},
+"notStarted": {
+"description": "Number of read pool instances for which upgrade has not started.",
+"format": "int32",
+"type": "integer"
+},
+"ongoing": {
+"description": "Number of read pool instances undergoing upgrade.",
+"format": "int32",
+"type": "integer"
+},
+"success": {
+"description": "Number of read pool instances successfully upgraded.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "Status": {
 "description": "The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).",
 "id": "Status",
@@ -4033,7 +4280,8 @@ false
 "SIGNAL_TYPE_RESOURCE_SUSPENDED",
 "SIGNAL_TYPE_EXPENSIVE_COMMANDS",
 "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED",
-"SIGNAL_TYPE_NO_DELETION_PROTECTION"
+"SIGNAL_TYPE_NO_DELETION_PROTECTION",
+"SIGNAL_TYPE_INEFFICIENT_QUERY"
 ],
 "enumDeprecated": [
 false,
@@ -4122,6 +4370,7 @@ false,
 false,
 false,
 false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -4211,7 +4460,8 @@ false
 "Detects if a database instance/cluster is suspended.",
 "Detects that expensive commands are being run on a database instance impacting overall performance.",
 "Indicates that the instance does not have a maintenance policy configured.",
-"Deletion Protection Disabled for the resource"
+"Deletion Protection Disabled for the resource",
+"Indicates that the instance has inefficient queries detected."
 ],
 "type": "string"
 },
@@ -4275,7 +4525,7 @@ false
 "type": "object"
 },
 "StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata": {
-"description": "Common model for database resource instance metadata. Next ID: 24",
+"description": "Common model for database resource instance metadata. Next ID: 25",
 "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata",
 "properties": {
 "availabilityConfiguration": {
@@ -4360,6 +4610,10 @@ false
 ],
 "type": "string"
 },
+"gcbdrConfiguration": {
+"$ref": "StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration",
+"description": "GCBDR configuration for the resource."
+},
 "id": {
 "$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId",
 "description": "Required. Unique identifier for a Database resource"
@@ -4436,7 +4690,7 @@ false
 "type": "string"
 },
 "suspensionReason": {
-"description": "Suspension reason for the resource.",
+"description": "Optional. Suspension reason for the resource.",
 "enum": [
 "SUSPENSION_REASON_UNSPECIFIED",
 "WIPEOUT_HIDE_EVENT",
@@ -4615,7 +4869,8 @@ false
 "SIGNAL_TYPE_RESOURCE_SUSPENDED",
 "SIGNAL_TYPE_EXPENSIVE_COMMANDS",
 "SIGNAL_TYPE_NO_MAINTENANCE_POLICY_CONFIGURED",
-"SIGNAL_TYPE_NO_DELETION_PROTECTION"
+"SIGNAL_TYPE_NO_DELETION_PROTECTION",
+"SIGNAL_TYPE_INEFFICIENT_QUERY"
 ],
 "enumDeprecated": [
 false,
@@ -4704,6 +4959,7 @@ false,
 false,
 false,
 false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -4793,7 +5049,8 @@ false
 "Detects if a database instance/cluster is suspended.",
 "Detects that expensive commands are being run on a database instance impacting overall performance.",
 "Indicates that the instance does not have a maintenance policy configured.",
-"Deletion Protection Disabled for the resource"
+"Deletion Protection Disabled for the resource",
+"Indicates that the instance has inefficient queries detected."
 ],
 "type": "string"
 }
@@ -4843,6 +5100,17 @@ false
 },
 "type": "object"
 },
+"StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration": {
+"description": "GCBDR Configuration for the resource.",
+"id": "StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration",
+"properties": {
+"gcbdrManaged": {
+"description": "Whether the resource is managed by GCBDR.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata": {
 "description": "Metadata for individual internal resources in an instance. e.g. spanner instance can have multiple databases with unique configuration settings. Similarly bigtable can have multiple clusters within same bigtable instance.",
 "id": "StorageDatabasecenterPartnerapiV1mainInternalResourceMetadata",
@@ -4878,12 +5146,12 @@ false
 "properties": {
 "cpuCount": {
 "deprecated": true,
-"description": "The number of CPUs. Deprecated. Use vcpu_count instead. TODO(b/342344482, b/342346271) add proto validations again after bug fix.",
+"description": "The number of CPUs. Deprecated. Use vcpu_count instead. TODO(b/342344482) add proto validations again after bug fix.",
 "format": "int32",
 "type": "integer"
 },
 "memorySizeInBytes": {
-"description": "Memory size in bytes. TODO(b/342344482, b/342346271) add proto validations again after bug fix.",
+"description": "Memory size in bytes. TODO(b/342344482) add proto validations again after bug fix.",
 "format": "int64",
 "type": "string"
 },
@@ -4893,7 +5161,7 @@ false
 "type": "integer"
 },
 "vcpuCount": {
-"description": "Optional. The number of vCPUs. TODO(b/342344482, b/342346271) add proto validations again after bug fix.",
+"description": "Optional. The number of vCPUs. TODO(b/342344482) add proto validations again after bug fix.",
 "format": "double",
 "type": "number"
 }
@@ -5243,10 +5511,33 @@ false
 "description": "The name of the flag resource, following Google Cloud conventions, e.g.: * projects/{project}/locations/{location}/flags/{flag} This field currently has no semantic meaning.",
 "type": "string"
 },
+"recommendedIntegerValue": {
+"description": "The recommended value for an INTEGER flag.",
+"format": "int64",
+"type": "string"
+},
+"recommendedStringValue": {
+"description": "The recommended value for a STRING flag.",
+"type": "string"
+},
 "requiresDbRestart": {
 "description": "Whether setting or updating this flag on an Instance requires a database restart. If a flag that requires database restart is set, the backend will automatically restart the database (making sure to satisfy any availability SLO's).",
 "type": "boolean"
 },
+"scope": {
+"description": "The scope of the flag.",
+"enum": [
+"SCOPE_UNSPECIFIED",
+"DATABASE",
+"CONNECTION_POOL"
+],
+"enumDescriptions": [
+"The scope of the flag is not specified. Default is DATABASE.",
+"The flag is a database flag.",
+"The flag is a connection pool flag."
+],
+"type": "string"
+},
 "stringRestrictions": {
 "$ref": "StringRestrictions",
 "description": "Restriction on STRING type value."
@@ -5439,6 +5730,98 @@ false
 },
 "type": "object"
 },
+"UpgradeClusterStatus": {
+"description": "Message for current status of the Major Version Upgrade operation.",
+"id": "UpgradeClusterStatus",
+"properties": {
+"cancellable": {
+"description": "Whether the operation is cancellable.",
+"type": "boolean"
+},
+"sourceVersion": {
+"description": "Source database major version.",
+"enum": [
+"DATABASE_VERSION_UNSPECIFIED",
+"POSTGRES_13",
+"POSTGRES_14",
+"POSTGRES_15",
+"POSTGRES_16"
+],
+"enumDeprecated": [
+false,
+true,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"This is an unknown database version.",
+"DEPRECATED - The database version is Postgres 13.",
+"The database version is Postgres 14.",
+"The database version is Postgres 15.",
+"The database version is Postgres 16."
+],
+"type": "string"
+},
+"stages": {
+"description": "Status of all upgrade stages.",
+"items": {
+"$ref": "StageStatus"
+},
+"type": "array"
+},
+"state": {
+"description": "Cluster Major Version Upgrade state.",
+"enum": [
+"STATUS_UNSPECIFIED",
+"NOT_STARTED",
+"IN_PROGRESS",
+"SUCCESS",
+"FAILED",
+"PARTIAL_SUCCESS",
+"CANCEL_IN_PROGRESS",
+"CANCELLED"
+],
+"enumDescriptions": [
+"Unspecified status.",
+"Not started.",
+"In progress.",
+"Operation succeeded.",
+"Operation failed.",
+"Operation partially succeeded.",
+"Cancel is in progress.",
+"Cancellation complete."
+],
+"type": "string"
+},
+"targetVersion": {
+"description": "Target database major version.",
+"enum": [
+"DATABASE_VERSION_UNSPECIFIED",
+"POSTGRES_13",
+"POSTGRES_14",
+"POSTGRES_15",
+"POSTGRES_16"
+],
+"enumDeprecated": [
+false,
+true,
+false,
+false,
+false
+],
+"enumDescriptions": [
+"This is an unknown database version.",
+"DEPRECATED - The database version is Postgres 13.",
+"The database version is Postgres 14.",
+"The database version is Postgres 15.",
+"The database version is Postgres 16."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "User": {
 "description": "Message describing User object.",
 "id": "User",