aws-sdk-rds 1.134.0 → 1.138.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -494,7 +494,7 @@ module Aws::RDS
494
494
  data[:db_cluster_instance_class]
495
495
  end
496
496
 
497
- # The storage type associated with DB instance.
497
+ # The storage type associated with the DB cluster.
498
498
  #
499
499
  # This setting is only for non-Aurora Multi-AZ DB clusters.
500
500
  # @return [String]
@@ -844,7 +844,7 @@ module Aws::RDS
844
844
  # Constraints: Must match the name of an existing DBSubnetGroup. Must
845
845
  # not be default.
846
846
  #
847
- # Example: `mySubnetgroup`
847
+ # Example: `mydbsubnetgroup`
848
848
  #
849
849
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
850
850
  # @option options [required, String] :engine
@@ -854,7 +854,8 @@ module Aws::RDS
854
854
  #
855
855
  # * `aurora` (for MySQL 5.6-compatible Aurora)
856
856
  #
857
- # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
857
+ # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
858
+ # Aurora)
858
859
  #
859
860
  # * `aurora-postgresql`
860
861
  #
@@ -873,7 +874,7 @@ module Aws::RDS
873
874
  # "DBEngineVersions[].EngineVersion"`
874
875
  #
875
876
  # To list all of the available engine versions for MySQL 5.7-compatible
876
- # Aurora, use the following command:
877
+ # and MySQL 8.0-compatible Aurora, use the following command:
877
878
  #
878
879
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
879
880
  # "DBEngineVersions[].EngineVersion"`
@@ -1294,11 +1295,11 @@ module Aws::RDS
1294
1295
  #
1295
1296
  # This setting is required to create a Multi-AZ DB cluster.
1296
1297
  #
1297
- # Valid values: `standard | gp2 | io1`
1298
+ # Valid values: `io1`
1298
1299
  #
1299
- # If you specify `io1`, also include a value for the `Iops` parameter.
1300
+ # When specified, a value for the `Iops` parameter is required.
1300
1301
  #
1301
- # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
1302
+ # Default: `io1`
1302
1303
  #
1303
1304
  # Valid for: Multi-AZ DB clusters only
1304
1305
  # @option options [Integer] :iops
@@ -1758,7 +1759,7 @@ module Aws::RDS
1758
1759
  # "DBEngineVersions[].EngineVersion"`
1759
1760
  #
1760
1761
  # To list all of the available engine versions for MySQL 5.7-compatible
1761
- # Aurora, use the following command:
1762
+ # and MySQL 8.0-compatible Aurora, use the following command:
1762
1763
  #
1763
1764
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
1764
1765
  # "DBEngineVersions[].EngineVersion"`
@@ -1904,12 +1905,11 @@ module Aws::RDS
1904
1905
  # @option options [String] :storage_type
1905
1906
  # Specifies the storage type to be associated with the DB cluster.
1906
1907
  #
1907
- # Valid values: `standard | gp2 | io1`
1908
+ # Valid values: `io1`
1908
1909
  #
1909
- # If you specify `io1`, you must also include a value for the `Iops`
1910
- # parameter.
1910
+ # When specified, a value for the `Iops` parameter is required.
1911
1911
  #
1912
- # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
1912
+ # Default: `io1`
1913
1913
  #
1914
1914
  # Valid for: Multi-AZ DB clusters only
1915
1915
  # @option options [Integer] :iops
@@ -2117,7 +2117,7 @@ module Aws::RDS
2117
2117
  # Constraints: If supplied, must match the name of an existing
2118
2118
  # DBSubnetGroup.
2119
2119
  #
2120
- # Example: `mySubnetgroup`
2120
+ # Example: `mydbsubnetgroup`
2121
2121
  #
2122
2122
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2123
2123
  # @option options [String] :option_group_name
@@ -2284,11 +2284,11 @@ module Aws::RDS
2284
2284
  # Specifies the storage type to be associated with the each DB instance
2285
2285
  # in the Multi-AZ DB cluster.
2286
2286
  #
2287
- # Valid values: `standard | gp2 | io1`
2287
+ # Valid values: `io1`
2288
2288
  #
2289
- # If you specify `io1`, also include a value for the `Iops` parameter.
2289
+ # When specified, a value for the `Iops` parameter is required.
2290
2290
  #
2291
- # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
2291
+ # Default: `io1`
2292
2292
  #
2293
2293
  # Valid for: Multi-AZ DB clusters only
2294
2294
  # @option options [Boolean] :publicly_accessible
@@ -211,7 +211,7 @@ module Aws::RDS
211
211
  #
212
212
  # **Aurora MySQL**
213
213
  #
214
- # Example: `aurora5.6`, `aurora-mysql5.7`
214
+ # Example: `aurora5.6`, `aurora-mysql5.7`, `aurora-mysql8.0`
215
215
  #
216
216
  # **Aurora PostgreSQL**
217
217
  #
@@ -246,7 +246,8 @@ module Aws::RDS
246
246
  #
247
247
  # * `aurora` (for MySQL 5.6-compatible Aurora)
248
248
  #
249
- # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
249
+ # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
250
+ # Aurora)
250
251
  #
251
252
  # * `aurora-postgresql`
252
253
  #
@@ -78,7 +78,14 @@ module Aws::RDS
78
78
  data[:allocated_storage]
79
79
  end
80
80
 
81
- # Specifies the status of this DB cluster snapshot.
81
+ # Specifies the status of this DB cluster snapshot. Valid statuses are
82
+ # the following:
83
+ #
84
+ # * `available`
85
+ #
86
+ # * `copying`
87
+ #
88
+ # * `creating`
82
89
  # @return [String]
83
90
  def status
84
91
  data[:status]
@@ -574,7 +581,7 @@ module Aws::RDS
574
581
  # "DBEngineVersions[].EngineVersion"`
575
582
  #
576
583
  # To list all of the available engine versions for MySQL 5.7-compatible
577
- # Aurora, use the following command:
584
+ # and MySQL 8.0-compatible Aurora, use the following command:
578
585
  #
579
586
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
580
587
  # "DBEngineVersions[].EngineVersion"`
@@ -638,7 +645,7 @@ module Aws::RDS
638
645
  # Constraints: If supplied, must match the name of an existing DB subnet
639
646
  # group.
640
647
  #
641
- # Example: `mySubnetgroup`
648
+ # Example: `mydbsubnetgroup`
642
649
  #
643
650
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
644
651
  # @option options [String] :database_name
@@ -804,12 +811,11 @@ module Aws::RDS
804
811
  # Specifies the storage type to be associated with the each DB instance
805
812
  # in the Multi-AZ DB cluster.
806
813
  #
807
- # Valid values: `standard | gp2 | io1`
814
+ # Valid values: `io1`
808
815
  #
809
- # If you specify `io1`, you must also include a value for the `Iops`
810
- # parameter.
816
+ # When specified, a value for the `Iops` parameter is required.
811
817
  #
812
- # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
818
+ # Default: `io1`
813
819
  #
814
820
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
815
821
  # @option options [Integer] :iops
@@ -940,7 +940,7 @@ module Aws::RDS
940
940
  #
941
941
  # ^
942
942
  #
943
- # **Amazon RDS Custom**
943
+ # **Amazon RDS Custom for Oracle**
944
944
  #
945
945
  # The Oracle System ID (SID) of the created RDS Custom DB instance. If
946
946
  # you don't specify a value, the default value is `ORCL`.
@@ -955,6 +955,10 @@ module Aws::RDS
955
955
  #
956
956
  # * It can't be a word reserved by the database engine.
957
957
  #
958
+ # **Amazon RDS Custom for SQL Server**
959
+ #
960
+ # Not applicable. Must be null.
961
+ #
958
962
  # **SQL Server**
959
963
  #
960
964
  # Not applicable. Must be null.
@@ -1005,9 +1009,11 @@ module Aws::RDS
1005
1009
  # following:
1006
1010
  #
1007
1011
  # * General Purpose (SSD) storage (gp2): Must be an integer from 40 to
1008
- # 65536.
1012
+ # 65536 for RDS Custom for Oracle, 16384 for RDS Custom for SQL
1013
+ # Server.
1009
1014
  #
1010
- # * Provisioned IOPS storage (io1): Must be an integer from 40 to 65536.
1015
+ # * Provisioned IOPS storage (io1): Must be an integer from 40 to 65536
1016
+ # for RDS Custom for Oracle, 16384 for RDS Custom for SQL Server.
1011
1017
  #
1012
1018
  # **MySQL**
1013
1019
  #
@@ -1068,21 +1074,21 @@ module Aws::RDS
1068
1074
  #
1069
1075
  # * General Purpose (SSD) storage (gp2):
1070
1076
  #
1071
- # * Enterprise and Standard editions: Must be an integer from 200 to
1077
+ # * Enterprise and Standard editions: Must be an integer from 20 to
1072
1078
  # 16384.
1073
1079
  #
1074
1080
  # * Web and Express editions: Must be an integer from 20 to 16384.
1075
1081
  #
1076
1082
  # * Provisioned IOPS storage (io1):
1077
1083
  #
1078
- # * Enterprise and Standard editions: Must be an integer from 200 to
1084
+ # * Enterprise and Standard editions: Must be an integer from 100 to
1079
1085
  # 16384.
1080
1086
  #
1081
1087
  # * Web and Express editions: Must be an integer from 100 to 16384.
1082
1088
  #
1083
1089
  # * Magnetic storage (standard):
1084
1090
  #
1085
- # * Enterprise and Standard editions: Must be an integer from 200 to
1091
+ # * Enterprise and Standard editions: Must be an integer from 20 to
1086
1092
  # 1024.
1087
1093
  #
1088
1094
  # * Web and Express editions: Must be an integer from 20 to 1024.
@@ -1106,11 +1112,18 @@ module Aws::RDS
1106
1112
  #
1107
1113
  # * `aurora` (for MySQL 5.6-compatible Aurora)
1108
1114
  #
1109
- # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
1115
+ # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
1116
+ # Aurora)
1110
1117
  #
1111
1118
  # * `aurora-postgresql`
1112
1119
  #
1113
- # * `custom-oracle-ee (for RDS Custom instances)`
1120
+ # * `custom-oracle-ee (for RDS Custom for Oracle instances)`
1121
+ #
1122
+ # * `custom-sqlserver-ee (for RDS Custom for SQL Server instances)`
1123
+ #
1124
+ # * `custom-sqlserver-se (for RDS Custom for SQL Server instances)`
1125
+ #
1126
+ # * `custom-sqlserver-web (for RDS Custom for SQL Server instances)`
1114
1127
  #
1115
1128
  # * `mariadb`
1116
1129
  #
@@ -1200,6 +1213,10 @@ module Aws::RDS
1200
1213
  # information on Amazon Web Services Regions and Availability Zones, see
1201
1214
  # [Regions and Availability Zones][1].
1202
1215
  #
1216
+ # **Amazon Aurora**
1217
+ #
1218
+ # Not applicable. Availability Zones are managed by the DB cluster.
1219
+ #
1203
1220
  # Default: A random, system-chosen Availability Zone in the endpoint's
1204
1221
  # Amazon Web Services Region.
1205
1222
  #
@@ -1226,7 +1243,10 @@ module Aws::RDS
1226
1243
  # @option options [String] :db_subnet_group_name
1227
1244
  # A DB subnet group to associate with this DB instance.
1228
1245
  #
1229
- # If there is no DB subnet group, then it is a non-VPC DB instance.
1246
+ # Constraints: Must match the name of an existing DBSubnetGroup. Must
1247
+ # not be default.
1248
+ #
1249
+ # Example: `mydbsubnetgroup`
1230
1250
  # @option options [String] :preferred_maintenance_window
1231
1251
  # The time range each week during which system maintenance can occur, in
1232
1252
  # Universal Coordinated Time (UTC). For more information, see [Amazon
@@ -1277,7 +1297,7 @@ module Aws::RDS
1277
1297
  #
1278
1298
  # * Can't be set to 0 if the DB instance is a source to read replicas
1279
1299
  #
1280
- # * Can't be set to 0 or 35 for an RDS Custom DB instance
1300
+ # * Can't be set to 0 or 35 for an RDS Custom for Oracle DB instance
1281
1301
  # @option options [String] :preferred_backup_window
1282
1302
  # The daily time range during which automated backups are created if
1283
1303
  # automated backups are enabled, using the `BackupRetentionPeriod`
@@ -1372,47 +1392,53 @@ module Aws::RDS
1372
1392
  # Not applicable. The version number of the database engine to be used
1373
1393
  # by the DB instance is managed by the DB cluster.
1374
1394
  #
1375
- # **Amazon RDS Custom**
1395
+ # **Amazon RDS Custom for Oracle**
1376
1396
  #
1377
1397
  # A custom engine version (CEV) that you have previously created. This
1378
- # setting is required for RDS Custom. The CEV name has the following
1379
- # format: `19.customized_string `. An example identifier is
1380
- # `19.my_cev1`. For more information, see [ Creating an RDS Custom DB
1381
- # instance][1] in the *Amazon RDS User Guide.*.
1398
+ # setting is required for RDS Custom for Oracle. The CEV name has the
1399
+ # following format: `19.customized_string `. An example identifier is
1400
+ # `19.my_cev1`. For more information, see [ Creating an RDS Custom for
1401
+ # Oracle DB instance][1] in the *Amazon RDS User Guide.*.
1402
+ #
1403
+ # **Amazon RDS Custom for SQL Server**
1404
+ #
1405
+ # See [RDS Custom for SQL Server general requirements][2] in the *Amazon
1406
+ # RDS User Guide.*
1382
1407
  #
1383
1408
  # **MariaDB**
1384
1409
  #
1385
- # For information, see [MariaDB on Amazon RDS Versions][2] in the
1410
+ # For information, see [MariaDB on Amazon RDS Versions][3] in the
1386
1411
  # *Amazon RDS User Guide.*
1387
1412
  #
1388
1413
  # **Microsoft SQL Server**
1389
1414
  #
1390
- # For information, see [Microsoft SQL Server Versions on Amazon RDS][3]
1415
+ # For information, see [Microsoft SQL Server Versions on Amazon RDS][4]
1391
1416
  # in the *Amazon RDS User Guide.*
1392
1417
  #
1393
1418
  # **MySQL**
1394
1419
  #
1395
- # For information, see [MySQL on Amazon RDS Versions][4] in the *Amazon
1420
+ # For information, see [MySQL on Amazon RDS Versions][5] in the *Amazon
1396
1421
  # RDS User Guide.*
1397
1422
  #
1398
1423
  # **Oracle**
1399
1424
  #
1400
- # For information, see [Oracle Database Engine Release Notes][5] in the
1425
+ # For information, see [Oracle Database Engine Release Notes][6] in the
1401
1426
  # *Amazon RDS User Guide.*
1402
1427
  #
1403
1428
  # **PostgreSQL**
1404
1429
  #
1405
1430
  # For information, see [Amazon RDS for PostgreSQL versions and
1406
- # extensions][6] in the *Amazon RDS User Guide.*
1431
+ # extensions][7] in the *Amazon RDS User Guide.*
1407
1432
  #
1408
1433
  #
1409
1434
  #
1410
1435
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-creating.html#custom-creating.create
1411
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
1412
- # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
1413
- # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
1414
- # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
1415
- # [6]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
1436
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-reqs-limits.html#custom-reqs-limits.reqsMS
1437
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
1438
+ # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
1439
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
1440
+ # [6]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
1441
+ # [7]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
1416
1442
  # @option options [Boolean] :auto_minor_version_upgrade
1417
1443
  # A value that indicates whether minor engine upgrades are applied
1418
1444
  # automatically to the DB instance during the maintenance window. By
@@ -1529,9 +1555,8 @@ module Aws::RDS
1529
1555
  # A value that indicates whether the DB instance is encrypted. By
1530
1556
  # default, it isn't encrypted.
1531
1557
  #
1532
- # For RDS Custom Oracle instances, either set this parameter to `true`
1533
- # or leave it unset. If you set this parameter to `false`, RDS reports
1534
- # an error.
1558
+ # For RDS Custom instances, either set this parameter to `true` or leave
1559
+ # it unset. If you set this parameter to `false`, RDS reports an error.
1535
1560
  #
1536
1561
  # **Amazon Aurora**
1537
1562
  #
@@ -1559,11 +1584,11 @@ module Aws::RDS
1559
1584
  #
1560
1585
  # **Amazon RDS Custom**
1561
1586
  #
1562
- # A KMS key is required for RDS Custom Oracle instances. For most RDS
1563
- # engines, if you leave this parameter empty while enabling
1564
- # `StorageEncrypted`, the engine uses the default KMS key. However, RDS
1565
- # Custom for Oracle doesn't use the default key when this parameter is
1566
- # empty. You must explicitly specify a key.
1587
+ # A KMS key is required for RDS Custom instances. For most RDS engines,
1588
+ # if you leave this parameter empty while enabling `StorageEncrypted`,
1589
+ # the engine uses the default KMS key. However, RDS Custom doesn't use
1590
+ # the default key when this parameter is empty. You must explicitly
1591
+ # specify a key.
1567
1592
  # @option options [String] :domain
1568
1593
  # The Active Directory directory ID to create the DB instance in.
1569
1594
  # Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
@@ -1992,7 +2017,7 @@ module Aws::RDS
1992
2017
  # * Not specify a DB subnet group. All these read replicas are created
1993
2018
  # outside of any VPC.
1994
2019
  #
1995
- # Example: `mySubnetgroup`
2020
+ # Example: `mydbsubnetgroup`
1996
2021
  # @option options [Array<String>] :vpc_security_group_ids
1997
2022
  # A list of Amazon EC2 VPC security groups to associate with the read
1998
2023
  # replica.
@@ -2489,7 +2514,7 @@ module Aws::RDS
2489
2514
  # change. The change is applied during the next maintenance window,
2490
2515
  # unless `ApplyImmediately` is enabled for this request.
2491
2516
  #
2492
- # This setting doesn't apply to RDS Custom.
2517
+ # This setting doesn't apply to RDS Custom for Oracle.
2493
2518
  #
2494
2519
  # Default: Uses existing setting
2495
2520
  #
@@ -2512,7 +2537,7 @@ module Aws::RDS
2512
2537
  # Constraints: If supplied, must match the name of an existing
2513
2538
  # DBSubnetGroup.
2514
2539
  #
2515
- # Example: `mySubnetGroup`
2540
+ # Example: `mydbsubnetgroup`
2516
2541
  #
2517
2542
  #
2518
2543
  #
@@ -2556,7 +2581,7 @@ module Aws::RDS
2556
2581
  # during the next maintenance window. Some parameter changes can cause
2557
2582
  # an outage and are applied on the next call to RebootDBInstance, or the
2558
2583
  # next failure reboot. Review the table of parameters in [Modifying a DB
2559
- # Instance][1] in the *Amazon RDS User Guide.* to see the impact of
2584
+ # Instance][1] in the *Amazon RDS User Guide* to see the impact of
2560
2585
  # enabling or disabling `ApplyImmediately` for each modified parameter
2561
2586
  # and to determine when the changes are applied.
2562
2587
  #
@@ -2653,7 +2678,7 @@ module Aws::RDS
2653
2678
  #
2654
2679
  # * It must be a value from 0 to 35. It can't be set to 0 if the DB
2655
2680
  # instance is a source to read replicas. It can't be set to 0 or 35
2656
- # for an RDS Custom DB instance.
2681
+ # for an RDS Custom for Oracle DB instance.
2657
2682
  #
2658
2683
  # * It can be specified for a MySQL read replica only if the source is
2659
2684
  # running MySQL 5.6 or later.
@@ -2736,8 +2761,8 @@ module Aws::RDS
2736
2761
  # lower. For information about valid engine versions, see
2737
2762
  # `CreateDBInstance`, or call `DescribeDBEngineVersions`.
2738
2763
  #
2739
- # In RDS Custom, this parameter is supported for read replicas only if
2740
- # they are in the `PATCH_DB_FAILURE` lifecycle.
2764
+ # In RDS Custom for Oracle, this parameter is supported for read
2765
+ # replicas only if they are in the `PATCH_DB_FAILURE` lifecycle.
2741
2766
  # @option options [Boolean] :allow_major_version_upgrade
2742
2767
  # A value that indicates whether major version upgrades are allowed.
2743
2768
  # Changing this parameter doesn't result in an outage and the change is
@@ -2983,8 +3008,6 @@ module Aws::RDS
2983
3008
  #
2984
3009
  # Changes to the `PubliclyAccessible` parameter are applied immediately
2985
3010
  # regardless of the value of the `ApplyImmediately` parameter.
2986
- #
2987
- # This setting doesn't apply to RDS Custom.
2988
3011
  # @option options [String] :monitoring_role_arn
2989
3012
  # The ARN for the IAM role that permits RDS to send enhanced monitoring
2990
3013
  # metrics to Amazon CloudWatch Logs. For example,
@@ -3394,7 +3417,7 @@ module Aws::RDS
3394
3417
  # Constraints: If supplied, must match the name of an existing
3395
3418
  # DBSubnetGroup.
3396
3419
  #
3397
- # Example: `mySubnetgroup`
3420
+ # Example: `mydbsubnetgroup`
3398
3421
  # @option options [Boolean] :multi_az
3399
3422
  # A value that indicates whether the DB instance is a Multi-AZ
3400
3423
  # deployment.
@@ -228,7 +228,8 @@ module Aws::RDS
228
228
  #
229
229
  # * `aurora` (for MySQL 5.6-compatible Aurora)
230
230
  #
231
- # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
231
+ # * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
232
+ # Aurora)
232
233
  #
233
234
  # * `aurora-postgresql`
234
235
  #
@@ -349,25 +350,35 @@ module Aws::RDS
349
350
  # @option options [required, Array<Types::Parameter>] :parameters
350
351
  # An array of parameter names, values, and the application methods for
351
352
  # the parameter update. At least one parameter name, value, and
352
- # application method method must be supplied; later arguments are
353
- # optional. A maximum of 20 parameters can be modified in a single
354
- # request.
353
+ # application method must be supplied; later arguments are optional. A
354
+ # maximum of 20 parameters can be modified in a single request.
355
355
  #
356
356
  # Valid Values (for the application method): `immediate |
357
357
  # pending-reboot`
358
358
  #
359
- # <note markdown="1"> You can use the `immediate` value with dynamic parameters only. You
359
+ # You can use the `immediate` value with dynamic parameters only. You
360
360
  # can use the `pending-reboot` value for both dynamic and static
361
361
  # parameters.
362
362
  #
363
- # When the application method is `immediate`, changes to dynamic
363
+ # When the application method is `immediate`, changes to dynamic
364
364
  # parameters are applied immediately to the DB instances associated with
365
- # the parameter group. When the application method is `pending-reboot`,
366
- # changes to dynamic and static parameters are applied after a reboot
367
- # without failover to the DB instances associated with the parameter
368
- # group.
365
+ # the parameter group.
366
+ #
367
+ # When the application method is `pending-reboot`, changes to dynamic
368
+ # and static parameters are applied after a reboot without failover to
369
+ # the DB instances associated with the parameter group.
370
+ #
371
+ # <note markdown="1"> You can't use `pending-reboot` with dynamic parameters on RDS for SQL
372
+ # Server DB instances. Use `immediate`.
369
373
  #
370
374
  # </note>
375
+ #
376
+ # For more information on modifying DB parameters, see [Working with DB
377
+ # parameter groups][1] in the *Amazon RDS User Guide*.
378
+ #
379
+ #
380
+ #
381
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html
371
382
  # @return [DBParameterGroup]
372
383
  def modify(options = {})
373
384
  options = options.merge(db_parameter_group_name: @name)
@@ -679,7 +679,7 @@ module Aws::RDS
679
679
  # Constraints: If supplied, must match the name of an existing
680
680
  # DBSubnetGroup.
681
681
  #
682
- # Example: `mySubnetgroup`
682
+ # Example: `mydbsubnetgroup`
683
683
  # @option options [Boolean] :multi_az
684
684
  # A value that indicates whether the DB instance is a Multi-AZ
685
685
  # deployment.
@@ -831,8 +831,21 @@ module Aws::RDS
831
831
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
832
832
  # @option options [Boolean] :copy_tags_to_snapshot
833
833
  # A value that indicates whether to copy all tags from the restored DB
834
- # instance to snapshots of the DB instance. By default, tags are not
835
- # copied.
834
+ # instance to snapshots of the DB instance.
835
+ #
836
+ # In most cases, tags aren't copied by default. However, when you
837
+ # restore a DB instance from a DB snapshot, RDS checks whether you
838
+ # specify new tags. If yes, the new tags are added to the restored DB
839
+ # instance. If there are no new tags, RDS looks for the tags from the
840
+ # source DB instance for the DB snapshot, and then adds those tags to
841
+ # the restored DB instance.
842
+ #
843
+ # For more information, see [ Copying tags to DB instance snapshots][1]
844
+ # in the *Amazon RDS User Guide*.
845
+ #
846
+ #
847
+ #
848
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html#USER_Tagging.CopyTags
836
849
  # @option options [String] :domain_iam_role_name
837
850
  # Specify the name of the IAM role to be used when making API calls to
838
851
  # the Directory Service.
@@ -935,8 +948,7 @@ module Aws::RDS
935
948
  # start with the prefix `AWSRDSCustom`.
936
949
  #
937
950
  # For the list of permissions required for the IAM role, see [ Configure
938
- # IAM and your VPC][1] in the *Amazon Relational Database Service User
939
- # Guide*.
951
+ # IAM and your VPC][1] in the *Amazon RDS User Guide*.
940
952
  #
941
953
  # This setting is required for RDS Custom.
942
954
  #
@@ -264,6 +264,9 @@ module Aws::RDS
264
264
  #
265
265
  # * If the source type is a DB cluster snapshot, a
266
266
  # `DBClusterSnapshotIdentifier` value must be supplied.
267
+ #
268
+ # * If the source type is an RDS Proxy, a `DBProxyName` value must be
269
+ # supplied.
267
270
  # @return [EventSubscription]
268
271
  def add_subscriber(options = {})
269
272
  options = options.merge(subscription_name: @name)
@@ -298,20 +301,24 @@ module Aws::RDS
298
301
  # @option options [String] :source_type
299
302
  # The type of source that is generating the events. For example, if you
300
303
  # want to be notified of events generated by a DB instance, you set this
301
- # parameter to `db-instance`. If this value isn't specified, all events
302
- # are returned.
304
+ # parameter to `db-instance`. For RDS Proxy events, specify `db-proxy`.
305
+ # If this value isn't specified, all events are returned.
303
306
  #
304
307
  # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
305
- # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
308
+ # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot` \|
309
+ # `db-proxy`
306
310
  # @option options [Array<String>] :event_categories
307
311
  # A list of event categories for a particular source type (`SourceType`)
308
312
  # that you want to subscribe to. You can see a list of the categories
309
- # for a given source type in [Events][1] in the *Amazon RDS User Guide*
310
- # or by using the `DescribeEventCategories` operation.
313
+ # for a given source type in the "Amazon RDS event categories and event
314
+ # messages" section of the [ *Amazon RDS User Guide* ][1] or the [
315
+ # *Amazon Aurora User Guide* ][2]. You can also see this list by using
316
+ # the `DescribeEventCategories` operation.
311
317
  #
312
318
  #
313
319
  #
314
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.html
320
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Events.Messages.html
321
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_Events.Messages.html
315
322
  # @option options [Array<String>] :source_ids
316
323
  # The list of identifiers of the event sources for which events are
317
324
  # returned. If not specified, then all sources are included in the
@@ -340,6 +347,9 @@ module Aws::RDS
340
347
  #
341
348
  # * If the source type is a DB cluster snapshot, a
342
349
  # `DBClusterSnapshotIdentifier` value must be supplied.
350
+ #
351
+ # * If the source type is an RDS Proxy, a `DBProxyName` value must be
352
+ # supplied.
343
353
  # @option options [Boolean] :enabled
344
354
  # A value that indicates whether to activate the subscription. If the
345
355
  # event notification subscription isn't activated, the subscription is
@@ -393,11 +403,12 @@ module Aws::RDS
393
403
  # @option options [String] :source_type
394
404
  # The type of source that is generating the events. For example, if you
395
405
  # want to be notified of events generated by a DB instance, you would
396
- # set this parameter to db-instance. If this value isn't specified, all
397
- # events are returned.
406
+ # set this parameter to db-instance. For RDS Proxy events, specify
407
+ # `db-proxy`. If this value isn't specified, all events are returned.
398
408
  #
399
409
  # Valid values: `db-instance` \| `db-cluster` \| `db-parameter-group` \|
400
- # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot`
410
+ # `db-security-group` \| `db-snapshot` \| `db-cluster-snapshot` \|
411
+ # `db-proxy`
401
412
  # @option options [Array<String>] :event_categories
402
413
  # A list of event categories for a source type (`SourceType`) that you
403
414
  # want to subscribe to. You can see a list of the categories for a given