aws-sdk-rds 1.7.0 → 1.8.0

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

@@ -186,7 +186,7 @@ module Aws::RDS
     #
     # @!attribute [rw] opt_in_type
     #   A value that specifies the type of opt-in request, or undoes an
-    #   opt-in request. An opt-in request of type `immediate` cannot be
+    #   opt-in request. An opt-in request of type `immediate` can't be
     #   undone.
     #
     #   Valid values:
@@ -274,16 +274,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_security_group
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * DescribeDBSecurityGroups
-    #
-    #   * AuthorizeDBSecurityGroupIngress
-    #
-    #   * CreateDBSecurityGroup
-    #
-    #   * RevokeDBSecurityGroupIngress
+    #   Contains the details for an Amazon RDS DB security group.
     #
     #   This data type is used as a response element in the
     #   DescribeDBSecurityGroups action.
@@ -452,7 +443,12 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://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/CopyDBClusterParameterGroupMessage AWS API Documentation
@@ -466,12 +462,10 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster_parameter_group
-    #   Contains the result of a successful invocation of the
-    #   CreateDBClusterParameterGroup or CopyDBClusterParameterGroup action.
+    #   Contains the details of an Amazon RDS DB cluster parameter group.
     #
-    #   This data type is used as a request parameter in the
-    #   DeleteDBClusterParameterGroup action, and as a response element in
-    #   the DescribeDBClusterParameterGroups action.
+    #   This data type is used as a response element in the
+    #   DescribeDBClusterParameterGroups action.
     #   @return [Types::DBClusterParameterGroup]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBClusterParameterGroupResult AWS API Documentation
@@ -503,7 +497,7 @@ module Aws::RDS
     #   The identifier of the DB cluster snapshot to copy. This parameter is
     #   not case-sensitive.
     #
-    #   You cannot copy an encrypted, shared DB cluster snapshot from one
+    #   You can't copy an encrypted, shared DB cluster snapshot from one
     #   AWS Region to another.
     #
     #   Constraints:
@@ -540,9 +534,9 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] kms_key_id
-    #   The AWS KMS key ID for an encrypted DB cluster snapshot. The KMS key
-    #   ID is the Amazon Resource Name (ARN), KMS key identifier, or the KMS
-    #   key alias for the KMS encryption key.
+    #   The AWS AWS KMS key ID for an encrypted DB cluster snapshot. The KMS
+    #   key ID is the Amazon Resource Name (ARN), KMS key identifier, or the
+    #   KMS key alias for the KMS encryption key.
     #
     #   If you copy an unencrypted DB cluster snapshot and specify a value
     #   for the `KmsKeyId` parameter, Amazon RDS encrypts the target DB
@@ -561,7 +555,7 @@ module Aws::RDS
     #   must set `KmsKeyId` to the KMS key ID you want to use to encrypt the
     #   copy of the DB cluster snapshot in the destination AWS Region. KMS
     #   encryption keys are specific to the AWS Region that they are created
-    #   in, and you cannot use encryption keys from one AWS Region in
+    #   in, and you can't use encryption keys from one AWS Region in
     #   another AWS Region.
     #   @return [String]
     #
@@ -578,11 +572,11 @@ module Aws::RDS
     #   be copied. The pre-signed URL request must contain the following
     #   parameter values:
     #
-    #   * `KmsKeyId` - The KMS key identifier for the key to use to encrypt
-    #     the copy of the DB cluster snapshot in the destination AWS Region.
-    #     This is the same identifier for both the `CopyDBClusterSnapshot`
-    #     action that is called in the destination AWS Region, and the
-    #     action contained in the pre-signed URL.
+    #   * `KmsKeyId` - The AWS KMS key identifier for the key to use to
+    #     encrypt the copy of the DB cluster snapshot in the destination AWS
+    #     Region. This is the same identifier for both the
+    #     `CopyDBClusterSnapshot` action that is called in the destination
+    #     AWS Region, and the action contained in the pre-signed URL.
     #
     #   * `DestinationRegion` - The name of the AWS Region that the DB
     #     cluster snapshot will be created in.
@@ -591,8 +585,8 @@ module Aws::RDS
     #     identifier for the encrypted DB cluster snapshot to be copied.
     #     This identifier must be in the Amazon Resource Name (ARN) format
     #     for the source AWS Region. For example, if you are copying an
-    #     encrypted DB cluster snapshot from the us-west-2 region, then your
-    #     `SourceDBClusterSnapshotIdentifier` looks like the following
+    #     encrypted DB cluster snapshot from the us-west-2 AWS Region, then
+    #     your `SourceDBClusterSnapshotIdentifier` looks like the following
     #     example:
     #     `arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115`.
     #
@@ -608,11 +602,17 @@ module Aws::RDS
     #
     # @!attribute [rw] copy_tags
     #   True to copy all tags from the source DB cluster snapshot to the
-    #   target DB cluster snapshot; otherwise false. The default is false.
+    #   target DB cluster snapshot, and otherwise false. The default is
+    #   false.
     #   @return [Boolean]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] destination_region
@@ -638,12 +638,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster_snapshot
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBClusterSnapshot
-    #
-    #   * DeleteDBClusterSnapshot
+    #   Contains the details for an Amazon RDS DB cluster snapshot
     #
     #   This data type is used as a response element in the
     #   DescribeDBClusterSnapshots action.
@@ -709,7 +704,12 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://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/CopyDBParameterGroupMessage AWS API Documentation
@@ -723,11 +723,9 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_parameter_group
-    #   Contains the result of a successful invocation of the
-    #   CreateDBParameterGroup action.
+    #   Contains the details of an Amazon RDS DB parameter group.
     #
-    #   This data type is used as a request parameter in the
-    #   DeleteDBParameterGroup action, and as a response element in the
+    #   This data type is used as a response element in the
     #   DescribeDBParameterGroups action.
     #   @return [Types::DBParameterGroup]
     #
@@ -823,17 +821,22 @@ module Aws::RDS
     #   If you copy an encrypted snapshot to a different AWS Region, then
     #   you must specify a KMS key for the destination AWS Region. KMS
     #   encryption keys are specific to the AWS Region that they are created
-    #   in, and you cannot use encryption keys from one AWS Region in
+    #   in, and you can't use encryption keys from one AWS Region in
     #   another AWS Region.
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] copy_tags
     #   True to copy all tags from the source DB snapshot to the target DB
-    #   snapshot; otherwise false. The default is false.
+    #   snapshot, and otherwise false. The default is false.
     #   @return [Boolean]
     #
     # @!attribute [rw] pre_signed_url
@@ -843,9 +846,9 @@ module Aws::RDS
     #
     #   You must specify this parameter when you copy an encrypted DB
     #   snapshot from another AWS Region by using the Amazon RDS API. You
-    #   can specify the source region option instead of this parameter when
-    #   you copy an encrypted DB snapshot from another AWS Region by using
-    #   the AWS CLI.
+    #   can specify the `--source-region` option instead of this parameter
+    #   when you copy an encrypted DB snapshot from another AWS Region by
+    #   using the AWS CLI.
     #
     #   The presigned URL must be a valid request for the `CopyDBSnapshot`
     #   API action that can be executed in the source AWS Region that
@@ -858,23 +861,24 @@ module Aws::RDS
     #     URL.
     #
     #     For example, if you copy an encrypted DB snapshot from the
-    #     us-west-2 region to the us-east-1 region, then you call the
-    #     `CopyDBSnapshot` action in the us-east-1 region and provide a
-    #     presigned URL that contains a call to the `CopyDBSnapshot` action
-    #     in the us-west-2 region. For this example, the `DestinationRegion`
-    #     in the presigned URL must be set to the us-east-1 region.
-    #
-    #   * `KmsKeyId` - The KMS key identifier for the key to use to encrypt
-    #     the copy of the DB snapshot in the destination AWS Region. This is
-    #     the same identifier for both the `CopyDBSnapshot` action that is
-    #     called in the destination AWS Region, and the action contained in
-    #     the presigned URL.
+    #     us-west-2 AWS Region to the us-east-1 AWS Region, then you call
+    #     the `CopyDBSnapshot` action in the us-east-1 AWS Region and
+    #     provide a presigned URL that contains a call to the
+    #     `CopyDBSnapshot` action in the us-west-2 AWS Region. For this
+    #     example, the `DestinationRegion` in the presigned URL must be set
+    #     to the us-east-1 AWS Region.
+    #
+    #   * `KmsKeyId` - The AWS KMS key identifier for the key to use to
+    #     encrypt the copy of the DB snapshot in the destination AWS Region.
+    #     This is the same identifier for both the `CopyDBSnapshot` action
+    #     that is called in the destination AWS Region, and the action
+    #     contained in the presigned URL.
     #
     #   * `SourceDBSnapshotIdentifier` - The DB snapshot identifier for the
     #     encrypted snapshot to be copied. This identifier must be in the
     #     Amazon Resource Name (ARN) format for the source AWS Region. For
     #     example, if you are copying an encrypted DB snapshot from the
-    #     us-west-2 region, then your `SourceDBSnapshotIdentifier` looks
+    #     us-west-2 AWS Region, then your `SourceDBSnapshotIdentifier` looks
     #     like the following example:
     #     `arn:aws:rds:us-west-2:123456789012:snapshot:mysql-instance1-snapshot-20161115`.
     #
@@ -896,8 +900,8 @@ module Aws::RDS
     #   Region to another, and your DB instance uses a nondefault option
     #   group. If your source DB instance uses Transparent Data Encryption
     #   for Oracle or Microsoft SQL Server, you must specify this option
-    #   when copying across regions. For more information, see [Option Group
-    #   Considerations][1].
+    #   when copying across AWS Regions. For more information, see [Option
+    #   Group Considerations][1].
     #
     #
     #
@@ -928,12 +932,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_snapshot
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBSnapshot
-    #
-    #   * DeleteDBSnapshot
+    #   Contains the details of an Amazon RDS DB snapshot.
     #
     #   This data type is used as a response element in the
     #   DescribeDBSnapshots action.
@@ -1004,7 +1003,12 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://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/CopyOptionGroupMessage AWS API Documentation
@@ -1063,7 +1067,7 @@ module Aws::RDS
     #
     # @!attribute [rw] availability_zones
     #   A list of EC2 Availability Zones that instances in the DB cluster
-    #   can be created in. For information on regions and Availability
+    #   can be created in. For information on AWS Regions and Availability
     #   Zones, see [Regions and Availability Zones][1].
     #
     #
@@ -1138,7 +1142,7 @@ module Aws::RDS
     # @!attribute [rw] engine
     #   The name of the database engine to be used for this DB cluster.
     #
-    #   Valid Values: `aurora`
+    #   Valid Values: `aurora`, `aurora-postgresql`
     #   @return [String]
     #
     # @!attribute [rw] engine_version
@@ -1179,8 +1183,8 @@ module Aws::RDS
     #   A value that indicates that the DB cluster should be associated with
     #   the specified option group.
     #
-    #   Permanent options cannot be removed from an option group. The option
-    #   group cannot be removed from a DB cluster once it is associated with
+    #   Permanent options can't be removed from an option group. The option
+    #   group can't be removed from a DB cluster once it is associated with
     #   a DB cluster.
     #   @return [String]
     #
@@ -1189,16 +1193,16 @@ module Aws::RDS
     #   automated backups are enabled using the `BackupRetentionPeriod`
     #   parameter.
     #
-    #   Default: A 30-minute window selected at random from an 8-hour block
-    #   of time per AWS Region. To see the time blocks available, see [
-    #   Adjusting the Preferred Maintenance Window][1] in the *Amazon RDS
-    #   User Guide.*
+    #   The default is a 30-minute window selected at random from an 8-hour
+    #   block of time for each AWS Region. To see the time blocks available,
+    #   see [ Adjusting the Preferred Maintenance Window][1] in the *Amazon
+    #   RDS User Guide.*
     #
     #   Constraints:
     #
     #   * Must be in the format `hh24:mi-hh24:mi`.
     #
-    #   * Times should be in Universal Coordinated Time (UTC).
+    #   * Must be in Universal Coordinated Time (UTC).
     #
     #   * Must not conflict with the preferred maintenance window.
     #
@@ -1215,12 +1219,12 @@ module Aws::RDS
     #
     #   Format: `ddd:hh24:mi-ddd:hh24:mi`
     #
-    #   Default: A 30-minute window selected at random from an 8-hour block
-    #   of time per AWS Region, occurring on a random day of the week. To
-    #   see the time blocks available, see [ Adjusting the Preferred
-    #   Maintenance Window][1] in the *Amazon RDS User Guide.*
+    #   The default is a 30-minute window selected at random from an 8-hour
+    #   block of time for each AWS Region, occurring on a random day of the
+    #   week. To see the time blocks available, see [ Adjusting the
+    #   Preferred Maintenance Window][1] in the *Amazon RDS User Guide.*
     #
-    #   Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
+    #   Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.
     #
     #   Constraints: Minimum 30-minute window.
     #
@@ -1235,7 +1239,12 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] storage_encrypted
@@ -1243,7 +1252,7 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] kms_key_id
-    #   The KMS key identifier for an encrypted DB cluster.
+    #   The AWS KMS key identifier for an encrypted DB cluster.
     #
     #   The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
     #   encryption key. If you are creating a DB cluster with the same AWS
@@ -1286,11 +1295,11 @@ module Aws::RDS
     #   The pre-signed URL request must contain the following parameter
     #   values:
     #
-    #   * `KmsKeyId` - The KMS key identifier for the key to use to encrypt
-    #     the copy of the DB cluster in the destination AWS Region. This
-    #     should refer to the same KMS key for both the `CreateDBCluster`
-    #     action that is called in the destination AWS Region, and the
-    #     action contained in the pre-signed URL.
+    #   * `KmsKeyId` - The AWS KMS key identifier for the key to use to
+    #     encrypt the copy of the DB cluster in the destination AWS Region.
+    #     This should refer to the same KMS key for both the
+    #     `CreateDBCluster` action that is called in the destination AWS
+    #     Region, and the action contained in the pre-signed URL.
     #
     #   * `DestinationRegion` - The name of the AWS Region that Aurora Read
     #     Replica will be created in.
@@ -1299,8 +1308,8 @@ module Aws::RDS
     #     encrypted DB cluster to be copied. This identifier must be in the
     #     Amazon Resource Name (ARN) format for the source AWS Region. For
     #     example, if you are copying an encrypted DB cluster from the
-    #     us-west-2 region, then your `ReplicationSourceIdentifier` would
-    #     look like Example:
+    #     us-west-2 AWS Region, then your `ReplicationSourceIdentifier`
+    #     would look like Example:
     #     `arn:aws:rds:us-west-2:123456789012:cluster:aurora-cluster1`.
     #
     #   To learn how to generate a Signature Version 4 signed request, see [
@@ -1314,9 +1323,8 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] enable_iam_database_authentication
-    #   A Boolean value that is true to enable mapping of AWS Identity and
-    #   Access Management (IAM) accounts to database accounts, and otherwise
-    #   false.
+    #   True to enable mapping of AWS Identity and Access Management (IAM)
+    #   accounts to database accounts, and otherwise false.
     #
     #   Default: `false`
     #   @return [Boolean]
@@ -1401,7 +1409,12 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://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/CreateDBClusterParameterGroupMessage AWS API Documentation
@@ -1415,12 +1428,10 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster_parameter_group
-    #   Contains the result of a successful invocation of the
-    #   CreateDBClusterParameterGroup or CopyDBClusterParameterGroup action.
+    #   Contains the details of an Amazon RDS DB cluster parameter group.
     #
-    #   This data type is used as a request parameter in the
-    #   DeleteDBClusterParameterGroup action, and as a response element in
-    #   the DescribeDBClusterParameterGroups action.
+    #   This data type is used as a response element in the
+    #   DescribeDBClusterParameterGroups action.
     #   @return [Types::DBClusterParameterGroup]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBClusterParameterGroupResult AWS API Documentation
@@ -1431,20 +1442,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBCluster
-    #
-    #   * DeleteDBCluster
-    #
-    #   * FailoverDBCluster
-    #
-    #   * ModifyDBCluster
-    #
-    #   * RestoreDBClusterFromSnapshot
-    #
-    #   * RestoreDBClusterToPointInTime
+    #   Contains the details of an Amazon RDS DB cluster.
     #
     #   This data type is used as a response element in the
     #   DescribeDBClusters action.
@@ -1513,12 +1511,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster_snapshot
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBClusterSnapshot
-    #
-    #   * DeleteDBClusterSnapshot
+    #   Contains the details for an Amazon RDS DB cluster snapshot
     #
     #   This data type is used as a response element in the
     #   DescribeDBClusterSnapshots action.
@@ -1676,7 +1669,7 @@ module Aws::RDS
     #
     # @!attribute [rw] allocated_storage
     #   The amount of storage (in gigabytes) to be initially allocated for
-    #   the database instance.
+    #   the DB instance.
     #
     #   Type: Integer
     #
@@ -1767,8 +1760,8 @@ module Aws::RDS
     #
     # @!attribute [rw] db_instance_class
     #   The compute and memory capacity of the DB instance, for example,
-    #   `db.m4.large`. Not all DB instance classes are available in all
-    #   regions, or for all database engines. For the full list of DB
+    #   `db.m4.large`. Not all DB instance classes are available in all AWS
+    #   Regions, or for all database engines. For the full list of DB
     #   instance classes, and availability for your engine, see [DB Instance
     #   Class][1] in the Amazon RDS User Guide.
     #
@@ -1786,6 +1779,8 @@ module Aws::RDS
     #
     #   * `aurora`
     #
+    #   * `aurora-postgresql`
+    #
     #   * `mariadb`
     #
     #   * `mysql`
@@ -1877,8 +1872,8 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] master_user_password
-    #   The password for the master user. Can be any printable ASCII
-    #   character except "/", """, or "@".
+    #   The password for the master user. The password can include any
+    #   printable ASCII character except "/", """, or "@".
     #
     #   **Amazon Aurora**
     #
@@ -1927,8 +1922,8 @@ module Aws::RDS
     #   @return [Array<String>]
     #
     # @!attribute [rw] availability_zone
-    #   The EC2 Availability Zone that the database instance is created in.
-    #   For information on regions and Availability Zones, see [Regions and
+    #   The EC2 Availability Zone that the DB instance is created in. For
+    #   information on AWS Regions and Availability Zones, see [Regions and
     #   Availability Zones][1].
     #
     #   Default: A random, system-chosen Availability Zone in the
@@ -1936,7 +1931,7 @@ module Aws::RDS
     #
     #   Example: `us-east-1d`
     #
-    #   Constraint: The AvailabilityZone parameter cannot be specified if
+    #   Constraint: The AvailabilityZone parameter can't be specified if
     #   the MultiAZ parameter is set to `true`. The specified Availability
     #   Zone must be in the same AWS Region as the current endpoint.
     #
@@ -1952,25 +1947,23 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] preferred_maintenance_window
-    #   The weekly time range during which system maintenance can occur, in
-    #   Universal Coordinated Time (UTC). For more information, see [DB
-    #   Instance Maintenance][1].
+    #   The time range each week during which system maintenance can occur,
+    #   in Universal Coordinated Time (UTC). For more information, see
+    #   [Amazon RDS Maintenance Window][1].
     #
     #   Format: `ddd:hh24:mi-ddd:hh24:mi`
     #
-    #   Default: A 30-minute window selected at random from an 8-hour block
-    #   of time per AWS Region, occurring on a random day of the week. To
-    #   see the time blocks available, see [ Adjusting the Preferred
-    #   Maintenance Window][2] in the *Amazon RDS User Guide.*
+    #   The default is a 30-minute window selected at random from an 8-hour
+    #   block of time for each AWS Region, occurring on a random day of the
+    #   week.
     #
-    #   Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
+    #   Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.
     #
     #   Constraints: Minimum 30-minute window.
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBMaintenance.html
-    #   [2]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/AdjustingTheMaintenanceWindow.html
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
     #   @return [String]
     #
     # @!attribute [rw] db_parameter_group_name
@@ -2010,7 +2003,7 @@ module Aws::RDS
     # @!attribute [rw] preferred_backup_window
     #   The daily time range during which automated backups are created if
     #   automated backups are enabled, using the `BackupRetentionPeriod`
-    #   parameter. For more information, see [DB Instance Backups][1].
+    #   parameter. For more information, see [The Backup Window][1].
     #
     #   **Amazon Aurora**
     #
@@ -2018,15 +2011,15 @@ module Aws::RDS
     #   is managed by the DB cluster. For more information, see
     #   CreateDBCluster.
     #
-    #   Default: A 30-minute window selected at random from an 8-hour block
-    #   of time per AWS Region. To see the time blocks available, see [
-    #   Adjusting the Preferred DB Instance Maintenance Window][2].
+    #   The default is a 30-minute window selected at random from an 8-hour
+    #   block of time for each AWS Region. To see the time blocks available,
+    #   see [ Adjusting the Preferred DB Instance Maintenance Window][2].
     #
     #   Constraints:
     #
     #   * Must be in the format `hh24:mi-hh24:mi`.
     #
-    #   * Times should be in Universal Coordinated Time (UTC).
+    #   * Must be in Universal Coordinated Time (UTC).
     #
     #   * Must not conflict with the preferred maintenance window.
     #
@@ -2034,7 +2027,7 @@ module Aws::RDS
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.BackingUpAndRestoringAmazonRDSInstances.html
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow
     #   [2]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#AdjustingTheMaintenanceWindow
     #   @return [String]
     #
@@ -2088,7 +2081,7 @@ module Aws::RDS
     #   @return [Integer]
     #
     # @!attribute [rw] multi_az
-    #   Specifies if the DB instance is a Multi-AZ deployment. You cannot
+    #   Specifies if the DB instance is a Multi-AZ deployment. You can't
     #   set the AvailabilityZone parameter if the MultiAZ parameter is set
     #   to true.
     #   @return [Boolean]
@@ -2108,65 +2101,65 @@ module Aws::RDS
     #
     #   **MariaDB**
     #
-    #   * `10.1.23` (supported in all AWS regions)
+    #   * `10.1.23` (supported in all AWS Regions)
     #
-    #   * `10.1.19` (supported in all AWS regions)
+    #   * `10.1.19` (supported in all AWS Regions)
     #
-    #   * `10.1.14` (supported in all regions except us-east-2)
+    #   * `10.1.14` (supported in all AWS Regions except us-east-2)
     #
     #
     #
-    #   * `10.0.31` (supported in all AWS regions)
+    #   * `10.0.31` (supported in all AWS Regions)
     #
-    #   * `10.0.28` (supported in all AWS regions)
+    #   * `10.0.28` (supported in all AWS Regions)
     #
-    #   * `10.0.24` (supported in all AWS regions)
+    #   * `10.0.24` (supported in all AWS Regions)
     #
-    #   * `10.0.17` (supported in all regions except us-east-2,
+    #   * `10.0.17` (supported in all AWS Regions except us-east-2,
     #     ca-central-1, eu-west-2)
     #
     #   **Microsoft SQL Server 2016**
     #
     #   * `13.00.4422.0.v1` (supported for all editions, and all AWS
-    #     regions)
+    #     Regions)
     #
     #   * `13.00.2164.0.v1` (supported for all editions, and all AWS
-    #     regions)
+    #     Regions)
     #
     #   **Microsoft SQL Server 2014**
     #
     #   * `12.00.5546.0.v1` (supported for all editions, and all AWS
-    #     regions)
+    #     Regions)
     #
     #   * `12.00.5000.0.v1` (supported for all editions, and all AWS
-    #     regions)
+    #     Regions)
     #
     #   * `12.00.4422.0.v1` (supported for all editions except Enterprise
-    #     Edition, and all AWS regions except ca-central-1 and eu-west-2)
+    #     Edition, and all AWS Regions except ca-central-1 and eu-west-2)
     #
     #   **Microsoft SQL Server 2012**
     #
     #   * `11.00.6594.0.v1` (supported for all editions, and all AWS
-    #     regions)
+    #     Regions)
     #
     #   * `11.00.6020.0.v1` (supported for all editions, and all AWS
-    #     regions)
+    #     Regions)
     #
-    #   * `11.00.5058.0.v1` (supported for all editions, and all AWS regions
+    #   * `11.00.5058.0.v1` (supported for all editions, and all AWS Regions
     #     except us-east-2, ca-central-1, and eu-west-2)
     #
     #   * `11.00.2100.60.v1` (supported for all editions, and all AWS
-    #     regions except us-east-2, ca-central-1, and eu-west-2)
+    #     Regions except us-east-2, ca-central-1, and eu-west-2)
     #
     #   **Microsoft SQL Server 2008 R2**
     #
-    #   * `10.50.6529.0.v1` (supported for all editions, and all AWS regions
+    #   * `10.50.6529.0.v1` (supported for all editions, and all AWS Regions
     #     except us-east-2, ca-central-1, and eu-west-2)
     #
     #   * `10.50.6000.34.v1` (supported for all editions, and all AWS
-    #     regions except us-east-2, ca-central-1, and eu-west-2)
+    #     Regions except us-east-2, ca-central-1, and eu-west-2)
     #
-    #   * `10.50.2789.0.v1` (supported for all editions, and all AWS regions
+    #   * `10.50.2789.0.v1` (supported for all editions, and all AWS Regions
     #     except us-east-2, ca-central-1, and eu-west-2)
     #
     #   **MySQL**
@@ -2177,30 +2170,28 @@ module Aws::RDS
     #
     #   * `5.7.16` (supported in all AWS regions)
     #
-    #   * `5.7.11` (supported in all AWS regions)
     #
     #
+    #   * `5.6.37` (supported in all AWS Regions)
     #
-    #   * `5.6.37` (supported in all AWS regions)
+    #   * `5.6.35` (supported in all AWS Regions)
     #
-    #   * `5.6.35` (supported in all AWS regions)
+    #   * `5.6.34` (supported in all AWS Regions)
     #
-    #   * `5.6.34` (supported in all AWS regions)
+    #   * `5.6.29` (supported in all AWS Regions)
     #
-    #   * `5.6.29` (supported in all AWS regions)
-    #
-    #   * `5.6.27` (supported in all regions except us-east-2, ca-central-1,
-    #     eu-west-2)
+    #   * `5.6.27` (supported in all AWS Regions except us-east-2,
+    #     ca-central-1, eu-west-2)
     #
     #
     #
-    #   * `5.5.57` (supported in all AWS regions)
+    #   * `5.5.57` (supported in all AWS Regions)
     #
-    #   * `5.5.54` (supported in all AWS regions)
+    #   * `5.5.54` (supported in all AWS Regions)
     #
-    #   * `5.5.53` (supported in all AWS regions)
+    #   * `5.5.53` (supported in all AWS Regions)
     #
-    #   * `5.5.46` (supported in all AWS regions)
+    #   * `5.5.46` (supported in all AWS Regions)
     #
     #   **Oracle 12c**
     #
@@ -2284,12 +2275,18 @@ module Aws::RDS
     #
     # @!attribute [rw] iops
     #   The amount of Provisioned IOPS (input/output operations per second)
-    #   to be initially allocated for the DB instance.
+    #   to be initially allocated for the DB instance. For information about
+    #   valid Iops values, see see [Amazon RDS Provisioned IOPS Storage to
+    #   Improve Performance][1].
     #
     #   Constraints: Must be a multiple between 3 and 10 of the storage
     #   amount for the DB instance. Must also be an integer multiple of
     #   1000. For example, if the size of your DB instance is 500 GB, then
     #   your `Iops` value can be 2000, 3000, 4000, or 5000.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
     #   @return [Integer]
     #
     # @!attribute [rw] option_group_name
@@ -2297,8 +2294,8 @@ module Aws::RDS
     #   specified option group.
     #
     #   Permanent options, such as the TDE option for Oracle Advanced
-    #   Security TDE, cannot be removed from an option group, and that
-    #   option group cannot be removed from a DB instance once it is
+    #   Security TDE, can't be removed from an option group, and that
+    #   option group can't be removed from a DB instance once it is
     #   associated with a DB instance
     #   @return [String]
     #
@@ -2335,7 +2332,12 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] db_cluster_identifier
@@ -2354,17 +2356,17 @@ module Aws::RDS
     #   If you specify `io1`, you must also include a value for the `Iops`
     #   parameter.
     #
-    #   Default: `io1` if the `Iops` parameter is specified; otherwise
+    #   Default: `io1` if the `Iops` parameter is specified, otherwise
     #   `standard`
     #   @return [String]
     #
     # @!attribute [rw] tde_credential_arn
-    #   The ARN from the Key Store with which to associate the instance for
+    #   The ARN from the key store with which to associate the instance for
     #   TDE encryption.
     #   @return [String]
     #
     # @!attribute [rw] tde_credential_password
-    #   The password for the given ARN from the Key Store in order to access
+    #   The password for the given ARN from the key store in order to access
     #   the device.
     #   @return [String]
     #
@@ -2380,7 +2382,7 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] kms_key_id
-    #   The KMS key identifier for an encrypted DB instance.
+    #   The AWS KMS key identifier for an encrypted DB instance.
     #
     #   The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
     #   encryption key. If you are creating a DB instance with the same AWS
@@ -2406,7 +2408,7 @@ module Aws::RDS
     #
     # @!attribute [rw] copy_tags_to_snapshot
     #   True to copy all tags from the DB instance to snapshots of the DB
-    #   instance; otherwise false. The default is false.
+    #   instance, and otherwise false. The default is false.
     #   @return [Boolean]
     #
     # @!attribute [rw] monitoring_interval
@@ -2422,7 +2424,7 @@ module Aws::RDS
     #
     # @!attribute [rw] monitoring_role_arn
     #   The ARN for the IAM role that permits RDS to send enhanced
-    #   monitoring metrics to CloudWatch Logs. For example,
+    #   monitoring metrics to Amazon CloudWatch Logs. For example,
     #   `arn:aws:iam:123456789012:role/emaccess`. For information on
     #   creating a monitoring role, go to [Setting Up and Enabling Enhanced
     #   Monitoring][1].
@@ -2466,7 +2468,7 @@ module Aws::RDS
     #
     # @!attribute [rw] enable_iam_database_authentication
     #   True to enable mapping of AWS Identity and Access Management (IAM)
-    #   accounts to database accounts; otherwise false.
+    #   accounts to database accounts, and otherwise false.
     #
     #   You can enable IAM database authentication for the following
     #   database engines:
@@ -2487,13 +2489,13 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] enable_performance_insights
-    #   True to enable Performance Insights for the DB instance; otherwise
-    #   false.
+    #   True to enable Performance Insights for the DB instance, and
+    #   otherwise false.
     #   @return [Boolean]
     #
     # @!attribute [rw] performance_insights_kms_key_id
-    #   The KMS key identifier for encryption of Performance Insights data.
-    #   The KMS key ID is the Amazon Resource Name (ARN), KMS key
+    #   The AWS KMS key identifier for encryption of Performance Insights
+    #   data. The KMS key ID is the Amazon Resource Name (ARN), KMS key
     #   identifier, or the KMS key alias for the KMS encryption key.
     #   @return [String]
     #
@@ -2597,7 +2599,7 @@ module Aws::RDS
     #
     #   * Can specify a DB instance that is a PostgreSQL DB instance only if
     #     the source is running PostgreSQL 9.3.5 or later (9.4.7 and higher
-    #     for cross region replication).
+    #     for cross-region replication).
     #
     #   * The specified DB instance must have automatic backups enabled, its
     #     backup retention period must be greater than 0.
@@ -2617,8 +2619,8 @@ module Aws::RDS
     #
     # @!attribute [rw] db_instance_class
     #   The compute and memory capacity of the Read Replica, for example,
-    #   `db.m4.large`. Not all DB instance classes are available in all
-    #   regions, or for all database engines. For the full list of DB
+    #   `db.m4.large`. Not all DB instance classes are available in all AWS
+    #   Regions, or for all database engines. For the full list of DB
     #   instance classes, and availability for your engine, see [DB Instance
     #   Class][1] in the Amazon RDS User Guide.
     #
@@ -2687,7 +2689,12 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] db_subnet_group_name
@@ -2726,13 +2733,13 @@ module Aws::RDS
     #   If you specify `io1`, you must also include a value for the `Iops`
     #   parameter.
     #
-    #   Default: `io1` if the `Iops` parameter is specified; otherwise
+    #   Default: `io1` if the `Iops` parameter is specified, otherwise
     #   `standard`
     #   @return [String]
     #
     # @!attribute [rw] copy_tags_to_snapshot
     #   True to copy all tags from the Read Replica to snapshots of the Read
-    #   Replica; otherwise false. The default is false.
+    #   Replica, and otherwise false. The default is false.
     #   @return [Boolean]
     #
     # @!attribute [rw] monitoring_interval
@@ -2748,7 +2755,7 @@ module Aws::RDS
     #
     # @!attribute [rw] monitoring_role_arn
     #   The ARN for the IAM role that permits RDS to send enhanced
-    #   monitoring metrics to CloudWatch Logs. For example,
+    #   monitoring metrics to Amazon CloudWatch Logs. For example,
     #   `arn:aws:iam:123456789012:role/emaccess`. For information on
     #   creating a monitoring role, go to [To create an IAM role for Amazon
     #   RDS Enhanced Monitoring][1].
@@ -2777,7 +2784,7 @@ module Aws::RDS
     #   If you create an encrypted Read Replica in a different AWS Region,
     #   then you must specify a KMS key for the destination AWS Region. KMS
     #   encryption keys are specific to the AWS Region that they are created
-    #   in, and you cannot use encryption keys from one AWS Region in
+    #   in, and you can't use encryption keys from one AWS Region in
     #   another AWS Region.
     #   @return [String]
     #
@@ -2788,9 +2795,9 @@ module Aws::RDS
     #
     #   You must specify this parameter when you create an encrypted Read
     #   Replica from another AWS Region by using the Amazon RDS API. You can
-    #   specify the source region option instead of this parameter when you
-    #   create an encrypted Read Replica from another AWS Region by using
-    #   the AWS CLI.
+    #   specify the `--source-region` option instead of this parameter when
+    #   you create an encrypted Read Replica from another AWS Region by
+    #   using the AWS CLI.
     #
     #   The presigned URL must be a valid request for the
     #   `CreateDBInstanceReadReplica` API action that can be executed in the
@@ -2804,24 +2811,24 @@ module Aws::RDS
     #     presigned URL.
     #
     #     For example, if you create an encrypted DB instance in the
-    #     us-west-1 region, from a source DB instance in the us-east-2
-    #     region, then you call the `CreateDBInstanceReadReplica` action in
-    #     the us-east-1 region and provide a presigned URL that contains a
-    #     call to the `CreateDBInstanceReadReplica` action in the us-west-2
-    #     region. For this example, the `DestinationRegion` in the presigned
-    #     URL must be set to the us-east-1 region.
-    #
-    #   * `KmsKeyId` - The KMS key identifier for the key to use to encrypt
-    #     the Read Replica in the destination AWS Region. This is the same
-    #     identifier for both the `CreateDBInstanceReadReplica` action that
-    #     is called in the destination AWS Region, and the action contained
-    #     in the presigned URL.
+    #     us-west-1 AWS Region, from a source DB instance in the us-east-2
+    #     AWS Region, then you call the `CreateDBInstanceReadReplica` action
+    #     in the us-east-1 AWS Region and provide a presigned URL that
+    #     contains a call to the `CreateDBInstanceReadReplica` action in the
+    #     us-west-2 AWS Region. For this example, the `DestinationRegion` in
+    #     the presigned URL must be set to the us-east-1 AWS Region.
+    #
+    #   * `KmsKeyId` - The AWS KMS key identifier for the key to use to
+    #     encrypt the Read Replica in the destination AWS Region. This is
+    #     the same identifier for both the `CreateDBInstanceReadReplica`
+    #     action that is called in the destination AWS Region, and the
+    #     action contained in the presigned URL.
     #
     #   * `SourceDBInstanceIdentifier` - The DB instance identifier for the
     #     encrypted DB instance to be replicated. This identifier must be in
     #     the Amazon Resource Name (ARN) format for the source AWS Region.
     #     For example, if you are creating an encrypted Read Replica from a
-    #     DB instance in the us-west-2 region, then your
+    #     DB instance in the us-west-2 AWS Region, then your
     #     `SourceDBInstanceIdentifier` looks like the following example:
     #     `arn:aws:rds:us-west-2:123456789012:instance:mysql-instance1-20161115`.
     #
@@ -2837,7 +2844,7 @@ module Aws::RDS
     #
     # @!attribute [rw] enable_iam_database_authentication
     #   True to enable mapping of AWS Identity and Access Management (IAM)
-    #   accounts to database accounts; otherwise false.
+    #   accounts to database accounts, and otherwise false.
     #
     #   You can enable IAM database authentication for the following
     #   database engines
@@ -2852,13 +2859,13 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] enable_performance_insights
-    #   True to enable Performance Insights for the read replica; otherwise
-    #   false.
+    #   True to enable Performance Insights for the read replica, and
+    #   otherwise false.
     #   @return [Boolean]
     #
     # @!attribute [rw] performance_insights_kms_key_id
-    #   The KMS key identifier for encryption of Performance Insights data.
-    #   The KMS key ID is the Amazon Resource Name (ARN), KMS key
+    #   The AWS KMS key identifier for encryption of Performance Insights
+    #   data. The KMS key ID is the Amazon Resource Name (ARN), KMS key
     #   identifier, or the KMS key alias for the KMS encryption key.
     #   @return [String]
     #
@@ -2899,18 +2906,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_instance
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBInstance
-    #
-    #   * DeleteDBInstance
-    #
-    #   * ModifyDBInstance
-    #
-    #   * StopDBInstance
-    #
-    #   * StartDBInstance
+    #   Contains the details of an Amazon RDS DB instance.
     #
     #   This data type is used as a response element in the
     #   DescribeDBInstances action.
@@ -2924,18 +2920,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_instance
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBInstance
-    #
-    #   * DeleteDBInstance
-    #
-    #   * ModifyDBInstance
-    #
-    #   * StopDBInstance
-    #
-    #   * StartDBInstance
+    #   Contains the details of an Amazon RDS DB instance.
     #
     #   This data type is used as a response element in the
     #   DescribeDBInstances action.
@@ -2991,7 +2976,12 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://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/CreateDBParameterGroupMessage AWS API Documentation
@@ -3005,11 +2995,9 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_parameter_group
-    #   Contains the result of a successful invocation of the
-    #   CreateDBParameterGroup action.
+    #   Contains the details of an Amazon RDS DB parameter group.
     #
-    #   This data type is used as a request parameter in the
-    #   DeleteDBParameterGroup action, and as a response element in the
+    #   This data type is used as a response element in the
     #   DescribeDBParameterGroups action.
     #   @return [Types::DBParameterGroup]
     #
@@ -3056,7 +3044,12 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://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/CreateDBSecurityGroupMessage AWS API Documentation
@@ -3069,16 +3062,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_security_group
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * DescribeDBSecurityGroups
-    #
-    #   * AuthorizeDBSecurityGroupIngress
-    #
-    #   * CreateDBSecurityGroup
-    #
-    #   * RevokeDBSecurityGroupIngress
+    #   Contains the details for an Amazon RDS DB security group.
     #
     #   This data type is used as a response element in the
     #   DescribeDBSecurityGroups action.
@@ -3133,7 +3117,12 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://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/CreateDBSnapshotMessage AWS API Documentation
@@ -3146,12 +3135,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_snapshot
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBSnapshot
-    #
-    #   * DeleteDBSnapshot
+    #   Contains the details of an Amazon RDS DB snapshot.
     #
     #   This data type is used as a response element in the
     #   DescribeDBSnapshots action.
@@ -3198,7 +3182,12 @@ module Aws::RDS
     #   @return [Array<String>]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://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/CreateDBSubnetGroupMessage AWS API Documentation
@@ -3212,16 +3201,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_subnet_group
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBSubnetGroup
-    #
-    #   * ModifyDBSubnetGroup
-    #
-    #   * DescribeDBSubnetGroups
-    #
-    #   * DeleteDBSubnetGroup
+    #   Contains the details of an Amazon RDS DB subnet group.
     #
     #   This data type is used as a response element in the
     #   DescribeDBSubnetGroups action.
@@ -3289,7 +3269,7 @@ module Aws::RDS
     #   The list of identifiers of the event sources for which events are
     #   returned. If not specified, then all sources are included in the
     #   response. An identifier must begin with a letter and must contain
-    #   only ASCII letters, digits, and hyphens; it cannot end with a hyphen
+    #   only ASCII letters, digits, and hyphens; it can't end with a hyphen
     #   or contain two consecutive hyphens.
     #
     #   Constraints:
@@ -3315,7 +3295,12 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://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/CreateEventSubscriptionMessage AWS API Documentation
@@ -3388,7 +3373,12 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://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/CreateOptionGroupMessage AWS API Documentation
@@ -3412,20 +3402,7 @@ module Aws::RDS
       include Aws::Structure
     end
 
-    # Contains the result of a successful invocation of the following
-    # actions:
-    #
-    # * CreateDBCluster
-    #
-    # * DeleteDBCluster
-    #
-    # * FailoverDBCluster
-    #
-    # * ModifyDBCluster
-    #
-    # * RestoreDBClusterFromSnapshot
-    #
-    # * RestoreDBClusterToPointInTime
+    # Contains the details of an Amazon RDS DB cluster.
     #
     # This data type is used as a response element in the DescribeDBClusters
     # action.
@@ -3581,14 +3558,14 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] kms_key_id
-    #   If `StorageEncrypted` is true, the KMS key identifier for the
+    #   If `StorageEncrypted` is true, the AWS KMS key identifier for the
     #   encrypted DB cluster.
     #   @return [String]
     #
     # @!attribute [rw] db_cluster_resource_id
-    #   The region-unique, immutable identifier for the DB cluster. This
-    #   identifier is found in AWS CloudTrail log entries whenever the KMS
-    #   key for the DB cluster is accessed.
+    #   The AWS Region-unique, immutable identifier for the DB cluster. This
+    #   identifier is found in AWS CloudTrail log entries whenever the AWS
+    #   KMS key for the DB cluster is accessed.
     #   @return [String]
     #
     # @!attribute [rw] db_cluster_arn
@@ -3604,7 +3581,7 @@ module Aws::RDS
     #
     # @!attribute [rw] iam_database_authentication_enabled
     #   True if mapping of AWS Identity and Access Management (IAM) accounts
-    #   to database accounts is enabled; otherwise false.
+    #   to database accounts is enabled, and otherwise false.
     #   @return [Boolean]
     #
     # @!attribute [rw] clone_group_id
@@ -3732,11 +3709,9 @@ module Aws::RDS
       include Aws::Structure
     end
 
-    # Contains the result of a successful invocation of the
-    # CreateDBClusterParameterGroup or CopyDBClusterParameterGroup action.
+    # Contains the details of an Amazon RDS DB cluster parameter group.
     #
-    # This data type is used as a request parameter in the
-    # DeleteDBClusterParameterGroup action, and as a response element in the
+    # This data type is used as a response element in the
     # DescribeDBClusterParameterGroups action.
     #
     # @!attribute [rw] db_cluster_parameter_group_name
@@ -3862,12 +3837,7 @@ module Aws::RDS
       include Aws::Structure
     end
 
-    # Contains the result of a successful invocation of the following
-    # actions:
-    #
-    # * CreateDBClusterSnapshot
-    #
-    # * DeleteDBClusterSnapshot
+    # Contains the details for an Amazon RDS DB cluster snapshot
     #
     # This data type is used as a response element in the
     # DescribeDBClusterSnapshots action.
@@ -3944,7 +3914,7 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] kms_key_id
-    #   If `StorageEncrypted` is true, the KMS key identifier for the
+    #   If `StorageEncrypted` is true, the AWS KMS key identifier for the
     #   encrypted DB cluster snapshot.
     #   @return [String]
     #
@@ -3955,12 +3925,12 @@ module Aws::RDS
     # @!attribute [rw] source_db_cluster_snapshot_arn
     #   If the DB cluster snapshot was copied from a source DB cluster
     #   snapshot, the Amazon Resource Name (ARN) for the source DB cluster
-    #   snapshot; otherwise, a null value.
+    #   snapshot, otherwise, a null value.
     #   @return [String]
     #
     # @!attribute [rw] iam_database_authentication_enabled
     #   True if mapping of AWS Identity and Access Management (IAM) accounts
-    #   to database accounts is enabled; otherwise false.
+    #   to database accounts is enabled, and otherwise false.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBClusterSnapshot AWS API Documentation
@@ -4150,18 +4120,7 @@ module Aws::RDS
       include Aws::Structure
     end
 
-    # Contains the result of a successful invocation of the following
-    # actions:
-    #
-    # * CreateDBInstance
-    #
-    # * DeleteDBInstance
-    #
-    # * ModifyDBInstance
-    #
-    # * StopDBInstance
-    #
-    # * StartDBInstance
+    # Contains the details of an Amazon RDS DB instance.
     #
     # This data type is used as a response element in the
     # DescribeDBInstances action.
@@ -4378,14 +4337,14 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] kms_key_id
-    #   If `StorageEncrypted` is true, the KMS key identifier for the
+    #   If `StorageEncrypted` is true, the AWS KMS key identifier for the
     #   encrypted DB instance.
     #   @return [String]
     #
     # @!attribute [rw] dbi_resource_id
-    #   The region-unique, immutable identifier for the DB instance. This
-    #   identifier is found in AWS CloudTrail log entries whenever the KMS
-    #   key for the DB instance is accessed.
+    #   The AWS Region-unique, immutable identifier for the DB instance.
+    #   This identifier is found in AWS CloudTrail log entries whenever the
+    #   AWS KMS key for the DB instance is accessed.
     #   @return [String]
     #
     # @!attribute [rw] ca_certificate_identifier
@@ -4415,7 +4374,7 @@ module Aws::RDS
     #
     # @!attribute [rw] monitoring_role_arn
     #   The ARN for the IAM role that permits RDS to send Enhanced
-    #   Monitoring metrics to CloudWatch Logs.
+    #   Monitoring metrics to Amazon CloudWatch Logs.
     #   @return [String]
     #
     # @!attribute [rw] promotion_tier
@@ -4441,7 +4400,7 @@ module Aws::RDS
     #
     # @!attribute [rw] iam_database_authentication_enabled
     #   True if mapping of AWS Identity and Access Management (IAM) accounts
-    #   to database accounts is enabled; otherwise false.
+    #   to database accounts is enabled, and otherwise false.
     #
     #   IAM database authentication can be enabled for the following
     #   database engines
@@ -4455,13 +4414,13 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] performance_insights_enabled
-    #   True if Performance Insights is enabled for the DB instance;
+    #   True if Performance Insights is enabled for the DB instance, and
     #   otherwise false.
     #   @return [Boolean]
     #
     # @!attribute [rw] performance_insights_kms_key_id
-    #   The KMS key identifier for encryption of Performance Insights data.
-    #   The KMS key ID is the Amazon Resource Name (ARN), KMS key
+    #   The AWS KMS key identifier for encryption of Performance Insights
+    #   data. The KMS key ID is the Amazon Resource Name (ARN), KMS key
     #   identifier, or the KMS key alias for the KMS encryption key.
     #   @return [String]
     #
@@ -4574,11 +4533,9 @@ module Aws::RDS
       include Aws::Structure
     end
 
-    # Contains the result of a successful invocation of the
-    # CreateDBParameterGroup action.
+    # Contains the details of an Amazon RDS DB parameter group.
     #
-    # This data type is used as a request parameter in the
-    # DeleteDBParameterGroup action, and as a response element in the
+    # This data type is used as a response element in the
     # DescribeDBParameterGroups action.
     #
     # @!attribute [rw] db_parameter_group_name
@@ -4697,16 +4654,7 @@ module Aws::RDS
       include Aws::Structure
     end
 
-    # Contains the result of a successful invocation of the following
-    # actions:
-    #
-    # * DescribeDBSecurityGroups
-    #
-    # * AuthorizeDBSecurityGroupIngress
-    #
-    # * CreateDBSecurityGroup
-    #
-    # * RevokeDBSecurityGroupIngress
+    # Contains the details for an Amazon RDS DB security group.
     #
     # This data type is used as a response element in the
     # DescribeDBSecurityGroups action.
@@ -4799,12 +4747,7 @@ module Aws::RDS
       include Aws::Structure
     end
 
-    # Contains the result of a successful invocation of the following
-    # actions:
-    #
-    # * CreateDBSnapshot
-    #
-    # * DeleteDBSnapshot
+    # Contains the details of an Amazon RDS DB snapshot.
     #
     # This data type is used as a response element in the
     # DescribeDBSnapshots action.
@@ -4907,8 +4850,8 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] kms_key_id
-    #   If `Encrypted` is true, the KMS key identifier for the encrypted DB
-    #   snapshot.
+    #   If `Encrypted` is true, the AWS KMS key identifier for the encrypted
+    #   DB snapshot.
     #   @return [String]
     #
     # @!attribute [rw] db_snapshot_arn
@@ -4924,7 +4867,7 @@ module Aws::RDS
     #
     # @!attribute [rw] iam_database_authentication_enabled
     #   True if mapping of AWS Identity and Access Management (IAM) accounts
-    #   to database accounts is enabled; otherwise false.
+    #   to database accounts is enabled, and otherwise false.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBSnapshot AWS API Documentation
@@ -5037,16 +4980,7 @@ module Aws::RDS
       include Aws::Structure
     end
 
-    # Contains the result of a successful invocation of the following
-    # actions:
-    #
-    # * CreateDBSubnetGroup
-    #
-    # * ModifyDBSubnetGroup
-    #
-    # * DescribeDBSubnetGroups
-    #
-    # * DeleteDBSubnetGroup
+    # Contains the details of an Amazon RDS DB subnet group.
     #
     # This data type is used as a response element in the
     # DescribeDBSubnetGroups action.
@@ -5183,7 +5117,7 @@ module Aws::RDS
     #
     #   * Must be the name of an existing DB cluster parameter group.
     #
-    #   * You cannot delete a default DB cluster parameter group.
+    #   * You can't delete a default DB cluster parameter group.
     #
     #   * Cannot be associated with any DB clusters.
     #   @return [String]
@@ -5196,20 +5130,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBCluster
-    #
-    #   * DeleteDBCluster
-    #
-    #   * FailoverDBCluster
-    #
-    #   * ModifyDBCluster
-    #
-    #   * RestoreDBClusterFromSnapshot
-    #
-    #   * RestoreDBClusterToPointInTime
+    #   Contains the details of an Amazon RDS DB cluster.
     #
     #   This data type is used as a response element in the
     #   DescribeDBClusters action.
@@ -5244,12 +5165,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster_snapshot
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBClusterSnapshot
-    #
-    #   * DeleteDBClusterSnapshot
+    #   Contains the details for an Amazon RDS DB cluster snapshot
     #
     #   This data type is used as a response element in the
     #   DescribeDBClusterSnapshots action.
@@ -5333,18 +5249,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_instance
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBInstance
-    #
-    #   * DeleteDBInstance
-    #
-    #   * ModifyDBInstance
-    #
-    #   * StopDBInstance
-    #
-    #   * StartDBInstance
+    #   Contains the details of an Amazon RDS DB instance.
     #
     #   This data type is used as a response element in the
     #   DescribeDBInstances action.
@@ -5371,7 +5276,7 @@ module Aws::RDS
     #
     #   * Must be the name of an existing DB parameter group
     #
-    #   * You cannot delete a default DB parameter group
+    #   * You can't delete a default DB parameter group
     #
     #   * Cannot be associated with any DB instances
     #   @return [String]
@@ -5393,7 +5298,7 @@ module Aws::RDS
     # @!attribute [rw] db_security_group_name
     #   The name of the DB security group to delete.
     #
-    #   <note markdown="1"> You cannot delete the default DB security group.
+    #   <note markdown="1"> You can't delete the default DB security group.
     #
     #    </note>
     #
@@ -5437,12 +5342,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_snapshot
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBSnapshot
-    #
-    #   * DeleteDBSnapshot
+    #   Contains the details of an Amazon RDS DB snapshot.
     #
     #   This data type is used as a response element in the
     #   DescribeDBSnapshots action.
@@ -5465,7 +5365,7 @@ module Aws::RDS
     # @!attribute [rw] db_subnet_group_name
     #   The name of the database subnet group to delete.
     #
-    #   <note markdown="1"> You cannot delete the default subnet group.
+    #   <note markdown="1"> You can't delete the default subnet group.
     #
     #    </note>
     #
@@ -5525,7 +5425,7 @@ module Aws::RDS
     # @!attribute [rw] option_group_name
     #   The name of the option group to be deleted.
     #
-    #   <note markdown="1"> You cannot delete default option groups.
+    #   <note markdown="1"> You can't delete default option groups.
     #
     #    </note>
     #   @return [String]
@@ -5784,7 +5684,7 @@ module Aws::RDS
     #
     # @!attribute [rw] db_cluster_identifier
     #   The ID of the DB cluster to retrieve the list of DB cluster
-    #   snapshots for. This parameter cannot be used in conjunction with the
+    #   snapshots for. This parameter can't be used in conjunction with the
     #   `DBClusterSnapshotIdentifier` parameter. This parameter is not
     #   case-sensitive.
     #
@@ -5797,7 +5697,7 @@ module Aws::RDS
     #
     # @!attribute [rw] db_cluster_snapshot_identifier
     #   A specific DB cluster snapshot identifier to describe. This
-    #   parameter cannot be used in conjunction with the
+    #   parameter can't be used in conjunction with the
     #   `DBClusterIdentifier` parameter. This value is stored as a lowercase
     #   string.
     #
@@ -5863,10 +5763,9 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] include_shared
-    #   Set this value to `true` to include shared manual DB cluster
-    #   snapshots from other AWS accounts that this AWS account has been
-    #   given permission to copy or restore, otherwise set this value to
-    #   `false`. The default is `false`.
+    #   True to include shared manual DB cluster snapshots from other AWS
+    #   accounts that this AWS account has been given permission to copy or
+    #   restore, and otherwise false. The default is `false`.
     #
     #   You can give an AWS account permission to restore a manual DB
     #   cluster snapshot from another AWS account by the
@@ -5874,10 +5773,9 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] include_public
-    #   Set this value to `true` to include manual DB cluster snapshots that
-    #   are public and can be copied or restored by any AWS account,
-    #   otherwise set this value to `false`. The default is `false`. The
-    #   default is false.
+    #   True to include manual DB cluster snapshots that are public and can
+    #   be copied or restored by any AWS account, and otherwise false. The
+    #   default is `false`. The default is false.
     #
     #   You can share a manual DB cluster snapshot as public by using the
     #   ModifyDBClusterSnapshotAttribute API action.
@@ -6092,7 +5990,7 @@ module Aws::RDS
     #
     #   * `db-cluster-id` - Accepts DB cluster identifiers and DB cluster
     #     Amazon Resource Names (ARNs). The results list will only include
-    #     information about the DB instances associated with the DB Clusters
+    #     information about the DB instances associated with the DB clusters
     #     identified by these ARNs.
     #
     #   * `db-instance-id` - Accepts DB instance identifiers and DB instance
@@ -6475,7 +6373,7 @@ module Aws::RDS
     #
     # @!attribute [rw] db_instance_identifier
     #   The ID of the DB instance to retrieve the list of DB snapshots for.
-    #   This parameter cannot be used in conjunction with
+    #   This parameter can't be used in conjunction with
     #   `DBSnapshotIdentifier`. This parameter is not case-sensitive.
     #
     #   Constraints:
@@ -6486,7 +6384,7 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] db_snapshot_identifier
-    #   A specific DB snapshot identifier to describe. This parameter cannot
+    #   A specific DB snapshot identifier to describe. This parameter can't
     #   be used in conjunction with `DBInstanceIdentifier`. This value is
     #   stored as a lowercase string.
     #
@@ -6551,10 +6449,9 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] include_shared
-    #   Set this value to `true` to include shared manual DB snapshots from
-    #   other AWS accounts that this AWS account has been given permission
-    #   to copy or restore, otherwise set this value to `false`. The default
-    #   is `false`.
+    #   True to include shared manual DB snapshots from other AWS accounts
+    #   that this AWS account has been given permission to copy or restore,
+    #   and otherwise false. The default is `false`.
     #
     #   You can give an AWS account permission to restore a manual DB
     #   snapshot from another AWS account by using the
@@ -6562,9 +6459,9 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] include_public
-    #   Set this value to `true` to include manual DB snapshots that are
-    #   public and can be copied or restored by any AWS account, otherwise
-    #   set this value to `false`. The default is `false`.
+    #   True to include manual DB snapshots that are public and can be
+    #   copied or restored by any AWS account, and otherwise false. The
+    #   default is false.
     #
     #   You can share a manual DB snapshot as public by using the
     #   ModifyDBSnapshotAttribute API.
@@ -7974,20 +7871,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBCluster
-    #
-    #   * DeleteDBCluster
-    #
-    #   * FailoverDBCluster
-    #
-    #   * ModifyDBCluster
-    #
-    #   * RestoreDBClusterFromSnapshot
-    #
-    #   * RestoreDBClusterToPointInTime
+    #   Contains the details of an Amazon RDS DB cluster.
     #
     #   This data type is used as a response element in the
     #   DescribeDBClusters action.
@@ -8191,8 +8075,8 @@ module Aws::RDS
     #   brief (sub-second) period during which new connections are rejected
     #   but existing connections are not interrupted.
     #
-    #   Permanent options cannot be removed from an option group. The option
-    #   group cannot be removed from a DB cluster once it is associated with
+    #   Permanent options can't be removed from an option group. The option
+    #   group can't be removed from a DB cluster once it is associated with
     #   a DB cluster.
     #   @return [String]
     #
@@ -8201,16 +8085,16 @@ module Aws::RDS
     #   automated backups are enabled, using the `BackupRetentionPeriod`
     #   parameter.
     #
-    #   Default: A 30-minute window selected at random from an 8-hour block
-    #   of time per AWS Region. To see the time blocks available, see [
-    #   Adjusting the Preferred Maintenance Window][1] in the *Amazon RDS
-    #   User Guide.*
+    #   The default is a 30-minute window selected at random from an 8-hour
+    #   block of time for each AWS Region. To see the time blocks available,
+    #   see [ Adjusting the Preferred Maintenance Window][1] in the *Amazon
+    #   RDS User Guide.*
     #
     #   Constraints:
     #
     #   * Must be in the format `hh24:mi-hh24:mi`.
     #
-    #   * Times should be in Universal Coordinated Time (UTC).
+    #   * Must be in Universal Coordinated Time (UTC).
     #
     #   * Must not conflict with the preferred maintenance window.
     #
@@ -8227,12 +8111,12 @@ module Aws::RDS
     #
     #   Format: `ddd:hh24:mi-ddd:hh24:mi`
     #
-    #   Default: A 30-minute window selected at random from an 8-hour block
-    #   of time per AWS Region, occurring on a random day of the week. To
-    #   see the time blocks available, see [ Adjusting the Preferred
-    #   Maintenance Window][1] in the *Amazon RDS User Guide.*
+    #   The default is a 30-minute window selected at random from an 8-hour
+    #   block of time for each AWS Region, occurring on a random day of the
+    #   week. To see the time blocks available, see [ Adjusting the
+    #   Preferred Maintenance Window][1] in the *Amazon RDS User Guide.*
     #
-    #   Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
+    #   Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.
     #
     #   Constraints: Minimum 30-minute window.
     #
@@ -8242,9 +8126,8 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] enable_iam_database_authentication
-    #   A Boolean value that is true to enable mapping of AWS Identity and
-    #   Access Management (IAM) accounts to database accounts, and otherwise
-    #   false.
+    #   True to enable mapping of AWS Identity and Access Management (IAM)
+    #   accounts to database accounts, and otherwise false.
     #
     #   Default: `false`
     #   @return [Boolean]
@@ -8305,20 +8188,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBCluster
-    #
-    #   * DeleteDBCluster
-    #
-    #   * FailoverDBCluster
-    #
-    #   * ModifyDBCluster
-    #
-    #   * RestoreDBClusterFromSnapshot
-    #
-    #   * RestoreDBClusterToPointInTime
+    #   Contains the details of an Amazon RDS DB cluster.
     #
     #   This data type is used as a response element in the
     #   DescribeDBClusters action.
@@ -8536,8 +8406,8 @@ module Aws::RDS
     #
     # @!attribute [rw] db_instance_class
     #   The new compute and memory capacity of the DB instance, for example,
-    #   `db.m4.large`. Not all DB instance classes are available in all
-    #   regions, or for all database engines. For the full list of DB
+    #   `db.m4.large`. Not all DB instance classes are available in all AWS
+    #   Regions, or for all database engines. For the full list of DB
     #   instance classes, and availability for your engine, see [DB Instance
     #   Class][1] in the Amazon RDS User Guide.
     #
@@ -8625,8 +8495,8 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] master_user_password
-    #   The new password for the master user. Can be any printable ASCII
-    #   character except "/", """, or "@".
+    #   The new password for the master user. The password can include any
+    #   printable ASCII character except "/", """, or "@".
     #
     #   Changing this parameter does not result in an outage and the change
     #   is asynchronously applied as soon as possible. Between the time of
@@ -8734,7 +8604,7 @@ module Aws::RDS
     #
     #   * Must be in the format hh24:mi-hh24:mi
     #
-    #   * Times should be in Universal Time Coordinated (UTC)
+    #   * Must be in Universal Time Coordinated (UTC)
     #
     #   * Must not conflict with the preferred maintenance window
     #
@@ -8863,8 +8733,8 @@ module Aws::RDS
     #   but existing connections are not interrupted.
     #
     #   Permanent options, such as the TDE option for Oracle Advanced
-    #   Security TDE, cannot be removed from an option group, and that
-    #   option group cannot be removed from a DB instance once it is
+    #   Security TDE, can't be removed from an option group, and that
+    #   option group can't be removed from a DB instance once it is
     #   associated with a DB instance
     #   @return [String]
     #
@@ -8894,17 +8764,17 @@ module Aws::RDS
     #   If you specify `io1`, you must also include a value for the `Iops`
     #   parameter.
     #
-    #   Default: `io1` if the `Iops` parameter is specified; otherwise
+    #   Default: `io1` if the `Iops` parameter is specified, otherwise
     #   `standard`
     #   @return [String]
     #
     # @!attribute [rw] tde_credential_arn
-    #   The ARN from the Key Store with which to associate the instance for
+    #   The ARN from the key store with which to associate the instance for
     #   TDE encryption.
     #   @return [String]
     #
     # @!attribute [rw] tde_credential_password
-    #   The password for the given ARN from the Key Store in order to access
+    #   The password for the given ARN from the key store in order to access
     #   the device.
     #   @return [String]
     #
@@ -8922,7 +8792,7 @@ module Aws::RDS
     #
     # @!attribute [rw] copy_tags_to_snapshot
     #   True to copy all tags from the DB instance to snapshots of the DB
-    #   instance; otherwise false. The default is false.
+    #   instance, and otherwise false. The default is false.
     #   @return [Boolean]
     #
     # @!attribute [rw] monitoring_interval
@@ -9006,7 +8876,7 @@ module Aws::RDS
     #
     # @!attribute [rw] monitoring_role_arn
     #   The ARN for the IAM role that permits RDS to send enhanced
-    #   monitoring metrics to CloudWatch Logs. For example,
+    #   monitoring metrics to Amazon CloudWatch Logs. For example,
     #   `arn:aws:iam:123456789012:role/emaccess`. For information on
     #   creating a monitoring role, go to [To create an IAM role for Amazon
     #   RDS Enhanced Monitoring][1].
@@ -9041,7 +8911,7 @@ module Aws::RDS
     #
     # @!attribute [rw] enable_iam_database_authentication
     #   True to enable mapping of AWS Identity and Access Management (IAM)
-    #   accounts to database accounts; otherwise false.
+    #   accounts to database accounts, and otherwise false.
     #
     #   You can enable IAM database authentication for the following
     #   database engines
@@ -9062,13 +8932,13 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] enable_performance_insights
-    #   True to enable Performance Insights for the DB instance; otherwise
-    #   false.
+    #   True to enable Performance Insights for the DB instance, and
+    #   otherwise false.
     #   @return [Boolean]
     #
     # @!attribute [rw] performance_insights_kms_key_id
-    #   The KMS key identifier for encryption of Performance Insights data.
-    #   The KMS key ID is the Amazon Resource Name (ARN), KMS key
+    #   The AWS KMS key identifier for encryption of Performance Insights
+    #   data. The KMS key ID is the Amazon Resource Name (ARN), KMS key
     #   identifier, or the KMS key alias for the KMS encryption key.
     #   @return [String]
     #
@@ -9114,18 +8984,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_instance
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBInstance
-    #
-    #   * DeleteDBInstance
-    #
-    #   * ModifyDBInstance
-    #
-    #   * StopDBInstance
-    #
-    #   * StartDBInstance
+    #   Contains the details of an Amazon RDS DB instance.
     #
     #   This data type is used as a response element in the
     #   DescribeDBInstances action.
@@ -9322,12 +9181,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_snapshot
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBSnapshot
-    #
-    #   * DeleteDBSnapshot
+    #   Contains the details of an Amazon RDS DB snapshot.
     #
     #   This data type is used as a response element in the
     #   DescribeDBSnapshots action.
@@ -9377,16 +9231,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_subnet_group
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBSubnetGroup
-    #
-    #   * ModifyDBSubnetGroup
-    #
-    #   * DescribeDBSubnetGroups
-    #
-    #   * DeleteDBSubnetGroup
+    #   Contains the details of an Amazon RDS DB subnet group.
     #
     #   This data type is used as a response element in the
     #   DescribeDBSubnetGroups action.
@@ -9503,8 +9348,8 @@ module Aws::RDS
     #   The name of the option group to be modified.
     #
     #   Permanent options, such as the TDE option for Oracle Advanced
-    #   Security TDE, cannot be removed from an option group, and that
-    #   option group cannot be removed from a DB instance once it is
+    #   Security TDE, can't be removed from an option group, and that
+    #   option group can't be removed from a DB instance once it is
     #   associated with a DB instance
     #   @return [String]
     #
@@ -10001,8 +9846,8 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] is_default
-    #   True if the version is the default version of the option; otherwise,
-    #   false.
+    #   True if the version is the default version of the option, and
+    #   otherwise false.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/OptionVersion AWS API Documentation
@@ -10415,20 +10260,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBCluster
-    #
-    #   * DeleteDBCluster
-    #
-    #   * FailoverDBCluster
-    #
-    #   * ModifyDBCluster
-    #
-    #   * RestoreDBClusterFromSnapshot
-    #
-    #   * RestoreDBClusterToPointInTime
+    #   Contains the details of an Amazon RDS DB cluster.
     #
     #   This data type is used as a response element in the
     #   DescribeDBClusters action.
@@ -10482,16 +10314,16 @@ module Aws::RDS
     #   automated backups are enabled, using the `BackupRetentionPeriod`
     #   parameter.
     #
-    #   Default: A 30-minute window selected at random from an 8-hour block
-    #   of time per AWS Region. To see the time blocks available, see [
-    #   Adjusting the Preferred Maintenance Window][1] in the *Amazon RDS
-    #   User Guide.*
+    #   The default is a 30-minute window selected at random from an 8-hour
+    #   block of time for each AWS Region. To see the time blocks available,
+    #   see [ Adjusting the Preferred Maintenance Window][1] in the *Amazon
+    #   RDS User Guide.*
     #
     #   Constraints:
     #
     #   * Must be in the format `hh24:mi-hh24:mi`.
     #
-    #   * Times should be in Universal Coordinated Time (UTC).
+    #   * Must be in Universal Coordinated Time (UTC).
     #
     #   * Must not conflict with the preferred maintenance window.
     #
@@ -10512,18 +10344,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_instance
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBInstance
-    #
-    #   * DeleteDBInstance
-    #
-    #   * ModifyDBInstance
-    #
-    #   * StopDBInstance
-    #
-    #   * StartDBInstance
+    #   Contains the details of an Amazon RDS DB instance.
     #
     #   This data type is used as a response element in the
     #   DescribeDBInstances action.
@@ -10570,7 +10391,12 @@ module Aws::RDS
     #   @return [Integer]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://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/PurchaseReservedDBInstancesOfferingMessage AWS API Documentation
@@ -10645,7 +10471,7 @@ module Aws::RDS
     # @!attribute [rw] force_failover
     #   When `true`, the reboot is conducted through a MultiAZ failover.
     #
-    #   Constraint: You cannot specify `true` if the instance is not
+    #   Constraint: You can't specify `true` if the instance is not
     #   configured for MultiAZ.
     #   @return [Boolean]
     #
@@ -10658,18 +10484,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_instance
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBInstance
-    #
-    #   * DeleteDBInstance
-    #
-    #   * ModifyDBInstance
-    #
-    #   * StopDBInstance
-    #
-    #   * StartDBInstance
+    #   Contains the details of an Amazon RDS DB instance.
     #
     #   This data type is used as a response element in the
     #   DescribeDBInstances action.
@@ -11012,13 +10827,13 @@ module Aws::RDS
     # @!attribute [rw] reset_all_parameters
     #   A value that is set to `true` to reset all parameters in the DB
     #   cluster parameter group to their default values, and `false`
-    #   otherwise. You cannot use this parameter if there is a list of
+    #   otherwise. You can't use this parameter if there is a list of
     #   parameter names specified for the `Parameters` parameter.
     #   @return [Boolean]
     #
     # @!attribute [rw] parameters
     #   A list of parameter names in the DB cluster parameter group to reset
-    #   to the default values. You cannot use this parameter if the
+    #   to the default values. You can't use this parameter if the
     #   `ResetAllParameters` parameter is set to `true`.
     #   @return [Array<Types::Parameter>]
     #
@@ -11190,8 +11005,8 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] db_cluster_identifier
-    #   The name of the DB cluster to create from the source data in the S3
-    #   bucket. This parameter is isn't case-sensitive.
+    #   The name of the DB cluster to create from the source data in the
+    #   Amazon S3 bucket. This parameter is isn't case-sensitive.
     #
     #   Constraints:
     #
@@ -11235,7 +11050,7 @@ module Aws::RDS
     #   The name of the database engine to be used for the restored DB
     #   cluster.
     #
-    #   Valid Values: `aurora`
+    #   Valid Values: `aurora`, `aurora-postgresql`
     #   @return [String]
     #
     # @!attribute [rw] engine_version
@@ -11276,8 +11091,8 @@ module Aws::RDS
     #   A value that indicates that the restored DB cluster should be
     #   associated with the specified option group.
     #
-    #   Permanent options cannot be removed from an option group. An option
-    #   group cannot be removed from a DB cluster once it is associated with
+    #   Permanent options can't be removed from an option group. An option
+    #   group can't be removed from a DB cluster once it is associated with
     #   a DB cluster.
     #   @return [String]
     #
@@ -11286,16 +11101,16 @@ module Aws::RDS
     #   automated backups are enabled using the `BackupRetentionPeriod`
     #   parameter.
     #
-    #   Default: A 30-minute window selected at random from an 8-hour block
-    #   of time per AWS Region. To see the time blocks available, see [
-    #   Adjusting the Preferred Maintenance Window][1] in the *Amazon RDS
-    #   User Guide.*
+    #   The default is a 30-minute window selected at random from an 8-hour
+    #   block of time for each AWS Region. To see the time blocks available,
+    #   see [ Adjusting the Preferred Maintenance Window][1] in the *Amazon
+    #   RDS User Guide.*
     #
     #   Constraints:
     #
     #   * Must be in the format `hh24:mi-hh24:mi`.
     #
-    #   * Times should be in Universal Coordinated Time (UTC).
+    #   * Must be in Universal Coordinated Time (UTC).
     #
     #   * Must not conflict with the preferred maintenance window.
     #
@@ -11312,12 +11127,12 @@ module Aws::RDS
     #
     #   Format: `ddd:hh24:mi-ddd:hh24:mi`
     #
-    #   Default: A 30-minute window selected at random from an 8-hour block
-    #   of time per AWS Region, occurring on a random day of the week. To
-    #   see the time blocks available, see [ Adjusting the Preferred
-    #   Maintenance Window][1] in the *Amazon RDS User Guide.*
+    #   The default is a 30-minute window selected at random from an 8-hour
+    #   block of time for each AWS Region, occurring on a random day of the
+    #   week. To see the time blocks available, see [ Adjusting the
+    #   Preferred Maintenance Window][1] in the *Amazon RDS User Guide.*
     #
-    #   Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
+    #   Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.
     #
     #   Constraints: Minimum 30-minute window.
     #
@@ -11327,7 +11142,12 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] storage_encrypted
@@ -11335,7 +11155,7 @@ module Aws::RDS
     #   @return [Boolean]
     #
     # @!attribute [rw] kms_key_id
-    #   The KMS key identifier for an encrypted DB cluster.
+    #   The AWS KMS key identifier for an encrypted DB cluster.
     #
     #   The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
     #   encryption key. If you are creating a DB cluster with the same AWS
@@ -11351,9 +11171,8 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] enable_iam_database_authentication
-    #   A Boolean value that is true to enable mapping of AWS Identity and
-    #   Access Management (IAM) accounts to database accounts, and otherwise
-    #   false.
+    #   True to enable mapping of AWS Identity and Access Management (IAM)
+    #   accounts to database accounts, and otherwise false.
     #
     #   Default: `false`
     #   @return [Boolean]
@@ -11423,20 +11242,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBCluster
-    #
-    #   * DeleteDBCluster
-    #
-    #   * FailoverDBCluster
-    #
-    #   * ModifyDBCluster
-    #
-    #   * RestoreDBClusterFromSnapshot
-    #
-    #   * RestoreDBClusterToPointInTime
+    #   Contains the details of an Amazon RDS DB cluster.
     #
     #   This data type is used as a response element in the
     #   DescribeDBClusters action.
@@ -11555,8 +11361,8 @@ module Aws::RDS
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] kms_key_id
-    #   The KMS key identifier to use when restoring an encrypted DB cluster
-    #   from a DB snapshot or DB cluster snapshot.
+    #   The AWS KMS key identifier to use when restoring an encrypted DB
+    #   cluster from a DB snapshot or DB cluster snapshot.
     #
     #   The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
     #   encryption key. If you are restoring a DB cluster with the same AWS
@@ -11577,9 +11383,8 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] enable_iam_database_authentication
-    #   A Boolean value that is true to enable mapping of AWS Identity and
-    #   Access Management (IAM) accounts to database accounts, and otherwise
-    #   false.
+    #   True to enable mapping of AWS Identity and Access Management (IAM)
+    #   accounts to database accounts, and otherwise false.
     #
     #   Default: `false`
     #   @return [Boolean]
@@ -11604,20 +11409,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBCluster
-    #
-    #   * DeleteDBCluster
-    #
-    #   * FailoverDBCluster
-    #
-    #   * ModifyDBCluster
-    #
-    #   * RestoreDBClusterFromSnapshot
-    #
-    #   * RestoreDBClusterToPointInTime
+    #   Contains the details of an Amazon RDS DB cluster.
     #
     #   This data type is used as a response element in the
     #   DescribeDBClusters action.
@@ -11675,7 +11467,7 @@ module Aws::RDS
     #   * `copy-on-write` - The new DB cluster is restored as a clone of the
     #     source DB cluster.
     #
-    #   Constraints: You cannot specify `copy-on-write` if the engine
+    #   Constraints: You can't specify `copy-on-write` if the engine
     #   version of the source DB cluster is earlier than 1.11.
     #
     #   If you don't specify a `RestoreType` value, then the new DB cluster
@@ -11748,12 +11540,17 @@ module Aws::RDS
     #   @return [Array<String>]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] kms_key_id
-    #   The KMS key identifier to use when restoring an encrypted DB cluster
-    #   from an encrypted DB cluster.
+    #   The AWS KMS key identifier to use when restoring an encrypted DB
+    #   cluster from an encrypted DB cluster.
     #
     #   The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
     #   encryption key. If you are restoring a DB cluster with the same AWS
@@ -11781,9 +11578,8 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] enable_iam_database_authentication
-    #   A Boolean value that is true to enable mapping of AWS Identity and
-    #   Access Management (IAM) accounts to database accounts, and otherwise
-    #   false.
+    #   True to enable mapping of AWS Identity and Access Management (IAM)
+    #   accounts to database accounts, and otherwise false.
     #
     #   Default: `false`
     #   @return [Boolean]
@@ -11807,20 +11603,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_cluster
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBCluster
-    #
-    #   * DeleteDBCluster
-    #
-    #   * FailoverDBCluster
-    #
-    #   * ModifyDBCluster
-    #
-    #   * RestoreDBClusterFromSnapshot
-    #
-    #   * RestoreDBClusterToPointInTime
+    #   Contains the details of an Amazon RDS DB cluster.
     #
     #   This data type is used as a response element in the
     #   DescribeDBClusters action.
@@ -11895,9 +11678,9 @@ module Aws::RDS
     # @!attribute [rw] db_instance_class
     #   The compute and memory capacity of the Amazon RDS DB instance, for
     #   example, `db.m4.large`. Not all DB instance classes are available in
-    #   all regions, or for all database engines. For the full list of DB
-    #   instance classes, and availability for your engine, see [DB Instance
-    #   Class][1] in the Amazon RDS User Guide.
+    #   all AWS Regions, or for all database engines. For the full list of
+    #   DB instance classes, and availability for your engine, see [DB
+    #   Instance Class][1] in the Amazon RDS User Guide.
     #
     #   Default: The same DBInstanceClass as the original DB instance.
     #
@@ -11915,11 +11698,11 @@ module Aws::RDS
     #   @return [Integer]
     #
     # @!attribute [rw] availability_zone
-    #   The EC2 Availability Zone that the database instance is created in.
+    #   The EC2 Availability Zone that the DB instance is created in.
     #
     #   Default: A random, system-chosen Availability Zone.
     #
-    #   Constraint: You cannot specify the AvailabilityZone parameter if the
+    #   Constraint: You can't specify the AvailabilityZone parameter if the
     #   MultiAZ parameter is set to `true`.
     #
     #   Example: `us-east-1a`
@@ -11937,7 +11720,7 @@ module Aws::RDS
     # @!attribute [rw] multi_az
     #   Specifies if the DB instance is a Multi-AZ deployment.
     #
-    #   Constraint: You cannot specify the AvailabilityZone parameter if the
+    #   Constraint: You can't specify the AvailabilityZone parameter if the
     #   MultiAZ parameter is set to `true`.
     #   @return [Boolean]
     #
@@ -11998,6 +11781,8 @@ module Aws::RDS
     #
     #   * `aurora`
     #
+    #   * `aurora-postgresql`
+    #
     #   * `mariadb`
     #
     #   * `mysql`
@@ -12045,13 +11830,18 @@ module Aws::RDS
     #   instance.
     #
     #   Permanent options, such as the TDE option for Oracle Advanced
-    #   Security TDE, cannot be removed from an option group, and that
-    #   option group cannot be removed from a DB instance once it is
+    #   Security TDE, can't be removed from an option group, and that
+    #   option group can't be removed from a DB instance once it is
     #   associated with a DB instance
     #   @return [String]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] storage_type
@@ -12062,17 +11852,17 @@ module Aws::RDS
     #   If you specify `io1`, you must also include a value for the `Iops`
     #   parameter.
     #
-    #   Default: `io1` if the `Iops` parameter is specified; otherwise
+    #   Default: `io1` if the `Iops` parameter is specified, otherwise
     #   `standard`
     #   @return [String]
     #
     # @!attribute [rw] tde_credential_arn
-    #   The ARN from the Key Store with which to associate the instance for
+    #   The ARN from the key store with which to associate the instance for
     #   TDE encryption.
     #   @return [String]
     #
     # @!attribute [rw] tde_credential_password
-    #   The password for the given ARN from the Key Store in order to access
+    #   The password for the given ARN from the key store in order to access
     #   the device.
     #   @return [String]
     #
@@ -12082,7 +11872,7 @@ module Aws::RDS
     #
     # @!attribute [rw] copy_tags_to_snapshot
     #   True to copy all tags from the restored DB instance to snapshots of
-    #   the DB instance; otherwise false. The default is false.
+    #   the DB instance, and otherwise false. The default is false.
     #   @return [Boolean]
     #
     # @!attribute [rw] domain_iam_role_name
@@ -12092,7 +11882,7 @@ module Aws::RDS
     #
     # @!attribute [rw] enable_iam_database_authentication
     #   True to enable mapping of AWS Identity and Access Management (IAM)
-    #   accounts to database accounts; otherwise false.
+    #   accounts to database accounts, and otherwise false.
     #
     #   You can enable IAM database authentication for the following
     #   database engines
@@ -12135,26 +11925,458 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_instance
-    #   Contains the result of a successful invocation of the following
-    #   actions:
+    #   Contains the details of an Amazon RDS DB instance.
     #
-    #   * CreateDBInstance
+    #   This data type is used as a response element in the
+    #   DescribeDBInstances action.
+    #   @return [Types::DBInstance]
     #
-    #   * DeleteDBInstance
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshotResult AWS API Documentation
     #
-    #   * ModifyDBInstance
+    class RestoreDBInstanceFromDBSnapshotResult < Struct.new(
+      :db_instance)
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass RestoreDBInstanceFromS3Message
+    #   data as a hash:
+    #
+    #       {
+    #         db_name: "String",
+    #         db_instance_identifier: "String", # required
+    #         allocated_storage: 1,
+    #         db_instance_class: "String", # required
+    #         engine: "String", # required
+    #         master_username: "String",
+    #         master_user_password: "String",
+    #         db_security_groups: ["String"],
+    #         vpc_security_group_ids: ["String"],
+    #         availability_zone: "String",
+    #         db_subnet_group_name: "String",
+    #         preferred_maintenance_window: "String",
+    #         db_parameter_group_name: "String",
+    #         backup_retention_period: 1,
+    #         preferred_backup_window: "String",
+    #         port: 1,
+    #         multi_az: false,
+    #         engine_version: "String",
+    #         auto_minor_version_upgrade: false,
+    #         license_model: "String",
+    #         iops: 1,
+    #         option_group_name: "String",
+    #         publicly_accessible: false,
+    #         tags: [
+    #           {
+    #             key: "String",
+    #             value: "String",
+    #           },
+    #         ],
+    #         storage_type: "String",
+    #         storage_encrypted: false,
+    #         kms_key_id: "String",
+    #         copy_tags_to_snapshot: false,
+    #         monitoring_interval: 1,
+    #         monitoring_role_arn: "String",
+    #         enable_iam_database_authentication: false,
+    #         source_engine: "String", # required
+    #         source_engine_version: "String", # required
+    #         s3_bucket_name: "String", # required
+    #         s3_prefix: "String",
+    #         s3_ingestion_role_arn: "String", # required
+    #         enable_performance_insights: false,
+    #         performance_insights_kms_key_id: "String",
+    #       }
+    #
+    # @!attribute [rw] db_name
+    #   The name of the database to create when the DB instance is created.
+    #   Follow the naming rules specified in CreateDBInstance.
+    #   @return [String]
+    #
+    # @!attribute [rw] db_instance_identifier
+    #   The DB instance identifier. This parameter is stored as a lowercase
+    #   string.
+    #
+    #   Constraints:
+    #
+    #   * Must contain from 1 to 63 letters, numbers, or hyphens.
+    #
+    #   * First character must be a letter.
+    #
+    #   * Cannot end with a hyphen or contain two consecutive hyphens.
+    #
+    #   Example: `mydbinstance`
+    #   @return [String]
+    #
+    # @!attribute [rw] allocated_storage
+    #   The amount of storage (in gigabytes) to allocate initially for the
+    #   DB instance. Follow the allocation rules specified in
+    #   CreateDBInstance.
+    #
+    #   <note markdown="1"> Be sure to allocate enough memory for your new DB instance so that
+    #   the restore operation can succeed. You can also allocate additional
+    #   memory for future growth.
+    #
+    #    </note>
+    #   @return [Integer]
+    #
+    # @!attribute [rw] db_instance_class
+    #   The compute and memory capacity of the DB instance, for example,
+    #   `db.m4.large`. Not all DB instance classes are available in all AWS
+    #   Regions, or for all database engines. For the full list of DB
+    #   instance classes, and availability for your engine, see [DB Instance
+    #   Class][1] in the Amazon RDS User Guide.
+    #
+    #   Importing from Amazon S3 is not supported on the db.t2.micro DB
+    #   instance class.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
+    #   @return [String]
+    #
+    # @!attribute [rw] engine
+    #   The name of the database engine to be used for this instance.
+    #
+    #   Valid Values: `mysql`
+    #   @return [String]
+    #
+    # @!attribute [rw] master_username
+    #   The name for the master user.
+    #
+    #   Constraints:
+    #
+    #   * Must be 1 to 16 letters or numbers.
+    #
+    #   * First character must be a letter.
+    #
+    #   * Cannot be a reserved word for the chosen database engine.
+    #   @return [String]
+    #
+    # @!attribute [rw] master_user_password
+    #   The password for the master user. The password can include any
+    #   printable ASCII character except "/", """, or "@".
+    #
+    #   Constraints: Must contain from 8 to 41 characters.
+    #   @return [String]
+    #
+    # @!attribute [rw] db_security_groups
+    #   A list of DB security groups to associate with this DB instance.
+    #
+    #   Default: The default DB security group for the database engine.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] vpc_security_group_ids
+    #   A list of VPC security groups to associate with this DB instance.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] availability_zone
+    #   The Availability Zone that the DB instance is created in. For
+    #   information about AWS Regions and Availability Zones, see [Regions
+    #   and Availability Zones][1].
+    #
+    #   Default: A random, system-chosen Availability Zone in the
+    #   endpoint's AWS Region.
+    #
+    #   Example: `us-east-1d`
+    #
+    #   Constraint: The AvailabilityZone parameter can't be specified if
+    #   the MultiAZ parameter is set to `true`. The specified Availability
+    #   Zone must be in the same AWS Region as the current endpoint.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html
+    #   @return [String]
+    #
+    # @!attribute [rw] db_subnet_group_name
+    #   A DB subnet group to associate with this DB instance.
+    #   @return [String]
+    #
+    # @!attribute [rw] preferred_maintenance_window
+    #   The time range each week during which system maintenance can occur,
+    #   in Universal Coordinated Time (UTC). For more information, see
+    #   [Amazon RDS Maintenance Window][1].
+    #
+    #   Constraints:
+    #
+    #   * Must be in the format `ddd:hh24:mi-ddd:hh24:mi`.
     #
-    #   * StopDBInstance
+    #   * Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun.
     #
-    #   * StartDBInstance
+    #   * Must be in Universal Coordinated Time (UTC).
+    #
+    #   * Must not conflict with the preferred backup window.
+    #
+    #   * Must be at least 30 minutes.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
+    #   @return [String]
+    #
+    # @!attribute [rw] db_parameter_group_name
+    #   The name of the DB parameter group to associate with this DB
+    #   instance. If this argument is omitted, the default parameter group
+    #   for the specified engine is used.
+    #   @return [String]
+    #
+    # @!attribute [rw] backup_retention_period
+    #   The number of days for which automated backups are retained. Setting
+    #   this parameter to a positive number enables backups. For more
+    #   information, see CreateDBInstance.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] preferred_backup_window
+    #   The time range each day during which automated backups are created
+    #   if automated backups are enabled. For more information, see [The
+    #   Backup Window][1].
+    #
+    #   Constraints:
+    #
+    #   * Must be in the format `hh24:mi-hh24:mi`.
+    #
+    #   * Must be in Universal Coordinated Time (UTC).
+    #
+    #   * Must not conflict with the preferred maintenance window.
+    #
+    #   * Must be at least 30 minutes.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithAutomatedBackups.html#USER_WorkingWithAutomatedBackups.BackupWindow
+    #   @return [String]
+    #
+    # @!attribute [rw] port
+    #   The port number on which the database accepts connections.
+    #
+    #   Type: Integer
+    #
+    #   Valid Values: `1150`-`65535`
+    #
+    #   Default: `3306`
+    #   @return [Integer]
+    #
+    # @!attribute [rw] multi_az
+    #   Specifies whether the DB instance is a Multi-AZ deployment. If
+    #   MultiAZ is set to `true`, you can't set the AvailabilityZone
+    #   parameter.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] engine_version
+    #   The version number of the database engine to use. Choose the latest
+    #   minor version of your database engine as specified in
+    #   CreateDBInstance.
+    #   @return [String]
+    #
+    # @!attribute [rw] auto_minor_version_upgrade
+    #   True to indicate that minor engine upgrades are applied
+    #   automatically to the DB instance during the maintenance window, and
+    #   otherwise false.
+    #
+    #   Default: `true`
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] license_model
+    #   The license model for this DB instance. Use
+    #   `general-public-license`.
+    #   @return [String]
+    #
+    # @!attribute [rw] iops
+    #   The amount of Provisioned IOPS (input/output operations per second)
+    #   to allocate initially for the DB instance. For information about
+    #   valid Iops values, see see [Amazon RDS Provisioned IOPS Storage to
+    #   Improve Performance][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
+    #   @return [Integer]
+    #
+    # @!attribute [rw] option_group_name
+    #   The name of the option group to associate with this DB instance. If
+    #   this argument is omitted, the default option group for the specified
+    #   engine is used.
+    #   @return [String]
+    #
+    # @!attribute [rw] publicly_accessible
+    #   Specifies whether the DB instance is publicly accessible or not. For
+    #   more information, see CreateDBInstance.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] tags
+    #   A list of tags to associate with this DB instance. For more
+    #   information, see [Tagging Amazon RDS Resources][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
+    #   @return [Array<Types::Tag>]
+    #
+    # @!attribute [rw] storage_type
+    #   Specifies the storage type to be associated with the DB instance.
+    #
+    #   Valid values: `standard` \| `gp2` \| `io1`
+    #
+    #   If you specify `io1`, you must also include a value for the `Iops`
+    #   parameter.
+    #
+    #   Default: `io1` if the `Iops` parameter is specified; otherwise
+    #   `standard`
+    #   @return [String]
+    #
+    # @!attribute [rw] storage_encrypted
+    #   Specifies whether the new DB instance is encrypted or not.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] kms_key_id
+    #   The AWS KMS key identifier for an encrypted DB instance.
+    #
+    #   The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
+    #   encryption key. If you are creating a DB instance with the same AWS
+    #   account that owns the KMS encryption key used to encrypt the new DB
+    #   instance, then you can use the KMS key alias instead of the ARN for
+    #   the KM encryption key.
+    #
+    #   If the `StorageEncrypted` parameter is true, and you do not specify
+    #   a value for the `KmsKeyId` parameter, then Amazon RDS will use your
+    #   default encryption key. AWS KMS creates the default encryption key
+    #   for your AWS account. Your AWS account has a different default
+    #   encryption key for each AWS Region.
+    #   @return [String]
+    #
+    # @!attribute [rw] copy_tags_to_snapshot
+    #   True to copy all tags from the DB instance to snapshots of the DB
+    #   instance, and otherwise false.
+    #
+    #   Default: false.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] monitoring_interval
+    #   The interval, in seconds, between points when Enhanced Monitoring
+    #   metrics are collected for the DB instance. To disable collecting
+    #   Enhanced Monitoring metrics, specify 0.
+    #
+    #   If `MonitoringRoleArn` is specified, then you must also set
+    #   `MonitoringInterval` to a value other than 0.
+    #
+    #   Valid Values: 0, 1, 5, 10, 15, 30, 60
+    #
+    #   Default: `0`
+    #   @return [Integer]
+    #
+    # @!attribute [rw] monitoring_role_arn
+    #   The ARN for the IAM role that permits RDS to send enhanced
+    #   monitoring metrics to Amazon CloudWatch Logs. For example,
+    #   `arn:aws:iam:123456789012:role/emaccess`. For information on
+    #   creating a monitoring role, see [Setting Up and Enabling Enhanced
+    #   Monitoring][1].
+    #
+    #   If `MonitoringInterval` is set to a value other than 0, then you
+    #   must supply a `MonitoringRoleArn` value.
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
+    #   @return [String]
+    #
+    # @!attribute [rw] enable_iam_database_authentication
+    #   True to enable mapping of AWS Identity and Access Management (IAM)
+    #   accounts to database accounts, and otherwise false.
+    #
+    #   Default: `false`
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] source_engine
+    #   The name of the engine of your source database.
+    #
+    #   Valid Values: `mysql`
+    #   @return [String]
+    #
+    # @!attribute [rw] source_engine_version
+    #   The engine version of your source database.
+    #
+    #   Valid Values: `5.6`
+    #   @return [String]
+    #
+    # @!attribute [rw] s3_bucket_name
+    #   The name of your Amazon S3 bucket that contains your database backup
+    #   file.
+    #   @return [String]
+    #
+    # @!attribute [rw] s3_prefix
+    #   The prefix of your Amazon S3 bucket.
+    #   @return [String]
+    #
+    # @!attribute [rw] s3_ingestion_role_arn
+    #   An AWS Identity and Access Management (IAM) role to allow Amazon RDS
+    #   to access your Amazon S3 bucket.
+    #   @return [String]
+    #
+    # @!attribute [rw] enable_performance_insights
+    #   True to enable Performance Insights for the DB instance, and
+    #   otherwise false.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] performance_insights_kms_key_id
+    #   The AWS KMS key identifier for encryption of Performance Insights
+    #   data. The KMS key ID is the Amazon Resource Name (ARN), the KMS key
+    #   identifier, or the KMS key alias for the KMS encryption key.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromS3Message AWS API Documentation
+    #
+    class RestoreDBInstanceFromS3Message < Struct.new(
+      :db_name,
+      :db_instance_identifier,
+      :allocated_storage,
+      :db_instance_class,
+      :engine,
+      :master_username,
+      :master_user_password,
+      :db_security_groups,
+      :vpc_security_group_ids,
+      :availability_zone,
+      :db_subnet_group_name,
+      :preferred_maintenance_window,
+      :db_parameter_group_name,
+      :backup_retention_period,
+      :preferred_backup_window,
+      :port,
+      :multi_az,
+      :engine_version,
+      :auto_minor_version_upgrade,
+      :license_model,
+      :iops,
+      :option_group_name,
+      :publicly_accessible,
+      :tags,
+      :storage_type,
+      :storage_encrypted,
+      :kms_key_id,
+      :copy_tags_to_snapshot,
+      :monitoring_interval,
+      :monitoring_role_arn,
+      :enable_iam_database_authentication,
+      :source_engine,
+      :source_engine_version,
+      :s3_bucket_name,
+      :s3_prefix,
+      :s3_ingestion_role_arn,
+      :enable_performance_insights,
+      :performance_insights_kms_key_id)
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] db_instance
+    #   Contains the details of an Amazon RDS DB instance.
     #
     #   This data type is used as a response element in the
     #   DescribeDBInstances action.
     #   @return [Types::DBInstance]
     #
-    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshotResult AWS API Documentation
+    # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromS3Result AWS API Documentation
     #
-    class RestoreDBInstanceFromDBSnapshotResult < Struct.new(
+    class RestoreDBInstanceFromS3Result < Struct.new(
       :db_instance)
       include Aws::Structure
     end
@@ -12205,7 +12427,7 @@ module Aws::RDS
     #   @return [String]
     #
     # @!attribute [rw] target_db_instance_identifier
-    #   The name of the new database instance to be created.
+    #   The name of the new DB instance to be created.
     #
     #   Constraints:
     #
@@ -12244,9 +12466,9 @@ module Aws::RDS
     # @!attribute [rw] db_instance_class
     #   The compute and memory capacity of the Amazon RDS DB instance, for
     #   example, `db.m4.large`. Not all DB instance classes are available in
-    #   all regions, or for all database engines. For the full list of DB
-    #   instance classes, and availability for your engine, see [DB Instance
-    #   Class][1] in the Amazon RDS User Guide.
+    #   all AWS Regions, or for all database engines. For the full list of
+    #   DB instance classes, and availability for your engine, see [DB
+    #   Instance Class][1] in the Amazon RDS User Guide.
     #
     #   Default: The same DBInstanceClass as the original DB instance.
     #
@@ -12264,11 +12486,11 @@ module Aws::RDS
     #   @return [Integer]
     #
     # @!attribute [rw] availability_zone
-    #   The EC2 Availability Zone that the database instance is created in.
+    #   The EC2 Availability Zone that the DB instance is created in.
     #
     #   Default: A random, system-chosen Availability Zone.
     #
-    #   Constraint: You cannot specify the AvailabilityZone parameter if the
+    #   Constraint: You can't specify the AvailabilityZone parameter if the
     #   MultiAZ parameter is set to true.
     #
     #   Example: `us-east-1a`
@@ -12286,7 +12508,7 @@ module Aws::RDS
     # @!attribute [rw] multi_az
     #   Specifies if the DB instance is a Multi-AZ deployment.
     #
-    #   Constraint: You cannot specify the AvailabilityZone parameter if the
+    #   Constraint: You can't specify the AvailabilityZone parameter if the
     #   MultiAZ parameter is set to `true`.
     #   @return [Boolean]
     #
@@ -12345,6 +12567,8 @@ module Aws::RDS
     #
     #   * `aurora`
     #
+    #   * `aurora-postgresql`
+    #
     #   * `mariadb`
     #
     #   * `mysql`
@@ -12385,18 +12609,23 @@ module Aws::RDS
     #   instance.
     #
     #   Permanent options, such as the TDE option for Oracle Advanced
-    #   Security TDE, cannot be removed from an option group, and that
-    #   option group cannot be removed from a DB instance once it is
+    #   Security TDE, can't be removed from an option group, and that
+    #   option group can't be removed from a DB instance once it is
     #   associated with a DB instance
     #   @return [String]
     #
     # @!attribute [rw] copy_tags_to_snapshot
     #   True to copy all tags from the restored DB instance to snapshots of
-    #   the DB instance; otherwise false. The default is false.
+    #   the DB instance, and otherwise false. The default is false.
     #   @return [Boolean]
     #
     # @!attribute [rw] tags
-    #   A list of tags.
+    #   A list of tags. For more information, see [Tagging Amazon RDS
+    #   Resources][1].
+    #
+    #
+    #
+    #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] storage_type
@@ -12407,17 +12636,17 @@ module Aws::RDS
     #   If you specify `io1`, you must also include a value for the `Iops`
     #   parameter.
     #
-    #   Default: `io1` if the `Iops` parameter is specified; otherwise
+    #   Default: `io1` if the `Iops` parameter is specified, otherwise
     #   `standard`
     #   @return [String]
     #
     # @!attribute [rw] tde_credential_arn
-    #   The ARN from the Key Store with which to associate the instance for
+    #   The ARN from the key store with which to associate the instance for
     #   TDE encryption.
     #   @return [String]
     #
     # @!attribute [rw] tde_credential_password
-    #   The password for the given ARN from the Key Store in order to access
+    #   The password for the given ARN from the key store in order to access
     #   the device.
     #   @return [String]
     #
@@ -12432,7 +12661,7 @@ module Aws::RDS
     #
     # @!attribute [rw] enable_iam_database_authentication
     #   True to enable mapping of AWS Identity and Access Management (IAM)
-    #   accounts to database accounts; otherwise false.
+    #   accounts to database accounts, and otherwise false.
     #
     #   You can enable IAM database authentication for the following
     #   database engines
@@ -12477,18 +12706,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_instance
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBInstance
-    #
-    #   * DeleteDBInstance
-    #
-    #   * ModifyDBInstance
-    #
-    #   * StopDBInstance
-    #
-    #   * StartDBInstance
+    #   Contains the details of an Amazon RDS DB instance.
     #
     #   This data type is used as a response element in the
     #   DescribeDBInstances action.
@@ -12519,7 +12737,7 @@ module Aws::RDS
     # @!attribute [rw] cidrip
     #   The IP range to revoke access from. Must be a valid CIDR range. If
     #   `CIDRIP` is specified, `EC2SecurityGroupName`, `EC2SecurityGroupId`
-    #   and `EC2SecurityGroupOwnerId` cannot be provided.
+    #   and `EC2SecurityGroupOwnerId` can't be provided.
     #   @return [String]
     #
     # @!attribute [rw] ec2_security_group_name
@@ -12557,16 +12775,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_security_group
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * DescribeDBSecurityGroups
-    #
-    #   * AuthorizeDBSecurityGroupIngress
-    #
-    #   * CreateDBSecurityGroup
-    #
-    #   * RevokeDBSecurityGroupIngress
+    #   Contains the details for an Amazon RDS DB security group.
     #
     #   This data type is used as a response element in the
     #   DescribeDBSecurityGroups action.
@@ -12645,18 +12854,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_instance
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBInstance
-    #
-    #   * DeleteDBInstance
-    #
-    #   * ModifyDBInstance
-    #
-    #   * StopDBInstance
-    #
-    #   * StartDBInstance
+    #   Contains the details of an Amazon RDS DB instance.
     #
     #   This data type is used as a response element in the
     #   DescribeDBInstances action.
@@ -12695,18 +12893,7 @@ module Aws::RDS
     end
 
     # @!attribute [rw] db_instance
-    #   Contains the result of a successful invocation of the following
-    #   actions:
-    #
-    #   * CreateDBInstance
-    #
-    #   * DeleteDBInstance
-    #
-    #   * ModifyDBInstance
-    #
-    #   * StopDBInstance
-    #
-    #   * StartDBInstance
+    #   Contains the details of an Amazon RDS DB instance.
     #
     #   This data type is used as a response element in the
     #   DescribeDBInstances action.
@@ -12762,7 +12949,7 @@ module Aws::RDS
     #
     # @!attribute [rw] key
     #   A key is the required name of the tag. The string value can be from
-    #   1 to 128 Unicode characters in length and cannot be prefixed with
+    #   1 to 128 Unicode characters in length and can't be prefixed with
     #   "aws:" or "rds:". The string can only contain only the set of
     #   Unicode letters, digits, white-space, '\_', '.', '/', '=',
     #   '+', '-' (Java regex:
@@ -12771,7 +12958,7 @@ module Aws::RDS
     #
     # @!attribute [rw] value
     #   A value is the optional value of the tag. The string value can be
-    #   from 1 to 256 Unicode characters in length and cannot be prefixed
+    #   from 1 to 256 Unicode characters in length and can't be prefixed
     #   with "aws:" or "rds:". The string can only contain only the set
     #   of Unicode letters, digits, white-space, '\_', '.', '/',
     #   '=', '+', '-' (Java regex: