aws-sdk-rds 1.189.0 → 1.190.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: eb9e966f7e62628d895d5d096661b01a63557528cc37d8c3a50cd290e17ac3a9
-  data.tar.gz: 5c8c5ffcc4cba0508227b6ff9204d55f3e39a47016e81a639f69bb0bae9f7baf
+  metadata.gz: '082375afb1f14b2983230f42b789f89f54b06282ef2861ff41b68694e97eb511'
+  data.tar.gz: ab787eedaf4d422971efea43ed5bb8d2c23af8c86eaee317d28b2357d025f21d
 SHA512:
-  metadata.gz: 71199d494672776b7c7f20199faca1684f0a6781a50c838237972b2ff779b075e7d3540c32253619d371bbb8e144bb3c8b163ddd1759bf010fad9c07ad9a56a4
-  data.tar.gz: 1455d70144f0f87b37705cc7c37561764f78aaa0f5a7ea6960d7cd44ff3211046b50f4e762e9284494184682560ac96a1b3926eed08a31f7e35769bc85c2895d
+  metadata.gz: c1a39000b92260f65e285e532f74a35bf0d2e2cc2ebf9ed40b0e9138295e6201bdd185c98da8b15635c187de69cc8799fefd0a632958de445cea76524dac73d5
+  data.tar.gz: e055bfc080fa942c85e578a6bec91eb38336f56f746e8c69a23b57f21873d61b244fc71cd90f85fb97e7038d1d60396a0a4c65317c413c5f3b19b534be76e8fe

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.190.0 (2023-08-21)
+------------------
+
+* Feature - Adding support for RDS Aurora Global Database Unplanned Failover
+
 1.189.0 (2023-08-01)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.189.0
+1.190.0

data/lib/aws-sdk-rds/client.rb

@@ -3006,6 +3006,12 @@ module Aws::RDS
     #
     #   * Multi-AZ DB clusters - `io1`
     #
+    #   <note markdown="1"> When you create an Aurora DB cluster with the storage type set to
+    #   `aurora-iopt1`, the storage type is returned in the response. The
+    #   storage type isn't returned when you set it to `aurora`.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.StorageReliability.html#aurora-storage-type
@@ -7517,9 +7523,11 @@ module Aws::RDS
     #   resp.global_cluster.global_cluster_members[0].readers[0] #=> String
     #   resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
     #   resp.global_cluster.global_cluster_members[0].global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
+    #   resp.global_cluster.global_cluster_members[0].synchronization_status #=> String, one of "connected", "pending-resync"
     #   resp.global_cluster.failover_state.status #=> String, one of "pending", "failing-over", "cancelling"
     #   resp.global_cluster.failover_state.from_db_cluster_arn #=> String
     #   resp.global_cluster.failover_state.to_db_cluster_arn #=> String
+    #   resp.global_cluster.failover_state.is_data_loss_allowed #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateGlobalCluster AWS API Documentation
     #
@@ -9451,9 +9459,11 @@ module Aws::RDS
     #   resp.global_cluster.global_cluster_members[0].readers[0] #=> String
     #   resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
     #   resp.global_cluster.global_cluster_members[0].global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
+    #   resp.global_cluster.global_cluster_members[0].synchronization_status #=> String, one of "connected", "pending-resync"
     #   resp.global_cluster.failover_state.status #=> String, one of "pending", "failing-over", "cancelling"
     #   resp.global_cluster.failover_state.from_db_cluster_arn #=> String
     #   resp.global_cluster.failover_state.to_db_cluster_arn #=> String
+    #   resp.global_cluster.failover_state.is_data_loss_allowed #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteGlobalCluster AWS API Documentation
     #
@@ -14381,9 +14391,11 @@ module Aws::RDS
     #   resp.global_clusters[0].global_cluster_members[0].readers[0] #=> String
     #   resp.global_clusters[0].global_cluster_members[0].is_writer #=> Boolean
     #   resp.global_clusters[0].global_cluster_members[0].global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
+    #   resp.global_clusters[0].global_cluster_members[0].synchronization_status #=> String, one of "connected", "pending-resync"
     #   resp.global_clusters[0].failover_state.status #=> String, one of "pending", "failing-over", "cancelling"
     #   resp.global_clusters[0].failover_state.from_db_cluster_arn #=> String
     #   resp.global_clusters[0].failover_state.to_db_cluster_arn #=> String
+    #   resp.global_clusters[0].failover_state.is_data_loss_allowed #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeGlobalClusters AWS API Documentation
     #
@@ -15953,51 +15965,99 @@ module Aws::RDS
       req.send_request(options)
     end
 
-    # Initiates the failover process for an Aurora global database
-    # (GlobalCluster).
-    #
-    # A failover for an Aurora global database promotes one of secondary
-    # read-only DB clusters to be the primary DB cluster and demotes the
-    # primary DB cluster to being a secondary (read-only) DB cluster. In
-    # other words, the role of the current primary DB cluster and the
-    # selected (target) DB cluster are switched. The selected secondary DB
-    # cluster assumes full read/write capabilities for the Aurora global
-    # database.
-    #
-    # For more information about failing over an Amazon Aurora global
-    # database, see [Managed planned failover for Amazon Aurora global
-    # databases][1] in the *Amazon Aurora User Guide*.
+    # Promotes the specified secondary DB cluster to be the primary DB
+    # cluster in the global database cluster to fail over or switch over a
+    # global database. Switchover operations were previously called
+    # "managed planned failovers."
     #
-    # <note markdown="1"> This action applies to GlobalCluster (Aurora global databases) only.
-    # Use this action only on healthy Aurora global databases with running
-    # Aurora DB clusters and no Region-wide outages, to test disaster
-    # recovery scenarios or to reconfigure your Aurora global database
-    # topology.
+    # <note markdown="1"> Although this operation can be used either to fail over or to switch
+    # over a global database cluster, its intended use is for global
+    # database failover. To switch over a global database cluster, we
+    # recommend that you use the SwitchoverGlobalCluster operation instead.
     #
     #  </note>
     #
+    # How you use this operation depends on whether you are failing over or
+    # switching over your global database cluster:
     #
+    # * Failing over - Specify the `AllowDataLoss` parameter and don't
+    #   specify the `Switchover` parameter.
     #
-    # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-disaster-recovery.html#aurora-global-database-disaster-recovery.managed-failover
+    # * Switching over - Specify the `Switchover` parameter or omit it, but
+    #   don't specify the `AllowDataLoss` parameter.
+    #
+    # **About failing over and switching over**
+    #
+    # While failing over and switching over a global database cluster both
+    # change the primary DB cluster, you use these operations for different
+    # reasons:
+    #
+    # * *Failing over* - Use this operation to respond to an unplanned
+    #   event, such as a Regional disaster in the primary Region. Failing
+    #   over can result in a loss of write transaction data that wasn't
+    #   replicated to the chosen secondary before the failover event
+    #   occurred. However, the recovery process that promotes a DB instance
+    #   on the chosen seconday DB cluster to be the primary writer DB
+    #   instance guarantees that the data is in a transactionally consistent
+    #   state.
+    #
+    #   For more information about failing over an Amazon Aurora global
+    #   database, see [Performing managed failovers for Aurora global
+    #   databases][1] in the *Amazon Aurora User Guide*.
+    #
+    # * *Switching over* - Use this operation on a healthy global database
+    #   cluster for planned events, such as Regional rotation or to fail
+    #   back to the original primary DB cluster after a failover operation.
+    #   With this operation, there is no data loss.
+    #
+    #   For more information about switching over an Amazon Aurora global
+    #   database, see [Performing switchovers for Aurora global
+    #   databases][2] in the *Amazon Aurora User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-disaster-recovery.html#aurora-global-database-failover.managed-unplanned
+    # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-disaster-recovery.html#aurora-global-database-disaster-recovery.managed-failover
     #
     # @option params [required, String] :global_cluster_identifier
-    #   Identifier of the Aurora global database (GlobalCluster) that should
-    #   be failed over. The identifier is the unique key assigned by the user
-    #   when the Aurora global database was created. In other words, it's the
-    #   name of the Aurora global database that you want to fail over.
+    #   The identifier of the global database cluster (Aurora global database)
+    #   this operation should apply to. The identifier is the unique key
+    #   assigned by the user when the Aurora global database is created. In
+    #   other words, it's the name of the Aurora global database.
     #
     #   Constraints:
     #
-    #   * Must match the identifier of an existing GlobalCluster (Aurora
-    #     global database).
+    #   * Must match the identifier of an existing global database cluster.
     #
     #   ^
     #
     # @option params [required, String] :target_db_cluster_identifier
-    #   Identifier of the secondary Aurora DB cluster that you want to promote
-    #   to primary for the Aurora global database (GlobalCluster.) Use the
-    #   Amazon Resource Name (ARN) for the identifier so that Aurora can
-    #   locate the cluster in its Amazon Web Services Region.
+    #   The identifier of the secondary Aurora DB cluster that you want to
+    #   promote to the primary for the global database cluster. Use the Amazon
+    #   Resource Name (ARN) for the identifier so that Aurora can locate the
+    #   cluster in its Amazon Web Services Region.
+    #
+    # @option params [Boolean] :allow_data_loss
+    #   Specifies whether to allow data loss for this global database cluster
+    #   operation. Allowing data loss triggers a global failover operation.
+    #
+    #   If you don't specify `AllowDataLoss`, the global database cluster
+    #   operation defaults to a switchover.
+    #
+    #   Constraints:
+    #
+    #   * Can't be specified together with the `Switchover` parameter.
+    #
+    #   ^
+    #
+    # @option params [Boolean] :switchover
+    #   Specifies whether to switch over this global database cluster.
+    #
+    #   Constraints:
+    #
+    #   * Can't be specified together with the `AllowDataLoss` parameter.
+    #
+    #   ^
     #
     # @return [Types::FailoverGlobalClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -16008,6 +16068,8 @@ module Aws::RDS
     #   resp = client.failover_global_cluster({
     #     global_cluster_identifier: "GlobalClusterIdentifier", # required
     #     target_db_cluster_identifier: "DBClusterIdentifier", # required
+    #     allow_data_loss: false,
+    #     switchover: false,
     #   })
     #
     # @example Response structure
@@ -16027,9 +16089,11 @@ module Aws::RDS
     #   resp.global_cluster.global_cluster_members[0].readers[0] #=> String
     #   resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
     #   resp.global_cluster.global_cluster_members[0].global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
+    #   resp.global_cluster.global_cluster_members[0].synchronization_status #=> String, one of "connected", "pending-resync"
     #   resp.global_cluster.failover_state.status #=> String, one of "pending", "failing-over", "cancelling"
     #   resp.global_cluster.failover_state.from_db_cluster_arn #=> String
     #   resp.global_cluster.failover_state.to_db_cluster_arn #=> String
+    #   resp.global_cluster.failover_state.is_data_loss_allowed #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/FailoverGlobalCluster AWS API Documentation
     #
@@ -20054,11 +20118,11 @@ module Aws::RDS
       req.send_request(options)
     end
 
-    # Modifies a setting for an Amazon Aurora global cluster. You can change
-    # one or more database configuration parameters by specifying these
-    # parameters and the new values in the request. For more information on
-    # Amazon Aurora, see [ What is Amazon Aurora?][1] in the *Amazon Aurora
-    # User Guide*.
+    # Modifies a setting for an Amazon Aurora global database cluster. You
+    # can change one or more database configuration parameters by specifying
+    # these parameters and the new values in the request. For more
+    # information on Amazon Aurora, see [ What is Amazon Aurora?][1] in the
+    # *Amazon Aurora User Guide*.
     #
     # <note markdown="1"> This operation only applies to Aurora global database clusters.
     #
@@ -20183,9 +20247,11 @@ module Aws::RDS
     #   resp.global_cluster.global_cluster_members[0].readers[0] #=> String
     #   resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
     #   resp.global_cluster.global_cluster_members[0].global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
+    #   resp.global_cluster.global_cluster_members[0].synchronization_status #=> String, one of "connected", "pending-resync"
     #   resp.global_cluster.failover_state.status #=> String, one of "pending", "failing-over", "cancelling"
     #   resp.global_cluster.failover_state.from_db_cluster_arn #=> String
     #   resp.global_cluster.failover_state.to_db_cluster_arn #=> String
+    #   resp.global_cluster.failover_state.is_data_loss_allowed #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyGlobalCluster AWS API Documentation
     #
@@ -21393,9 +21459,11 @@ module Aws::RDS
     #   resp.global_cluster.global_cluster_members[0].readers[0] #=> String
     #   resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
     #   resp.global_cluster.global_cluster_members[0].global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
+    #   resp.global_cluster.global_cluster_members[0].synchronization_status #=> String, one of "connected", "pending-resync"
     #   resp.global_cluster.failover_state.status #=> String, one of "pending", "failing-over", "cancelling"
     #   resp.global_cluster.failover_state.from_db_cluster_arn #=> String
     #   resp.global_cluster.failover_state.to_db_cluster_arn #=> String
+    #   resp.global_cluster.failover_state.is_data_loss_allowed #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RemoveFromGlobalCluster AWS API Documentation
     #
@@ -27896,6 +27964,92 @@ module Aws::RDS
       req.send_request(options)
     end
 
+    # Switches over the specified secondary DB cluster to be the new primary
+    # DB cluster in the global database cluster. Switchover operations were
+    # previously called "managed planned failovers."
+    #
+    # Aurora promotes the specified secondary cluster to assume full
+    # read/write capabilities and demotes the current primary cluster to a
+    # secondary (read-only) cluster, maintaining the orginal replication
+    # topology. All secondary clusters are synchronized with the primary at
+    # the beginning of the process so the new primary continues operations
+    # for the Aurora global database without losing any data. Your database
+    # is unavailable for a short time while the primary and selected
+    # secondary clusters are assuming their new roles. For more information
+    # about switching over an Aurora global database, see [Performing
+    # switchovers for Amazon Aurora global databases][1] in the *Amazon
+    # Aurora User Guide*.
+    #
+    # <note markdown="1"> This operation is intended for controlled environments, for operations
+    # such as "regional rotation" or to fall back to the original primary
+    # after a global database failover.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database-disaster-recovery.html#aurora-global-database-disaster-recovery.managed-failover
+    #
+    # @option params [required, String] :global_cluster_identifier
+    #   The identifier of the global database cluster to switch over. This
+    #   parameter isn't case-sensitive.
+    #
+    #   Constraints:
+    #
+    #   * Must match the identifier of an existing global database cluster
+    #     (Aurora global database).
+    #
+    #   ^
+    #
+    # @option params [required, String] :target_db_cluster_identifier
+    #   The identifier of the secondary Aurora DB cluster to promote to the
+    #   new primary for the global database cluster. Use the Amazon Resource
+    #   Name (ARN) for the identifier so that Aurora can locate the cluster in
+    #   its Amazon Web Services Region.
+    #
+    # @return [Types::SwitchoverGlobalClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::SwitchoverGlobalClusterResult#global_cluster #global_cluster} => Types::GlobalCluster
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.switchover_global_cluster({
+    #     global_cluster_identifier: "GlobalClusterIdentifier", # required
+    #     target_db_cluster_identifier: "DBClusterIdentifier", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.global_cluster.global_cluster_identifier #=> String
+    #   resp.global_cluster.global_cluster_resource_id #=> String
+    #   resp.global_cluster.global_cluster_arn #=> String
+    #   resp.global_cluster.status #=> String
+    #   resp.global_cluster.engine #=> String
+    #   resp.global_cluster.engine_version #=> String
+    #   resp.global_cluster.database_name #=> String
+    #   resp.global_cluster.storage_encrypted #=> Boolean
+    #   resp.global_cluster.deletion_protection #=> Boolean
+    #   resp.global_cluster.global_cluster_members #=> Array
+    #   resp.global_cluster.global_cluster_members[0].db_cluster_arn #=> String
+    #   resp.global_cluster.global_cluster_members[0].readers #=> Array
+    #   resp.global_cluster.global_cluster_members[0].readers[0] #=> String
+    #   resp.global_cluster.global_cluster_members[0].is_writer #=> Boolean
+    #   resp.global_cluster.global_cluster_members[0].global_write_forwarding_status #=> String, one of "enabled", "disabled", "enabling", "disabling", "unknown"
+    #   resp.global_cluster.global_cluster_members[0].synchronization_status #=> String, one of "connected", "pending-resync"
+    #   resp.global_cluster.failover_state.status #=> String, one of "pending", "failing-over", "cancelling"
+    #   resp.global_cluster.failover_state.from_db_cluster_arn #=> String
+    #   resp.global_cluster.failover_state.to_db_cluster_arn #=> String
+    #   resp.global_cluster.failover_state.is_data_loss_allowed #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/SwitchoverGlobalCluster AWS API Documentation
+    #
+    # @overload switchover_global_cluster(params = {})
+    # @param [Hash] params ({})
+    def switchover_global_cluster(params = {}, options = {})
+      req = build_request(:switchover_global_cluster, params)
+      req.send_request(options)
+    end
+
     # Switches over an Oracle standby database in an Oracle Data Guard
     # environment, making it the new primary database. Issue this command in
     # the Region that hosts the current standby database.
@@ -28101,7 +28255,7 @@ module Aws::RDS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rds'
-      context[:gem_version] = '1.189.0'
+      context[:gem_version] = '1.190.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-rds/client_api.rb

@@ -387,6 +387,7 @@ module Aws::RDS
     GlobalClusterList = Shapes::ListShape.new(name: 'GlobalClusterList')
     GlobalClusterMember = Shapes::StructureShape.new(name: 'GlobalClusterMember')
     GlobalClusterMemberList = Shapes::ListShape.new(name: 'GlobalClusterMemberList')
+    GlobalClusterMemberSynchronizationStatus = Shapes::StringShape.new(name: 'GlobalClusterMemberSynchronizationStatus')
     GlobalClusterNotFoundFault = Shapes::StructureShape.new(name: 'GlobalClusterNotFoundFault')
     GlobalClusterQuotaExceededFault = Shapes::StructureShape.new(name: 'GlobalClusterQuotaExceededFault')
     GlobalClustersMessage = Shapes::StructureShape.new(name: 'GlobalClustersMessage')
@@ -627,6 +628,8 @@ module Aws::RDS
     SwitchoverDetail = Shapes::StructureShape.new(name: 'SwitchoverDetail')
     SwitchoverDetailList = Shapes::ListShape.new(name: 'SwitchoverDetailList')
     SwitchoverDetailStatus = Shapes::StringShape.new(name: 'SwitchoverDetailStatus')
+    SwitchoverGlobalClusterMessage = Shapes::StructureShape.new(name: 'SwitchoverGlobalClusterMessage')
+    SwitchoverGlobalClusterResult = Shapes::StructureShape.new(name: 'SwitchoverGlobalClusterResult')
     SwitchoverReadReplicaMessage = Shapes::StructureShape.new(name: 'SwitchoverReadReplicaMessage')
     SwitchoverReadReplicaResult = Shapes::StructureShape.new(name: 'SwitchoverReadReplicaResult')
     SwitchoverTimeout = Shapes::IntegerShape.new(name: 'SwitchoverTimeout')
@@ -2454,6 +2457,8 @@ module Aws::RDS
 
     FailoverGlobalClusterMessage.add_member(:global_cluster_identifier, Shapes::ShapeRef.new(shape: GlobalClusterIdentifier, required: true, location_name: "GlobalClusterIdentifier"))
     FailoverGlobalClusterMessage.add_member(:target_db_cluster_identifier, Shapes::ShapeRef.new(shape: DBClusterIdentifier, required: true, location_name: "TargetDbClusterIdentifier"))
+    FailoverGlobalClusterMessage.add_member(:allow_data_loss, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "AllowDataLoss"))
+    FailoverGlobalClusterMessage.add_member(:switchover, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "Switchover"))
     FailoverGlobalClusterMessage.struct_class = Types::FailoverGlobalClusterMessage
 
     FailoverGlobalClusterResult.add_member(:global_cluster, Shapes::ShapeRef.new(shape: GlobalCluster, location_name: "GlobalCluster"))
@@ -2462,6 +2467,7 @@ module Aws::RDS
     FailoverState.add_member(:status, Shapes::ShapeRef.new(shape: FailoverStatus, location_name: "Status"))
     FailoverState.add_member(:from_db_cluster_arn, Shapes::ShapeRef.new(shape: String, location_name: "FromDbClusterArn"))
     FailoverState.add_member(:to_db_cluster_arn, Shapes::ShapeRef.new(shape: String, location_name: "ToDbClusterArn"))
+    FailoverState.add_member(:is_data_loss_allowed, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsDataLossAllowed"))
     FailoverState.struct_class = Types::FailoverState
 
     FeatureNameList.member = Shapes::ShapeRef.new(shape: String)
@@ -2495,6 +2501,7 @@ module Aws::RDS
     GlobalClusterMember.add_member(:readers, Shapes::ShapeRef.new(shape: ReadersArnList, location_name: "Readers"))
     GlobalClusterMember.add_member(:is_writer, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsWriter"))
     GlobalClusterMember.add_member(:global_write_forwarding_status, Shapes::ShapeRef.new(shape: WriteForwardingStatus, location_name: "GlobalWriteForwardingStatus"))
+    GlobalClusterMember.add_member(:synchronization_status, Shapes::ShapeRef.new(shape: GlobalClusterMemberSynchronizationStatus, location_name: "SynchronizationStatus"))
     GlobalClusterMember.struct_class = Types::GlobalClusterMember
 
     GlobalClusterMemberList.member = Shapes::ShapeRef.new(shape: GlobalClusterMember, location_name: "GlobalClusterMember")
@@ -3681,6 +3688,13 @@ module Aws::RDS
 
     SwitchoverDetailList.member = Shapes::ShapeRef.new(shape: SwitchoverDetail)
 
+    SwitchoverGlobalClusterMessage.add_member(:global_cluster_identifier, Shapes::ShapeRef.new(shape: GlobalClusterIdentifier, required: true, location_name: "GlobalClusterIdentifier"))
+    SwitchoverGlobalClusterMessage.add_member(:target_db_cluster_identifier, Shapes::ShapeRef.new(shape: DBClusterIdentifier, required: true, location_name: "TargetDbClusterIdentifier"))
+    SwitchoverGlobalClusterMessage.struct_class = Types::SwitchoverGlobalClusterMessage
+
+    SwitchoverGlobalClusterResult.add_member(:global_cluster, Shapes::ShapeRef.new(shape: GlobalCluster, location_name: "GlobalCluster"))
+    SwitchoverGlobalClusterResult.struct_class = Types::SwitchoverGlobalClusterResult
+
     SwitchoverReadReplicaMessage.add_member(:db_instance_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBInstanceIdentifier"))
     SwitchoverReadReplicaMessage.struct_class = Types::SwitchoverReadReplicaMessage
 
@@ -5701,6 +5715,18 @@ module Aws::RDS
         o.errors << Shapes::ShapeRef.new(shape: InvalidBlueGreenDeploymentStateFault)
       end)
 
+      api.add_operation(:switchover_global_cluster, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "SwitchoverGlobalCluster"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: SwitchoverGlobalClusterMessage)
+        o.output = Shapes::ShapeRef.new(shape: SwitchoverGlobalClusterResult)
+        o.errors << Shapes::ShapeRef.new(shape: GlobalClusterNotFoundFault)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidGlobalClusterStateFault)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidDBClusterStateFault)
+        o.errors << Shapes::ShapeRef.new(shape: DBClusterNotFoundFault)
+      end)
+
       api.add_operation(:switchover_read_replica, Seahorse::Model::Operation.new.tap do |o|
         o.name = "SwitchoverReadReplica"
         o.http_method = "POST"

data/lib/aws-sdk-rds/db_cluster.rb

@@ -1379,6 +1379,12 @@ module Aws::RDS
     #
     #   * Multi-AZ DB clusters - `io1`
     #
+    #   <note markdown="1"> When you create an Aurora DB cluster with the storage type set to
+    #   `aurora-iopt1`, the storage type is returned in the response. The
+    #   storage type isn't returned when you set it to `aurora`.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.StorageReliability.html#aurora-storage-type

data/lib/aws-sdk-rds/endpoints.rb

@@ -2000,6 +2000,20 @@ module Aws::RDS
       end
     end
 
+    class SwitchoverGlobalCluster
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::RDS::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class SwitchoverReadReplica
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-rds/plugins/endpoints.rb

@@ -340,6 +340,8 @@ module Aws::RDS
             Aws::RDS::Endpoints::StopDBInstanceAutomatedBackupsReplication.build(context)
           when :switchover_blue_green_deployment
             Aws::RDS::Endpoints::SwitchoverBlueGreenDeployment.build(context)
+          when :switchover_global_cluster
+            Aws::RDS::Endpoints::SwitchoverGlobalCluster.build(context)
           when :switchover_read_replica
             Aws::RDS::Endpoints::SwitchoverReadReplica.build(context)
           end

data/lib/aws-sdk-rds/resource.rb

@@ -631,6 +631,12 @@ module Aws::RDS
     #
     #   * Multi-AZ DB clusters - `io1`
     #
+    #   <note markdown="1"> When you create an Aurora DB cluster with the storage type set to
+    #   `aurora-iopt1`, the storage type is returned in the response. The
+    #   storage type isn't returned when you set it to `aurora`.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.StorageReliability.html#aurora-storage-type

data/lib/aws-sdk-rds/types.rb

@@ -2543,6 +2543,12 @@ module Aws::RDS
     #
     #   * Multi-AZ DB clusters - `io1`
     #
+    #   <note markdown="1"> When you create an Aurora DB cluster with the storage type set to
+    #   `aurora-iopt1`, the storage type is returned in the response. The
+    #   storage type isn't returned when you set it to `aurora`.
+    #
+    #    </note>
+    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Overview.StorageReliability.html#aurora-storage-type
@@ -13928,32 +13934,58 @@ module Aws::RDS
     end
 
     # @!attribute [rw] global_cluster_identifier
-    #   Identifier of the Aurora global database (GlobalCluster) that should
-    #   be failed over. The identifier is the unique key assigned by the
-    #   user when the Aurora global database was created. In other words,
-    #   it's the name of the Aurora global database that you want to fail
-    #   over.
+    #   The identifier of the global database cluster (Aurora global
+    #   database) this operation should apply to. The identifier is the
+    #   unique key assigned by the user when the Aurora global database is
+    #   created. In other words, it's the name of the Aurora global
+    #   database.
     #
     #   Constraints:
     #
-    #   * Must match the identifier of an existing GlobalCluster (Aurora
-    #     global database).
+    #   * Must match the identifier of an existing global database cluster.
     #
     #   ^
     #   @return [String]
     #
     # @!attribute [rw] target_db_cluster_identifier
-    #   Identifier of the secondary Aurora DB cluster that you want to
-    #   promote to primary for the Aurora global database (GlobalCluster.)
-    #   Use the Amazon Resource Name (ARN) for the identifier so that Aurora
-    #   can locate the cluster in its Amazon Web Services Region.
+    #   The identifier of the secondary Aurora DB cluster that you want to
+    #   promote to the primary for the global database cluster. Use the
+    #   Amazon Resource Name (ARN) for the identifier so that Aurora can
+    #   locate the cluster in its Amazon Web Services Region.
     #   @return [String]
     #
+    # @!attribute [rw] allow_data_loss
+    #   Specifies whether to allow data loss for this global database
+    #   cluster operation. Allowing data loss triggers a global failover
+    #   operation.
+    #
+    #   If you don't specify `AllowDataLoss`, the global database cluster
+    #   operation defaults to a switchover.
+    #
+    #   Constraints:
+    #
+    #   * Can't be specified together with the `Switchover` parameter.
+    #
+    #   ^
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] switchover
+    #   Specifies whether to switch over this global database cluster.
+    #
+    #   Constraints:
+    #
+    #   * Can't be specified together with the `AllowDataLoss` parameter.
+    #
+    #   ^
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/FailoverGlobalClusterMessage AWS API Documentation
     #
     class FailoverGlobalClusterMessage < Struct.new(
       :global_cluster_identifier,
-      :target_db_cluster_identifier)
+      :target_db_cluster_identifier,
+      :allow_data_loss,
+      :switchover)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -13970,30 +14002,29 @@ module Aws::RDS
       include Aws::Structure
     end
 
-    # Contains the state of scheduled or in-process failover operations on
-    # an Aurora global database (GlobalCluster). This Data type is empty
-    # unless a failover operation is scheduled or is currently underway on
-    # the Aurora global database.
+    # Contains the state of scheduled or in-process operations on a global
+    # cluster (Aurora global database). This data type is empty unless a
+    # switchover or failover operation is scheduled or is in progress on the
+    # Aurora global database.
     #
     # @!attribute [rw] status
-    #   The current status of the Aurora global database (GlobalCluster).
-    #   Possible values are as follows:
+    #   The current status of the global cluster. Possible values are as
+    #   follows:
     #
-    #   * pending – A request to fail over the Aurora global database
-    #     (GlobalCluster) has been received by the service. The
-    #     `GlobalCluster`'s primary DB cluster and the specified secondary
-    #     DB cluster are being verified before the failover process can
-    #     start.
+    #   * pending – The service received a request to switch over or fail
+    #     over the global cluster. The global cluster's primary DB cluster
+    #     and the specified secondary DB cluster are being verified before
+    #     the operation starts.
     #
     #   * failing-over – This status covers the range of Aurora internal
-    #     operations that take place during the failover process, such as
-    #     demoting the primary Aurora DB cluster, promoting the secondary
-    #     Aurora DB, and synchronizing replicas.
+    #     operations that take place during the switchover or failover
+    #     process, such as demoting the primary Aurora DB cluster, promoting
+    #     the secondary Aurora DB cluster, and synchronizing replicas.
     #
-    #   * cancelling – The request to fail over the Aurora global database
-    #     (GlobalCluster) was cancelled and the primary Aurora DB cluster
-    #     and the selected secondary Aurora DB cluster are returning to
-    #     their previous states.
+    #   * cancelling – The request to switch over or fail over the global
+    #     cluster was cancelled and the primary Aurora DB cluster and the
+    #     selected secondary Aurora DB cluster are returning to their
+    #     previous states.
     #   @return [String]
     #
     # @!attribute [rw] from_db_cluster_arn
@@ -14006,12 +14037,19 @@ module Aws::RDS
     #   currently being promoted, and which is associated with this state.
     #   @return [String]
     #
+    # @!attribute [rw] is_data_loss_allowed
+    #   Indicates whether the operation is a global switchover or a global
+    #   failover. If data loss is allowed, then the operation is a global
+    #   failover. Otherwise, it's a switchover.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/FailoverState AWS API Documentation
     #
     class FailoverState < Struct.new(
       :status,
       :from_db_cluster_arn,
-      :to_db_cluster_arn)
+      :to_db_cluster_arn,
+      :is_data_loss_allowed)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -14105,10 +14143,10 @@ module Aws::RDS
     #
     # @!attribute [rw] failover_state
     #   A data object containing all properties for the current state of an
-    #   in-process or pending failover process for this Aurora global
-    #   database. This object is empty unless the FailoverGlobalCluster API
-    #   operation has been called on this Aurora global database
-    #   (GlobalCluster).
+    #   in-process or pending switchover or failover process for this global
+    #   cluster (Aurora global database). This object is empty unless the
+    #   `SwitchoverGlobalCluster` or `FailoverGlobalCluster` operation was
+    #   called on this global cluster.
     #   @return [Types::FailoverState]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/GlobalCluster AWS API Documentation
@@ -14138,36 +14176,43 @@ module Aws::RDS
     class GlobalClusterAlreadyExistsFault < Aws::EmptyStructure; end
 
     # A data structure with information about any primary and secondary
-    # clusters associated with an Aurora global database.
+    # clusters associated with a global cluster (Aurora global database).
     #
     # @!attribute [rw] db_cluster_arn
-    #   The Amazon Resource Name (ARN) for each Aurora cluster.
+    #   The Amazon Resource Name (ARN) for each Aurora DB cluster in the
+    #   global cluster.
     #   @return [String]
     #
     # @!attribute [rw] readers
     #   The Amazon Resource Name (ARN) for each read-only secondary cluster
-    #   associated with the Aurora global database.
+    #   associated with the global cluster.
     #   @return [Array<String>]
     #
     # @!attribute [rw] is_writer
-    #   Specifies whether the Aurora cluster is the primary cluster (that
-    #   is, has read-write capability) for the Aurora global database with
-    #   which it is associated.
+    #   Specifies whether the Aurora DB cluster is the primary cluster (that
+    #   is, has read-write capability) for the global cluster with which it
+    #   is associated.
     #   @return [Boolean]
     #
     # @!attribute [rw] global_write_forwarding_status
-    #   Specifies whether a secondary cluster in an Aurora global database
-    #   has write forwarding enabled, not enabled, or is in the process of
+    #   Specifies whether a secondary cluster in the global cluster has
+    #   write forwarding enabled, not enabled, or is in the process of
     #   enabling it.
     #   @return [String]
     #
+    # @!attribute [rw] synchronization_status
+    #   The status of synchronization of each Aurora DB cluster in the
+    #   global cluster.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/GlobalClusterMember AWS API Documentation
     #
     class GlobalClusterMember < Struct.new(
       :db_cluster_arn,
       :readers,
       :is_writer,
-      :global_write_forwarding_status)
+      :global_write_forwarding_status,
+      :synchronization_status)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -23963,6 +24008,46 @@ module Aws::RDS
       include Aws::Structure
     end
 
+    # @!attribute [rw] global_cluster_identifier
+    #   The identifier of the global database cluster to switch over. This
+    #   parameter isn't case-sensitive.
+    #
+    #   Constraints:
+    #
+    #   * Must match the identifier of an existing global database cluster
+    #     (Aurora global database).
+    #
+    #   ^
+    #   @return [String]
+    #
+    # @!attribute [rw] target_db_cluster_identifier
+    #   The identifier of the secondary Aurora DB cluster to promote to the
+    #   new primary for the global database cluster. Use the Amazon Resource
+    #   Name (ARN) for the identifier so that Aurora can locate the cluster
+    #   in its Amazon Web Services Region.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/SwitchoverGlobalClusterMessage AWS API Documentation
+    #
+    class SwitchoverGlobalClusterMessage < Struct.new(
+      :global_cluster_identifier,
+      :target_db_cluster_identifier)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] global_cluster
+    #   A data type representing an Aurora global database.
+    #   @return [Types::GlobalCluster]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/SwitchoverGlobalClusterResult AWS API Documentation
+    #
+    class SwitchoverGlobalClusterResult < Struct.new(
+      :global_cluster)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] db_instance_identifier
     #   The DB instance identifier of the current standby database. This
     #   value is stored as a lowercase string.

data/lib/aws-sdk-rds.rb

@@ -78,6 +78,6 @@ require_relative 'aws-sdk-rds/customizations'
 # @!group service
 module Aws::RDS
 
-  GEM_VERSION = '1.189.0'
+  GEM_VERSION = '1.190.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-rds
 version: !ruby/object:Gem::Version
-  version: 1.189.0
+  version: 1.190.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-01 00:00:00.000000000 Z
+date: 2023-08-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sigv4