aws-sdk-rds 1.130.0 → 1.134.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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +20 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-rds/client.rb +1519 -359
- data/lib/aws-sdk-rds/client_api.rb +65 -0
- data/lib/aws-sdk-rds/db_cluster.rb +727 -65
- data/lib/aws-sdk-rds/db_cluster_parameter_group.rb +12 -0
- data/lib/aws-sdk-rds/db_cluster_snapshot.rb +166 -14
- data/lib/aws-sdk-rds/db_instance.rb +113 -118
- data/lib/aws-sdk-rds/db_snapshot.rb +33 -11
- data/lib/aws-sdk-rds/resource.rb +361 -106
- data/lib/aws-sdk-rds/types.rb +1731 -313
- data/lib/aws-sdk-rds.rb +1 -1
- metadata +4 -4
| @@ -225,9 +225,10 @@ module Aws::RDS | |
| 225 225 |  | 
| 226 226 | 
             
                # Contains one or more identifiers of Aurora DB clusters to which the
         | 
| 227 227 | 
             
                # RDS DB instance is replicated as a read replica. For example, when you
         | 
| 228 | 
            -
                # create an Aurora read replica of an RDS MySQL DB instance, the | 
| 229 | 
            -
                # MySQL DB cluster for the Aurora read replica is shown. This | 
| 230 | 
            -
                #  | 
| 228 | 
            +
                # create an Aurora read replica of an RDS for MySQL DB instance, the
         | 
| 229 | 
            +
                # Aurora MySQL DB cluster for the Aurora read replica is shown. This
         | 
| 230 | 
            +
                # output doesn't contain information about cross-Region Aurora read
         | 
| 231 | 
            +
                # replicas.
         | 
| 231 232 | 
             
                #
         | 
| 232 233 | 
             
                # <note markdown="1"> Currently, each RDS DB instance can have only one Aurora read replica.
         | 
| 233 234 | 
             
                #
         | 
| @@ -296,12 +297,13 @@ module Aws::RDS | |
| 296 297 |  | 
| 297 298 | 
             
                # Specifies the accessibility options for the DB instance.
         | 
| 298 299 | 
             
                #
         | 
| 299 | 
            -
                # When the DB  | 
| 300 | 
            -
                # to the private IP address from within the DB | 
| 301 | 
            -
                #  | 
| 302 | 
            -
                #  | 
| 303 | 
            -
                #  | 
| 304 | 
            -
                #  | 
| 300 | 
            +
                # When the DB cluster is publicly accessible, its Domain Name System
         | 
| 301 | 
            +
                # (DNS) endpoint resolves to the private IP address from within the DB
         | 
| 302 | 
            +
                # cluster's virtual private cloud (VPC). It resolves to the public IP
         | 
| 303 | 
            +
                # address from outside of the DB cluster's VPC. Access to the DB
         | 
| 304 | 
            +
                # cluster is ultimately controlled by the security group it uses. That
         | 
| 305 | 
            +
                # public access isn't permitted if the security group assigned to the
         | 
| 306 | 
            +
                # DB cluster doesn't permit it.
         | 
| 305 307 | 
             
                #
         | 
| 306 308 | 
             
                # When the DB instance isn't publicly accessible, it is an internal DB
         | 
| 307 309 | 
             
                # instance with a DNS name that resolves to a private IP address.
         | 
| @@ -670,6 +672,13 @@ module Aws::RDS | |
| 670 672 | 
             
                  data[:custom_iam_instance_profile]
         | 
| 671 673 | 
             
                end
         | 
| 672 674 |  | 
| 675 | 
            +
                # Specifies where automated backups and manual snapshots are stored:
         | 
| 676 | 
            +
                # Amazon Web Services Outposts or the Amazon Web Services Region.
         | 
| 677 | 
            +
                # @return [String]
         | 
| 678 | 
            +
                def backup_target
         | 
| 679 | 
            +
                  data[:backup_target]
         | 
| 680 | 
            +
                end
         | 
| 681 | 
            +
             | 
| 673 682 | 
             
                # @!endgroup
         | 
| 674 683 |  | 
| 675 684 | 
             
                # @return [Client]
         | 
| @@ -865,6 +874,7 @@ module Aws::RDS | |
| 865 874 | 
             
                #     max_allocated_storage: 1,
         | 
| 866 875 | 
             
                #     enable_customer_owned_ip: false,
         | 
| 867 876 | 
             
                #     custom_iam_instance_profile: "String",
         | 
| 877 | 
            +
                #     backup_target: "String",
         | 
| 868 878 | 
             
                #   })
         | 
| 869 879 | 
             
                # @param [Hash] options ({})
         | 
| 870 880 | 
             
                # @option options [String] :db_name
         | 
| @@ -1077,8 +1087,8 @@ module Aws::RDS | |
| 1077 1087 | 
             
                #
         | 
| 1078 1088 | 
             
                #     * Web and Express editions: Must be an integer from 20 to 1024.
         | 
| 1079 1089 | 
             
                # @option options [required, String] :db_instance_class
         | 
| 1080 | 
            -
                #   The compute and memory capacity of the DB instance, for example | 
| 1081 | 
            -
                #    | 
| 1090 | 
            +
                #   The compute and memory capacity of the DB instance, for example
         | 
| 1091 | 
            +
                #   db.m4.large. Not all DB instance classes are available in all Amazon
         | 
| 1082 1092 | 
             
                #   Web Services Regions, or for all database engines. For the full list
         | 
| 1083 1093 | 
             
                #   of DB instance classes, and availability for your engine, see [DB
         | 
| 1084 1094 | 
             
                #   Instance Class][1] in the *Amazon RDS User Guide.*
         | 
| @@ -1131,59 +1141,13 @@ module Aws::RDS | |
| 1131 1141 | 
             
                #   Not applicable. The name for the master user is managed by the DB
         | 
| 1132 1142 | 
             
                #   cluster.
         | 
| 1133 1143 | 
             
                #
         | 
| 1134 | 
            -
                #   ** | 
| 1135 | 
            -
                #
         | 
| 1136 | 
            -
                #   Constraints:
         | 
| 1137 | 
            -
                #
         | 
| 1138 | 
            -
                #   * Required for MariaDB.
         | 
| 1139 | 
            -
                #
         | 
| 1140 | 
            -
                #   * Must be 1 to 16 letters or numbers.
         | 
| 1141 | 
            -
                #
         | 
| 1142 | 
            -
                #   * Can't be a reserved word for the chosen database engine.
         | 
| 1143 | 
            -
                #
         | 
| 1144 | 
            -
                #   **Microsoft SQL Server**
         | 
| 1144 | 
            +
                #   **Amazon RDS**
         | 
| 1145 1145 | 
             
                #
         | 
| 1146 1146 | 
             
                #   Constraints:
         | 
| 1147 1147 | 
             
                #
         | 
| 1148 | 
            -
                #   * Required | 
| 1148 | 
            +
                #   * Required.
         | 
| 1149 1149 | 
             
                #
         | 
| 1150 | 
            -
                #   * Must be 1 to  | 
| 1151 | 
            -
                #
         | 
| 1152 | 
            -
                #   * The first character must be a letter.
         | 
| 1153 | 
            -
                #
         | 
| 1154 | 
            -
                #   * Can't be a reserved word for the chosen database engine.
         | 
| 1155 | 
            -
                #
         | 
| 1156 | 
            -
                #   **MySQL**
         | 
| 1157 | 
            -
                #
         | 
| 1158 | 
            -
                #   Constraints:
         | 
| 1159 | 
            -
                #
         | 
| 1160 | 
            -
                #   * Required for MySQL.
         | 
| 1161 | 
            -
                #
         | 
| 1162 | 
            -
                #   * Must be 1 to 16 letters or numbers.
         | 
| 1163 | 
            -
                #
         | 
| 1164 | 
            -
                #   * First character must be a letter.
         | 
| 1165 | 
            -
                #
         | 
| 1166 | 
            -
                #   * Can't be a reserved word for the chosen database engine.
         | 
| 1167 | 
            -
                #
         | 
| 1168 | 
            -
                #   **Oracle**
         | 
| 1169 | 
            -
                #
         | 
| 1170 | 
            -
                #   Constraints:
         | 
| 1171 | 
            -
                #
         | 
| 1172 | 
            -
                #   * Required for Oracle.
         | 
| 1173 | 
            -
                #
         | 
| 1174 | 
            -
                #   * Must be 1 to 30 letters or numbers.
         | 
| 1175 | 
            -
                #
         | 
| 1176 | 
            -
                #   * First character must be a letter.
         | 
| 1177 | 
            -
                #
         | 
| 1178 | 
            -
                #   * Can't be a reserved word for the chosen database engine.
         | 
| 1179 | 
            -
                #
         | 
| 1180 | 
            -
                #   **PostgreSQL**
         | 
| 1181 | 
            -
                #
         | 
| 1182 | 
            -
                #   Constraints:
         | 
| 1183 | 
            -
                #
         | 
| 1184 | 
            -
                #   * Required for PostgreSQL.
         | 
| 1185 | 
            -
                #
         | 
| 1186 | 
            -
                #   * Must be 1 to 63 letters or numbers.
         | 
| 1150 | 
            +
                #   * Must be 1 to 16 letters, numbers, or underscores.
         | 
| 1187 1151 | 
             
                #
         | 
| 1188 1152 | 
             
                #   * First character must be a letter.
         | 
| 1189 1153 | 
             
                #
         | 
| @@ -1418,27 +1382,28 @@ module Aws::RDS | |
| 1418 1382 | 
             
                #
         | 
| 1419 1383 | 
             
                #   **MariaDB**
         | 
| 1420 1384 | 
             
                #
         | 
| 1421 | 
            -
                #    | 
| 1422 | 
            -
                #   Guide.*
         | 
| 1385 | 
            +
                #   For information, see [MariaDB on Amazon RDS Versions][2] in the
         | 
| 1386 | 
            +
                #   *Amazon RDS User Guide.*
         | 
| 1423 1387 | 
             
                #
         | 
| 1424 1388 | 
             
                #   **Microsoft SQL Server**
         | 
| 1425 1389 | 
             
                #
         | 
| 1426 | 
            -
                #    | 
| 1427 | 
            -
                #   RDS User Guide.*
         | 
| 1390 | 
            +
                #   For information, see [Microsoft SQL Server Versions on Amazon RDS][3]
         | 
| 1391 | 
            +
                #   in the *Amazon RDS User Guide.*
         | 
| 1428 1392 | 
             
                #
         | 
| 1429 1393 | 
             
                #   **MySQL**
         | 
| 1430 1394 | 
             
                #
         | 
| 1431 | 
            -
                #    | 
| 1395 | 
            +
                #   For information, see [MySQL on Amazon RDS Versions][4] in the *Amazon
         | 
| 1396 | 
            +
                #   RDS User Guide.*
         | 
| 1432 1397 | 
             
                #
         | 
| 1433 1398 | 
             
                #   **Oracle**
         | 
| 1434 1399 | 
             
                #
         | 
| 1435 | 
            -
                #    | 
| 1436 | 
            -
                #   Guide.*
         | 
| 1400 | 
            +
                #   For information, see [Oracle Database Engine Release Notes][5] in the
         | 
| 1401 | 
            +
                #   *Amazon RDS User Guide.*
         | 
| 1437 1402 | 
             
                #
         | 
| 1438 1403 | 
             
                #   **PostgreSQL**
         | 
| 1439 1404 | 
             
                #
         | 
| 1440 | 
            -
                #    | 
| 1441 | 
            -
                #   *Amazon RDS User Guide.*
         | 
| 1405 | 
            +
                #   For information, see [Amazon RDS for PostgreSQL versions and
         | 
| 1406 | 
            +
                #   extensions][6] in the *Amazon RDS User Guide.*
         | 
| 1442 1407 | 
             
                #
         | 
| 1443 1408 | 
             
                #
         | 
| 1444 1409 | 
             
                #
         | 
| @@ -1465,8 +1430,8 @@ module Aws::RDS | |
| 1465 1430 | 
             
                # @option options [Integer] :iops
         | 
| 1466 1431 | 
             
                #   The amount of Provisioned IOPS (input/output operations per second) to
         | 
| 1467 1432 | 
             
                #   be initially allocated for the DB instance. For information about
         | 
| 1468 | 
            -
                #   valid Iops values, see [Amazon RDS Provisioned IOPS  | 
| 1469 | 
            -
                #    | 
| 1433 | 
            +
                #   valid `Iops` values, see [Amazon RDS Provisioned IOPS storage to
         | 
| 1434 | 
            +
                #   improve performance][1] in the *Amazon RDS User Guide*.
         | 
| 1470 1435 | 
             
                #
         | 
| 1471 1436 | 
             
                #   Constraints: For MariaDB, MySQL, Oracle, and PostgreSQL DB instances,
         | 
| 1472 1437 | 
             
                #   must be a multiple between .5 and 50 of the storage amount for the DB
         | 
| @@ -1504,12 +1469,13 @@ module Aws::RDS | |
| 1504 1469 | 
             
                # @option options [Boolean] :publicly_accessible
         | 
| 1505 1470 | 
             
                #   A value that indicates whether the DB instance is publicly accessible.
         | 
| 1506 1471 | 
             
                #
         | 
| 1507 | 
            -
                #   When the DB instance is publicly accessible, its  | 
| 1508 | 
            -
                #   to the private IP address from within the DB | 
| 1509 | 
            -
                #    | 
| 1510 | 
            -
                #    | 
| 1511 | 
            -
                #    | 
| 1512 | 
            -
                #    | 
| 1472 | 
            +
                #   When the DB instance is publicly accessible, its Domain Name System
         | 
| 1473 | 
            +
                #   (DNS) endpoint resolves to the private IP address from within the DB
         | 
| 1474 | 
            +
                #   instance's virtual private cloud (VPC). It resolves to the public IP
         | 
| 1475 | 
            +
                #   address from outside of the DB instance's VPC. Access to the DB
         | 
| 1476 | 
            +
                #   instance is ultimately controlled by the security group it uses. That
         | 
| 1477 | 
            +
                #   public access is not permitted if the security group assigned to the
         | 
| 1478 | 
            +
                #   DB instance doesn't permit it.
         | 
| 1513 1479 | 
             
                #
         | 
| 1514 1480 | 
             
                #   When the DB instance isn't publicly accessible, it is an internal DB
         | 
| 1515 1481 | 
             
                #   instance with a DNS name that resolves to a private IP address.
         | 
| @@ -1520,19 +1486,19 @@ module Aws::RDS | |
| 1520 1486 | 
             
                #   If `DBSubnetGroupName` isn't specified, and `PubliclyAccessible`
         | 
| 1521 1487 | 
             
                #   isn't specified, the following applies:
         | 
| 1522 1488 | 
             
                #
         | 
| 1523 | 
            -
                #   * If the default VPC in the target  | 
| 1489 | 
            +
                #   * If the default VPC in the target Region doesn’t have an internet
         | 
| 1524 1490 | 
             
                #     gateway attached to it, the DB instance is private.
         | 
| 1525 1491 | 
             
                #
         | 
| 1526 | 
            -
                #   * If the default VPC in the target  | 
| 1492 | 
            +
                #   * If the default VPC in the target Region has an internet gateway
         | 
| 1527 1493 | 
             
                #     attached to it, the DB instance is public.
         | 
| 1528 1494 | 
             
                #
         | 
| 1529 1495 | 
             
                #   If `DBSubnetGroupName` is specified, and `PubliclyAccessible` isn't
         | 
| 1530 1496 | 
             
                #   specified, the following applies:
         | 
| 1531 1497 | 
             
                #
         | 
| 1532 | 
            -
                #   * If the subnets are part of a VPC that doesn’t have an  | 
| 1498 | 
            +
                #   * If the subnets are part of a VPC that doesn’t have an internet
         | 
| 1533 1499 | 
             
                #     gateway attached to it, the DB instance is private.
         | 
| 1534 1500 | 
             
                #
         | 
| 1535 | 
            -
                #   * If the subnets are part of a VPC that has an  | 
| 1501 | 
            +
                #   * If the subnets are part of a VPC that has an internet gateway
         | 
| 1536 1502 | 
             
                #     attached to it, the DB instance is public.
         | 
| 1537 1503 | 
             
                # @option options [Array<Types::Tag>] :tags
         | 
| 1538 1504 | 
             
                #   Tags to assign to the DB instance.
         | 
| @@ -1676,7 +1642,7 @@ module Aws::RDS | |
| 1676 1642 | 
             
                # @option options [Boolean] :enable_iam_database_authentication
         | 
| 1677 1643 | 
             
                #   A value that indicates whether to enable mapping of Amazon Web
         | 
| 1678 1644 | 
             
                #   Services Identity and Access Management (IAM) accounts to database
         | 
| 1679 | 
            -
                #   accounts. By default, mapping  | 
| 1645 | 
            +
                #   accounts. By default, mapping isn't enabled.
         | 
| 1680 1646 | 
             
                #
         | 
| 1681 1647 | 
             
                #   This setting doesn't apply to RDS Custom or Amazon Aurora. In Aurora,
         | 
| 1682 1648 | 
             
                #   mapping Amazon Web Services IAM accounts to database accounts is
         | 
| @@ -1762,7 +1728,7 @@ module Aws::RDS | |
| 1762 1728 | 
             
                # @option options [Boolean] :deletion_protection
         | 
| 1763 1729 | 
             
                #   A value that indicates whether the DB instance has deletion protection
         | 
| 1764 1730 | 
             
                #   enabled. The database can't be deleted when deletion protection is
         | 
| 1765 | 
            -
                #   enabled. By default, deletion protection  | 
| 1731 | 
            +
                #   enabled. By default, deletion protection isn't enabled. For more
         | 
| 1766 1732 | 
             
                #   information, see [ Deleting a DB Instance][1].
         | 
| 1767 1733 | 
             
                #
         | 
| 1768 1734 | 
             
                #   **Amazon Aurora**
         | 
| @@ -1830,6 +1796,18 @@ module Aws::RDS | |
| 1830 1796 | 
             
                #
         | 
| 1831 1797 | 
             
                #
         | 
| 1832 1798 | 
             
                #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
         | 
| 1799 | 
            +
                # @option options [String] :backup_target
         | 
| 1800 | 
            +
                #   Specifies where automated backups and manual snapshots are stored.
         | 
| 1801 | 
            +
                #
         | 
| 1802 | 
            +
                #   Possible values are `outposts` (Amazon Web Services Outposts) and
         | 
| 1803 | 
            +
                #   `region` (Amazon Web Services Region). The default is `region`.
         | 
| 1804 | 
            +
                #
         | 
| 1805 | 
            +
                #   For more information, see [Working with Amazon RDS on Amazon Web
         | 
| 1806 | 
            +
                #   Services Outposts][1] in the *Amazon RDS User Guide*.
         | 
| 1807 | 
            +
                #
         | 
| 1808 | 
            +
                #
         | 
| 1809 | 
            +
                #
         | 
| 1810 | 
            +
                #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
         | 
| 1833 1811 | 
             
                # @return [DBInstance]
         | 
| 1834 1812 | 
             
                def create(options = {})
         | 
| 1835 1813 | 
             
                  options = options.merge(db_instance_identifier: @id)
         | 
| @@ -1894,8 +1872,8 @@ module Aws::RDS | |
| 1894 1872 | 
             
                #   unique key that identifies a DB instance. This parameter is stored as
         | 
| 1895 1873 | 
             
                #   a lowercase string.
         | 
| 1896 1874 | 
             
                # @option options [String] :db_instance_class
         | 
| 1897 | 
            -
                #   The compute and memory capacity of the read replica, for example | 
| 1898 | 
            -
                #    | 
| 1875 | 
            +
                #   The compute and memory capacity of the read replica, for example
         | 
| 1876 | 
            +
                #   db.m4.large. Not all DB instance classes are available in all Amazon
         | 
| 1899 1877 | 
             
                #   Web Services Regions, or for all database engines. For the full list
         | 
| 1900 1878 | 
             
                #   of DB instance classes, and availability for your engine, see [DB
         | 
| 1901 1879 | 
             
                #   Instance Class][1] in the *Amazon RDS User Guide.*
         | 
| @@ -1954,8 +1932,8 @@ module Aws::RDS | |
| 1954 1932 | 
             
                #
         | 
| 1955 1933 | 
             
                #   If you do not specify a value for `DBParameterGroupName`, then Amazon
         | 
| 1956 1934 | 
             
                #   RDS uses the `DBParameterGroup` of source DB instance for a same
         | 
| 1957 | 
            -
                #    | 
| 1958 | 
            -
                #   specified DB engine for a cross  | 
| 1935 | 
            +
                #   Region read replica, or the default `DBParameterGroup` for the
         | 
| 1936 | 
            +
                #   specified DB engine for a cross-Region read replica.
         | 
| 1959 1937 | 
             
                #
         | 
| 1960 1938 | 
             
                #   Specifying a parameter group for this operation is only supported for
         | 
| 1961 1939 | 
             
                #   Oracle DB instances. It isn't supported for RDS Custom.
         | 
| @@ -1970,12 +1948,13 @@ module Aws::RDS | |
| 1970 1948 | 
             
                # @option options [Boolean] :publicly_accessible
         | 
| 1971 1949 | 
             
                #   A value that indicates whether the DB instance is publicly accessible.
         | 
| 1972 1950 | 
             
                #
         | 
| 1973 | 
            -
                #   When the DB  | 
| 1974 | 
            -
                #   to the private IP address from within the DB | 
| 1975 | 
            -
                #    | 
| 1976 | 
            -
                #    | 
| 1977 | 
            -
                #    | 
| 1978 | 
            -
                #    | 
| 1951 | 
            +
                #   When the DB cluster is publicly accessible, its Domain Name System
         | 
| 1952 | 
            +
                #   (DNS) endpoint resolves to the private IP address from within the DB
         | 
| 1953 | 
            +
                #   cluster's virtual private cloud (VPC). It resolves to the public IP
         | 
| 1954 | 
            +
                #   address from outside of the DB cluster's VPC. Access to the DB
         | 
| 1955 | 
            +
                #   cluster is ultimately controlled by the security group it uses. That
         | 
| 1956 | 
            +
                #   public access isn't permitted if the security group assigned to the
         | 
| 1957 | 
            +
                #   DB cluster doesn't permit it.
         | 
| 1979 1958 | 
             
                #
         | 
| 1980 1959 | 
             
                #   When the DB instance isn't publicly accessible, it is an internal DB
         | 
| 1981 1960 | 
             
                #   instance with a DNS name that resolves to a private IP address.
         | 
| @@ -2144,7 +2123,7 @@ module Aws::RDS | |
| 2144 2123 | 
             
                #   Region.
         | 
| 2145 2124 | 
             
                #
         | 
| 2146 2125 | 
             
                #    `SourceRegion` isn't supported for SQL Server, because SQL Server on
         | 
| 2147 | 
            -
                #   Amazon RDS doesn't support cross- | 
| 2126 | 
            +
                #   Amazon RDS doesn't support cross-Region read replicas.
         | 
| 2148 2127 | 
             
                #
         | 
| 2149 2128 | 
             
                #    </note>
         | 
| 2150 2129 | 
             
                #
         | 
| @@ -2157,7 +2136,7 @@ module Aws::RDS | |
| 2157 2136 | 
             
                # @option options [Boolean] :enable_iam_database_authentication
         | 
| 2158 2137 | 
             
                #   A value that indicates whether to enable mapping of Amazon Web
         | 
| 2159 2138 | 
             
                #   Services Identity and Access Management (IAM) accounts to database
         | 
| 2160 | 
            -
                #   accounts. By default, mapping  | 
| 2139 | 
            +
                #   accounts. By default, mapping isn't enabled.
         | 
| 2161 2140 | 
             
                #
         | 
| 2162 2141 | 
             
                #   For more information about IAM database authentication, see [ IAM
         | 
| 2163 2142 | 
             
                #   Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
         | 
| @@ -2222,7 +2201,7 @@ module Aws::RDS | |
| 2222 2201 | 
             
                # @option options [Boolean] :deletion_protection
         | 
| 2223 2202 | 
             
                #   A value that indicates whether the DB instance has deletion protection
         | 
| 2224 2203 | 
             
                #   enabled. The database can't be deleted when deletion protection is
         | 
| 2225 | 
            -
                #   enabled. By default, deletion protection  | 
| 2204 | 
            +
                #   enabled. By default, deletion protection isn't enabled. For more
         | 
| 2226 2205 | 
             
                #   information, see [ Deleting a DB Instance][1].
         | 
| 2227 2206 | 
             
                #
         | 
| 2228 2207 | 
             
                #
         | 
| @@ -2500,8 +2479,8 @@ module Aws::RDS | |
| 2500 2479 | 
             
                #   For the valid values for allocated storage for each engine, see
         | 
| 2501 2480 | 
             
                #   `CreateDBInstance`.
         | 
| 2502 2481 | 
             
                # @option options [String] :db_instance_class
         | 
| 2503 | 
            -
                #   The new compute and memory capacity of the DB instance, for example | 
| 2504 | 
            -
                #    | 
| 2482 | 
            +
                #   The new compute and memory capacity of the DB instance, for example
         | 
| 2483 | 
            +
                #   db.m4.large. Not all DB instance classes are available in all Amazon
         | 
| 2505 2484 | 
             
                #   Web Services Regions, or for all database engines. For the full list
         | 
| 2506 2485 | 
             
                #   of DB instance classes, and availability for your engine, see [DB
         | 
| 2507 2486 | 
             
                #   Instance Class][1] in the *Amazon RDS User Guide*.
         | 
| @@ -2987,12 +2966,13 @@ module Aws::RDS | |
| 2987 2966 | 
             
                # @option options [Boolean] :publicly_accessible
         | 
| 2988 2967 | 
             
                #   A value that indicates whether the DB instance is publicly accessible.
         | 
| 2989 2968 | 
             
                #
         | 
| 2990 | 
            -
                #   When the DB  | 
| 2991 | 
            -
                #   to the private IP address from within the DB | 
| 2992 | 
            -
                #    | 
| 2993 | 
            -
                #    | 
| 2994 | 
            -
                #    | 
| 2995 | 
            -
                #    | 
| 2969 | 
            +
                #   When the DB cluster is publicly accessible, its Domain Name System
         | 
| 2970 | 
            +
                #   (DNS) endpoint resolves to the private IP address from within the DB
         | 
| 2971 | 
            +
                #   cluster's virtual private cloud (VPC). It resolves to the public IP
         | 
| 2972 | 
            +
                #   address from outside of the DB cluster's VPC. Access to the DB
         | 
| 2973 | 
            +
                #   cluster is ultimately controlled by the security group it uses. That
         | 
| 2974 | 
            +
                #   public access isn't permitted if the security group assigned to the
         | 
| 2975 | 
            +
                #   DB cluster doesn't permit it.
         | 
| 2996 2976 | 
             
                #
         | 
| 2997 2977 | 
             
                #   When the DB instance isn't publicly accessible, it is an internal DB
         | 
| 2998 2978 | 
             
                #   instance with a DNS name that resolves to a private IP address.
         | 
| @@ -3043,7 +3023,7 @@ module Aws::RDS | |
| 3043 3023 | 
             
                # @option options [Boolean] :enable_iam_database_authentication
         | 
| 3044 3024 | 
             
                #   A value that indicates whether to enable mapping of Amazon Web
         | 
| 3045 3025 | 
             
                #   Services Identity and Access Management (IAM) accounts to database
         | 
| 3046 | 
            -
                #   accounts. By default, mapping  | 
| 3026 | 
            +
                #   accounts. By default, mapping isn't enabled.
         | 
| 3047 3027 | 
             
                #
         | 
| 3048 3028 | 
             
                #   This setting doesn't apply to Amazon Aurora. Mapping Amazon Web
         | 
| 3049 3029 | 
             
                #   Services IAM accounts to database accounts is managed by the DB
         | 
| @@ -3110,7 +3090,7 @@ module Aws::RDS | |
| 3110 3090 | 
             
                # @option options [Boolean] :deletion_protection
         | 
| 3111 3091 | 
             
                #   A value that indicates whether the DB instance has deletion protection
         | 
| 3112 3092 | 
             
                #   enabled. The database can't be deleted when deletion protection is
         | 
| 3113 | 
            -
                #   enabled. By default, deletion protection  | 
| 3093 | 
            +
                #   enabled. By default, deletion protection isn't enabled. For more
         | 
| 3114 3094 | 
             
                #   information, see [ Deleting a DB Instance][1].
         | 
| 3115 3095 | 
             
                #
         | 
| 3116 3096 | 
             
                #
         | 
| @@ -3347,6 +3327,7 @@ module Aws::RDS | |
| 3347 3327 | 
             
                #     source_db_instance_automated_backups_arn: "String",
         | 
| 3348 3328 | 
             
                #     enable_customer_owned_ip: false,
         | 
| 3349 3329 | 
             
                #     custom_iam_instance_profile: "String",
         | 
| 3330 | 
            +
                #     backup_target: "String",
         | 
| 3350 3331 | 
             
                #   })
         | 
| 3351 3332 | 
             
                # @param [Hash] options ({})
         | 
| 3352 3333 | 
             
                # @option options [required, String] :target_db_instance_identifier
         | 
| @@ -3382,10 +3363,10 @@ module Aws::RDS | |
| 3382 3363 | 
             
                #   provided.
         | 
| 3383 3364 | 
             
                # @option options [String] :db_instance_class
         | 
| 3384 3365 | 
             
                #   The compute and memory capacity of the Amazon RDS DB instance, for
         | 
| 3385 | 
            -
                #   example | 
| 3386 | 
            -
                #    | 
| 3387 | 
            -
                #    | 
| 3388 | 
            -
                #    | 
| 3366 | 
            +
                #   example db.m4.large. Not all DB instance classes are available in all
         | 
| 3367 | 
            +
                #   Amazon Web Services Regions, or for all database engines. For the full
         | 
| 3368 | 
            +
                #   list of DB instance classes, and availability for your engine, see [DB
         | 
| 3369 | 
            +
                #   Instance Class][1] in the *Amazon RDS User Guide.*
         | 
| 3389 3370 | 
             
                #
         | 
| 3390 3371 | 
             
                #   Default: The same DBInstanceClass as the original DB instance.
         | 
| 3391 3372 | 
             
                #
         | 
| @@ -3425,12 +3406,13 @@ module Aws::RDS | |
| 3425 3406 | 
             
                # @option options [Boolean] :publicly_accessible
         | 
| 3426 3407 | 
             
                #   A value that indicates whether the DB instance is publicly accessible.
         | 
| 3427 3408 | 
             
                #
         | 
| 3428 | 
            -
                #   When the DB  | 
| 3429 | 
            -
                #   to the private IP address from within the DB | 
| 3430 | 
            -
                #    | 
| 3431 | 
            -
                #    | 
| 3432 | 
            -
                #    | 
| 3433 | 
            -
                #    | 
| 3409 | 
            +
                #   When the DB cluster is publicly accessible, its Domain Name System
         | 
| 3410 | 
            +
                #   (DNS) endpoint resolves to the private IP address from within the DB
         | 
| 3411 | 
            +
                #   cluster's virtual private cloud (VPC). It resolves to the public IP
         | 
| 3412 | 
            +
                #   address from outside of the DB cluster's VPC. Access to the DB
         | 
| 3413 | 
            +
                #   cluster is ultimately controlled by the security group it uses. That
         | 
| 3414 | 
            +
                #   public access isn't permitted if the security group assigned to the
         | 
| 3415 | 
            +
                #   DB cluster doesn't permit it.
         | 
| 3434 3416 | 
             
                #
         | 
| 3435 3417 | 
             
                #   When the DB instance isn't publicly accessible, it is an internal DB
         | 
| 3436 3418 | 
             
                #   instance with a DNS name that resolves to a private IP address.
         | 
| @@ -3565,7 +3547,7 @@ module Aws::RDS | |
| 3565 3547 | 
             
                # @option options [Boolean] :enable_iam_database_authentication
         | 
| 3566 3548 | 
             
                #   A value that indicates whether to enable mapping of Amazon Web
         | 
| 3567 3549 | 
             
                #   Services Identity and Access Management (IAM) accounts to database
         | 
| 3568 | 
            -
                #   accounts. By default, mapping  | 
| 3550 | 
            +
                #   accounts. By default, mapping isn't enabled.
         | 
| 3569 3551 | 
             
                #
         | 
| 3570 3552 | 
             
                #   This setting doesn't apply to RDS Custom.
         | 
| 3571 3553 | 
             
                #
         | 
| @@ -3617,7 +3599,7 @@ module Aws::RDS | |
| 3617 3599 | 
             
                # @option options [Boolean] :deletion_protection
         | 
| 3618 3600 | 
             
                #   A value that indicates whether the DB instance has deletion protection
         | 
| 3619 3601 | 
             
                #   enabled. The database can't be deleted when deletion protection is
         | 
| 3620 | 
            -
                #   enabled. By default, deletion protection  | 
| 3602 | 
            +
                #   enabled. By default, deletion protection isn't enabled. For more
         | 
| 3621 3603 | 
             
                #   information, see [ Deleting a DB Instance][1].
         | 
| 3622 3604 | 
             
                #
         | 
| 3623 3605 | 
             
                #
         | 
| @@ -3688,6 +3670,19 @@ module Aws::RDS | |
| 3688 3670 | 
             
                #
         | 
| 3689 3671 | 
             
                #
         | 
| 3690 3672 | 
             
                #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
         | 
| 3673 | 
            +
                # @option options [String] :backup_target
         | 
| 3674 | 
            +
                #   Specifies where automated backups and manual snapshots are stored for
         | 
| 3675 | 
            +
                #   the restored DB instance.
         | 
| 3676 | 
            +
                #
         | 
| 3677 | 
            +
                #   Possible values are `outposts` (Amazon Web Services Outposts) and
         | 
| 3678 | 
            +
                #   `region` (Amazon Web Services Region). The default is `region`.
         | 
| 3679 | 
            +
                #
         | 
| 3680 | 
            +
                #   For more information, see [Working with Amazon RDS on Amazon Web
         | 
| 3681 | 
            +
                #   Services Outposts][1] in the *Amazon RDS User Guide*.
         | 
| 3682 | 
            +
                #
         | 
| 3683 | 
            +
                #
         | 
| 3684 | 
            +
                #
         | 
| 3685 | 
            +
                #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
         | 
| 3691 3686 | 
             
                # @return [DBInstance]
         | 
| 3692 3687 | 
             
                def restore(options = {})
         | 
| 3693 3688 | 
             
                  options = options.merge(source_db_instance_identifier: @id)
         | 
| @@ -237,6 +237,13 @@ module Aws::RDS | |
| 237 237 | 
             
                  data[:original_snapshot_create_time]
         | 
| 238 238 | 
             
                end
         | 
| 239 239 |  | 
| 240 | 
            +
                # Specifies where manual snapshots are stored: Amazon Web Services
         | 
| 241 | 
            +
                # Outposts or the Amazon Web Services Region.
         | 
| 242 | 
            +
                # @return [String]
         | 
| 243 | 
            +
                def snapshot_target
         | 
| 244 | 
            +
                  data[:snapshot_target]
         | 
| 245 | 
            +
                end
         | 
| 246 | 
            +
             | 
| 240 247 | 
             
                # @!endgroup
         | 
| 241 248 |  | 
| 242 249 | 
             
                # @return [Client]
         | 
| @@ -623,6 +630,7 @@ module Aws::RDS | |
| 623 630 | 
             
                #     deletion_protection: false,
         | 
| 624 631 | 
             
                #     enable_customer_owned_ip: false,
         | 
| 625 632 | 
             
                #     custom_iam_instance_profile: "String",
         | 
| 633 | 
            +
                #     backup_target: "String",
         | 
| 626 634 | 
             
                #   })
         | 
| 627 635 | 
             
                # @param [Hash] options ({})
         | 
| 628 636 | 
             
                # @option options [required, String] :db_instance_identifier
         | 
| @@ -640,10 +648,10 @@ module Aws::RDS | |
| 640 648 | 
             
                #   Example: `my-snapshot-id`
         | 
| 641 649 | 
             
                # @option options [String] :db_instance_class
         | 
| 642 650 | 
             
                #   The compute and memory capacity of the Amazon RDS DB instance, for
         | 
| 643 | 
            -
                #   example | 
| 644 | 
            -
                #    | 
| 645 | 
            -
                #    | 
| 646 | 
            -
                #    | 
| 651 | 
            +
                #   example db.m4.large. Not all DB instance classes are available in all
         | 
| 652 | 
            +
                #   Amazon Web Services Regions, or for all database engines. For the full
         | 
| 653 | 
            +
                #   list of DB instance classes, and availability for your engine, see [DB
         | 
| 654 | 
            +
                #   Instance Class][1] in the *Amazon RDS User Guide.*
         | 
| 647 655 | 
             
                #
         | 
| 648 656 | 
             
                #   Default: The same DBInstanceClass as the original DB instance.
         | 
| 649 657 | 
             
                #
         | 
| @@ -683,12 +691,13 @@ module Aws::RDS | |
| 683 691 | 
             
                # @option options [Boolean] :publicly_accessible
         | 
| 684 692 | 
             
                #   A value that indicates whether the DB instance is publicly accessible.
         | 
| 685 693 | 
             
                #
         | 
| 686 | 
            -
                #   When the DB instance is publicly accessible, its  | 
| 687 | 
            -
                #   to the private IP address from within the DB | 
| 688 | 
            -
                #    | 
| 689 | 
            -
                #    | 
| 690 | 
            -
                #    | 
| 691 | 
            -
                #    | 
| 694 | 
            +
                #   When the DB instance is publicly accessible, its Domain Name System
         | 
| 695 | 
            +
                #   (DNS) endpoint resolves to the private IP address from within the DB
         | 
| 696 | 
            +
                #   instance's virtual private cloud (VPC). It resolves to the public IP
         | 
| 697 | 
            +
                #   address from outside of the DB instance's VPC. Access to the DB
         | 
| 698 | 
            +
                #   instance is ultimately controlled by the security group it uses. That
         | 
| 699 | 
            +
                #   public access is not permitted if the security group assigned to the
         | 
| 700 | 
            +
                #   DB instance doesn't permit it.
         | 
| 692 701 | 
             
                #
         | 
| 693 702 | 
             
                #   When the DB instance isn't publicly accessible, it is an internal DB
         | 
| 694 703 | 
             
                #   instance with a DNS name that resolves to a private IP address.
         | 
| @@ -884,7 +893,7 @@ module Aws::RDS | |
| 884 893 | 
             
                # @option options [Boolean] :deletion_protection
         | 
| 885 894 | 
             
                #   A value that indicates whether the DB instance has deletion protection
         | 
| 886 895 | 
             
                #   enabled. The database can't be deleted when deletion protection is
         | 
| 887 | 
            -
                #   enabled. By default, deletion protection  | 
| 896 | 
            +
                #   enabled. By default, deletion protection isn't enabled. For more
         | 
| 888 897 | 
             
                #   information, see [ Deleting a DB Instance][1].
         | 
| 889 898 | 
             
                #
         | 
| 890 899 | 
             
                #
         | 
| @@ -934,6 +943,19 @@ module Aws::RDS | |
| 934 943 | 
             
                #
         | 
| 935 944 | 
             
                #
         | 
| 936 945 | 
             
                #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
         | 
| 946 | 
            +
                # @option options [String] :backup_target
         | 
| 947 | 
            +
                #   Specifies where automated backups and manual snapshots are stored for
         | 
| 948 | 
            +
                #   the restored DB instance.
         | 
| 949 | 
            +
                #
         | 
| 950 | 
            +
                #   Possible values are `outposts` (Amazon Web Services Outposts) and
         | 
| 951 | 
            +
                #   `region` (Amazon Web Services Region). The default is `region`.
         | 
| 952 | 
            +
                #
         | 
| 953 | 
            +
                #   For more information, see [Working with Amazon RDS on Amazon Web
         | 
| 954 | 
            +
                #   Services Outposts][1] in the *Amazon RDS User Guide*.
         | 
| 955 | 
            +
                #
         | 
| 956 | 
            +
                #
         | 
| 957 | 
            +
                #
         | 
| 958 | 
            +
                #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
         | 
| 937 959 | 
             
                # @return [DBInstance]
         | 
| 938 960 | 
             
                def restore(options = {})
         | 
| 939 961 | 
             
                  options = options.merge(db_snapshot_identifier: @snapshot_id)
         |