feat: [google-cloud-alloydb] add new PSC instance configuration setti…

…ng and output the PSC DNS name (#13193)

- [ ] Regenerate this pull request now.

BEGIN_COMMIT_OVERRIDE
feat: add new PSC instance configuration setting and output the PSC DNS
name
feat: add new API to execute SQL statements
feat: add support for Free Trials
feat: add support to schedule maintenance
feat: additional field to set tags on a backup or cluster
feat: add more observability options on the Instance level
feat: add new API to perform a promotion or switchover on secondary
instances
feat: support for obtaining the public ip addresses of an instance and
enabling either inbound or outbound public ip
feat: add new API to list the databases in a project and location
feat: add optional field to keep extra roles on a user if it already
exists
docs: various typo fixes, correcting the formatting, and clarifications
on the request_id and validate_only fields in API requests and on the
page_size when listing the database
END_COMMIT_OVERRIDE



PiperOrigin-RevId: 688544999

Source-Link:
googleapis/googleapis@113ddfe

Source-Link:
googleapis/googleapis-gen@14fa50e
Copy-Tag:
eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWFsbG95ZGIvLk93bEJvdC55YW1sIiwiaCI6IjE0ZmE1MGVkZDU3NjI5YWIzMThiYjdiOThhNzI4NmI0Njc0OWU4ZGYifQ==

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Anthonios Partheniou <partheniou@google.com>

packages/google-cloud-alloydb/google/cloud/alloydb/__init__.py

@@ -22,6 +22,12 @@
     AlloyDBAdminAsyncClient,
 )
 from google.cloud.alloydb_v1.services.alloy_db_admin.client import AlloyDBAdminClient
+from google.cloud.alloydb_v1.types.data_model import (
+    SqlResult,
+    SqlResultColumn,
+    SqlResultRow,
+    SqlResultValue,
+)
 from google.cloud.alloydb_v1.types.resources import (
     AutomatedBackupPolicy,
     Backup,
@@ -32,13 +38,17 @@
     ContinuousBackupConfig,
     ContinuousBackupInfo,
     ContinuousBackupSource,
+    Database,
     DatabaseVersion,
     EncryptionConfig,
     EncryptionInfo,
     Instance,
     InstanceView,
+    MaintenanceSchedule,
+    MaintenanceUpdatePolicy,
     MigrationSource,
     SslConfig,
+    SubscriptionType,
     SupportedDatabaseFlag,
     User,
     UserPassword,
@@ -59,6 +69,9 @@
     DeleteClusterRequest,
     DeleteInstanceRequest,
     DeleteUserRequest,
+    ExecuteSqlMetadata,
+    ExecuteSqlRequest,
+    ExecuteSqlResponse,
     FailoverInstanceRequest,
     GenerateClientCertificateRequest,
     GenerateClientCertificateResponse,
@@ -72,6 +85,8 @@
     ListBackupsResponse,
     ListClustersRequest,
     ListClustersResponse,
+    ListDatabasesRequest,
+    ListDatabasesResponse,
     ListInstancesRequest,
     ListInstancesResponse,
     ListSupportedDatabaseFlagsRequest,
@@ -82,6 +97,7 @@
     PromoteClusterRequest,
     RestartInstanceRequest,
     RestoreClusterRequest,
+    SwitchoverClusterRequest,
     UpdateBackupRequest,
     UpdateClusterRequest,
     UpdateInstanceRequest,
@@ -91,6 +107,10 @@
 __all__ = (
     "AlloyDBAdminClient",
     "AlloyDBAdminAsyncClient",
+    "SqlResult",
+    "SqlResultColumn",
+    "SqlResultRow",
+    "SqlResultValue",
     "AutomatedBackupPolicy",
     "Backup",
     "BackupSource",
@@ -99,9 +119,12 @@
     "ContinuousBackupConfig",
     "ContinuousBackupInfo",
     "ContinuousBackupSource",
+    "Database",
     "EncryptionConfig",
     "EncryptionInfo",
     "Instance",
+    "MaintenanceSchedule",
+    "MaintenanceUpdatePolicy",
     "MigrationSource",
     "SslConfig",
     "SupportedDatabaseFlag",
@@ -110,6 +133,7 @@
     "ClusterView",
     "DatabaseVersion",
     "InstanceView",
+    "SubscriptionType",
     "BatchCreateInstancesMetadata",
     "BatchCreateInstancesRequest",
     "BatchCreateInstancesResponse",
@@ -125,6 +149,9 @@
     "DeleteClusterRequest",
     "DeleteInstanceRequest",
     "DeleteUserRequest",
+    "ExecuteSqlMetadata",
+    "ExecuteSqlRequest",
+    "ExecuteSqlResponse",
     "FailoverInstanceRequest",
     "GenerateClientCertificateRequest",
     "GenerateClientCertificateResponse",
@@ -138,6 +165,8 @@
     "ListBackupsResponse",
     "ListClustersRequest",
     "ListClustersResponse",
+    "ListDatabasesRequest",
+    "ListDatabasesResponse",
     "ListInstancesRequest",
     "ListInstancesResponse",
     "ListSupportedDatabaseFlagsRequest",
@@ -148,6 +177,7 @@
     "PromoteClusterRequest",
     "RestartInstanceRequest",
     "RestoreClusterRequest",
+    "SwitchoverClusterRequest",
     "UpdateBackupRequest",
     "UpdateClusterRequest",
     "UpdateInstanceRequest",

packages/google-cloud-alloydb/google/cloud/alloydb_v1/__init__.py

@@ -19,6 +19,7 @@
 
 
 from .services.alloy_db_admin import AlloyDBAdminAsyncClient, AlloyDBAdminClient
+from .types.data_model import SqlResult, SqlResultColumn, SqlResultRow, SqlResultValue
 from .types.resources import (
     AutomatedBackupPolicy,
     Backup,
@@ -29,13 +30,17 @@
     ContinuousBackupConfig,
     ContinuousBackupInfo,
     ContinuousBackupSource,
+    Database,
     DatabaseVersion,
     EncryptionConfig,
     EncryptionInfo,
     Instance,
     InstanceView,
+    MaintenanceSchedule,
+    MaintenanceUpdatePolicy,
     MigrationSource,
     SslConfig,
+    SubscriptionType,
     SupportedDatabaseFlag,
     User,
     UserPassword,
@@ -56,6 +61,9 @@
     DeleteClusterRequest,
     DeleteInstanceRequest,
     DeleteUserRequest,
+    ExecuteSqlMetadata,
+    ExecuteSqlRequest,
+    ExecuteSqlResponse,
     FailoverInstanceRequest,
     GenerateClientCertificateRequest,
     GenerateClientCertificateResponse,
@@ -69,6 +77,8 @@
     ListBackupsResponse,
     ListClustersRequest,
     ListClustersResponse,
+    ListDatabasesRequest,
+    ListDatabasesResponse,
     ListInstancesRequest,
     ListInstancesResponse,
     ListSupportedDatabaseFlagsRequest,
@@ -79,6 +89,7 @@
     PromoteClusterRequest,
     RestartInstanceRequest,
     RestoreClusterRequest,
+    SwitchoverClusterRequest,
     UpdateBackupRequest,
     UpdateClusterRequest,
     UpdateInstanceRequest,
@@ -108,13 +119,17 @@
     "CreateSecondaryClusterRequest",
     "CreateSecondaryInstanceRequest",
     "CreateUserRequest",
+    "Database",
     "DatabaseVersion",
     "DeleteBackupRequest",
     "DeleteClusterRequest",
     "DeleteInstanceRequest",
     "DeleteUserRequest",
     "EncryptionConfig",
     "EncryptionInfo",
+    "ExecuteSqlMetadata",
+    "ExecuteSqlRequest",
+    "ExecuteSqlResponse",
     "FailoverInstanceRequest",
     "GenerateClientCertificateRequest",
     "GenerateClientCertificateResponse",
@@ -130,19 +145,29 @@
     "ListBackupsResponse",
     "ListClustersRequest",
     "ListClustersResponse",
+    "ListDatabasesRequest",
+    "ListDatabasesResponse",
     "ListInstancesRequest",
     "ListInstancesResponse",
     "ListSupportedDatabaseFlagsRequest",
     "ListSupportedDatabaseFlagsResponse",
     "ListUsersRequest",
     "ListUsersResponse",
+    "MaintenanceSchedule",
+    "MaintenanceUpdatePolicy",
     "MigrationSource",
     "OperationMetadata",
     "PromoteClusterRequest",
     "RestartInstanceRequest",
     "RestoreClusterRequest",
+    "SqlResult",
+    "SqlResultColumn",
+    "SqlResultRow",
+    "SqlResultValue",
     "SslConfig",
+    "SubscriptionType",
     "SupportedDatabaseFlag",
+    "SwitchoverClusterRequest",
     "UpdateBackupRequest",
     "UpdateClusterRequest",
     "UpdateInstanceRequest",

packages/google-cloud-alloydb/google/cloud/alloydb_v1/gapic_metadata.json

@@ -65,6 +65,11 @@
                 "delete_user"
               ]
             },
+            "ExecuteSql": {
+              "methods": [
+                "execute_sql"
+              ]
+            },
             "FailoverInstance": {
               "methods": [
                 "failover_instance"
@@ -115,6 +120,11 @@
                 "list_clusters"
               ]
             },
+            "ListDatabases": {
+              "methods": [
+                "list_databases"
+              ]
+            },
             "ListInstances": {
               "methods": [
                 "list_instances"
@@ -145,6 +155,11 @@
                 "restore_cluster"
               ]
             },
+            "SwitchoverCluster": {
+              "methods": [
+                "switchover_cluster"
+              ]
+            },
             "UpdateBackup": {
               "methods": [
                 "update_backup"
@@ -225,6 +240,11 @@
                 "delete_user"
               ]
             },
+            "ExecuteSql": {
+              "methods": [
+                "execute_sql"
+              ]
+            },
             "FailoverInstance": {
               "methods": [
                 "failover_instance"
@@ -275,6 +295,11 @@
                 "list_clusters"
               ]
             },
+            "ListDatabases": {
+              "methods": [
+                "list_databases"
+              ]
+            },
             "ListInstances": {
               "methods": [
                 "list_instances"
@@ -305,6 +330,11 @@
                 "restore_cluster"
               ]
             },
+            "SwitchoverCluster": {
+              "methods": [
+                "switchover_cluster"
+              ]
+            },
             "UpdateBackup": {
               "methods": [
                 "update_backup"
@@ -385,6 +415,11 @@
                 "delete_user"
               ]
             },
+            "ExecuteSql": {
+              "methods": [
+                "execute_sql"
+              ]
+            },
             "FailoverInstance": {
               "methods": [
                 "failover_instance"
@@ -435,6 +470,11 @@
                 "list_clusters"
               ]
             },
+            "ListDatabases": {
+              "methods": [
+                "list_databases"
+              ]
+            },
             "ListInstances": {
               "methods": [
                 "list_instances"
@@ -465,6 +505,11 @@
                 "restore_cluster"
               ]
             },
+            "SwitchoverCluster": {
+              "methods": [
+                "switchover_cluster"
+              ]
+            },
             "UpdateBackup": {
               "methods": [
                 "update_backup"