aws-sdk-rds 1.95.0 → 1.96.0

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

@@ -472,6 +472,7 @@ module Aws::RDS
     RemoveSourceIdentifierFromSubscriptionMessage = Shapes::StructureShape.new(name: 'RemoveSourceIdentifierFromSubscriptionMessage')
     RemoveSourceIdentifierFromSubscriptionResult = Shapes::StructureShape.new(name: 'RemoveSourceIdentifierFromSubscriptionResult')
     RemoveTagsFromResourceMessage = Shapes::StructureShape.new(name: 'RemoveTagsFromResourceMessage')
+    ReplicaMode = Shapes::StringShape.new(name: 'ReplicaMode')
     ReservedDBInstance = Shapes::StructureShape.new(name: 'ReservedDBInstance')
     ReservedDBInstanceAlreadyExistsFault = Shapes::StructureShape.new(name: 'ReservedDBInstanceAlreadyExistsFault')
     ReservedDBInstanceList = Shapes::ListShape.new(name: 'ReservedDBInstanceList')
@@ -895,6 +896,7 @@ module Aws::RDS
     CreateDBInstanceReadReplicaMessage.add_member(:deletion_protection, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "DeletionProtection"))
     CreateDBInstanceReadReplicaMessage.add_member(:domain, Shapes::ShapeRef.new(shape: String, location_name: "Domain"))
     CreateDBInstanceReadReplicaMessage.add_member(:domain_iam_role_name, Shapes::ShapeRef.new(shape: String, location_name: "DomainIAMRoleName"))
+    CreateDBInstanceReadReplicaMessage.add_member(:replica_mode, Shapes::ShapeRef.new(shape: ReplicaMode, location_name: "ReplicaMode"))
     CreateDBInstanceReadReplicaMessage.add_member(:destination_region, Shapes::ShapeRef.new(shape: String, location_name: "DestinationRegion", metadata: {"documented"=>false}))
     CreateDBInstanceReadReplicaMessage.add_member(:source_region, Shapes::ShapeRef.new(shape: String, location_name: "SourceRegion"))
     CreateDBInstanceReadReplicaMessage.struct_class = Types::CreateDBInstanceReadReplicaMessage
@@ -1261,6 +1263,7 @@ module Aws::RDS
     DBInstance.add_member(:read_replica_source_db_instance_identifier, Shapes::ShapeRef.new(shape: String, location_name: "ReadReplicaSourceDBInstanceIdentifier"))
     DBInstance.add_member(:read_replica_db_instance_identifiers, Shapes::ShapeRef.new(shape: ReadReplicaDBInstanceIdentifierList, location_name: "ReadReplicaDBInstanceIdentifiers"))
     DBInstance.add_member(:read_replica_db_cluster_identifiers, Shapes::ShapeRef.new(shape: ReadReplicaDBClusterIdentifierList, location_name: "ReadReplicaDBClusterIdentifiers"))
+    DBInstance.add_member(:replica_mode, Shapes::ShapeRef.new(shape: ReplicaMode, location_name: "ReplicaMode"))
     DBInstance.add_member(:license_model, Shapes::ShapeRef.new(shape: String, location_name: "LicenseModel"))
     DBInstance.add_member(:iops, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "Iops"))
     DBInstance.add_member(:option_group_memberships, Shapes::ShapeRef.new(shape: OptionGroupMembershipList, location_name: "OptionGroupMemberships"))
@@ -2331,6 +2334,7 @@ module Aws::RDS
     ModifyDBInstanceMessage.add_member(:deletion_protection, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "DeletionProtection"))
     ModifyDBInstanceMessage.add_member(:max_allocated_storage, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "MaxAllocatedStorage"))
     ModifyDBInstanceMessage.add_member(:certificate_rotation_restart, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "CertificateRotationRestart"))
+    ModifyDBInstanceMessage.add_member(:replica_mode, Shapes::ShapeRef.new(shape: ReplicaMode, location_name: "ReplicaMode"))
     ModifyDBInstanceMessage.struct_class = Types::ModifyDBInstanceMessage
 
     ModifyDBInstanceResult.add_member(:db_instance, Shapes::ShapeRef.new(shape: DBInstance, location_name: "DBInstance"))

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

@@ -1339,6 +1339,13 @@ module Aws::RDS
     #   The Active Directory directory ID to move the DB cluster to. Specify
     #   `none` to remove the cluster from its current domain. The domain must
     #   be created prior to this operation.
+    #
+    #   For more information, see [Kerberos Authentication][1] in the *Amazon
+    #   Aurora User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/kerberos-authentication.html
     # @option options [String] :domain_iam_role_name
     #   Specify the name of the IAM role to be used when making API calls to
     #   the Directory Service.

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

@@ -667,7 +667,16 @@ module Aws::RDS
     #   copy them.
     # @option options [String] :domain
     #   Specify the Active Directory directory ID to restore the DB cluster
-    #   in. The domain must be created prior to this operation.
+    #   in. The domain must be created prior to this operation. Currently,
+    #   only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
+    #   can be created in an Active Directory Domain.
+    #
+    #   For more information, see [ Kerberos Authentication][1] in the *Amazon
+    #   RDS User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
     # @option options [String] :domain_iam_role_name
     #   Specify the name of the IAM role to be used when making API calls to
     #   the Directory Service.

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

@@ -225,6 +225,22 @@ module Aws::RDS
       data[:read_replica_db_cluster_identifiers]
     end
 
+    # The open mode of an Oracle read replica. The default is
+    # `open-read-only`. For more information, see [Working with Oracle Read
+    # Replicas for Amazon RDS][1] in the *Amazon RDS User Guide*.
+    #
+    # <note markdown="1"> This attribute is only supported in RDS for Oracle.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
+    # @return [String]
+    def replica_mode
+      data[:replica_mode]
+    end
+
     # License model information for this DB instance.
     # @return [String]
     def license_model
@@ -707,6 +723,9 @@ module Aws::RDS
     #
     #   * Must contain 1 to 64 letters or numbers.
     #
+    #   * Must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0-9).
+    #
     #   * Can't be a word reserved by the specified database engine
     #
     #   **MariaDB**
@@ -719,6 +738,9 @@ module Aws::RDS
     #
     #   * Must contain 1 to 64 letters or numbers.
     #
+    #   * Must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0-9).
+    #
     #   * Can't be a word reserved by the specified database engine
     #
     #   **PostgreSQL**
@@ -731,8 +753,8 @@ module Aws::RDS
     #
     #   * Must contain 1 to 63 letters, numbers, or underscores.
     #
-    #   * Must begin with a letter or an underscore. Subsequent characters can
-    #     be letters, underscores, or digits (0-9).
+    #   * Must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0-9).
     #
     #   * Can't be a word reserved by the specified database engine
     #
@@ -1330,24 +1352,15 @@ module Aws::RDS
     #   for each AWS Region.
     # @option options [String] :domain
     #   The Active Directory directory ID to create the DB instance in.
-    #   Currently, only Microsoft SQL Server and Oracle DB instances can be
-    #   created in an Active Directory Domain.
+    #   Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
+    #   instances can be created in an Active Directory Domain.
     #
-    #   For Microsoft SQL Server DB instances, Amazon RDS can use Windows
-    #   Authentication to authenticate users that connect to the DB instance.
-    #   For more information, see [ Using Windows Authentication with an
-    #   Amazon RDS DB Instance Running Microsoft SQL Server][1] in the *Amazon
+    #   For more information, see [ Kerberos Authentication][1] in the *Amazon
     #   RDS User Guide*.
     #
-    #   For Oracle DB instances, Amazon RDS can use Kerberos Authentication to
-    #   authenticate users that connect to the DB instance. For more
-    #   information, see [ Using Kerberos Authentication with Amazon RDS for
-    #   Oracle][2] in the *Amazon RDS User Guide*.
     #
     #
-    #
-    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
-    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
     # @option options [Boolean] :copy_tags_to_snapshot
     #   A value that indicates whether to copy tags from the DB instance to
     #   snapshots of the DB instance. By default, tags are not copied.
@@ -1544,6 +1557,7 @@ module Aws::RDS
     #     deletion_protection: false,
     #     domain: "String",
     #     domain_iam_role_name: "String",
+    #     replica_mode: "open-read-only", # accepts open-read-only, mounted
     #     source_region: "String",
     #   })
     # @param [Hash] options ({})
@@ -1847,25 +1861,39 @@ module Aws::RDS
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html
     # @option options [String] :domain
     #   The Active Directory directory ID to create the DB instance in.
+    #   Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
+    #   instances can be created in an Active Directory Domain.
     #
-    #   For Oracle DB instances, Amazon RDS can use Kerberos authentication to
-    #   authenticate users that connect to the DB instance. For more
-    #   information, see [ Using Kerberos Authentication with Amazon RDS for
-    #   Oracle][1] in the *Amazon RDS User Guide*.
-    #
-    #   For Microsoft SQL Server DB instances, Amazon RDS can use Windows
-    #   Authentication to authenticate users that connect to the DB instance.
-    #   For more information, see [ Using Windows Authentication with an
-    #   Amazon RDS DB Instance Running Microsoft SQL Server][2] in the *Amazon
+    #   For more information, see [ Kerberos Authentication][1] in the *Amazon
     #   RDS User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
-    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
     # @option options [String] :domain_iam_role_name
     #   Specify the name of the IAM role to be used when making API calls to
     #   the Directory Service.
+    # @option options [String] :replica_mode
+    #   The open mode of the replica database: mounted or read-only.
+    #
+    #   <note markdown="1"> This parameter is only supported for Oracle DB instances.
+    #
+    #    </note>
+    #
+    #   Mounted DB replicas are included in Oracle Enterprise Edition. The
+    #   main use case for mounted replicas is cross-Region disaster recovery.
+    #   The primary database doesn't use Active Data Guard to transmit
+    #   information to the mounted replica. Because it doesn't accept user
+    #   connections, a mounted replica can't serve a read-only workload.
+    #
+    #   You can create a combination of mounted and read-only DB replicas for
+    #   the same primary DB instance. For more information, see [Working with
+    #   Oracle Read Replicas for Amazon RDS][1] in the *Amazon RDS User
+    #   Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
     # @option options [String] :destination_region
     # @option options [String] :source_region
     #   The source region of the snapshot. This is only needed when the
@@ -2037,6 +2065,7 @@ module Aws::RDS
     #     deletion_protection: false,
     #     max_allocated_storage: 1,
     #     certificate_rotation_restart: false,
+    #     replica_mode: "open-read-only", # accepts open-read-only, mounted
     #   })
     # @param [Hash] options ({})
     # @option options [Integer] :allocated_storage
@@ -2390,25 +2419,16 @@ module Aws::RDS
     # @option options [String] :domain
     #   The Active Directory directory ID to move the DB instance to. Specify
     #   `none` to remove the instance from its current domain. The domain must
-    #   be created prior to this operation. Currently, only Microsoft SQL
-    #   Server and Oracle DB instances can be created in an Active Directory
-    #   Domain.
-    #
-    #   For Microsoft SQL Server DB instances, Amazon RDS can use Windows
-    #   Authentication to authenticate users that connect to the DB instance.
-    #   For more information, see [ Using Windows Authentication with an
-    #   Amazon RDS DB Instance Running Microsoft SQL Server][1] in the *Amazon
-    #   RDS User Guide*.
+    #   be created prior to this operation. Currently, only MySQL, Microsoft
+    #   SQL Server, Oracle, and PostgreSQL DB instances can be created in an
+    #   Active Directory Domain.
     #
-    #   For Oracle DB instances, Amazon RDS can use Kerberos authentication to
-    #   authenticate users that connect to the DB instance. For more
-    #   information, see [ Using Kerberos Authentication with Amazon RDS for
-    #   Oracle][2] in the *Amazon RDS User Guide*.
+    #   For more information, see [ Kerberos Authentication][1] in the *Amazon
+    #   RDS User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
-    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
     # @option options [Boolean] :copy_tags_to_snapshot
     #   A value that indicates whether to copy all tags from the DB instance
     #   to snapshots of the DB instance. By default, tags are not copied.
@@ -2610,6 +2630,25 @@ module Aws::RDS
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html
     #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL-certificate-rotation.html
+    # @option options [String] :replica_mode
+    #   A value that sets the open mode of a replica database to either
+    #   mounted or read-only.
+    #
+    #   <note markdown="1"> Currently, this parameter is only supported for Oracle DB instances.
+    #
+    #    </note>
+    #
+    #   Mounted DB replicas are included in Oracle Enterprise Edition. The
+    #   main use case for mounted replicas is cross-Region disaster recovery.
+    #   The primary database doesn't use Active Data Guard to transmit
+    #   information to the mounted replica. Because it doesn't accept user
+    #   connections, a mounted replica can't serve a read-only workload. For
+    #   more information, see [Working with Oracle Read Replicas for Amazon
+    #   RDS][1] in the *Amazon RDS User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
     # @return [DBInstance]
     def modify(options = {})
       options = options.merge(db_instance_identifier: @id)
@@ -2924,24 +2963,15 @@ module Aws::RDS
     # @option options [String] :domain
     #   Specify the Active Directory directory ID to restore the DB instance
     #   in. The domain must be created prior to this operation. Currently,
-    #   only Microsoft SQL Server and Oracle DB instances can be created in an
-    #   Active Directory Domain.
+    #   only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
+    #   can be created in an Active Directory Domain.
     #
-    #   For Microsoft SQL Server DB instances, Amazon RDS can use Windows
-    #   Authentication to authenticate users that connect to the DB instance.
-    #   For more information, see [ Using Windows Authentication with an
-    #   Amazon RDS DB Instance Running Microsoft SQL Server][1] in the *Amazon
+    #   For more information, see [ Kerberos Authentication][1] in the *Amazon
     #   RDS User Guide*.
     #
-    #   For Oracle DB instances, Amazon RDS can use Kerberos authentication to
-    #   authenticate users that connect to the DB instance. For more
-    #   information, see [ Using Kerberos Authentication with Amazon RDS for
-    #   Oracle][2] in the *Amazon RDS User Guide*.
-    #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
-    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
     # @option options [String] :domain_iam_role_name
     #   Specify the name of the IAM role to be used when making API calls to
     #   the Directory Service.

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

@@ -759,24 +759,15 @@ module Aws::RDS
     # @option options [String] :domain
     #   Specify the Active Directory directory ID to restore the DB instance
     #   in. The domain must be created prior to this operation. Currently,
-    #   only Microsoft SQL Server and Oracle DB instances can be created in an
-    #   Active Directory Domain.
+    #   only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
+    #   can be created in an Active Directory Domain.
     #
-    #   For Microsoft SQL Server DB instances, Amazon RDS can use Windows
-    #   Authentication to authenticate users that connect to the DB instance.
-    #   For more information, see [ Using Windows Authentication with an
-    #   Amazon RDS DB Instance Running Microsoft SQL Server][1] in the *Amazon
+    #   For more information, see [ Kerberos Authentication][1] in the *Amazon
     #   RDS User Guide*.
     #
-    #   For Oracle DB instances, Amazon RDS can use Kerberos authentication to
-    #   authenticate users that connect to the DB instance. For more
-    #   information, see [ Using Kerberos Authentication with Amazon RDS for
-    #   Oracle][2] in the *Amazon RDS User Guide*.
     #
     #
-    #
-    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
-    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
     # @option options [Boolean] :copy_tags_to_snapshot
     #   A value that indicates whether to copy all tags from the restored DB
     #   instance to snapshots of the DB instance. By default, tags are not

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

@@ -247,17 +247,23 @@ module Aws::RDS
     #
     #   Constraints:
     #
-    #   * If the source type is a DB instance, then a `DBInstanceIdentifier`
+    #   * If the source type is a DB instance, a `DBInstanceIdentifier` value
     #     must be supplied.
     #
-    #   * If the source type is a DB security group, a `DBSecurityGroupName`
+    #   * If the source type is a DB cluster, a `DBClusterIdentifier` value
     #     must be supplied.
     #
     #   * If the source type is a DB parameter group, a `DBParameterGroupName`
+    #     value must be supplied.
+    #
+    #   * If the source type is a DB security group, a `DBSecurityGroupName`
+    #     value must be supplied.
+    #
+    #   * If the source type is a DB snapshot, a `DBSnapshotIdentifier` value
     #     must be supplied.
     #
-    #   * If the source type is a DB snapshot, a `DBSnapshotIdentifier` must
-    #     be supplied.
+    #   * If the source type is a DB cluster snapshot, a
+    #     `DBClusterSnapshotIdentifier` value must be supplied.
     # @return [EventSubscription]
     def add_subscriber(options = {})
       options = options.merge(subscription_name: @name)
@@ -291,17 +297,17 @@ module Aws::RDS
     #   and subscribe to it.
     # @option options [String] :source_type
     #   The type of source that is generating the events. For example, if you
-    #   want to be notified of events generated by a DB instance, you would
-    #   set this parameter to db-instance. if this value isn't specified, all
-    #   events are returned.
+    #   want to be notified of events generated by a DB instance, you set this
+    #   parameter to `db-instance`. If this value isn't specified, all events
+    #   are returned.
     #
     #   Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
     #   `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
     # @option options [Array<String>] :event_categories
-    #   A list of event categories for a SourceType that you want to subscribe
-    #   to. You can see a list of the categories for a given SourceType in the
-    #   [Events][1] topic in the *Amazon RDS User Guide* or by using the
-    #   **DescribeEventCategories** action.
+    #   A list of event categories for a particular source type (`SourceType`)
+    #   that you want to subscribe to. You can see a list of the categories
+    #   for a given source type in [Events][1] in the *Amazon RDS User Guide*
+    #   or by using the `DescribeEventCategories` operation.
     #
     #
     #
@@ -315,19 +321,26 @@ module Aws::RDS
     #
     #   Constraints:
     #
-    #   * If SourceIds are supplied, SourceType must also be provided.
+    #   * If a `SourceIds` value is supplied, `SourceType` must also be
+    #     provided.
     #
-    #   * If the source type is a DB instance, then a `DBInstanceIdentifier`
+    #   * If the source type is a DB instance, a `DBInstanceIdentifier` value
     #     must be supplied.
     #
-    #   * If the source type is a DB security group, a `DBSecurityGroupName`
+    #   * If the source type is a DB cluster, a `DBClusterIdentifier` value
     #     must be supplied.
     #
     #   * If the source type is a DB parameter group, a `DBParameterGroupName`
+    #     value must be supplied.
+    #
+    #   * If the source type is a DB security group, a `DBSecurityGroupName`
+    #     value must be supplied.
+    #
+    #   * If the source type is a DB snapshot, a `DBSnapshotIdentifier` value
     #     must be supplied.
     #
-    #   * If the source type is a DB snapshot, a `DBSnapshotIdentifier` must
-    #     be supplied.
+    #   * If the source type is a DB cluster snapshot, a
+    #     `DBClusterSnapshotIdentifier` value must be supplied.
     # @option options [Boolean] :enabled
     #   A value that indicates whether to activate the subscription. If the
     #   event notification subscription isn't activated, the subscription is
@@ -384,13 +397,13 @@ module Aws::RDS
     #   set this parameter to db-instance. If this value isn't specified, all
     #   events are returned.
     #
-    #   Valid values: db-instance \| db-parameter-group \| db-security-group
-    #   \| db-snapshot
+    #   Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
+    #   `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
     # @option options [Array<String>] :event_categories
-    #   A list of event categories for a SourceType that you want to subscribe
-    #   to. You can see a list of the categories for a given SourceType in the
-    #   [Events][1] topic in the *Amazon RDS User Guide* or by using the
-    #   **DescribeEventCategories** action.
+    #   A list of event categories for a source type (`SourceType`) that you
+    #   want to subscribe to. You can see a list of the categories for a given
+    #   source type in [Events][1] in the *Amazon RDS User Guide* or by using
+    #   the `DescribeEventCategories` operation.
     #
     #
     #

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

@@ -586,6 +586,9 @@ module Aws::RDS
     #
     #   * Must contain 1 to 64 letters or numbers.
     #
+    #   * Must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0-9).
+    #
     #   * Can't be a word reserved by the specified database engine
     #
     #   **MariaDB**
@@ -598,6 +601,9 @@ module Aws::RDS
     #
     #   * Must contain 1 to 64 letters or numbers.
     #
+    #   * Must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0-9).
+    #
     #   * Can't be a word reserved by the specified database engine
     #
     #   **PostgreSQL**
@@ -610,8 +616,8 @@ module Aws::RDS
     #
     #   * Must contain 1 to 63 letters, numbers, or underscores.
     #
-    #   * Must begin with a letter or an underscore. Subsequent characters can
-    #     be letters, underscores, or digits (0-9).
+    #   * Must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0-9).
     #
     #   * Can't be a word reserved by the specified database engine
     #
@@ -1222,24 +1228,15 @@ module Aws::RDS
     #   for each AWS Region.
     # @option options [String] :domain
     #   The Active Directory directory ID to create the DB instance in.
-    #   Currently, only Microsoft SQL Server and Oracle DB instances can be
-    #   created in an Active Directory Domain.
+    #   Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
+    #   instances can be created in an Active Directory Domain.
     #
-    #   For Microsoft SQL Server DB instances, Amazon RDS can use Windows
-    #   Authentication to authenticate users that connect to the DB instance.
-    #   For more information, see [ Using Windows Authentication with an
-    #   Amazon RDS DB Instance Running Microsoft SQL Server][1] in the *Amazon
+    #   For more information, see [ Kerberos Authentication][1] in the *Amazon
     #   RDS User Guide*.
     #
-    #   For Oracle DB instances, Amazon RDS can use Kerberos Authentication to
-    #   authenticate users that connect to the DB instance. For more
-    #   information, see [ Using Kerberos Authentication with Amazon RDS for
-    #   Oracle][2] in the *Amazon RDS User Guide*.
     #
     #
-    #
-    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_SQLServerWinAuth.html
-    #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-kerberos.html
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
     # @option options [Boolean] :copy_tags_to_snapshot
     #   A value that indicates whether to copy tags from the DB instance to
     #   snapshots of the DB instance. By default, tags are not copied.
@@ -1557,17 +1554,17 @@ module Aws::RDS
     #   and subscribe to it.
     # @option options [String] :source_type
     #   The type of source that is generating the events. For example, if you
-    #   want to be notified of events generated by a DB instance, you would
-    #   set this parameter to db-instance. if this value isn't specified, all
-    #   events are returned.
+    #   want to be notified of events generated by a DB instance, you set this
+    #   parameter to `db-instance`. If this value isn't specified, all events
+    #   are returned.
     #
     #   Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
     #   `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
     # @option options [Array<String>] :event_categories
-    #   A list of event categories for a SourceType that you want to subscribe
-    #   to. You can see a list of the categories for a given SourceType in the
-    #   [Events][1] topic in the *Amazon RDS User Guide* or by using the
-    #   **DescribeEventCategories** action.
+    #   A list of event categories for a particular source type (`SourceType`)
+    #   that you want to subscribe to. You can see a list of the categories
+    #   for a given source type in [Events][1] in the *Amazon RDS User Guide*
+    #   or by using the `DescribeEventCategories` operation.
     #
     #
     #
@@ -1581,19 +1578,26 @@ module Aws::RDS
     #
     #   Constraints:
     #
-    #   * If SourceIds are supplied, SourceType must also be provided.
+    #   * If a `SourceIds` value is supplied, `SourceType` must also be
+    #     provided.
     #
-    #   * If the source type is a DB instance, then a `DBInstanceIdentifier`
+    #   * If the source type is a DB instance, a `DBInstanceIdentifier` value
     #     must be supplied.
     #
-    #   * If the source type is a DB security group, a `DBSecurityGroupName`
+    #   * If the source type is a DB cluster, a `DBClusterIdentifier` value
     #     must be supplied.
     #
     #   * If the source type is a DB parameter group, a `DBParameterGroupName`
+    #     value must be supplied.
+    #
+    #   * If the source type is a DB security group, a `DBSecurityGroupName`
+    #     value must be supplied.
+    #
+    #   * If the source type is a DB snapshot, a `DBSnapshotIdentifier` value
     #     must be supplied.
     #
-    #   * If the source type is a DB snapshot, a `DBSnapshotIdentifier` must
-    #     be supplied.
+    #   * If the source type is a DB cluster snapshot, a
+    #     `DBClusterSnapshotIdentifier` value must be supplied.
     # @option options [Boolean] :enabled
     #   A value that indicates whether to activate the subscription. If the
     #   event notification subscription isn't activated, the subscription is
@@ -2325,8 +2329,8 @@ module Aws::RDS
     # @option options [String] :source_type
     #   The type of source that is generating the events.
     #
-    #   Valid values: db-instance \| db-parameter-group \| db-security-group
-    #   \| db-snapshot
+    #   Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
+    #   `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
     # @option options [Array<Types::Filter>] :filters
     #   This parameter isn't currently supported.
     # @return [EventCategoryMap::Collection]
@@ -2414,19 +2418,26 @@ module Aws::RDS
     #
     #   Constraints:
     #
-    #   * If SourceIdentifier is supplied, SourceType must also be provided.
+    #   * If `SourceIdentifier` is supplied, `SourceType` must also be
+    #     provided.
     #
-    #   * If the source type is `DBInstance`, then a `DBInstanceIdentifier`
+    #   * If the source type is a DB instance, a `DBInstanceIdentifier` value
     #     must be supplied.
     #
-    #   * If the source type is `DBSecurityGroup`, a `DBSecurityGroupName`
+    #   * If the source type is a DB cluster, a `DBClusterIdentifier` value
     #     must be supplied.
     #
-    #   * If the source type is `DBParameterGroup`, a `DBParameterGroupName`
+    #   * If the source type is a DB parameter group, a `DBParameterGroupName`
+    #     value must be supplied.
+    #
+    #   * If the source type is a DB security group, a `DBSecurityGroupName`
+    #     value must be supplied.
+    #
+    #   * If the source type is a DB snapshot, a `DBSnapshotIdentifier` value
     #     must be supplied.
     #
-    #   * If the source type is `DBSnapshot`, a `DBSnapshotIdentifier` must be
-    #     supplied.
+    #   * If the source type is a DB cluster snapshot, a
+    #     `DBClusterSnapshotIdentifier` value must be supplied.
     #
     #   * Can't end with a hyphen or contain two consecutive hyphens.
     # @option options [String] :source_type