google-cloud-sql-v1 0.2.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_databases.rb

@@ -31,6 +31,9 @@ module Google
         # @!attribute [rw] project
         #   @return [::String]
         #     Project ID of the project that contains the instance.
+        # @!attribute [rw] location
+        #   @return [::String]
+        #     Optional. Region of the Cloud SQL instance.
         class SqlDatabasesDeleteRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -46,6 +49,9 @@ module Google
         # @!attribute [rw] project
         #   @return [::String]
         #     Project ID of the project that contains the instance.
+        # @!attribute [rw] location
+        #   @return [::String]
+        #     Optional. Region of the Cloud SQL instance.
         class SqlDatabasesGetRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -60,6 +66,9 @@ module Google
         #     Project ID of the project that contains the instance.
         # @!attribute [rw] body
         #   @return [::Google::Cloud::Sql::V1::Database]
+        # @!attribute [rw] location
+        #   @return [::String]
+        #     Optional. Region of the Cloud SQL instance.
         class SqlDatabasesInsertRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -72,6 +81,9 @@ module Google
         # @!attribute [rw] project
         #   @return [::String]
         #     Project ID of the project that contains the instance.
+        # @!attribute [rw] location
+        #   @return [::String]
+        #     Optional. Region of the Cloud SQL instance.
         class SqlDatabasesListRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -89,6 +101,9 @@ module Google
         #     Project ID of the project that contains the instance.
         # @!attribute [rw] body
         #   @return [::Google::Cloud::Sql::V1::Database]
+        # @!attribute [rw] location
+        #   @return [::String]
+        #     Optional. Region of the Cloud SQL instance.
         class SqlDatabasesUpdateRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods