aws-sdk-neptune 1.84.0 → 1.85.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 746147ac31146ca2c5be27607d3a59b8fffd832eb72d508baa1a2425b211ab7c
-  data.tar.gz: 0a31a900c29ece7d1122d7e2a5bbafb2bab65463093058aef20965d2be462102
+  metadata.gz: 6bacaad6b935d197dcf24115f2ce47c0318a3b766f4a5f38527adc1889f44578
+  data.tar.gz: e3443e6d1cb1ab8f15c5cc5c03459a2c035044c4a066e1557dd278b56bd09f6a
 SHA512:
-  metadata.gz: f685236467a778306a46e9e92cb59a29dd1d8982b837a51ec2d6b65fb259fbf7d18b4901e4b4c415bb3a2eb95e68f7070eb49ffc412fea4b10f878e33665842e
-  data.tar.gz: 52cb4af210b1e280556c8c9abbc884cfc291adf13c95d3567a2ab402cf9ff600c85ef7df8772b86dcb4d2cb6fbbcbc4c2aaec80fcdfcdbe0f970de768fefe27d
+  metadata.gz: 4dab8812e5c0bdd2bfc73ab064fed223f3c483cab26ebdb818402ec6228057262723c094ddc1ac13db69eff922feae559b839b15354c623406760116688fe504
+  data.tar.gz: 1fad5b54f266ad7d1663287587ae62912c188b7ab0f1f3a868181c30a7100935b1bbf028e6f77ce24dd717b43256b8b0ef986c331765482590dc0fdf161d31de

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.85.0 (2025-05-16)
+------------------
+
+* Feature - This release adds Global Cluster Switchover capability which enables you to change your global cluster's primary AWS Region, the region that serves writes, while preserving the replication between all regions in the global cluster.
+
 1.84.0 (2025-05-12)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.84.0
+1.85.0

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

@@ -1028,7 +1028,7 @@ module Aws::Neptune
     #   The version number of the database engine to use for the new DB
     #   cluster.
     #
-    #   Example: `1.0.2.1`
+    #   Example: `1.2.1.0`
     #
     # @option params [Integer] :port
     #   The port number on which the instances in the DB cluster accept
@@ -1167,25 +1167,26 @@ module Aws::Neptune
     #   should be added.
     #
     # @option params [String] :storage_type
-    #   The storage type to associate with the DB cluster.
+    #   The storage type for the new DB cluster.
     #
     #   Valid Values:
     #
-    #   * `standard | iopt1`
-    #
-    #   ^
+    #   * <b> <code>standard</code> </b>   –   ( *the default* ) Configures
+    #     cost-effective database storage for applications with moderate to
+    #     small I/O usage. When set to `standard`, the storage type is not
+    #     returned in the response.
     #
-    #   Default:
+    #   * <b> <code>iopt1</code> </b>   –   Enables [I/O-Optimized storage][1]
+    #     that's designed to meet the needs of I/O-intensive graph workloads
+    #     that require predictable pricing with low I/O latency and consistent
+    #     I/O throughput.
     #
-    #   * `standard`
+    #     Neptune I/O-Optimized storage is only available starting with engine
+    #     release 1.3.0.0.
     #
-    #   ^
     #
-    #   <note markdown="1"> When you create a Neptune cluster with the storage type set to
-    #   `iopt1`, the storage type is returned in the response. The storage
-    #   type isn't returned when you set it to `standard`.
     #
-    #    </note>
+    #   [1]: https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage
     #
     # @option params [String] :source_region
     #   The source region of the snapshot. This is only needed when the
@@ -1744,9 +1745,8 @@ module Aws::Neptune
     #   Type: String
     #
     # @option params [String] :storage_type
-    #   Specifies the storage type to be associated with the DB instance.
-    #
-    #   Not applicable. Storage is managed by the DB Cluster.
+    #   Not applicable. In Neptune the storage type is managed at the DB
+    #   Cluster level.
     #
     # @option params [String] :tde_credential_arn
     #   The ARN from the key store with which to associate the instance for
@@ -2347,6 +2347,10 @@ module Aws::Neptune
     #   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.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/neptune-2014-10-31/CreateGlobalCluster AWS API Documentation
     #
@@ -2969,6 +2973,10 @@ module Aws::Neptune
     #   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.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/neptune-2014-10-31/DeleteGlobalCluster AWS API Documentation
     #
@@ -4568,6 +4576,10 @@ module Aws::Neptune
     #   resp.global_clusters[0].global_cluster_members[0].readers #=> Array
     #   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].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/neptune-2014-10-31/DescribeGlobalClusters AWS API Documentation
     #
@@ -4955,6 +4967,22 @@ module Aws::Neptune
     #   The Amazon Resource Name (ARN) of the secondary Neptune DB cluster
     #   that you want to promote to primary for the global database.
     #
+    # @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:
     #
     #   * {Types::FailoverGlobalClusterResult#global_cluster #global_cluster} => Types::GlobalCluster
@@ -4964,6 +4992,8 @@ module Aws::Neptune
     #   resp = client.failover_global_cluster({
     #     global_cluster_identifier: "GlobalClusterIdentifier", # required
     #     target_db_cluster_identifier: "String", # required
+    #     allow_data_loss: false,
+    #     switchover: false,
     #   })
     #
     # @example Response structure
@@ -4981,6 +5011,10 @@ module Aws::Neptune
     #   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.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/neptune-2014-10-31/FailoverGlobalCluster AWS API Documentation
     #
@@ -5222,15 +5256,21 @@ module Aws::Neptune
     #
     #   Valid Values:
     #
-    #   * `standard | iopt1`
+    #   * <b> <code>standard</code> </b>   –   ( *the default* ) Configures
+    #     cost-effective database storage for applications with moderate to
+    #     small I/O usage.
     #
-    #   ^
+    #   * <b> <code>iopt1</code> </b>   –   Enables [I/O-Optimized storage][1]
+    #     that's designed to meet the needs of I/O-intensive graph workloads
+    #     that require predictable pricing with low I/O latency and consistent
+    #     I/O throughput.
     #
-    #   Default:
+    #     Neptune I/O-Optimized storage is only available starting with engine
+    #     release 1.3.0.0.
     #
-    #   * `standard`
     #
-    #   ^
+    #
+    #   [1]: https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage
     #
     # @return [Types::ModifyDBClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5761,7 +5801,8 @@ module Aws::Neptune
     #   Example: `mydbinstance`
     #
     # @option params [String] :storage_type
-    #   Not supported.
+    #   Not applicable. In Neptune the storage type is managed at the DB
+    #   Cluster level.
     #
     # @option params [String] :tde_credential_arn
     #   The ARN from the key store with which to associate the instance for
@@ -6306,6 +6347,10 @@ module Aws::Neptune
     #   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.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/neptune-2014-10-31/ModifyGlobalCluster AWS API Documentation
     #
@@ -6598,6 +6643,10 @@ module Aws::Neptune
     #   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.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/neptune-2014-10-31/RemoveFromGlobalCluster AWS API Documentation
     #
@@ -7613,6 +7662,76 @@ module Aws::Neptune
       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."
+    #
+    # 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 original replication topology.
+    # All secondary clusters are synchronized with the primary at the
+    # beginning of the process so the new primary continues operations for
+    # the 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.
+    #
+    # <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>
+    #
+    # @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.
+    #
+    # @option params [required, String] :target_db_cluster_identifier
+    #   The Amazon Resource Name (ARN) of the secondary Neptune DB cluster
+    #   that you want to promote to primary for the global database.
+    #
+    # @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: "String", # 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.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.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/neptune-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
+
     # @!endgroup
 
     # @param params ({})
@@ -7631,7 +7750,7 @@ module Aws::Neptune
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-neptune'
-      context[:gem_version] = '1.84.0'
+      context[:gem_version] = '1.85.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -189,6 +189,8 @@ module Aws::Neptune
     FailoverDBClusterResult = Shapes::StructureShape.new(name: 'FailoverDBClusterResult')
     FailoverGlobalClusterMessage = Shapes::StructureShape.new(name: 'FailoverGlobalClusterMessage')
     FailoverGlobalClusterResult = Shapes::StructureShape.new(name: 'FailoverGlobalClusterResult')
+    FailoverState = Shapes::StructureShape.new(name: 'FailoverState')
+    FailoverStatus = Shapes::StringShape.new(name: 'FailoverStatus')
     Filter = Shapes::StructureShape.new(name: 'Filter')
     FilterList = Shapes::ListShape.new(name: 'FilterList')
     FilterValueList = Shapes::ListShape.new(name: 'FilterValueList')
@@ -308,6 +310,8 @@ module Aws::Neptune
     SubscriptionNotFoundFault = Shapes::StructureShape.new(name: 'SubscriptionNotFoundFault', error: {"code" => "SubscriptionNotFound", "httpStatusCode" => 404, "senderFault" => true})
     SupportedCharacterSetsList = Shapes::ListShape.new(name: 'SupportedCharacterSetsList')
     SupportedTimezonesList = Shapes::ListShape.new(name: 'SupportedTimezonesList')
+    SwitchoverGlobalClusterMessage = Shapes::StructureShape.new(name: 'SwitchoverGlobalClusterMessage')
+    SwitchoverGlobalClusterResult = Shapes::StructureShape.new(name: 'SwitchoverGlobalClusterResult')
     TStamp = Shapes::TimestampShape.new(name: 'TStamp')
     Tag = Shapes::StructureShape.new(name: 'Tag')
     TagList = Shapes::ListShape.new(name: 'TagList')
@@ -1188,11 +1192,19 @@ module Aws::Neptune
 
     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: String, 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"))
     FailoverGlobalClusterResult.struct_class = Types::FailoverGlobalClusterResult
 
+    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
+
     Filter.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name"))
     Filter.add_member(:values, Shapes::ShapeRef.new(shape: FilterValueList, required: true, location_name: "Values"))
     Filter.struct_class = Types::Filter
@@ -1210,6 +1222,7 @@ module Aws::Neptune
     GlobalCluster.add_member(:storage_encrypted, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "StorageEncrypted"))
     GlobalCluster.add_member(:deletion_protection, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "DeletionProtection"))
     GlobalCluster.add_member(:global_cluster_members, Shapes::ShapeRef.new(shape: GlobalClusterMemberList, location_name: "GlobalClusterMembers"))
+    GlobalCluster.add_member(:failover_state, Shapes::ShapeRef.new(shape: FailoverState, location_name: "FailoverState"))
     GlobalCluster.struct_class = Types::GlobalCluster
 
     GlobalClusterAlreadyExistsFault.struct_class = Types::GlobalClusterAlreadyExistsFault
@@ -1670,6 +1683,13 @@ module Aws::Neptune
 
     SupportedTimezonesList.member = Shapes::ShapeRef.new(shape: Timezone, location_name: "Timezone")
 
+    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: String, 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
+
     Tag.add_member(:key, Shapes::ShapeRef.new(shape: String, location_name: "Key"))
     Tag.add_member(:value, Shapes::ShapeRef.new(shape: String, location_name: "Value"))
     Tag.struct_class = Types::Tag
@@ -2631,6 +2651,18 @@ module Aws::Neptune
         o.errors << Shapes::ShapeRef.new(shape: InvalidDBClusterStateFault)
         o.errors << Shapes::ShapeRef.new(shape: InvalidDBInstanceStateFault)
       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)
     end
 
   end

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

@@ -266,7 +266,24 @@ module Aws::Neptune
     #   @return [Integer]
     #
     # @!attribute [rw] storage_type
-    #   The storage type for the DB cluster.
+    #   The pending change in storage type for the DB cluster.   Valid
+    #   Values:
+    #
+    #   * <b> <code>standard</code> </b>   –   ( *the default* ) Configures
+    #     cost-effective database storage for applications with moderate to
+    #     small I/O usage.
+    #
+    #   * <b> <code>iopt1</code> </b>   –   Enables [I/O-Optimized
+    #     storage][1] that's designed to meet the needs of I/O-intensive
+    #     graph workloads that require predictable pricing with low I/O
+    #     latency and consistent I/O throughput.
+    #
+    #     Neptune I/O-Optimized storage is only available starting with
+    #     engine release 1.3.0.0.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage
     #   @return [String]
     #
     # @!attribute [rw] allocated_storage
@@ -278,7 +295,7 @@ module Aws::Neptune
     #
     # @!attribute [rw] iops
     #   The Provisioned IOPS (I/O operations per second) value. This setting
-    #   is only for non-Aurora Multi-AZ DB clusters.
+    #   is only for Multi-AZ DB clusters.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/neptune-2014-10-31/ClusterPendingModifiedValues AWS API Documentation
@@ -747,7 +764,7 @@ module Aws::Neptune
     #   The version number of the database engine to use for the new DB
     #   cluster.
     #
-    #   Example: `1.0.2.1`
+    #   Example: `1.2.1.0`
     #   @return [String]
     #
     # @!attribute [rw] port
@@ -904,25 +921,26 @@ module Aws::Neptune
     #   @return [String]
     #
     # @!attribute [rw] storage_type
-    #   The storage type to associate with the DB cluster.
+    #   The storage type for the new DB cluster.
     #
     #   Valid Values:
     #
-    #   * `standard | iopt1`
-    #
-    #   ^
+    #   * <b> <code>standard</code> </b>   –   ( *the default* ) Configures
+    #     cost-effective database storage for applications with moderate to
+    #     small I/O usage. When set to `standard`, the storage type is not
+    #     returned in the response.
     #
-    #   Default:
+    #   * <b> <code>iopt1</code> </b>   –   Enables [I/O-Optimized
+    #     storage][1] that's designed to meet the needs of I/O-intensive
+    #     graph workloads that require predictable pricing with low I/O
+    #     latency and consistent I/O throughput.
     #
-    #   * `standard`
+    #     Neptune I/O-Optimized storage is only available starting with
+    #     engine release 1.3.0.0.
     #
-    #   ^
     #
-    #   <note markdown="1"> When you create a Neptune cluster with the storage type set to
-    #   `iopt1`, the storage type is returned in the response. The storage
-    #   type isn't returned when you set it to `standard`.
     #
-    #    </note>
+    #   [1]: https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage
     #   @return [String]
     #
     # @!attribute [rw] source_region
@@ -1294,9 +1312,8 @@ module Aws::Neptune
     #   @return [String]
     #
     # @!attribute [rw] storage_type
-    #   Specifies the storage type to be associated with the DB instance.
-    #
-    #   Not applicable. Storage is managed by the DB Cluster.
+    #   Not applicable. In Neptune the storage type is managed at the DB
+    #   Cluster level.
     #   @return [String]
     #
     # @!attribute [rw] tde_credential_arn
@@ -1980,7 +1997,25 @@ module Aws::Neptune
     #   @return [Time]
     #
     # @!attribute [rw] storage_type
-    #   The storage type associated with the DB cluster.
+    #   The storage type used by the DB cluster.
+    #
+    #   Valid Values:
+    #
+    #   * <b> <code>standard</code> </b>   –   ( *the default* ) Provides
+    #     cost-effective database storage for applications with moderate to
+    #     small I/O usage.
+    #
+    #   * <b> <code>iopt1</code> </b>   –   Enables [I/O-Optimized
+    #     storage][1] that's designed to meet the needs of I/O-intensive
+    #     graph workloads that require predictable pricing with low I/O
+    #     latency and consistent I/O throughput.
+    #
+    #     Neptune I/O-Optimized storage is only available starting with
+    #     engine release 1.3.0.0.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/neptune-2014-10-31/DBCluster AWS API Documentation
@@ -2133,7 +2168,7 @@ module Aws::Neptune
     class DBClusterEndpointAlreadyExistsFault < Aws::EmptyStructure; end
 
     # @!attribute [rw] marker
-    #   An optional pagination token provided by a previous
+    #   n optional pagination token provided by a previous
     #   `DescribeDBClusterEndpoints` request. If this parameter is
     #   specified, the response includes only records beyond the marker, up
     #   to the value specified by `MaxRecords`.
@@ -2905,7 +2940,7 @@ module Aws::Neptune
     #   @return [Array<Types::DBInstanceStatusInfo>]
     #
     # @!attribute [rw] storage_type
-    #   Specifies the storage type associated with DB instance.
+    #   Specifies the storage type associated with the DB instance.
     #   @return [String]
     #
     # @!attribute [rw] tde_credential_arn
@@ -5211,11 +5246,32 @@ module Aws::Neptune
     #   that you want to promote to primary for the global database.
     #   @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/neptune-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
@@ -5237,6 +5293,62 @@ module Aws::Neptune
       include Aws::Structure
     end
 
+    # Contains the state of scheduled or in-process operations on a global
+    # cluster (Neptune global database). This data type is empty unless a
+    # switchover or failover operation is scheduled or is in progress on the
+    # Neptune global database.
+    #
+    # @!attribute [rw] status
+    #   The current status of the global cluster. Possible values are as
+    #   follows:
+    #
+    #   * 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 – Neptune is promoting the chosen secondary Neptune
+    #     DB cluster to become the new primary DB cluster to fail over the
+    #     global cluster.
+    #
+    #   * cancelling – The request to switch over or fail over the global
+    #     cluster was cancelled and the primary Neptune DB cluster and the
+    #     selected secondary Neptune DB cluster are returning to their
+    #     previous states.
+    #
+    #   * switching-over – This status covers the range of Neptune internal
+    #     operations that take place during the switchover process, such as
+    #     demoting the primary Neptune DB cluster, promoting the secondary
+    #     Neptune DB cluster, and synchronizing replicas.
+    #   @return [String]
+    #
+    # @!attribute [rw] from_db_cluster_arn
+    #   The Amazon Resource Name (ARN) of the Neptune DB cluster that is
+    #   currently being demoted, and which is associated with this state.
+    #   @return [String]
+    #
+    # @!attribute [rw] to_db_cluster_arn
+    #   The Amazon Resource Name (ARN) of the Neptune DB cluster that is
+    #   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/neptune-2014-10-31/FailoverState AWS API Documentation
+    #
+    class FailoverState < Struct.new(
+      :status,
+      :from_db_cluster_arn,
+      :to_db_cluster_arn,
+      :is_data_loss_allowed)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # This type is not currently supported.
     #
     # @!attribute [rw] name
@@ -5304,6 +5416,14 @@ module Aws::Neptune
     #   that are part of the global database.
     #   @return [Array<Types::GlobalClusterMember>]
     #
+    # @!attribute [rw] failover_state
+    #   A data object containing all properties for the current state of an
+    #   in-process or pending switchover or failover process for this global
+    #   cluster (Neptune 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/neptune-2014-10-31/GlobalCluster AWS API Documentation
     #
     class GlobalCluster < Struct.new(
@@ -5315,7 +5435,8 @@ module Aws::Neptune
       :engine_version,
       :storage_encrypted,
       :deletion_protection,
-      :global_cluster_members)
+      :global_cluster_members,
+      :failover_state)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5858,15 +5979,21 @@ module Aws::Neptune
     #
     #   Valid Values:
     #
-    #   * `standard | iopt1`
+    #   * <b> <code>standard</code> </b>   –   ( *the default* ) Configures
+    #     cost-effective database storage for applications with moderate to
+    #     small I/O usage.
     #
-    #   ^
+    #   * <b> <code>iopt1</code> </b>   –   Enables [I/O-Optimized
+    #     storage][1] that's designed to meet the needs of I/O-intensive
+    #     graph workloads that require predictable pricing with low I/O
+    #     latency and consistent I/O throughput.
     #
-    #   Default:
+    #     Neptune I/O-Optimized storage is only available starting with
+    #     engine release 1.3.0.0.
     #
-    #   * `standard`
     #
-    #   ^
+    #
+    #   [1]: https://docs.aws.amazon.com/neptune/latest/userguide/storage-types.html#provisioned-iops-storage
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/neptune-2014-10-31/ModifyDBClusterMessage AWS API Documentation
@@ -6210,7 +6337,8 @@ module Aws::Neptune
     #   @return [String]
     #
     # @!attribute [rw] storage_type
-    #   Not supported.
+    #   Not applicable. In Neptune the storage type is managed at the DB
+    #   Cluster level.
     #   @return [String]
     #
     # @!attribute [rw] tde_credential_arn
@@ -6667,7 +6795,8 @@ module Aws::Neptune
     #   @return [Boolean]
     #
     # @!attribute [rw] storage_type
-    #   Indicates the storage type for a DB instance.
+    #   Not applicable. In Neptune the storage type is managed at the DB
+    #   Cluster level.
     #   @return [String]
     #
     # @!attribute [rw] supports_iops
@@ -6982,7 +7111,8 @@ module Aws::Neptune
     #   @return [String]
     #
     # @!attribute [rw] storage_type
-    #   Specifies the storage type to be associated with the DB instance.
+    #   Not applicable. In Neptune the storage type is managed at the DB
+    #   Cluster level.
     #   @return [String]
     #
     # @!attribute [rw] ca_certificate_identifier
@@ -7961,6 +8091,45 @@ module Aws::Neptune
     #
     class SubscriptionNotFoundFault < Aws::EmptyStructure; 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.
+    #   @return [String]
+    #
+    # @!attribute [rw] target_db_cluster_identifier
+    #   The Amazon Resource Name (ARN) of the secondary Neptune DB cluster
+    #   that you want to promote to primary for the global database.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/neptune-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
+    #   Contains the details of an Amazon Neptune global database.
+    #
+    #   This data type is used as a response element for the
+    #   CreateGlobalCluster, DescribeGlobalClusters, ModifyGlobalCluster,
+    #   DeleteGlobalCluster, FailoverGlobalCluster, and
+    #   RemoveFromGlobalCluster actions.
+    #   @return [Types::GlobalCluster]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/neptune-2014-10-31/SwitchoverGlobalClusterResult AWS API Documentation
+    #
+    class SwitchoverGlobalClusterResult < Struct.new(
+      :global_cluster)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Metadata assigned to an Amazon Neptune resource consisting of a
     # key-value pair.
     #
@@ -8078,28 +8247,27 @@ module Aws::Neptune
       include Aws::Structure
     end
 
-    # Information about valid modifications that you can make to your DB
-    # instance.
-    #
-    # Contains the result of a successful call to the
-    # DescribeValidDBInstanceModifications action.
+    # Not applicable. In Neptune the storage type is managed at the DB
+    # Cluster level.
     #
     # @!attribute [rw] storage_type
-    #   The valid storage types for your DB instance. For example, gp2, io1.
+    #   Not applicable. In Neptune the storage type is managed at the DB
+    #   Cluster level.
     #   @return [String]
     #
     # @!attribute [rw] storage_size
-    #   The valid range of storage in gibibytes. For example, 100 to 16384.
+    #   Not applicable. In Neptune the storage type is managed at the DB
+    #   Cluster level.
     #   @return [Array<Types::Range>]
     #
     # @!attribute [rw] provisioned_iops
-    #   The valid range of provisioned IOPS. For example, 1000-20000.
+    #   Not applicable. In Neptune the storage type is managed at the DB
+    #   Cluster level.
     #   @return [Array<Types::Range>]
     #
     # @!attribute [rw] iops_to_storage_ratio
-    #   The valid range of Provisioned IOPS to gibibytes of storage
-    #   multiplier. For example, 3-10, which means that provisioned IOPS can
-    #   be between 3 and 10 times storage.
+    #   Not applicable. In Neptune the storage type is managed at the DB
+    #   Cluster level.
     #   @return [Array<Types::DoubleRange>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/neptune-2014-10-31/ValidStorageOptions AWS API Documentation

data/lib/aws-sdk-neptune.rb

@@ -55,7 +55,7 @@ module Aws::Neptune
   autoload :EndpointProvider, 'aws-sdk-neptune/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-neptune/endpoints'
 
-  GEM_VERSION = '1.84.0'
+  GEM_VERSION = '1.85.0'
 
 end
 

data/sig/client.rbs

@@ -897,7 +897,9 @@ module Aws
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Neptune/Client.html#failover_global_cluster-instance_method
       def failover_global_cluster: (
                                      global_cluster_identifier: ::String,
-                                     target_db_cluster_identifier: ::String
+                                     target_db_cluster_identifier: ::String,
+                                     ?allow_data_loss: bool,
+                                     ?switchover: bool
                                    ) -> _FailoverGlobalClusterResponseSuccess
                                  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _FailoverGlobalClusterResponseSuccess
 
@@ -1322,6 +1324,17 @@ module Aws
                            ) -> _StopDBClusterResponseSuccess
                          | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _StopDBClusterResponseSuccess
 
+      interface _SwitchoverGlobalClusterResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::SwitchoverGlobalClusterResult]
+        def global_cluster: () -> Types::GlobalCluster
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Neptune/Client.html#switchover_global_cluster-instance_method
+      def switchover_global_cluster: (
+                                       global_cluster_identifier: ::String,
+                                       target_db_cluster_identifier: ::String
+                                     ) -> _SwitchoverGlobalClusterResponseSuccess
+                                   | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _SwitchoverGlobalClusterResponseSuccess
+
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Neptune/Client.html#wait_until-instance_method
       def wait_until: (:db_instance_available waiter_name, 
                     ?db_instance_identifier: ::String,

data/sig/types.rbs

@@ -1081,6 +1081,8 @@ module Aws::Neptune
     class FailoverGlobalClusterMessage
       attr_accessor global_cluster_identifier: ::String
       attr_accessor target_db_cluster_identifier: ::String
+      attr_accessor allow_data_loss: bool
+      attr_accessor switchover: bool
       SENSITIVE: []
     end
 
@@ -1089,6 +1091,14 @@ module Aws::Neptune
       SENSITIVE: []
     end
 
+    class FailoverState
+      attr_accessor status: ("pending" | "failing-over" | "cancelling")
+      attr_accessor from_db_cluster_arn: ::String
+      attr_accessor to_db_cluster_arn: ::String
+      attr_accessor is_data_loss_allowed: bool
+      SENSITIVE: []
+    end
+
     class Filter
       attr_accessor name: ::String
       attr_accessor values: ::Array[::String]
@@ -1105,6 +1115,7 @@ module Aws::Neptune
       attr_accessor storage_encrypted: bool
       attr_accessor deletion_protection: bool
       attr_accessor global_cluster_members: ::Array[Types::GlobalClusterMember]
+      attr_accessor failover_state: Types::FailoverState
       SENSITIVE: []
     end
 
@@ -1667,6 +1678,17 @@ module Aws::Neptune
     class SubscriptionNotFoundFault < Aws::EmptyStructure
     end
 
+    class SwitchoverGlobalClusterMessage
+      attr_accessor global_cluster_identifier: ::String
+      attr_accessor target_db_cluster_identifier: ::String
+      SENSITIVE: []
+    end
+
+    class SwitchoverGlobalClusterResult
+      attr_accessor global_cluster: Types::GlobalCluster
+      SENSITIVE: []
+    end
+
     class Tag
       attr_accessor key: ::String
       attr_accessor value: ::String

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-neptune
 version: !ruby/object:Gem::Version
-  version: 1.84.0
+  version: 1.85.0
 platform: ruby
 authors:
 - Amazon Web Services