aws-sdk-rds 1.108.0 → 1.113.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
@@ -451,12 +451,19 @@ module Aws::RDS
451
451
  # Specify the name of the IAM role to be used when making API calls to
452
452
  # the Directory Service.
453
453
  # @option options [Boolean] :enable_global_write_forwarding
454
- # A value that indicates whether to enable write operations to be
455
- # forwarded from this cluster to the primary cluster in an Aurora global
456
- # database. The resulting changes are replicated back to this cluster.
457
- # This parameter only applies to DB clusters that are secondary clusters
458
- # in an Aurora global database. By default, Aurora disallows write
459
- # operations for secondary clusters.
454
+ # A value that indicates whether to enable this DB cluster to forward
455
+ # write operations to the primary cluster of an Aurora global database
456
+ # (GlobalCluster). By default, write operations are not allowed on
457
+ # Aurora DB clusters that are secondary clusters in an Aurora global
458
+ # database.
459
+ #
460
+ # You can set this value only on Aurora DB clusters that are members of
461
+ # an Aurora global database. With this parameter enabled, a secondary
462
+ # cluster can forward writes to the current primary cluster and the
463
+ # resulting changes are replicated back to this cluster. For the primary
464
+ # DB cluster of an Aurora global database, this value is used
465
+ # immediately if the primary is demoted by the FailoverGlobalCluster API
466
+ # operation, but it does nothing until then.
460
467
  # @option options [String] :source_region
461
468
  # The source region of the snapshot. This is only needed when the
462
469
  # shapshot is encrypted and in a different region.
@@ -584,6 +591,7 @@ module Aws::RDS
584
591
  # ],
585
592
  # deletion_protection: false,
586
593
  # max_allocated_storage: 1,
594
+ # enable_customer_owned_ip: false,
587
595
  # })
588
596
  # @param [Hash] options ({})
589
597
  # @option options [String] :db_name
@@ -623,8 +631,8 @@ module Aws::RDS
623
631
  # **PostgreSQL**
624
632
  #
625
633
  # The name of the database to create when the DB instance is created. If
626
- # this parameter isn't specified, no database is created in the DB
627
- # instance.
634
+ # this parameter isn't specified, a database named `postgres` is
635
+ # created in the DB instance.
628
636
  #
629
637
  # Constraints:
630
638
  #
@@ -653,17 +661,34 @@ module Aws::RDS
653
661
  #
654
662
  # Not applicable. Must be null.
655
663
  #
656
- # **Amazon Aurora**
664
+ # **Amazon Aurora MySQL**
657
665
  #
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.
666
+ # The name of the database to create when the primary DB instance of the
667
+ # Aurora MySQL DB cluster is created. If this parameter isn't specified
668
+ # for an Aurora MySQL DB cluster, no database is created in the DB
669
+ # cluster.
661
670
  #
662
671
  # Constraints:
663
672
  #
664
- # * Must contain 1 to 64 letters or numbers.
673
+ # * It must contain 1 to 64 alphanumeric characters.
665
674
  #
666
- # * Can't be a word reserved by the specified database engine
675
+ # * It can't be a word reserved by the database engine.
676
+ #
677
+ # **Amazon Aurora PostgreSQL**
678
+ #
679
+ # The name of the database to create when the primary DB instance of the
680
+ # Aurora PostgreSQL DB cluster is created. If this parameter isn't
681
+ # specified for an Aurora PostgreSQL DB cluster, a database named
682
+ # `postgres` is created in the DB cluster.
683
+ #
684
+ # Constraints:
685
+ #
686
+ # * It must contain 1 to 63 alphanumeric characters.
687
+ #
688
+ # * It must begin with a letter or an underscore. Subsequent characters
689
+ # can be letters, underscores, or digits (0 to 9).
690
+ #
691
+ # * It can't be a word reserved by the database engine.
667
692
  # @option options [required, String] :db_instance_identifier
668
693
  # The DB instance identifier. This parameter is stored as a lowercase
669
694
  # string.
@@ -935,8 +960,8 @@ module Aws::RDS
935
960
  # specify the identifier of the custom Availability Zone to create the
936
961
  # DB instance in.
937
962
  #
938
- # For more information about RDS on VMware, see the [ *RDS on VMware
939
- # User Guide.* ][2]
963
+ # For more information about RDS on VMware, see the [ RDS on VMware User
964
+ # Guide.][2]
940
965
  #
941
966
  # </note>
942
967
  #
@@ -1112,8 +1137,8 @@ module Aws::RDS
1112
1137
  #
1113
1138
  # **PostgreSQL**
1114
1139
  #
1115
- # See [Supported PostgreSQL Database Versions][5] in the *Amazon RDS
1116
- # User Guide.*
1140
+ # See [Amazon RDS for PostgreSQL versions and extensions][5] in the
1141
+ # *Amazon RDS User Guide.*
1117
1142
  #
1118
1143
  #
1119
1144
  #
@@ -1121,7 +1146,7 @@ module Aws::RDS
1121
1146
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
1122
1147
  # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
1123
1148
  # [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
1149
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
1125
1150
  # @option options [Boolean] :auto_minor_version_upgrade
1126
1151
  # A value that indicates whether minor engine upgrades are applied
1127
1152
  # automatically to the DB instance during the maintenance window. By
@@ -1146,8 +1171,8 @@ module Aws::RDS
1146
1171
  #
1147
1172
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
1148
1173
  # @option options [String] :option_group_name
1149
- # Indicates that the DB instance should be associated with the specified
1150
- # option group.
1174
+ # A value that indicates that the DB instance should be associated with
1175
+ # the specified option group.
1151
1176
  #
1152
1177
  # Permanent options, such as the TDE option for Oracle Advanced Security
1153
1178
  # TDE, can't be removed from an option group. Also, that option group
@@ -1367,7 +1392,8 @@ module Aws::RDS
1367
1392
  #
1368
1393
  # **Oracle**
1369
1394
  #
1370
- # Possible values are `alert`, `audit`, `listener`, and `trace`.
1395
+ # Possible values are `alert`, `audit`, `listener`, `trace`, and
1396
+ # `oemagent`.
1371
1397
  #
1372
1398
  # **PostgreSQL**
1373
1399
  #
@@ -1398,6 +1424,33 @@ module Aws::RDS
1398
1424
  # @option options [Integer] :max_allocated_storage
1399
1425
  # The upper limit to which Amazon RDS can automatically scale the
1400
1426
  # storage of the DB instance.
1427
+ #
1428
+ # For more information about this setting, including limitations that
1429
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
1430
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
1431
+ #
1432
+ #
1433
+ #
1434
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
1435
+ # @option options [Boolean] :enable_customer_owned_ip
1436
+ # A value that indicates whether to enable a customer-owned IP address
1437
+ # (CoIP) for an RDS on Outposts DB instance.
1438
+ #
1439
+ # A *CoIP* provides local or external connectivity to resources in your
1440
+ # Outpost subnets through your on-premises network. For some use cases,
1441
+ # a CoIP can provide lower latency for connections to the DB instance
1442
+ # from outside of its virtual private cloud (VPC) on your local network.
1443
+ #
1444
+ # For more information about RDS on Outposts, see [Working with Amazon
1445
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
1446
+ #
1447
+ # For more information about CoIPs, see [Customer-owned IP addresses][2]
1448
+ # in the *AWS Outposts User Guide*.
1449
+ #
1450
+ #
1451
+ #
1452
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
1453
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
1401
1454
  # @return [DBInstance]
1402
1455
  def create_db_instance(options = {})
1403
1456
  resp = @client.create_db_instance(options)
@@ -1667,6 +1720,30 @@ module Aws::RDS
1667
1720
  # @option options [required, String] :engine_name
1668
1721
  # Specifies the name of the engine that this option group should be
1669
1722
  # associated with.
1723
+ #
1724
+ # Valid Values:
1725
+ #
1726
+ # * `mariadb`
1727
+ #
1728
+ # * `mysql`
1729
+ #
1730
+ # * `oracle-ee`
1731
+ #
1732
+ # * `oracle-se2`
1733
+ #
1734
+ # * `oracle-se1`
1735
+ #
1736
+ # * `oracle-se`
1737
+ #
1738
+ # * `postgres`
1739
+ #
1740
+ # * `sqlserver-ee`
1741
+ #
1742
+ # * `sqlserver-se`
1743
+ #
1744
+ # * `sqlserver-ex`
1745
+ #
1746
+ # * `sqlserver-web`
1670
1747
  # @option options [required, String] :major_engine_version
1671
1748
  # Specifies the major version of the engine that this option group
1672
1749
  # should be associated with.
@@ -1915,6 +1992,36 @@ module Aws::RDS
1915
1992
  # @param [Hash] options ({})
1916
1993
  # @option options [String] :engine
1917
1994
  # The database engine to return.
1995
+ #
1996
+ # Valid Values:
1997
+ #
1998
+ # * `aurora` (for MySQL 5.6-compatible Aurora)
1999
+ #
2000
+ # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
2001
+ #
2002
+ # * `aurora-postgresql`
2003
+ #
2004
+ # * `mariadb`
2005
+ #
2006
+ # * `mysql`
2007
+ #
2008
+ # * `oracle-ee`
2009
+ #
2010
+ # * `oracle-se2`
2011
+ #
2012
+ # * `oracle-se1`
2013
+ #
2014
+ # * `oracle-se`
2015
+ #
2016
+ # * `postgres`
2017
+ #
2018
+ # * `sqlserver-ee`
2019
+ #
2020
+ # * `sqlserver-se`
2021
+ #
2022
+ # * `sqlserver-ex`
2023
+ #
2024
+ # * `sqlserver-web`
1918
2025
  # @option options [String] :engine_version
1919
2026
  # The database engine version to return.
1920
2027
  #
@@ -2541,6 +2648,30 @@ module Aws::RDS
2541
2648
  # @option options [String] :engine_name
2542
2649
  # Filters the list of option groups to only include groups associated
2543
2650
  # with a specific database engine.
2651
+ #
2652
+ # Valid Values:
2653
+ #
2654
+ # * `mariadb`
2655
+ #
2656
+ # * `mysql`
2657
+ #
2658
+ # * `oracle-ee`
2659
+ #
2660
+ # * `oracle-se2`
2661
+ #
2662
+ # * `oracle-se1`
2663
+ #
2664
+ # * `oracle-se`
2665
+ #
2666
+ # * `postgres`
2667
+ #
2668
+ # * `sqlserver-ee`
2669
+ #
2670
+ # * `sqlserver-se`
2671
+ #
2672
+ # * `sqlserver-ex`
2673
+ #
2674
+ # * `sqlserver-web`
2544
2675
  # @option options [String] :major_engine_version
2545
2676
  # Filters the list of option groups to only include groups associated
2546
2677
  # with a specific database engine version. If specified, then EngineName
@@ -766,7 +766,7 @@ module Aws::RDS
766
766
  # @return [Types::PendingCloudwatchLogsExports]
767
767
  #
768
768
  # @!attribute [rw] db_cluster_identifier
769
- # The DBClusterIdentifier for the DB cluster.
769
+ # The DBClusterIdentifier value for the DB cluster.
770
770
  # @return [String]
771
771
  #
772
772
  # @!attribute [rw] master_user_password
@@ -774,8 +774,8 @@ module Aws::RDS
774
774
  # @return [String]
775
775
  #
776
776
  # @!attribute [rw] iam_database_authentication_enabled
777
- # Whether mapping of AWS Identity and Access Management (IAM) accounts
778
- # to database accounts is enabled.
777
+ # A value that indicates whether mapping of AWS Identity and Access
778
+ # Management (IAM) accounts to database accounts is enabled.
779
779
  # @return [Boolean]
780
780
  #
781
781
  # @!attribute [rw] engine_version
@@ -960,14 +960,7 @@ module Aws::RDS
960
960
  #
961
961
  # * Must specify a valid DB cluster parameter group.
962
962
  #
963
- # * If the source DB cluster parameter group is in the same AWS Region
964
- # as the copy, specify a valid DB parameter group identifier, for
965
- # example `my-db-cluster-param-group`, or a valid ARN.
966
- #
967
- # * If the source DB parameter group is in a different AWS Region than
968
- # the copy, specify a valid DB cluster parameter group ARN, for
969
- # example
970
- # `arn:aws:rds:us-east-1:123456789012:cluster-pg:custom-cluster-group1`.
963
+ # ^
971
964
  #
972
965
  #
973
966
  #
@@ -1237,8 +1230,7 @@ module Aws::RDS
1237
1230
  #
1238
1231
  # * Must specify a valid DB parameter group.
1239
1232
  #
1240
- # * Must specify a valid DB parameter group identifier, for example
1241
- # `my-db-param-group`, or a valid ARN.
1233
+ # ^
1242
1234
  #
1243
1235
  #
1244
1236
  #
@@ -1473,7 +1465,7 @@ module Aws::RDS
1473
1465
  # group. If your source DB instance uses Transparent Data Encryption
1474
1466
  # for Oracle or Microsoft SQL Server, you must specify this option
1475
1467
  # when copying across AWS Regions. For more information, see [Option
1476
- # Group Considerations][1] in the *Amazon RDS User Guide.*
1468
+ # group considerations][1] in the *Amazon RDS User Guide.*
1477
1469
  #
1478
1470
  #
1479
1471
  #
@@ -1647,8 +1639,8 @@ module Aws::RDS
1647
1639
  # A custom Availability Zone (AZ) is an on-premises AZ that is
1648
1640
  # integrated with a VMware vSphere cluster.
1649
1641
  #
1650
- # For more information about RDS on VMware, see the [ *RDS on VMware
1651
- # User Guide.* ][1]
1642
+ # For more information about RDS on VMware, see the [ RDS on VMware
1643
+ # User Guide.][1]
1652
1644
  #
1653
1645
  #
1654
1646
  #
@@ -2109,7 +2101,7 @@ module Aws::RDS
2109
2101
  # @return [Array<String>]
2110
2102
  #
2111
2103
  # @!attribute [rw] engine_mode
2112
- # The DB engine mode of the DB cluster, either `provisioned`
2104
+ # The DB engine mode of the DB cluster, either `provisioned`,
2113
2105
  # `serverless`, `parallelquery`, `global`, or `multimaster`.
2114
2106
  #
2115
2107
  # The `parallelquery` engine mode isn't required for Aurora MySQL
@@ -2205,12 +2197,19 @@ module Aws::RDS
2205
2197
  # @return [String]
2206
2198
  #
2207
2199
  # @!attribute [rw] enable_global_write_forwarding
2208
- # A value that indicates whether to enable write operations to be
2209
- # forwarded from this cluster to the primary cluster in an Aurora
2210
- # global database. The resulting changes are replicated back to this
2211
- # cluster. This parameter only applies to DB clusters that are
2212
- # secondary clusters in an Aurora global database. By default, Aurora
2213
- # disallows write operations for secondary clusters.
2200
+ # A value that indicates whether to enable this DB cluster to forward
2201
+ # write operations to the primary cluster of an Aurora global database
2202
+ # (GlobalCluster). By default, write operations are not allowed on
2203
+ # Aurora DB clusters that are secondary clusters in an Aurora global
2204
+ # database.
2205
+ #
2206
+ # You can set this value only on Aurora DB clusters that are members
2207
+ # of an Aurora global database. With this parameter enabled, a
2208
+ # secondary cluster can forward writes to the current primary cluster
2209
+ # and the resulting changes are replicated back to this cluster. For
2210
+ # the primary DB cluster of an Aurora global database, this value is
2211
+ # used immediately if the primary is demoted by the
2212
+ # FailoverGlobalCluster API operation, but it does nothing until then.
2214
2213
  # @return [Boolean]
2215
2214
  #
2216
2215
  # @!attribute [rw] source_region
@@ -2485,6 +2484,7 @@ module Aws::RDS
2485
2484
  # ],
2486
2485
  # deletion_protection: false,
2487
2486
  # max_allocated_storage: 1,
2487
+ # enable_customer_owned_ip: false,
2488
2488
  # }
2489
2489
  #
2490
2490
  # @!attribute [rw] db_name
@@ -2524,8 +2524,8 @@ module Aws::RDS
2524
2524
  # **PostgreSQL**
2525
2525
  #
2526
2526
  # The name of the database to create when the DB instance is created.
2527
- # If this parameter isn't specified, no database is created in the DB
2528
- # instance.
2527
+ # If this parameter isn't specified, a database named `postgres` is
2528
+ # created in the DB instance.
2529
2529
  #
2530
2530
  # Constraints:
2531
2531
  #
@@ -2554,17 +2554,34 @@ module Aws::RDS
2554
2554
  #
2555
2555
  # Not applicable. Must be null.
2556
2556
  #
2557
- # **Amazon Aurora**
2557
+ # **Amazon Aurora MySQL**
2558
2558
  #
2559
- # The name of the database to create when the primary instance of the
2560
- # DB cluster is created. If this parameter isn't specified, no
2561
- # database is created in the DB instance.
2559
+ # The name of the database to create when the primary DB instance of
2560
+ # the Aurora MySQL DB cluster is created. If this parameter isn't
2561
+ # specified for an Aurora MySQL DB cluster, no database is created in
2562
+ # the DB cluster.
2562
2563
  #
2563
2564
  # Constraints:
2564
2565
  #
2565
- # * Must contain 1 to 64 letters or numbers.
2566
+ # * It must contain 1 to 64 alphanumeric characters.
2566
2567
  #
2567
- # * Can't be a word reserved by the specified database engine
2568
+ # * It can't be a word reserved by the database engine.
2569
+ #
2570
+ # **Amazon Aurora PostgreSQL**
2571
+ #
2572
+ # The name of the database to create when the primary DB instance of
2573
+ # the Aurora PostgreSQL DB cluster is created. If this parameter
2574
+ # isn't specified for an Aurora PostgreSQL DB cluster, a database
2575
+ # named `postgres` is created in the DB cluster.
2576
+ #
2577
+ # Constraints:
2578
+ #
2579
+ # * It must contain 1 to 63 alphanumeric characters.
2580
+ #
2581
+ # * It must begin with a letter or an underscore. Subsequent
2582
+ # characters can be letters, underscores, or digits (0 to 9).
2583
+ #
2584
+ # * It can't be a word reserved by the database engine.
2568
2585
  # @return [String]
2569
2586
  #
2570
2587
  # @!attribute [rw] db_instance_identifier
@@ -2855,8 +2872,8 @@ module Aws::RDS
2855
2872
  # specify the identifier of the custom Availability Zone to create the
2856
2873
  # DB instance in.
2857
2874
  #
2858
- # For more information about RDS on VMware, see the [ *RDS on VMware
2859
- # User Guide.* ][2]
2875
+ # For more information about RDS on VMware, see the [ RDS on VMware
2876
+ # User Guide.][2]
2860
2877
  #
2861
2878
  # </note>
2862
2879
  #
@@ -3049,8 +3066,8 @@ module Aws::RDS
3049
3066
  #
3050
3067
  # **PostgreSQL**
3051
3068
  #
3052
- # See [Supported PostgreSQL Database Versions][5] in the *Amazon RDS
3053
- # User Guide.*
3069
+ # See [Amazon RDS for PostgreSQL versions and extensions][5] in the
3070
+ # *Amazon RDS User Guide.*
3054
3071
  #
3055
3072
  #
3056
3073
  #
@@ -3058,7 +3075,7 @@ module Aws::RDS
3058
3075
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
3059
3076
  # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
3060
3077
  # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
3061
- # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts.General.DBVersions
3078
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
3062
3079
  # @return [String]
3063
3080
  #
3064
3081
  # @!attribute [rw] auto_minor_version_upgrade
@@ -3091,8 +3108,8 @@ module Aws::RDS
3091
3108
  # @return [Integer]
3092
3109
  #
3093
3110
  # @!attribute [rw] option_group_name
3094
- # Indicates that the DB instance should be associated with the
3095
- # specified option group.
3111
+ # A value that indicates that the DB instance should be associated
3112
+ # with the specified option group.
3096
3113
  #
3097
3114
  # Permanent options, such as the TDE option for Oracle Advanced
3098
3115
  # Security TDE, can't be removed from an option group. Also, that
@@ -3358,7 +3375,8 @@ module Aws::RDS
3358
3375
  #
3359
3376
  # **Oracle**
3360
3377
  #
3361
- # Possible values are `alert`, `audit`, `listener`, and `trace`.
3378
+ # Possible values are `alert`, `audit`, `listener`, `trace`, and
3379
+ # `oemagent`.
3362
3380
  #
3363
3381
  # **PostgreSQL**
3364
3382
  #
@@ -3395,8 +3413,38 @@ module Aws::RDS
3395
3413
  # @!attribute [rw] max_allocated_storage
3396
3414
  # The upper limit to which Amazon RDS can automatically scale the
3397
3415
  # storage of the DB instance.
3416
+ #
3417
+ # For more information about this setting, including limitations that
3418
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
3419
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
3420
+ #
3421
+ #
3422
+ #
3423
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
3398
3424
  # @return [Integer]
3399
3425
  #
3426
+ # @!attribute [rw] enable_customer_owned_ip
3427
+ # A value that indicates whether to enable a customer-owned IP address
3428
+ # (CoIP) for an RDS on Outposts DB instance.
3429
+ #
3430
+ # A *CoIP* provides local or external connectivity to resources in
3431
+ # your Outpost subnets through your on-premises network. For some use
3432
+ # cases, a CoIP can provide lower latency for connections to the DB
3433
+ # instance from outside of its virtual private cloud (VPC) on your
3434
+ # local network.
3435
+ #
3436
+ # For more information about RDS on Outposts, see [Working with Amazon
3437
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
3438
+ #
3439
+ # For more information about CoIPs, see [Customer-owned IP
3440
+ # addresses][2] in the *AWS Outposts User Guide*.
3441
+ #
3442
+ #
3443
+ #
3444
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
3445
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
3446
+ # @return [Boolean]
3447
+ #
3400
3448
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceMessage AWS API Documentation
3401
3449
  #
3402
3450
  class CreateDBInstanceMessage < Struct.new(
@@ -3446,7 +3494,8 @@ module Aws::RDS
3446
3494
  :enable_cloudwatch_logs_exports,
3447
3495
  :processor_features,
3448
3496
  :deletion_protection,
3449
- :max_allocated_storage)
3497
+ :max_allocated_storage,
3498
+ :enable_customer_owned_ip)
3450
3499
  SENSITIVE = []
3451
3500
  include Aws::Structure
3452
3501
  end
@@ -3947,6 +3996,14 @@ module Aws::RDS
3947
3996
  # @!attribute [rw] max_allocated_storage
3948
3997
  # The upper limit to which Amazon RDS can automatically scale the
3949
3998
  # storage of the DB instance.
3999
+ #
4000
+ # For more information about this setting, including limitations that
4001
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
4002
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
4003
+ #
4004
+ #
4005
+ #
4006
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
3950
4007
  # @return [Integer]
3951
4008
  #
3952
4009
  # @!attribute [rw] source_region
@@ -4656,6 +4713,30 @@ module Aws::RDS
4656
4713
  # @!attribute [rw] engine_name
4657
4714
  # Specifies the name of the engine that this option group should be
4658
4715
  # associated with.
4716
+ #
4717
+ # Valid Values:
4718
+ #
4719
+ # * `mariadb`
4720
+ #
4721
+ # * `mysql`
4722
+ #
4723
+ # * `oracle-ee`
4724
+ #
4725
+ # * `oracle-se2`
4726
+ #
4727
+ # * `oracle-se1`
4728
+ #
4729
+ # * `oracle-se`
4730
+ #
4731
+ # * `postgres`
4732
+ #
4733
+ # * `sqlserver-ee`
4734
+ #
4735
+ # * `sqlserver-se`
4736
+ #
4737
+ # * `sqlserver-ex`
4738
+ #
4739
+ # * `sqlserver-web`
4659
4740
  # @return [String]
4660
4741
  #
4661
4742
  # @!attribute [rw] major_engine_version
@@ -4697,8 +4778,8 @@ module Aws::RDS
4697
4778
  # A custom Availability Zone (AZ) is an on-premises AZ that is
4698
4779
  # integrated with a VMware vSphere cluster.
4699
4780
  #
4700
- # For more information about RDS on VMware, see the [ *RDS on VMware
4701
- # User Guide.* ][1]
4781
+ # For more information about RDS on VMware, see the [ RDS on VMware User
4782
+ # Guide.][1]
4702
4783
  #
4703
4784
  #
4704
4785
  #
@@ -5120,9 +5201,9 @@ module Aws::RDS
5120
5201
  # @return [Boolean]
5121
5202
  #
5122
5203
  # @!attribute [rw] pending_modified_values
5123
- # Specifies that changes to the DB cluster are pending. This element
5124
- # is only included when changes are pending. Specific changes are
5125
- # identified by subelements.
5204
+ # A value that specifies that changes to the DB cluster are pending.
5205
+ # This element is only included when changes are pending. Specific
5206
+ # changes are identified by subelements.
5126
5207
  # @return [Types::ClusterPendingModifiedValues]
5127
5208
  #
5128
5209
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBCluster AWS API Documentation
@@ -6176,9 +6257,9 @@ module Aws::RDS
6176
6257
  # @return [String]
6177
6258
  #
6178
6259
  # @!attribute [rw] pending_modified_values
6179
- # Specifies that changes to the DB instance are pending. This element
6180
- # is only included when changes are pending. Specific changes are
6181
- # identified by subelements.
6260
+ # A value that specifies that changes to the DB instance are pending.
6261
+ # This element is only included when changes are pending. Specific
6262
+ # changes are identified by subelements.
6182
6263
  # @return [Types::PendingModifiedValues]
6183
6264
  #
6184
6265
  # @!attribute [rw] latest_restorable_time
@@ -6195,7 +6276,8 @@ module Aws::RDS
6195
6276
  # @return [String]
6196
6277
  #
6197
6278
  # @!attribute [rw] auto_minor_version_upgrade
6198
- # Indicates that minor version patches are applied automatically.
6279
+ # A value that indicates that minor version patches are applied
6280
+ # automatically.
6199
6281
  # @return [Boolean]
6200
6282
  #
6201
6283
  # @!attribute [rw] read_replica_source_db_instance_identifier
@@ -6469,6 +6551,28 @@ module Aws::RDS
6469
6551
  # instance.
6470
6552
  # @return [Array<Types::DBInstanceAutomatedBackupsReplication>]
6471
6553
  #
6554
+ # @!attribute [rw] customer_owned_ip_enabled
6555
+ # Specifies whether a customer-owned IP address (CoIP) is enabled for
6556
+ # an RDS on Outposts DB instance.
6557
+ #
6558
+ # A <i>CoIP </i>provides local or external connectivity to resources
6559
+ # in your Outpost subnets through your on-premises network. For some
6560
+ # use cases, a CoIP can provide lower latency for connections to the
6561
+ # DB instance from outside of its virtual private cloud (VPC) on your
6562
+ # local network.
6563
+ #
6564
+ # For more information about RDS on Outposts, see [Working with Amazon
6565
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
6566
+ #
6567
+ # For more information about CoIPs, see [Customer-owned IP
6568
+ # addresses][2] in the *AWS Outposts User Guide*.
6569
+ #
6570
+ #
6571
+ #
6572
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
6573
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
6574
+ # @return [Boolean]
6575
+ #
6472
6576
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBInstance AWS API Documentation
6473
6577
  #
6474
6578
  class DBInstance < Struct.new(
@@ -6533,7 +6637,8 @@ module Aws::RDS
6533
6637
  :listener_endpoint,
6534
6638
  :max_allocated_storage,
6535
6639
  :tag_list,
6536
- :db_instance_automated_backups_replications)
6640
+ :db_instance_automated_backups_replications,
6641
+ :customer_owned_ip_enabled)
6537
6642
  SENSITIVE = []
6538
6643
  include Aws::Structure
6539
6644
  end
@@ -7836,8 +7941,8 @@ module Aws::RDS
7836
7941
  # A custom Availability Zone (AZ) is an on-premises AZ that is
7837
7942
  # integrated with a VMware vSphere cluster.
7838
7943
  #
7839
- # For more information about RDS on VMware, see the [ *RDS on VMware
7840
- # User Guide.* ][1]
7944
+ # For more information about RDS on VMware, see the [ RDS on VMware
7945
+ # User Guide.][1]
7841
7946
  #
7842
7947
  #
7843
7948
  #
@@ -9162,6 +9267,36 @@ module Aws::RDS
9162
9267
  #
9163
9268
  # @!attribute [rw] engine
9164
9269
  # The database engine to return.
9270
+ #
9271
+ # Valid Values:
9272
+ #
9273
+ # * `aurora` (for MySQL 5.6-compatible Aurora)
9274
+ #
9275
+ # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
9276
+ #
9277
+ # * `aurora-postgresql`
9278
+ #
9279
+ # * `mariadb`
9280
+ #
9281
+ # * `mysql`
9282
+ #
9283
+ # * `oracle-ee`
9284
+ #
9285
+ # * `oracle-se2`
9286
+ #
9287
+ # * `oracle-se1`
9288
+ #
9289
+ # * `oracle-se`
9290
+ #
9291
+ # * `postgres`
9292
+ #
9293
+ # * `sqlserver-ee`
9294
+ #
9295
+ # * `sqlserver-se`
9296
+ #
9297
+ # * `sqlserver-ex`
9298
+ #
9299
+ # * `sqlserver-web`
9165
9300
  # @return [String]
9166
9301
  #
9167
9302
  # @!attribute [rw] engine_version
@@ -9289,20 +9424,19 @@ module Aws::RDS
9289
9424
  #
9290
9425
  # * `active` - automated backups for current instances
9291
9426
  #
9292
- # * `retained` - automated backups for deleted instances
9427
+ # * `retained` - automated backups for deleted instances and after
9428
+ # backup replication is stopped
9293
9429
  #
9294
9430
  # * `creating` - automated backups that are waiting for the first
9295
9431
  # automated snapshot to be available
9296
9432
  #
9297
9433
  # * `db-instance-id` - Accepts DB instance identifiers and Amazon
9298
- # Resource Names (ARNs) for DB instances. The results list includes
9299
- # only information about the DB instance automated backupss
9300
- # identified by these ARNs.
9434
+ # Resource Names (ARNs). The results list includes only information
9435
+ # about the DB instance automated backups identified by these ARNs.
9301
9436
  #
9302
- # * `dbi-resource-id` - Accepts DB instance resource identifiers and
9303
- # DB Amazon Resource Names (ARNs) for DB instances. The results list
9304
- # includes only information about the DB instance resources
9305
- # identified by these ARNs.
9437
+ # * `dbi-resource-id` - Accepts DB resource identifiers and Amazon
9438
+ # Resource Names (ARNs). The results list includes only information
9439
+ # about the DB instance resources identified by these ARNs.
9306
9440
  #
9307
9441
  # Returns all resources by default. The status for each resource is
9308
9442
  # specified in the response.
@@ -10761,6 +10895,30 @@ module Aws::RDS
10761
10895
  # @!attribute [rw] engine_name
10762
10896
  # A required parameter. Options available for the given engine name
10763
10897
  # are described.
10898
+ #
10899
+ # Valid Values:
10900
+ #
10901
+ # * `mariadb`
10902
+ #
10903
+ # * `mysql`
10904
+ #
10905
+ # * `oracle-ee`
10906
+ #
10907
+ # * `oracle-se2`
10908
+ #
10909
+ # * `oracle-se1`
10910
+ #
10911
+ # * `oracle-se`
10912
+ #
10913
+ # * `postgres`
10914
+ #
10915
+ # * `sqlserver-ee`
10916
+ #
10917
+ # * `sqlserver-se`
10918
+ #
10919
+ # * `sqlserver-ex`
10920
+ #
10921
+ # * `sqlserver-web`
10764
10922
  # @return [String]
10765
10923
  #
10766
10924
  # @!attribute [rw] major_engine_version
@@ -10848,6 +11006,30 @@ module Aws::RDS
10848
11006
  # @!attribute [rw] engine_name
10849
11007
  # Filters the list of option groups to only include groups associated
10850
11008
  # with a specific database engine.
11009
+ #
11010
+ # Valid Values:
11011
+ #
11012
+ # * `mariadb`
11013
+ #
11014
+ # * `mysql`
11015
+ #
11016
+ # * `oracle-ee`
11017
+ #
11018
+ # * `oracle-se2`
11019
+ #
11020
+ # * `oracle-se1`
11021
+ #
11022
+ # * `oracle-se`
11023
+ #
11024
+ # * `postgres`
11025
+ #
11026
+ # * `sqlserver-ee`
11027
+ #
11028
+ # * `sqlserver-se`
11029
+ #
11030
+ # * `sqlserver-ex`
11031
+ #
11032
+ # * `sqlserver-web`
10851
11033
  # @return [String]
10852
11034
  #
10853
11035
  # @!attribute [rw] major_engine_version
@@ -10891,6 +11073,36 @@ module Aws::RDS
10891
11073
  #
10892
11074
  # @!attribute [rw] engine
10893
11075
  # The name of the engine to retrieve DB instance options for.
11076
+ #
11077
+ # Valid Values:
11078
+ #
11079
+ # * `aurora` (for MySQL 5.6-compatible Aurora)
11080
+ #
11081
+ # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
11082
+ #
11083
+ # * `aurora-postgresql`
11084
+ #
11085
+ # * `mariadb`
11086
+ #
11087
+ # * `mysql`
11088
+ #
11089
+ # * `oracle-ee`
11090
+ #
11091
+ # * `oracle-se2`
11092
+ #
11093
+ # * `oracle-se1`
11094
+ #
11095
+ # * `oracle-se`
11096
+ #
11097
+ # * `postgres`
11098
+ #
11099
+ # * `sqlserver-ee`
11100
+ #
11101
+ # * `sqlserver-se`
11102
+ #
11103
+ # * `sqlserver-ex`
11104
+ #
11105
+ # * `sqlserver-web`
10894
11106
  # @return [String]
10895
11107
  #
10896
11108
  # @!attribute [rw] engine_version
@@ -11973,6 +12185,103 @@ module Aws::RDS
11973
12185
  include Aws::Structure
11974
12186
  end
11975
12187
 
12188
+ # @note When making an API call, you may pass FailoverGlobalClusterMessage
12189
+ # data as a hash:
12190
+ #
12191
+ # {
12192
+ # global_cluster_identifier: "GlobalClusterIdentifier", # required
12193
+ # target_db_cluster_identifier: "DBClusterIdentifier", # required
12194
+ # }
12195
+ #
12196
+ # @!attribute [rw] global_cluster_identifier
12197
+ # Identifier of the Aurora global database (GlobalCluster) that should
12198
+ # be failed over. The identifier is the unique key assigned by the
12199
+ # user when the Aurora global database was created. In other words,
12200
+ # it's the name of the Aurora global database that you want to fail
12201
+ # over.
12202
+ #
12203
+ # Constraints:
12204
+ #
12205
+ # * Must match the identifier of an existing GlobalCluster (Aurora
12206
+ # global database).
12207
+ #
12208
+ # ^
12209
+ # @return [String]
12210
+ #
12211
+ # @!attribute [rw] target_db_cluster_identifier
12212
+ # Identifier of the secondary Aurora DB cluster that you want to
12213
+ # promote to primary for the Aurora global database (GlobalCluster.)
12214
+ # Use the Amazon Resource Name (ARN) for the identifier so that Aurora
12215
+ # can locate the cluster in its AWS Region.
12216
+ # @return [String]
12217
+ #
12218
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/FailoverGlobalClusterMessage AWS API Documentation
12219
+ #
12220
+ class FailoverGlobalClusterMessage < Struct.new(
12221
+ :global_cluster_identifier,
12222
+ :target_db_cluster_identifier)
12223
+ SENSITIVE = []
12224
+ include Aws::Structure
12225
+ end
12226
+
12227
+ # @!attribute [rw] global_cluster
12228
+ # A data type representing an Aurora global database.
12229
+ # @return [Types::GlobalCluster]
12230
+ #
12231
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/FailoverGlobalClusterResult AWS API Documentation
12232
+ #
12233
+ class FailoverGlobalClusterResult < Struct.new(
12234
+ :global_cluster)
12235
+ SENSITIVE = []
12236
+ include Aws::Structure
12237
+ end
12238
+
12239
+ # Contains the state of scheduled or in-process failover operations on
12240
+ # an Aurora global database (GlobalCluster). This Data type is empty
12241
+ # unless a failover operation is scheduled or is currently underway on
12242
+ # the Aurora global database.
12243
+ #
12244
+ # @!attribute [rw] status
12245
+ # The current status of the Aurora global database (GlobalCluster).
12246
+ # Possible values are as follows:
12247
+ #
12248
+ # * pending – A request to fail over the Aurora global database
12249
+ # (GlobalCluster) has been received by the service. The
12250
+ # `GlobalCluster`'s primary DB cluster and the specified secondary
12251
+ # DB cluster are being verified before the failover process can
12252
+ # start.
12253
+ #
12254
+ # * failing-over – This status covers the range of Aurora internal
12255
+ # operations that take place during the failover process, such as
12256
+ # demoting the primary Aurora DB cluster, promoting the secondary
12257
+ # Aurora DB, and synchronizing replicas.
12258
+ #
12259
+ # * cancelling – The request to fail over the Aurora global database
12260
+ # (GlobalCluster) was cancelled and the primary Aurora DB cluster
12261
+ # and the selected secondary Aurora DB cluster are returning to
12262
+ # their previous states.
12263
+ # @return [String]
12264
+ #
12265
+ # @!attribute [rw] from_db_cluster_arn
12266
+ # The Amazon Resource Name (ARN) of the Aurora DB cluster that is
12267
+ # currently being demoted, and which is associated with this state.
12268
+ # @return [String]
12269
+ #
12270
+ # @!attribute [rw] to_db_cluster_arn
12271
+ # The Amazon Resource Name (ARN) of the Aurora DB cluster that is
12272
+ # currently being promoted, and which is associated with this state.
12273
+ # @return [String]
12274
+ #
12275
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/FailoverState AWS API Documentation
12276
+ #
12277
+ class FailoverState < Struct.new(
12278
+ :status,
12279
+ :from_db_cluster_arn,
12280
+ :to_db_cluster_arn)
12281
+ SENSITIVE = []
12282
+ include Aws::Structure
12283
+ end
12284
+
11976
12285
  # A filter name and value pair that is used to return a more specific
11977
12286
  # list of results from a describe operation. Filters can be used to
11978
12287
  # match a set of resources by specific criteria, such as IDs. The
@@ -12068,6 +12377,14 @@ module Aws::RDS
12068
12377
  # database cluster. Currently limited to 1 item.
12069
12378
  # @return [Array<Types::GlobalClusterMember>]
12070
12379
  #
12380
+ # @!attribute [rw] failover_state
12381
+ # A data object containing all properties for the current state of an
12382
+ # in-process or pending failover process for this Aurora global
12383
+ # database. This object is empty unless the FailoverGlobalCluster API
12384
+ # operation has been called on this Aurora global database
12385
+ # (GlobalCluster).
12386
+ # @return [Types::FailoverState]
12387
+ #
12071
12388
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/GlobalCluster AWS API Documentation
12072
12389
  #
12073
12390
  class GlobalCluster < Struct.new(
@@ -12080,7 +12397,8 @@ module Aws::RDS
12080
12397
  :database_name,
12081
12398
  :storage_encrypted,
12082
12399
  :deletion_protection,
12083
- :global_cluster_members)
12400
+ :global_cluster_members,
12401
+ :failover_state)
12084
12402
  SENSITIVE = []
12085
12403
  include Aws::Structure
12086
12404
  end
@@ -13108,12 +13426,19 @@ module Aws::RDS
13108
13426
  # @return [Boolean]
13109
13427
  #
13110
13428
  # @!attribute [rw] enable_global_write_forwarding
13111
- # A value that indicates whether to enable write operations to be
13112
- # forwarded from this cluster to the primary cluster in an Aurora
13113
- # global database. The resulting changes are replicated back to this
13114
- # cluster. This parameter only applies to DB clusters that are
13115
- # secondary clusters in an Aurora global database. By default, Aurora
13116
- # disallows write operations for secondary clusters.
13429
+ # A value that indicates whether to enable this DB cluster to forward
13430
+ # write operations to the primary cluster of an Aurora global database
13431
+ # (GlobalCluster). By default, write operations are not allowed on
13432
+ # Aurora DB clusters that are secondary clusters in an Aurora global
13433
+ # database.
13434
+ #
13435
+ # You can set this value only on Aurora DB clusters that are members
13436
+ # of an Aurora global database. With this parameter enabled, a
13437
+ # secondary cluster can forward writes to the current primary cluster
13438
+ # and the resulting changes are replicated back to this cluster. For
13439
+ # the primary DB cluster of an Aurora global database, this value is
13440
+ # used immediately if the primary is demoted by the
13441
+ # FailoverGlobalCluster API operation, but it does nothing until then.
13117
13442
  # @return [Boolean]
13118
13443
  #
13119
13444
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBClusterMessage AWS API Documentation
@@ -13337,6 +13662,7 @@ module Aws::RDS
13337
13662
  # max_allocated_storage: 1,
13338
13663
  # certificate_rotation_restart: false,
13339
13664
  # replica_mode: "open-read-only", # accepts open-read-only, mounted
13665
+ # enable_customer_owned_ip: false,
13340
13666
  # }
13341
13667
  #
13342
13668
  # @!attribute [rw] db_instance_identifier
@@ -13385,8 +13711,8 @@ module Aws::RDS
13385
13711
  # The new DB subnet group for the DB instance. You can use this
13386
13712
  # parameter to move your DB instance to a different VPC. If your DB
13387
13713
  # instance isn't in a VPC, you can also use this parameter to move
13388
- # your DB instance into a VPC. For more information, see [Updating the
13389
- # VPC for a DB Instance][1] in the *Amazon RDS User Guide.*
13714
+ # your DB instance into a VPC. For more information, see [Working with
13715
+ # a DB instance in a VPC][1] in the *Amazon RDS User Guide.*
13390
13716
  #
13391
13717
  # Changing the subnet group causes an outage during the change. The
13392
13718
  # change is applied during the next maintenance window, unless you
@@ -13399,7 +13725,7 @@ module Aws::RDS
13399
13725
  #
13400
13726
  #
13401
13727
  #
13402
- # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.Non-VPC2VPC
13728
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html#USER_VPC.Non-VPC2VPC
13403
13729
  # @return [String]
13404
13730
  #
13405
13731
  # @!attribute [rw] db_security_groups
@@ -13607,8 +13933,10 @@ module Aws::RDS
13607
13933
  # parameter group can be the default for that DB parameter group
13608
13934
  # family.
13609
13935
  #
13610
- # For information about valid engine versions, see `CreateDBInstance`,
13611
- # or call `DescribeDBEngineVersions`.
13936
+ # If you specify only a major version, Amazon RDS will update the DB
13937
+ # instance to the default minor version if the current minor version
13938
+ # is lower. For information about valid engine versions, see
13939
+ # `CreateDBInstance`, or call `DescribeDBEngineVersions`.
13612
13940
  # @return [String]
13613
13941
  #
13614
13942
  # @!attribute [rw] allow_major_version_upgrade
@@ -13674,7 +14002,7 @@ module Aws::RDS
13674
14002
  # @return [Integer]
13675
14003
  #
13676
14004
  # @!attribute [rw] option_group_name
13677
- # Indicates that the DB instance should be associated with the
14005
+ # A value that indicates the DB instance should be associated with the
13678
14006
  # specified option group. Changing this parameter doesn't result in
13679
14007
  # an outage except in the following case and the change is applied
13680
14008
  # during the next maintenance window unless the `ApplyImmediately`
@@ -13975,6 +14303,14 @@ module Aws::RDS
13975
14303
  # @!attribute [rw] max_allocated_storage
13976
14304
  # The upper limit to which Amazon RDS can automatically scale the
13977
14305
  # storage of the DB instance.
14306
+ #
14307
+ # For more information about this setting, including limitations that
14308
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
14309
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
14310
+ #
14311
+ #
14312
+ #
14313
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
13978
14314
  # @return [Integer]
13979
14315
  #
13980
14316
  # @!attribute [rw] certificate_rotation_restart
@@ -14027,6 +14363,28 @@ module Aws::RDS
14027
14363
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
14028
14364
  # @return [String]
14029
14365
  #
14366
+ # @!attribute [rw] enable_customer_owned_ip
14367
+ # A value that indicates whether to enable a customer-owned IP address
14368
+ # (CoIP) for an RDS on Outposts DB instance.
14369
+ #
14370
+ # A *CoIP* provides local or external connectivity to resources in
14371
+ # your Outpost subnets through your on-premises network. For some use
14372
+ # cases, a CoIP can provide lower latency for connections to the DB
14373
+ # instance from outside of its virtual private cloud (VPC) on your
14374
+ # local network.
14375
+ #
14376
+ # For more information about RDS on Outposts, see [Working with Amazon
14377
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
14378
+ #
14379
+ # For more information about CoIPs, see [Customer-owned IP
14380
+ # addresses][2] in the *AWS Outposts User Guide*.
14381
+ #
14382
+ #
14383
+ #
14384
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
14385
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
14386
+ # @return [Boolean]
14387
+ #
14030
14388
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstanceMessage AWS API Documentation
14031
14389
  #
14032
14390
  class ModifyDBInstanceMessage < Struct.new(
@@ -14072,7 +14430,8 @@ module Aws::RDS
14072
14430
  :deletion_protection,
14073
14431
  :max_allocated_storage,
14074
14432
  :certificate_rotation_restart,
14075
- :replica_mode)
14433
+ :replica_mode,
14434
+ :enable_customer_owned_ip)
14076
14435
  SENSITIVE = []
14077
14436
  include Aws::Structure
14078
14437
  end
@@ -14434,11 +14793,11 @@ module Aws::RDS
14434
14793
  # You can specify this parameter when you upgrade an Oracle DB
14435
14794
  # snapshot. The same option group considerations apply when upgrading
14436
14795
  # a DB snapshot as when upgrading a DB instance. For more information,
14437
- # see [Option Group Considerations][1] in the *Amazon RDS User Guide.*
14796
+ # see [Option group considerations][1] in the *Amazon RDS User Guide.*
14438
14797
  #
14439
14798
  #
14440
14799
  #
14441
- # [1]: http://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Oracle.html#USER_UpgradeDBInstance.Oracle.OGPG.OG
14800
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Oracle.html#USER_UpgradeDBInstance.Oracle.OGPG.OG
14442
14801
  # @return [String]
14443
14802
  #
14444
14803
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSnapshotMessage AWS API Documentation
@@ -14596,6 +14955,8 @@ module Aws::RDS
14596
14955
  # global_cluster_identifier: "String",
14597
14956
  # new_global_cluster_identifier: "String",
14598
14957
  # deletion_protection: false,
14958
+ # engine_version: "String",
14959
+ # allow_major_version_upgrade: false,
14599
14960
  # }
14600
14961
  #
14601
14962
  # @!attribute [rw] global_cluster_identifier
@@ -14631,12 +14992,53 @@ module Aws::RDS
14631
14992
  # protection is enabled.
14632
14993
  # @return [Boolean]
14633
14994
  #
14995
+ # @!attribute [rw] engine_version
14996
+ # The version number of the database engine to which you want to
14997
+ # upgrade. Changing this parameter results in an outage. The change is
14998
+ # applied during the next maintenance window unless `ApplyImmediately`
14999
+ # is enabled.
15000
+ #
15001
+ # To list all of the available engine versions for `aurora` (for MySQL
15002
+ # 5.6-compatible Aurora), use the following command:
15003
+ #
15004
+ # `` aws rds describe-db-engine-versions --engine aurora --query
15005
+ # '*[]|[?SupportsGlobalDatabases == `true`].[EngineVersion]' ``
15006
+ #
15007
+ # To list all of the available engine versions for `aurora-mysql` (for
15008
+ # MySQL 5.7-compatible Aurora), use the following command:
15009
+ #
15010
+ # `` aws rds describe-db-engine-versions --engine aurora-mysql --query
15011
+ # '*[]|[?SupportsGlobalDatabases == `true`].[EngineVersion]' ``
15012
+ #
15013
+ # To list all of the available engine versions for
15014
+ # `aurora-postgresql`, use the following command:
15015
+ #
15016
+ # `` aws rds describe-db-engine-versions --engine aurora-postgresql
15017
+ # --query '*[]|[?SupportsGlobalDatabases == `true`].[EngineVersion]'
15018
+ # ``
15019
+ # @return [String]
15020
+ #
15021
+ # @!attribute [rw] allow_major_version_upgrade
15022
+ # A value that indicates whether major version upgrades are allowed.
15023
+ #
15024
+ # Constraints: You must allow major version upgrades when specifying a
15025
+ # value for the `EngineVersion` parameter that is a different major
15026
+ # version than the DB cluster's current version.
15027
+ #
15028
+ # If you upgrade the major version of a global database, the cluster
15029
+ # and DB instance parameter groups are set to the default parameter
15030
+ # groups for the new version. Apply any custom parameter groups after
15031
+ # completing the upgrade.
15032
+ # @return [Boolean]
15033
+ #
14634
15034
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyGlobalClusterMessage AWS API Documentation
14635
15035
  #
14636
15036
  class ModifyGlobalClusterMessage < Struct.new(
14637
15037
  :global_cluster_identifier,
14638
15038
  :new_global_cluster_identifier,
14639
- :deletion_protection)
15039
+ :deletion_protection,
15040
+ :engine_version,
15041
+ :allow_major_version_upgrade)
14640
15042
  SENSITIVE = []
14641
15043
  include Aws::Structure
14642
15044
  end
@@ -15634,7 +16036,7 @@ module Aws::RDS
15634
16036
  end
15635
16037
 
15636
16038
  # This data type is used as a response element in the `ModifyDBInstance`
15637
- # action and contains changes that will be applied during the next
16039
+ # operation and contains changes that will be applied during the next
15638
16040
  # maintenance window.
15639
16041
  #
15640
16042
  # @!attribute [rw] db_instance_class
@@ -15660,8 +16062,8 @@ module Aws::RDS
15660
16062
  # @return [Integer]
15661
16063
  #
15662
16064
  # @!attribute [rw] multi_az
15663
- # Indicates that the Single-AZ DB instance will change to a Multi-AZ
15664
- # deployment.
16065
+ # A value that indicates that the Single-AZ DB instance will change to
16066
+ # a Multi-AZ deployment.
15665
16067
  # @return [Boolean]
15666
16068
  #
15667
16069
  # @!attribute [rw] engine_version
@@ -17802,6 +18204,7 @@ module Aws::RDS
17802
18204
  # use_default_processor_features: false,
17803
18205
  # db_parameter_group_name: "String",
17804
18206
  # deletion_protection: false,
18207
+ # enable_customer_owned_ip: false,
17805
18208
  # }
17806
18209
  #
17807
18210
  # @!attribute [rw] db_instance_identifier
@@ -18111,6 +18514,28 @@ module Aws::RDS
18111
18514
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html
18112
18515
  # @return [Boolean]
18113
18516
  #
18517
+ # @!attribute [rw] enable_customer_owned_ip
18518
+ # A value that indicates whether to enable a customer-owned IP address
18519
+ # (CoIP) for an RDS on Outposts DB instance.
18520
+ #
18521
+ # A *CoIP* provides local or external connectivity to resources in
18522
+ # your Outpost subnets through your on-premises network. For some use
18523
+ # cases, a CoIP can provide lower latency for connections to the DB
18524
+ # instance from outside of its virtual private cloud (VPC) on your
18525
+ # local network.
18526
+ #
18527
+ # For more information about RDS on Outposts, see [Working with Amazon
18528
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
18529
+ #
18530
+ # For more information about CoIPs, see [Customer-owned IP
18531
+ # addresses][2] in the *AWS Outposts User Guide*.
18532
+ #
18533
+ #
18534
+ #
18535
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
18536
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
18537
+ # @return [Boolean]
18538
+ #
18114
18539
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshotMessage AWS API Documentation
18115
18540
  #
18116
18541
  class RestoreDBInstanceFromDBSnapshotMessage < Struct.new(
@@ -18141,7 +18566,8 @@ module Aws::RDS
18141
18566
  :processor_features,
18142
18567
  :use_default_processor_features,
18143
18568
  :db_parameter_group_name,
18144
- :deletion_protection)
18569
+ :deletion_protection,
18570
+ :enable_customer_owned_ip)
18145
18571
  SENSITIVE = []
18146
18572
  include Aws::Structure
18147
18573
  end
@@ -18629,6 +19055,14 @@ module Aws::RDS
18629
19055
  # @!attribute [rw] max_allocated_storage
18630
19056
  # The upper limit to which Amazon RDS can automatically scale the
18631
19057
  # storage of the DB instance.
19058
+ #
19059
+ # For more information about this setting, including limitations that
19060
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
19061
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
19062
+ #
19063
+ #
19064
+ #
19065
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
18632
19066
  # @return [Integer]
18633
19067
  #
18634
19068
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromS3Message AWS API Documentation
@@ -18744,6 +19178,7 @@ module Aws::RDS
18744
19178
  # source_dbi_resource_id: "String",
18745
19179
  # max_allocated_storage: 1,
18746
19180
  # source_db_instance_automated_backups_arn: "String",
19181
+ # enable_customer_owned_ip: false,
18747
19182
  # }
18748
19183
  #
18749
19184
  # @!attribute [rw] source_db_instance_identifier
@@ -19070,6 +19505,14 @@ module Aws::RDS
19070
19505
  # @!attribute [rw] max_allocated_storage
19071
19506
  # The upper limit to which Amazon RDS can automatically scale the
19072
19507
  # storage of the DB instance.
19508
+ #
19509
+ # For more information about this setting, including limitations that
19510
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
19511
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
19512
+ #
19513
+ #
19514
+ #
19515
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
19073
19516
  # @return [Integer]
19074
19517
  #
19075
19518
  # @!attribute [rw] source_db_instance_automated_backups_arn
@@ -19078,6 +19521,28 @@ module Aws::RDS
19078
19521
  # `arn:aws:rds:useast-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
19079
19522
  # @return [String]
19080
19523
  #
19524
+ # @!attribute [rw] enable_customer_owned_ip
19525
+ # A value that indicates whether to enable a customer-owned IP address
19526
+ # (CoIP) for an RDS on Outposts DB instance.
19527
+ #
19528
+ # A *CoIP* provides local or external connectivity to resources in
19529
+ # your Outpost subnets through your on-premises network. For some use
19530
+ # cases, a CoIP can provide lower latency for connections to the DB
19531
+ # instance from outside of its virtual private cloud (VPC) on your
19532
+ # local network.
19533
+ #
19534
+ # For more information about RDS on Outposts, see [Working with Amazon
19535
+ # RDS on AWS Outposts][1] in the *Amazon RDS User Guide*.
19536
+ #
19537
+ # For more information about CoIPs, see [Customer-owned IP
19538
+ # addresses][2] in the *AWS Outposts User Guide*.
19539
+ #
19540
+ #
19541
+ #
19542
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
19543
+ # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
19544
+ # @return [Boolean]
19545
+ #
19081
19546
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceToPointInTimeMessage AWS API Documentation
19082
19547
  #
19083
19548
  class RestoreDBInstanceToPointInTimeMessage < Struct.new(
@@ -19113,7 +19578,8 @@ module Aws::RDS
19113
19578
  :deletion_protection,
19114
19579
  :source_dbi_resource_id,
19115
19580
  :max_allocated_storage,
19116
- :source_db_instance_automated_backups_arn)
19581
+ :source_db_instance_automated_backups_arn,
19582
+ :enable_customer_owned_ip)
19117
19583
  SENSITIVE = []
19118
19584
  include Aws::Structure
19119
19585
  end
@@ -20339,8 +20805,8 @@ module Aws::RDS
20339
20805
  # Information about the virtual private network (VPN) between the VMware
20340
20806
  # vSphere cluster and the AWS website.
20341
20807
  #
20342
- # For more information about RDS on VMware, see the [ *RDS on VMware
20343
- # User Guide.* ][1]
20808
+ # For more information about RDS on VMware, see the [ RDS on VMware User
20809
+ # Guide.][1]
20344
20810
  #
20345
20811
  #
20346
20812
  #