fix: [alloydb] deprecated various PSC instance configuration fields (#…

…5793)

* fix: deprecated various PSC instance configuration fields
feat: add new PSC instance configuration setting and output the PSC DNS name
feat: add new API to upgrade a cluster
feat: add new API to execute SQL statements
feat: add new cluster and instance level configurations to interact with Gemini
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: add new CloudSQL backup resource
feat: support for obtaining the public ip addresses of an instance and enabling outbound public ip
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

PiperOrigin-RevId: 694277265

Source-Link: googleapis/googleapis@f9f62cb

Source-Link: googleapis/googleapis-gen@c94213d
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWFsbG95ZGIvLk93bEJvdC55YW1sIiwiaCI6ImM5NDIxM2RlOThjZmEzYmE1MTM5OTE4MDJhMTQyOTAxYTNkZWQxYzUifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* fix: deprecated various PSC instance configuration fields
feat: add new PSC instance configuration setting and output the PSC DNS name
feat: add new API to upgrade a cluster
feat: add new API to execute SQL statements
feat: add new cluster and instance level configurations to interact with Gemini
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: add new CloudSQL backup resource
feat: support for obtaining the public ip addresses of an instance and enabling outbound public ip
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

PiperOrigin-RevId: 694626053

Source-Link: googleapis/googleapis@c72f219

Source-Link: googleapis/googleapis-gen@ba9e7c8
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWFsbG95ZGIvLk93bEJvdC55YW1sIiwiaCI6ImJhOWU3Yzg3OTA2NjIzMjM2MGFjNjZkOWMyYzc0ZjI3ZTg2ZTdkNDQifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

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

packages/google-cloud-alloydb/protos/google/cloud/alloydb/v1alpha/csql_resources.proto

@@ -0,0 +1,40 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.alloydb.v1alpha;
+
+import "google/api/field_behavior.proto";
+
+option csharp_namespace = "Google.Cloud.AlloyDb.V1Alpha";
+option go_package = "cloud.google.com/go/alloydb/apiv1alpha/alloydbpb;alloydbpb";
+option java_multiple_files = true;
+option java_outer_classname = "CsqlResourcesProto";
+option java_package = "com.google.cloud.alloydb.v1alpha";
+option php_namespace = "Google\\Cloud\\AlloyDb\\V1alpha";
+option ruby_package = "Google::Cloud::AlloyDB::V1alpha";
+
+// The source CloudSQL backup resource.
+message CloudSQLBackupRunSource {
+  // The project ID of the source CloudSQL instance. This should be the same as
+  // the AlloyDB cluster's project.
+  string project = 1;
+
+  // Required. The CloudSQL instance ID.
+  string instance_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The CloudSQL backup run ID.
+  int64 backup_run_id = 3 [(google.api.field_behavior) = REQUIRED];
+}

packages/google-cloud-alloydb/protos/google/cloud/alloydb/v1alpha/data_model.proto

@@ -0,0 +1,62 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.alloydb.v1alpha;
+
+option csharp_namespace = "Google.Cloud.AlloyDb.V1Alpha";
+option go_package = "cloud.google.com/go/alloydb/apiv1alpha/alloydbpb;alloydbpb";
+option java_multiple_files = true;
+option java_outer_classname = "DataModelProto";
+option java_package = "com.google.cloud.alloydb.v1alpha";
+option php_namespace = "Google\\Cloud\\AlloyDb\\V1alpha";
+option ruby_package = "Google::Cloud::AlloyDB::V1alpha";
+
+// SqlResult represents the result for the execution of a sql statement.
+message SqlResult {
+  // List of columns included in the result. This also includes the data type
+  // of the column.
+  repeated SqlResultColumn columns = 1;
+
+  // Rows returned by the SQL statement.
+  repeated SqlResultRow rows = 2;
+}
+
+// Contains the name and datatype of a column in a SQL Result.
+message SqlResultColumn {
+  // Name of the column.
+  string name = 1;
+
+  // Datatype of the column as reported by the postgres driver.
+  // Common type names are "VARCHAR", "TEXT", "NVARCHAR", "DECIMAL", "BOOL",
+  // "INT", and "BIGINT".
+  string type = 2;
+}
+
+// A single row from a sql result.
+message SqlResultRow {
+  // List of values in a row of sql result.
+  repeated SqlResultValue values = 1;
+}
+
+// A single value in a row from a sql result.
+message SqlResultValue {
+  // The cell value represented in string format.
+  // Timestamps are converted to string using RFC3339Nano format.
+  optional string value = 1;
+
+  // Set to true if cell value is null.
+  optional bool null_value = 2;
+}

packages/google-cloud-alloydb/protos/google/cloud/alloydb/v1alpha/gemini.proto

@@ -0,0 +1,47 @@
+// Copyright 2024 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+syntax = "proto3";
+
+package google.cloud.alloydb.v1alpha;
+
+import "google/api/field_behavior.proto";
+
+option csharp_namespace = "Google.Cloud.AlloyDb.V1Alpha";
+option go_package = "cloud.google.com/go/alloydb/apiv1alpha/alloydbpb;alloydbpb";
+option java_multiple_files = true;
+option java_outer_classname = "GeminiProto";
+option java_package = "com.google.cloud.alloydb.v1alpha";
+option php_namespace = "Google\\Cloud\\AlloyDb\\V1alpha";
+option ruby_package = "Google::Cloud::AlloyDB::V1alpha";
+
+// Cluster level configuration parameters related to the Gemini in Databases
+// add-on.
+message GeminiClusterConfig {
+  // Output only. Whether the Gemini in Databases add-on is enabled for the
+  // cluster. It will be true only if the add-on has been enabled for the
+  // billing account corresponding to the cluster. Its status is toggled from
+  // the Admin Control Center (ACC) and cannot be toggled using AlloyDB's APIs.
+  bool entitled = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// Instance level configuration parameters related to the Gemini in Databases
+// add-on.
+message GeminiInstanceConfig {
+  // Output only. Whether the Gemini in Databases add-on is enabled for the
+  // instance. It will be true only if the add-on has been enabled for the
+  // billing account corresponding to the instance. Its status is toggled from
+  // the Admin Control Center (ACC) and cannot be toggled using AlloyDB's APIs.
+  bool entitled = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+}