google-cloud-sql-v1 0.4.0 → 0.5.0

data/proto_docs/google/cloud/sql/v1/cloud_sql_blue_green_deployments.rb

@@ -0,0 +1,399 @@
+# frozen_string_literal: true
+
+# Copyright 2026 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 Sql
+      module V1
+        # A `BlueGreenDeployment` resource represents a Cloud SQL blue-green deployment
+        # setup.
+        # @!attribute [r] name
+        #   @return [::String]
+        #     Output only. Identifier. The full resource name of the deployment.
+        #     Format:
+        #     projects/\\{project}/locations/\\{location}/blueGreenDeployments/\\{deployment_id}
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. User-provided description for the deployment.
+        #     The description can be up to 255 characters long.
+        # @!attribute [r] create_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Output only. The time when the deployment was created.
+        #     Example: `2024-01-01T00:00:00Z`
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::Sql::V1::BlueGreenDeployment::State]
+        #     Output only. The current state of the blue-green deployment.
+        # @!attribute [rw] source_instance
+        #   @return [::String]
+        #     Required. Immutable. Required on create, and immutable. The full resource
+        #     name of the source instance (the "blue" instance). Format:
+        #     projects/\\{project}/instances/\\{instance}
+        # @!attribute [r] switchover_target_instance
+        #   @return [::String]
+        #     Output only. The full resource name of the primary target instance (the
+        #     "green" instance) that will be promoted during switchover. This field is
+        #     always populated once the deployment is created. Format:
+        #     projects/\\{project}/instances/\\{instance}
+        # @!attribute [r] error_detail
+        #   @return [::String]
+        #     Output only. Provides details on why switchover is not possible.
+        #     This field is empty unless a switchover attempt failed or the state is
+        #     `SWITCHOVER_NOT_READY`.
+        #     Example: "The target database version does not match the source instance
+        #     database version."
+        # @!attribute [r] deployment_mappings
+        #   @return [::Array<::Google::Cloud::Sql::V1::BlueGreenDeployment::SourceTargetPairedNode>]
+        #     Output only. A list representing the pairs of source and target instances
+        #     in the deployment.
+        # @!attribute [r] deployment_tasks
+        #   @return [::Google::Cloud::Sql::V1::BlueGreenDeployment::DeploymentTasks]
+        #     Output only. Combined list of tasks for all paired nodes.
+        # @!attribute [rw] requested_config
+        #   @return [::Google::Cloud::Sql::V1::BlueGreenDeployment::RequestedConfig]
+        #     Optional. Immutable. Optional on create, and immutable. The configuration
+        #     intended for the target instance(s) when the deployment was created.
+        class BlueGreenDeployment
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Configuration specified by the user at creation time for the target (green)
+          # instance.
+          # @!attribute [rw] database_version
+          #   @return [::String]
+          #     Optional. The target database major version for the upgrade. For example,
+          #     `MYSQL_8_0` or `POSTGRES_15`.
+          class RequestedConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Combined list of tasks for all paired nodes in the deployment.
+          # @!attribute [r] task
+          #   @return [::Array<::Google::Cloud::Sql::V1::BlueGreenDeployment::SourceTargetPairedNode::DeploymentTask>]
+          #     Output only. Tasks performed or being performed on the paired nodes
+          #     of the deployment at a consolidated level.
+          class DeploymentTasks
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # Represents a pairing of a source instance node and a target instance node.
+          # @!attribute [r] source
+          #   @return [::Google::Cloud::Sql::V1::BlueGreenDeployment::SourceTargetPairedNode::NodeInfo]
+          #     Output only. Specifies the resource name of the source instance in this
+          #     pair.
+          # @!attribute [r] target
+          #   @return [::Google::Cloud::Sql::V1::BlueGreenDeployment::SourceTargetPairedNode::NodeInfo]
+          #     Output only. Specifies details of the corresponding target instance in
+          #     this pair.
+          # @!attribute [r] state
+          #   @return [::Google::Cloud::Sql::V1::BlueGreenDeployment::SourceTargetPairedNode::State]
+          #     Output only. Specifies the current state of this specific source-target
+          #     pair.
+          # @!attribute [r] diffs
+          #   @return [::Array<::Google::Cloud::Sql::V1::BlueGreenDeployment::SourceTargetPairedNode::ConfigDiff>]
+          #     Output only. Describes the list of differences for the
+          #     `SourceTargetPairedNode`.
+          class SourceTargetPairedNode
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Represents a specific configuration difference between blue and green
+            # instances.
+            # @!attribute [r] field
+            #   @return [::String]
+            #     Output only. The name of the field that differs in the blue and green
+            #     instances, fully-qualified. Example: `settings.tier`
+            # @!attribute [r] source_value
+            #   @return [::String]
+            #     Output only. The value on the source instance.
+            # @!attribute [r] target_value
+            #   @return [::String]
+            #     Output only. The value on the target instance.
+            class ConfigDiff
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Details about an instance within the deployment.
+            # @!attribute [r] instance
+            #   @return [::String]
+            #     Output only. The full resource name of the instance.
+            #     Format: projects/\\{project}/instances/\\{instance}
+            # @!attribute [r] connection
+            #   @return [::String]
+            #     Output only. The instance connection name.
+            # @!attribute [r] dns
+            #   @return [::String]
+            #     Output only. The unique DNS name for this instance.
+            # @!attribute [r] ip_mappings
+            #   @return [::Array<::Google::Cloud::Sql::V1::IpMapping>]
+            #     Output only. The list of IP addresses for this instance.
+            class NodeInfo
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Represents a task executed as part of the deployment on a target
+            # instance.
+            # @!attribute [r] type
+            #   @return [::Google::Cloud::Sql::V1::BlueGreenDeployment::SourceTargetPairedNode::DeploymentTask::Type]
+            #     Output only. The type of the task.
+            # @!attribute [r] state
+            #   @return [::Google::Cloud::Sql::V1::BlueGreenDeployment::SourceTargetPairedNode::DeploymentTask::State]
+            #     Output only. The current state of the task.
+            # @!attribute [r] start_time
+            #   @return [::Google::Protobuf::Timestamp]
+            #     Output only. Task start time.
+            # @!attribute [r] end_time
+            #   @return [::Google::Protobuf::Timestamp]
+            #     Output only. Task end time (if completed).
+            # @!attribute [r] error_message
+            #   @return [::String]
+            #     Output only. Optional error details if the task state is `FAILED`.
+            class DeploymentTask
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+
+              # The type of the task.
+              # This enum type `Type` is prone to change, and new values may be added
+              # in the future.
+              module Type
+                # The default value. This value is used if the type is omitted.
+                TYPE_UNSPECIFIED = 0
+
+                # Provisions the green environment, which includes creating the target
+                # instance.
+                PROVISION = 1
+
+                # Upgrades the green environment, for example, performing a major
+                # version upgrade on the target instance.
+                UPGRADE = 2
+
+                # Promotes the target instance and then demotes the source instance for
+                # this pair.
+                SWITCHOVER = 3
+
+                # Deletes the blue-green deployment, including underlying resources.
+                DELETE = 4
+
+                # Post-switchover operations, including cleaning up resources of the
+                # old instance, taking final backups, and updating metadata.
+                POST_SWITCHOVER_OPERATIONS = 5
+              end
+
+              # The state of the task.
+              # This enum is not frozen, and new values may be added in the future.
+              module State
+                # The state of the task is unknown.
+                STATE_UNSPECIFIED = 0
+
+                # The task is pending.
+                PENDING = 1
+
+                # The task is running.
+                RUNNING = 2
+
+                # The task has succeeded.
+                SUCCEEDED = 3
+
+                # The task has failed.
+                FAILED = 4
+              end
+            end
+
+            # The state of a pair of source and target instances in deployment (paired
+            # node).
+            module State
+              # The state of the paired node is unknown.
+              STATE_UNSPECIFIED = 0
+
+              # The paired node is being provisioned.
+              PROVISIONING = 1
+
+              # The paired node is provisioned.
+              PROVISIONED = 2
+
+              # The paired node is upgrading.
+              UPGRADING = 3
+
+              # The paired node is upgraded.
+              UPGRADED = 4
+
+              # Upgrade failed on the paired node.
+              UPGRADE_FAILED = 5
+
+              # Switchover is in progress.
+              SWITCHOVER_IN_PROGRESS = 6
+
+              # Switchover failed on the paired node.
+              SWITCHOVER_FAILED = 7
+
+              # Switchover completed successfully.
+              SWITCHOVER_SUCCEEDED = 8
+
+              # The paired node is being deleted.
+              DELETING = 11
+            end
+          end
+
+          # The state of the blue-green deployment.
+          module State
+            # The default value. This value is used if the state is omitted or unknown.
+            STATE_UNSPECIFIED = 0
+
+            # The deployment is being provisioned.
+            PROVISIONING = 1
+
+            # The deployment is ready for switchover.
+            SWITCHOVER_READY = 2
+
+            # The deployment is not ready for switchover.
+            SWITCHOVER_NOT_READY = 3
+
+            # The deployment is in the process of switching over.
+            SWITCHOVER_IN_PROGRESS = 4
+
+            # The deployment has completed switchover.
+            SWITCHOVER_COMPLETED = 5
+
+            # The deployment is being deleted.
+            DELETING = 6
+          end
+        end
+
+        # The request message for creating a `BlueGreenDeployment` resource.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource where this blue-green deployment will be
+        #     created. Format: projects/\\{project}/locations/\\{location}
+        # @!attribute [rw] blue_green_deployment_id
+        #   @return [::String]
+        #     Required. The ID to use for the blue-green deployment, which will become
+        #     the final component of the deployment's resource name. The ID must be
+        #     unique within the given project and location and between 2-63 characters.
+        # @!attribute [rw] blue_green_deployment
+        #   @return [::Google::Cloud::Sql::V1::BlueGreenDeployment]
+        #     Required. The `BlueGreenDeployment` resource to create.
+        class CreateBlueGreenDeploymentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for getting a BlueGreenDeployment.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the blue-green deployment to retrieve.
+        #     Format:
+        #     projects/\\{project}/locations/\\{location}/blueGreenDeployments/\\{blue_green_deployment}
+        # @!attribute [rw] view
+        #   @return [::Google::Cloud::Sql::V1::GetBlueGreenDeploymentRequest::BlueGreenDeploymentView]
+        #     Optional. Specifies whether to return the basic or detailed view of the
+        #     resource in the response.
+        class GetBlueGreenDeploymentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The view of a `BlueGreenDeployment` resource.
+          module BlueGreenDeploymentView
+            # Blue-green deployment view enumeration. This allows the caller to specify
+            # what view they query. If unspecified
+            # (BLUE_GREEN_DEPLOYMENT_VIEW_UNSPECIFIED), the behavior is the same as
+            # BASIC.
+            BLUE_GREEN_DEPLOYMENT_VIEW_UNSPECIFIED = 0
+
+            # Includes basic metadata about the blue-green deployment.
+            # `BASIC` is the default view.
+            BASIC = 1
+
+            # Includes basic metadata and configuration differences between source and
+            # target instances (`database_version`, `tier`, `edition`,
+            # `availability_type`, `data_disk_size_gb`, and `data_disk_type`).
+            DETAILED = 2
+          end
+        end
+
+        # Request message for switching over a `BlueGreenDeployment` resource.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the blue-green deployment to switch over.
+        #     Format:
+        #     projects/\\{project}/locations/\\{location}/blueGreenDeployments/\\{blue_green_deployment}
+        class SwitchoverBlueGreenDeploymentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The request message for listing blue-green deployment resources.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The parent resource whose blue-green deployments are to be
+        #     listed. Format: projects/\\{project}/locations/\\{location}
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of deployments to return. The service may
+        #     return fewer deployments than this value. If unspecified, at most 500
+        #     deployments are returned. The maximum value is 1000; values above 1000
+        #     are treated as 1000.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token, received from a previous `ListBlueGreenDeployments`
+        #     call. Provide this to retrieve the subsequent page.
+        # @!attribute [rw] filter
+        #   @return [::String]
+        #     Optional. A filter expression that filters the results.
+        # @!attribute [rw] order_by
+        #   @return [::String]
+        #     Optional. A comma-separated list of fields to order the results by.
+        class ListBlueGreenDeploymentsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The response message for listing blue-green deployment resources.
+        # @!attribute [rw] blue_green_deployments
+        #   @return [::Array<::Google::Cloud::Sql::V1::BlueGreenDeployment>]
+        #     The list of blue-green deployment resources.
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     A token to retrieve the next page of results, or empty if there are no
+        #     more results.
+        class ListBlueGreenDeploymentsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for deleting a BlueGreenDeployment.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the blue-green deployment to delete.
+        #     Format:
+        #     projects/\\{project}/locations/\\{location}/blueGreenDeployments/\\{blue_green_deployment}
+        # @!attribute [rw] delete_old_source
+        #   @return [::Boolean]
+        #     Optional. If set to true, and the switchover is complete, this deletes the
+        #     old source instance along with the deployment.
+        class DeleteBlueGreenDeploymentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/sql/v1/cloud_sql_instances.rb

@@ -978,6 +978,11 @@ module Google
         #     Optional. This field has the same purpose as restore_instance_settings,
         #     changes any instance settings stored in the backup you are restoring from.
         #     With the difference that these fields are cleared in the settings.
+        # @!attribute [rw] ignore_maintenance_version
+        #   @return [::Boolean]
+        #     Optional. If true, the restore operation proceeds even if the target
+        #     instance's maintenance version is older than the source instance's
+        #     maintenance version.
         class InstancesRestoreBackupRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1439,6 +1444,10 @@ module Google
         #     Input only. Determines whether an in-place major version upgrade of
         #     replicas happens when an in-place major version upgrade of a primary
         #     instance is initiated.
+        # @!attribute [rw] skip_precheck
+        #   @return [::Google::Protobuf::BoolValue]
+        #     Optional. Input only. Determines whether the precheck step is skipped
+        #     during a major version upgrade.
         # @!attribute [rw] tags
         #   @return [::Google::Protobuf::Map{::String => ::String}]
         #     Optional. Input only. Immutable. Tag keys and tag values that are bound to
@@ -1463,6 +1472,10 @@ module Google
         # @!attribute [r] dns_names
         #   @return [::Array<::Google::Cloud::Sql::V1::DnsNameMapping>]
         #     Output only. The list of DNS names used by this instance.
+        # @!attribute [r] deployment_info
+        #   @return [::Google::Cloud::Sql::V1::BlueGreenDeploymentInfo]
+        #     Output only. Deployment info for the instance. This is set if the instance
+        #     is currently part of any blue-green setup.
         # @!attribute [rw] database_center_integration_enabled
         #   @return [::Google::Protobuf::BoolValue]
         #     Optional. If true, instance metadata is sent to the Database Center. If
@@ -1643,6 +1656,62 @@ module Google
           end
         end
 
+        # Blue-green deployment metadata for a database instance. In a blue-green
+        # deployment, we maintain two environments, one of which is live.
+        # This message contains details about the blue-green deployment.
+        # @!attribute [r] deployment_id
+        #   @return [::String]
+        #     Output only. The resource ID of the blue-green deployment.
+        # @!attribute [r] source
+        #   @return [::Google::Cloud::Sql::V1::BlueGreenDeploymentInfo::SourceRole]
+        #     Output only. The source instance for the Blue-Green deployment.
+        #
+        #     Note: The following fields are mutually exclusive: `source`, `target`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [r] target
+        #   @return [::Google::Cloud::Sql::V1::BlueGreenDeploymentInfo::TargetRole]
+        #     Output only. The target instance for the Blue-Green deployment.
+        #
+        #     Note: The following fields are mutually exclusive: `target`, `source`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [r] state
+        #   @return [::Google::Cloud::Sql::V1::BlueGreenDeploymentInfo::State]
+        #     Output only. The current state of blue-green-deployment for UI tags
+        class BlueGreenDeploymentInfo
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # The source instance for the Blue-Green deployment.
+          # @!attribute [r] target_id
+          #   @return [::Google::Cloud::Sql::V1::InstanceReference]
+          #     Output only. The target instance paired with this source instance in a
+          #     blue-green deployment.
+          class SourceRole
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The target instance for the Blue-Green deployment.
+          # @!attribute [r] source_id
+          #   @return [::Google::Cloud::Sql::V1::InstanceReference]
+          #     Output only. The source instance paired with this target instance in a
+          #     blue-green deployment.
+          class TargetRole
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
+          # The state of blue-green-deployment for UI tags
+          module State
+            # The state of the deployment is unknown.
+            STATE_UNSPECIFIED = 0
+
+            # The deployment is pre-switchover.
+            PRE_SWITCHOVER = 1
+
+            # The deployment is post-switchover.
+            POST_SWITCHOVER = 2
+          end
+        end
+
         # Gemini instance configuration.
         # @!attribute [r] entitled
         #   @return [::Boolean]
@@ -2102,6 +2171,15 @@ module Google
             # The replication user is missing specific privileges to setup DDL
             # replication. (e.g. CREATE EVENT TRIGGER, CREATE SCHEMA) for PostgreSQL.
             PG_DDL_REPLICATION_INSUFFICIENT_PRIVILEGE = 58
+
+            # Read replicas of the Writable Destination instance will be recreated
+            # after external synchronization is complete, causing downtime on read
+            # replicas.
+            WRITABLE_DESTINATION_REPLICA_RECREATION_DOWNTIME = 59
+
+            # A warning that disk storage auto increase is disabled on the destination
+            # instance for a Writable Destination migration.
+            WRITABLE_DESTINATION_STORAGE_AUTO_INCREASE_DISABLED = 60
           end
         end
 
@@ -2205,7 +2283,6 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # Execute SQL statements request.
         # @!attribute [rw] instance
         #   @return [::String]
         #     Required. Database instance ID. This does not include the project ID.
@@ -2236,6 +2313,7 @@ module Google
         # @!attribute [rw] database
         #   @return [::String]
         #     Optional. Name of the database on which the statement will be executed.
+        #     For Postgres and SQL Server it's required, for MySQL it's optional.
         # @!attribute [rw] password_secret_version
         #   @return [::String]
         #     Optional. The resource name of the Secret Manager secret holding the
@@ -2289,7 +2367,6 @@ module Google
           end
         end
 
-        # Execute SQL statements response.
         # @!attribute [rw] messages
         #   @return [::Array<::Google::Cloud::Sql::V1::SqlInstancesExecuteSqlResponse::Message>]
         #     A list of notices and warnings generated during query execution.
@@ -2499,6 +2576,10 @@ module Google
 
           # A Cloud SQL read pool.
           READ_POOL_INSTANCE = 5
+
+          # A Cloud SQL instance acting as a Blue-Green deployment target primary.
+          # (MySQL only)
+          GREEN_INSTANCE = 7
         end
 
         # The suspension reason of the database instance if the state is SUSPENDED.