aws-sdk-rds 1.128.0 → 1.129.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -189,7 +189,8 @@ module Aws::RDS
189
189
  data[:latest_restorable_time]
190
190
  end
191
191
 
192
- # Specifies if the DB instance is a Multi-AZ deployment.
192
+ # Specifies if the DB instance is a Multi-AZ deployment. This setting
193
+ # doesn't apply to RDS Custom.
193
194
  # @return [Boolean]
194
195
  def multi_az
195
196
  data[:multi_az]
@@ -252,7 +253,8 @@ module Aws::RDS
252
253
  data[:replica_mode]
253
254
  end
254
255
 
255
- # License model information for this DB instance.
256
+ # License model information for this DB instance. This setting doesn't
257
+ # apply to RDS Custom.
256
258
  # @return [String]
257
259
  def license_model
258
260
  data[:license_model]
@@ -355,8 +357,7 @@ module Aws::RDS
355
357
  # identifier for the encrypted DB instance.
356
358
  #
357
359
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
358
- # alias ARN, or alias name for the Amazon Web Services KMS customer
359
- # master key (CMK).
360
+ # alias ARN, or alias name for the KMS key.
360
361
  # @return [String]
361
362
  def kms_key_id
362
363
  data[:kms_key_id]
@@ -364,8 +365,8 @@ module Aws::RDS
364
365
 
365
366
  # The Amazon Web Services Region-unique, immutable identifier for the DB
366
367
  # instance. This identifier is found in Amazon Web Services CloudTrail
367
- # log entries whenever the Amazon Web Services KMS customer master key
368
- # (CMK) for the DB instance is accessed.
368
+ # log entries whenever the Amazon Web Services KMS key for the DB
369
+ # instance is accessed.
369
370
  # @return [String]
370
371
  def dbi_resource_id
371
372
  data[:dbi_resource_id]
@@ -474,8 +475,7 @@ module Aws::RDS
474
475
  # Performance Insights data.
475
476
  #
476
477
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
477
- # alias ARN, or alias name for the Amazon Web Services KMS customer
478
- # master key (CMK).
478
+ # alias ARN, or alias name for the KMS key.
479
479
  # @return [String]
480
480
  def performance_insights_kms_key_id
481
481
  data[:performance_insights_kms_key_id]
@@ -601,7 +601,7 @@ module Aws::RDS
601
601
  # The Amazon Web Services KMS key identifier used for encrypting
602
602
  # messages in the database activity stream. The Amazon Web Services KMS
603
603
  # key identifier is the key ARN, key ID, alias ARN, or alias name for
604
- # the Amazon Web Services KMS customer master key (CMK).
604
+ # the KMS key.
605
605
  # @return [String]
606
606
  def activity_stream_kms_key_id
607
607
  data[:activity_stream_kms_key_id]
@@ -629,6 +629,47 @@ module Aws::RDS
629
629
  data[:activity_stream_engine_native_audit_fields_included]
630
630
  end
631
631
 
632
+ # The automation mode of the RDS Custom DB instance: `full` or `all
633
+ # paused`. If `full`, the DB instance automates monitoring and instance
634
+ # recovery. If `all paused`, the instance pauses automation for the
635
+ # duration set by `--resume-full-automation-mode-minutes`.
636
+ # @return [String]
637
+ def automation_mode
638
+ data[:automation_mode]
639
+ end
640
+
641
+ # The number of minutes to pause the automation. When the time period
642
+ # ends, RDS Custom resumes full automation. The minimum value is 60
643
+ # (default). The maximum value is 1,440.
644
+ # @return [Time]
645
+ def resume_full_automation_mode_time
646
+ data[:resume_full_automation_mode_time]
647
+ end
648
+
649
+ # The instance profile associated with the underlying Amazon EC2
650
+ # instance of an RDS Custom DB instance. The instance profile must meet
651
+ # the following requirements:
652
+ #
653
+ # * The profile must exist in your account.
654
+ #
655
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
656
+ # assume.
657
+ #
658
+ # * The instance profile name and the associated IAM role name must
659
+ # start with the prefix `AWSRDSCustom`.
660
+ #
661
+ # For the list of permissions required for the IAM role, see [ Configure
662
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
663
+ # Guide*.
664
+ #
665
+ #
666
+ #
667
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
668
+ # @return [String]
669
+ def custom_iam_instance_profile
670
+ data[:custom_iam_instance_profile]
671
+ end
672
+
632
673
  # @!endgroup
633
674
 
634
675
  # @return [Client]
@@ -823,6 +864,7 @@ module Aws::RDS
823
864
  # deletion_protection: false,
824
865
  # max_allocated_storage: 1,
825
866
  # enable_customer_owned_ip: false,
867
+ # custom_iam_instance_profile: "String",
826
868
  # })
827
869
  # @param [Hash] options ({})
828
870
  # @option options [String] :db_name
@@ -888,6 +930,21 @@ module Aws::RDS
888
930
  #
889
931
  # ^
890
932
  #
933
+ # **Amazon RDS Custom**
934
+ #
935
+ # The Oracle System ID (SID) of the created RDS Custom DB instance. If
936
+ # you don't specify a value, the default value is `ORCL`.
937
+ #
938
+ # Default: `ORCL`
939
+ #
940
+ # Constraints:
941
+ #
942
+ # * It must contain 1 to 8 alphanumeric characters.
943
+ #
944
+ # * It must contain a letter.
945
+ #
946
+ # * It can't be a word reserved by the database engine.
947
+ #
891
948
  # **SQL Server**
892
949
  #
893
950
  # Not applicable. Must be null.
@@ -932,6 +989,16 @@ module Aws::RDS
932
989
  # amount of data in your database increases, though you are only charged
933
990
  # for the space that you use in an Aurora cluster volume.
934
991
  #
992
+ # **Amazon RDS Custom**
993
+ #
994
+ # Constraints to the amount of storage for each storage type are the
995
+ # following:
996
+ #
997
+ # * General Purpose (SSD) storage (gp2): Must be an integer from 40 to
998
+ # 65536.
999
+ #
1000
+ # * Provisioned IOPS storage (io1): Must be an integer from 40 to 65536.
1001
+ #
935
1002
  # **MySQL**
936
1003
  #
937
1004
  # Constraints to the amount of storage for each storage type are the
@@ -1033,6 +1100,8 @@ module Aws::RDS
1033
1100
  #
1034
1101
  # * `aurora-postgresql`
1035
1102
  #
1103
+ # * `custom-oracle-ee (for RDS Custom instances)`
1104
+ #
1036
1105
  # * `mariadb`
1037
1106
  #
1038
1107
  # * `mysql`
@@ -1217,6 +1286,8 @@ module Aws::RDS
1217
1286
  # If you do not specify a value, then the default DB parameter group for
1218
1287
  # the specified DB engine and version is used.
1219
1288
  #
1289
+ # This setting doesn't apply to RDS Custom.
1290
+ #
1220
1291
  # Constraints:
1221
1292
  #
1222
1293
  # * Must be 1 to 255 letters, numbers, or hyphens.
@@ -1241,6 +1312,8 @@ module Aws::RDS
1241
1312
  # * Must be a value from 0 to 35
1242
1313
  #
1243
1314
  # * Can't be set to 0 if the DB instance is a source to read replicas
1315
+ #
1316
+ # * Can't be set to 0 or 35 for an RDS Custom DB instance
1244
1317
  # @option options [String] :preferred_backup_window
1245
1318
  # The daily time range during which automated backups are created if
1246
1319
  # automated backups are enabled, using the `BackupRetentionPeriod`
@@ -1317,6 +1390,8 @@ module Aws::RDS
1317
1390
  # A value that indicates whether the DB instance is a Multi-AZ
1318
1391
  # deployment. You can't set the `AvailabilityZone` parameter if the DB
1319
1392
  # instance is a Multi-AZ deployment.
1393
+ #
1394
+ # This setting doesn't apply to RDS Custom.
1320
1395
  # @option options [String] :engine_version
1321
1396
  # The version number of the database engine to use.
1322
1397
  #
@@ -1333,46 +1408,60 @@ module Aws::RDS
1333
1408
  # Not applicable. The version number of the database engine to be used
1334
1409
  # by the DB instance is managed by the DB cluster.
1335
1410
  #
1411
+ # **Amazon RDS Custom**
1412
+ #
1413
+ # A custom engine version (CEV) that you have previously created. This
1414
+ # setting is required for RDS Custom. The CEV name has the following
1415
+ # format: `19.customized_string `. An example identifier is
1416
+ # `19.my_cev1`. For more information, see [ Creating an RDS Custom DB
1417
+ # instance][1] in the *Amazon RDS User Guide.*.
1418
+ #
1336
1419
  # **MariaDB**
1337
1420
  #
1338
- # See [MariaDB on Amazon RDS Versions][1] in the *Amazon RDS User
1421
+ # See [MariaDB on Amazon RDS Versions][2] in the *Amazon RDS User
1339
1422
  # Guide.*
1340
1423
  #
1341
1424
  # **Microsoft SQL Server**
1342
1425
  #
1343
- # See [Microsoft SQL Server Versions on Amazon RDS][2] in the *Amazon
1426
+ # See [Microsoft SQL Server Versions on Amazon RDS][3] in the *Amazon
1344
1427
  # RDS User Guide.*
1345
1428
  #
1346
1429
  # **MySQL**
1347
1430
  #
1348
- # See [MySQL on Amazon RDS Versions][3] in the *Amazon RDS User Guide.*
1431
+ # See [MySQL on Amazon RDS Versions][4] in the *Amazon RDS User Guide.*
1349
1432
  #
1350
1433
  # **Oracle**
1351
1434
  #
1352
- # See [Oracle Database Engine Release Notes][4] in the *Amazon RDS User
1435
+ # See [Oracle Database Engine Release Notes][5] in the *Amazon RDS User
1353
1436
  # Guide.*
1354
1437
  #
1355
1438
  # **PostgreSQL**
1356
1439
  #
1357
- # See [Amazon RDS for PostgreSQL versions and extensions][5] in the
1440
+ # See [Amazon RDS for PostgreSQL versions and extensions][6] in the
1358
1441
  # *Amazon RDS User Guide.*
1359
1442
  #
1360
1443
  #
1361
1444
  #
1362
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
1363
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
1364
- # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
1365
- # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
1366
- # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
1445
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-creating.html#custom-creating.create
1446
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
1447
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
1448
+ # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
1449
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
1450
+ # [6]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
1367
1451
  # @option options [Boolean] :auto_minor_version_upgrade
1368
1452
  # A value that indicates whether minor engine upgrades are applied
1369
1453
  # automatically to the DB instance during the maintenance window. By
1370
1454
  # default, minor engine upgrades are applied automatically.
1455
+ #
1456
+ # If you create an RDS Custom DB instance, you must set
1457
+ # `AutoMinorVersionUpgrade` to `false`.
1371
1458
  # @option options [String] :license_model
1372
1459
  # License model information for this DB instance.
1373
1460
  #
1374
1461
  # Valid values: `license-included` \| `bring-your-own-license` \|
1375
1462
  # `general-public-license`
1463
+ #
1464
+ # This setting doesn't apply to RDS Custom.
1376
1465
  # @option options [Integer] :iops
1377
1466
  # The amount of Provisioned IOPS (input/output operations per second) to
1378
1467
  # be initially allocated for the DB instance. For information about
@@ -1393,11 +1482,16 @@ module Aws::RDS
1393
1482
  #
1394
1483
  # Permanent options, such as the TDE option for Oracle Advanced Security
1395
1484
  # TDE, can't be removed from an option group. Also, that option group
1396
- # can't be removed from a DB instance once it is associated with a DB
1397
- # instance
1485
+ # can't be removed from a DB instance after it is associated with a DB
1486
+ # instance.
1487
+ #
1488
+ # This setting doesn't apply to RDS Custom.
1398
1489
  # @option options [String] :character_set_name
1399
- # For supported engines, indicates that the DB instance should be
1400
- # associated with the specified CharacterSet.
1490
+ # For supported engines, this value indicates that the DB instance
1491
+ # should be associated with the specified `CharacterSet`.
1492
+ #
1493
+ # This setting doesn't apply to RDS Custom. However, if you need to
1494
+ # change the character set, you can change it on the database itself.
1401
1495
  #
1402
1496
  # **Amazon Aurora**
1403
1497
  #
@@ -1405,6 +1499,8 @@ module Aws::RDS
1405
1499
  # more information, see `CreateDBCluster`.
1406
1500
  # @option options [String] :nchar_character_set_name
1407
1501
  # The name of the NCHAR character set for the Oracle DB instance.
1502
+ #
1503
+ # This parameter doesn't apply to RDS Custom.
1408
1504
  # @option options [Boolean] :publicly_accessible
1409
1505
  # A value that indicates whether the DB instance is publicly accessible.
1410
1506
  #
@@ -1442,6 +1538,8 @@ module Aws::RDS
1442
1538
  # Tags to assign to the DB instance.
1443
1539
  # @option options [String] :db_cluster_identifier
1444
1540
  # The identifier of the DB cluster that the instance will belong to.
1541
+ #
1542
+ # This setting doesn't apply to RDS Custom.
1445
1543
  # @option options [String] :storage_type
1446
1544
  # Specifies the storage type to be associated with the DB instance.
1447
1545
  #
@@ -1454,13 +1552,21 @@ module Aws::RDS
1454
1552
  # @option options [String] :tde_credential_arn
1455
1553
  # The ARN from the key store with which to associate the instance for
1456
1554
  # TDE encryption.
1555
+ #
1556
+ # This setting doesn't apply to RDS Custom.
1457
1557
  # @option options [String] :tde_credential_password
1458
1558
  # The password for the given ARN from the key store in order to access
1459
1559
  # the device.
1560
+ #
1561
+ # This setting doesn't apply to RDS Custom.
1460
1562
  # @option options [Boolean] :storage_encrypted
1461
1563
  # A value that indicates whether the DB instance is encrypted. By
1462
1564
  # default, it isn't encrypted.
1463
1565
  #
1566
+ # For RDS Custom Oracle instances, either set this parameter to `true`
1567
+ # or leave it unset. If you set this parameter to `false`, RDS reports
1568
+ # an error.
1569
+ #
1464
1570
  # **Amazon Aurora**
1465
1571
  #
1466
1572
  # Not applicable. The encryption for DB instances is managed by the DB
@@ -1470,9 +1576,9 @@ module Aws::RDS
1470
1576
  # instance.
1471
1577
  #
1472
1578
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
1473
- # alias ARN, or alias name for the Amazon Web Services KMS customer
1474
- # master key (CMK). To use a CMK in a different Amazon Web Services
1475
- # account, specify the key ARN or alias ARN.
1579
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
1580
+ # different Amazon Web Services account, specify the key ARN or alias
1581
+ # ARN.
1476
1582
  #
1477
1583
  # **Amazon Aurora**
1478
1584
  #
@@ -1480,10 +1586,18 @@ module Aws::RDS
1480
1586
  # by the DB cluster. For more information, see `CreateDBCluster`.
1481
1587
  #
1482
1588
  # If `StorageEncrypted` is enabled, and you do not specify a value for
1483
- # the `KmsKeyId` parameter, then Amazon RDS uses your default CMK. There
1484
- # is a default CMK for your Amazon Web Services account. Your Amazon Web
1485
- # Services account has a different default CMK for each Amazon Web
1486
- # Services Region.
1589
+ # the `KmsKeyId` parameter, then Amazon RDS uses your default KMS key.
1590
+ # There is a default KMS key for your Amazon Web Services account. Your
1591
+ # Amazon Web Services account has a different default KMS key for each
1592
+ # Amazon Web Services Region.
1593
+ #
1594
+ # **Amazon RDS Custom**
1595
+ #
1596
+ # A KMS key is required for RDS Custom Oracle instances. For most RDS
1597
+ # engines, if you leave this parameter empty while enabling
1598
+ # `StorageEncrypted`, the engine uses the default KMS key. However, RDS
1599
+ # Custom for Oracle doesn't use the default key when this parameter is
1600
+ # empty. You must explicitly specify a key.
1487
1601
  # @option options [String] :domain
1488
1602
  # The Active Directory directory ID to create the DB instance in.
1489
1603
  # Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
@@ -1492,6 +1606,8 @@ module Aws::RDS
1492
1606
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
1493
1607
  # RDS User Guide*.
1494
1608
  #
1609
+ # This setting doesn't apply to RDS Custom.
1610
+ #
1495
1611
  #
1496
1612
  #
1497
1613
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -1506,35 +1622,43 @@ module Aws::RDS
1506
1622
  # the DB cluster setting.
1507
1623
  # @option options [Integer] :monitoring_interval
1508
1624
  # The interval, in seconds, between points when Enhanced Monitoring
1509
- # metrics are collected for the DB instance. To disable collecting
1625
+ # metrics are collected for the DB instance. To disable collection of
1510
1626
  # Enhanced Monitoring metrics, specify 0. The default is 0.
1511
1627
  #
1512
- # If `MonitoringRoleArn` is specified, then you must also set
1628
+ # If `MonitoringRoleArn` is specified, then you must set
1513
1629
  # `MonitoringInterval` to a value other than 0.
1514
1630
  #
1631
+ # This setting doesn't apply to RDS Custom.
1632
+ #
1515
1633
  # Valid Values: `0, 1, 5, 10, 15, 30, 60`
1516
1634
  # @option options [String] :monitoring_role_arn
1517
1635
  # The ARN for the IAM role that permits RDS to send enhanced monitoring
1518
1636
  # metrics to Amazon CloudWatch Logs. For example,
1519
1637
  # `arn:aws:iam:123456789012:role/emaccess`. For information on creating
1520
- # a monitoring role, go to [Setting Up and Enabling Enhanced
1638
+ # a monitoring role, see [Setting Up and Enabling Enhanced
1521
1639
  # Monitoring][1] in the *Amazon RDS User Guide*.
1522
1640
  #
1523
1641
  # If `MonitoringInterval` is set to a value other than 0, then you must
1524
1642
  # supply a `MonitoringRoleArn` value.
1525
1643
  #
1644
+ # This setting doesn't apply to RDS Custom.
1645
+ #
1526
1646
  #
1527
1647
  #
1528
1648
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
1529
1649
  # @option options [String] :domain_iam_role_name
1530
1650
  # Specify the name of the IAM role to be used when making API calls to
1531
1651
  # the Directory Service.
1652
+ #
1653
+ # This setting doesn't apply to RDS Custom.
1532
1654
  # @option options [Integer] :promotion_tier
1533
1655
  # A value that specifies the order in which an Aurora Replica is
1534
1656
  # promoted to the primary instance after a failure of the existing
1535
1657
  # primary instance. For more information, see [ Fault Tolerance for an
1536
1658
  # Aurora DB Cluster][1] in the *Amazon Aurora User Guide*.
1537
1659
  #
1660
+ # This setting doesn't apply to RDS Custom.
1661
+ #
1538
1662
  # Default: 1
1539
1663
  #
1540
1664
  # Valid Values: 0 - 15
@@ -1554,9 +1678,9 @@ module Aws::RDS
1554
1678
  # Services Identity and Access Management (IAM) accounts to database
1555
1679
  # accounts. By default, mapping is disabled.
1556
1680
  #
1557
- # This setting doesn't apply to Amazon Aurora. Mapping Amazon Web
1558
- # Services IAM accounts to database accounts is managed by the DB
1559
- # cluster.
1681
+ # This setting doesn't apply to RDS Custom or Amazon Aurora. In Aurora,
1682
+ # mapping Amazon Web Services IAM accounts to database accounts is
1683
+ # managed by the DB cluster.
1560
1684
  #
1561
1685
  # For more information, see [ IAM Database Authentication for MySQL and
1562
1686
  # PostgreSQL][1] in the *Amazon RDS User Guide.*
@@ -1566,10 +1690,10 @@ module Aws::RDS
1566
1690
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
1567
1691
  # @option options [Boolean] :enable_performance_insights
1568
1692
  # A value that indicates whether to enable Performance Insights for the
1569
- # DB instance.
1693
+ # DB instance. For more information, see [Using Amazon Performance
1694
+ # Insights][1] in the *Amazon Relational Database Service User Guide*.
1570
1695
  #
1571
- # For more information, see [Using Amazon Performance Insights][1] in
1572
- # the *Amazon Relational Database Service User Guide*.
1696
+ # This setting doesn't apply to RDS Custom.
1573
1697
  #
1574
1698
  #
1575
1699
  #
@@ -1579,27 +1703,33 @@ module Aws::RDS
1579
1703
  # Performance Insights data.
1580
1704
  #
1581
1705
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
1582
- # alias ARN, or alias name for the Amazon Web Services KMS customer
1583
- # master key (CMK).
1706
+ # alias ARN, or alias name for the KMS key.
1584
1707
  #
1585
1708
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
1586
- # Amazon RDS uses your default CMK. There is a default CMK for your
1587
- # Amazon Web Services account. Your Amazon Web Services account has a
1588
- # different default CMK for each Amazon Web Services Region.
1709
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
1710
+ # your Amazon Web Services account. Your Amazon Web Services account has
1711
+ # a different default KMS key for each Amazon Web Services Region.
1712
+ #
1713
+ # This setting doesn't apply to RDS Custom.
1589
1714
  # @option options [Integer] :performance_insights_retention_period
1590
1715
  # The amount of time, in days, to retain Performance Insights data.
1591
1716
  # Valid values are 7 or 731 (2 years).
1717
+ #
1718
+ # This setting doesn't apply to RDS Custom.
1592
1719
  # @option options [Array<String>] :enable_cloudwatch_logs_exports
1593
1720
  # The list of log types that need to be enabled for exporting to
1594
- # CloudWatch Logs. The values in the list depend on the DB engine being
1595
- # used. For more information, see [Publishing Database Logs to Amazon
1596
- # CloudWatch Logs ][1] in the *Amazon Relational Database Service User
1597
- # Guide*.
1721
+ # CloudWatch Logs. The values in the list depend on the DB engine. For
1722
+ # more information, see [Publishing Database Logs to Amazon CloudWatch
1723
+ # Logs][1] in the *Amazon Relational Database Service User Guide*.
1598
1724
  #
1599
1725
  # **Amazon Aurora**
1600
1726
  #
1601
1727
  # Not applicable. CloudWatch Logs exports are managed by the DB cluster.
1602
1728
  #
1729
+ # **RDS Custom**
1730
+ #
1731
+ # Not applicable.
1732
+ #
1603
1733
  # **MariaDB**
1604
1734
  #
1605
1735
  # Possible values are `audit`, `error`, `general`, and `slowquery`.
@@ -1627,6 +1757,8 @@ module Aws::RDS
1627
1757
  # @option options [Array<Types::ProcessorFeature>] :processor_features
1628
1758
  # The number of CPU cores and the number of threads per core for the DB
1629
1759
  # instance class of the DB instance.
1760
+ #
1761
+ # This setting doesn't apply to RDS Custom.
1630
1762
  # @option options [Boolean] :deletion_protection
1631
1763
  # A value that indicates whether the DB instance has deletion protection
1632
1764
  # enabled. The database can't be deleted when deletion protection is
@@ -1651,6 +1783,8 @@ module Aws::RDS
1651
1783
  # apply to it, see [ Managing capacity automatically with Amazon RDS
1652
1784
  # storage autoscaling][1] in the *Amazon RDS User Guide*.
1653
1785
  #
1786
+ # This setting doesn't apply to RDS Custom.
1787
+ #
1654
1788
  #
1655
1789
  #
1656
1790
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -1674,6 +1808,28 @@ module Aws::RDS
1674
1808
  #
1675
1809
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
1676
1810
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
1811
+ # @option options [String] :custom_iam_instance_profile
1812
+ # The instance profile associated with the underlying Amazon EC2
1813
+ # instance of an RDS Custom DB instance. The instance profile must meet
1814
+ # the following requirements:
1815
+ #
1816
+ # * The profile must exist in your account.
1817
+ #
1818
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
1819
+ # assume.
1820
+ #
1821
+ # * The instance profile name and the associated IAM role name must
1822
+ # start with the prefix `AWSRDSCustom`.
1823
+ #
1824
+ # For the list of permissions required for the IAM role, see [ Configure
1825
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
1826
+ # Guide*.
1827
+ #
1828
+ # This setting is required for RDS Custom.
1829
+ #
1830
+ #
1831
+ #
1832
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
1677
1833
  # @return [DBInstance]
1678
1834
  def create(options = {})
1679
1835
  options = options.merge(db_instance_identifier: @id)
@@ -1729,6 +1885,7 @@ module Aws::RDS
1729
1885
  # domain_iam_role_name: "String",
1730
1886
  # replica_mode: "open-read-only", # accepts open-read-only, mounted
1731
1887
  # max_allocated_storage: 1,
1888
+ # custom_iam_instance_profile: "String",
1732
1889
  # source_region: "String",
1733
1890
  # })
1734
1891
  # @param [Hash] options ({})
@@ -1770,10 +1927,14 @@ module Aws::RDS
1770
1927
  # support for the replica. Creating your read replica as a Multi-AZ DB
1771
1928
  # instance is independent of whether the source database is a Multi-AZ
1772
1929
  # DB instance.
1930
+ #
1931
+ # This setting doesn't apply to RDS Custom.
1773
1932
  # @option options [Boolean] :auto_minor_version_upgrade
1774
1933
  # A value that indicates whether minor engine upgrades are applied
1775
1934
  # automatically to the read replica during the maintenance window.
1776
1935
  #
1936
+ # This setting doesn't apply to RDS Custom.
1937
+ #
1777
1938
  # Default: Inherits from the source DB instance
1778
1939
  # @option options [Integer] :iops
1779
1940
  # The amount of Provisioned IOPS (input/output operations per second) to
@@ -1786,6 +1947,8 @@ module Aws::RDS
1786
1947
  # source instance.
1787
1948
  #
1788
1949
  # </note>
1950
+ #
1951
+ # This setting doesn't apply to RDS Custom.
1789
1952
  # @option options [String] :db_parameter_group_name
1790
1953
  # The name of the DB parameter group to associate with this DB instance.
1791
1954
  #
@@ -1794,10 +1957,8 @@ module Aws::RDS
1794
1957
  # region read replica, or the default `DBParameterGroup` for the
1795
1958
  # specified DB engine for a cross region read replica.
1796
1959
  #
1797
- # <note markdown="1"> Currently, specifying a parameter group for this operation is only
1798
- # supported for Oracle DB instances.
1799
- #
1800
- # </note>
1960
+ # Specifying a parameter group for this operation is only supported for
1961
+ # Oracle DB instances. It isn't supported for RDS Custom.
1801
1962
  #
1802
1963
  # Constraints:
1803
1964
  #
@@ -1854,7 +2015,10 @@ module Aws::RDS
1854
2015
  #
1855
2016
  # Example: `mySubnetgroup`
1856
2017
  # @option options [Array<String>] :vpc_security_group_ids
1857
- # A list of EC2 VPC security groups to associate with the read replica.
2018
+ # A list of Amazon EC2 VPC security groups to associate with the read
2019
+ # replica.
2020
+ #
2021
+ # This setting doesn't apply to RDS Custom.
1858
2022
  #
1859
2023
  # Default: The default EC2 VPC security group for the DB subnet group's
1860
2024
  # VPC.
@@ -1878,6 +2042,8 @@ module Aws::RDS
1878
2042
  # If `MonitoringRoleArn` is specified, then you must also set
1879
2043
  # `MonitoringInterval` to a value other than 0.
1880
2044
  #
2045
+ # This setting doesn't apply to RDS Custom.
2046
+ #
1881
2047
  # Valid Values: `0, 1, 5, 10, 15, 30, 60`
1882
2048
  # @option options [String] :monitoring_role_arn
1883
2049
  # The ARN for the IAM role that permits RDS to send enhanced monitoring
@@ -1889,6 +2055,8 @@ module Aws::RDS
1889
2055
  # If `MonitoringInterval` is set to a value other than 0, then you must
1890
2056
  # supply a `MonitoringRoleArn` value.
1891
2057
  #
2058
+ # This setting doesn't apply to RDS Custom.
2059
+ #
1892
2060
  #
1893
2061
  #
1894
2062
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
@@ -1897,23 +2065,26 @@ module Aws::RDS
1897
2065
  # replica.
1898
2066
  #
1899
2067
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
1900
- # alias ARN, or alias name for the Amazon Web Services KMS CMK.
2068
+ # alias ARN, or alias name for the KMS key.
1901
2069
  #
1902
2070
  # If you create an encrypted read replica in the same Amazon Web
1903
2071
  # Services Region as the source DB instance, then do not specify a value
1904
- # for this parameter. A read replica in the same Region is always
1905
- # encrypted with the same Amazon Web Services KMS CMK as the source DB
2072
+ # for this parameter. A read replica in the same Amazon Web Services
2073
+ # Region is always encrypted with the same KMS key as the source DB
1906
2074
  # instance.
1907
2075
  #
1908
2076
  # If you create an encrypted read replica in a different Amazon Web
1909
- # Services Region, then you must specify a Amazon Web Services KMS key
1910
- # identifier for the destination Amazon Web Services Region. Amazon Web
1911
- # Services KMS CMKs are specific to the Amazon Web Services Region that
1912
- # they are created in, and you can't use CMKs from one Amazon Web
1913
- # Services Region in another Amazon Web Services Region.
2077
+ # Services Region, then you must specify a KMS key identifier for the
2078
+ # destination Amazon Web Services Region. KMS keys are specific to the
2079
+ # Amazon Web Services Region that they are created in, and you can't
2080
+ # use KMS keys from one Amazon Web Services Region in another Amazon Web
2081
+ # Services Region.
1914
2082
  #
1915
2083
  # You can't create an encrypted read replica from an unencrypted DB
1916
2084
  # instance.
2085
+ #
2086
+ # This setting doesn't apply to RDS Custom, which uses the same KMS key
2087
+ # as the primary replica.
1917
2088
  # @option options [String] :pre_signed_url
1918
2089
  # The URL that contains a Signature Version 4 signed request for the
1919
2090
  # `CreateDBInstanceReadReplica` API action in the source Amazon Web
@@ -1977,6 +2148,8 @@ module Aws::RDS
1977
2148
  #
1978
2149
  # </note>
1979
2150
  #
2151
+ # This setting doesn't apply to RDS Custom.
2152
+ #
1980
2153
  #
1981
2154
  #
1982
2155
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html
@@ -1990,6 +2163,8 @@ module Aws::RDS
1990
2163
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
1991
2164
  # RDS User Guide.*
1992
2165
  #
2166
+ # This setting doesn't apply to RDS Custom.
2167
+ #
1993
2168
  #
1994
2169
  #
1995
2170
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
@@ -2000,6 +2175,8 @@ module Aws::RDS
2000
2175
  # For more information, see [Using Amazon Performance Insights][1] in
2001
2176
  # the *Amazon RDS User Guide*.
2002
2177
  #
2178
+ # This setting doesn't apply to RDS Custom.
2179
+ #
2003
2180
  #
2004
2181
  #
2005
2182
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
@@ -2008,31 +2185,40 @@ module Aws::RDS
2008
2185
  # Performance Insights data.
2009
2186
  #
2010
2187
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
2011
- # alias ARN, or alias name for the Amazon Web Services KMS customer
2012
- # master key (CMK).
2188
+ # alias ARN, or alias name for the KMS key.
2013
2189
  #
2014
2190
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
2015
- # Amazon RDS uses your default CMK. There is a default CMK for your
2016
- # Amazon Web Services account. Your Amazon Web Services account has a
2017
- # different default CMK for each Amazon Web Services Region.
2191
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
2192
+ # your Amazon Web Services account. Your Amazon Web Services account has
2193
+ # a different default KMS key for each Amazon Web Services Region.
2194
+ #
2195
+ # This setting doesn't apply to RDS Custom.
2018
2196
  # @option options [Integer] :performance_insights_retention_period
2019
2197
  # The amount of time, in days, to retain Performance Insights data.
2020
2198
  # Valid values are 7 or 731 (2 years).
2199
+ #
2200
+ # This setting doesn't apply to RDS Custom.
2021
2201
  # @option options [Array<String>] :enable_cloudwatch_logs_exports
2022
2202
  # The list of logs that the new DB instance is to export to CloudWatch
2023
2203
  # Logs. The values in the list depend on the DB engine being used. For
2024
2204
  # more information, see [Publishing Database Logs to Amazon CloudWatch
2025
2205
  # Logs ][1] in the *Amazon RDS User Guide*.
2026
2206
  #
2207
+ # This setting doesn't apply to RDS Custom.
2208
+ #
2027
2209
  #
2028
2210
  #
2029
2211
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
2030
2212
  # @option options [Array<Types::ProcessorFeature>] :processor_features
2031
2213
  # The number of CPU cores and the number of threads per core for the DB
2032
2214
  # instance class of the DB instance.
2215
+ #
2216
+ # This setting doesn't apply to RDS Custom.
2033
2217
  # @option options [Boolean] :use_default_processor_features
2034
2218
  # A value that indicates whether the DB instance class of the DB
2035
2219
  # instance uses its default processor features.
2220
+ #
2221
+ # This setting doesn't apply to RDS Custom.
2036
2222
  # @option options [Boolean] :deletion_protection
2037
2223
  # A value that indicates whether the DB instance has deletion protection
2038
2224
  # enabled. The database can't be deleted when deletion protection is
@@ -2050,12 +2236,16 @@ module Aws::RDS
2050
2236
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
2051
2237
  # RDS User Guide*.
2052
2238
  #
2239
+ # This setting doesn't apply to RDS Custom.
2240
+ #
2053
2241
  #
2054
2242
  #
2055
2243
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
2056
2244
  # @option options [String] :domain_iam_role_name
2057
2245
  # Specify the name of the IAM role to be used when making API calls to
2058
2246
  # the Directory Service.
2247
+ #
2248
+ # This setting doesn't apply to RDS Custom.
2059
2249
  # @option options [String] :replica_mode
2060
2250
  # The open mode of the replica database: mounted or read-only.
2061
2251
  #
@@ -2063,17 +2253,22 @@ module Aws::RDS
2063
2253
  #
2064
2254
  # </note>
2065
2255
  #
2066
- # Mounted DB replicas are included in Oracle Enterprise Edition. The
2067
- # main use case for mounted replicas is cross-Region disaster recovery.
2068
- # The primary database doesn't use Active Data Guard to transmit
2069
- # information to the mounted replica. Because it doesn't accept user
2070
- # connections, a mounted replica can't serve a read-only workload.
2256
+ # Mounted DB replicas are included in Oracle Database Enterprise
2257
+ # Edition. The main use case for mounted replicas is cross-Region
2258
+ # disaster recovery. The primary database doesn't use Active Data Guard
2259
+ # to transmit information to the mounted replica. Because it doesn't
2260
+ # accept user connections, a mounted replica can't serve a read-only
2261
+ # workload.
2071
2262
  #
2072
2263
  # You can create a combination of mounted and read-only DB replicas for
2073
2264
  # the same primary DB instance. For more information, see [Working with
2074
2265
  # Oracle Read Replicas for Amazon RDS][1] in the *Amazon RDS User
2075
2266
  # Guide*.
2076
2267
  #
2268
+ # For RDS Custom, you must specify this parameter and set it to
2269
+ # `mounted`. The value won't be set by default. After replica creation,
2270
+ # you can manage the open mode manually.
2271
+ #
2077
2272
  #
2078
2273
  #
2079
2274
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
@@ -2088,6 +2283,28 @@ module Aws::RDS
2088
2283
  #
2089
2284
  #
2090
2285
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
2286
+ # @option options [String] :custom_iam_instance_profile
2287
+ # The instance profile associated with the underlying Amazon EC2
2288
+ # instance of an RDS Custom DB instance. The instance profile must meet
2289
+ # the following requirements:
2290
+ #
2291
+ # * The profile must exist in your account.
2292
+ #
2293
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
2294
+ # assume.
2295
+ #
2296
+ # * The instance profile name and the associated IAM role name must
2297
+ # start with the prefix `AWSRDSCustom`.
2298
+ #
2299
+ # For the list of permissions required for the IAM role, see [ Configure
2300
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
2301
+ # Guide*.
2302
+ #
2303
+ # This setting is required for RDS Custom.
2304
+ #
2305
+ #
2306
+ #
2307
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
2091
2308
  # @option options [String] :source_region
2092
2309
  # The source region of the snapshot. This is only needed when the
2093
2310
  # shapshot is encrypted and in a different region.
@@ -2157,30 +2374,36 @@ module Aws::RDS
2157
2374
  # @param [Hash] options ({})
2158
2375
  # @option options [Boolean] :skip_final_snapshot
2159
2376
  # A value that indicates whether to skip the creation of a final DB
2160
- # snapshot before the DB instance is deleted. If skip is specified, no
2161
- # DB snapshot is created. If skip isn't specified, a DB snapshot is
2162
- # created before the DB instance is deleted. By default, skip isn't
2163
- # specified, and the DB snapshot is created.
2377
+ # snapshot before deleting the instance. If you enable this parameter,
2378
+ # RDS doesn't create a DB snapshot. If you don't enable this
2379
+ # parameter, RDS creates a DB snapshot before the DB instance is
2380
+ # deleted. By default, skip isn't enabled, and the DB snapshot is
2381
+ # created.
2164
2382
  #
2165
- # When a DB instance is in a failure state and has a status of
2166
- # 'failed', 'incompatible-restore', or 'incompatible-network', it
2167
- # can only be deleted when skip is specified.
2383
+ # <note markdown="1"> If you don't enable this parameter, you must specify the
2384
+ # `FinalDBSnapshotIdentifier` parameter.
2168
2385
  #
2169
- # Specify skip when deleting a read replica.
2386
+ # </note>
2170
2387
  #
2171
- # <note markdown="1"> The FinalDBSnapshotIdentifier parameter must be specified if skip
2172
- # isn't specified.
2388
+ # When a DB instance is in a failure state and has a status of `failed`,
2389
+ # `incompatible-restore`, or `incompatible-network`, RDS can delete the
2390
+ # instance only if you enable this parameter.
2173
2391
  #
2174
- # </note>
2392
+ # If you delete a read replica or an RDS Custom instance, you must
2393
+ # enable this setting.
2394
+ #
2395
+ # This setting is required for RDS Custom.
2175
2396
  # @option options [String] :final_db_snapshot_identifier
2176
2397
  # The `DBSnapshotIdentifier` of the new `DBSnapshot` created when the
2177
2398
  # `SkipFinalSnapshot` parameter is disabled.
2178
2399
  #
2179
- # <note markdown="1"> Specifying this parameter and also specifying to skip final DB
2180
- # snapshot creation in SkipFinalShapshot results in an error.
2400
+ # <note markdown="1"> If you enable this parameter and also enable SkipFinalShapshot, the
2401
+ # command results in an error.
2181
2402
  #
2182
2403
  # </note>
2183
2404
  #
2405
+ # This setting doesn't apply to RDS Custom.
2406
+ #
2184
2407
  # Constraints:
2185
2408
  #
2186
2409
  # * Must be 1 to 255 letters or numbers.
@@ -2261,6 +2484,8 @@ module Aws::RDS
2261
2484
  # replica_mode: "open-read-only", # accepts open-read-only, mounted
2262
2485
  # enable_customer_owned_ip: false,
2263
2486
  # aws_backup_recovery_point_arn: "AwsBackupRecoveryPointArn",
2487
+ # automation_mode: "full", # accepts full, all-paused
2488
+ # resume_full_automation_mode_minutes: 1,
2264
2489
  # })
2265
2490
  # @param [Hash] options ({})
2266
2491
  # @option options [Integer] :allocated_storage
@@ -2279,12 +2504,14 @@ module Aws::RDS
2279
2504
  # `db.m4.large`. Not all DB instance classes are available in all Amazon
2280
2505
  # Web Services Regions, or for all database engines. For the full list
2281
2506
  # of DB instance classes, and availability for your engine, see [DB
2282
- # Instance Class][1] in the *Amazon RDS User Guide.*
2507
+ # Instance Class][1] in the *Amazon RDS User Guide*.
2283
2508
  #
2284
2509
  # If you modify the DB instance class, an outage occurs during the
2285
2510
  # change. The change is applied during the next maintenance window,
2286
2511
  # unless `ApplyImmediately` is enabled for this request.
2287
2512
  #
2513
+ # This setting doesn't apply to RDS Custom.
2514
+ #
2288
2515
  # Default: Uses existing setting
2289
2516
  #
2290
2517
  #
@@ -2295,12 +2522,14 @@ module Aws::RDS
2295
2522
  # parameter to move your DB instance to a different VPC. If your DB
2296
2523
  # instance isn't in a VPC, you can also use this parameter to move your
2297
2524
  # DB instance into a VPC. For more information, see [Working with a DB
2298
- # instance in a VPC][1] in the *Amazon RDS User Guide.*
2525
+ # instance in a VPC][1] in the *Amazon RDS User Guide*.
2299
2526
  #
2300
2527
  # Changing the subnet group causes an outage during the change. The
2301
2528
  # change is applied during the next maintenance window, unless you
2302
2529
  # enable `ApplyImmediately`.
2303
2530
  #
2531
+ # This parameter doesn't apply to RDS Custom.
2532
+ #
2304
2533
  # Constraints: If supplied, must match the name of an existing
2305
2534
  # DBSubnetGroup.
2306
2535
  #
@@ -2314,14 +2543,18 @@ module Aws::RDS
2314
2543
  # Changing this setting doesn't result in an outage and the change is
2315
2544
  # asynchronously applied as soon as possible.
2316
2545
  #
2546
+ # This setting doesn't apply to RDS Custom.
2547
+ #
2317
2548
  # Constraints:
2318
2549
  #
2319
2550
  # * If supplied, must match existing DBSecurityGroups.
2320
2551
  #
2321
2552
  # ^
2322
2553
  # @option options [Array<String>] :vpc_security_group_ids
2323
- # A list of EC2 VPC security groups to authorize on this DB instance.
2324
- # This change is asynchronously applied as soon as possible.
2554
+ # A list of Amazon EC2 VPC security groups to authorize on this DB
2555
+ # instance. This change is asynchronously applied as soon as possible.
2556
+ #
2557
+ # This setting doesn't apply to RDS Custom.
2325
2558
  #
2326
2559
  # **Amazon Aurora**
2327
2560
  #
@@ -2361,6 +2594,8 @@ module Aws::RDS
2361
2594
  # element exists in the `PendingModifiedValues` element of the operation
2362
2595
  # response.
2363
2596
  #
2597
+ # This setting doesn't apply to RDS Custom.
2598
+ #
2364
2599
  # **Amazon Aurora**
2365
2600
  #
2366
2601
  # Not applicable. The password for the master user is managed by the DB
@@ -2396,17 +2631,22 @@ module Aws::RDS
2396
2631
  # </note>
2397
2632
  # @option options [String] :db_parameter_group_name
2398
2633
  # The name of the DB parameter group to apply to the DB instance.
2634
+ #
2399
2635
  # Changing this setting doesn't result in an outage. The parameter
2400
2636
  # group name itself is changed immediately, but the actual parameter
2401
2637
  # changes are not applied until you reboot the instance without
2402
- # failover. In this case, the DB instance isn't rebooted automatically
2403
- # and the parameter changes isn't applied during the next maintenance
2404
- # window.
2638
+ # failover. In this case, the DB instance isn't rebooted automatically,
2639
+ # and the parameter changes aren't applied during the next maintenance
2640
+ # window. However, if you modify dynamic parameters in the newly
2641
+ # associated DB parameter group, these changes are applied immediately
2642
+ # without a reboot.
2643
+ #
2644
+ # This setting doesn't apply to RDS Custom.
2405
2645
  #
2406
2646
  # Default: Uses existing setting
2407
2647
  #
2408
2648
  # Constraints: The DB parameter group must be in the same DB parameter
2409
- # group family as this DB instance.
2649
+ # group family as the DB instance.
2410
2650
  # @option options [Integer] :backup_retention_period
2411
2651
  # The number of days to retain automated backups. Setting this parameter
2412
2652
  # to a positive number enables backups. Setting this parameter to 0
@@ -2432,15 +2672,15 @@ module Aws::RDS
2432
2672
  #
2433
2673
  # Constraints:
2434
2674
  #
2435
- # * Must be a value from 0 to 35
2436
- #
2437
- # * Can be specified for a MySQL read replica only if the source is
2438
- # running MySQL 5.6 or later
2675
+ # * It must be a value from 0 to 35. It can't be set to 0 if the DB
2676
+ # instance is a source to read replicas. It can't be set to 0 or 35
2677
+ # for an RDS Custom DB instance.
2439
2678
  #
2440
- # * Can be specified for a PostgreSQL read replica only if the source is
2441
- # running PostgreSQL 9.3.5
2679
+ # * It can be specified for a MySQL read replica only if the source is
2680
+ # running MySQL 5.6 or later.
2442
2681
  #
2443
- # * Can't be set to 0 if the DB instance is a source to read replicas
2682
+ # * It can be specified for a PostgreSQL read replica only if the source
2683
+ # is running PostgreSQL 9.3.5.
2444
2684
  # @option options [String] :preferred_backup_window
2445
2685
  # The daily time range during which automated backups are created if
2446
2686
  # automated backups are enabled, as determined by the
@@ -2496,9 +2736,11 @@ module Aws::RDS
2496
2736
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#Concepts.DBMaintenance
2497
2737
  # @option options [Boolean] :multi_az
2498
2738
  # A value that indicates whether the DB instance is a Multi-AZ
2499
- # deployment. Changing this parameter doesn't result in an outage and
2500
- # the change is applied during the next maintenance window unless the
2739
+ # deployment. Changing this parameter doesn't result in an outage. The
2740
+ # change is applied during the next maintenance window unless the
2501
2741
  # `ApplyImmediately` parameter is enabled for this request.
2742
+ #
2743
+ # This setting doesn't apply to RDS Custom.
2502
2744
  # @option options [String] :engine_version
2503
2745
  # The version number of the database engine to upgrade to. Changing this
2504
2746
  # parameter results in an outage and the change is applied during the
@@ -2514,25 +2756,40 @@ module Aws::RDS
2514
2756
  # instance to the default minor version if the current minor version is
2515
2757
  # lower. For information about valid engine versions, see
2516
2758
  # `CreateDBInstance`, or call `DescribeDBEngineVersions`.
2759
+ #
2760
+ # In RDS Custom, this parameter is supported for read replicas only if
2761
+ # they are in the `PATCH_DB_FAILURE` lifecycle.
2517
2762
  # @option options [Boolean] :allow_major_version_upgrade
2518
2763
  # A value that indicates whether major version upgrades are allowed.
2519
2764
  # Changing this parameter doesn't result in an outage and the change is
2520
2765
  # asynchronously applied as soon as possible.
2521
2766
  #
2767
+ # This setting doesn't apply to RDS Custom.
2768
+ #
2522
2769
  # Constraints: Major version upgrades must be allowed when specifying a
2523
2770
  # value for the EngineVersion parameter that is a different major
2524
2771
  # version than the DB instance's current version.
2525
2772
  # @option options [Boolean] :auto_minor_version_upgrade
2526
2773
  # A value that indicates whether minor version upgrades are applied
2527
- # automatically to the DB instance during the maintenance window.
2528
- # Changing this parameter doesn't result in an outage except in the
2529
- # following case and the change is asynchronously applied as soon as
2530
- # possible. An outage results if this parameter is enabled during the
2531
- # maintenance window, and a newer minor version is available, and RDS
2532
- # has enabled auto patching for that engine version.
2774
+ # automatically to the DB instance during the maintenance window. An
2775
+ # outage occurs when all the following conditions are met:
2776
+ #
2777
+ # * The automatic upgrade is enabled for the maintenance window.
2778
+ #
2779
+ # * A newer minor version is available.
2780
+ #
2781
+ # * RDS has enabled automatic patching for the engine version.
2782
+ #
2783
+ # If any of the preceding conditions isn't met, RDS applies the change
2784
+ # as soon as possible and doesn't cause an outage.
2785
+ #
2786
+ # For an RDS Custom DB instance, set `AutoMinorVersionUpgrade` to
2787
+ # `false`. Otherwise, the operation returns an error.
2533
2788
  # @option options [String] :license_model
2534
2789
  # The license model for the DB instance.
2535
2790
  #
2791
+ # This setting doesn't apply to RDS Custom.
2792
+ #
2536
2793
  # Valid values: `license-included` \| `bring-your-own-license` \|
2537
2794
  # `general-public-license`
2538
2795
  # @option options [Integer] :iops
@@ -2569,18 +2826,23 @@ module Aws::RDS
2569
2826
  # Default: Uses existing setting
2570
2827
  # @option options [String] :option_group_name
2571
2828
  # A value that indicates the DB instance should be associated with the
2572
- # specified option group. Changing this parameter doesn't result in an
2573
- # outage except in the following case and the change is applied during
2574
- # the next maintenance window unless the `ApplyImmediately` parameter is
2575
- # enabled for this request. If the parameter change results in an option
2576
- # group that enables OEM, this change can cause a brief (sub-second)
2577
- # period during which new connections are rejected but existing
2578
- # connections are not interrupted.
2829
+ # specified option group.
2830
+ #
2831
+ # Changing this parameter doesn't result in an outage, with one
2832
+ # exception. If the parameter change results in an option group that
2833
+ # enables OEM, it can cause a brief period, lasting less than a second,
2834
+ # during which new connections are rejected but existing connections
2835
+ # aren't interrupted.
2836
+ #
2837
+ # The change is applied during the next maintenance window unless the
2838
+ # `ApplyImmediately` parameter is enabled for this request.
2579
2839
  #
2580
2840
  # Permanent options, such as the TDE option for Oracle Advanced Security
2581
2841
  # TDE, can't be removed from an option group, and that option group
2582
- # can't be removed from a DB instance once it is associated with a DB
2583
- # instance
2842
+ # can't be removed from a DB instance after it is associated with a DB
2843
+ # instance.
2844
+ #
2845
+ # This setting doesn't apply to RDS Custom.
2584
2846
  # @option options [String] :new_db_instance_identifier
2585
2847
  # The new DB instance identifier for the DB instance when renaming a DB
2586
2848
  # instance. When you change the DB instance identifier, an instance
@@ -2588,6 +2850,8 @@ module Aws::RDS
2588
2850
  # occur during the next maintenance window if you disable Apply
2589
2851
  # Immediately. This value is stored as a lowercase string.
2590
2852
  #
2853
+ # This setting doesn't apply to RDS Custom.
2854
+ #
2591
2855
  # Constraints:
2592
2856
  #
2593
2857
  # * Must contain from 1 to 63 letters, numbers, or hyphens.
@@ -2624,22 +2888,29 @@ module Aws::RDS
2624
2888
  # @option options [String] :tde_credential_arn
2625
2889
  # The ARN from the key store with which to associate the instance for
2626
2890
  # TDE encryption.
2891
+ #
2892
+ # This setting doesn't apply to RDS Custom.
2627
2893
  # @option options [String] :tde_credential_password
2628
2894
  # The password for the given ARN from the key store in order to access
2629
2895
  # the device.
2896
+ #
2897
+ # This setting doesn't apply to RDS Custom.
2630
2898
  # @option options [String] :ca_certificate_identifier
2631
- # Indicates the certificate that needs to be associated with the
2632
- # instance.
2899
+ # Specifies the certificate to associate with the DB instance.
2900
+ #
2901
+ # This setting doesn't apply to RDS Custom.
2633
2902
  # @option options [String] :domain
2634
2903
  # The Active Directory directory ID to move the DB instance to. Specify
2635
- # `none` to remove the instance from its current domain. The domain must
2636
- # be created prior to this operation. Currently, only MySQL, Microsoft
2637
- # SQL Server, Oracle, and PostgreSQL DB instances can be created in an
2904
+ # `none` to remove the instance from its current domain. You must create
2905
+ # the domain before this operation. Currently, you can create only
2906
+ # MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances in an
2638
2907
  # Active Directory Domain.
2639
2908
  #
2640
2909
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
2641
2910
  # RDS User Guide*.
2642
2911
  #
2912
+ # This setting doesn't apply to RDS Custom.
2913
+ #
2643
2914
  #
2644
2915
  #
2645
2916
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -2655,10 +2926,12 @@ module Aws::RDS
2655
2926
  # @option options [Integer] :monitoring_interval
2656
2927
  # The interval, in seconds, between points when Enhanced Monitoring
2657
2928
  # metrics are collected for the DB instance. To disable collecting
2658
- # Enhanced Monitoring metrics, specify 0. The default is 0.
2929
+ # Enhanced Monitoring metrics, specify 0, which is the default.
2659
2930
  #
2660
- # If `MonitoringRoleArn` is specified, then you must also set
2661
- # `MonitoringInterval` to a value other than 0.
2931
+ # If `MonitoringRoleArn` is specified, set `MonitoringInterval` to a
2932
+ # value other than 0.
2933
+ #
2934
+ # This setting doesn't apply to RDS Custom.
2662
2935
  #
2663
2936
  # Valid Values: `0, 1, 5, 10, 15, 30, 60`
2664
2937
  # @option options [Integer] :db_port_number
@@ -2668,9 +2941,11 @@ module Aws::RDS
2668
2941
  # port values specified for options in the option group for the DB
2669
2942
  # instance.
2670
2943
  #
2671
- # Your database will restart when you change the `DBPortNumber` value
2944
+ # If you change the `DBPortNumber` value, your database restarts
2672
2945
  # regardless of the value of the `ApplyImmediately` parameter.
2673
2946
  #
2947
+ # This setting doesn't apply to RDS Custom.
2948
+ #
2674
2949
  # **MySQL**
2675
2950
  #
2676
2951
  # Default: `3306`
@@ -2728,15 +3003,19 @@ module Aws::RDS
2728
3003
  #
2729
3004
  # Changes to the `PubliclyAccessible` parameter are applied immediately
2730
3005
  # regardless of the value of the `ApplyImmediately` parameter.
3006
+ #
3007
+ # This setting doesn't apply to RDS Custom.
2731
3008
  # @option options [String] :monitoring_role_arn
2732
3009
  # The ARN for the IAM role that permits RDS to send enhanced monitoring
2733
3010
  # metrics to Amazon CloudWatch Logs. For example,
2734
3011
  # `arn:aws:iam:123456789012:role/emaccess`. For information on creating
2735
- # a monitoring role, go to [To create an IAM role for Amazon RDS
2736
- # Enhanced Monitoring][1] in the *Amazon RDS User Guide.*
3012
+ # a monitoring role, see [To create an IAM role for Amazon RDS Enhanced
3013
+ # Monitoring][1] in the *Amazon RDS User Guide.*
2737
3014
  #
2738
- # If `MonitoringInterval` is set to a value other than 0, then you must
2739
- # supply a `MonitoringRoleArn` value.
3015
+ # If `MonitoringInterval` is set to a value other than 0, supply a
3016
+ # `MonitoringRoleArn` value.
3017
+ #
3018
+ # This setting doesn't apply to RDS Custom.
2740
3019
  #
2741
3020
  #
2742
3021
  #
@@ -2744,12 +3023,16 @@ module Aws::RDS
2744
3023
  # @option options [String] :domain_iam_role_name
2745
3024
  # The name of the IAM role to use when making API calls to the Directory
2746
3025
  # Service.
3026
+ #
3027
+ # This setting doesn't apply to RDS Custom.
2747
3028
  # @option options [Integer] :promotion_tier
2748
3029
  # A value that specifies the order in which an Aurora Replica is
2749
3030
  # promoted to the primary instance after a failure of the existing
2750
3031
  # primary instance. For more information, see [ Fault Tolerance for an
2751
3032
  # Aurora DB Cluster][1] in the *Amazon Aurora User Guide*.
2752
3033
  #
3034
+ # This setting doesn't apply to RDS Custom.
3035
+ #
2753
3036
  # Default: 1
2754
3037
  #
2755
3038
  # Valid Values: 0 - 15
@@ -2770,6 +3053,8 @@ module Aws::RDS
2770
3053
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
2771
3054
  # RDS User Guide.*
2772
3055
  #
3056
+ # This setting doesn't apply to RDS Custom.
3057
+ #
2773
3058
  #
2774
3059
  #
2775
3060
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
@@ -2780,6 +3065,8 @@ module Aws::RDS
2780
3065
  # For more information, see [Using Amazon Performance Insights][1] in
2781
3066
  # the *Amazon Relational Database Service User Guide*.
2782
3067
  #
3068
+ # This setting doesn't apply to RDS Custom.
3069
+ #
2783
3070
  #
2784
3071
  #
2785
3072
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
@@ -2788,16 +3075,19 @@ module Aws::RDS
2788
3075
  # Performance Insights data.
2789
3076
  #
2790
3077
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
2791
- # alias ARN, or alias name for the Amazon Web Services KMS customer
2792
- # master key (CMK).
3078
+ # alias ARN, or alias name for the KMS key.
2793
3079
  #
2794
3080
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
2795
- # Amazon RDS uses your default CMK. There is a default CMK for your
2796
- # Amazon Web Services account. Your Amazon Web Services account has a
2797
- # different default CMK for each Amazon Web Services Region.
3081
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
3082
+ # your Amazon Web Services account. Your Amazon Web Services account has
3083
+ # a different default KMS key for each Amazon Web Services Region.
3084
+ #
3085
+ # This setting doesn't apply to RDS Custom.
2798
3086
  # @option options [Integer] :performance_insights_retention_period
2799
3087
  # The amount of time, in days, to retain Performance Insights data.
2800
3088
  # Valid values are 7 or 731 (2 years).
3089
+ #
3090
+ # This setting doesn't apply to RDS Custom.
2801
3091
  # @option options [Types::CloudwatchLogsExportConfiguration] :cloudwatch_logs_export_configuration
2802
3092
  # The configuration setting for the log types to be enabled for export
2803
3093
  # to CloudWatch Logs for a specific DB instance.
@@ -2805,12 +3095,18 @@ module Aws::RDS
2805
3095
  # A change to the `CloudwatchLogsExportConfiguration` parameter is
2806
3096
  # always applied to the DB instance immediately. Therefore, the
2807
3097
  # `ApplyImmediately` parameter has no effect.
3098
+ #
3099
+ # This setting doesn't apply to RDS Custom.
2808
3100
  # @option options [Array<Types::ProcessorFeature>] :processor_features
2809
3101
  # The number of CPU cores and the number of threads per core for the DB
2810
3102
  # instance class of the DB instance.
3103
+ #
3104
+ # This setting doesn't apply to RDS Custom.
2811
3105
  # @option options [Boolean] :use_default_processor_features
2812
3106
  # A value that indicates whether the DB instance class of the DB
2813
3107
  # instance uses its default processor features.
3108
+ #
3109
+ # This setting doesn't apply to RDS Custom.
2814
3110
  # @option options [Boolean] :deletion_protection
2815
3111
  # A value that indicates whether the DB instance has deletion protection
2816
3112
  # enabled. The database can't be deleted when deletion protection is
@@ -2828,6 +3124,8 @@ module Aws::RDS
2828
3124
  # apply to it, see [ Managing capacity automatically with Amazon RDS
2829
3125
  # storage autoscaling][1] in the *Amazon RDS User Guide*.
2830
3126
  #
3127
+ # This setting doesn't apply to RDS Custom.
3128
+ #
2831
3129
  #
2832
3130
  #
2833
3131
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -2854,6 +3152,8 @@ module Aws::RDS
2854
3152
  # Aurora DB engines, see [ Rotating Your SSL/TLS Certificate][2] in
2855
3153
  # the *Amazon Aurora User Guide.*
2856
3154
  #
3155
+ # This setting doesn't apply to RDS Custom.
3156
+ #
2857
3157
  #
2858
3158
  #
2859
3159
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html
@@ -2874,6 +3174,8 @@ module Aws::RDS
2874
3174
  # more information, see [Working with Oracle Read Replicas for Amazon
2875
3175
  # RDS][1] in the *Amazon RDS User Guide*.
2876
3176
  #
3177
+ # This setting doesn't apply to RDS Custom.
3178
+ #
2877
3179
  #
2878
3180
  #
2879
3181
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
@@ -2900,6 +3202,17 @@ module Aws::RDS
2900
3202
  # @option options [String] :aws_backup_recovery_point_arn
2901
3203
  # The Amazon Resource Name (ARN) of the recovery point in Amazon Web
2902
3204
  # Services Backup.
3205
+ #
3206
+ # This setting doesn't apply to RDS Custom.
3207
+ # @option options [String] :automation_mode
3208
+ # The automation mode of the RDS Custom DB instance: `full` or `all
3209
+ # paused`. If `full`, the DB instance automates monitoring and instance
3210
+ # recovery. If `all paused`, the instance pauses automation for the
3211
+ # duration set by `ResumeFullAutomationModeMinutes`.
3212
+ # @option options [Integer] :resume_full_automation_mode_minutes
3213
+ # The number of minutes to pause the automation. When the time period
3214
+ # ends, RDS Custom resumes full automation. The minimum value is `60`
3215
+ # (default). The maximum value is `1,440`.
2903
3216
  # @return [DBInstance]
2904
3217
  def modify(options = {})
2905
3218
  options = options.merge(db_instance_identifier: @id)
@@ -3033,6 +3346,7 @@ module Aws::RDS
3033
3346
  # max_allocated_storage: 1,
3034
3347
  # source_db_instance_automated_backups_arn: "String",
3035
3348
  # enable_customer_owned_ip: false,
3349
+ # custom_iam_instance_profile: "String",
3036
3350
  # })
3037
3351
  # @param [Hash] options ({})
3038
3352
  # @option options [required, String] :target_db_instance_identifier
@@ -3104,6 +3418,8 @@ module Aws::RDS
3104
3418
  # A value that indicates whether the DB instance is a Multi-AZ
3105
3419
  # deployment.
3106
3420
  #
3421
+ # This setting doesn't apply to RDS Custom.
3422
+ #
3107
3423
  # Constraint: You can't specify the `AvailabilityZone` parameter if the
3108
3424
  # DB instance is a Multi-AZ deployment.
3109
3425
  # @option options [Boolean] :publicly_accessible
@@ -3123,9 +3439,13 @@ module Aws::RDS
3123
3439
  # @option options [Boolean] :auto_minor_version_upgrade
3124
3440
  # A value that indicates whether minor version upgrades are applied
3125
3441
  # automatically to the DB instance during the maintenance window.
3442
+ #
3443
+ # This setting doesn't apply to RDS Custom.
3126
3444
  # @option options [String] :license_model
3127
3445
  # License model information for the restored DB instance.
3128
3446
  #
3447
+ # This setting doesn't apply to RDS Custom.
3448
+ #
3129
3449
  # Default: Same as source.
3130
3450
  #
3131
3451
  # Valid values: `license-included` \| `bring-your-own-license` \|
@@ -3133,12 +3453,15 @@ module Aws::RDS
3133
3453
  # @option options [String] :db_name
3134
3454
  # The database name for the restored DB instance.
3135
3455
  #
3136
- # <note markdown="1"> This parameter isn't used for the MySQL or MariaDB engines.
3456
+ # <note markdown="1"> This parameter isn't supported for the MySQL or MariaDB engines. It
3457
+ # also doesn't apply to RDS Custom.
3137
3458
  #
3138
3459
  # </note>
3139
3460
  # @option options [String] :engine
3140
3461
  # The database engine to use for the new instance.
3141
3462
  #
3463
+ # This setting doesn't apply to RDS Custom.
3464
+ #
3142
3465
  # Default: The same as source
3143
3466
  #
3144
3467
  # Constraint: Must be compatible with the engine of the source
@@ -3181,8 +3504,10 @@ module Aws::RDS
3181
3504
  #
3182
3505
  # Permanent options, such as the TDE option for Oracle Advanced Security
3183
3506
  # TDE, can't be removed from an option group, and that option group
3184
- # can't be removed from a DB instance once it is associated with a DB
3507
+ # can't be removed from a DB instance after it is associated with a DB
3185
3508
  # instance
3509
+ #
3510
+ # This setting doesn't apply to RDS Custom.
3186
3511
  # @option options [Boolean] :copy_tags_to_snapshot
3187
3512
  # A value that indicates whether to copy all tags from the restored DB
3188
3513
  # instance to snapshots of the DB instance. By default, tags are not
@@ -3206,9 +3531,13 @@ module Aws::RDS
3206
3531
  # @option options [String] :tde_credential_arn
3207
3532
  # The ARN from the key store with which to associate the instance for
3208
3533
  # TDE encryption.
3534
+ #
3535
+ # This setting doesn't apply to RDS Custom.
3209
3536
  # @option options [String] :tde_credential_password
3210
3537
  # The password for the given ARN from the key store in order to access
3211
3538
  # the device.
3539
+ #
3540
+ # This setting doesn't apply to RDS Custom.
3212
3541
  # @option options [Array<String>] :vpc_security_group_ids
3213
3542
  # A list of EC2 VPC security groups to associate with this DB instance.
3214
3543
  #
@@ -3216,9 +3545,11 @@ module Aws::RDS
3216
3545
  # VPC.
3217
3546
  # @option options [String] :domain
3218
3547
  # Specify the Active Directory directory ID to restore the DB instance
3219
- # in. The domain must be created prior to this operation. Currently,
3220
- # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
3221
- # can be created in an Active Directory Domain.
3548
+ # in. Create the domain before running this command. Currently, you can
3549
+ # create only the MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
3550
+ # instances in an Active Directory Domain.
3551
+ #
3552
+ # This setting doesn't apply to RDS Custom.
3222
3553
  #
3223
3554
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
3224
3555
  # RDS User Guide*.
@@ -3229,11 +3560,15 @@ module Aws::RDS
3229
3560
  # @option options [String] :domain_iam_role_name
3230
3561
  # Specify the name of the IAM role to be used when making API calls to
3231
3562
  # the Directory Service.
3563
+ #
3564
+ # This setting doesn't apply to RDS Custom.
3232
3565
  # @option options [Boolean] :enable_iam_database_authentication
3233
3566
  # A value that indicates whether to enable mapping of Amazon Web
3234
3567
  # Services Identity and Access Management (IAM) accounts to database
3235
3568
  # accounts. By default, mapping is disabled.
3236
3569
  #
3570
+ # This setting doesn't apply to RDS Custom.
3571
+ #
3237
3572
  # For more information about IAM database authentication, see [ IAM
3238
3573
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
3239
3574
  # RDS User Guide.*
@@ -3247,21 +3582,29 @@ module Aws::RDS
3247
3582
  # used. For more information, see [Publishing Database Logs to Amazon
3248
3583
  # CloudWatch Logs][1] in the *Amazon RDS User Guide*.
3249
3584
  #
3585
+ # This setting doesn't apply to RDS Custom.
3586
+ #
3250
3587
  #
3251
3588
  #
3252
3589
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
3253
3590
  # @option options [Array<Types::ProcessorFeature>] :processor_features
3254
3591
  # The number of CPU cores and the number of threads per core for the DB
3255
3592
  # instance class of the DB instance.
3593
+ #
3594
+ # This setting doesn't apply to RDS Custom.
3256
3595
  # @option options [Boolean] :use_default_processor_features
3257
3596
  # A value that indicates whether the DB instance class of the DB
3258
3597
  # instance uses its default processor features.
3598
+ #
3599
+ # This setting doesn't apply to RDS Custom.
3259
3600
  # @option options [String] :db_parameter_group_name
3260
3601
  # The name of the DB parameter group to associate with this DB instance.
3261
3602
  #
3262
3603
  # If you do not specify a value for `DBParameterGroupName`, then the
3263
3604
  # default `DBParameterGroup` for the specified DB engine is used.
3264
3605
  #
3606
+ # This setting doesn't apply to RDS Custom.
3607
+ #
3265
3608
  # Constraints:
3266
3609
  #
3267
3610
  # * If supplied, must match the name of an existing DBParameterGroup.
@@ -3290,6 +3633,8 @@ module Aws::RDS
3290
3633
  # apply to it, see [ Managing capacity automatically with Amazon RDS
3291
3634
  # storage autoscaling][1] in the *Amazon RDS User Guide*.
3292
3635
  #
3636
+ # This setting doesn't apply to RDS Custom.
3637
+ #
3293
3638
  #
3294
3639
  #
3295
3640
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -3297,6 +3642,8 @@ module Aws::RDS
3297
3642
  # The Amazon Resource Name (ARN) of the replicated automated backups
3298
3643
  # from which to restore, for example,
3299
3644
  # `arn:aws:rds:useast-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
3645
+ #
3646
+ # This setting doesn't apply to RDS Custom.
3300
3647
  # @option options [Boolean] :enable_customer_owned_ip
3301
3648
  # A value that indicates whether to enable a customer-owned IP address
3302
3649
  # (CoIP) for an RDS on Outposts DB instance.
@@ -3306,6 +3653,8 @@ module Aws::RDS
3306
3653
  # a CoIP can provide lower latency for connections to the DB instance
3307
3654
  # from outside of its virtual private cloud (VPC) on your local network.
3308
3655
  #
3656
+ # This setting doesn't apply to RDS Custom.
3657
+ #
3309
3658
  # For more information about RDS on Outposts, see [Working with Amazon
3310
3659
  # RDS on Amazon Web Services Outposts][1] in the *Amazon RDS User
3311
3660
  # Guide*.
@@ -3317,6 +3666,28 @@ module Aws::RDS
3317
3666
  #
3318
3667
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
3319
3668
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
3669
+ # @option options [String] :custom_iam_instance_profile
3670
+ # The instance profile associated with the underlying Amazon EC2
3671
+ # instance of an RDS Custom DB instance. The instance profile must meet
3672
+ # the following requirements:
3673
+ #
3674
+ # * The profile must exist in your account.
3675
+ #
3676
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
3677
+ # assume.
3678
+ #
3679
+ # * The instance profile name and the associated IAM role name must
3680
+ # start with the prefix `AWSRDSCustom`.
3681
+ #
3682
+ # For the list of permissions required for the IAM role, see [ Configure
3683
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
3684
+ # Guide*.
3685
+ #
3686
+ # This setting is required for RDS Custom.
3687
+ #
3688
+ #
3689
+ #
3690
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
3320
3691
  # @return [DBInstance]
3321
3692
  def restore(options = {})
3322
3693
  options = options.merge(source_db_instance_identifier: @id)
@@ -3698,6 +4069,8 @@ module Aws::RDS
3698
4069
  # You can give an Amazon Web Services account permission to restore a
3699
4070
  # manual DB snapshot from another Amazon Web Services account by using
3700
4071
  # the `ModifyDBSnapshotAttribute` API action.
4072
+ #
4073
+ # This setting doesn't apply to RDS Custom.
3701
4074
  # @option options [Boolean] :include_public
3702
4075
  # A value that indicates whether to include manual DB cluster snapshots
3703
4076
  # that are public and can be copied or restored by any Amazon Web
@@ -3705,6 +4078,8 @@ module Aws::RDS
3705
4078
  #
3706
4079
  # You can share a manual DB snapshot as public by using the
3707
4080
  # ModifyDBSnapshotAttribute API.
4081
+ #
4082
+ # This setting doesn't apply to RDS Custom.
3708
4083
  # @option options [String] :dbi_resource_id
3709
4084
  # A specific DB resource ID to describe.
3710
4085
  # @return [DBSnapshot::Collection]