aws-sdk-rds 1.7.0 → 1.8.0

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

@@ -306,16 +306,16 @@ module Aws::RDS
       data[:storage_encrypted]
     end
 
-    # 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]
     def kms_key_id
       data[:kms_key_id]
     end
 
-    # 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]
     def dbi_resource_id
       data[:dbi_resource_id]
@@ -357,7 +357,7 @@ module Aws::RDS
     end
 
     # The ARN for the IAM role that permits RDS to send Enhanced Monitoring
-    # metrics to CloudWatch Logs.
+    # metrics to Amazon CloudWatch Logs.
     # @return [String]
     def monitoring_role_arn
       data[:monitoring_role_arn]
@@ -391,7 +391,7 @@ module Aws::RDS
     end
 
     # 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
@@ -407,16 +407,16 @@ module Aws::RDS
       data[:iam_database_authentication_enabled]
     end
 
-    # True if Performance Insights is enabled for the DB instance; otherwise
-    # false.
+    # True if Performance Insights is enabled for the DB instance, and
+    # otherwise false.
     # @return [Boolean]
     def performance_insights_enabled
       data[:performance_insights_enabled]
     end
 
-    # The 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.
+    # 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]
     def performance_insights_kms_key_id
       data[:performance_insights_kms_key_id]
@@ -680,7 +680,7 @@ module Aws::RDS
     #   * Cannot be a word reserved by the specified database engine
     # @option options [Integer] :allocated_storage
     #   The amount of storage (in gigabytes) to be initially allocated for the
-    #   database instance.
+    #   DB instance.
     #
     #   Type: Integer
     #
@@ -765,8 +765,8 @@ module Aws::RDS
     #     * Web and Express editions: Must be an integer from 20 to 1024.
     # @option options [required, String] :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 instance
+    #   `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.
     #
@@ -782,6 +782,8 @@ module Aws::RDS
     #
     #   * `aurora`
     #
+    #   * `aurora-postgresql`
+    #
     #   * `mariadb`
     #
     #   * `mysql`
@@ -869,8 +871,8 @@ module Aws::RDS
     #
     #   * Cannot be a reserved word for the chosen database engine.
     # @option options [String] :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**
     #
@@ -911,8 +913,8 @@ module Aws::RDS
     #   Default: The default EC2 VPC security group for the DB subnet group's
     #   VPC.
     # @option options [String] :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 endpoint's
@@ -920,7 +922,7 @@ module Aws::RDS
     #
     #   Example: `us-east-1d`
     #
-    #   Constraint: The AvailabilityZone parameter cannot be specified if the
+    #   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.
     #
@@ -932,25 +934,23 @@ module Aws::RDS
     #
     #   If there is no DB subnet group, then it is a non-VPC DB instance.
     # @option options [String] :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
     # @option options [String] :db_parameter_group_name
     #   The name of the DB parameter group to associate with this DB instance.
     #   If this argument is omitted, the default DBParameterGroup for the
@@ -983,22 +983,22 @@ module Aws::RDS
     # @option options [String] :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**
     #
     #   Not applicable. The daily time range for creating automated backups 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.
     #
@@ -1006,7 +1006,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
     # @option options [Integer] :port
     #   The port number on which the database accepts connections.
@@ -1056,7 +1056,7 @@ module Aws::RDS
     #
     #   Type: Integer
     # @option options [Boolean] :multi_az
-    #   Specifies if the DB instance is a Multi-AZ deployment. You cannot set
+    #   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.
     # @option options [String] :engine_version
@@ -1074,59 +1074,59 @@ 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, ca-central-1,
-    #     eu-west-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)
+    #   * `13.00.4422.0.v1` (supported for all editions, and all AWS Regions)
     #
-    #   * `13.00.2164.0.v1` (supported for all editions, and all AWS regions)
+    #   * `13.00.2164.0.v1` (supported for all editions, and all AWS Regions)
     #
     #   **Microsoft SQL Server 2014**
     #
-    #   * `12.00.5546.0.v1` (supported for all editions, and all AWS regions)
+    #   * `12.00.5546.0.v1` (supported for all editions, and all AWS Regions)
     #
-    #   * `12.00.5000.0.v1` (supported for all editions, and all AWS regions)
+    #   * `12.00.5000.0.v1` (supported for all editions, and all AWS 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)
+    #   * `11.00.6594.0.v1` (supported for all editions, and all AWS Regions)
     #
-    #   * `11.00.6020.0.v1` (supported for all editions, and all AWS regions)
+    #   * `11.00.6020.0.v1` (supported for all editions, and all AWS 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
+    #   * `11.00.2100.60.v1` (supported for all editions, and all AWS 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
+    #   * `10.50.6000.34.v1` (supported for all editions, and all AWS 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**
@@ -1137,30 +1137,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**
     #
@@ -1238,19 +1236,25 @@ module Aws::RDS
     #   `general-public-license`
     # @option options [Integer] :iops
     #   The amount of Provisioned IOPS (input/output operations per second) to
-    #   be initially allocated for the DB instance.
+    #   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
     # @option options [String] :option_group_name
     #   Indicates that the DB instance should be associated with the 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 associated with a DB
+    #   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
     # @option options [String] :character_set_name
     #   For supported engines, indicates that the DB instance should be
@@ -1281,7 +1285,12 @@ module Aws::RDS
     #   as part of the request and the PubliclyAccessible value has not been
     #   set, the DB instance is private.
     # @option options [Array<Types::Tag>] :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
     # @option options [String] :db_cluster_identifier
     #   The identifier of the DB cluster that the instance will belong to.
     #
@@ -1296,13 +1305,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`
     # @option options [String] :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.
     # @option options [String] :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.
     # @option options [Boolean] :storage_encrypted
     #   Specifies whether the DB instance is encrypted.
@@ -1314,7 +1323,7 @@ module Aws::RDS
     #
     #   Default: false
     # @option options [String] :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
@@ -1336,7 +1345,7 @@ module Aws::RDS
     #   Specify the Active Directory Domain to create the instance in.
     # @option options [Boolean] :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.
     # @option options [Integer] :monitoring_interval
     #   The interval, in seconds, between points when Enhanced Monitoring
     #   metrics are collected for the DB instance. To disable collecting
@@ -1348,7 +1357,7 @@ module Aws::RDS
     #   Valid Values: `0, 1, 5, 10, 15, 30, 60`
     # @option options [String] :monitoring_role_arn
     #   The ARN for the IAM role that permits RDS to send enhanced monitoring
-    #   metrics to CloudWatch Logs. For example,
+    #   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].
@@ -1384,7 +1393,7 @@ module Aws::RDS
     #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.TimeZone
     # @option options [Boolean] :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:
@@ -1402,12 +1411,12 @@ module Aws::RDS
     #
     #   Default: `false`
     # @option options [Boolean] :enable_performance_insights
-    #   True to enable Performance Insights for the DB instance; otherwise
+    #   True to enable Performance Insights for the DB instance, and otherwise
     #   false.
     # @option options [String] :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 identifier,
-    #   or the KMS key alias for the KMS encryption 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 [DBInstance]
     def create(options = {})
       options = options.merge(db_instance_identifier: @id)
@@ -1455,8 +1464,8 @@ module Aws::RDS
     #   a lowercase string.
     # @option options [String] :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 instance
+    #   `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.
     #
@@ -1510,7 +1519,12 @@ module Aws::RDS
     #   as part of the request and the PubliclyAccessible value has not been
     #   set, the DB instance is private.
     # @option options [Array<Types::Tag>] :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
     # @option options [String] :db_subnet_group_name
     #   Specifies a DB subnet group for the DB instance. The new DB instance
     #   is created in the VPC associated with the DB subnet group. If no DB
@@ -1545,11 +1559,11 @@ 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`
     # @option options [Boolean] :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.
     # @option options [Integer] :monitoring_interval
     #   The interval, in seconds, between points when Enhanced Monitoring
     #   metrics are collected for the Read Replica. To disable collecting
@@ -1561,7 +1575,7 @@ module Aws::RDS
     #   Valid Values: `0, 1, 5, 10, 15, 30, 60`
     # @option options [String] :monitoring_role_arn
     #   The ARN for the IAM role that permits RDS to send enhanced monitoring
-    #   metrics to CloudWatch Logs. For example,
+    #   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].
@@ -1588,7 +1602,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 another
+    #   in, and you can't use encryption keys from one AWS Region in another
     #   AWS Region.
     # @option options [String] :pre_signed_url
     #   The URL that contains a Signature Version 4 signed request for the
@@ -1597,9 +1611,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
@@ -1612,24 +1626,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.
+    #     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
+    #     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`.
     #
@@ -1643,7 +1657,7 @@ module Aws::RDS
     #   [2]: http://docs.aws.amazon.com/general/latest/gr/signature-version-4.html
     # @option options [Boolean] :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
@@ -1656,12 +1670,12 @@ module Aws::RDS
     #
     #   Default: `false`
     # @option options [Boolean] :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.
     # @option options [String] :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 identifier,
-    #   or the KMS key alias for the KMS encryption 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.
     # @option options [String] :destination_region
     # @option options [String] :source_region
     #   The source region of the snapshot. This is only needed when the
@@ -1704,7 +1718,12 @@ module Aws::RDS
     #
     #   Example: `my-snapshot-id`
     # @option options [Array<Types::Tag>] :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 [DBSnapshot]
     def create_snapshot(options = {})
       options = options.merge(db_instance_identifier: @id)
@@ -1887,8 +1906,8 @@ module Aws::RDS
     #   for the instance, and creating a DB snapshot of the instance.
     # @option options [String] :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 instance
+    #   `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.
     #
@@ -1965,8 +1984,8 @@ module Aws::RDS
     #
     #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.DBInstance.Modifying.html
     # @option options [String] :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 the
@@ -2066,7 +2085,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
     #
@@ -2176,8 +2195,8 @@ module Aws::RDS
     #   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 associated with a DB
+    #   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
     # @option options [String] :new_db_instance_identifier
     #   The new DB instance identifier for the DB instance when renaming a DB
@@ -2203,13 +2222,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`
     # @option options [String] :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.
     # @option options [String] :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.
     # @option options [String] :ca_certificate_identifier
     #   Indicates the certificate that needs to be associated with the
@@ -2221,7 +2240,7 @@ module Aws::RDS
     #   instance can be created in a Active Directory Domain.
     # @option options [Boolean] :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.
     # @option options [Integer] :monitoring_interval
     #   The interval, in seconds, between points when Enhanced Monitoring
     #   metrics are collected for the DB instance. To disable collecting
@@ -2296,7 +2315,7 @@ module Aws::RDS
     #   Default: false
     # @option options [String] :monitoring_role_arn
     #   The ARN for the IAM role that permits RDS to send enhanced monitoring
-    #   metrics to CloudWatch Logs. For example,
+    #   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].
@@ -2325,7 +2344,7 @@ module Aws::RDS
     #   [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Aurora.Managing.html#Aurora.Managing.FaultTolerance
     # @option options [Boolean] :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
@@ -2343,12 +2362,12 @@ module Aws::RDS
     #
     #   Default: `false`
     # @option options [Boolean] :enable_performance_insights
-    #   True to enable Performance Insights for the DB instance; otherwise
+    #   True to enable Performance Insights for the DB instance, and otherwise
     #   false.
     # @option options [String] :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 identifier,
-    #   or the KMS key alias for the KMS encryption 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 [DBInstance]
     def modify(options = {})
       options = options.merge(db_instance_identifier: @id)
@@ -2384,15 +2403,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.
     #
@@ -2421,7 +2441,7 @@ module Aws::RDS
     # @option options [Boolean] :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 [DBInstance]
     def reboot(options = {})
@@ -2468,7 +2488,7 @@ module Aws::RDS
     #   })
     # @param [Hash] options ({})
     # @option options [required, String] :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:
     #
@@ -2500,7 +2520,7 @@ module Aws::RDS
     # @option options [String] :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
+    #   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.
     #
@@ -2516,11 +2536,11 @@ module Aws::RDS
     #
     #   Default: The same port as the original DB instance.
     # @option options [String] :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`
@@ -2534,7 +2554,7 @@ module Aws::RDS
     # @option options [Boolean] :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`.
     # @option options [Boolean] :publicly_accessible
     #   Specifies the accessibility options for the DB instance. A value of
@@ -2583,6 +2603,8 @@ module Aws::RDS
     #
     #   * `aurora`
     #
+    #   * `aurora-postgresql`
+    #
     #   * `mariadb`
     #
     #   * `mysql`
@@ -2618,14 +2640,19 @@ module Aws::RDS
     #   The name of the option group to be used for the restored DB 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 associated with a DB
+    #   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
     # @option options [Boolean] :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.
     # @option options [Array<Types::Tag>] :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
     # @option options [String] :storage_type
     #   Specifies the storage type to be associated with the DB instance.
     #
@@ -2634,13 +2661,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`
     # @option options [String] :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.
     # @option options [String] :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.
     # @option options [String] :domain
     #   Specify the Active Directory Domain to restore the instance in.
@@ -2649,7 +2676,7 @@ module Aws::RDS
     #   the Directory Service.
     # @option options [Boolean] :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
@@ -2982,7 +3009,7 @@ module Aws::RDS
     #   })
     # @param [Hash] options ({})
     # @option options [String] :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.
     #
@@ -3022,18 +3049,17 @@ module Aws::RDS
     # @option options [Array<Types::Filter>] :filters
     #   This parameter is not currently supported.
     # @option options [Boolean] :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 ModifyDBSnapshotAttribute API
     #   action.
     # @option options [Boolean] :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.