aws-sdk-rds 1.107.0 → 1.112.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -523,8 +523,8 @@ module Aws::RDS
523
523
  # to another, and your DB instance uses a nondefault option group. If
524
524
  # your source DB instance uses Transparent Data Encryption for Oracle or
525
525
  # Microsoft SQL Server, you must specify this option when copying across
526
- # AWS Regions. For more information, see [Option Group
527
- # Considerations][1] in the *Amazon RDS User Guide.*
526
+ # AWS Regions. For more information, see [Option group
527
+ # considerations][1] in the *Amazon RDS User Guide.*
528
528
  #
529
529
  #
530
530
  #
@@ -605,6 +605,7 @@ module Aws::RDS
605
605
  # use_default_processor_features: false,
606
606
  # db_parameter_group_name: "String",
607
607
  # deletion_protection: false,
608
+ # enable_customer_owned_ip: false,
608
609
  # })
609
610
  # @param [Hash] options ({})
610
611
  # @option options [required, String] :db_instance_identifier
@@ -845,6 +846,25 @@ module Aws::RDS
845
846
  #
846
847
  #
847
848
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html
849
+ # @option options [Boolean] :enable_customer_owned_ip
850
+ # A value that indicates whether to enable a customer-owned IP address
851
+ # (CoIP) for an RDS on Outposts DB instance.
852
+ #
853
+ # A *CoIP* provides local or external connectivity to resources in your
854
+ # Outpost subnets through your on-premises network. For some use cases,
855
+ # a CoIP can provide lower latency for connections to the DB instance
856
+ # from outside of its virtual private cloud (VPC) on your local network.
857
+ #
858
+ # For more information about RDS on Outposts, see [Working with Amazon
859
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
860
+ #
861
+ # For more information about CoIPs, see [Customer-owned IP addresses][2]
862
+ # in the *AWS Outposts User Guide*.
863
+ #
864
+ #
865
+ #
866
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
867
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
848
868
  # @return [DBInstance]
849
869
  def restore(options = {})
850
870
  options = options.merge(db_snapshot_identifier: @snapshot_id)
@@ -236,6 +236,30 @@ module Aws::RDS
236
236
  # @option options [required, String] :engine_name
237
237
  # Specifies the name of the engine that this option group should be
238
238
  # associated with.
239
+ #
240
+ # Valid Values:
241
+ #
242
+ # * `mariadb`
243
+ #
244
+ # * `mysql`
245
+ #
246
+ # * `oracle-ee`
247
+ #
248
+ # * `oracle-se2`
249
+ #
250
+ # * `oracle-se1`
251
+ #
252
+ # * `oracle-se`
253
+ #
254
+ # * `postgres`
255
+ #
256
+ # * `sqlserver-ee`
257
+ #
258
+ # * `sqlserver-se`
259
+ #
260
+ # * `sqlserver-ex`
261
+ #
262
+ # * `sqlserver-web`
239
263
  # @option options [required, String] :major_engine_version
240
264
  # Specifies the major version of the engine that this option group
241
265
  # should be associated with.
@@ -371,7 +371,7 @@ module Aws::RDS
371
371
  #
372
372
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
373
373
  # @option options [String] :engine_mode
374
- # The DB engine mode of the DB cluster, either `provisioned`
374
+ # The DB engine mode of the DB cluster, either `provisioned`,
375
375
  # `serverless`, `parallelquery`, `global`, or `multimaster`.
376
376
  #
377
377
  # The `parallelquery` engine mode isn't required for Aurora MySQL
@@ -584,6 +584,7 @@ module Aws::RDS
584
584
  # ],
585
585
  # deletion_protection: false,
586
586
  # max_allocated_storage: 1,
587
+ # enable_customer_owned_ip: false,
587
588
  # })
588
589
  # @param [Hash] options ({})
589
590
  # @option options [String] :db_name
@@ -623,7 +624,7 @@ module Aws::RDS
623
624
  # **PostgreSQL**
624
625
  #
625
626
  # The name of the database to create when the DB instance is created. If
626
- # this parameter isn't specified, the default "postgres" database is
627
+ # this parameter isn't specified, a database named `postgres` is
627
628
  # created in the DB instance.
628
629
  #
629
630
  # Constraints:
@@ -653,17 +654,34 @@ module Aws::RDS
653
654
  #
654
655
  # Not applicable. Must be null.
655
656
  #
656
- # **Amazon Aurora**
657
+ # **Amazon Aurora MySQL**
657
658
  #
658
- # The name of the database to create when the primary instance of the DB
659
- # cluster is created. If this parameter isn't specified, no database is
660
- # created in the DB instance.
659
+ # The name of the database to create when the primary DB instance of the
660
+ # Aurora MySQL DB cluster is created. If this parameter isn't specified
661
+ # for an Aurora MySQL DB cluster, no database is created in the DB
662
+ # cluster.
661
663
  #
662
664
  # Constraints:
663
665
  #
664
- # * Must contain 1 to 64 letters or numbers.
666
+ # * It must contain 1 to 64 alphanumeric characters.
665
667
  #
666
- # * Can't be a word reserved by the specified database engine
668
+ # * It can't be a word reserved by the database engine.
669
+ #
670
+ # **Amazon Aurora PostgreSQL**
671
+ #
672
+ # The name of the database to create when the primary DB instance of the
673
+ # Aurora PostgreSQL DB cluster is created. If this parameter isn't
674
+ # specified for an Aurora PostgreSQL DB cluster, a database named
675
+ # `postgres` is created in the DB cluster.
676
+ #
677
+ # Constraints:
678
+ #
679
+ # * It must contain 1 to 63 alphanumeric characters.
680
+ #
681
+ # * It must begin with a letter or an underscore. Subsequent characters
682
+ # can be letters, underscores, or digits (0 to 9).
683
+ #
684
+ # * It can't be a word reserved by the database engine.
667
685
  # @option options [required, String] :db_instance_identifier
668
686
  # The DB instance identifier. This parameter is stored as a lowercase
669
687
  # string.
@@ -935,8 +953,8 @@ module Aws::RDS
935
953
  # specify the identifier of the custom Availability Zone to create the
936
954
  # DB instance in.
937
955
  #
938
- # For more information about RDS on VMware, see the [ *RDS on VMware
939
- # User Guide.* ][2]
956
+ # For more information about RDS on VMware, see the [ RDS on VMware User
957
+ # Guide.][2]
940
958
  #
941
959
  # </note>
942
960
  #
@@ -1112,8 +1130,8 @@ module Aws::RDS
1112
1130
  #
1113
1131
  # **PostgreSQL**
1114
1132
  #
1115
- # See [Supported PostgreSQL Database Versions][5] in the *Amazon RDS
1116
- # User Guide.*
1133
+ # See [Amazon RDS for PostgreSQL versions and extensions][5] in the
1134
+ # *Amazon RDS User Guide.*
1117
1135
  #
1118
1136
  #
1119
1137
  #
@@ -1121,7 +1139,7 @@ module Aws::RDS
1121
1139
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
1122
1140
  # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
1123
1141
  # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
1124
- # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.DBVersions
1142
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
1125
1143
  # @option options [Boolean] :auto_minor_version_upgrade
1126
1144
  # A value that indicates whether minor engine upgrades are applied
1127
1145
  # automatically to the DB instance during the maintenance window. By
@@ -1146,8 +1164,8 @@ module Aws::RDS
1146
1164
  #
1147
1165
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
1148
1166
  # @option options [String] :option_group_name
1149
- # Indicates that the DB instance should be associated with the specified
1150
- # option group.
1167
+ # A value that indicates that the DB instance should be associated with
1168
+ # the specified option group.
1151
1169
  #
1152
1170
  # Permanent options, such as the TDE option for Oracle Advanced Security
1153
1171
  # TDE, can't be removed from an option group. Also, that option group
@@ -1367,7 +1385,8 @@ module Aws::RDS
1367
1385
  #
1368
1386
  # **Oracle**
1369
1387
  #
1370
- # Possible values are `alert`, `audit`, `listener`, and `trace`.
1388
+ # Possible values are `alert`, `audit`, `listener`, `trace`, and
1389
+ # `oemagent`.
1371
1390
  #
1372
1391
  # **PostgreSQL**
1373
1392
  #
@@ -1398,6 +1417,33 @@ module Aws::RDS
1398
1417
  # @option options [Integer] :max_allocated_storage
1399
1418
  # The upper limit to which Amazon RDS can automatically scale the
1400
1419
  # storage of the DB instance.
1420
+ #
1421
+ # For more information about this setting, including limitations that
1422
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
1423
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
1424
+ #
1425
+ #
1426
+ #
1427
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
1428
+ # @option options [Boolean] :enable_customer_owned_ip
1429
+ # A value that indicates whether to enable a customer-owned IP address
1430
+ # (CoIP) for an RDS on Outposts DB instance.
1431
+ #
1432
+ # A *CoIP* provides local or external connectivity to resources in your
1433
+ # Outpost subnets through your on-premises network. For some use cases,
1434
+ # a CoIP can provide lower latency for connections to the DB instance
1435
+ # from outside of its virtual private cloud (VPC) on your local network.
1436
+ #
1437
+ # For more information about RDS on Outposts, see [Working with Amazon
1438
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
1439
+ #
1440
+ # For more information about CoIPs, see [Customer-owned IP addresses][2]
1441
+ # in the *AWS Outposts User Guide*.
1442
+ #
1443
+ #
1444
+ #
1445
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
1446
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
1401
1447
  # @return [DBInstance]
1402
1448
  def create_db_instance(options = {})
1403
1449
  resp = @client.create_db_instance(options)
@@ -1667,6 +1713,30 @@ module Aws::RDS
1667
1713
  # @option options [required, String] :engine_name
1668
1714
  # Specifies the name of the engine that this option group should be
1669
1715
  # associated with.
1716
+ #
1717
+ # Valid Values:
1718
+ #
1719
+ # * `mariadb`
1720
+ #
1721
+ # * `mysql`
1722
+ #
1723
+ # * `oracle-ee`
1724
+ #
1725
+ # * `oracle-se2`
1726
+ #
1727
+ # * `oracle-se1`
1728
+ #
1729
+ # * `oracle-se`
1730
+ #
1731
+ # * `postgres`
1732
+ #
1733
+ # * `sqlserver-ee`
1734
+ #
1735
+ # * `sqlserver-se`
1736
+ #
1737
+ # * `sqlserver-ex`
1738
+ #
1739
+ # * `sqlserver-web`
1670
1740
  # @option options [required, String] :major_engine_version
1671
1741
  # Specifies the major version of the engine that this option group
1672
1742
  # should be associated with.
@@ -1915,6 +1985,36 @@ module Aws::RDS
1915
1985
  # @param [Hash] options ({})
1916
1986
  # @option options [String] :engine
1917
1987
  # The database engine to return.
1988
+ #
1989
+ # Valid Values:
1990
+ #
1991
+ # * `aurora` (for MySQL 5.6-compatible Aurora)
1992
+ #
1993
+ # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
1994
+ #
1995
+ # * `aurora-postgresql`
1996
+ #
1997
+ # * `mariadb`
1998
+ #
1999
+ # * `mysql`
2000
+ #
2001
+ # * `oracle-ee`
2002
+ #
2003
+ # * `oracle-se2`
2004
+ #
2005
+ # * `oracle-se1`
2006
+ #
2007
+ # * `oracle-se`
2008
+ #
2009
+ # * `postgres`
2010
+ #
2011
+ # * `sqlserver-ee`
2012
+ #
2013
+ # * `sqlserver-se`
2014
+ #
2015
+ # * `sqlserver-ex`
2016
+ #
2017
+ # * `sqlserver-web`
1918
2018
  # @option options [String] :engine_version
1919
2019
  # The database engine version to return.
1920
2020
  #
@@ -2541,6 +2641,30 @@ module Aws::RDS
2541
2641
  # @option options [String] :engine_name
2542
2642
  # Filters the list of option groups to only include groups associated
2543
2643
  # with a specific database engine.
2644
+ #
2645
+ # Valid Values:
2646
+ #
2647
+ # * `mariadb`
2648
+ #
2649
+ # * `mysql`
2650
+ #
2651
+ # * `oracle-ee`
2652
+ #
2653
+ # * `oracle-se2`
2654
+ #
2655
+ # * `oracle-se1`
2656
+ #
2657
+ # * `oracle-se`
2658
+ #
2659
+ # * `postgres`
2660
+ #
2661
+ # * `sqlserver-ee`
2662
+ #
2663
+ # * `sqlserver-se`
2664
+ #
2665
+ # * `sqlserver-ex`
2666
+ #
2667
+ # * `sqlserver-web`
2544
2668
  # @option options [String] :major_engine_version
2545
2669
  # Filters the list of option groups to only include groups associated
2546
2670
  # with a specific database engine version. If specified, then EngineName
@@ -755,6 +755,45 @@ module Aws::RDS
755
755
  include Aws::Structure
756
756
  end
757
757
 
758
+ # This data type is used as a response element in the `ModifyDBCluster`
759
+ # operation and contains changes that will be applied during the next
760
+ # maintenance window.
761
+ #
762
+ # @!attribute [rw] pending_cloudwatch_logs_exports
763
+ # A list of the log types whose configuration is still pending. In
764
+ # other words, these log types are in the process of being activated
765
+ # or deactivated.
766
+ # @return [Types::PendingCloudwatchLogsExports]
767
+ #
768
+ # @!attribute [rw] db_cluster_identifier
769
+ # The DBClusterIdentifier value for the DB cluster.
770
+ # @return [String]
771
+ #
772
+ # @!attribute [rw] master_user_password
773
+ # The master credentials for the DB cluster.
774
+ # @return [String]
775
+ #
776
+ # @!attribute [rw] iam_database_authentication_enabled
777
+ # A value that indicates whether mapping of AWS Identity and Access
778
+ # Management (IAM) accounts to database accounts is enabled.
779
+ # @return [Boolean]
780
+ #
781
+ # @!attribute [rw] engine_version
782
+ # The database engine version.
783
+ # @return [String]
784
+ #
785
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ClusterPendingModifiedValues AWS API Documentation
786
+ #
787
+ class ClusterPendingModifiedValues < Struct.new(
788
+ :pending_cloudwatch_logs_exports,
789
+ :db_cluster_identifier,
790
+ :master_user_password,
791
+ :iam_database_authentication_enabled,
792
+ :engine_version)
793
+ SENSITIVE = []
794
+ include Aws::Structure
795
+ end
796
+
758
797
  # Specifies the settings that control the size and behavior of the
759
798
  # connection pool associated with a `DBProxyTargetGroup`.
760
799
  #
@@ -921,14 +960,7 @@ module Aws::RDS
921
960
  #
922
961
  # * Must specify a valid DB cluster parameter group.
923
962
  #
924
- # * If the source DB cluster parameter group is in the same AWS Region
925
- # as the copy, specify a valid DB parameter group identifier, for
926
- # example `my-db-cluster-param-group`, or a valid ARN.
927
- #
928
- # * If the source DB parameter group is in a different AWS Region than
929
- # the copy, specify a valid DB cluster parameter group ARN, for
930
- # example
931
- # `arn:aws:rds:us-east-1:123456789012:cluster-pg:custom-cluster-group1`.
963
+ # ^
932
964
  #
933
965
  #
934
966
  #
@@ -1198,8 +1230,7 @@ module Aws::RDS
1198
1230
  #
1199
1231
  # * Must specify a valid DB parameter group.
1200
1232
  #
1201
- # * Must specify a valid DB parameter group identifier, for example
1202
- # `my-db-param-group`, or a valid ARN.
1233
+ # ^
1203
1234
  #
1204
1235
  #
1205
1236
  #
@@ -1434,7 +1465,7 @@ module Aws::RDS
1434
1465
  # group. If your source DB instance uses Transparent Data Encryption
1435
1466
  # for Oracle or Microsoft SQL Server, you must specify this option
1436
1467
  # when copying across AWS Regions. For more information, see [Option
1437
- # Group Considerations][1] in the *Amazon RDS User Guide.*
1468
+ # group considerations][1] in the *Amazon RDS User Guide.*
1438
1469
  #
1439
1470
  #
1440
1471
  #
@@ -1608,8 +1639,8 @@ module Aws::RDS
1608
1639
  # A custom Availability Zone (AZ) is an on-premises AZ that is
1609
1640
  # integrated with a VMware vSphere cluster.
1610
1641
  #
1611
- # For more information about RDS on VMware, see the [ *RDS on VMware
1612
- # User Guide.* ][1]
1642
+ # For more information about RDS on VMware, see the [ RDS on VMware
1643
+ # User Guide.][1]
1613
1644
  #
1614
1645
  #
1615
1646
  #
@@ -2070,7 +2101,7 @@ module Aws::RDS
2070
2101
  # @return [Array<String>]
2071
2102
  #
2072
2103
  # @!attribute [rw] engine_mode
2073
- # The DB engine mode of the DB cluster, either `provisioned`
2104
+ # The DB engine mode of the DB cluster, either `provisioned`,
2074
2105
  # `serverless`, `parallelquery`, `global`, or `multimaster`.
2075
2106
  #
2076
2107
  # The `parallelquery` engine mode isn't required for Aurora MySQL
@@ -2446,6 +2477,7 @@ module Aws::RDS
2446
2477
  # ],
2447
2478
  # deletion_protection: false,
2448
2479
  # max_allocated_storage: 1,
2480
+ # enable_customer_owned_ip: false,
2449
2481
  # }
2450
2482
  #
2451
2483
  # @!attribute [rw] db_name
@@ -2485,8 +2517,8 @@ module Aws::RDS
2485
2517
  # **PostgreSQL**
2486
2518
  #
2487
2519
  # The name of the database to create when the DB instance is created.
2488
- # If this parameter isn't specified, the default "postgres"
2489
- # database is created in the DB instance.
2520
+ # If this parameter isn't specified, a database named `postgres` is
2521
+ # created in the DB instance.
2490
2522
  #
2491
2523
  # Constraints:
2492
2524
  #
@@ -2515,17 +2547,34 @@ module Aws::RDS
2515
2547
  #
2516
2548
  # Not applicable. Must be null.
2517
2549
  #
2518
- # **Amazon Aurora**
2550
+ # **Amazon Aurora MySQL**
2519
2551
  #
2520
- # The name of the database to create when the primary instance of the
2521
- # DB cluster is created. If this parameter isn't specified, no
2522
- # database is created in the DB instance.
2552
+ # The name of the database to create when the primary DB instance of
2553
+ # the Aurora MySQL DB cluster is created. If this parameter isn't
2554
+ # specified for an Aurora MySQL DB cluster, no database is created in
2555
+ # the DB cluster.
2523
2556
  #
2524
2557
  # Constraints:
2525
2558
  #
2526
- # * Must contain 1 to 64 letters or numbers.
2559
+ # * It must contain 1 to 64 alphanumeric characters.
2527
2560
  #
2528
- # * Can't be a word reserved by the specified database engine
2561
+ # * It can't be a word reserved by the database engine.
2562
+ #
2563
+ # **Amazon Aurora PostgreSQL**
2564
+ #
2565
+ # The name of the database to create when the primary DB instance of
2566
+ # the Aurora PostgreSQL DB cluster is created. If this parameter
2567
+ # isn't specified for an Aurora PostgreSQL DB cluster, a database
2568
+ # named `postgres` is created in the DB cluster.
2569
+ #
2570
+ # Constraints:
2571
+ #
2572
+ # * It must contain 1 to 63 alphanumeric characters.
2573
+ #
2574
+ # * It must begin with a letter or an underscore. Subsequent
2575
+ # characters can be letters, underscores, or digits (0 to 9).
2576
+ #
2577
+ # * It can't be a word reserved by the database engine.
2529
2578
  # @return [String]
2530
2579
  #
2531
2580
  # @!attribute [rw] db_instance_identifier
@@ -2816,8 +2865,8 @@ module Aws::RDS
2816
2865
  # specify the identifier of the custom Availability Zone to create the
2817
2866
  # DB instance in.
2818
2867
  #
2819
- # For more information about RDS on VMware, see the [ *RDS on VMware
2820
- # User Guide.* ][2]
2868
+ # For more information about RDS on VMware, see the [ RDS on VMware
2869
+ # User Guide.][2]
2821
2870
  #
2822
2871
  # </note>
2823
2872
  #
@@ -3010,8 +3059,8 @@ module Aws::RDS
3010
3059
  #
3011
3060
  # **PostgreSQL**
3012
3061
  #
3013
- # See [Supported PostgreSQL Database Versions][5] in the *Amazon RDS
3014
- # User Guide.*
3062
+ # See [Amazon RDS for PostgreSQL versions and extensions][5] in the
3063
+ # *Amazon RDS User Guide.*
3015
3064
  #
3016
3065
  #
3017
3066
  #
@@ -3019,7 +3068,7 @@ module Aws::RDS
3019
3068
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
3020
3069
  # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
3021
3070
  # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
3022
- # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.DBVersions
3071
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
3023
3072
  # @return [String]
3024
3073
  #
3025
3074
  # @!attribute [rw] auto_minor_version_upgrade
@@ -3052,8 +3101,8 @@ module Aws::RDS
3052
3101
  # @return [Integer]
3053
3102
  #
3054
3103
  # @!attribute [rw] option_group_name
3055
- # Indicates that the DB instance should be associated with the
3056
- # specified option group.
3104
+ # A value that indicates that the DB instance should be associated
3105
+ # with the specified option group.
3057
3106
  #
3058
3107
  # Permanent options, such as the TDE option for Oracle Advanced
3059
3108
  # Security TDE, can't be removed from an option group. Also, that
@@ -3319,7 +3368,8 @@ module Aws::RDS
3319
3368
  #
3320
3369
  # **Oracle**
3321
3370
  #
3322
- # Possible values are `alert`, `audit`, `listener`, and `trace`.
3371
+ # Possible values are `alert`, `audit`, `listener`, `trace`, and
3372
+ # `oemagent`.
3323
3373
  #
3324
3374
  # **PostgreSQL**
3325
3375
  #
@@ -3356,8 +3406,38 @@ module Aws::RDS
3356
3406
  # @!attribute [rw] max_allocated_storage
3357
3407
  # The upper limit to which Amazon RDS can automatically scale the
3358
3408
  # storage of the DB instance.
3409
+ #
3410
+ # For more information about this setting, including limitations that
3411
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
3412
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
3413
+ #
3414
+ #
3415
+ #
3416
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
3359
3417
  # @return [Integer]
3360
3418
  #
3419
+ # @!attribute [rw] enable_customer_owned_ip
3420
+ # A value that indicates whether to enable a customer-owned IP address
3421
+ # (CoIP) for an RDS on Outposts DB instance.
3422
+ #
3423
+ # A *CoIP* provides local or external connectivity to resources in
3424
+ # your Outpost subnets through your on-premises network. For some use
3425
+ # cases, a CoIP can provide lower latency for connections to the DB
3426
+ # instance from outside of its virtual private cloud (VPC) on your
3427
+ # local network.
3428
+ #
3429
+ # For more information about RDS on Outposts, see [Working with Amazon
3430
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
3431
+ #
3432
+ # For more information about CoIPs, see [Customer-owned IP
3433
+ # addresses][2] in the *AWS Outposts User Guide*.
3434
+ #
3435
+ #
3436
+ #
3437
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
3438
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
3439
+ # @return [Boolean]
3440
+ #
3361
3441
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceMessage AWS API Documentation
3362
3442
  #
3363
3443
  class CreateDBInstanceMessage < Struct.new(
@@ -3407,7 +3487,8 @@ module Aws::RDS
3407
3487
  :enable_cloudwatch_logs_exports,
3408
3488
  :processor_features,
3409
3489
  :deletion_protection,
3410
- :max_allocated_storage)
3490
+ :max_allocated_storage,
3491
+ :enable_customer_owned_ip)
3411
3492
  SENSITIVE = []
3412
3493
  include Aws::Structure
3413
3494
  end
@@ -3709,9 +3790,9 @@ module Aws::RDS
3709
3790
  # alias name for the AWS KMS CMK.
3710
3791
  #
3711
3792
  # If you create an encrypted read replica in the same AWS Region as
3712
- # the source DB instance, then you do not have to specify a value for
3713
- # this parameter. The read replica is encrypted with the same AWS KMS
3714
- # CMK as the source DB instance.
3793
+ # the source DB instance, then do not specify a value for this
3794
+ # parameter. A read replica in the same Region is always encrypted
3795
+ # with the same AWS KMS CMK as the source DB instance.
3715
3796
  #
3716
3797
  # If you create an encrypted read replica in a different AWS Region,
3717
3798
  # then you must specify a AWS KMS key identifier for the destination
@@ -3908,6 +3989,14 @@ module Aws::RDS
3908
3989
  # @!attribute [rw] max_allocated_storage
3909
3990
  # The upper limit to which Amazon RDS can automatically scale the
3910
3991
  # storage of the DB instance.
3992
+ #
3993
+ # For more information about this setting, including limitations that
3994
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
3995
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
3996
+ #
3997
+ #
3998
+ #
3999
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
3911
4000
  # @return [Integer]
3912
4001
  #
3913
4002
  # @!attribute [rw] source_region
@@ -4617,6 +4706,30 @@ module Aws::RDS
4617
4706
  # @!attribute [rw] engine_name
4618
4707
  # Specifies the name of the engine that this option group should be
4619
4708
  # associated with.
4709
+ #
4710
+ # Valid Values:
4711
+ #
4712
+ # * `mariadb`
4713
+ #
4714
+ # * `mysql`
4715
+ #
4716
+ # * `oracle-ee`
4717
+ #
4718
+ # * `oracle-se2`
4719
+ #
4720
+ # * `oracle-se1`
4721
+ #
4722
+ # * `oracle-se`
4723
+ #
4724
+ # * `postgres`
4725
+ #
4726
+ # * `sqlserver-ee`
4727
+ #
4728
+ # * `sqlserver-se`
4729
+ #
4730
+ # * `sqlserver-ex`
4731
+ #
4732
+ # * `sqlserver-web`
4620
4733
  # @return [String]
4621
4734
  #
4622
4735
  # @!attribute [rw] major_engine_version
@@ -4658,8 +4771,8 @@ module Aws::RDS
4658
4771
  # A custom Availability Zone (AZ) is an on-premises AZ that is
4659
4772
  # integrated with a VMware vSphere cluster.
4660
4773
  #
4661
- # For more information about RDS on VMware, see the [ *RDS on VMware
4662
- # User Guide.* ][1]
4774
+ # For more information about RDS on VMware, see the [ RDS on VMware User
4775
+ # Guide.][1]
4663
4776
  #
4664
4777
  #
4665
4778
  #
@@ -5080,6 +5193,12 @@ module Aws::RDS
5080
5193
  # cluster.
5081
5194
  # @return [Boolean]
5082
5195
  #
5196
+ # @!attribute [rw] pending_modified_values
5197
+ # A value that specifies that changes to the DB cluster are pending.
5198
+ # This element is only included when changes are pending. Specific
5199
+ # changes are identified by subelements.
5200
+ # @return [Types::ClusterPendingModifiedValues]
5201
+ #
5083
5202
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBCluster AWS API Documentation
5084
5203
  #
5085
5204
  class DBCluster < Struct.new(
@@ -5137,7 +5256,8 @@ module Aws::RDS
5137
5256
  :domain_memberships,
5138
5257
  :tag_list,
5139
5258
  :global_write_forwarding_status,
5140
- :global_write_forwarding_requested)
5259
+ :global_write_forwarding_requested,
5260
+ :pending_modified_values)
5141
5261
  SENSITIVE = []
5142
5262
  include Aws::Structure
5143
5263
  end
@@ -6130,9 +6250,9 @@ module Aws::RDS
6130
6250
  # @return [String]
6131
6251
  #
6132
6252
  # @!attribute [rw] pending_modified_values
6133
- # Specifies that changes to the DB instance are pending. This element
6134
- # is only included when changes are pending. Specific changes are
6135
- # identified by subelements.
6253
+ # A value that specifies that changes to the DB instance are pending.
6254
+ # This element is only included when changes are pending. Specific
6255
+ # changes are identified by subelements.
6136
6256
  # @return [Types::PendingModifiedValues]
6137
6257
  #
6138
6258
  # @!attribute [rw] latest_restorable_time
@@ -6149,7 +6269,8 @@ module Aws::RDS
6149
6269
  # @return [String]
6150
6270
  #
6151
6271
  # @!attribute [rw] auto_minor_version_upgrade
6152
- # Indicates that minor version patches are applied automatically.
6272
+ # A value that indicates that minor version patches are applied
6273
+ # automatically.
6153
6274
  # @return [Boolean]
6154
6275
  #
6155
6276
  # @!attribute [rw] read_replica_source_db_instance_identifier
@@ -6423,6 +6544,28 @@ module Aws::RDS
6423
6544
  # instance.
6424
6545
  # @return [Array<Types::DBInstanceAutomatedBackupsReplication>]
6425
6546
  #
6547
+ # @!attribute [rw] customer_owned_ip_enabled
6548
+ # Specifies whether a customer-owned IP address (CoIP) is enabled for
6549
+ # an RDS on Outposts DB instance.
6550
+ #
6551
+ # A <i>CoIP </i>provides local or external connectivity to resources
6552
+ # in your Outpost subnets through your on-premises network. For some
6553
+ # use cases, a CoIP can provide lower latency for connections to the
6554
+ # DB instance from outside of its virtual private cloud (VPC) on your
6555
+ # local network.
6556
+ #
6557
+ # For more information about RDS on Outposts, see [Working with Amazon
6558
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
6559
+ #
6560
+ # For more information about CoIPs, see [Customer-owned IP
6561
+ # addresses][2] in the *AWS Outposts User Guide*.
6562
+ #
6563
+ #
6564
+ #
6565
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
6566
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
6567
+ # @return [Boolean]
6568
+ #
6426
6569
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBInstance AWS API Documentation
6427
6570
  #
6428
6571
  class DBInstance < Struct.new(
@@ -6487,7 +6630,8 @@ module Aws::RDS
6487
6630
  :listener_endpoint,
6488
6631
  :max_allocated_storage,
6489
6632
  :tag_list,
6490
- :db_instance_automated_backups_replications)
6633
+ :db_instance_automated_backups_replications,
6634
+ :customer_owned_ip_enabled)
6491
6635
  SENSITIVE = []
6492
6636
  include Aws::Structure
6493
6637
  end
@@ -7790,8 +7934,8 @@ module Aws::RDS
7790
7934
  # A custom Availability Zone (AZ) is an on-premises AZ that is
7791
7935
  # integrated with a VMware vSphere cluster.
7792
7936
  #
7793
- # For more information about RDS on VMware, see the [ *RDS on VMware
7794
- # User Guide.* ][1]
7937
+ # For more information about RDS on VMware, see the [ RDS on VMware
7938
+ # User Guide.][1]
7795
7939
  #
7796
7940
  #
7797
7941
  #
@@ -9116,6 +9260,36 @@ module Aws::RDS
9116
9260
  #
9117
9261
  # @!attribute [rw] engine
9118
9262
  # The database engine to return.
9263
+ #
9264
+ # Valid Values:
9265
+ #
9266
+ # * `aurora` (for MySQL 5.6-compatible Aurora)
9267
+ #
9268
+ # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
9269
+ #
9270
+ # * `aurora-postgresql`
9271
+ #
9272
+ # * `mariadb`
9273
+ #
9274
+ # * `mysql`
9275
+ #
9276
+ # * `oracle-ee`
9277
+ #
9278
+ # * `oracle-se2`
9279
+ #
9280
+ # * `oracle-se1`
9281
+ #
9282
+ # * `oracle-se`
9283
+ #
9284
+ # * `postgres`
9285
+ #
9286
+ # * `sqlserver-ee`
9287
+ #
9288
+ # * `sqlserver-se`
9289
+ #
9290
+ # * `sqlserver-ex`
9291
+ #
9292
+ # * `sqlserver-web`
9119
9293
  # @return [String]
9120
9294
  #
9121
9295
  # @!attribute [rw] engine_version
@@ -9243,20 +9417,19 @@ module Aws::RDS
9243
9417
  #
9244
9418
  # * `active` - automated backups for current instances
9245
9419
  #
9246
- # * `retained` - automated backups for deleted instances
9420
+ # * `retained` - automated backups for deleted instances and after
9421
+ # backup replication is stopped
9247
9422
  #
9248
9423
  # * `creating` - automated backups that are waiting for the first
9249
9424
  # automated snapshot to be available
9250
9425
  #
9251
9426
  # * `db-instance-id` - Accepts DB instance identifiers and Amazon
9252
- # Resource Names (ARNs) for DB instances. The results list includes
9253
- # only information about the DB instance automated backupss
9254
- # identified by these ARNs.
9427
+ # Resource Names (ARNs). The results list includes only information
9428
+ # about the DB instance automated backups identified by these ARNs.
9255
9429
  #
9256
- # * `dbi-resource-id` - Accepts DB instance resource identifiers and
9257
- # DB Amazon Resource Names (ARNs) for DB instances. The results list
9258
- # includes only information about the DB instance resources
9259
- # identified by these ARNs.
9430
+ # * `dbi-resource-id` - Accepts DB resource identifiers and Amazon
9431
+ # Resource Names (ARNs). The results list includes only information
9432
+ # about the DB instance resources identified by these ARNs.
9260
9433
  #
9261
9434
  # Returns all resources by default. The status for each resource is
9262
9435
  # specified in the response.
@@ -10715,6 +10888,30 @@ module Aws::RDS
10715
10888
  # @!attribute [rw] engine_name
10716
10889
  # A required parameter. Options available for the given engine name
10717
10890
  # are described.
10891
+ #
10892
+ # Valid Values:
10893
+ #
10894
+ # * `mariadb`
10895
+ #
10896
+ # * `mysql`
10897
+ #
10898
+ # * `oracle-ee`
10899
+ #
10900
+ # * `oracle-se2`
10901
+ #
10902
+ # * `oracle-se1`
10903
+ #
10904
+ # * `oracle-se`
10905
+ #
10906
+ # * `postgres`
10907
+ #
10908
+ # * `sqlserver-ee`
10909
+ #
10910
+ # * `sqlserver-se`
10911
+ #
10912
+ # * `sqlserver-ex`
10913
+ #
10914
+ # * `sqlserver-web`
10718
10915
  # @return [String]
10719
10916
  #
10720
10917
  # @!attribute [rw] major_engine_version
@@ -10802,6 +10999,30 @@ module Aws::RDS
10802
10999
  # @!attribute [rw] engine_name
10803
11000
  # Filters the list of option groups to only include groups associated
10804
11001
  # with a specific database engine.
11002
+ #
11003
+ # Valid Values:
11004
+ #
11005
+ # * `mariadb`
11006
+ #
11007
+ # * `mysql`
11008
+ #
11009
+ # * `oracle-ee`
11010
+ #
11011
+ # * `oracle-se2`
11012
+ #
11013
+ # * `oracle-se1`
11014
+ #
11015
+ # * `oracle-se`
11016
+ #
11017
+ # * `postgres`
11018
+ #
11019
+ # * `sqlserver-ee`
11020
+ #
11021
+ # * `sqlserver-se`
11022
+ #
11023
+ # * `sqlserver-ex`
11024
+ #
11025
+ # * `sqlserver-web`
10805
11026
  # @return [String]
10806
11027
  #
10807
11028
  # @!attribute [rw] major_engine_version
@@ -10845,6 +11066,36 @@ module Aws::RDS
10845
11066
  #
10846
11067
  # @!attribute [rw] engine
10847
11068
  # The name of the engine to retrieve DB instance options for.
11069
+ #
11070
+ # Valid Values:
11071
+ #
11072
+ # * `aurora` (for MySQL 5.6-compatible Aurora)
11073
+ #
11074
+ # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
11075
+ #
11076
+ # * `aurora-postgresql`
11077
+ #
11078
+ # * `mariadb`
11079
+ #
11080
+ # * `mysql`
11081
+ #
11082
+ # * `oracle-ee`
11083
+ #
11084
+ # * `oracle-se2`
11085
+ #
11086
+ # * `oracle-se1`
11087
+ #
11088
+ # * `oracle-se`
11089
+ #
11090
+ # * `postgres`
11091
+ #
11092
+ # * `sqlserver-ee`
11093
+ #
11094
+ # * `sqlserver-se`
11095
+ #
11096
+ # * `sqlserver-ex`
11097
+ #
11098
+ # * `sqlserver-web`
10848
11099
  # @return [String]
10849
11100
  #
10850
11101
  # @!attribute [rw] engine_version
@@ -12039,6 +12290,10 @@ module Aws::RDS
12039
12290
  include Aws::Structure
12040
12291
  end
12041
12292
 
12293
+ # The `GlobalClusterIdentifier` already exists. Choose a new global
12294
+ # database identifier (unique name) to create a new global database
12295
+ # cluster.
12296
+ #
12042
12297
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/GlobalClusterAlreadyExistsFault AWS API Documentation
12043
12298
  #
12044
12299
  class GlobalClusterAlreadyExistsFault < Aws::EmptyStructure; end
@@ -12078,10 +12333,16 @@ module Aws::RDS
12078
12333
  include Aws::Structure
12079
12334
  end
12080
12335
 
12336
+ # The `GlobalClusterIdentifier` doesn't refer to an existing global
12337
+ # database cluster.
12338
+ #
12081
12339
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/GlobalClusterNotFoundFault AWS API Documentation
12082
12340
  #
12083
12341
  class GlobalClusterNotFoundFault < Aws::EmptyStructure; end
12084
12342
 
12343
+ # The number of global database clusters for this account is already at
12344
+ # the maximum allowed.
12345
+ #
12085
12346
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/GlobalClusterQuotaExceededFault AWS API Documentation
12086
12347
  #
12087
12348
  class GlobalClusterQuotaExceededFault < Aws::EmptyStructure; end
@@ -12469,6 +12730,9 @@ module Aws::RDS
12469
12730
  #
12470
12731
  class InvalidExportTaskStateFault < Aws::EmptyStructure; end
12471
12732
 
12733
+ # The global cluster is in an invalid state and can't perform the
12734
+ # requested operation.
12735
+ #
12472
12736
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/InvalidGlobalClusterStateFault AWS API Documentation
12473
12737
  #
12474
12738
  class InvalidGlobalClusterStateFault < Aws::EmptyStructure; end
@@ -13278,6 +13542,7 @@ module Aws::RDS
13278
13542
  # max_allocated_storage: 1,
13279
13543
  # certificate_rotation_restart: false,
13280
13544
  # replica_mode: "open-read-only", # accepts open-read-only, mounted
13545
+ # enable_customer_owned_ip: false,
13281
13546
  # }
13282
13547
  #
13283
13548
  # @!attribute [rw] db_instance_identifier
@@ -13326,8 +13591,8 @@ module Aws::RDS
13326
13591
  # The new DB subnet group for the DB instance. You can use this
13327
13592
  # parameter to move your DB instance to a different VPC. If your DB
13328
13593
  # instance isn't in a VPC, you can also use this parameter to move
13329
- # your DB instance into a VPC. For more information, see [Updating the
13330
- # VPC for a DB Instance][1] in the *Amazon RDS User Guide.*
13594
+ # your DB instance into a VPC. For more information, see [Working with
13595
+ # a DB instance in a VPC][1] in the *Amazon RDS User Guide.*
13331
13596
  #
13332
13597
  # Changing the subnet group causes an outage during the change. The
13333
13598
  # change is applied during the next maintenance window, unless you
@@ -13340,7 +13605,7 @@ module Aws::RDS
13340
13605
  #
13341
13606
  #
13342
13607
  #
13343
- # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.Non-VPC2VPC
13608
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.Non-VPC2VPC
13344
13609
  # @return [String]
13345
13610
  #
13346
13611
  # @!attribute [rw] db_security_groups
@@ -13548,8 +13813,10 @@ module Aws::RDS
13548
13813
  # parameter group can be the default for that DB parameter group
13549
13814
  # family.
13550
13815
  #
13551
- # For information about valid engine versions, see `CreateDBInstance`,
13552
- # or call `DescribeDBEngineVersions`.
13816
+ # If you specify only a major version, Amazon RDS will update the DB
13817
+ # instance to the default minor version if the current minor version
13818
+ # is lower. For information about valid engine versions, see
13819
+ # `CreateDBInstance`, or call `DescribeDBEngineVersions`.
13553
13820
  # @return [String]
13554
13821
  #
13555
13822
  # @!attribute [rw] allow_major_version_upgrade
@@ -13615,7 +13882,7 @@ module Aws::RDS
13615
13882
  # @return [Integer]
13616
13883
  #
13617
13884
  # @!attribute [rw] option_group_name
13618
- # Indicates that the DB instance should be associated with the
13885
+ # A value that indicates the DB instance should be associated with the
13619
13886
  # specified option group. Changing this parameter doesn't result in
13620
13887
  # an outage except in the following case and the change is applied
13621
13888
  # during the next maintenance window unless the `ApplyImmediately`
@@ -13916,6 +14183,14 @@ module Aws::RDS
13916
14183
  # @!attribute [rw] max_allocated_storage
13917
14184
  # The upper limit to which Amazon RDS can automatically scale the
13918
14185
  # storage of the DB instance.
14186
+ #
14187
+ # For more information about this setting, including limitations that
14188
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
14189
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
14190
+ #
14191
+ #
14192
+ #
14193
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
13919
14194
  # @return [Integer]
13920
14195
  #
13921
14196
  # @!attribute [rw] certificate_rotation_restart
@@ -13968,6 +14243,28 @@ module Aws::RDS
13968
14243
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
13969
14244
  # @return [String]
13970
14245
  #
14246
+ # @!attribute [rw] enable_customer_owned_ip
14247
+ # A value that indicates whether to enable a customer-owned IP address
14248
+ # (CoIP) for an RDS on Outposts DB instance.
14249
+ #
14250
+ # A *CoIP* provides local or external connectivity to resources in
14251
+ # your Outpost subnets through your on-premises network. For some use
14252
+ # cases, a CoIP can provide lower latency for connections to the DB
14253
+ # instance from outside of its virtual private cloud (VPC) on your
14254
+ # local network.
14255
+ #
14256
+ # For more information about RDS on Outposts, see [Working with Amazon
14257
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
14258
+ #
14259
+ # For more information about CoIPs, see [Customer-owned IP
14260
+ # addresses][2] in the *AWS Outposts User Guide*.
14261
+ #
14262
+ #
14263
+ #
14264
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
14265
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
14266
+ # @return [Boolean]
14267
+ #
13971
14268
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstanceMessage AWS API Documentation
13972
14269
  #
13973
14270
  class ModifyDBInstanceMessage < Struct.new(
@@ -14013,7 +14310,8 @@ module Aws::RDS
14013
14310
  :deletion_protection,
14014
14311
  :max_allocated_storage,
14015
14312
  :certificate_rotation_restart,
14016
- :replica_mode)
14313
+ :replica_mode,
14314
+ :enable_customer_owned_ip)
14017
14315
  SENSITIVE = []
14018
14316
  include Aws::Structure
14019
14317
  end
@@ -14375,11 +14673,11 @@ module Aws::RDS
14375
14673
  # You can specify this parameter when you upgrade an Oracle DB
14376
14674
  # snapshot. The same option group considerations apply when upgrading
14377
14675
  # a DB snapshot as when upgrading a DB instance. For more information,
14378
- # see [Option Group Considerations][1] in the *Amazon RDS User Guide.*
14676
+ # see [Option group considerations][1] in the *Amazon RDS User Guide.*
14379
14677
  #
14380
14678
  #
14381
14679
  #
14382
- # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Oracle.html#USER_UpgradeDBInstance.Oracle.OGPG.OG
14680
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Oracle.html#USER_UpgradeDBInstance.Oracle.OGPG.OG
14383
14681
  # @return [String]
14384
14682
  #
14385
14683
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSnapshotMessage AWS API Documentation
@@ -14537,6 +14835,8 @@ module Aws::RDS
14537
14835
  # global_cluster_identifier: "String",
14538
14836
  # new_global_cluster_identifier: "String",
14539
14837
  # deletion_protection: false,
14838
+ # engine_version: "String",
14839
+ # allow_major_version_upgrade: false,
14540
14840
  # }
14541
14841
  #
14542
14842
  # @!attribute [rw] global_cluster_identifier
@@ -14572,12 +14872,53 @@ module Aws::RDS
14572
14872
  # protection is enabled.
14573
14873
  # @return [Boolean]
14574
14874
  #
14875
+ # @!attribute [rw] engine_version
14876
+ # The version number of the database engine to which you want to
14877
+ # upgrade. Changing this parameter results in an outage. The change is
14878
+ # applied during the next maintenance window unless `ApplyImmediately`
14879
+ # is enabled.
14880
+ #
14881
+ # To list all of the available engine versions for `aurora` (for MySQL
14882
+ # 5.6-compatible Aurora), use the following command:
14883
+ #
14884
+ # `` aws rds describe-db-engine-versions --engine aurora --query
14885
+ # '*[]|[?SupportsGlobalDatabases == `true`].[EngineVersion]' ``
14886
+ #
14887
+ # To list all of the available engine versions for `aurora-mysql` (for
14888
+ # MySQL 5.7-compatible Aurora), use the following command:
14889
+ #
14890
+ # `` aws rds describe-db-engine-versions --engine aurora-mysql --query
14891
+ # '*[]|[?SupportsGlobalDatabases == `true`].[EngineVersion]' ``
14892
+ #
14893
+ # To list all of the available engine versions for
14894
+ # `aurora-postgresql`, use the following command:
14895
+ #
14896
+ # `` aws rds describe-db-engine-versions --engine aurora-postgresql
14897
+ # --query '*[]|[?SupportsGlobalDatabases == `true`].[EngineVersion]'
14898
+ # ``
14899
+ # @return [String]
14900
+ #
14901
+ # @!attribute [rw] allow_major_version_upgrade
14902
+ # A value that indicates whether major version upgrades are allowed.
14903
+ #
14904
+ # Constraints: You must allow major version upgrades when specifying a
14905
+ # value for the `EngineVersion` parameter that is a different major
14906
+ # version than the DB cluster's current version.
14907
+ #
14908
+ # If you upgrade the major version of a global database, the cluster
14909
+ # and DB instance parameter groups are set to the default parameter
14910
+ # groups for the new version. Apply any custom parameter groups after
14911
+ # completing the upgrade.
14912
+ # @return [Boolean]
14913
+ #
14575
14914
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyGlobalClusterMessage AWS API Documentation
14576
14915
  #
14577
14916
  class ModifyGlobalClusterMessage < Struct.new(
14578
14917
  :global_cluster_identifier,
14579
14918
  :new_global_cluster_identifier,
14580
- :deletion_protection)
14919
+ :deletion_protection,
14920
+ :engine_version,
14921
+ :allow_major_version_upgrade)
14581
14922
  SENSITIVE = []
14582
14923
  include Aws::Structure
14583
14924
  end
@@ -15575,39 +15916,38 @@ module Aws::RDS
15575
15916
  end
15576
15917
 
15577
15918
  # This data type is used as a response element in the `ModifyDBInstance`
15578
- # action.
15919
+ # operation and contains changes that will be applied during the next
15920
+ # maintenance window.
15579
15921
  #
15580
15922
  # @!attribute [rw] db_instance_class
15581
- # Contains the new `DBInstanceClass` for the DB instance that will be
15582
- # applied or is currently being applied.
15923
+ # The name of the compute and memory capacity class for the DB
15924
+ # instance.
15583
15925
  # @return [String]
15584
15926
  #
15585
15927
  # @!attribute [rw] allocated_storage
15586
- # Contains the new `AllocatedStorage` size for the DB instance that
15587
- # will be applied or is currently being applied.
15928
+ # The allocated storage size for the DB instance specified in
15929
+ # gibibytes .
15588
15930
  # @return [Integer]
15589
15931
  #
15590
15932
  # @!attribute [rw] master_user_password
15591
- # Contains the pending or currently-in-progress change of the master
15592
- # credentials for the DB instance.
15933
+ # The master credentials for the DB instance.
15593
15934
  # @return [String]
15594
15935
  #
15595
15936
  # @!attribute [rw] port
15596
- # Specifies the pending port for the DB instance.
15937
+ # The port for the DB instance.
15597
15938
  # @return [Integer]
15598
15939
  #
15599
15940
  # @!attribute [rw] backup_retention_period
15600
- # Specifies the pending number of days for which automated backups are
15601
- # retained.
15941
+ # The number of days for which automated backups are retained.
15602
15942
  # @return [Integer]
15603
15943
  #
15604
15944
  # @!attribute [rw] multi_az
15605
- # Indicates that the Single-AZ DB instance is to change to a Multi-AZ
15606
- # deployment.
15945
+ # A value that indicates that the Single-AZ DB instance will change to
15946
+ # a Multi-AZ deployment.
15607
15947
  # @return [Boolean]
15608
15948
  #
15609
15949
  # @!attribute [rw] engine_version
15610
- # Indicates the database engine version.
15950
+ # The database engine version.
15611
15951
  # @return [String]
15612
15952
  #
15613
15953
  # @!attribute [rw] license_model
@@ -15618,25 +15958,23 @@ module Aws::RDS
15618
15958
  # @return [String]
15619
15959
  #
15620
15960
  # @!attribute [rw] iops
15621
- # Specifies the new Provisioned IOPS value for the DB instance that
15622
- # will be applied or is currently being applied.
15961
+ # The Provisioned IOPS value for the DB instance.
15623
15962
  # @return [Integer]
15624
15963
  #
15625
15964
  # @!attribute [rw] db_instance_identifier
15626
- # Contains the new `DBInstanceIdentifier` for the DB instance that
15627
- # will be applied or is currently being applied.
15965
+ # The database identifier for the DB instance.
15628
15966
  # @return [String]
15629
15967
  #
15630
15968
  # @!attribute [rw] storage_type
15631
- # Specifies the storage type to be associated with the DB instance.
15969
+ # The storage type of the DB instance.
15632
15970
  # @return [String]
15633
15971
  #
15634
15972
  # @!attribute [rw] ca_certificate_identifier
15635
- # Specifies the identifier of the CA certificate for the DB instance.
15973
+ # The identifier of the CA certificate for the DB instance.
15636
15974
  # @return [String]
15637
15975
  #
15638
15976
  # @!attribute [rw] db_subnet_group_name
15639
- # The new DB subnet group for the DB instance.
15977
+ # The DB subnet group for the DB instance.
15640
15978
  # @return [String]
15641
15979
  #
15642
15980
  # @!attribute [rw] pending_cloudwatch_logs_exports
@@ -15650,6 +15988,11 @@ module Aws::RDS
15650
15988
  # DB instance class of the DB instance.
15651
15989
  # @return [Array<Types::ProcessorFeature>]
15652
15990
  #
15991
+ # @!attribute [rw] iam_database_authentication_enabled
15992
+ # Whether mapping of AWS Identity and Access Management (IAM) accounts
15993
+ # to database accounts is enabled.
15994
+ # @return [Boolean]
15995
+ #
15653
15996
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PendingModifiedValues AWS API Documentation
15654
15997
  #
15655
15998
  class PendingModifiedValues < Struct.new(
@@ -15667,7 +16010,8 @@ module Aws::RDS
15667
16010
  :ca_certificate_identifier,
15668
16011
  :db_subnet_group_name,
15669
16012
  :pending_cloudwatch_logs_exports,
15670
- :processor_features)
16013
+ :processor_features,
16014
+ :iam_database_authentication_enabled)
15671
16015
  SENSITIVE = []
15672
16016
  include Aws::Structure
15673
16017
  end
@@ -17740,6 +18084,7 @@ module Aws::RDS
17740
18084
  # use_default_processor_features: false,
17741
18085
  # db_parameter_group_name: "String",
17742
18086
  # deletion_protection: false,
18087
+ # enable_customer_owned_ip: false,
17743
18088
  # }
17744
18089
  #
17745
18090
  # @!attribute [rw] db_instance_identifier
@@ -18049,6 +18394,28 @@ module Aws::RDS
18049
18394
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html
18050
18395
  # @return [Boolean]
18051
18396
  #
18397
+ # @!attribute [rw] enable_customer_owned_ip
18398
+ # A value that indicates whether to enable a customer-owned IP address
18399
+ # (CoIP) for an RDS on Outposts DB instance.
18400
+ #
18401
+ # A *CoIP* provides local or external connectivity to resources in
18402
+ # your Outpost subnets through your on-premises network. For some use
18403
+ # cases, a CoIP can provide lower latency for connections to the DB
18404
+ # instance from outside of its virtual private cloud (VPC) on your
18405
+ # local network.
18406
+ #
18407
+ # For more information about RDS on Outposts, see [Working with Amazon
18408
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
18409
+ #
18410
+ # For more information about CoIPs, see [Customer-owned IP
18411
+ # addresses][2] in the *AWS Outposts User Guide*.
18412
+ #
18413
+ #
18414
+ #
18415
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
18416
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
18417
+ # @return [Boolean]
18418
+ #
18052
18419
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshotMessage AWS API Documentation
18053
18420
  #
18054
18421
  class RestoreDBInstanceFromDBSnapshotMessage < Struct.new(
@@ -18079,7 +18446,8 @@ module Aws::RDS
18079
18446
  :processor_features,
18080
18447
  :use_default_processor_features,
18081
18448
  :db_parameter_group_name,
18082
- :deletion_protection)
18449
+ :deletion_protection,
18450
+ :enable_customer_owned_ip)
18083
18451
  SENSITIVE = []
18084
18452
  include Aws::Structure
18085
18453
  end
@@ -18567,6 +18935,14 @@ module Aws::RDS
18567
18935
  # @!attribute [rw] max_allocated_storage
18568
18936
  # The upper limit to which Amazon RDS can automatically scale the
18569
18937
  # storage of the DB instance.
18938
+ #
18939
+ # For more information about this setting, including limitations that
18940
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
18941
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
18942
+ #
18943
+ #
18944
+ #
18945
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
18570
18946
  # @return [Integer]
18571
18947
  #
18572
18948
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromS3Message AWS API Documentation
@@ -18682,6 +19058,7 @@ module Aws::RDS
18682
19058
  # source_dbi_resource_id: "String",
18683
19059
  # max_allocated_storage: 1,
18684
19060
  # source_db_instance_automated_backups_arn: "String",
19061
+ # enable_customer_owned_ip: false,
18685
19062
  # }
18686
19063
  #
18687
19064
  # @!attribute [rw] source_db_instance_identifier
@@ -19008,6 +19385,14 @@ module Aws::RDS
19008
19385
  # @!attribute [rw] max_allocated_storage
19009
19386
  # The upper limit to which Amazon RDS can automatically scale the
19010
19387
  # storage of the DB instance.
19388
+ #
19389
+ # For more information about this setting, including limitations that
19390
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
19391
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
19392
+ #
19393
+ #
19394
+ #
19395
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
19011
19396
  # @return [Integer]
19012
19397
  #
19013
19398
  # @!attribute [rw] source_db_instance_automated_backups_arn
@@ -19016,6 +19401,28 @@ module Aws::RDS
19016
19401
  # `arn:aws:rds:useast-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
19017
19402
  # @return [String]
19018
19403
  #
19404
+ # @!attribute [rw] enable_customer_owned_ip
19405
+ # A value that indicates whether to enable a customer-owned IP address
19406
+ # (CoIP) for an RDS on Outposts DB instance.
19407
+ #
19408
+ # A *CoIP* provides local or external connectivity to resources in
19409
+ # your Outpost subnets through your on-premises network. For some use
19410
+ # cases, a CoIP can provide lower latency for connections to the DB
19411
+ # instance from outside of its virtual private cloud (VPC) on your
19412
+ # local network.
19413
+ #
19414
+ # For more information about RDS on Outposts, see [Working with Amazon
19415
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
19416
+ #
19417
+ # For more information about CoIPs, see [Customer-owned IP
19418
+ # addresses][2] in the *AWS Outposts User Guide*.
19419
+ #
19420
+ #
19421
+ #
19422
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
19423
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
19424
+ # @return [Boolean]
19425
+ #
19019
19426
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceToPointInTimeMessage AWS API Documentation
19020
19427
  #
19021
19428
  class RestoreDBInstanceToPointInTimeMessage < Struct.new(
@@ -19051,7 +19458,8 @@ module Aws::RDS
19051
19458
  :deletion_protection,
19052
19459
  :source_dbi_resource_id,
19053
19460
  :max_allocated_storage,
19054
- :source_db_instance_automated_backups_arn)
19461
+ :source_db_instance_automated_backups_arn,
19462
+ :enable_customer_owned_ip)
19055
19463
  SENSITIVE = []
19056
19464
  include Aws::Structure
19057
19465
  end
@@ -20277,8 +20685,8 @@ module Aws::RDS
20277
20685
  # Information about the virtual private network (VPN) between the VMware
20278
20686
  # vSphere cluster and the AWS website.
20279
20687
  #
20280
- # For more information about RDS on VMware, see the [ *RDS on VMware
20281
- # User Guide.* ][1]
20688
+ # For more information about RDS on VMware, see the [ RDS on VMware User
20689
+ # Guide.][1]
20282
20690
  #
20283
20691
  #
20284
20692
  #