google-cloud-alloy_db-v1beta 0.9.0 → 0.11.0

data/proto_docs/google/cloud/alloydb/v1beta/csql_resources.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+# 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module AlloyDB
+      module V1beta
+        # The source CloudSQL backup resource.
+        # @!attribute [rw] project
+        #   @return [::String]
+        #     The project ID of the source CloudSQL instance. This should be the same as
+        #     the AlloyDB cluster's project.
+        # @!attribute [rw] instance_id
+        #   @return [::String]
+        #     Required. The CloudSQL instance ID.
+        # @!attribute [rw] backup_run_id
+        #   @return [::Integer]
+        #     Required. The CloudSQL backup run ID.
+        class CloudSQLBackupRunSource
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/alloydb/v1beta/data_model.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+# 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module AlloyDB
+      module V1beta
+        # SqlResult represents the result for the execution of a sql statement.
+        # @!attribute [rw] columns
+        #   @return [::Array<::Google::Cloud::AlloyDB::V1beta::SqlResultColumn>]
+        #     List of columns included in the result. This also includes the data type
+        #     of the column.
+        # @!attribute [rw] rows
+        #   @return [::Array<::Google::Cloud::AlloyDB::V1beta::SqlResultRow>]
+        #     Rows returned by the SQL statement.
+        class SqlResult
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Contains the name and datatype of a column in a SQL Result.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Name of the column.
+        # @!attribute [rw] type
+        #   @return [::String]
+        #     Datatype of the column as reported by the postgres driver.
+        #     Common type names are "VARCHAR", "TEXT", "NVARCHAR", "DECIMAL", "BOOL",
+        #     "INT", and "BIGINT".
+        class SqlResultColumn
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A single row from a sql result.
+        # @!attribute [rw] values
+        #   @return [::Array<::Google::Cloud::AlloyDB::V1beta::SqlResultValue>]
+        #     List of values in a row of sql result.
+        class SqlResultRow
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A single value in a row from a sql result.
+        # @!attribute [rw] value
+        #   @return [::String]
+        #     The cell value represented in string format.
+        #     Timestamps are converted to string using RFC3339Nano format.
+        # @!attribute [rw] null_value
+        #   @return [::Boolean]
+        #     Set to true if cell value is null.
+        class SqlResultValue
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/alloydb/v1beta/gemini.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# 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
+#
+#     https://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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module AlloyDB
+      module V1beta
+        # Cluster level configuration parameters related to the Gemini in Databases
+        # add-on.
+        # @!attribute [r] entitled
+        #   @return [::Boolean]
+        #     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.
+        class GeminiClusterConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Instance level configuration parameters related to the Gemini in Databases
+        # add-on.
+        # @!attribute [r] entitled
+        #   @return [::Boolean]
+        #     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.
+        class GeminiInstanceConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/alloydb/v1beta/resources.rb

@@ -114,7 +114,7 @@ module Google
 
           # SSL mode options.
           module SslMode
-            # SSL mode not specified. Defaults to ENCRYPTED_ONLY.
+            # SSL mode is not specified. Defaults to ENCRYPTED_ONLY.
             SSL_MODE_UNSPECIFIED = 0
 
             # SSL connections are optional. CA verification not enforced.
@@ -126,7 +126,7 @@ module Google
             SSL_MODE_REQUIRE = 2
 
             # SSL connections are required. CA verification enforced.
-            # Clients must have certificates signed by a Cluster CA, e.g. via
+            # Clients must have certificates signed by a Cluster CA, for example, using
             # GenerateClientCertificate.
             SSL_MODE_VERIFY_CA = 3
 
@@ -364,6 +364,9 @@ module Google
         # @!attribute [r] migration_source
         #   @return [::Google::Cloud::AlloyDB::V1beta::MigrationSource]
         #     Output only. Cluster created via DMS migration.
+        # @!attribute [r] cloudsql_backup_run_source
+        #   @return [::Google::Cloud::AlloyDB::V1beta::CloudSQLBackupRunSource]
+        #     Output only. Cluster created from CloudSQL snapshot.
         # @!attribute [r] name
         #   @return [::String]
         #     Output only. The name of the cluster resource with the format:
@@ -473,6 +476,10 @@ module Google
         # @!attribute [r] satisfies_pzs
         #   @return [::Boolean]
         #     Output only. Reserved for future use.
+        # @!attribute [rw] psc_config
+        #   @return [::Google::Cloud::AlloyDB::V1beta::Cluster::PscConfig]
+        #     Optional. The configuration for Private Service Connect (PSC) for the
+        #     cluster.
         # @!attribute [rw] maintenance_update_policy
         #   @return [::Google::Cloud::AlloyDB::V1beta::MaintenanceUpdatePolicy]
         #     Optional. The maintenance update policy determines when to allow or deny
@@ -481,6 +488,24 @@ module Google
         #   @return [::Google::Cloud::AlloyDB::V1beta::MaintenanceSchedule]
         #     Output only. The maintenance schedule for the cluster, generated for a
         #     specific rollout if a maintenance window is set.
+        # @!attribute [rw] gemini_config
+        #   @return [::Google::Cloud::AlloyDB::V1beta::GeminiClusterConfig]
+        #     Optional. Configuration parameters related to the Gemini in Databases
+        #     add-on.
+        # @!attribute [rw] subscription_type
+        #   @return [::Google::Cloud::AlloyDB::V1beta::SubscriptionType]
+        #     Optional. Subscription type of the cluster.
+        # @!attribute [r] trial_metadata
+        #   @return [::Google::Cloud::AlloyDB::V1beta::Cluster::TrialMetadata]
+        #     Output only. Metadata for free trial clusters
+        # @!attribute [rw] tags
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Input only. Immutable. Tag keys/values directly bound to this
+        #     resource. For example:
+        #     ```
+        #     "123/environment": "production",
+        #     "123/costCenter": "marketing"
+        #     ```
         class Cluster
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -531,6 +556,34 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # PscConfig contains PSC related configuration at a cluster level.
+          # @!attribute [rw] psc_enabled
+          #   @return [::Boolean]
+          #     Optional. Create an instance that allows connections from Private Service
+          #     Connect endpoints to the instance.
+          class PscConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Contains information and all metadata related to TRIAL clusters.
+          # @!attribute [rw] start_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     start time of the trial cluster.
+          # @!attribute [rw] end_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     End time of the trial cluster.
+          # @!attribute [rw] upgrade_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     Upgrade time of trial cluster to Standard cluster.
+          # @!attribute [rw] grace_end_time
+          #   @return [::Google::Protobuf::Timestamp]
+          #     grace end time of the cluster.
+          class TrialMetadata
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # @!attribute [rw] key
           #   @return [::String]
           # @!attribute [rw] value
@@ -549,6 +602,15 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class TagsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Cluster State
           module State
             # The state of the cluster is unknown.
@@ -689,6 +751,9 @@ module Google
         # @!attribute [rw] query_insights_config
         #   @return [::Google::Cloud::AlloyDB::V1beta::Instance::QueryInsightsInstanceConfig]
         #     Configuration for query insights.
+        # @!attribute [rw] observability_config
+        #   @return [::Google::Cloud::AlloyDB::V1beta::Instance::ObservabilityInstanceConfig]
+        #     Configuration for observability.
         # @!attribute [rw] read_pool_config
         #   @return [::Google::Cloud::AlloyDB::V1beta::Instance::ReadPoolConfig]
         #     Read pool instance configuration.
@@ -735,7 +800,11 @@ module Google
         #     instance.
         # @!attribute [rw] network_config
         #   @return [::Google::Cloud::AlloyDB::V1beta::Instance::InstanceNetworkConfig]
-        #     Optional. Instance level network configuration.
+        #     Optional. Instance-level network configuration.
+        # @!attribute [rw] gemini_config
+        #   @return [::Google::Cloud::AlloyDB::V1beta::GeminiInstanceConfig]
+        #     Optional. Configuration parameters related to the Gemini in Databases
+        #     add-on.
         # @!attribute [r] outbound_public_ip_addresses
         #   @return [::Array<::String>]
         #     Output only. All outbound public IP addresses configured for the instance.
@@ -798,6 +867,51 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # Observability Instance specific configuration.
+          # @!attribute [rw] enabled
+          #   @return [::Boolean]
+          #     Observability feature status for an instance.
+          #     This flag is turned "off" by default.
+          # @!attribute [rw] preserve_comments
+          #   @return [::Boolean]
+          #     Preserve comments in query string for an instance.
+          #     This flag is turned "off" by default.
+          # @!attribute [rw] track_wait_events
+          #   @return [::Boolean]
+          #     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.
+          # @!attribute [r] track_wait_event_types
+          #   @return [::Boolean]
+          #     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 producer API.
+          # @!attribute [rw] max_query_string_length
+          #   @return [::Integer]
+          #     Query string length. The default value is 10k.
+          # @!attribute [rw] record_application_tags
+          #   @return [::Boolean]
+          #     Record application tags for an instance.
+          #     This flag is turned "off" by default.
+          # @!attribute [rw] query_plans_per_minute
+          #   @return [::Integer]
+          #     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.
+          # @!attribute [rw] track_active_queries
+          #   @return [::Boolean]
+          #     Track actively running queries on the instance.
+          #     If not set, this flag is "off" by default.
+          # @!attribute [rw] track_client_address
+          #   @return [::Boolean]
+          #     Track client address for an instance.
+          #     If not set, default value is "off".
+          class ObservabilityInstanceConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Configuration for a read pool instance.
           # @!attribute [rw] node_count
           #   @return [::Integer]
@@ -836,33 +950,12 @@ module Google
           #     connections to the database.
           # @!attribute [rw] ssl_config
           #   @return [::Google::Cloud::AlloyDB::V1beta::SslConfig]
-          #     Optional. SSL config option for this instance.
+          #     Optional. SSL configuration option for this instance.
           class ClientConnectionConfig
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # Configuration for setting up a PSC interface. This information needs to be
-          # provided by the customer.
-          # PSC interfaces will be created and added to VMs via SLM (adding a network
-          # interface will require recreating the VM). For HA instances this will be
-          # done via LDTM.
-          # @!attribute [rw] consumer_endpoint_ips
-          #   @return [::Array<::String>]
-          #     A list of endpoints in the consumer VPC the interface might initiate
-          #     outbound connections to. This list has to be provided when the PSC
-          #     interface is created.
-          # @!attribute [rw] network_attachment
-          #   @return [::String]
-          #     The NetworkAttachment resource created in the consumer VPC to which the
-          #     PSC interface will be linked, in the form of:
-          #     `projects/${CONSUMER_PROJECT}/regions/${REGION}/networkAttachments/${NETWORK_ATTACHMENT_NAME}`.
-          #     NetworkAttachment has to be provided when the PSC interface is created.
-          class PscInterfaceConfig
-            include ::Google::Protobuf::MessageExts
-            extend ::Google::Protobuf::MessageExts::ClassMethods
-          end
-
           # PscInstanceConfig contains PSC related configuration at an
           # instance level.
           # @!attribute [r] service_attachment_link
@@ -875,32 +968,16 @@ module Google
           #   @return [::Array<::String>]
           #     Optional. List of consumer projects that are allowed to create
           #     PSC endpoints to service-attachments to this instance.
-          # @!attribute [rw] allowed_consumer_networks
-          #   @return [::Array<::String>]
-          #     Optional. List of consumer networks that are allowed to create
-          #     PSC endpoints to service-attachments to this instance.
-          # @!attribute [rw] psc_interface_configs
-          #   @return [::Array<::Google::Cloud::AlloyDB::V1beta::Instance::PscInterfaceConfig>]
-          #     Optional. Configurations for setting up PSC interfaces attached to the
-          #     instance which are used for outbound connectivity. Only primary instances
-          #     can have PSC interface attached. All the VMs created for the primary
-          #     instance will share the same configurations. Currently we only support 0
-          #     or 1 PSC interface.
-          # @!attribute [rw] outgoing_service_attachment_links
-          #   @return [::Array<::String>]
-          #     Optional. List of service attachments that this instance has created
-          #     endpoints to connect with. Currently, only a single outgoing service
-          #     attachment is supported per instance.
-          # @!attribute [rw] psc_enabled
-          #   @return [::Boolean]
-          #     Optional. Whether PSC connectivity is enabled for this instance.
-          #     This is populated by referencing the value from the parent cluster.
+          # @!attribute [r] psc_dns_name
+          #   @return [::String]
+          #     Output only. The DNS name of the instance for PSC connectivity.
+          #     Name convention: <uid>.<uid>.<region>.alloydb-psc.goog
           class PscInstanceConfig
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
-          # Metadata related to instance level network configuration.
+          # Metadata related to instance-level network configuration.
           # @!attribute [rw] authorized_external_networks
           #   @return [::Array<::Google::Cloud::AlloyDB::V1beta::Instance::InstanceNetworkConfig::AuthorizedNetwork>]
           #     Optional. A list of external network authorized to access this instance.
@@ -1151,6 +1228,14 @@ module Google
         #     Output only. The database engine major version of the cluster this backup
         #     was created from. Any restored cluster created from this backup will have
         #     the same database version.
+        # @!attribute [rw] tags
+        #   @return [::Google::Protobuf::Map{::String => ::String}]
+        #     Optional. Input only. Immutable. Tag keys/values directly bound to this
+        #     resource. For example:
+        #     ```
+        #     "123/environment": "production",
+        #     "123/costCenter": "marketing"
+        #     ```
         class Backup
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1199,6 +1284,15 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::String]
+          class TagsEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # Backup State
           module State
             # The state of the backup is unknown.
@@ -1333,6 +1427,10 @@ module Google
         # @!attribute [rw] user_type
         #   @return [::Google::Cloud::AlloyDB::V1beta::User::UserType]
         #     Optional. Type of this user.
+        # @!attribute [rw] keep_extra_roles
+        #   @return [::Boolean]
+        #     Input only. If the user already exists and it has additional roles, keep
+        #     them granted.
         class User
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1417,6 +1515,24 @@ module Google
 
           # The database version is Postgres 15.
           POSTGRES_15 = 3
+
+          # The database version is Postgres 16.
+          POSTGRES_16 = 4
+        end
+
+        # Subscription_type added to distinguish between Standard and Trial
+        # subscriptions. By default, a subscription type is considered STANDARD unless
+        # explicitly specified.
+        module SubscriptionType
+          # This is an unknown subscription type. By default, the subscription type is
+          # STANDARD.
+          SUBSCRIPTION_TYPE_UNSPECIFIED = 0
+
+          # Standard subscription.
+          STANDARD = 1
+
+          # Trial subscription.
+          TRIAL = 2
         end
       end
     end