aws-sdk-dsql 1.7.0 → 1.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3291563dc8b970c9f7f0c11e1b9cca68e27ab119db5643e9ad082100cae6d31e
-  data.tar.gz: e0aa1f8c90785e0ee96cb007ebc75914dd7982a8fccb308456391a2584f3d608
+  metadata.gz: c2b16d6886186fa4cadf30a8314463a9d5e8490ac0ef311563c731e509746a2f
+  data.tar.gz: 6ecae443a02493e99057a0d8cdfec5b08deb1ac139c4d77b772e52448cb6203e
 SHA512:
-  metadata.gz: 5076a36189099de2a589fb123e65c25a8b3edf33b7e10590d20d051a830a8694082d6962d01ec2af1e33ddd2ed68df4c0c8684cb0da6818e81c51ea7b6615a70
-  data.tar.gz: a334e501c779a38940382749b9ea5fa31fcb168cbef331ca929063c6a612d31699ccf76d49d1dc6c4a2dd850968229b5dc2a5ede18d257ffca3cdf1e5a9d2bf8
+  metadata.gz: 28b4c137725551efb686c0e6e99e52270c79812c8c41676d476b3674ff7edd46ca0583e1b9f7e90272994ef8c201a02860170d3a91479d081d53347773b16937
+  data.tar.gz: cb3f2a8ae7f56db0057784b8dfe7f90b764e08b5dfc2b6809156efa23edd973de2515d1a3e3ac847d4e5b233299291de2453e5e3e80b11a73e01e04542e4bfac

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.8.0 (2025-05-13)
+------------------
+
+* Feature - CreateMultiRegionClusters and DeleteMultiRegionClusters APIs marked as deprecated. Introduced new multi-Region clusters creation experience through multiRegionProperties parameter in CreateCluster API.
+
 1.7.0 (2025-05-12)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.7.0
+1.8.0

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

@@ -469,7 +469,63 @@ module Aws::DSQL
 
     # @!group API Operations
 
-    # Creates a cluster in Amazon Aurora DSQL.
+    # This operation creates a cluster in Amazon Aurora DSQL. You need the
+    # following permissions to use this operation.
+    #
+    # Permission to create a cluster.
+    #
+    # dsql:CreateCluster
+    #
+    # : Resources: arn:aws:dsql:*region*:*account-id*:cluster/*
+    #
+    # Permission to add tags to a resource.
+    #
+    # dsql:TagResource
+    #
+    # : Resources: arn:aws:dsql:*region*:*account-id*:cluster/*
+    #
+    # Permission to configure multi-region properties for a cluster.
+    #
+    # dsql:PutMultiRegionProperties
+    #
+    # : Resources: arn:aws:dsql:*region*:*account-id*:cluster/*
+    #
+    # When specifying multiRegionProperties.clusters.
+    #
+    # dsql:AddPeerCluster
+    #
+    # : Permission to add peer clusters.
+    #
+    #   Resources:
+    #
+    #   * Local cluster: arn:aws:dsql:*region*:*account-id*:cluster/*
+    #
+    #   * Each peer cluster: exact ARN of each specified peer cluster
+    #
+    # When specifying multiRegionProperties.witnessRegion.
+    #
+    # dsql:PutWitnessRegion
+    #
+    # : Permission to set a witness region.
+    #
+    #   Resources: arn:aws:dsql:*region*:*account-id*:cluster/*
+    #
+    #   Condition Keys: `dsql:WitnessRegion` (matching the specified witness
+    #   region)
+    #
+    #   <note markdown="1"> This permission is checked both in the cluster Region and in the
+    #   witness Region.
+    #
+    #    </note>
+    #
+    # **Important Notes for Multi-Region Operations**
+    #
+    #  * The witness region specified in
+    #   `multiRegionProperties.witnessRegion` cannot be the same as the
+    #   cluster's Region.
+    #
+    # * When updating clusters with peer relationships, permissions are
+    #   checked for both adding and removing peers.
     #
     # @option params [Boolean] :deletion_protection_enabled
     #   If enabled, you can't delete your cluster. You must first disable
@@ -492,12 +548,17 @@ module Aws::DSQL
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [Types::MultiRegionProperties] :multi_region_properties
+    #   The configuration settings when creating a multi-Region cluster,
+    #   including the witness region and linked cluster properties.
+    #
     # @return [Types::CreateClusterOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateClusterOutput#identifier #identifier} => String
     #   * {Types::CreateClusterOutput#arn #arn} => String
     #   * {Types::CreateClusterOutput#status #status} => String
     #   * {Types::CreateClusterOutput#creation_time #creation_time} => Time
+    #   * {Types::CreateClusterOutput#multi_region_properties #multi_region_properties} => Types::MultiRegionProperties
     #   * {Types::CreateClusterOutput#deletion_protection_enabled #deletion_protection_enabled} => Boolean
     #
     #
@@ -518,14 +579,21 @@ module Aws::DSQL
     #       "TagKey" => "TagValue",
     #     },
     #     client_token: "ClientToken",
+    #     multi_region_properties: {
+    #       witness_region: "Region",
+    #       clusters: ["ClusterArn"],
+    #     },
     #   })
     #
     # @example Response structure
     #
     #   resp.identifier #=> String
     #   resp.arn #=> String
-    #   resp.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED"
+    #   resp.status #=> String, one of "CREATING", "ACTIVE", "IDLE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", "PENDING_SETUP", "PENDING_DELETE"
     #   resp.creation_time #=> Time
+    #   resp.multi_region_properties.witness_region #=> String
+    #   resp.multi_region_properties.clusters #=> Array
+    #   resp.multi_region_properties.clusters[0] #=> String
     #   resp.deletion_protection_enabled #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dsql-2018-05-10/CreateCluster AWS API Documentation
@@ -585,8 +653,8 @@ module Aws::DSQL
     #   resp.to_h outputs the following:
     #   {
     #     linked_cluster_arns: [
-    #       "arn:aws:dsql:us-east-1:111122223333:cluster/abcdefghijklmnopqrst12345", 
-    #       "arn:aws:dsql:us-east-2:111122223333:cluster/klmnopqrstuvwxyzabcd54321", 
+    #       "arn:aws:dsql:us-east-1:111122223333:cluster/abcdefghijklmnopqrstu12345", 
+    #       "arn:aws:dsql:us-east-2:111122223333:cluster/klmnopqrstuvwxyzabcde54321", 
     #     ], 
     #   }
     #
@@ -665,7 +733,7 @@ module Aws::DSQL
     #
     #   resp.identifier #=> String
     #   resp.arn #=> String
-    #   resp.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED"
+    #   resp.status #=> String, one of "CREATING", "ACTIVE", "IDLE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", "PENDING_SETUP", "PENDING_DELETE"
     #   resp.creation_time #=> Time
     #   resp.deletion_protection_enabled #=> Boolean
     #
@@ -705,8 +773,8 @@ module Aws::DSQL
     #
     #   resp = client.delete_multi_region_clusters({
     #     linked_cluster_arns: [
-    #       "arn:aws:dsql:us-east-1:111122223333:cluster/abcdefghijklmnopqrst12345", 
-    #       "arn:aws:dsql:us-east-2:111122223333:cluster/klmnopqrstuvwxyzabcd54321", 
+    #       "arn:aws:dsql:us-east-1:111122223333:cluster/abcdefghijklmnopqrstu12345", 
+    #       "arn:aws:dsql:us-east-2:111122223333:cluster/klmnopqrstuvwxyzabcde54321", 
     #     ], 
     #   })
     #
@@ -737,9 +805,11 @@ module Aws::DSQL
     #   * {Types::GetClusterOutput#arn #arn} => String
     #   * {Types::GetClusterOutput#status #status} => String
     #   * {Types::GetClusterOutput#creation_time #creation_time} => Time
-    #   * {Types::GetClusterOutput#deletion_protection_enabled #deletion_protection_enabled} => Boolean
     #   * {Types::GetClusterOutput#witness_region #witness_region} => String
     #   * {Types::GetClusterOutput#linked_cluster_arns #linked_cluster_arns} => Array&lt;String&gt;
+    #   * {Types::GetClusterOutput#deletion_protection_enabled #deletion_protection_enabled} => Boolean
+    #   * {Types::GetClusterOutput#multi_region_properties #multi_region_properties} => Types::MultiRegionProperties
+    #   * {Types::GetClusterOutput#tags #tags} => Hash&lt;String,String&gt;
     #
     #
     # @example Example: Get Cluster
@@ -758,12 +828,17 @@ module Aws::DSQL
     #
     #   resp.identifier #=> String
     #   resp.arn #=> String
-    #   resp.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED"
+    #   resp.status #=> String, one of "CREATING", "ACTIVE", "IDLE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", "PENDING_SETUP", "PENDING_DELETE"
     #   resp.creation_time #=> Time
-    #   resp.deletion_protection_enabled #=> Boolean
     #   resp.witness_region #=> String
     #   resp.linked_cluster_arns #=> Array
     #   resp.linked_cluster_arns[0] #=> String
+    #   resp.deletion_protection_enabled #=> Boolean
+    #   resp.multi_region_properties.witness_region #=> String
+    #   resp.multi_region_properties.clusters #=> Array
+    #   resp.multi_region_properties.clusters[0] #=> String
+    #   resp.tags #=> Hash
+    #   resp.tags["TagKey"] #=> String
     #
     #
     # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -976,6 +1051,26 @@ module Aws::DSQL
 
     # Updates a cluster.
     #
+    # **Example IAM Policy for Multi-Region Operations**
+    #
+    # The following IAM policy grants permissions for multi-Region
+    # operations.
+    #
+    # The `dsql:RemovePeerCluster` permission uses a wildcard ARN pattern to
+    # simplify permission management during updates.
+    #
+    # **Important Notes for Multi-Region Operations**
+    #
+    #  * The witness region specified in
+    #   `multiRegionProperties.witnessRegion` cannot be the same as the
+    #   cluster's Region.
+    #
+    # * When updating clusters with peer relationships, permissions are
+    #   checked for both adding and removing peers.
+    #
+    # * The `dsql:RemovePeerCluster` permission uses a wildcard ARN pattern
+    #   to simplify permission management during updates.
+    #
     # @option params [required, String] :identifier
     #   The ID of the cluster you want to update.
     #
@@ -996,15 +1091,19 @@ module Aws::DSQL
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [Types::MultiRegionProperties] :multi_region_properties
+    #   The new multi-Region cluster configuration settings to be applied
+    #   during an update operation.
+    #
     # @return [Types::UpdateClusterOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateClusterOutput#identifier #identifier} => String
     #   * {Types::UpdateClusterOutput#arn #arn} => String
     #   * {Types::UpdateClusterOutput#status #status} => String
     #   * {Types::UpdateClusterOutput#creation_time #creation_time} => Time
-    #   * {Types::UpdateClusterOutput#deletion_protection_enabled #deletion_protection_enabled} => Boolean
     #   * {Types::UpdateClusterOutput#witness_region #witness_region} => String
     #   * {Types::UpdateClusterOutput#linked_cluster_arns #linked_cluster_arns} => Array&lt;String&gt;
+    #   * {Types::UpdateClusterOutput#deletion_protection_enabled #deletion_protection_enabled} => Boolean
     #
     #
     # @example Example: Update Cluster
@@ -1020,18 +1119,22 @@ module Aws::DSQL
     #     identifier: "ClusterId", # required
     #     deletion_protection_enabled: false,
     #     client_token: "ClientToken",
+    #     multi_region_properties: {
+    #       witness_region: "Region",
+    #       clusters: ["ClusterArn"],
+    #     },
     #   })
     #
     # @example Response structure
     #
     #   resp.identifier #=> String
     #   resp.arn #=> String
-    #   resp.status #=> String, one of "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED"
+    #   resp.status #=> String, one of "CREATING", "ACTIVE", "IDLE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", "PENDING_SETUP", "PENDING_DELETE"
     #   resp.creation_time #=> Time
-    #   resp.deletion_protection_enabled #=> Boolean
     #   resp.witness_region #=> String
     #   resp.linked_cluster_arns #=> Array
     #   resp.linked_cluster_arns[0] #=> String
+    #   resp.deletion_protection_enabled #=> Boolean
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dsql-2018-05-10/UpdateCluster AWS API Documentation
     #
@@ -1060,7 +1163,7 @@ module Aws::DSQL
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-dsql'
-      context[:gem_version] = '1.7.0'
+      context[:gem_version] = '1.8.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -46,6 +46,7 @@ module Aws::DSQL
     ListTagsForResourceInput = Shapes::StructureShape.new(name: 'ListTagsForResourceInput')
     ListTagsForResourceOutput = Shapes::StructureShape.new(name: 'ListTagsForResourceOutput')
     MaxResults = Shapes::IntegerShape.new(name: 'MaxResults')
+    MultiRegionProperties = Shapes::StructureShape.new(name: 'MultiRegionProperties')
     NextToken = Shapes::StringShape.new(name: 'NextToken')
     Region = Shapes::StringShape.new(name: 'Region')
     RegionList = Shapes::ListShape.new(name: 'RegionList')
@@ -75,7 +76,7 @@ module Aws::DSQL
     ClusterList.member = Shapes::ShapeRef.new(shape: ClusterSummary)
 
     ClusterPropertyMap.key = Shapes::ShapeRef.new(shape: Region)
-    ClusterPropertyMap.value = Shapes::ShapeRef.new(shape: LinkedClusterProperties)
+    ClusterPropertyMap.value = Shapes::ShapeRef.new(shape: LinkedClusterProperties, deprecated: true)
 
     ClusterSummary.add_member(:identifier, Shapes::ShapeRef.new(shape: ClusterId, required: true, location_name: "identifier"))
     ClusterSummary.add_member(:arn, Shapes::ShapeRef.new(shape: ClusterArn, required: true, location_name: "arn"))
@@ -89,17 +90,19 @@ module Aws::DSQL
     CreateClusterInput.add_member(:deletion_protection_enabled, Shapes::ShapeRef.new(shape: DeletionProtectionEnabled, location_name: "deletionProtectionEnabled"))
     CreateClusterInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
     CreateClusterInput.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "clientToken", metadata: {"idempotencyToken" => true}))
+    CreateClusterInput.add_member(:multi_region_properties, Shapes::ShapeRef.new(shape: MultiRegionProperties, location_name: "multiRegionProperties"))
     CreateClusterInput.struct_class = Types::CreateClusterInput
 
     CreateClusterOutput.add_member(:identifier, Shapes::ShapeRef.new(shape: ClusterId, required: true, location_name: "identifier"))
     CreateClusterOutput.add_member(:arn, Shapes::ShapeRef.new(shape: ClusterArn, required: true, location_name: "arn"))
     CreateClusterOutput.add_member(:status, Shapes::ShapeRef.new(shape: ClusterStatus, required: true, location_name: "status"))
     CreateClusterOutput.add_member(:creation_time, Shapes::ShapeRef.new(shape: ClusterCreationTime, required: true, location_name: "creationTime"))
+    CreateClusterOutput.add_member(:multi_region_properties, Shapes::ShapeRef.new(shape: MultiRegionProperties, location_name: "multiRegionProperties"))
     CreateClusterOutput.add_member(:deletion_protection_enabled, Shapes::ShapeRef.new(shape: DeletionProtectionEnabled, required: true, location_name: "deletionProtectionEnabled"))
     CreateClusterOutput.struct_class = Types::CreateClusterOutput
 
-    CreateMultiRegionClustersInput.add_member(:linked_region_list, Shapes::ShapeRef.new(shape: RegionList, required: true, location_name: "linkedRegionList"))
-    CreateMultiRegionClustersInput.add_member(:cluster_properties, Shapes::ShapeRef.new(shape: ClusterPropertyMap, location_name: "clusterProperties"))
+    CreateMultiRegionClustersInput.add_member(:linked_region_list, Shapes::ShapeRef.new(shape: RegionList, required: true, deprecated: true, location_name: "linkedRegionList"))
+    CreateMultiRegionClustersInput.add_member(:cluster_properties, Shapes::ShapeRef.new(shape: ClusterPropertyMap, deprecated: true, location_name: "clusterProperties"))
     CreateMultiRegionClustersInput.add_member(:witness_region, Shapes::ShapeRef.new(shape: Region, required: true, location_name: "witnessRegion"))
     CreateMultiRegionClustersInput.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "clientToken", metadata: {"idempotencyToken" => true}))
     CreateMultiRegionClustersInput.struct_class = Types::CreateMultiRegionClustersInput
@@ -115,7 +118,7 @@ module Aws::DSQL
     DeleteClusterOutput.add_member(:arn, Shapes::ShapeRef.new(shape: ClusterArn, required: true, location_name: "arn"))
     DeleteClusterOutput.add_member(:status, Shapes::ShapeRef.new(shape: ClusterStatus, required: true, location_name: "status"))
     DeleteClusterOutput.add_member(:creation_time, Shapes::ShapeRef.new(shape: ClusterCreationTime, required: true, location_name: "creationTime"))
-    DeleteClusterOutput.add_member(:deletion_protection_enabled, Shapes::ShapeRef.new(shape: DeletionProtectionEnabled, required: true, location_name: "deletionProtectionEnabled"))
+    DeleteClusterOutput.add_member(:deletion_protection_enabled, Shapes::ShapeRef.new(shape: DeletionProtectionEnabled, required: true, deprecated: true, location_name: "deletionProtectionEnabled", metadata: {"deprecatedMessage" => "The deletionProtectionEnabled field is deprecated in the DeleteCluster API. To check deletion protection status, use the GetCluster API instead.", "deprecatedSince" => "5/13/2025"}))
     DeleteClusterOutput.struct_class = Types::DeleteClusterOutput
 
     DeleteMultiRegionClustersInput.add_member(:linked_cluster_arns, Shapes::ShapeRef.new(shape: ClusterArnList, required: true, location: "querystring", location_name: "linked-cluster-arns"))
@@ -129,9 +132,11 @@ module Aws::DSQL
     GetClusterOutput.add_member(:arn, Shapes::ShapeRef.new(shape: ClusterArn, required: true, location_name: "arn"))
     GetClusterOutput.add_member(:status, Shapes::ShapeRef.new(shape: ClusterStatus, required: true, location_name: "status"))
     GetClusterOutput.add_member(:creation_time, Shapes::ShapeRef.new(shape: ClusterCreationTime, required: true, location_name: "creationTime"))
+    GetClusterOutput.add_member(:witness_region, Shapes::ShapeRef.new(shape: Region, deprecated: true, location_name: "witnessRegion", metadata: {"deprecatedMessage" => "The witnessRegion field is deprecated. To see the witnessRegion, use multiRegionProperties.witnessRegion instead.", "deprecatedSince" => "5/13/2025"}))
+    GetClusterOutput.add_member(:linked_cluster_arns, Shapes::ShapeRef.new(shape: ClusterArnList, deprecated: true, location_name: "linkedClusterArns", metadata: {"deprecatedMessage" => "The linkedClusterArns field is deprecated. To see the peered cluster Arns, use multiRegionProperties.cluster instead.", "deprecatedSince" => "5/13/2025"}))
     GetClusterOutput.add_member(:deletion_protection_enabled, Shapes::ShapeRef.new(shape: DeletionProtectionEnabled, required: true, location_name: "deletionProtectionEnabled"))
-    GetClusterOutput.add_member(:witness_region, Shapes::ShapeRef.new(shape: Region, location_name: "witnessRegion"))
-    GetClusterOutput.add_member(:linked_cluster_arns, Shapes::ShapeRef.new(shape: ClusterArnList, location_name: "linkedClusterArns"))
+    GetClusterOutput.add_member(:multi_region_properties, Shapes::ShapeRef.new(shape: MultiRegionProperties, location_name: "multiRegionProperties"))
+    GetClusterOutput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
     GetClusterOutput.struct_class = Types::GetClusterOutput
 
     GetVpcEndpointServiceNameInput.add_member(:identifier, Shapes::ShapeRef.new(shape: ClusterId, required: true, location: "uri", location_name: "identifier"))
@@ -162,6 +167,10 @@ module Aws::DSQL
     ListTagsForResourceOutput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
     ListTagsForResourceOutput.struct_class = Types::ListTagsForResourceOutput
 
+    MultiRegionProperties.add_member(:witness_region, Shapes::ShapeRef.new(shape: Region, location_name: "witnessRegion"))
+    MultiRegionProperties.add_member(:clusters, Shapes::ShapeRef.new(shape: ClusterArnList, location_name: "clusters"))
+    MultiRegionProperties.struct_class = Types::MultiRegionProperties
+
     RegionList.member = Shapes::ShapeRef.new(shape: Region)
 
     ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
@@ -198,15 +207,16 @@ module Aws::DSQL
     UpdateClusterInput.add_member(:identifier, Shapes::ShapeRef.new(shape: ClusterId, required: true, location: "uri", location_name: "identifier"))
     UpdateClusterInput.add_member(:deletion_protection_enabled, Shapes::ShapeRef.new(shape: DeletionProtectionEnabled, location_name: "deletionProtectionEnabled"))
     UpdateClusterInput.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "clientToken", metadata: {"idempotencyToken" => true}))
+    UpdateClusterInput.add_member(:multi_region_properties, Shapes::ShapeRef.new(shape: MultiRegionProperties, location_name: "multiRegionProperties"))
     UpdateClusterInput.struct_class = Types::UpdateClusterInput
 
     UpdateClusterOutput.add_member(:identifier, Shapes::ShapeRef.new(shape: ClusterId, required: true, location_name: "identifier"))
     UpdateClusterOutput.add_member(:arn, Shapes::ShapeRef.new(shape: ClusterArn, required: true, location_name: "arn"))
     UpdateClusterOutput.add_member(:status, Shapes::ShapeRef.new(shape: ClusterStatus, required: true, location_name: "status"))
     UpdateClusterOutput.add_member(:creation_time, Shapes::ShapeRef.new(shape: ClusterCreationTime, required: true, location_name: "creationTime"))
-    UpdateClusterOutput.add_member(:deletion_protection_enabled, Shapes::ShapeRef.new(shape: DeletionProtectionEnabled, required: true, location_name: "deletionProtectionEnabled"))
-    UpdateClusterOutput.add_member(:witness_region, Shapes::ShapeRef.new(shape: Region, location_name: "witnessRegion"))
-    UpdateClusterOutput.add_member(:linked_cluster_arns, Shapes::ShapeRef.new(shape: ClusterArnList, location_name: "linkedClusterArns"))
+    UpdateClusterOutput.add_member(:witness_region, Shapes::ShapeRef.new(shape: Region, deprecated: true, location_name: "witnessRegion", metadata: {"deprecatedMessage" => "The witnessRegion field is deprecated in the UpdateCluster API. To check witnessRegion, use the GetCluster API instead.", "deprecatedSince" => "5/13/2025"}))
+    UpdateClusterOutput.add_member(:linked_cluster_arns, Shapes::ShapeRef.new(shape: ClusterArnList, deprecated: true, location_name: "linkedClusterArns", metadata: {"deprecatedMessage" => "The linkedClusterArns field is deprecated in the UpdateCluster API. To check peer cluster, use the GetCluster API instead.", "deprecatedSince" => "5/13/2025"}))
+    UpdateClusterOutput.add_member(:deletion_protection_enabled, Shapes::ShapeRef.new(shape: DeletionProtectionEnabled, required: true, deprecated: true, location_name: "deletionProtectionEnabled", metadata: {"deprecatedMessage" => "The deletionProtectionEnabled field is deprecated in the UpdateCluster API. To check deletion protection status, use the GetCluster API instead.", "deprecatedSince" => "5/13/2025"}))
     UpdateClusterOutput.struct_class = Types::UpdateClusterOutput
 
     ValidationException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
@@ -247,8 +257,8 @@ module Aws::DSQL
         o.output = Shapes::ShapeRef.new(shape: CreateClusterOutput)
         o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
-        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
         o.errors << Shapes::ShapeRef.new(shape: ConflictException)
       end)
@@ -257,6 +267,7 @@ module Aws::DSQL
         o.name = "CreateMultiRegionClusters"
         o.http_method = "POST"
         o.http_request_uri = "/multi-region-clusters"
+        o.deprecated = true
         o.input = Shapes::ShapeRef.new(shape: CreateMultiRegionClustersInput)
         o.output = Shapes::ShapeRef.new(shape: CreateMultiRegionClustersOutput)
         o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
@@ -285,6 +296,7 @@ module Aws::DSQL
         o.name = "DeleteMultiRegionClusters"
         o.http_method = "DELETE"
         o.http_request_uri = "/multi-region-clusters"
+        o.deprecated = true
         o.input = Shapes::ShapeRef.new(shape: DeleteMultiRegionClustersInput)
         o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
@@ -387,8 +399,8 @@ module Aws::DSQL
         o.input = Shapes::ShapeRef.new(shape: UpdateClusterInput)
         o.output = Shapes::ShapeRef.new(shape: UpdateClusterOutput)
         o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
-        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: ConflictException)

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

@@ -89,17 +89,23 @@ module Aws::DSQL
     #   not need to pass this option.
     #   @return [String]
     #
+    # @!attribute [rw] multi_region_properties
+    #   The configuration settings when creating a multi-Region cluster,
+    #   including the witness region and linked cluster properties.
+    #   @return [Types::MultiRegionProperties]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dsql-2018-05-10/CreateClusterInput AWS API Documentation
     #
     class CreateClusterInput < Struct.new(
       :deletion_protection_enabled,
       :tags,
-      :client_token)
+      :client_token,
+      :multi_region_properties)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Output Mixin
+    # The output of a created cluster.
     #
     # @!attribute [rw] identifier
     #   The ID of the created cluster.
@@ -117,6 +123,11 @@ module Aws::DSQL
     #   The time of when created the cluster.
     #   @return [Time]
     #
+    # @!attribute [rw] multi_region_properties
+    #   The multi-Region cluster configuration details that were set during
+    #   cluster creation
+    #   @return [Types::MultiRegionProperties]
+    #
     # @!attribute [rw] deletion_protection_enabled
     #   Whether deletion protection is enabled on this cluster.
     #   @return [Boolean]
@@ -128,6 +139,7 @@ module Aws::DSQL
       :arn,
       :status,
       :creation_time,
+      :multi_region_properties,
       :deletion_protection_enabled)
       SENSITIVE = []
       include Aws::Structure
@@ -212,7 +224,7 @@ module Aws::DSQL
       include Aws::Structure
     end
 
-    # Output Mixin
+    # The output from a deleted cluster.
     #
     # @!attribute [rw] identifier
     #   The ID of the deleted cluster.
@@ -287,7 +299,7 @@ module Aws::DSQL
       include Aws::Structure
     end
 
-    # Output Mixin
+    # The output of a cluster.
     #
     # @!attribute [rw] identifier
     #   The ID of the retrieved cluster.
@@ -305,10 +317,6 @@ module Aws::DSQL
     #   The time of when the cluster was created.
     #   @return [Time]
     #
-    # @!attribute [rw] deletion_protection_enabled
-    #   Whether deletion protection is enabled in this cluster.
-    #   @return [Boolean]
-    #
     # @!attribute [rw] witness_region
     #   The witness Region of the cluster. Applicable only for multi-Region
     #   clusters.
@@ -318,6 +326,19 @@ module Aws::DSQL
     #   The ARNs of the clusters linked to the retrieved cluster.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] deletion_protection_enabled
+    #   Whether deletion protection is enabled in this cluster.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] multi_region_properties
+    #   Returns the current multi-Region cluster configuration, including
+    #   witness region and linked cluster information.
+    #   @return [Types::MultiRegionProperties]
+    #
+    # @!attribute [rw] tags
+    #   Map of tags.
+    #   @return [Hash<String,String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dsql-2018-05-10/GetClusterOutput AWS API Documentation
     #
     class GetClusterOutput < Struct.new(
@@ -325,9 +346,11 @@ module Aws::DSQL
       :arn,
       :status,
       :creation_time,
-      :deletion_protection_enabled,
       :witness_region,
-      :linked_cluster_arns)
+      :linked_cluster_arns,
+      :deletion_protection_enabled,
+      :multi_region_properties,
+      :tags)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -459,17 +482,40 @@ module Aws::DSQL
       include Aws::Structure
     end
 
+    # Defines the structure for multi-Region cluster configurations,
+    # containing the witness region and linked cluster settings.
+    #
+    # @!attribute [rw] witness_region
+    #   The that serves as the witness region for a multi-Region cluster.
+    #   The witness region helps maintain cluster consistency and quorum.
+    #   @return [String]
+    #
+    # @!attribute [rw] clusters
+    #   The set of linked clusters that form the multi-Region cluster
+    #   configuration. Each linked cluster represents a database instance in
+    #   a different Region.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dsql-2018-05-10/MultiRegionProperties AWS API Documentation
+    #
+    class MultiRegionProperties < Struct.new(
+      :witness_region,
+      :clusters)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The resource could not be found.
     #
     # @!attribute [rw] message
     #   @return [String]
     #
     # @!attribute [rw] resource_id
-    #   Hypothetical identifier of the resource which does not exist
+    #   The resource ID could not be found.
     #   @return [String]
     #
     # @!attribute [rw] resource_type
-    #   Hypothetical type of the resource which does not exist
+    #   The resource type could not be found.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dsql-2018-05-10/ResourceNotFoundException AWS API Documentation
@@ -485,23 +531,23 @@ module Aws::DSQL
     # The service limit was exceeded.
     #
     # @!attribute [rw] message
-    #   Description of the error
+    #   The service exception for exceeding a quota.
     #   @return [String]
     #
     # @!attribute [rw] resource_id
-    #   Identifier of the resource affected
+    #   The resource ID exceeds a quota.
     #   @return [String]
     #
     # @!attribute [rw] resource_type
-    #   Type of the resource affected
+    #   The resource type exceeds a quota.
     #   @return [String]
     #
     # @!attribute [rw] service_code
-    #   Service Quotas requirement to identify originating service
+    #   The request exceeds a service quota.
     #   @return [String]
     #
     # @!attribute [rw] quota_code
-    #   Service Quotas requirement to identify originating quota
+    #   The service exceeds a quota.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dsql-2018-05-10/ServiceQuotaExceededException AWS API Documentation
@@ -536,19 +582,19 @@ module Aws::DSQL
     # The request was denied due to request throttling.
     #
     # @!attribute [rw] message
-    #   Description of the error
+    #   The message that the request was denied due to request throttling.
     #   @return [String]
     #
     # @!attribute [rw] service_code
-    #   Service Quotas requirement to identify originating service
+    #   The request exceeds a service quota.
     #   @return [String]
     #
     # @!attribute [rw] quota_code
-    #   Service Quotas requirement to identify originating quota
+    #   The request exceeds a request rate quota.
     #   @return [String]
     #
     # @!attribute [rw] retry_after_seconds
-    #   Advice to clients on when the call can be safely retried
+    #   The request exceeds a request rate quota. Retry after seconds.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dsql-2018-05-10/ThrottlingException AWS API Documentation
@@ -602,17 +648,23 @@ module Aws::DSQL
     #   not need to pass this option.
     #   @return [String]
     #
+    # @!attribute [rw] multi_region_properties
+    #   The new multi-Region cluster configuration settings to be applied
+    #   during an update operation.
+    #   @return [Types::MultiRegionProperties]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dsql-2018-05-10/UpdateClusterInput AWS API Documentation
     #
     class UpdateClusterInput < Struct.new(
       :identifier,
       :deletion_protection_enabled,
-      :client_token)
+      :client_token,
+      :multi_region_properties)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Output Mixin
+    # The details of the cluster after it has been updated.
     #
     # @!attribute [rw] identifier
     #   The ID of the cluster to update.
@@ -630,10 +682,6 @@ module Aws::DSQL
     #   The time of when the cluster was created.
     #   @return [Time]
     #
-    # @!attribute [rw] deletion_protection_enabled
-    #   Whether deletion protection is enabled for the updated cluster.
-    #   @return [Boolean]
-    #
     # @!attribute [rw] witness_region
     #   The Region that receives all data you write to linked clusters.
     #   @return [String]
@@ -643,6 +691,10 @@ module Aws::DSQL
     #   only for multi-Region clusters.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] deletion_protection_enabled
+    #   Whether deletion protection is enabled for the updated cluster.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dsql-2018-05-10/UpdateClusterOutput AWS API Documentation
     #
     class UpdateClusterOutput < Struct.new(
@@ -650,9 +702,9 @@ module Aws::DSQL
       :arn,
       :status,
       :creation_time,
-      :deletion_protection_enabled,
       :witness_region,
-      :linked_cluster_arns)
+      :linked_cluster_arns,
+      :deletion_protection_enabled)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -664,11 +716,11 @@ module Aws::DSQL
     #   @return [String]
     #
     # @!attribute [rw] reason
-    #   Reason the request failed validation
+    #   The reason for the validation exception.
     #   @return [String]
     #
     # @!attribute [rw] field_list
-    #   List of fields that caused the error
+    #   A list of fields that didn't validate.
     #   @return [Array<Types::ValidationExceptionField>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dsql-2018-05-10/ValidationException AWS API Documentation

data/lib/aws-sdk-dsql.rb

@@ -55,7 +55,7 @@ module Aws::DSQL
   autoload :EndpointProvider, 'aws-sdk-dsql/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-dsql/endpoints'
 
-  GEM_VERSION = '1.7.0'
+  GEM_VERSION = '1.8.0'
 
 end
 

data/sig/client.rbs

@@ -81,15 +81,20 @@ module Aws
         include ::Seahorse::Client::_ResponseSuccess[Types::CreateClusterOutput]
         def identifier: () -> ::String
         def arn: () -> ::String
-        def status: () -> ("CREATING" | "ACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED")
+        def status: () -> ("CREATING" | "ACTIVE" | "IDLE" | "INACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED" | "PENDING_SETUP" | "PENDING_DELETE")
         def creation_time: () -> ::Time
+        def multi_region_properties: () -> Types::MultiRegionProperties
         def deletion_protection_enabled: () -> bool
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/DSQL/Client.html#create_cluster-instance_method
       def create_cluster: (
                             ?deletion_protection_enabled: bool,
                             ?tags: Hash[::String, ::String],
-                            ?client_token: ::String
+                            ?client_token: ::String,
+                            ?multi_region_properties: {
+                              witness_region: ::String?,
+                              clusters: Array[::String]?
+                            }
                           ) -> _CreateClusterResponseSuccess
                         | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateClusterResponseSuccess
 
@@ -113,7 +118,7 @@ module Aws
         include ::Seahorse::Client::_ResponseSuccess[Types::DeleteClusterOutput]
         def identifier: () -> ::String
         def arn: () -> ::String
-        def status: () -> ("CREATING" | "ACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED")
+        def status: () -> ("CREATING" | "ACTIVE" | "IDLE" | "INACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED" | "PENDING_SETUP" | "PENDING_DELETE")
         def creation_time: () -> ::Time
         def deletion_protection_enabled: () -> bool
       end
@@ -135,11 +140,13 @@ module Aws
         include ::Seahorse::Client::_ResponseSuccess[Types::GetClusterOutput]
         def identifier: () -> ::String
         def arn: () -> ::String
-        def status: () -> ("CREATING" | "ACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED")
+        def status: () -> ("CREATING" | "ACTIVE" | "IDLE" | "INACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED" | "PENDING_SETUP" | "PENDING_DELETE")
         def creation_time: () -> ::Time
-        def deletion_protection_enabled: () -> bool
         def witness_region: () -> ::String
         def linked_cluster_arns: () -> ::Array[::String]
+        def deletion_protection_enabled: () -> bool
+        def multi_region_properties: () -> Types::MultiRegionProperties
+        def tags: () -> ::Hash[::String, ::String]
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/DSQL/Client.html#get_cluster-instance_method
       def get_cluster: (
@@ -197,17 +204,21 @@ module Aws
         include ::Seahorse::Client::_ResponseSuccess[Types::UpdateClusterOutput]
         def identifier: () -> ::String
         def arn: () -> ::String
-        def status: () -> ("CREATING" | "ACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED")
+        def status: () -> ("CREATING" | "ACTIVE" | "IDLE" | "INACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED" | "PENDING_SETUP" | "PENDING_DELETE")
         def creation_time: () -> ::Time
-        def deletion_protection_enabled: () -> bool
         def witness_region: () -> ::String
         def linked_cluster_arns: () -> ::Array[::String]
+        def deletion_protection_enabled: () -> bool
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/DSQL/Client.html#update_cluster-instance_method
       def update_cluster: (
                             identifier: ::String,
                             ?deletion_protection_enabled: bool,
-                            ?client_token: ::String
+                            ?client_token: ::String,
+                            ?multi_region_properties: {
+                              witness_region: ::String?,
+                              clusters: Array[::String]?
+                            }
                           ) -> _UpdateClusterResponseSuccess
                         | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateClusterResponseSuccess
 

data/sig/types.rbs

@@ -30,14 +30,16 @@ module Aws::DSQL
       attr_accessor deletion_protection_enabled: bool
       attr_accessor tags: ::Hash[::String, ::String]
       attr_accessor client_token: ::String
+      attr_accessor multi_region_properties: Types::MultiRegionProperties
       SENSITIVE: []
     end
 
     class CreateClusterOutput
       attr_accessor identifier: ::String
       attr_accessor arn: ::String
-      attr_accessor status: ("CREATING" | "ACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED")
+      attr_accessor status: ("CREATING" | "ACTIVE" | "IDLE" | "INACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED" | "PENDING_SETUP" | "PENDING_DELETE")
       attr_accessor creation_time: ::Time
+      attr_accessor multi_region_properties: Types::MultiRegionProperties
       attr_accessor deletion_protection_enabled: bool
       SENSITIVE: []
     end
@@ -64,7 +66,7 @@ module Aws::DSQL
     class DeleteClusterOutput
       attr_accessor identifier: ::String
       attr_accessor arn: ::String
-      attr_accessor status: ("CREATING" | "ACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED")
+      attr_accessor status: ("CREATING" | "ACTIVE" | "IDLE" | "INACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED" | "PENDING_SETUP" | "PENDING_DELETE")
       attr_accessor creation_time: ::Time
       attr_accessor deletion_protection_enabled: bool
       SENSITIVE: []
@@ -84,11 +86,13 @@ module Aws::DSQL
     class GetClusterOutput
       attr_accessor identifier: ::String
       attr_accessor arn: ::String
-      attr_accessor status: ("CREATING" | "ACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED")
+      attr_accessor status: ("CREATING" | "ACTIVE" | "IDLE" | "INACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED" | "PENDING_SETUP" | "PENDING_DELETE")
       attr_accessor creation_time: ::Time
-      attr_accessor deletion_protection_enabled: bool
       attr_accessor witness_region: ::String
       attr_accessor linked_cluster_arns: ::Array[::String]
+      attr_accessor deletion_protection_enabled: bool
+      attr_accessor multi_region_properties: Types::MultiRegionProperties
+      attr_accessor tags: ::Hash[::String, ::String]
       SENSITIVE: []
     end
 
@@ -136,6 +140,12 @@ module Aws::DSQL
       SENSITIVE: []
     end
 
+    class MultiRegionProperties
+      attr_accessor witness_region: ::String
+      attr_accessor clusters: ::Array[::String]
+      SENSITIVE: []
+    end
+
     class ResourceNotFoundException
       attr_accessor message: ::String
       attr_accessor resource_id: ::String
@@ -176,17 +186,18 @@ module Aws::DSQL
       attr_accessor identifier: ::String
       attr_accessor deletion_protection_enabled: bool
       attr_accessor client_token: ::String
+      attr_accessor multi_region_properties: Types::MultiRegionProperties
       SENSITIVE: []
     end
 
     class UpdateClusterOutput
       attr_accessor identifier: ::String
       attr_accessor arn: ::String
-      attr_accessor status: ("CREATING" | "ACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED")
+      attr_accessor status: ("CREATING" | "ACTIVE" | "IDLE" | "INACTIVE" | "UPDATING" | "DELETING" | "DELETED" | "FAILED" | "PENDING_SETUP" | "PENDING_DELETE")
       attr_accessor creation_time: ::Time
-      attr_accessor deletion_protection_enabled: bool
       attr_accessor witness_region: ::String
       attr_accessor linked_cluster_arns: ::Array[::String]
+      attr_accessor deletion_protection_enabled: bool
       SENSITIVE: []
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-dsql
 version: !ruby/object:Gem::Version
-  version: 1.7.0
+  version: 1.8.0
 platform: ruby
 authors:
 - Amazon Web Services