aws-sdk-rds 1.111.0 → 1.116.0

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

@@ -570,6 +570,12 @@ module Aws::RDS
       data[:customer_owned_ip_enabled]
     end
 
+    # The Amazon Resource Name (ARN) of the recovery point in AWS Backup.
+    # @return [String]
+    def aws_backup_recovery_point_arn
+      data[:aws_backup_recovery_point_arn]
+    end
+
     # @!endgroup
 
     # @return [Client]
@@ -2186,6 +2192,7 @@ module Aws::RDS
     #     certificate_rotation_restart: false,
     #     replica_mode: "open-read-only", # accepts open-read-only, mounted
     #     enable_customer_owned_ip: false,
+    #     aws_backup_recovery_point_arn: "AwsBackupRecoveryPointArn",
     #   })
     # @param [Hash] options ({})
     # @option options [Integer] :allocated_storage
@@ -2802,6 +2809,8 @@ module Aws::RDS
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
     #   [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
+    # @option options [String] :aws_backup_recovery_point_arn
+    #   The Amazon Resource Name (ARN) of the recovery point in AWS Backup.
     # @return [DBInstance]
     def modify(options = {})
       options = options.merge(db_instance_identifier: @id)

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

@@ -60,6 +60,9 @@ module Aws::RDS
   # * {DBParameterGroupNotFoundFault}
   # * {DBParameterGroupQuotaExceededFault}
   # * {DBProxyAlreadyExistsFault}
+  # * {DBProxyEndpointAlreadyExistsFault}
+  # * {DBProxyEndpointNotFoundFault}
+  # * {DBProxyEndpointQuotaExceededFault}
   # * {DBProxyNotFoundFault}
   # * {DBProxyQuotaExceededFault}
   # * {DBProxyTargetAlreadyRegisteredFault}
@@ -101,6 +104,7 @@ module Aws::RDS
   # * {InvalidDBInstanceAutomatedBackupStateFault}
   # * {InvalidDBInstanceStateFault}
   # * {InvalidDBParameterGroupStateFault}
+  # * {InvalidDBProxyEndpointStateFault}
   # * {InvalidDBProxyStateFault}
   # * {InvalidDBSecurityGroupStateFault}
   # * {InvalidDBSnapshotStateFault}
@@ -477,6 +481,36 @@ module Aws::RDS
       end
     end
 
+    class DBProxyEndpointAlreadyExistsFault < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::RDS::Types::DBProxyEndpointAlreadyExistsFault] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    class DBProxyEndpointNotFoundFault < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::RDS::Types::DBProxyEndpointNotFoundFault] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
+    class DBProxyEndpointQuotaExceededFault < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::RDS::Types::DBProxyEndpointQuotaExceededFault] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
     class DBProxyNotFoundFault < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context
@@ -887,6 +921,16 @@ module Aws::RDS
       end
     end
 
+    class InvalidDBProxyEndpointStateFault < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::RDS::Types::InvalidDBProxyEndpointStateFault] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+    end
+
     class InvalidDBProxyStateFault < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -365,7 +365,7 @@ module Aws::RDS
     #
     #   **Aurora PostgreSQL**
     #
-    #   Possible values are `postgresql` and `upgrade`.
+    #   Possible value is `postgresql`.
     #
     #
     #
@@ -451,12 +451,19 @@ module Aws::RDS
     #   Specify the name of the IAM role to be used when making API calls to
     #   the Directory Service.
     # @option options [Boolean] :enable_global_write_forwarding
-    #   A value that indicates whether to enable write operations to be
-    #   forwarded from this cluster to the primary cluster in an Aurora global
-    #   database. The resulting changes are replicated back to this cluster.
-    #   This parameter only applies to DB clusters that are secondary clusters
-    #   in an Aurora global database. By default, Aurora disallows write
-    #   operations for secondary clusters.
+    #   A value that indicates whether to enable this DB cluster to forward
+    #   write operations to the primary cluster of an Aurora global database
+    #   (GlobalCluster). By default, write operations are not allowed on
+    #   Aurora DB clusters that are secondary clusters in an Aurora global
+    #   database.
+    #
+    #   You can set this value only on Aurora DB clusters that are members of
+    #   an Aurora global database. With this parameter enabled, a secondary
+    #   cluster can forward writes to the current primary cluster and the
+    #   resulting changes are replicated back to this cluster. For the primary
+    #   DB cluster of an Aurora global database, this value is used
+    #   immediately if the primary is demoted by the FailoverGlobalCluster API
+    #   operation, but it does nothing until then.
     # @option options [String] :source_region
     #   The source region of the snapshot. This is only needed when the
     #   shapshot is encrypted and in a different region.

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

@@ -2093,7 +2093,7 @@ module Aws::RDS
     #
     #   **Aurora PostgreSQL**
     #
-    #   Possible values are `postgresql` and `upgrade`.
+    #   Possible value is `postgresql`.
     #
     #
     #
@@ -2197,12 +2197,19 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] enable_global_write_forwarding
-    #   A value that indicates whether to enable write operations to be
-    #   forwarded from this cluster to the primary cluster in an Aurora
-    #   global database. The resulting changes are replicated back to this
-    #   cluster. This parameter only applies to DB clusters that are
-    #   secondary clusters in an Aurora global database. By default, Aurora
-    #   disallows write operations for secondary clusters.
+    #   A value that indicates whether to enable this DB cluster to forward
+    #   write operations to the primary cluster of an Aurora global database
+    #   (GlobalCluster). By default, write operations are not allowed on
+    #   Aurora DB clusters that are secondary clusters in an Aurora global
+    #   database.
+    #
+    #   You can set this value only on Aurora DB clusters that are members
+    #   of an Aurora global database. With this parameter enabled, a
+    #   secondary cluster can forward writes to the current primary cluster
+    #   and the resulting changes are replicated back to this cluster. For
+    #   the primary DB cluster of an Aurora global database, this value is
+    #   used immediately if the primary is demoted by the
+    #   FailoverGlobalCluster API operation, but it does nothing until then.
     #   @return [Boolean]
     #
     # @!attribute [rw] source_region
@@ -4156,6 +4163,87 @@ module Aws::RDS
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass CreateDBProxyEndpointRequest
+    #   data as a hash:
+    #
+    #       {
+    #         db_proxy_name: "DBProxyName", # required
+    #         db_proxy_endpoint_name: "DBProxyEndpointName", # required
+    #         vpc_subnet_ids: ["String"], # required
+    #         vpc_security_group_ids: ["String"],
+    #         target_role: "READ_WRITE", # accepts READ_WRITE, READ_ONLY
+    #         tags: [
+    #           {
+    #             key: "String",
+    #             value: "String",
+    #           },
+    #         ],
+    #       }
+    #
+    # @!attribute [rw] db_proxy_name
+    #   The name of the DB proxy associated with the DB proxy endpoint that
+    #   you create.
+    #   @return [String]
+    #
+    # @!attribute [rw] db_proxy_endpoint_name
+    #   The name of the DB proxy endpoint to create.
+    #   @return [String]
+    #
+    # @!attribute [rw] vpc_subnet_ids
+    #   The VPC subnet IDs for the DB proxy endpoint that you create. You
+    #   can specify a different set of subnet IDs than for the original DB
+    #   proxy.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] vpc_security_group_ids
+    #   The VPC security group IDs for the DB proxy endpoint that you
+    #   create. You can specify a different set of security group IDs than
+    #   for the original DB proxy. The default is the default security group
+    #   for the VPC.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] target_role
+    #   A value that indicates whether the DB proxy endpoint can be used for
+    #   read/write or read-only operations. The default is `READ_WRITE`.
+    #   @return [String]
+    #
+    # @!attribute [rw] tags
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1] in the *Amazon RDS User Guide.*
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
+    #   @return [Array<Types::Tag>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBProxyEndpointRequest AWS API Documentation
+    #
+    class CreateDBProxyEndpointRequest < Struct.new(
+      :db_proxy_name,
+      :db_proxy_endpoint_name,
+      :vpc_subnet_ids,
+      :vpc_security_group_ids,
+      :target_role,
+      :tags)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] db_proxy_endpoint
+    #   The `DBProxyEndpoint` object that is created by the API operation.
+    #   The DB proxy endpoint that you create might provide capabilities
+    #   such as read/write or read-only operations, or using a different VPC
+    #   than the proxy's default VPC.
+    #   @return [Types::DBProxyEndpoint]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBProxyEndpointResponse AWS API Documentation
+    #
+    class CreateDBProxyEndpointResponse < Struct.new(
+      :db_proxy_endpoint)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass CreateDBProxyRequest
     #   data as a hash:
     #
@@ -5793,7 +5881,13 @@ module Aws::RDS
     #   @return [Time]
     #
     # @!attribute [rw] engine
-    #   Specifies the name of the database engine.
+    #   Specifies the name of the database engine for this DB cluster
+    #   snapshot.
+    #   @return [String]
+    #
+    # @!attribute [rw] engine_mode
+    #   Provides the engine mode of the database engine for this DB cluster
+    #   snapshot.
     #   @return [String]
     #
     # @!attribute [rw] allocated_storage
@@ -5819,7 +5913,7 @@ module Aws::RDS
     #   @return [Time]
     #
     # @!attribute [rw] master_username
-    #   Provides the master username for the DB cluster snapshot.
+    #   Provides the master username for this DB cluster snapshot.
     #   @return [String]
     #
     # @!attribute [rw] engine_version
@@ -5884,6 +5978,7 @@ module Aws::RDS
       :db_cluster_identifier,
       :snapshot_create_time,
       :engine,
+      :engine_mode,
       :allocated_storage,
       :status,
       :port,
@@ -6566,6 +6661,10 @@ module Aws::RDS
     #   [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
     #   @return [Boolean]
     #
+    # @!attribute [rw] aws_backup_recovery_point_arn
+    #   The Amazon Resource Name (ARN) of the recovery point in AWS Backup.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBInstance AWS API Documentation
     #
     class DBInstance < Struct.new(
@@ -6631,7 +6730,8 @@ module Aws::RDS
       :max_allocated_storage,
       :tag_list,
       :db_instance_automated_backups_replications,
-      :customer_owned_ip_enabled)
+      :customer_owned_ip_enabled,
+      :aws_backup_recovery_point_arn)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -7162,6 +7262,10 @@ module Aws::RDS
     #   Aurora.
     #   @return [String]
     #
+    # @!attribute [rw] vpc_id
+    #   Provides the VPC ID of the DB proxy.
+    #   @return [String]
+    #
     # @!attribute [rw] vpc_security_group_ids
     #   Provides a list of VPC security groups that the proxy belongs to.
     #   @return [Array<String>]
@@ -7181,9 +7285,9 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] endpoint
-    #   The endpoint that you can use to connect to the proxy. You include
-    #   the endpoint value in the connection string for a database client
-    #   application.
+    #   The endpoint that you can use to connect to the DB proxy. You
+    #   include the endpoint value in the connection string for a database
+    #   client application.
     #   @return [String]
     #
     # @!attribute [rw] require_tls
@@ -7228,6 +7332,7 @@ module Aws::RDS
       :db_proxy_arn,
       :status,
       :engine_family,
+      :vpc_id,
       :vpc_security_group_ids,
       :vpc_subnet_ids,
       :auth,
@@ -7249,6 +7354,109 @@ module Aws::RDS
     #
     class DBProxyAlreadyExistsFault < Aws::EmptyStructure; end
 
+    # The data structure representing an endpoint associated with a DB
+    # proxy. RDS automatically creates one endpoint for each DB proxy. For
+    # Aurora DB clusters, you can associate additional endpoints with the
+    # same DB proxy. These endpoints can be read/write or read-only. They
+    # can also reside in different VPCs than the associated DB proxy.
+    #
+    # This data type is used as a response element in the
+    # `DescribeDBProxyEndpoints` operation.
+    #
+    # @!attribute [rw] db_proxy_endpoint_name
+    #   The name for the DB proxy endpoint. An identifier must begin with a
+    #   letter and must contain only ASCII letters, digits, and hyphens; it
+    #   can't end with a hyphen or contain two consecutive hyphens.
+    #   @return [String]
+    #
+    # @!attribute [rw] db_proxy_endpoint_arn
+    #   The Amazon Resource Name (ARN) for the DB proxy endpoint.
+    #   @return [String]
+    #
+    # @!attribute [rw] db_proxy_name
+    #   The identifier for the DB proxy that is associated with this DB
+    #   proxy endpoint.
+    #   @return [String]
+    #
+    # @!attribute [rw] status
+    #   The current status of this DB proxy endpoint. A status of
+    #   `available` means the endpoint is ready to handle requests. Other
+    #   values indicate that you must wait for the endpoint to be ready, or
+    #   take some action to resolve an issue.
+    #   @return [String]
+    #
+    # @!attribute [rw] vpc_id
+    #   Provides the VPC ID of the DB proxy endpoint.
+    #   @return [String]
+    #
+    # @!attribute [rw] vpc_security_group_ids
+    #   Provides a list of VPC security groups that the DB proxy endpoint
+    #   belongs to.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] vpc_subnet_ids
+    #   The EC2 subnet IDs for the DB proxy endpoint.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] endpoint
+    #   The endpoint that you can use to connect to the DB proxy. You
+    #   include the endpoint value in the connection string for a database
+    #   client application.
+    #   @return [String]
+    #
+    # @!attribute [rw] created_date
+    #   The date and time when the DB proxy endpoint was first created.
+    #   @return [Time]
+    #
+    # @!attribute [rw] target_role
+    #   A value that indicates whether the DB proxy endpoint can be used for
+    #   read/write or read-only operations.
+    #   @return [String]
+    #
+    # @!attribute [rw] is_default
+    #   A value that indicates whether this endpoint is the default endpoint
+    #   for the associated DB proxy. Default DB proxy endpoints always have
+    #   read/write capability. Other endpoints that you associate with the
+    #   DB proxy can be either read/write or read-only.
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBProxyEndpoint AWS API Documentation
+    #
+    class DBProxyEndpoint < Struct.new(
+      :db_proxy_endpoint_name,
+      :db_proxy_endpoint_arn,
+      :db_proxy_name,
+      :status,
+      :vpc_id,
+      :vpc_security_group_ids,
+      :vpc_subnet_ids,
+      :endpoint,
+      :created_date,
+      :target_role,
+      :is_default)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The specified DB proxy endpoint name must be unique for all DB proxy
+    # endpoints owned by your AWS account in the specified AWS Region.
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBProxyEndpointAlreadyExistsFault AWS API Documentation
+    #
+    class DBProxyEndpointAlreadyExistsFault < Aws::EmptyStructure; end
+
+    # The DB proxy endpoint doesn't exist.
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBProxyEndpointNotFoundFault AWS API Documentation
+    #
+    class DBProxyEndpointNotFoundFault < Aws::EmptyStructure; end
+
+    # The DB proxy already has the maximum number of endpoints.
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBProxyEndpointQuotaExceededFault AWS API Documentation
+    #
+    class DBProxyEndpointQuotaExceededFault < Aws::EmptyStructure; end
+
     # The specified proxy name doesn't correspond to a proxy owned by your
     # AWS account in the specified AWS Region.
     #
@@ -7301,6 +7509,11 @@ module Aws::RDS
     #   Aurora DB cluster, that the target represents.
     #   @return [String]
     #
+    # @!attribute [rw] role
+    #   A value that indicates whether the target of the proxy can be used
+    #   for read/write or read-only operations.
+    #   @return [String]
+    #
     # @!attribute [rw] target_health
     #   Information about the connection health of the RDS Proxy target.
     #   @return [Types::TargetHealth]
@@ -7314,6 +7527,7 @@ module Aws::RDS
       :rds_resource_id,
       :port,
       :type,
+      :role,
       :target_health)
       SENSITIVE = []
       include Aws::Structure
@@ -8276,6 +8490,38 @@ module Aws::RDS
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DeleteDBProxyEndpointRequest
+    #   data as a hash:
+    #
+    #       {
+    #         db_proxy_endpoint_name: "DBProxyEndpointName", # required
+    #       }
+    #
+    # @!attribute [rw] db_proxy_endpoint_name
+    #   The name of the DB proxy endpoint to delete.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBProxyEndpointRequest AWS API Documentation
+    #
+    class DeleteDBProxyEndpointRequest < Struct.new(
+      :db_proxy_endpoint_name)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] db_proxy_endpoint
+    #   The data structure representing the details of the DB proxy endpoint
+    #   that you delete.
+    #   @return [Types::DBProxyEndpoint]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBProxyEndpointResponse AWS API Documentation
+    #
+    class DeleteDBProxyEndpointResponse < Struct.new(
+      :db_proxy_endpoint)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DeleteDBProxyRequest
     #   data as a hash:
     #
@@ -9811,7 +10057,9 @@ module Aws::RDS
     #       }
     #
     # @!attribute [rw] db_proxy_name
-    #   The name of the DB proxy.
+    #   The name of the DB proxy. If you omit this parameter, the output
+    #   includes information about all DB proxies owned by your AWS account
+    #   ID.
     #   @return [String]
     #
     # @!attribute [rw] filters
@@ -9866,6 +10114,86 @@ module Aws::RDS
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass DescribeDBProxyEndpointsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         db_proxy_name: "DBProxyName",
+    #         db_proxy_endpoint_name: "DBProxyEndpointName",
+    #         filters: [
+    #           {
+    #             name: "String", # required
+    #             values: ["String"], # required
+    #           },
+    #         ],
+    #         marker: "String",
+    #         max_records: 1,
+    #       }
+    #
+    # @!attribute [rw] db_proxy_name
+    #   The name of the DB proxy whose endpoints you want to describe. If
+    #   you omit this parameter, the output includes information about all
+    #   DB proxy endpoints associated with all your DB proxies.
+    #   @return [String]
+    #
+    # @!attribute [rw] db_proxy_endpoint_name
+    #   The name of a DB proxy endpoint to describe. If you omit this
+    #   parameter, the output includes information about all DB proxy
+    #   endpoints associated with the specified proxy.
+    #   @return [String]
+    #
+    # @!attribute [rw] filters
+    #   This parameter is not currently supported.
+    #   @return [Array<Types::Filter>]
+    #
+    # @!attribute [rw] marker
+    #   An optional pagination token provided by a previous request. If this
+    #   parameter is specified, the response includes only records beyond
+    #   the marker, up to the value specified by `MaxRecords`.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_records
+    #   The maximum number of records to include in the response. If more
+    #   records exist than the specified `MaxRecords` value, a pagination
+    #   token called a marker is included in the response so that the
+    #   remaining results can be retrieved.
+    #
+    #   Default: 100
+    #
+    #   Constraints: Minimum 20, maximum 100.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBProxyEndpointsRequest AWS API Documentation
+    #
+    class DescribeDBProxyEndpointsRequest < Struct.new(
+      :db_proxy_name,
+      :db_proxy_endpoint_name,
+      :filters,
+      :marker,
+      :max_records)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] db_proxy_endpoints
+    #   The list of `ProxyEndpoint` objects returned by the API operation.
+    #   @return [Array<Types::DBProxyEndpoint>]
+    #
+    # @!attribute [rw] marker
+    #   An optional pagination token provided by a previous request. If this
+    #   parameter is specified, the response includes only records beyond
+    #   the marker, up to the value specified by `MaxRecords`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBProxyEndpointsResponse AWS API Documentation
+    #
+    class DescribeDBProxyEndpointsResponse < Struct.new(
+      :db_proxy_endpoints,
+      :marker)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass DescribeDBProxyTargetGroupsRequest
     #   data as a hash:
     #
@@ -12178,6 +12506,103 @@ module Aws::RDS
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass FailoverGlobalClusterMessage
+    #   data as a hash:
+    #
+    #       {
+    #         global_cluster_identifier: "GlobalClusterIdentifier", # required
+    #         target_db_cluster_identifier: "DBClusterIdentifier", # required
+    #       }
+    #
+    # @!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.
+    #
+    #   Constraints:
+    #
+    #   * Must match the identifier of an existing GlobalCluster (Aurora
+    #     global database).
+    #
+    #   ^
+    #   @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 AWS Region.
+    #   @return [String]
+    #
+    # @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)
+      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/FailoverGlobalClusterResult AWS API Documentation
+    #
+    class FailoverGlobalClusterResult < Struct.new(
+      :global_cluster)
+      SENSITIVE = []
+      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.
+    #
+    # @!attribute [rw] status
+    #   The current status of the Aurora global database (GlobalCluster).
+    #   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.
+    #
+    #   * 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.
+    #
+    #   * 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.
+    #   @return [String]
+    #
+    # @!attribute [rw] from_db_cluster_arn
+    #   The Amazon Resource Name (ARN) of the Aurora 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 Aurora DB cluster that is
+    #   currently being promoted, and which is associated with this state.
+    #   @return [String]
+    #
+    # @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)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A filter name and value pair that is used to return a more specific
     # list of results from a describe operation. Filters can be used to
     # match a set of resources by specific criteria, such as IDs. The
@@ -12273,6 +12698,14 @@ module Aws::RDS
     #   database cluster. Currently limited to 1 item.
     #   @return [Array<Types::GlobalClusterMember>]
     #
+    # @!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).
+    #   @return [Types::FailoverState]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/GlobalCluster AWS API Documentation
     #
     class GlobalCluster < Struct.new(
@@ -12285,7 +12718,8 @@ module Aws::RDS
       :database_name,
       :storage_encrypted,
       :deletion_protection,
-      :global_cluster_members)
+      :global_cluster_members,
+      :failover_state)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -12666,6 +13100,13 @@ module Aws::RDS
     #
     class InvalidDBParameterGroupStateFault < Aws::EmptyStructure; end
 
+    # You can't perform this operation while the DB proxy endpoint is in a
+    # particular state.
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/InvalidDBProxyEndpointStateFault AWS API Documentation
+    #
+    class InvalidDBProxyEndpointStateFault < Aws::EmptyStructure; end
+
     # The requested operation can't be performed while the proxy is in this
     # state.
     #
@@ -13313,12 +13754,19 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] enable_global_write_forwarding
-    #   A value that indicates whether to enable write operations to be
-    #   forwarded from this cluster to the primary cluster in an Aurora
-    #   global database. The resulting changes are replicated back to this
-    #   cluster. This parameter only applies to DB clusters that are
-    #   secondary clusters in an Aurora global database. By default, Aurora
-    #   disallows write operations for secondary clusters.
+    #   A value that indicates whether to enable this DB cluster to forward
+    #   write operations to the primary cluster of an Aurora global database
+    #   (GlobalCluster). By default, write operations are not allowed on
+    #   Aurora DB clusters that are secondary clusters in an Aurora global
+    #   database.
+    #
+    #   You can set this value only on Aurora DB clusters that are members
+    #   of an Aurora global database. With this parameter enabled, a
+    #   secondary cluster can forward writes to the current primary cluster
+    #   and the resulting changes are replicated back to this cluster. For
+    #   the primary DB cluster of an Aurora global database, this value is
+    #   used immediately if the primary is demoted by the
+    #   FailoverGlobalCluster API operation, but it does nothing until then.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBClusterMessage AWS API Documentation
@@ -13543,6 +13991,7 @@ module Aws::RDS
     #         certificate_rotation_restart: false,
     #         replica_mode: "open-read-only", # accepts open-read-only, mounted
     #         enable_customer_owned_ip: false,
+    #         aws_backup_recovery_point_arn: "AwsBackupRecoveryPointArn",
     #       }
     #
     # @!attribute [rw] db_instance_identifier
@@ -14265,6 +14714,10 @@ module Aws::RDS
     #   [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
     #   @return [Boolean]
     #
+    # @!attribute [rw] aws_backup_recovery_point_arn
+    #   The Amazon Resource Name (ARN) of the recovery point in AWS Backup.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstanceMessage AWS API Documentation
     #
     class ModifyDBInstanceMessage < Struct.new(
@@ -14311,7 +14764,8 @@ module Aws::RDS
       :max_allocated_storage,
       :certificate_rotation_restart,
       :replica_mode,
-      :enable_customer_owned_ip)
+      :enable_customer_owned_ip,
+      :aws_backup_recovery_point_arn)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -14390,6 +14844,57 @@ module Aws::RDS
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ModifyDBProxyEndpointRequest
+    #   data as a hash:
+    #
+    #       {
+    #         db_proxy_endpoint_name: "DBProxyEndpointName", # required
+    #         new_db_proxy_endpoint_name: "DBProxyEndpointName",
+    #         vpc_security_group_ids: ["String"],
+    #       }
+    #
+    # @!attribute [rw] db_proxy_endpoint_name
+    #   The name of the DB proxy sociated with the DB proxy endpoint that
+    #   you want to modify.
+    #   @return [String]
+    #
+    # @!attribute [rw] new_db_proxy_endpoint_name
+    #   The new identifier for the `DBProxyEndpoint`. An identifier must
+    #   begin with a letter and must contain only ASCII letters, digits, and
+    #   hyphens; it can't end with a hyphen or contain two consecutive
+    #   hyphens.
+    #   @return [String]
+    #
+    # @!attribute [rw] vpc_security_group_ids
+    #   The VPC security group IDs for the DB proxy endpoint. When the DB
+    #   proxy endpoint uses a different VPC than the original proxy, you
+    #   also specify a different set of security group IDs than for the
+    #   original proxy.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBProxyEndpointRequest AWS API Documentation
+    #
+    class ModifyDBProxyEndpointRequest < Struct.new(
+      :db_proxy_endpoint_name,
+      :new_db_proxy_endpoint_name,
+      :vpc_security_group_ids)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] db_proxy_endpoint
+    #   The `DBProxyEndpoint` object representing the new settings for the
+    #   DB proxy endpoint.
+    #   @return [Types::DBProxyEndpoint]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBProxyEndpointResponse AWS API Documentation
+    #
+    class ModifyDBProxyEndpointResponse < Struct.new(
+      :db_proxy_endpoint)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ModifyDBProxyRequest
     #   data as a hash:
     #
@@ -20494,8 +20999,23 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] is_major_version_upgrade
-    #   A value that indicates whether a database engine is upgraded to a
-    #   major version.
+    #   A value that indicates whether upgrading to the target version
+    #   requires upgrading the major version of the database engine.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] supported_engine_modes
+    #   A list of the supported DB engine modes for the target engine
+    #   version.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] supports_parallel_query
+    #   A value that indicates whether you can use Aurora parallel query
+    #   with the target engine version.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] supports_global_databases
+    #   A value that indicates whether you can use Aurora global databases
+    #   with the target engine version.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/UpgradeTarget AWS API Documentation
@@ -20505,7 +21025,10 @@ module Aws::RDS
       :engine_version,
       :description,
       :auto_upgrade,
-      :is_major_version_upgrade)
+      :is_major_version_upgrade,
+      :supported_engine_modes,
+      :supports_parallel_query,
+      :supports_global_databases)
       SENSITIVE = []
       include Aws::Structure
     end