aws-sdk-rds 1.127.0 → 1.131.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.
@@ -277,6 +277,15 @@ module Aws::RDS
277
277
  # ** Please note ** When response stubbing is enabled, no HTTP
278
278
  # requests are made, and retries are disabled.
279
279
  #
280
+ # @option options [Boolean] :use_dualstack_endpoint
281
+ # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
282
+ # will be used if available.
283
+ #
284
+ # @option options [Boolean] :use_fips_endpoint
285
+ # When set to `true`, fips compatible endpoints will be used if available.
286
+ # When a `fips` region is used, the region is normalized and this config
287
+ # is set to `true`.
288
+ #
280
289
  # @option options [Boolean] :validate_params (true)
281
290
  # When `true`, request parameters are validated before
282
291
  # sending the request.
@@ -352,7 +361,7 @@ module Aws::RDS
352
361
  #
353
362
  # @option params [String] :feature_name
354
363
  # The name of the feature for the DB cluster that the IAM role is to be
355
- # associated with. For the list of supported feature names, see
364
+ # associated with. For information about supported feature names, see
356
365
  # DBEngineVersion.
357
366
  #
358
367
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -382,6 +391,8 @@ module Aws::RDS
382
391
  #
383
392
  # </note>
384
393
  #
394
+ # This command doesn't apply to RDS Custom.
395
+ #
385
396
  # @option params [required, String] :db_instance_identifier
386
397
  # The name of the DB instance to associate the IAM role with.
387
398
  #
@@ -391,7 +402,7 @@ module Aws::RDS
391
402
  #
392
403
  # @option params [required, String] :feature_name
393
404
  # The name of the feature for the DB instance that the IAM role is to be
394
- # associated with. For the list of supported feature names, see
405
+ # associated with. For information about supported feature names, see
395
406
  # DBEngineVersion.
396
407
  #
397
408
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -1027,11 +1038,11 @@ module Aws::RDS
1027
1038
  # values:
1028
1039
  #
1029
1040
  # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the
1030
- # customer master key (CMK) to use to encrypt the copy of the DB
1031
- # cluster snapshot in the destination Amazon Web Services Region.
1032
- # This is the same identifier for both the `CopyDBClusterSnapshot`
1033
- # action that is called in the destination Amazon Web Services
1034
- # Region, and the action contained in the pre-signed URL.
1041
+ # KMS key to use to encrypt the copy of the DB cluster snapshot in
1042
+ # the destination Amazon Web Services Region. This is the same
1043
+ # identifier for both the `CopyDBClusterSnapshot` action that is
1044
+ # called in the destination Amazon Web Services Region, and the
1045
+ # action contained in the pre-signed URL.
1035
1046
  #
1036
1047
  # * `DestinationRegion` - The name of the Amazon Web Services Region
1037
1048
  # that the DB cluster snapshot is to be created in.
@@ -1133,15 +1144,13 @@ module Aws::RDS
1133
1144
  # @option params [String] :kms_key_id
1134
1145
  # The Amazon Web Services KMS key identifier for an encrypted DB cluster
1135
1146
  # snapshot. The Amazon Web Services KMS key identifier is the key ARN,
1136
- # key ID, alias ARN, or alias name for the Amazon Web Services KMS
1137
- # customer master key (CMK).
1147
+ # key ID, alias ARN, or alias name for the Amazon Web Services KMS key.
1138
1148
  #
1139
1149
  # If you copy an encrypted DB cluster snapshot from your Amazon Web
1140
1150
  # Services account, you can specify a value for `KmsKeyId` to encrypt
1141
- # the copy with a new Amazon Web Services KMS CMK. If you don't specify
1142
- # a value for `KmsKeyId`, then the copy of the DB cluster snapshot is
1143
- # encrypted with the same Amazon Web Services KMS key as the source DB
1144
- # cluster snapshot.
1151
+ # the copy with a new KMS key. If you don't specify a value for
1152
+ # `KmsKeyId`, then the copy of the DB cluster snapshot is encrypted with
1153
+ # the same KMS key as the source DB cluster snapshot.
1145
1154
  #
1146
1155
  # If you copy an encrypted DB cluster snapshot that is shared from
1147
1156
  # another Amazon Web Services account, then you must specify a value for
@@ -1150,10 +1159,10 @@ module Aws::RDS
1150
1159
  # To copy an encrypted DB cluster snapshot to another Amazon Web
1151
1160
  # Services Region, you must set `KmsKeyId` to the Amazon Web Services
1152
1161
  # KMS key identifier you want to use to encrypt the copy of the DB
1153
- # cluster snapshot in the destination Amazon Web Services Region. Amazon
1154
- # Web Services KMS CMKs are specific to the Amazon Web Services Region
1155
- # that they are created in, and you can't use CMKs from one Amazon Web
1156
- # Services Region in another Amazon Web Services Region.
1162
+ # cluster snapshot in the destination Amazon Web Services Region. KMS
1163
+ # keys are specific to the Amazon Web Services Region that they are
1164
+ # created in, and you can't use KMS keys from one Amazon Web Services
1165
+ # Region in another Amazon Web Services Region.
1157
1166
  #
1158
1167
  # If you copy an unencrypted DB cluster snapshot and specify a value for
1159
1168
  # the `KmsKeyId` parameter, an error is returned.
@@ -1173,12 +1182,12 @@ module Aws::RDS
1173
1182
  # snapshot to be copied. The pre-signed URL request must contain the
1174
1183
  # following parameter values:
1175
1184
  #
1176
- # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the
1177
- # customer master key (CMK) to use to encrypt the copy of the DB
1178
- # cluster snapshot in the destination Amazon Web Services Region. This
1179
- # is the same identifier for both the `CopyDBClusterSnapshot` action
1180
- # that is called in the destination Amazon Web Services Region, and
1181
- # the action contained in the pre-signed URL.
1185
+ # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
1186
+ # key to use to encrypt the copy of the DB cluster snapshot in the
1187
+ # destination Amazon Web Services Region. This is the same identifier
1188
+ # for both the `CopyDBClusterSnapshot` action that is called in the
1189
+ # destination Amazon Web Services Region, and the action contained in
1190
+ # the pre-signed URL.
1182
1191
  #
1183
1192
  # * `DestinationRegion` - The name of the Amazon Web Services Region
1184
1193
  # that the DB cluster snapshot is to be created in.
@@ -1404,6 +1413,8 @@ module Aws::RDS
1404
1413
  # the `CopyDBSnapshot` action is the destination Amazon Web Services
1405
1414
  # Region for the DB snapshot copy.
1406
1415
  #
1416
+ # This command doesn't apply to RDS Custom.
1417
+ #
1407
1418
  # For more information about copying snapshots, see [Copying a DB
1408
1419
  # Snapshot][1] in the *Amazon RDS User Guide.*
1409
1420
  #
@@ -1459,15 +1470,13 @@ module Aws::RDS
1459
1470
  # @option params [String] :kms_key_id
1460
1471
  # The Amazon Web Services KMS key identifier for an encrypted DB
1461
1472
  # snapshot. The Amazon Web Services KMS key identifier is the key ARN,
1462
- # key ID, alias ARN, or alias name for the Amazon Web Services KMS
1463
- # customer master key (CMK).
1473
+ # key ID, alias ARN, or alias name for the KMS key.
1464
1474
  #
1465
1475
  # If you copy an encrypted DB snapshot from your Amazon Web Services
1466
1476
  # account, you can specify a value for this parameter to encrypt the
1467
- # copy with a new Amazon Web Services KMS CMK. If you don't specify a
1468
- # value for this parameter, then the copy of the DB snapshot is
1469
- # encrypted with the same Amazon Web Services KMS key as the source DB
1470
- # snapshot.
1477
+ # copy with a new KMS key. If you don't specify a value for this
1478
+ # parameter, then the copy of the DB snapshot is encrypted with the same
1479
+ # Amazon Web Services KMS key as the source DB snapshot.
1471
1480
  #
1472
1481
  # If you copy an encrypted DB snapshot that is shared from another
1473
1482
  # Amazon Web Services account, then you must specify a value for this
@@ -1477,11 +1486,11 @@ module Aws::RDS
1477
1486
  # the copy is encrypted.
1478
1487
  #
1479
1488
  # If you copy an encrypted snapshot to a different Amazon Web Services
1480
- # Region, then you must specify a Amazon Web Services KMS key identifier
1481
- # for the destination Amazon Web Services Region. Amazon Web Services
1482
- # KMS CMKs are specific to the Amazon Web Services Region that they are
1483
- # created in, and you can't use CMKs from one Amazon Web Services
1484
- # Region in another Amazon Web Services Region.
1489
+ # Region, then you must specify an Amazon Web Services KMS key
1490
+ # identifier for the destination Amazon Web Services Region. KMS keys
1491
+ # are specific to the Amazon Web Services Region that they are created
1492
+ # in, and you can't use KMS keys from one Amazon Web Services Region in
1493
+ # another Amazon Web Services Region.
1485
1494
  #
1486
1495
  # @option params [Array<Types::Tag>] :tags
1487
1496
  # A list of tags. For more information, see [Tagging Amazon RDS
@@ -1524,12 +1533,11 @@ module Aws::RDS
1524
1533
  # presigned URL must be set to the us-east-1 Amazon Web Services
1525
1534
  # Region.
1526
1535
  #
1527
- # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the
1528
- # customer master key (CMK) to use to encrypt the copy of the DB
1529
- # snapshot in the destination Amazon Web Services Region. This is the
1530
- # same identifier for both the `CopyDBSnapshot` action that is called
1531
- # in the destination Amazon Web Services Region, and the action
1532
- # contained in the presigned URL.
1536
+ # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
1537
+ # key to use to encrypt the copy of the DB snapshot in the destination
1538
+ # Amazon Web Services Region. This is the same identifier for both the
1539
+ # `CopyDBSnapshot` action that is called in the destination Amazon Web
1540
+ # Services Region, and the action contained in the presigned URL.
1533
1541
  #
1534
1542
  # * `SourceDBSnapshotIdentifier` - The DB snapshot identifier for the
1535
1543
  # encrypted snapshot to be copied. This identifier must be in the
@@ -1658,6 +1666,7 @@ module Aws::RDS
1658
1666
  # resp.db_snapshot.tag_list[0].key #=> String
1659
1667
  # resp.db_snapshot.tag_list[0].value #=> String
1660
1668
  # resp.db_snapshot.original_snapshot_create_time #=> Time
1669
+ # resp.db_snapshot.snapshot_target #=> String
1661
1670
  #
1662
1671
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBSnapshot AWS API Documentation
1663
1672
  #
@@ -1847,6 +1856,238 @@ module Aws::RDS
1847
1856
  req.send_request(options)
1848
1857
  end
1849
1858
 
1859
+ # Creates a custom DB engine version (CEV). A CEV is a binary volume
1860
+ # snapshot of a database engine and specific AMI. The only supported
1861
+ # engine is Oracle Database 19c Enterprise Edition with the January 2021
1862
+ # or later RU/RUR.
1863
+ #
1864
+ # Amazon RDS, which is a fully managed service, supplies the Amazon
1865
+ # Machine Image (AMI) and database software. The Amazon RDS database
1866
+ # software is preinstalled, so you need only select a DB engine and
1867
+ # version, and create your database. With Amazon RDS Custom, you upload
1868
+ # your database installation files in Amazon S3.
1869
+ #
1870
+ # When you create a custom engine version, you specify the files in a
1871
+ # JSON document called a CEV manifest. This document describes
1872
+ # installation .zip files stored in Amazon S3. RDS Custom creates your
1873
+ # CEV from the installation files that you provided. This service model
1874
+ # is called Bring Your Own Media (BYOM).
1875
+ #
1876
+ # Creation takes approximately two hours. If creation fails, RDS Custom
1877
+ # issues `RDS-EVENT-0196` with the message `Creation failed for custom
1878
+ # engine version`, and includes details about the failure. For example,
1879
+ # the event prints missing files.
1880
+ #
1881
+ # After you create the CEV, it is available for use. You can create
1882
+ # multiple CEVs, and create multiple RDS Custom instances from any CEV.
1883
+ # You can also change the status of a CEV to make it available or
1884
+ # inactive.
1885
+ #
1886
+ # <note markdown="1"> The MediaImport service that imports files from Amazon S3 to create
1887
+ # CEVs isn't integrated with Amazon Web Services CloudTrail. If you
1888
+ # turn on data logging for Amazon RDS in CloudTrail, calls to the
1889
+ # `CreateCustomDbEngineVersion` event aren't logged. However, you might
1890
+ # see calls from the API gateway that accesses your Amazon S3 bucket.
1891
+ # These calls originate from the MediaImport service for the
1892
+ # `CreateCustomDbEngineVersion` event.
1893
+ #
1894
+ # </note>
1895
+ #
1896
+ # For more information, see [ Creating a CEV][1] in the *Amazon RDS User
1897
+ # Guide*.
1898
+ #
1899
+ #
1900
+ #
1901
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.create
1902
+ #
1903
+ # @option params [required, String] :engine
1904
+ # The database engine to use for your custom engine version (CEV). The
1905
+ # only supported value is `custom-oracle-ee`.
1906
+ #
1907
+ # @option params [required, String] :engine_version
1908
+ # The name of your CEV. The name format is `19.customized_string `. For
1909
+ # example, a valid name is `19.my_cev1`. This setting is required for
1910
+ # RDS Custom, but optional for Amazon RDS. The combination of `Engine`
1911
+ # and `EngineVersion` is unique per customer per Region.
1912
+ #
1913
+ # @option params [required, String] :database_installation_files_s3_bucket_name
1914
+ # The name of an Amazon S3 bucket that contains database installation
1915
+ # files for your CEV. For example, a valid bucket name is
1916
+ # `my-custom-installation-files`.
1917
+ #
1918
+ # @option params [String] :database_installation_files_s3_prefix
1919
+ # The Amazon S3 directory that contains the database installation files
1920
+ # for your CEV. For example, a valid bucket name is `123456789012/cev1`.
1921
+ # If this setting isn't specified, no prefix is assumed.
1922
+ #
1923
+ # @option params [required, String] :kms_key_id
1924
+ # The Amazon Web Services KMS key identifier for an encrypted CEV. A
1925
+ # symmetric KMS key is required for RDS Custom, but optional for Amazon
1926
+ # RDS.
1927
+ #
1928
+ # If you have an existing symmetric KMS key in your account, you can use
1929
+ # it with RDS Custom. No further action is necessary. If you don't
1930
+ # already have a symmetric KMS key in your account, follow the
1931
+ # instructions in [ Creating symmetric KMS keys][1] in the *Amazon Web
1932
+ # Services Key Management Service Developer Guide*.
1933
+ #
1934
+ # You can choose the same symmetric key when you create a CEV and a DB
1935
+ # instance, or choose different keys.
1936
+ #
1937
+ #
1938
+ #
1939
+ # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html#create-symmetric-cmk
1940
+ #
1941
+ # @option params [String] :description
1942
+ # An optional description of your CEV.
1943
+ #
1944
+ # @option params [required, String] :manifest
1945
+ # The CEV manifest, which is a JSON document that describes the
1946
+ # installation .zip files stored in Amazon S3. Specify the name/value
1947
+ # pairs in a file or a quoted string. RDS Custom applies the patches in
1948
+ # the order in which they are listed.
1949
+ #
1950
+ # The following JSON fields are valid:
1951
+ #
1952
+ # MediaImportTemplateVersion
1953
+ #
1954
+ # : Version of the CEV manifest. The date is in the format `YYYY-MM-DD`.
1955
+ #
1956
+ # databaseInstallationFileNames
1957
+ #
1958
+ # : Ordered list of installation files for the CEV.
1959
+ #
1960
+ # opatchFileNames
1961
+ #
1962
+ # : Ordered list of OPatch installers used for the Oracle DB engine.
1963
+ #
1964
+ # psuRuPatchFileNames
1965
+ #
1966
+ # : The PSU and RU patches for this CEV.
1967
+ #
1968
+ # OtherPatchFileNames
1969
+ #
1970
+ # : The patches that are not in the list of PSU and RU patches. Amazon
1971
+ # RDS applies these patches after applying the PSU and RU patches.
1972
+ #
1973
+ # For more information, see [ Creating the CEV manifest][1] in the
1974
+ # *Amazon RDS User Guide*.
1975
+ #
1976
+ #
1977
+ #
1978
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.preparing.manifest
1979
+ #
1980
+ # @option params [Array<Types::Tag>] :tags
1981
+ # A list of tags. For more information, see [Tagging Amazon RDS
1982
+ # Resources][1] in the *Amazon RDS User Guide.*
1983
+ #
1984
+ #
1985
+ #
1986
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
1987
+ #
1988
+ # @return [Types::DBEngineVersion] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1989
+ #
1990
+ # * {Types::DBEngineVersion#engine #engine} => String
1991
+ # * {Types::DBEngineVersion#engine_version #engine_version} => String
1992
+ # * {Types::DBEngineVersion#db_parameter_group_family #db_parameter_group_family} => String
1993
+ # * {Types::DBEngineVersion#db_engine_description #db_engine_description} => String
1994
+ # * {Types::DBEngineVersion#db_engine_version_description #db_engine_version_description} => String
1995
+ # * {Types::DBEngineVersion#default_character_set #default_character_set} => Types::CharacterSet
1996
+ # * {Types::DBEngineVersion#supported_character_sets #supported_character_sets} => Array&lt;Types::CharacterSet&gt;
1997
+ # * {Types::DBEngineVersion#supported_nchar_character_sets #supported_nchar_character_sets} => Array&lt;Types::CharacterSet&gt;
1998
+ # * {Types::DBEngineVersion#valid_upgrade_target #valid_upgrade_target} => Array&lt;Types::UpgradeTarget&gt;
1999
+ # * {Types::DBEngineVersion#supported_timezones #supported_timezones} => Array&lt;Types::Timezone&gt;
2000
+ # * {Types::DBEngineVersion#exportable_log_types #exportable_log_types} => Array&lt;String&gt;
2001
+ # * {Types::DBEngineVersion#supports_log_exports_to_cloudwatch_logs #supports_log_exports_to_cloudwatch_logs} => Boolean
2002
+ # * {Types::DBEngineVersion#supports_read_replica #supports_read_replica} => Boolean
2003
+ # * {Types::DBEngineVersion#supported_engine_modes #supported_engine_modes} => Array&lt;String&gt;
2004
+ # * {Types::DBEngineVersion#supported_feature_names #supported_feature_names} => Array&lt;String&gt;
2005
+ # * {Types::DBEngineVersion#status #status} => String
2006
+ # * {Types::DBEngineVersion#supports_parallel_query #supports_parallel_query} => Boolean
2007
+ # * {Types::DBEngineVersion#supports_global_databases #supports_global_databases} => Boolean
2008
+ # * {Types::DBEngineVersion#major_engine_version #major_engine_version} => String
2009
+ # * {Types::DBEngineVersion#database_installation_files_s3_bucket_name #database_installation_files_s3_bucket_name} => String
2010
+ # * {Types::DBEngineVersion#database_installation_files_s3_prefix #database_installation_files_s3_prefix} => String
2011
+ # * {Types::DBEngineVersion#db_engine_version_arn #db_engine_version_arn} => String
2012
+ # * {Types::DBEngineVersion#kms_key_id #kms_key_id} => String
2013
+ # * {Types::DBEngineVersion#create_time #create_time} => Time
2014
+ # * {Types::DBEngineVersion#tag_list #tag_list} => Array&lt;Types::Tag&gt;
2015
+ #
2016
+ # @example Request syntax with placeholder values
2017
+ #
2018
+ # resp = client.create_custom_db_engine_version({
2019
+ # engine: "CustomEngineName", # required
2020
+ # engine_version: "CustomEngineVersion", # required
2021
+ # database_installation_files_s3_bucket_name: "BucketName", # required
2022
+ # database_installation_files_s3_prefix: "String255",
2023
+ # kms_key_id: "KmsKeyIdOrArn", # required
2024
+ # description: "Description",
2025
+ # manifest: "CustomDBEngineVersionManifest", # required
2026
+ # tags: [
2027
+ # {
2028
+ # key: "String",
2029
+ # value: "String",
2030
+ # },
2031
+ # ],
2032
+ # })
2033
+ #
2034
+ # @example Response structure
2035
+ #
2036
+ # resp.engine #=> String
2037
+ # resp.engine_version #=> String
2038
+ # resp.db_parameter_group_family #=> String
2039
+ # resp.db_engine_description #=> String
2040
+ # resp.db_engine_version_description #=> String
2041
+ # resp.default_character_set.character_set_name #=> String
2042
+ # resp.default_character_set.character_set_description #=> String
2043
+ # resp.supported_character_sets #=> Array
2044
+ # resp.supported_character_sets[0].character_set_name #=> String
2045
+ # resp.supported_character_sets[0].character_set_description #=> String
2046
+ # resp.supported_nchar_character_sets #=> Array
2047
+ # resp.supported_nchar_character_sets[0].character_set_name #=> String
2048
+ # resp.supported_nchar_character_sets[0].character_set_description #=> String
2049
+ # resp.valid_upgrade_target #=> Array
2050
+ # resp.valid_upgrade_target[0].engine #=> String
2051
+ # resp.valid_upgrade_target[0].engine_version #=> String
2052
+ # resp.valid_upgrade_target[0].description #=> String
2053
+ # resp.valid_upgrade_target[0].auto_upgrade #=> Boolean
2054
+ # resp.valid_upgrade_target[0].is_major_version_upgrade #=> Boolean
2055
+ # resp.valid_upgrade_target[0].supported_engine_modes #=> Array
2056
+ # resp.valid_upgrade_target[0].supported_engine_modes[0] #=> String
2057
+ # resp.valid_upgrade_target[0].supports_parallel_query #=> Boolean
2058
+ # resp.valid_upgrade_target[0].supports_global_databases #=> Boolean
2059
+ # resp.supported_timezones #=> Array
2060
+ # resp.supported_timezones[0].timezone_name #=> String
2061
+ # resp.exportable_log_types #=> Array
2062
+ # resp.exportable_log_types[0] #=> String
2063
+ # resp.supports_log_exports_to_cloudwatch_logs #=> Boolean
2064
+ # resp.supports_read_replica #=> Boolean
2065
+ # resp.supported_engine_modes #=> Array
2066
+ # resp.supported_engine_modes[0] #=> String
2067
+ # resp.supported_feature_names #=> Array
2068
+ # resp.supported_feature_names[0] #=> String
2069
+ # resp.status #=> String
2070
+ # resp.supports_parallel_query #=> Boolean
2071
+ # resp.supports_global_databases #=> Boolean
2072
+ # resp.major_engine_version #=> String
2073
+ # resp.database_installation_files_s3_bucket_name #=> String
2074
+ # resp.database_installation_files_s3_prefix #=> String
2075
+ # resp.db_engine_version_arn #=> String
2076
+ # resp.kms_key_id #=> String
2077
+ # resp.create_time #=> Time
2078
+ # resp.tag_list #=> Array
2079
+ # resp.tag_list[0].key #=> String
2080
+ # resp.tag_list[0].value #=> String
2081
+ #
2082
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateCustomDBEngineVersion AWS API Documentation
2083
+ #
2084
+ # @overload create_custom_db_engine_version(params = {})
2085
+ # @param [Hash] params ({})
2086
+ def create_custom_db_engine_version(params = {}, options = {})
2087
+ req = build_request(:create_custom_db_engine_version, params)
2088
+ req.send_request(options)
2089
+ end
2090
+
1850
2091
  # Creates a new Amazon Aurora DB cluster.
1851
2092
  #
1852
2093
  # You can use the `ReplicationSourceIdentifier` parameter to create the
@@ -2061,29 +2302,29 @@ module Aws::RDS
2061
2302
  # cluster.
2062
2303
  #
2063
2304
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
2064
- # alias ARN, or alias name for the Amazon Web Services KMS customer
2065
- # master key (CMK). To use a CMK in a different Amazon Web Services
2066
- # account, specify the key ARN or alias ARN.
2305
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
2306
+ # different Amazon Web Services account, specify the key ARN or alias
2307
+ # ARN.
2067
2308
  #
2068
- # When a CMK isn't specified in `KmsKeyId`\:
2309
+ # When a KMS key isn't specified in `KmsKeyId`\:
2069
2310
  #
2070
2311
  # * If `ReplicationSourceIdentifier` identifies an encrypted source,
2071
- # then Amazon RDS will use the CMK used to encrypt the source.
2072
- # Otherwise, Amazon RDS will use your default CMK.
2312
+ # then Amazon RDS will use the KMS key used to encrypt the source.
2313
+ # Otherwise, Amazon RDS will use your default KMS key.
2073
2314
  #
2074
2315
  # * If the `StorageEncrypted` parameter is enabled and
2075
2316
  # `ReplicationSourceIdentifier` isn't specified, then Amazon RDS will
2076
- # use your default CMK.
2317
+ # use your default KMS key.
2077
2318
  #
2078
- # There is a default CMK for your Amazon Web Services account. Your
2079
- # Amazon Web Services account has a different default CMK for each
2319
+ # There is a default KMS key for your Amazon Web Services account. Your
2320
+ # Amazon Web Services account has a different default KMS key for each
2080
2321
  # Amazon Web Services Region.
2081
2322
  #
2082
2323
  # If you create a read replica of an encrypted DB cluster in another
2083
- # Amazon Web Services Region, you must set `KmsKeyId` to a Amazon Web
2084
- # Services KMS key identifier that is valid in the destination Amazon
2085
- # Web Services Region. This CMK is used to encrypt the read replica in
2086
- # that Amazon Web Services Region.
2324
+ # Amazon Web Services Region, you must set `KmsKeyId` to a KMS key
2325
+ # identifier that is valid in the destination Amazon Web Services
2326
+ # Region. This KMS key is used to encrypt the read replica in that
2327
+ # Amazon Web Services Region.
2087
2328
  #
2088
2329
  # @option params [String] :pre_signed_url
2089
2330
  # A URL that contains a Signature Version 4 signed request for the
@@ -2099,12 +2340,12 @@ module Aws::RDS
2099
2340
  # The pre-signed URL request must contain the following parameter
2100
2341
  # values:
2101
2342
  #
2102
- # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the key
2103
- # to use to encrypt the copy of the DB cluster in the destination
2104
- # Amazon Web Services Region. This should refer to the same Amazon Web
2105
- # Services KMS CMK for both the `CreateDBCluster` action that is
2106
- # called in the destination Amazon Web Services Region, and the action
2107
- # contained in the pre-signed URL.
2343
+ # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
2344
+ # key to use to encrypt the copy of the DB cluster in the destination
2345
+ # Amazon Web Services Region. This should refer to the same KMS key
2346
+ # for both the `CreateDBCluster` action that is called in the
2347
+ # destination Amazon Web Services Region, and the action contained in
2348
+ # the pre-signed URL.
2108
2349
  #
2109
2350
  # * `DestinationRegion` - The name of the Amazon Web Services Region
2110
2351
  # that Aurora read replica will be created in.
@@ -2883,6 +3124,21 @@ module Aws::RDS
2883
3124
  #
2884
3125
  # ^
2885
3126
  #
3127
+ # **Amazon RDS Custom**
3128
+ #
3129
+ # The Oracle System ID (SID) of the created RDS Custom DB instance. If
3130
+ # you don't specify a value, the default value is `ORCL`.
3131
+ #
3132
+ # Default: `ORCL`
3133
+ #
3134
+ # Constraints:
3135
+ #
3136
+ # * It must contain 1 to 8 alphanumeric characters.
3137
+ #
3138
+ # * It must contain a letter.
3139
+ #
3140
+ # * It can't be a word reserved by the database engine.
3141
+ #
2886
3142
  # **SQL Server**
2887
3143
  #
2888
3144
  # Not applicable. Must be null.
@@ -2942,6 +3198,16 @@ module Aws::RDS
2942
3198
  # amount of data in your database increases, though you are only charged
2943
3199
  # for the space that you use in an Aurora cluster volume.
2944
3200
  #
3201
+ # **Amazon RDS Custom**
3202
+ #
3203
+ # Constraints to the amount of storage for each storage type are the
3204
+ # following:
3205
+ #
3206
+ # * General Purpose (SSD) storage (gp2): Must be an integer from 40 to
3207
+ # 65536.
3208
+ #
3209
+ # * Provisioned IOPS storage (io1): Must be an integer from 40 to 65536.
3210
+ #
2945
3211
  # **MySQL**
2946
3212
  #
2947
3213
  # Constraints to the amount of storage for each storage type are the
@@ -3045,6 +3311,8 @@ module Aws::RDS
3045
3311
  #
3046
3312
  # * `aurora-postgresql`
3047
3313
  #
3314
+ # * `custom-oracle-ee (for RDS Custom instances)`
3315
+ #
3048
3316
  # * `mariadb`
3049
3317
  #
3050
3318
  # * `mysql`
@@ -3075,59 +3343,13 @@ module Aws::RDS
3075
3343
  # Not applicable. The name for the master user is managed by the DB
3076
3344
  # cluster.
3077
3345
  #
3078
- # **MariaDB**
3346
+ # **Amazon RDS**
3079
3347
  #
3080
3348
  # Constraints:
3081
3349
  #
3082
- # * Required for MariaDB.
3083
- #
3084
- # * Must be 1 to 16 letters or numbers.
3085
- #
3086
- # * Can't be a reserved word for the chosen database engine.
3350
+ # * Required.
3087
3351
  #
3088
- # **Microsoft SQL Server**
3089
- #
3090
- # Constraints:
3091
- #
3092
- # * Required for SQL Server.
3093
- #
3094
- # * Must be 1 to 128 letters or numbers.
3095
- #
3096
- # * The first character must be a letter.
3097
- #
3098
- # * Can't be a reserved word for the chosen database engine.
3099
- #
3100
- # **MySQL**
3101
- #
3102
- # Constraints:
3103
- #
3104
- # * Required for MySQL.
3105
- #
3106
- # * Must be 1 to 16 letters or numbers.
3107
- #
3108
- # * First character must be a letter.
3109
- #
3110
- # * Can't be a reserved word for the chosen database engine.
3111
- #
3112
- # **Oracle**
3113
- #
3114
- # Constraints:
3115
- #
3116
- # * Required for Oracle.
3117
- #
3118
- # * Must be 1 to 30 letters or numbers.
3119
- #
3120
- # * First character must be a letter.
3121
- #
3122
- # * Can't be a reserved word for the chosen database engine.
3123
- #
3124
- # **PostgreSQL**
3125
- #
3126
- # Constraints:
3127
- #
3128
- # * Required for PostgreSQL.
3129
- #
3130
- # * Must be 1 to 63 letters or numbers.
3352
+ # * Must be 1 to 16 letters, numbers, or underscores.
3131
3353
  #
3132
3354
  # * First character must be a letter.
3133
3355
  #
@@ -3237,6 +3459,8 @@ module Aws::RDS
3237
3459
  # If you do not specify a value, then the default DB parameter group for
3238
3460
  # the specified DB engine and version is used.
3239
3461
  #
3462
+ # This setting doesn't apply to RDS Custom.
3463
+ #
3240
3464
  # Constraints:
3241
3465
  #
3242
3466
  # * Must be 1 to 255 letters, numbers, or hyphens.
@@ -3263,6 +3487,8 @@ module Aws::RDS
3263
3487
  #
3264
3488
  # * Can't be set to 0 if the DB instance is a source to read replicas
3265
3489
  #
3490
+ # * Can't be set to 0 or 35 for an RDS Custom DB instance
3491
+ #
3266
3492
  # @option params [String] :preferred_backup_window
3267
3493
  # The daily time range during which automated backups are created if
3268
3494
  # automated backups are enabled, using the `BackupRetentionPeriod`
@@ -3342,6 +3568,8 @@ module Aws::RDS
3342
3568
  # deployment. You can't set the `AvailabilityZone` parameter if the DB
3343
3569
  # instance is a Multi-AZ deployment.
3344
3570
  #
3571
+ # This setting doesn't apply to RDS Custom.
3572
+ #
3345
3573
  # @option params [String] :engine_version
3346
3574
  # The version number of the database engine to use.
3347
3575
  #
@@ -3358,49 +3586,63 @@ module Aws::RDS
3358
3586
  # Not applicable. The version number of the database engine to be used
3359
3587
  # by the DB instance is managed by the DB cluster.
3360
3588
  #
3589
+ # **Amazon RDS Custom**
3590
+ #
3591
+ # A custom engine version (CEV) that you have previously created. This
3592
+ # setting is required for RDS Custom. The CEV name has the following
3593
+ # format: `19.customized_string `. An example identifier is
3594
+ # `19.my_cev1`. For more information, see [ Creating an RDS Custom DB
3595
+ # instance][1] in the *Amazon RDS User Guide.*.
3596
+ #
3361
3597
  # **MariaDB**
3362
3598
  #
3363
- # See [MariaDB on Amazon RDS Versions][1] in the *Amazon RDS User
3599
+ # See [MariaDB on Amazon RDS Versions][2] in the *Amazon RDS User
3364
3600
  # Guide.*
3365
3601
  #
3366
3602
  # **Microsoft SQL Server**
3367
3603
  #
3368
- # See [Microsoft SQL Server Versions on Amazon RDS][2] in the *Amazon
3604
+ # See [Microsoft SQL Server Versions on Amazon RDS][3] in the *Amazon
3369
3605
  # RDS User Guide.*
3370
3606
  #
3371
3607
  # **MySQL**
3372
3608
  #
3373
- # See [MySQL on Amazon RDS Versions][3] in the *Amazon RDS User Guide.*
3609
+ # See [MySQL on Amazon RDS Versions][4] in the *Amazon RDS User Guide.*
3374
3610
  #
3375
3611
  # **Oracle**
3376
3612
  #
3377
- # See [Oracle Database Engine Release Notes][4] in the *Amazon RDS User
3613
+ # See [Oracle Database Engine Release Notes][5] in the *Amazon RDS User
3378
3614
  # Guide.*
3379
3615
  #
3380
3616
  # **PostgreSQL**
3381
3617
  #
3382
- # See [Amazon RDS for PostgreSQL versions and extensions][5] in the
3618
+ # See [Amazon RDS for PostgreSQL versions and extensions][6] in the
3383
3619
  # *Amazon RDS User Guide.*
3384
3620
  #
3385
3621
  #
3386
3622
  #
3387
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
3388
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
3389
- # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
3390
- # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
3391
- # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
3623
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-creating.html#custom-creating.create
3624
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
3625
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
3626
+ # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
3627
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
3628
+ # [6]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
3392
3629
  #
3393
3630
  # @option params [Boolean] :auto_minor_version_upgrade
3394
3631
  # A value that indicates whether minor engine upgrades are applied
3395
3632
  # automatically to the DB instance during the maintenance window. By
3396
3633
  # default, minor engine upgrades are applied automatically.
3397
3634
  #
3635
+ # If you create an RDS Custom DB instance, you must set
3636
+ # `AutoMinorVersionUpgrade` to `false`.
3637
+ #
3398
3638
  # @option params [String] :license_model
3399
3639
  # License model information for this DB instance.
3400
3640
  #
3401
3641
  # Valid values: `license-included` \| `bring-your-own-license` \|
3402
3642
  # `general-public-license`
3403
3643
  #
3644
+ # This setting doesn't apply to RDS Custom.
3645
+ #
3404
3646
  # @option params [Integer] :iops
3405
3647
  # The amount of Provisioned IOPS (input/output operations per second) to
3406
3648
  # be initially allocated for the DB instance. For information about
@@ -3422,12 +3664,17 @@ module Aws::RDS
3422
3664
  #
3423
3665
  # Permanent options, such as the TDE option for Oracle Advanced Security
3424
3666
  # TDE, can't be removed from an option group. Also, that option group
3425
- # can't be removed from a DB instance once it is associated with a DB
3426
- # instance
3667
+ # can't be removed from a DB instance after it is associated with a DB
3668
+ # instance.
3669
+ #
3670
+ # This setting doesn't apply to RDS Custom.
3427
3671
  #
3428
3672
  # @option params [String] :character_set_name
3429
- # For supported engines, indicates that the DB instance should be
3430
- # associated with the specified CharacterSet.
3673
+ # For supported engines, this value indicates that the DB instance
3674
+ # should be associated with the specified `CharacterSet`.
3675
+ #
3676
+ # This setting doesn't apply to RDS Custom. However, if you need to
3677
+ # change the character set, you can change it on the database itself.
3431
3678
  #
3432
3679
  # **Amazon Aurora**
3433
3680
  #
@@ -3437,6 +3684,8 @@ module Aws::RDS
3437
3684
  # @option params [String] :nchar_character_set_name
3438
3685
  # The name of the NCHAR character set for the Oracle DB instance.
3439
3686
  #
3687
+ # This parameter doesn't apply to RDS Custom.
3688
+ #
3440
3689
  # @option params [Boolean] :publicly_accessible
3441
3690
  # A value that indicates whether the DB instance is publicly accessible.
3442
3691
  #
@@ -3477,6 +3726,8 @@ module Aws::RDS
3477
3726
  # @option params [String] :db_cluster_identifier
3478
3727
  # The identifier of the DB cluster that the instance will belong to.
3479
3728
  #
3729
+ # This setting doesn't apply to RDS Custom.
3730
+ #
3480
3731
  # @option params [String] :storage_type
3481
3732
  # Specifies the storage type to be associated with the DB instance.
3482
3733
  #
@@ -3491,14 +3742,22 @@ module Aws::RDS
3491
3742
  # The ARN from the key store with which to associate the instance for
3492
3743
  # TDE encryption.
3493
3744
  #
3745
+ # This setting doesn't apply to RDS Custom.
3746
+ #
3494
3747
  # @option params [String] :tde_credential_password
3495
3748
  # The password for the given ARN from the key store in order to access
3496
3749
  # the device.
3497
3750
  #
3751
+ # This setting doesn't apply to RDS Custom.
3752
+ #
3498
3753
  # @option params [Boolean] :storage_encrypted
3499
3754
  # A value that indicates whether the DB instance is encrypted. By
3500
3755
  # default, it isn't encrypted.
3501
3756
  #
3757
+ # For RDS Custom Oracle instances, either set this parameter to `true`
3758
+ # or leave it unset. If you set this parameter to `false`, RDS reports
3759
+ # an error.
3760
+ #
3502
3761
  # **Amazon Aurora**
3503
3762
  #
3504
3763
  # Not applicable. The encryption for DB instances is managed by the DB
@@ -3509,9 +3768,9 @@ module Aws::RDS
3509
3768
  # instance.
3510
3769
  #
3511
3770
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
3512
- # alias ARN, or alias name for the Amazon Web Services KMS customer
3513
- # master key (CMK). To use a CMK in a different Amazon Web Services
3514
- # account, specify the key ARN or alias ARN.
3771
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
3772
+ # different Amazon Web Services account, specify the key ARN or alias
3773
+ # ARN.
3515
3774
  #
3516
3775
  # **Amazon Aurora**
3517
3776
  #
@@ -3519,10 +3778,18 @@ module Aws::RDS
3519
3778
  # by the DB cluster. For more information, see `CreateDBCluster`.
3520
3779
  #
3521
3780
  # If `StorageEncrypted` is enabled, and you do not specify a value for
3522
- # the `KmsKeyId` parameter, then Amazon RDS uses your default CMK. There
3523
- # is a default CMK for your Amazon Web Services account. Your Amazon Web
3524
- # Services account has a different default CMK for each Amazon Web
3525
- # Services Region.
3781
+ # the `KmsKeyId` parameter, then Amazon RDS uses your default KMS key.
3782
+ # There is a default KMS key for your Amazon Web Services account. Your
3783
+ # Amazon Web Services account has a different default KMS key for each
3784
+ # Amazon Web Services Region.
3785
+ #
3786
+ # **Amazon RDS Custom**
3787
+ #
3788
+ # A KMS key is required for RDS Custom Oracle instances. For most RDS
3789
+ # engines, if you leave this parameter empty while enabling
3790
+ # `StorageEncrypted`, the engine uses the default KMS key. However, RDS
3791
+ # Custom for Oracle doesn't use the default key when this parameter is
3792
+ # empty. You must explicitly specify a key.
3526
3793
  #
3527
3794
  # @option params [String] :domain
3528
3795
  # The Active Directory directory ID to create the DB instance in.
@@ -3532,6 +3799,8 @@ module Aws::RDS
3532
3799
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
3533
3800
  # RDS User Guide*.
3534
3801
  #
3802
+ # This setting doesn't apply to RDS Custom.
3803
+ #
3535
3804
  #
3536
3805
  #
3537
3806
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -3548,24 +3817,28 @@ module Aws::RDS
3548
3817
  #
3549
3818
  # @option params [Integer] :monitoring_interval
3550
3819
  # The interval, in seconds, between points when Enhanced Monitoring
3551
- # metrics are collected for the DB instance. To disable collecting
3820
+ # metrics are collected for the DB instance. To disable collection of
3552
3821
  # Enhanced Monitoring metrics, specify 0. The default is 0.
3553
3822
  #
3554
- # If `MonitoringRoleArn` is specified, then you must also set
3823
+ # If `MonitoringRoleArn` is specified, then you must set
3555
3824
  # `MonitoringInterval` to a value other than 0.
3556
3825
  #
3826
+ # This setting doesn't apply to RDS Custom.
3827
+ #
3557
3828
  # Valid Values: `0, 1, 5, 10, 15, 30, 60`
3558
3829
  #
3559
3830
  # @option params [String] :monitoring_role_arn
3560
3831
  # The ARN for the IAM role that permits RDS to send enhanced monitoring
3561
3832
  # metrics to Amazon CloudWatch Logs. For example,
3562
3833
  # `arn:aws:iam:123456789012:role/emaccess`. For information on creating
3563
- # a monitoring role, go to [Setting Up and Enabling Enhanced
3834
+ # a monitoring role, see [Setting Up and Enabling Enhanced
3564
3835
  # Monitoring][1] in the *Amazon RDS User Guide*.
3565
3836
  #
3566
3837
  # If `MonitoringInterval` is set to a value other than 0, then you must
3567
3838
  # supply a `MonitoringRoleArn` value.
3568
3839
  #
3840
+ # This setting doesn't apply to RDS Custom.
3841
+ #
3569
3842
  #
3570
3843
  #
3571
3844
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
@@ -3574,12 +3847,16 @@ module Aws::RDS
3574
3847
  # Specify the name of the IAM role to be used when making API calls to
3575
3848
  # the Directory Service.
3576
3849
  #
3850
+ # This setting doesn't apply to RDS Custom.
3851
+ #
3577
3852
  # @option params [Integer] :promotion_tier
3578
3853
  # A value that specifies the order in which an Aurora Replica is
3579
3854
  # promoted to the primary instance after a failure of the existing
3580
3855
  # primary instance. For more information, see [ Fault Tolerance for an
3581
3856
  # Aurora DB Cluster][1] in the *Amazon Aurora User Guide*.
3582
3857
  #
3858
+ # This setting doesn't apply to RDS Custom.
3859
+ #
3583
3860
  # Default: 1
3584
3861
  #
3585
3862
  # Valid Values: 0 - 15
@@ -3601,9 +3878,9 @@ module Aws::RDS
3601
3878
  # Services Identity and Access Management (IAM) accounts to database
3602
3879
  # accounts. By default, mapping is disabled.
3603
3880
  #
3604
- # This setting doesn't apply to Amazon Aurora. Mapping Amazon Web
3605
- # Services IAM accounts to database accounts is managed by the DB
3606
- # cluster.
3881
+ # This setting doesn't apply to RDS Custom or Amazon Aurora. In Aurora,
3882
+ # mapping Amazon Web Services IAM accounts to database accounts is
3883
+ # managed by the DB cluster.
3607
3884
  #
3608
3885
  # For more information, see [ IAM Database Authentication for MySQL and
3609
3886
  # PostgreSQL][1] in the *Amazon RDS User Guide.*
@@ -3614,10 +3891,10 @@ module Aws::RDS
3614
3891
  #
3615
3892
  # @option params [Boolean] :enable_performance_insights
3616
3893
  # A value that indicates whether to enable Performance Insights for the
3617
- # DB instance.
3894
+ # DB instance. For more information, see [Using Amazon Performance
3895
+ # Insights][1] in the *Amazon Relational Database Service User Guide*.
3618
3896
  #
3619
- # For more information, see [Using Amazon Performance Insights][1] in
3620
- # the *Amazon Relational Database Service User Guide*.
3897
+ # This setting doesn't apply to RDS Custom.
3621
3898
  #
3622
3899
  #
3623
3900
  #
@@ -3628,29 +3905,35 @@ module Aws::RDS
3628
3905
  # Performance Insights data.
3629
3906
  #
3630
3907
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
3631
- # alias ARN, or alias name for the Amazon Web Services KMS customer
3632
- # master key (CMK).
3908
+ # alias ARN, or alias name for the KMS key.
3633
3909
  #
3634
3910
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
3635
- # Amazon RDS uses your default CMK. There is a default CMK for your
3636
- # Amazon Web Services account. Your Amazon Web Services account has a
3637
- # different default CMK for each Amazon Web Services Region.
3911
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
3912
+ # your Amazon Web Services account. Your Amazon Web Services account has
3913
+ # a different default KMS key for each Amazon Web Services Region.
3914
+ #
3915
+ # This setting doesn't apply to RDS Custom.
3638
3916
  #
3639
3917
  # @option params [Integer] :performance_insights_retention_period
3640
3918
  # The amount of time, in days, to retain Performance Insights data.
3641
3919
  # Valid values are 7 or 731 (2 years).
3642
3920
  #
3921
+ # This setting doesn't apply to RDS Custom.
3922
+ #
3643
3923
  # @option params [Array<String>] :enable_cloudwatch_logs_exports
3644
3924
  # The list of log types that need to be enabled for exporting to
3645
- # CloudWatch Logs. The values in the list depend on the DB engine being
3646
- # used. For more information, see [Publishing Database Logs to Amazon
3647
- # CloudWatch Logs ][1] in the *Amazon Relational Database Service User
3648
- # Guide*.
3925
+ # CloudWatch Logs. The values in the list depend on the DB engine. For
3926
+ # more information, see [Publishing Database Logs to Amazon CloudWatch
3927
+ # Logs][1] in the *Amazon Relational Database Service User Guide*.
3649
3928
  #
3650
3929
  # **Amazon Aurora**
3651
3930
  #
3652
3931
  # Not applicable. CloudWatch Logs exports are managed by the DB cluster.
3653
3932
  #
3933
+ # **RDS Custom**
3934
+ #
3935
+ # Not applicable.
3936
+ #
3654
3937
  # **MariaDB**
3655
3938
  #
3656
3939
  # Possible values are `audit`, `error`, `general`, and `slowquery`.
@@ -3680,6 +3963,8 @@ module Aws::RDS
3680
3963
  # The number of CPU cores and the number of threads per core for the DB
3681
3964
  # instance class of the DB instance.
3682
3965
  #
3966
+ # This setting doesn't apply to RDS Custom.
3967
+ #
3683
3968
  # @option params [Boolean] :deletion_protection
3684
3969
  # A value that indicates whether the DB instance has deletion protection
3685
3970
  # enabled. The database can't be deleted when deletion protection is
@@ -3705,6 +3990,8 @@ module Aws::RDS
3705
3990
  # apply to it, see [ Managing capacity automatically with Amazon RDS
3706
3991
  # storage autoscaling][1] in the *Amazon RDS User Guide*.
3707
3992
  #
3993
+ # This setting doesn't apply to RDS Custom.
3994
+ #
3708
3995
  #
3709
3996
  #
3710
3997
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -3730,6 +4017,42 @@ module Aws::RDS
3730
4017
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
3731
4018
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
3732
4019
  #
4020
+ # @option params [String] :custom_iam_instance_profile
4021
+ # The instance profile associated with the underlying Amazon EC2
4022
+ # instance of an RDS Custom DB instance. The instance profile must meet
4023
+ # the following requirements:
4024
+ #
4025
+ # * The profile must exist in your account.
4026
+ #
4027
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
4028
+ # assume.
4029
+ #
4030
+ # * The instance profile name and the associated IAM role name must
4031
+ # start with the prefix `AWSRDSCustom`.
4032
+ #
4033
+ # For the list of permissions required for the IAM role, see [ Configure
4034
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
4035
+ # Guide*.
4036
+ #
4037
+ # This setting is required for RDS Custom.
4038
+ #
4039
+ #
4040
+ #
4041
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
4042
+ #
4043
+ # @option params [String] :backup_target
4044
+ # Specifies where automated backups and manual snapshots are stored.
4045
+ #
4046
+ # Possible values are `outposts` (Amazon Web Services Outposts) and
4047
+ # `region` (Amazon Web Services Region). The default is `region`.
4048
+ #
4049
+ # For more information, see [Working with Amazon RDS on Amazon Web
4050
+ # Services Outposts][1] in the *Amazon RDS User Guide*.
4051
+ #
4052
+ #
4053
+ #
4054
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
4055
+ #
3733
4056
  # @return [Types::CreateDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3734
4057
  #
3735
4058
  # * {Types::CreateDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -3815,6 +4138,8 @@ module Aws::RDS
3815
4138
  # deletion_protection: false,
3816
4139
  # max_allocated_storage: 1,
3817
4140
  # enable_customer_owned_ip: false,
4141
+ # custom_iam_instance_profile: "String",
4142
+ # backup_target: "String",
3818
4143
  # })
3819
4144
  #
3820
4145
  # @example Response structure
@@ -3875,6 +4200,8 @@ module Aws::RDS
3875
4200
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
3876
4201
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
3877
4202
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
4203
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
4204
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
3878
4205
  # resp.db_instance.latest_restorable_time #=> Time
3879
4206
  # resp.db_instance.multi_az #=> Boolean
3880
4207
  # resp.db_instance.engine_version #=> String
@@ -3949,6 +4276,10 @@ module Aws::RDS
3949
4276
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
3950
4277
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
3951
4278
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
4279
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
4280
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
4281
+ # resp.db_instance.custom_iam_instance_profile #=> String
4282
+ # resp.db_instance.backup_target #=> String
3952
4283
  #
3953
4284
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstance AWS API Documentation
3954
4285
  #
@@ -4017,8 +4348,8 @@ module Aws::RDS
4017
4348
  # * If the source DB instance is in a different Amazon Web Services
4018
4349
  # Region from the read replica, specify a valid DB instance ARN. For
4019
4350
  # more information, see [Constructing an ARN for Amazon RDS][3] in the
4020
- # *Amazon RDS User Guide*. This doesn't apply to SQL Server, which
4021
- # doesn't support cross-region replicas.
4351
+ # *Amazon RDS User Guide*. This doesn't apply to SQL Server or RDS
4352
+ # Custom, which don't support cross-Region replicas.
4022
4353
  #
4023
4354
  #
4024
4355
  #
@@ -4064,10 +4395,14 @@ module Aws::RDS
4064
4395
  # instance is independent of whether the source database is a Multi-AZ
4065
4396
  # DB instance.
4066
4397
  #
4398
+ # This setting doesn't apply to RDS Custom.
4399
+ #
4067
4400
  # @option params [Boolean] :auto_minor_version_upgrade
4068
4401
  # A value that indicates whether minor engine upgrades are applied
4069
4402
  # automatically to the read replica during the maintenance window.
4070
4403
  #
4404
+ # This setting doesn't apply to RDS Custom.
4405
+ #
4071
4406
  # Default: Inherits from the source DB instance
4072
4407
  #
4073
4408
  # @option params [Integer] :iops
@@ -4083,6 +4418,8 @@ module Aws::RDS
4083
4418
  #
4084
4419
  # </note>
4085
4420
  #
4421
+ # This setting doesn't apply to RDS Custom.
4422
+ #
4086
4423
  # @option params [String] :db_parameter_group_name
4087
4424
  # The name of the DB parameter group to associate with this DB instance.
4088
4425
  #
@@ -4091,10 +4428,8 @@ module Aws::RDS
4091
4428
  # region read replica, or the default `DBParameterGroup` for the
4092
4429
  # specified DB engine for a cross region read replica.
4093
4430
  #
4094
- # <note markdown="1"> Currently, specifying a parameter group for this operation is only
4095
- # supported for Oracle DB instances.
4096
- #
4097
- # </note>
4431
+ # Specifying a parameter group for this operation is only supported for
4432
+ # Oracle DB instances. It isn't supported for RDS Custom.
4098
4433
  #
4099
4434
  # Constraints:
4100
4435
  #
@@ -4155,7 +4490,10 @@ module Aws::RDS
4155
4490
  # Example: `mySubnetgroup`
4156
4491
  #
4157
4492
  # @option params [Array<String>] :vpc_security_group_ids
4158
- # A list of EC2 VPC security groups to associate with the read replica.
4493
+ # A list of Amazon EC2 VPC security groups to associate with the read
4494
+ # replica.
4495
+ #
4496
+ # This setting doesn't apply to RDS Custom.
4159
4497
  #
4160
4498
  # Default: The default EC2 VPC security group for the DB subnet group's
4161
4499
  # VPC.
@@ -4182,6 +4520,8 @@ module Aws::RDS
4182
4520
  # If `MonitoringRoleArn` is specified, then you must also set
4183
4521
  # `MonitoringInterval` to a value other than 0.
4184
4522
  #
4523
+ # This setting doesn't apply to RDS Custom.
4524
+ #
4185
4525
  # Valid Values: `0, 1, 5, 10, 15, 30, 60`
4186
4526
  #
4187
4527
  # @option params [String] :monitoring_role_arn
@@ -4194,6 +4534,8 @@ module Aws::RDS
4194
4534
  # If `MonitoringInterval` is set to a value other than 0, then you must
4195
4535
  # supply a `MonitoringRoleArn` value.
4196
4536
  #
4537
+ # This setting doesn't apply to RDS Custom.
4538
+ #
4197
4539
  #
4198
4540
  #
4199
4541
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
@@ -4203,24 +4545,27 @@ module Aws::RDS
4203
4545
  # replica.
4204
4546
  #
4205
4547
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
4206
- # alias ARN, or alias name for the Amazon Web Services KMS CMK.
4548
+ # alias ARN, or alias name for the KMS key.
4207
4549
  #
4208
4550
  # If you create an encrypted read replica in the same Amazon Web
4209
4551
  # Services Region as the source DB instance, then do not specify a value
4210
- # for this parameter. A read replica in the same Region is always
4211
- # encrypted with the same Amazon Web Services KMS CMK as the source DB
4552
+ # for this parameter. A read replica in the same Amazon Web Services
4553
+ # Region is always encrypted with the same KMS key as the source DB
4212
4554
  # instance.
4213
4555
  #
4214
4556
  # If you create an encrypted read replica in a different Amazon Web
4215
- # Services Region, then you must specify a Amazon Web Services KMS key
4216
- # identifier for the destination Amazon Web Services Region. Amazon Web
4217
- # Services KMS CMKs are specific to the Amazon Web Services Region that
4218
- # they are created in, and you can't use CMKs from one Amazon Web
4219
- # Services Region in another Amazon Web Services Region.
4557
+ # Services Region, then you must specify a KMS key identifier for the
4558
+ # destination Amazon Web Services Region. KMS keys are specific to the
4559
+ # Amazon Web Services Region that they are created in, and you can't
4560
+ # use KMS keys from one Amazon Web Services Region in another Amazon Web
4561
+ # Services Region.
4220
4562
  #
4221
4563
  # You can't create an encrypted read replica from an unencrypted DB
4222
4564
  # instance.
4223
4565
  #
4566
+ # This setting doesn't apply to RDS Custom, which uses the same KMS key
4567
+ # as the primary replica.
4568
+ #
4224
4569
  # @option params [String] :pre_signed_url
4225
4570
  # The URL that contains a Signature Version 4 signed request for the
4226
4571
  # `CreateDBInstanceReadReplica` API action in the source Amazon Web
@@ -4284,6 +4629,8 @@ module Aws::RDS
4284
4629
  #
4285
4630
  # </note>
4286
4631
  #
4632
+ # This setting doesn't apply to RDS Custom.
4633
+ #
4287
4634
  #
4288
4635
  #
4289
4636
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html
@@ -4298,6 +4645,8 @@ module Aws::RDS
4298
4645
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
4299
4646
  # RDS User Guide.*
4300
4647
  #
4648
+ # This setting doesn't apply to RDS Custom.
4649
+ #
4301
4650
  #
4302
4651
  #
4303
4652
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
@@ -4309,6 +4658,8 @@ module Aws::RDS
4309
4658
  # For more information, see [Using Amazon Performance Insights][1] in
4310
4659
  # the *Amazon RDS User Guide*.
4311
4660
  #
4661
+ # This setting doesn't apply to RDS Custom.
4662
+ #
4312
4663
  #
4313
4664
  #
4314
4665
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
@@ -4318,24 +4669,29 @@ module Aws::RDS
4318
4669
  # Performance Insights data.
4319
4670
  #
4320
4671
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
4321
- # alias ARN, or alias name for the Amazon Web Services KMS customer
4322
- # master key (CMK).
4672
+ # alias ARN, or alias name for the KMS key.
4323
4673
  #
4324
4674
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
4325
- # Amazon RDS uses your default CMK. There is a default CMK for your
4326
- # Amazon Web Services account. Your Amazon Web Services account has a
4327
- # different default CMK for each Amazon Web Services Region.
4675
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
4676
+ # your Amazon Web Services account. Your Amazon Web Services account has
4677
+ # a different default KMS key for each Amazon Web Services Region.
4678
+ #
4679
+ # This setting doesn't apply to RDS Custom.
4328
4680
  #
4329
4681
  # @option params [Integer] :performance_insights_retention_period
4330
4682
  # The amount of time, in days, to retain Performance Insights data.
4331
4683
  # Valid values are 7 or 731 (2 years).
4332
4684
  #
4685
+ # This setting doesn't apply to RDS Custom.
4686
+ #
4333
4687
  # @option params [Array<String>] :enable_cloudwatch_logs_exports
4334
4688
  # The list of logs that the new DB instance is to export to CloudWatch
4335
4689
  # Logs. The values in the list depend on the DB engine being used. For
4336
4690
  # more information, see [Publishing Database Logs to Amazon CloudWatch
4337
4691
  # Logs ][1] in the *Amazon RDS User Guide*.
4338
4692
  #
4693
+ # This setting doesn't apply to RDS Custom.
4694
+ #
4339
4695
  #
4340
4696
  #
4341
4697
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -4344,10 +4700,14 @@ module Aws::RDS
4344
4700
  # The number of CPU cores and the number of threads per core for the DB
4345
4701
  # instance class of the DB instance.
4346
4702
  #
4703
+ # This setting doesn't apply to RDS Custom.
4704
+ #
4347
4705
  # @option params [Boolean] :use_default_processor_features
4348
4706
  # A value that indicates whether the DB instance class of the DB
4349
4707
  # instance uses its default processor features.
4350
4708
  #
4709
+ # This setting doesn't apply to RDS Custom.
4710
+ #
4351
4711
  # @option params [Boolean] :deletion_protection
4352
4712
  # A value that indicates whether the DB instance has deletion protection
4353
4713
  # enabled. The database can't be deleted when deletion protection is
@@ -4366,6 +4726,8 @@ module Aws::RDS
4366
4726
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
4367
4727
  # RDS User Guide*.
4368
4728
  #
4729
+ # This setting doesn't apply to RDS Custom.
4730
+ #
4369
4731
  #
4370
4732
  #
4371
4733
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -4374,6 +4736,8 @@ module Aws::RDS
4374
4736
  # Specify the name of the IAM role to be used when making API calls to
4375
4737
  # the Directory Service.
4376
4738
  #
4739
+ # This setting doesn't apply to RDS Custom.
4740
+ #
4377
4741
  # @option params [String] :replica_mode
4378
4742
  # The open mode of the replica database: mounted or read-only.
4379
4743
  #
@@ -4381,17 +4745,22 @@ module Aws::RDS
4381
4745
  #
4382
4746
  # </note>
4383
4747
  #
4384
- # Mounted DB replicas are included in Oracle Enterprise Edition. The
4385
- # main use case for mounted replicas is cross-Region disaster recovery.
4386
- # The primary database doesn't use Active Data Guard to transmit
4387
- # information to the mounted replica. Because it doesn't accept user
4388
- # connections, a mounted replica can't serve a read-only workload.
4748
+ # Mounted DB replicas are included in Oracle Database Enterprise
4749
+ # Edition. The main use case for mounted replicas is cross-Region
4750
+ # disaster recovery. The primary database doesn't use Active Data Guard
4751
+ # to transmit information to the mounted replica. Because it doesn't
4752
+ # accept user connections, a mounted replica can't serve a read-only
4753
+ # workload.
4389
4754
  #
4390
4755
  # You can create a combination of mounted and read-only DB replicas for
4391
4756
  # the same primary DB instance. For more information, see [Working with
4392
4757
  # Oracle Read Replicas for Amazon RDS][1] in the *Amazon RDS User
4393
4758
  # Guide*.
4394
4759
  #
4760
+ # For RDS Custom, you must specify this parameter and set it to
4761
+ # `mounted`. The value won't be set by default. After replica creation,
4762
+ # you can manage the open mode manually.
4763
+ #
4395
4764
  #
4396
4765
  #
4397
4766
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
@@ -4408,6 +4777,29 @@ module Aws::RDS
4408
4777
  #
4409
4778
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
4410
4779
  #
4780
+ # @option params [String] :custom_iam_instance_profile
4781
+ # The instance profile associated with the underlying Amazon EC2
4782
+ # instance of an RDS Custom DB instance. The instance profile must meet
4783
+ # the following requirements:
4784
+ #
4785
+ # * The profile must exist in your account.
4786
+ #
4787
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
4788
+ # assume.
4789
+ #
4790
+ # * The instance profile name and the associated IAM role name must
4791
+ # start with the prefix `AWSRDSCustom`.
4792
+ #
4793
+ # For the list of permissions required for the IAM role, see [ Configure
4794
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
4795
+ # Guide*.
4796
+ #
4797
+ # This setting is required for RDS Custom.
4798
+ #
4799
+ #
4800
+ #
4801
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
4802
+ #
4411
4803
  # @option params [String] :source_region
4412
4804
  # The source region of the snapshot. This is only needed when the
4413
4805
  # shapshot is encrypted and in a different region.
@@ -4488,6 +4880,7 @@ module Aws::RDS
4488
4880
  # domain_iam_role_name: "String",
4489
4881
  # replica_mode: "open-read-only", # accepts open-read-only, mounted
4490
4882
  # max_allocated_storage: 1,
4883
+ # custom_iam_instance_profile: "String",
4491
4884
  # source_region: "String",
4492
4885
  # })
4493
4886
  #
@@ -4549,6 +4942,8 @@ module Aws::RDS
4549
4942
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
4550
4943
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
4551
4944
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
4945
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
4946
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
4552
4947
  # resp.db_instance.latest_restorable_time #=> Time
4553
4948
  # resp.db_instance.multi_az #=> Boolean
4554
4949
  # resp.db_instance.engine_version #=> String
@@ -4623,6 +5018,10 @@ module Aws::RDS
4623
5018
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
4624
5019
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
4625
5020
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
5021
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
5022
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
5023
+ # resp.db_instance.custom_iam_instance_profile #=> String
5024
+ # resp.db_instance.backup_target #=> String
4626
5025
  #
4627
5026
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceReadReplica AWS API Documentation
4628
5027
  #
@@ -4638,13 +5037,15 @@ module Aws::RDS
4638
5037
  # A DB parameter group is initially created with the default parameters
4639
5038
  # for the database engine used by the DB instance. To provide custom
4640
5039
  # values for any of the parameters, you must modify the group after
4641
- # creating it using *ModifyDBParameterGroup*. Once you've created a DB
5040
+ # creating it using `ModifyDBParameterGroup`. Once you've created a DB
4642
5041
  # parameter group, you need to associate it with your DB instance using
4643
- # *ModifyDBInstance*. When you associate a new DB parameter group with a
5042
+ # `ModifyDBInstance`. When you associate a new DB parameter group with a
4644
5043
  # running DB instance, you need to reboot the DB instance without
4645
5044
  # failover for the new DB parameter group and associated settings to
4646
5045
  # take effect.
4647
5046
  #
5047
+ # This command doesn't apply to RDS Custom.
5048
+ #
4648
5049
  # After you create a DB parameter group, you should wait at least 5
4649
5050
  # minutes before creating your first DB instance that uses that DB
4650
5051
  # parameter group as the default parameter group. This allows Amazon RDS
@@ -5175,6 +5576,7 @@ module Aws::RDS
5175
5576
  # resp.db_snapshot.tag_list[0].key #=> String
5176
5577
  # resp.db_snapshot.tag_list[0].value #=> String
5177
5578
  # resp.db_snapshot.original_snapshot_create_time #=> Time
5579
+ # resp.db_snapshot.snapshot_target #=> String
5178
5580
  #
5179
5581
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSnapshot AWS API Documentation
5180
5582
  #
@@ -5523,6 +5925,8 @@ module Aws::RDS
5523
5925
 
5524
5926
  # Creates a new option group. You can create up to 20 option groups.
5525
5927
  #
5928
+ # This command doesn't apply to RDS Custom.
5929
+ #
5526
5930
  # @option params [required, String] :option_group_name
5527
5931
  # Specifies the name of the option group to be created.
5528
5932
  #
@@ -5699,6 +6103,136 @@ module Aws::RDS
5699
6103
  req.send_request(options)
5700
6104
  end
5701
6105
 
6106
+ # Deletes a custom engine version. To run this command, make sure you
6107
+ # meet the following prerequisites:
6108
+ #
6109
+ # * The CEV must not be the default for RDS Custom. If it is, change the
6110
+ # default before running this command.
6111
+ #
6112
+ # * The CEV must not be associated with an RDS Custom DB instance, RDS
6113
+ # Custom instance snapshot, or automated backup of your RDS Custom
6114
+ # instance.
6115
+ #
6116
+ # Typically, deletion takes a few minutes.
6117
+ #
6118
+ # <note markdown="1"> The MediaImport service that imports files from Amazon S3 to create
6119
+ # CEVs isn't integrated with Amazon Web Services CloudTrail. If you
6120
+ # turn on data logging for Amazon RDS in CloudTrail, calls to the
6121
+ # `DeleteCustomDbEngineVersion` event aren't logged. However, you might
6122
+ # see calls from the API gateway that accesses your Amazon S3 bucket.
6123
+ # These calls originate from the MediaImport service for the
6124
+ # `DeleteCustomDbEngineVersion` event.
6125
+ #
6126
+ # </note>
6127
+ #
6128
+ # For more information, see [ Deleting a CEV][1] in the *Amazon RDS User
6129
+ # Guide*.
6130
+ #
6131
+ #
6132
+ #
6133
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.delete
6134
+ #
6135
+ # @option params [required, String] :engine
6136
+ # The database engine. The only supported engine is `custom-oracle-ee`.
6137
+ #
6138
+ # @option params [required, String] :engine_version
6139
+ # The custom engine version (CEV) for your DB instance. This option is
6140
+ # required for RDS Custom, but optional for Amazon RDS. The combination
6141
+ # of `Engine` and `EngineVersion` is unique per customer per Amazon Web
6142
+ # Services Region.
6143
+ #
6144
+ # @return [Types::DBEngineVersion] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6145
+ #
6146
+ # * {Types::DBEngineVersion#engine #engine} => String
6147
+ # * {Types::DBEngineVersion#engine_version #engine_version} => String
6148
+ # * {Types::DBEngineVersion#db_parameter_group_family #db_parameter_group_family} => String
6149
+ # * {Types::DBEngineVersion#db_engine_description #db_engine_description} => String
6150
+ # * {Types::DBEngineVersion#db_engine_version_description #db_engine_version_description} => String
6151
+ # * {Types::DBEngineVersion#default_character_set #default_character_set} => Types::CharacterSet
6152
+ # * {Types::DBEngineVersion#supported_character_sets #supported_character_sets} => Array&lt;Types::CharacterSet&gt;
6153
+ # * {Types::DBEngineVersion#supported_nchar_character_sets #supported_nchar_character_sets} => Array&lt;Types::CharacterSet&gt;
6154
+ # * {Types::DBEngineVersion#valid_upgrade_target #valid_upgrade_target} => Array&lt;Types::UpgradeTarget&gt;
6155
+ # * {Types::DBEngineVersion#supported_timezones #supported_timezones} => Array&lt;Types::Timezone&gt;
6156
+ # * {Types::DBEngineVersion#exportable_log_types #exportable_log_types} => Array&lt;String&gt;
6157
+ # * {Types::DBEngineVersion#supports_log_exports_to_cloudwatch_logs #supports_log_exports_to_cloudwatch_logs} => Boolean
6158
+ # * {Types::DBEngineVersion#supports_read_replica #supports_read_replica} => Boolean
6159
+ # * {Types::DBEngineVersion#supported_engine_modes #supported_engine_modes} => Array&lt;String&gt;
6160
+ # * {Types::DBEngineVersion#supported_feature_names #supported_feature_names} => Array&lt;String&gt;
6161
+ # * {Types::DBEngineVersion#status #status} => String
6162
+ # * {Types::DBEngineVersion#supports_parallel_query #supports_parallel_query} => Boolean
6163
+ # * {Types::DBEngineVersion#supports_global_databases #supports_global_databases} => Boolean
6164
+ # * {Types::DBEngineVersion#major_engine_version #major_engine_version} => String
6165
+ # * {Types::DBEngineVersion#database_installation_files_s3_bucket_name #database_installation_files_s3_bucket_name} => String
6166
+ # * {Types::DBEngineVersion#database_installation_files_s3_prefix #database_installation_files_s3_prefix} => String
6167
+ # * {Types::DBEngineVersion#db_engine_version_arn #db_engine_version_arn} => String
6168
+ # * {Types::DBEngineVersion#kms_key_id #kms_key_id} => String
6169
+ # * {Types::DBEngineVersion#create_time #create_time} => Time
6170
+ # * {Types::DBEngineVersion#tag_list #tag_list} => Array&lt;Types::Tag&gt;
6171
+ #
6172
+ # @example Request syntax with placeholder values
6173
+ #
6174
+ # resp = client.delete_custom_db_engine_version({
6175
+ # engine: "CustomEngineName", # required
6176
+ # engine_version: "CustomEngineVersion", # required
6177
+ # })
6178
+ #
6179
+ # @example Response structure
6180
+ #
6181
+ # resp.engine #=> String
6182
+ # resp.engine_version #=> String
6183
+ # resp.db_parameter_group_family #=> String
6184
+ # resp.db_engine_description #=> String
6185
+ # resp.db_engine_version_description #=> String
6186
+ # resp.default_character_set.character_set_name #=> String
6187
+ # resp.default_character_set.character_set_description #=> String
6188
+ # resp.supported_character_sets #=> Array
6189
+ # resp.supported_character_sets[0].character_set_name #=> String
6190
+ # resp.supported_character_sets[0].character_set_description #=> String
6191
+ # resp.supported_nchar_character_sets #=> Array
6192
+ # resp.supported_nchar_character_sets[0].character_set_name #=> String
6193
+ # resp.supported_nchar_character_sets[0].character_set_description #=> String
6194
+ # resp.valid_upgrade_target #=> Array
6195
+ # resp.valid_upgrade_target[0].engine #=> String
6196
+ # resp.valid_upgrade_target[0].engine_version #=> String
6197
+ # resp.valid_upgrade_target[0].description #=> String
6198
+ # resp.valid_upgrade_target[0].auto_upgrade #=> Boolean
6199
+ # resp.valid_upgrade_target[0].is_major_version_upgrade #=> Boolean
6200
+ # resp.valid_upgrade_target[0].supported_engine_modes #=> Array
6201
+ # resp.valid_upgrade_target[0].supported_engine_modes[0] #=> String
6202
+ # resp.valid_upgrade_target[0].supports_parallel_query #=> Boolean
6203
+ # resp.valid_upgrade_target[0].supports_global_databases #=> Boolean
6204
+ # resp.supported_timezones #=> Array
6205
+ # resp.supported_timezones[0].timezone_name #=> String
6206
+ # resp.exportable_log_types #=> Array
6207
+ # resp.exportable_log_types[0] #=> String
6208
+ # resp.supports_log_exports_to_cloudwatch_logs #=> Boolean
6209
+ # resp.supports_read_replica #=> Boolean
6210
+ # resp.supported_engine_modes #=> Array
6211
+ # resp.supported_engine_modes[0] #=> String
6212
+ # resp.supported_feature_names #=> Array
6213
+ # resp.supported_feature_names[0] #=> String
6214
+ # resp.status #=> String
6215
+ # resp.supports_parallel_query #=> Boolean
6216
+ # resp.supports_global_databases #=> Boolean
6217
+ # resp.major_engine_version #=> String
6218
+ # resp.database_installation_files_s3_bucket_name #=> String
6219
+ # resp.database_installation_files_s3_prefix #=> String
6220
+ # resp.db_engine_version_arn #=> String
6221
+ # resp.kms_key_id #=> String
6222
+ # resp.create_time #=> Time
6223
+ # resp.tag_list #=> Array
6224
+ # resp.tag_list[0].key #=> String
6225
+ # resp.tag_list[0].value #=> String
6226
+ #
6227
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteCustomDBEngineVersion AWS API Documentation
6228
+ #
6229
+ # @overload delete_custom_db_engine_version(params = {})
6230
+ # @param [Hash] params ({})
6231
+ def delete_custom_db_engine_version(params = {}, options = {})
6232
+ req = build_request(:delete_custom_db_engine_version, params)
6233
+ req.send_request(options)
6234
+ end
6235
+
5702
6236
  # The DeleteDBCluster action deletes a previously provisioned DB
5703
6237
  # cluster. When you delete a DB cluster, all automated backups for that
5704
6238
  # DB cluster are deleted and can't be recovered. Manual DB cluster
@@ -6124,31 +6658,37 @@ module Aws::RDS
6124
6658
  #
6125
6659
  # @option params [Boolean] :skip_final_snapshot
6126
6660
  # A value that indicates whether to skip the creation of a final DB
6127
- # snapshot before the DB instance is deleted. If skip is specified, no
6128
- # DB snapshot is created. If skip isn't specified, a DB snapshot is
6129
- # created before the DB instance is deleted. By default, skip isn't
6130
- # specified, and the DB snapshot is created.
6661
+ # snapshot before deleting the instance. If you enable this parameter,
6662
+ # RDS doesn't create a DB snapshot. If you don't enable this
6663
+ # parameter, RDS creates a DB snapshot before the DB instance is
6664
+ # deleted. By default, skip isn't enabled, and the DB snapshot is
6665
+ # created.
6666
+ #
6667
+ # <note markdown="1"> If you don't enable this parameter, you must specify the
6668
+ # `FinalDBSnapshotIdentifier` parameter.
6131
6669
  #
6132
- # When a DB instance is in a failure state and has a status of
6133
- # 'failed', 'incompatible-restore', or 'incompatible-network', it
6134
- # can only be deleted when skip is specified.
6670
+ # </note>
6135
6671
  #
6136
- # Specify skip when deleting a read replica.
6672
+ # When a DB instance is in a failure state and has a status of `failed`,
6673
+ # `incompatible-restore`, or `incompatible-network`, RDS can delete the
6674
+ # instance only if you enable this parameter.
6137
6675
  #
6138
- # <note markdown="1"> The FinalDBSnapshotIdentifier parameter must be specified if skip
6139
- # isn't specified.
6676
+ # If you delete a read replica or an RDS Custom instance, you must
6677
+ # enable this setting.
6140
6678
  #
6141
- # </note>
6679
+ # This setting is required for RDS Custom.
6142
6680
  #
6143
6681
  # @option params [String] :final_db_snapshot_identifier
6144
6682
  # The `DBSnapshotIdentifier` of the new `DBSnapshot` created when the
6145
6683
  # `SkipFinalSnapshot` parameter is disabled.
6146
6684
  #
6147
- # <note markdown="1"> Specifying this parameter and also specifying to skip final DB
6148
- # snapshot creation in SkipFinalShapshot results in an error.
6685
+ # <note markdown="1"> If you enable this parameter and also enable SkipFinalShapshot, the
6686
+ # command results in an error.
6149
6687
  #
6150
6688
  # </note>
6151
6689
  #
6690
+ # This setting doesn't apply to RDS Custom.
6691
+ #
6152
6692
  # Constraints:
6153
6693
  #
6154
6694
  # * Must be 1 to 255 letters or numbers.
@@ -6252,6 +6792,8 @@ module Aws::RDS
6252
6792
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
6253
6793
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
6254
6794
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
6795
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
6796
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
6255
6797
  # resp.db_instance.latest_restorable_time #=> Time
6256
6798
  # resp.db_instance.multi_az #=> Boolean
6257
6799
  # resp.db_instance.engine_version #=> String
@@ -6326,6 +6868,10 @@ module Aws::RDS
6326
6868
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
6327
6869
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
6328
6870
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
6871
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
6872
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
6873
+ # resp.db_instance.custom_iam_instance_profile #=> String
6874
+ # resp.db_instance.backup_target #=> String
6329
6875
  #
6330
6876
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstance AWS API Documentation
6331
6877
  #
@@ -6349,6 +6895,8 @@ module Aws::RDS
6349
6895
  # example,
6350
6896
  # `arn:aws:rds:us-east-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
6351
6897
  #
6898
+ # This setting doesn't apply to RDS Custom.
6899
+ #
6352
6900
  # @return [Types::DeleteDBInstanceAutomatedBackupResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6353
6901
  #
6354
6902
  # * {Types::DeleteDBInstanceAutomatedBackupResult#db_instance_automated_backup #db_instance_automated_backup} => Types::DBInstanceAutomatedBackup
@@ -6390,6 +6938,7 @@ module Aws::RDS
6390
6938
  # resp.db_instance_automated_backup.db_instance_automated_backups_arn #=> String
6391
6939
  # resp.db_instance_automated_backup.db_instance_automated_backups_replications #=> Array
6392
6940
  # resp.db_instance_automated_backup.db_instance_automated_backups_replications[0].db_instance_automated_backups_arn #=> String
6941
+ # resp.db_instance_automated_backup.backup_target #=> String
6393
6942
  #
6394
6943
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstanceAutomatedBackup AWS API Documentation
6395
6944
  #
@@ -6657,6 +7206,7 @@ module Aws::RDS
6657
7206
  # resp.db_snapshot.tag_list[0].key #=> String
6658
7207
  # resp.db_snapshot.tag_list[0].value #=> String
6659
7208
  # resp.db_snapshot.original_snapshot_create_time #=> Time
7209
+ # resp.db_snapshot.snapshot_target #=> String
6660
7210
  #
6661
7211
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBSnapshot AWS API Documentation
6662
7212
  #
@@ -8117,6 +8667,10 @@ module Aws::RDS
8117
8667
  # `CharacterSetName` parameter for `CreateDBInstance`, the response
8118
8668
  # includes a list of supported character sets for each engine version.
8119
8669
  #
8670
+ # For RDS Custom, the default is not to list supported character sets.
8671
+ # If you set `ListSupportedCharacterSets` to `true`, RDS Custom returns
8672
+ # no results.
8673
+ #
8120
8674
  # @option params [Boolean] :list_supported_timezones
8121
8675
  # A value that indicates whether to list the supported time zones for
8122
8676
  # each engine version.
@@ -8125,6 +8679,10 @@ module Aws::RDS
8125
8679
  # `TimeZone` parameter for `CreateDBInstance`, the response includes a
8126
8680
  # list of supported time zones for each engine version.
8127
8681
  #
8682
+ # For RDS Custom, the default is not to list supported time zones. If
8683
+ # you set `ListSupportedTimezones` to `true`, RDS Custom returns no
8684
+ # results.
8685
+ #
8128
8686
  # @option params [Boolean] :include_all
8129
8687
  # A value that indicates whether to include engine versions that aren't
8130
8688
  # available in the list. The default is to list only available engine
@@ -8214,6 +8772,15 @@ module Aws::RDS
8214
8772
  # resp.db_engine_versions[0].status #=> String
8215
8773
  # resp.db_engine_versions[0].supports_parallel_query #=> Boolean
8216
8774
  # resp.db_engine_versions[0].supports_global_databases #=> Boolean
8775
+ # resp.db_engine_versions[0].major_engine_version #=> String
8776
+ # resp.db_engine_versions[0].database_installation_files_s3_bucket_name #=> String
8777
+ # resp.db_engine_versions[0].database_installation_files_s3_prefix #=> String
8778
+ # resp.db_engine_versions[0].db_engine_version_arn #=> String
8779
+ # resp.db_engine_versions[0].kms_key_id #=> String
8780
+ # resp.db_engine_versions[0].create_time #=> Time
8781
+ # resp.db_engine_versions[0].tag_list #=> Array
8782
+ # resp.db_engine_versions[0].tag_list[0].key #=> String
8783
+ # resp.db_engine_versions[0].tag_list[0].value #=> String
8217
8784
  #
8218
8785
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBEngineVersions AWS API Documentation
8219
8786
  #
@@ -8285,6 +8852,8 @@ module Aws::RDS
8285
8852
  # for example,
8286
8853
  # `arn:aws:rds:us-east-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
8287
8854
  #
8855
+ # This setting doesn't apply to RDS Custom.
8856
+ #
8288
8857
  # @return [Types::DBInstanceAutomatedBackupMessage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8289
8858
  #
8290
8859
  # * {Types::DBInstanceAutomatedBackupMessage#marker #marker} => String
@@ -8340,6 +8909,7 @@ module Aws::RDS
8340
8909
  # resp.db_instance_automated_backups[0].db_instance_automated_backups_arn #=> String
8341
8910
  # resp.db_instance_automated_backups[0].db_instance_automated_backups_replications #=> Array
8342
8911
  # resp.db_instance_automated_backups[0].db_instance_automated_backups_replications[0].db_instance_automated_backups_arn #=> String
8912
+ # resp.db_instance_automated_backups[0].backup_target #=> String
8343
8913
  #
8344
8914
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBInstanceAutomatedBackups AWS API Documentation
8345
8915
  #
@@ -8504,6 +9074,8 @@ module Aws::RDS
8504
9074
  # resp.db_instances[0].pending_modified_values.processor_features[0].name #=> String
8505
9075
  # resp.db_instances[0].pending_modified_values.processor_features[0].value #=> String
8506
9076
  # resp.db_instances[0].pending_modified_values.iam_database_authentication_enabled #=> Boolean
9077
+ # resp.db_instances[0].pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
9078
+ # resp.db_instances[0].pending_modified_values.resume_full_automation_mode_time #=> Time
8507
9079
  # resp.db_instances[0].latest_restorable_time #=> Time
8508
9080
  # resp.db_instances[0].multi_az #=> Boolean
8509
9081
  # resp.db_instances[0].engine_version #=> String
@@ -8578,6 +9150,10 @@ module Aws::RDS
8578
9150
  # resp.db_instances[0].activity_stream_kinesis_stream_name #=> String
8579
9151
  # resp.db_instances[0].activity_stream_mode #=> String, one of "sync", "async"
8580
9152
  # resp.db_instances[0].activity_stream_engine_native_audit_fields_included #=> Boolean
9153
+ # resp.db_instances[0].automation_mode #=> String, one of "full", "all-paused"
9154
+ # resp.db_instances[0].resume_full_automation_mode_time #=> Time
9155
+ # resp.db_instances[0].custom_iam_instance_profile #=> String
9156
+ # resp.db_instances[0].backup_target #=> String
8581
9157
  #
8582
9158
  #
8583
9159
  # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -8596,6 +9172,8 @@ module Aws::RDS
8596
9172
 
8597
9173
  # Returns a list of DB log files for the DB instance.
8598
9174
  #
9175
+ # This command doesn't apply to RDS Custom.
9176
+ #
8599
9177
  # @option params [required, String] :db_instance_identifier
8600
9178
  # The customer-assigned name of the DB instance that contains the log
8601
9179
  # files you want to list.
@@ -9441,6 +10019,8 @@ module Aws::RDS
9441
10019
  # manual DB snapshot from another Amazon Web Services account by using
9442
10020
  # the `ModifyDBSnapshotAttribute` API action.
9443
10021
  #
10022
+ # This setting doesn't apply to RDS Custom.
10023
+ #
9444
10024
  # @option params [Boolean] :include_public
9445
10025
  # A value that indicates whether to include manual DB cluster snapshots
9446
10026
  # that are public and can be copied or restored by any Amazon Web
@@ -9449,6 +10029,8 @@ module Aws::RDS
9449
10029
  # You can share a manual DB snapshot as public by using the
9450
10030
  # ModifyDBSnapshotAttribute API.
9451
10031
  #
10032
+ # This setting doesn't apply to RDS Custom.
10033
+ #
9452
10034
  # @option params [String] :dbi_resource_id
9453
10035
  # A specific DB resource ID to describe.
9454
10036
  #
@@ -9532,6 +10114,7 @@ module Aws::RDS
9532
10114
  # resp.db_snapshots[0].tag_list[0].key #=> String
9533
10115
  # resp.db_snapshots[0].tag_list[0].value #=> String
9534
10116
  # resp.db_snapshots[0].original_snapshot_create_time #=> Time
10117
+ # resp.db_snapshots[0].snapshot_target #=> String
9535
10118
  #
9536
10119
  #
9537
10120
  # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -10095,7 +10678,7 @@ module Aws::RDS
10095
10678
  #
10096
10679
  # resp = client.describe_events({
10097
10680
  # source_identifier: "String",
10098
- # source_type: "db-instance", # accepts db-instance, db-parameter-group, db-security-group, db-snapshot, db-cluster, db-cluster-snapshot
10681
+ # source_type: "db-instance", # accepts db-instance, db-parameter-group, db-security-group, db-snapshot, db-cluster, db-cluster-snapshot, custom-engine-version
10099
10682
  # start_time: Time.now,
10100
10683
  # end_time: Time.now,
10101
10684
  # duration: 1,
@@ -10115,7 +10698,7 @@ module Aws::RDS
10115
10698
  # resp.marker #=> String
10116
10699
  # resp.events #=> Array
10117
10700
  # resp.events[0].source_identifier #=> String
10118
- # resp.events[0].source_type #=> String, one of "db-instance", "db-parameter-group", "db-security-group", "db-snapshot", "db-cluster", "db-cluster-snapshot"
10701
+ # resp.events[0].source_type #=> String, one of "db-instance", "db-parameter-group", "db-security-group", "db-snapshot", "db-cluster", "db-cluster-snapshot", "custom-engine-version"
10119
10702
  # resp.events[0].message #=> String
10120
10703
  # resp.events[0].event_categories #=> Array
10121
10704
  # resp.events[0].event_categories[0] #=> String
@@ -10155,8 +10738,20 @@ module Aws::RDS
10155
10738
  # * `source-arn` - The Amazon Resource Name (ARN) of the snapshot
10156
10739
  # exported to Amazon S3
10157
10740
  #
10158
- # * `status` - The status of the export task. Must be lowercase, for
10159
- # example, `complete`.
10741
+ # * `status` - The status of the export task. Must be lowercase. Valid
10742
+ # statuses are the following:
10743
+ #
10744
+ # * `canceled`
10745
+ #
10746
+ # * `canceling`
10747
+ #
10748
+ # * `complete`
10749
+ #
10750
+ # * `failed`
10751
+ #
10752
+ # * `in_progress`
10753
+ #
10754
+ # * `starting`
10160
10755
  #
10161
10756
  # @option params [String] :marker
10162
10757
  # An optional pagination token provided by a previous
@@ -10718,6 +11313,8 @@ module Aws::RDS
10718
11313
  # The license model filter value. Specify this parameter to show only
10719
11314
  # the available offerings matching the specified license model.
10720
11315
  #
11316
+ # RDS Custom supports only the BYOL licensing model.
11317
+ #
10721
11318
  # @option params [String] :availability_zone_group
10722
11319
  # The Availability Zone group associated with a Local Zone. Specify this
10723
11320
  # parameter to retrieve available offerings for the Local Zones in the
@@ -10726,8 +11323,14 @@ module Aws::RDS
10726
11323
  # Omit this parameter to show the available offerings in the specified
10727
11324
  # Amazon Web Services Region.
10728
11325
  #
11326
+ # This setting doesn't apply to RDS Custom.
11327
+ #
10729
11328
  # @option params [Boolean] :vpc
10730
11329
  # A value that indicates whether to show only VPC or non-VPC offerings.
11330
+ # RDS Custom supports only VPC offerings.
11331
+ #
11332
+ # RDS Custom supports only VPC offerings. If you describe non-VPC
11333
+ # offerings for RDS Custom, the output shows VPC offerings.
10731
11334
  #
10732
11335
  # @option params [Array<Types::Filter>] :filters
10733
11336
  # This parameter isn't currently supported.
@@ -11341,6 +11944,8 @@ module Aws::RDS
11341
11944
  # modifications you can make to your DB instance. You can use this
11342
11945
  # information when you call `ModifyDBInstance`.
11343
11946
  #
11947
+ # This command doesn't apply to RDS Custom.
11948
+ #
11344
11949
  # @option params [required, String] :db_instance_identifier
11345
11950
  # The customer identifier or the ARN of your DB instance.
11346
11951
  #
@@ -11387,6 +11992,8 @@ module Aws::RDS
11387
11992
  # Downloads all or a portion of the specified log file, up to 1 MB in
11388
11993
  # size.
11389
11994
  #
11995
+ # This command doesn't apply to RDS Custom.
11996
+ #
11390
11997
  # @option params [required, String] :db_instance_identifier
11391
11998
  # The customer-assigned name of the DB instance that contains the log
11392
11999
  # files you want to list.
@@ -12078,6 +12685,154 @@ module Aws::RDS
12078
12685
  req.send_request(options)
12079
12686
  end
12080
12687
 
12688
+ # Modifies the status of a custom engine version (CEV). You can find
12689
+ # CEVs to modify by calling `DescribeDBEngineVersions`.
12690
+ #
12691
+ # <note markdown="1"> The MediaImport service that imports files from Amazon S3 to create
12692
+ # CEVs isn't integrated with Amazon Web Services CloudTrail. If you
12693
+ # turn on data logging for Amazon RDS in CloudTrail, calls to the
12694
+ # `ModifyCustomDbEngineVersion` event aren't logged. However, you might
12695
+ # see calls from the API gateway that accesses your Amazon S3 bucket.
12696
+ # These calls originate from the MediaImport service for the
12697
+ # `ModifyCustomDbEngineVersion` event.
12698
+ #
12699
+ # </note>
12700
+ #
12701
+ # For more information, see [Modifying CEV status][1] in the *Amazon RDS
12702
+ # User Guide*.
12703
+ #
12704
+ #
12705
+ #
12706
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.modify
12707
+ #
12708
+ # @option params [required, String] :engine
12709
+ # The DB engine. The only supported value is `custom-oracle-ee`.
12710
+ #
12711
+ # @option params [required, String] :engine_version
12712
+ # The custom engine version (CEV) that you want to modify. This option
12713
+ # is required for RDS Custom, but optional for Amazon RDS. The
12714
+ # combination of `Engine` and `EngineVersion` is unique per customer per
12715
+ # Amazon Web Services Region.
12716
+ #
12717
+ # @option params [String] :description
12718
+ # An optional description of your CEV.
12719
+ #
12720
+ # @option params [String] :status
12721
+ # The availability status to be assigned to the CEV. Valid values are as
12722
+ # follows:
12723
+ #
12724
+ # available
12725
+ #
12726
+ # : You can use this CEV to create a new RDS Custom DB instance.
12727
+ #
12728
+ # inactive
12729
+ #
12730
+ # : You can create a new RDS Custom instance by restoring a DB snapshot
12731
+ # with this CEV. You can't patch or create new instances with this
12732
+ # CEV.
12733
+ #
12734
+ # You can change any status to any status. A typical reason to change
12735
+ # status is to prevent the accidental use of a CEV, or to make a
12736
+ # deprecated CEV eligible for use again. For example, you might change
12737
+ # the status of your CEV from `available` to `inactive`, and from
12738
+ # `inactive` back to `available`. To change the availability status of
12739
+ # the CEV, it must not currently be in use by an RDS Custom instance,
12740
+ # snapshot, or automated backup.
12741
+ #
12742
+ # @return [Types::DBEngineVersion] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
12743
+ #
12744
+ # * {Types::DBEngineVersion#engine #engine} => String
12745
+ # * {Types::DBEngineVersion#engine_version #engine_version} => String
12746
+ # * {Types::DBEngineVersion#db_parameter_group_family #db_parameter_group_family} => String
12747
+ # * {Types::DBEngineVersion#db_engine_description #db_engine_description} => String
12748
+ # * {Types::DBEngineVersion#db_engine_version_description #db_engine_version_description} => String
12749
+ # * {Types::DBEngineVersion#default_character_set #default_character_set} => Types::CharacterSet
12750
+ # * {Types::DBEngineVersion#supported_character_sets #supported_character_sets} => Array&lt;Types::CharacterSet&gt;
12751
+ # * {Types::DBEngineVersion#supported_nchar_character_sets #supported_nchar_character_sets} => Array&lt;Types::CharacterSet&gt;
12752
+ # * {Types::DBEngineVersion#valid_upgrade_target #valid_upgrade_target} => Array&lt;Types::UpgradeTarget&gt;
12753
+ # * {Types::DBEngineVersion#supported_timezones #supported_timezones} => Array&lt;Types::Timezone&gt;
12754
+ # * {Types::DBEngineVersion#exportable_log_types #exportable_log_types} => Array&lt;String&gt;
12755
+ # * {Types::DBEngineVersion#supports_log_exports_to_cloudwatch_logs #supports_log_exports_to_cloudwatch_logs} => Boolean
12756
+ # * {Types::DBEngineVersion#supports_read_replica #supports_read_replica} => Boolean
12757
+ # * {Types::DBEngineVersion#supported_engine_modes #supported_engine_modes} => Array&lt;String&gt;
12758
+ # * {Types::DBEngineVersion#supported_feature_names #supported_feature_names} => Array&lt;String&gt;
12759
+ # * {Types::DBEngineVersion#status #status} => String
12760
+ # * {Types::DBEngineVersion#supports_parallel_query #supports_parallel_query} => Boolean
12761
+ # * {Types::DBEngineVersion#supports_global_databases #supports_global_databases} => Boolean
12762
+ # * {Types::DBEngineVersion#major_engine_version #major_engine_version} => String
12763
+ # * {Types::DBEngineVersion#database_installation_files_s3_bucket_name #database_installation_files_s3_bucket_name} => String
12764
+ # * {Types::DBEngineVersion#database_installation_files_s3_prefix #database_installation_files_s3_prefix} => String
12765
+ # * {Types::DBEngineVersion#db_engine_version_arn #db_engine_version_arn} => String
12766
+ # * {Types::DBEngineVersion#kms_key_id #kms_key_id} => String
12767
+ # * {Types::DBEngineVersion#create_time #create_time} => Time
12768
+ # * {Types::DBEngineVersion#tag_list #tag_list} => Array&lt;Types::Tag&gt;
12769
+ #
12770
+ # @example Request syntax with placeholder values
12771
+ #
12772
+ # resp = client.modify_custom_db_engine_version({
12773
+ # engine: "CustomEngineName", # required
12774
+ # engine_version: "CustomEngineVersion", # required
12775
+ # description: "Description",
12776
+ # status: "available", # accepts available, inactive, inactive-except-restore
12777
+ # })
12778
+ #
12779
+ # @example Response structure
12780
+ #
12781
+ # resp.engine #=> String
12782
+ # resp.engine_version #=> String
12783
+ # resp.db_parameter_group_family #=> String
12784
+ # resp.db_engine_description #=> String
12785
+ # resp.db_engine_version_description #=> String
12786
+ # resp.default_character_set.character_set_name #=> String
12787
+ # resp.default_character_set.character_set_description #=> String
12788
+ # resp.supported_character_sets #=> Array
12789
+ # resp.supported_character_sets[0].character_set_name #=> String
12790
+ # resp.supported_character_sets[0].character_set_description #=> String
12791
+ # resp.supported_nchar_character_sets #=> Array
12792
+ # resp.supported_nchar_character_sets[0].character_set_name #=> String
12793
+ # resp.supported_nchar_character_sets[0].character_set_description #=> String
12794
+ # resp.valid_upgrade_target #=> Array
12795
+ # resp.valid_upgrade_target[0].engine #=> String
12796
+ # resp.valid_upgrade_target[0].engine_version #=> String
12797
+ # resp.valid_upgrade_target[0].description #=> String
12798
+ # resp.valid_upgrade_target[0].auto_upgrade #=> Boolean
12799
+ # resp.valid_upgrade_target[0].is_major_version_upgrade #=> Boolean
12800
+ # resp.valid_upgrade_target[0].supported_engine_modes #=> Array
12801
+ # resp.valid_upgrade_target[0].supported_engine_modes[0] #=> String
12802
+ # resp.valid_upgrade_target[0].supports_parallel_query #=> Boolean
12803
+ # resp.valid_upgrade_target[0].supports_global_databases #=> Boolean
12804
+ # resp.supported_timezones #=> Array
12805
+ # resp.supported_timezones[0].timezone_name #=> String
12806
+ # resp.exportable_log_types #=> Array
12807
+ # resp.exportable_log_types[0] #=> String
12808
+ # resp.supports_log_exports_to_cloudwatch_logs #=> Boolean
12809
+ # resp.supports_read_replica #=> Boolean
12810
+ # resp.supported_engine_modes #=> Array
12811
+ # resp.supported_engine_modes[0] #=> String
12812
+ # resp.supported_feature_names #=> Array
12813
+ # resp.supported_feature_names[0] #=> String
12814
+ # resp.status #=> String
12815
+ # resp.supports_parallel_query #=> Boolean
12816
+ # resp.supports_global_databases #=> Boolean
12817
+ # resp.major_engine_version #=> String
12818
+ # resp.database_installation_files_s3_bucket_name #=> String
12819
+ # resp.database_installation_files_s3_prefix #=> String
12820
+ # resp.db_engine_version_arn #=> String
12821
+ # resp.kms_key_id #=> String
12822
+ # resp.create_time #=> Time
12823
+ # resp.tag_list #=> Array
12824
+ # resp.tag_list[0].key #=> String
12825
+ # resp.tag_list[0].value #=> String
12826
+ #
12827
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyCustomDBEngineVersion AWS API Documentation
12828
+ #
12829
+ # @overload modify_custom_db_engine_version(params = {})
12830
+ # @param [Hash] params ({})
12831
+ def modify_custom_db_engine_version(params = {}, options = {})
12832
+ req = build_request(:modify_custom_db_engine_version, params)
12833
+ req.send_request(options)
12834
+ end
12835
+
12081
12836
  # Modify a setting for an Amazon Aurora DB cluster. You can change one
12082
12837
  # or more database configuration parameters by specifying these
12083
12838
  # parameters and the new values in the request. For more information on
@@ -12872,12 +13627,14 @@ module Aws::RDS
12872
13627
  # `db.m4.large`. Not all DB instance classes are available in all Amazon
12873
13628
  # Web Services Regions, or for all database engines. For the full list
12874
13629
  # of DB instance classes, and availability for your engine, see [DB
12875
- # Instance Class][1] in the *Amazon RDS User Guide.*
13630
+ # Instance Class][1] in the *Amazon RDS User Guide*.
12876
13631
  #
12877
13632
  # If you modify the DB instance class, an outage occurs during the
12878
13633
  # change. The change is applied during the next maintenance window,
12879
13634
  # unless `ApplyImmediately` is enabled for this request.
12880
13635
  #
13636
+ # This setting doesn't apply to RDS Custom.
13637
+ #
12881
13638
  # Default: Uses existing setting
12882
13639
  #
12883
13640
  #
@@ -12889,12 +13646,14 @@ module Aws::RDS
12889
13646
  # parameter to move your DB instance to a different VPC. If your DB
12890
13647
  # instance isn't in a VPC, you can also use this parameter to move your
12891
13648
  # DB instance into a VPC. For more information, see [Working with a DB
12892
- # instance in a VPC][1] in the *Amazon RDS User Guide.*
13649
+ # instance in a VPC][1] in the *Amazon RDS User Guide*.
12893
13650
  #
12894
13651
  # Changing the subnet group causes an outage during the change. The
12895
13652
  # change is applied during the next maintenance window, unless you
12896
13653
  # enable `ApplyImmediately`.
12897
13654
  #
13655
+ # This parameter doesn't apply to RDS Custom.
13656
+ #
12898
13657
  # Constraints: If supplied, must match the name of an existing
12899
13658
  # DBSubnetGroup.
12900
13659
  #
@@ -12909,6 +13668,8 @@ module Aws::RDS
12909
13668
  # Changing this setting doesn't result in an outage and the change is
12910
13669
  # asynchronously applied as soon as possible.
12911
13670
  #
13671
+ # This setting doesn't apply to RDS Custom.
13672
+ #
12912
13673
  # Constraints:
12913
13674
  #
12914
13675
  # * If supplied, must match existing DBSecurityGroups.
@@ -12916,8 +13677,10 @@ module Aws::RDS
12916
13677
  # ^
12917
13678
  #
12918
13679
  # @option params [Array<String>] :vpc_security_group_ids
12919
- # A list of EC2 VPC security groups to authorize on this DB instance.
12920
- # This change is asynchronously applied as soon as possible.
13680
+ # A list of Amazon EC2 VPC security groups to authorize on this DB
13681
+ # instance. This change is asynchronously applied as soon as possible.
13682
+ #
13683
+ # This setting doesn't apply to RDS Custom.
12921
13684
  #
12922
13685
  # **Amazon Aurora**
12923
13686
  #
@@ -12959,6 +13722,8 @@ module Aws::RDS
12959
13722
  # element exists in the `PendingModifiedValues` element of the operation
12960
13723
  # response.
12961
13724
  #
13725
+ # This setting doesn't apply to RDS Custom.
13726
+ #
12962
13727
  # **Amazon Aurora**
12963
13728
  #
12964
13729
  # Not applicable. The password for the master user is managed by the DB
@@ -12995,17 +13760,22 @@ module Aws::RDS
12995
13760
  #
12996
13761
  # @option params [String] :db_parameter_group_name
12997
13762
  # The name of the DB parameter group to apply to the DB instance.
13763
+ #
12998
13764
  # Changing this setting doesn't result in an outage. The parameter
12999
13765
  # group name itself is changed immediately, but the actual parameter
13000
13766
  # changes are not applied until you reboot the instance without
13001
- # failover. In this case, the DB instance isn't rebooted automatically
13002
- # and the parameter changes isn't applied during the next maintenance
13003
- # window.
13767
+ # failover. In this case, the DB instance isn't rebooted automatically,
13768
+ # and the parameter changes aren't applied during the next maintenance
13769
+ # window. However, if you modify dynamic parameters in the newly
13770
+ # associated DB parameter group, these changes are applied immediately
13771
+ # without a reboot.
13772
+ #
13773
+ # This setting doesn't apply to RDS Custom.
13004
13774
  #
13005
13775
  # Default: Uses existing setting
13006
13776
  #
13007
13777
  # Constraints: The DB parameter group must be in the same DB parameter
13008
- # group family as this DB instance.
13778
+ # group family as the DB instance.
13009
13779
  #
13010
13780
  # @option params [Integer] :backup_retention_period
13011
13781
  # The number of days to retain automated backups. Setting this parameter
@@ -13032,15 +13802,15 @@ module Aws::RDS
13032
13802
  #
13033
13803
  # Constraints:
13034
13804
  #
13035
- # * Must be a value from 0 to 35
13036
- #
13037
- # * Can be specified for a MySQL read replica only if the source is
13038
- # running MySQL 5.6 or later
13805
+ # * It must be a value from 0 to 35. It can't be set to 0 if the DB
13806
+ # instance is a source to read replicas. It can't be set to 0 or 35
13807
+ # for an RDS Custom DB instance.
13039
13808
  #
13040
- # * Can be specified for a PostgreSQL read replica only if the source is
13041
- # running PostgreSQL 9.3.5
13809
+ # * It can be specified for a MySQL read replica only if the source is
13810
+ # running MySQL 5.6 or later.
13042
13811
  #
13043
- # * Can't be set to 0 if the DB instance is a source to read replicas
13812
+ # * It can be specified for a PostgreSQL read replica only if the source
13813
+ # is running PostgreSQL 9.3.5.
13044
13814
  #
13045
13815
  # @option params [String] :preferred_backup_window
13046
13816
  # The daily time range during which automated backups are created if
@@ -13099,10 +13869,12 @@ module Aws::RDS
13099
13869
  #
13100
13870
  # @option params [Boolean] :multi_az
13101
13871
  # A value that indicates whether the DB instance is a Multi-AZ
13102
- # deployment. Changing this parameter doesn't result in an outage and
13103
- # the change is applied during the next maintenance window unless the
13872
+ # deployment. Changing this parameter doesn't result in an outage. The
13873
+ # change is applied during the next maintenance window unless the
13104
13874
  # `ApplyImmediately` parameter is enabled for this request.
13105
13875
  #
13876
+ # This setting doesn't apply to RDS Custom.
13877
+ #
13106
13878
  # @option params [String] :engine_version
13107
13879
  # The version number of the database engine to upgrade to. Changing this
13108
13880
  # parameter results in an outage and the change is applied during the
@@ -13119,27 +13891,42 @@ module Aws::RDS
13119
13891
  # lower. For information about valid engine versions, see
13120
13892
  # `CreateDBInstance`, or call `DescribeDBEngineVersions`.
13121
13893
  #
13894
+ # In RDS Custom, this parameter is supported for read replicas only if
13895
+ # they are in the `PATCH_DB_FAILURE` lifecycle.
13896
+ #
13122
13897
  # @option params [Boolean] :allow_major_version_upgrade
13123
13898
  # A value that indicates whether major version upgrades are allowed.
13124
13899
  # Changing this parameter doesn't result in an outage and the change is
13125
13900
  # asynchronously applied as soon as possible.
13126
13901
  #
13902
+ # This setting doesn't apply to RDS Custom.
13903
+ #
13127
13904
  # Constraints: Major version upgrades must be allowed when specifying a
13128
13905
  # value for the EngineVersion parameter that is a different major
13129
13906
  # version than the DB instance's current version.
13130
13907
  #
13131
13908
  # @option params [Boolean] :auto_minor_version_upgrade
13132
13909
  # A value that indicates whether minor version upgrades are applied
13133
- # automatically to the DB instance during the maintenance window.
13134
- # Changing this parameter doesn't result in an outage except in the
13135
- # following case and the change is asynchronously applied as soon as
13136
- # possible. An outage results if this parameter is enabled during the
13137
- # maintenance window, and a newer minor version is available, and RDS
13138
- # has enabled auto patching for that engine version.
13910
+ # automatically to the DB instance during the maintenance window. An
13911
+ # outage occurs when all the following conditions are met:
13912
+ #
13913
+ # * The automatic upgrade is enabled for the maintenance window.
13914
+ #
13915
+ # * A newer minor version is available.
13916
+ #
13917
+ # * RDS has enabled automatic patching for the engine version.
13918
+ #
13919
+ # If any of the preceding conditions isn't met, RDS applies the change
13920
+ # as soon as possible and doesn't cause an outage.
13921
+ #
13922
+ # For an RDS Custom DB instance, set `AutoMinorVersionUpgrade` to
13923
+ # `false`. Otherwise, the operation returns an error.
13139
13924
  #
13140
13925
  # @option params [String] :license_model
13141
13926
  # The license model for the DB instance.
13142
13927
  #
13928
+ # This setting doesn't apply to RDS Custom.
13929
+ #
13143
13930
  # Valid values: `license-included` \| `bring-your-own-license` \|
13144
13931
  # `general-public-license`
13145
13932
  #
@@ -13178,18 +13965,23 @@ module Aws::RDS
13178
13965
  #
13179
13966
  # @option params [String] :option_group_name
13180
13967
  # A value that indicates the DB instance should be associated with the
13181
- # specified option group. Changing this parameter doesn't result in an
13182
- # outage except in the following case and the change is applied during
13183
- # the next maintenance window unless the `ApplyImmediately` parameter is
13184
- # enabled for this request. If the parameter change results in an option
13185
- # group that enables OEM, this change can cause a brief (sub-second)
13186
- # period during which new connections are rejected but existing
13187
- # connections are not interrupted.
13968
+ # specified option group.
13969
+ #
13970
+ # Changing this parameter doesn't result in an outage, with one
13971
+ # exception. If the parameter change results in an option group that
13972
+ # enables OEM, it can cause a brief period, lasting less than a second,
13973
+ # during which new connections are rejected but existing connections
13974
+ # aren't interrupted.
13975
+ #
13976
+ # The change is applied during the next maintenance window unless the
13977
+ # `ApplyImmediately` parameter is enabled for this request.
13188
13978
  #
13189
13979
  # Permanent options, such as the TDE option for Oracle Advanced Security
13190
13980
  # TDE, can't be removed from an option group, and that option group
13191
- # can't be removed from a DB instance once it is associated with a DB
13192
- # instance
13981
+ # can't be removed from a DB instance after it is associated with a DB
13982
+ # instance.
13983
+ #
13984
+ # This setting doesn't apply to RDS Custom.
13193
13985
  #
13194
13986
  # @option params [String] :new_db_instance_identifier
13195
13987
  # The new DB instance identifier for the DB instance when renaming a DB
@@ -13198,6 +13990,8 @@ module Aws::RDS
13198
13990
  # occur during the next maintenance window if you disable Apply
13199
13991
  # Immediately. This value is stored as a lowercase string.
13200
13992
  #
13993
+ # This setting doesn't apply to RDS Custom.
13994
+ #
13201
13995
  # Constraints:
13202
13996
  #
13203
13997
  # * Must contain from 1 to 63 letters, numbers, or hyphens.
@@ -13237,24 +14031,31 @@ module Aws::RDS
13237
14031
  # The ARN from the key store with which to associate the instance for
13238
14032
  # TDE encryption.
13239
14033
  #
14034
+ # This setting doesn't apply to RDS Custom.
14035
+ #
13240
14036
  # @option params [String] :tde_credential_password
13241
14037
  # The password for the given ARN from the key store in order to access
13242
14038
  # the device.
13243
14039
  #
14040
+ # This setting doesn't apply to RDS Custom.
14041
+ #
13244
14042
  # @option params [String] :ca_certificate_identifier
13245
- # Indicates the certificate that needs to be associated with the
13246
- # instance.
14043
+ # Specifies the certificate to associate with the DB instance.
14044
+ #
14045
+ # This setting doesn't apply to RDS Custom.
13247
14046
  #
13248
14047
  # @option params [String] :domain
13249
14048
  # The Active Directory directory ID to move the DB instance to. Specify
13250
- # `none` to remove the instance from its current domain. The domain must
13251
- # be created prior to this operation. Currently, only MySQL, Microsoft
13252
- # SQL Server, Oracle, and PostgreSQL DB instances can be created in an
14049
+ # `none` to remove the instance from its current domain. You must create
14050
+ # the domain before this operation. Currently, you can create only
14051
+ # MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances in an
13253
14052
  # Active Directory Domain.
13254
14053
  #
13255
14054
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
13256
14055
  # RDS User Guide*.
13257
14056
  #
14057
+ # This setting doesn't apply to RDS Custom.
14058
+ #
13258
14059
  #
13259
14060
  #
13260
14061
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -13272,10 +14073,12 @@ module Aws::RDS
13272
14073
  # @option params [Integer] :monitoring_interval
13273
14074
  # The interval, in seconds, between points when Enhanced Monitoring
13274
14075
  # metrics are collected for the DB instance. To disable collecting
13275
- # Enhanced Monitoring metrics, specify 0. The default is 0.
14076
+ # Enhanced Monitoring metrics, specify 0, which is the default.
13276
14077
  #
13277
- # If `MonitoringRoleArn` is specified, then you must also set
13278
- # `MonitoringInterval` to a value other than 0.
14078
+ # If `MonitoringRoleArn` is specified, set `MonitoringInterval` to a
14079
+ # value other than 0.
14080
+ #
14081
+ # This setting doesn't apply to RDS Custom.
13279
14082
  #
13280
14083
  # Valid Values: `0, 1, 5, 10, 15, 30, 60`
13281
14084
  #
@@ -13286,9 +14089,11 @@ module Aws::RDS
13286
14089
  # port values specified for options in the option group for the DB
13287
14090
  # instance.
13288
14091
  #
13289
- # Your database will restart when you change the `DBPortNumber` value
14092
+ # If you change the `DBPortNumber` value, your database restarts
13290
14093
  # regardless of the value of the `ApplyImmediately` parameter.
13291
14094
  #
14095
+ # This setting doesn't apply to RDS Custom.
14096
+ #
13292
14097
  # **MySQL**
13293
14098
  #
13294
14099
  # Default: `3306`
@@ -13348,15 +14153,19 @@ module Aws::RDS
13348
14153
  # Changes to the `PubliclyAccessible` parameter are applied immediately
13349
14154
  # regardless of the value of the `ApplyImmediately` parameter.
13350
14155
  #
14156
+ # This setting doesn't apply to RDS Custom.
14157
+ #
13351
14158
  # @option params [String] :monitoring_role_arn
13352
14159
  # The ARN for the IAM role that permits RDS to send enhanced monitoring
13353
14160
  # metrics to Amazon CloudWatch Logs. For example,
13354
14161
  # `arn:aws:iam:123456789012:role/emaccess`. For information on creating
13355
- # a monitoring role, go to [To create an IAM role for Amazon RDS
13356
- # Enhanced Monitoring][1] in the *Amazon RDS User Guide.*
14162
+ # a monitoring role, see [To create an IAM role for Amazon RDS Enhanced
14163
+ # Monitoring][1] in the *Amazon RDS User Guide.*
13357
14164
  #
13358
- # If `MonitoringInterval` is set to a value other than 0, then you must
13359
- # supply a `MonitoringRoleArn` value.
14165
+ # If `MonitoringInterval` is set to a value other than 0, supply a
14166
+ # `MonitoringRoleArn` value.
14167
+ #
14168
+ # This setting doesn't apply to RDS Custom.
13360
14169
  #
13361
14170
  #
13362
14171
  #
@@ -13366,12 +14175,16 @@ module Aws::RDS
13366
14175
  # The name of the IAM role to use when making API calls to the Directory
13367
14176
  # Service.
13368
14177
  #
14178
+ # This setting doesn't apply to RDS Custom.
14179
+ #
13369
14180
  # @option params [Integer] :promotion_tier
13370
14181
  # A value that specifies the order in which an Aurora Replica is
13371
14182
  # promoted to the primary instance after a failure of the existing
13372
14183
  # primary instance. For more information, see [ Fault Tolerance for an
13373
14184
  # Aurora DB Cluster][1] in the *Amazon Aurora User Guide*.
13374
14185
  #
14186
+ # This setting doesn't apply to RDS Custom.
14187
+ #
13375
14188
  # Default: 1
13376
14189
  #
13377
14190
  # Valid Values: 0 - 15
@@ -13393,6 +14206,8 @@ module Aws::RDS
13393
14206
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
13394
14207
  # RDS User Guide.*
13395
14208
  #
14209
+ # This setting doesn't apply to RDS Custom.
14210
+ #
13396
14211
  #
13397
14212
  #
13398
14213
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
@@ -13404,6 +14219,8 @@ module Aws::RDS
13404
14219
  # For more information, see [Using Amazon Performance Insights][1] in
13405
14220
  # the *Amazon Relational Database Service User Guide*.
13406
14221
  #
14222
+ # This setting doesn't apply to RDS Custom.
14223
+ #
13407
14224
  #
13408
14225
  #
13409
14226
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
@@ -13413,18 +14230,21 @@ module Aws::RDS
13413
14230
  # Performance Insights data.
13414
14231
  #
13415
14232
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
13416
- # alias ARN, or alias name for the Amazon Web Services KMS customer
13417
- # master key (CMK).
14233
+ # alias ARN, or alias name for the KMS key.
13418
14234
  #
13419
14235
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
13420
- # Amazon RDS uses your default CMK. There is a default CMK for your
13421
- # Amazon Web Services account. Your Amazon Web Services account has a
13422
- # different default CMK for each Amazon Web Services Region.
14236
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
14237
+ # your Amazon Web Services account. Your Amazon Web Services account has
14238
+ # a different default KMS key for each Amazon Web Services Region.
14239
+ #
14240
+ # This setting doesn't apply to RDS Custom.
13423
14241
  #
13424
14242
  # @option params [Integer] :performance_insights_retention_period
13425
14243
  # The amount of time, in days, to retain Performance Insights data.
13426
14244
  # Valid values are 7 or 731 (2 years).
13427
14245
  #
14246
+ # This setting doesn't apply to RDS Custom.
14247
+ #
13428
14248
  # @option params [Types::CloudwatchLogsExportConfiguration] :cloudwatch_logs_export_configuration
13429
14249
  # The configuration setting for the log types to be enabled for export
13430
14250
  # to CloudWatch Logs for a specific DB instance.
@@ -13433,14 +14253,20 @@ module Aws::RDS
13433
14253
  # always applied to the DB instance immediately. Therefore, the
13434
14254
  # `ApplyImmediately` parameter has no effect.
13435
14255
  #
14256
+ # This setting doesn't apply to RDS Custom.
14257
+ #
13436
14258
  # @option params [Array<Types::ProcessorFeature>] :processor_features
13437
14259
  # The number of CPU cores and the number of threads per core for the DB
13438
14260
  # instance class of the DB instance.
13439
14261
  #
14262
+ # This setting doesn't apply to RDS Custom.
14263
+ #
13440
14264
  # @option params [Boolean] :use_default_processor_features
13441
14265
  # A value that indicates whether the DB instance class of the DB
13442
14266
  # instance uses its default processor features.
13443
14267
  #
14268
+ # This setting doesn't apply to RDS Custom.
14269
+ #
13444
14270
  # @option params [Boolean] :deletion_protection
13445
14271
  # A value that indicates whether the DB instance has deletion protection
13446
14272
  # enabled. The database can't be deleted when deletion protection is
@@ -13459,6 +14285,8 @@ module Aws::RDS
13459
14285
  # apply to it, see [ Managing capacity automatically with Amazon RDS
13460
14286
  # storage autoscaling][1] in the *Amazon RDS User Guide*.
13461
14287
  #
14288
+ # This setting doesn't apply to RDS Custom.
14289
+ #
13462
14290
  #
13463
14291
  #
13464
14292
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -13486,6 +14314,8 @@ module Aws::RDS
13486
14314
  # Aurora DB engines, see [ Rotating Your SSL/TLS Certificate][2] in
13487
14315
  # the *Amazon Aurora User Guide.*
13488
14316
  #
14317
+ # This setting doesn't apply to RDS Custom.
14318
+ #
13489
14319
  #
13490
14320
  #
13491
14321
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html
@@ -13507,6 +14337,8 @@ module Aws::RDS
13507
14337
  # more information, see [Working with Oracle Read Replicas for Amazon
13508
14338
  # RDS][1] in the *Amazon RDS User Guide*.
13509
14339
  #
14340
+ # This setting doesn't apply to RDS Custom.
14341
+ #
13510
14342
  #
13511
14343
  #
13512
14344
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
@@ -13536,6 +14368,19 @@ module Aws::RDS
13536
14368
  # The Amazon Resource Name (ARN) of the recovery point in Amazon Web
13537
14369
  # Services Backup.
13538
14370
  #
14371
+ # This setting doesn't apply to RDS Custom.
14372
+ #
14373
+ # @option params [String] :automation_mode
14374
+ # The automation mode of the RDS Custom DB instance: `full` or `all
14375
+ # paused`. If `full`, the DB instance automates monitoring and instance
14376
+ # recovery. If `all paused`, the instance pauses automation for the
14377
+ # duration set by `ResumeFullAutomationModeMinutes`.
14378
+ #
14379
+ # @option params [Integer] :resume_full_automation_mode_minutes
14380
+ # The number of minutes to pause the automation. When the time period
14381
+ # ends, RDS Custom resumes full automation. The minimum value is `60`
14382
+ # (default). The maximum value is `1,440`.
14383
+ #
13539
14384
  # @return [Types::ModifyDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
13540
14385
  #
13541
14386
  # * {Types::ModifyDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -13618,6 +14463,8 @@ module Aws::RDS
13618
14463
  # replica_mode: "open-read-only", # accepts open-read-only, mounted
13619
14464
  # enable_customer_owned_ip: false,
13620
14465
  # aws_backup_recovery_point_arn: "AwsBackupRecoveryPointArn",
14466
+ # automation_mode: "full", # accepts full, all-paused
14467
+ # resume_full_automation_mode_minutes: 1,
13621
14468
  # })
13622
14469
  #
13623
14470
  # @example Response structure
@@ -13678,6 +14525,8 @@ module Aws::RDS
13678
14525
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
13679
14526
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
13680
14527
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
14528
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
14529
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
13681
14530
  # resp.db_instance.latest_restorable_time #=> Time
13682
14531
  # resp.db_instance.multi_az #=> Boolean
13683
14532
  # resp.db_instance.engine_version #=> String
@@ -13752,6 +14601,10 @@ module Aws::RDS
13752
14601
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
13753
14602
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
13754
14603
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
14604
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
14605
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
14606
+ # resp.db_instance.custom_iam_instance_profile #=> String
14607
+ # resp.db_instance.backup_target #=> String
13755
14608
  #
13756
14609
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstance AWS API Documentation
13757
14610
  #
@@ -14092,8 +14945,8 @@ module Aws::RDS
14092
14945
  # Updates a manual DB snapshot with a new engine version. The snapshot
14093
14946
  # can be encrypted or unencrypted, but not shared or public.
14094
14947
  #
14095
- # Amazon RDS supports upgrading DB snapshots for MySQL, Oracle, and
14096
- # PostgreSQL.
14948
+ # Amazon RDS supports upgrading DB snapshots for MySQL, PostgreSQL, and
14949
+ # Oracle. This command doesn't apply to RDS Custom.
14097
14950
  #
14098
14951
  # @option params [required, String] :db_snapshot_identifier
14099
14952
  # The identifier of the DB snapshot to modify.
@@ -14187,6 +15040,7 @@ module Aws::RDS
14187
15040
  # resp.db_snapshot.tag_list[0].key #=> String
14188
15041
  # resp.db_snapshot.tag_list[0].value #=> String
14189
15042
  # resp.db_snapshot.original_snapshot_create_time #=> Time
15043
+ # resp.db_snapshot.snapshot_target #=> String
14190
15044
  #
14191
15045
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSnapshot AWS API Documentation
14192
15046
  #
@@ -14742,7 +15596,8 @@ module Aws::RDS
14742
15596
  # on your read replica, configure the automated backup window so that
14743
15597
  # daily backups do not interfere with read replica promotion.
14744
15598
  #
14745
- # * This command doesn't apply to Aurora MySQL and Aurora PostgreSQL.
15599
+ # * This command doesn't apply to Aurora MySQL, Aurora PostgreSQL, or
15600
+ # RDS Custom.
14746
15601
  #
14747
15602
  # </note>
14748
15603
  #
@@ -14882,6 +15737,8 @@ module Aws::RDS
14882
15737
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
14883
15738
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
14884
15739
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
15740
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
15741
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
14885
15742
  # resp.db_instance.latest_restorable_time #=> Time
14886
15743
  # resp.db_instance.multi_az #=> Boolean
14887
15744
  # resp.db_instance.engine_version #=> String
@@ -14956,6 +15813,10 @@ module Aws::RDS
14956
15813
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
14957
15814
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
14958
15815
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
15816
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
15817
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
15818
+ # resp.db_instance.custom_iam_instance_profile #=> String
15819
+ # resp.db_instance.backup_target #=> String
14959
15820
  #
14960
15821
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplica AWS API Documentation
14961
15822
  #
@@ -15197,6 +16058,8 @@ module Aws::RDS
15197
16058
  # For more information about rebooting, see [Rebooting a DB Instance][1]
15198
16059
  # in the *Amazon RDS User Guide.*
15199
16060
  #
16061
+ # This command doesn't apply to RDS Custom.
16062
+ #
15200
16063
  #
15201
16064
  #
15202
16065
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RebootInstance.html
@@ -15303,6 +16166,8 @@ module Aws::RDS
15303
16166
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
15304
16167
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
15305
16168
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
16169
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
16170
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
15306
16171
  # resp.db_instance.latest_restorable_time #=> Time
15307
16172
  # resp.db_instance.multi_az #=> Boolean
15308
16173
  # resp.db_instance.engine_version #=> String
@@ -15377,6 +16242,10 @@ module Aws::RDS
15377
16242
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
15378
16243
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
15379
16244
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
16245
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
16246
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
16247
+ # resp.db_instance.custom_iam_instance_profile #=> String
16248
+ # resp.db_instance.backup_target #=> String
15380
16249
  #
15381
16250
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RebootDBInstance AWS API Documentation
15382
16251
  #
@@ -15520,7 +16389,7 @@ module Aws::RDS
15520
16389
  #
15521
16390
  # @option params [String] :feature_name
15522
16391
  # The name of the feature for the DB cluster that the IAM role is to be
15523
- # disassociated from. For the list of supported feature names, see
16392
+ # disassociated from. For information about supported feature names, see
15524
16393
  # DBEngineVersion.
15525
16394
  #
15526
16395
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -15555,7 +16424,7 @@ module Aws::RDS
15555
16424
  #
15556
16425
  # @option params [required, String] :feature_name
15557
16426
  # The name of the feature for the DB instance that the IAM role is to be
15558
- # disassociated from. For the list of supported feature names, see
16427
+ # disassociated from. For information about supported feature names, see
15559
16428
  # `DBEngineVersion`.
15560
16429
  #
15561
16430
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -16102,15 +16971,15 @@ module Aws::RDS
16102
16971
  # cluster.
16103
16972
  #
16104
16973
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
16105
- # alias ARN, or alias name for the Amazon Web Services KMS customer
16106
- # master key (CMK). To use a CMK in a different Amazon Web Services
16107
- # account, specify the key ARN or alias ARN.
16974
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
16975
+ # different Amazon Web Services account, specify the key ARN or alias
16976
+ # ARN.
16108
16977
  #
16109
16978
  # If the StorageEncrypted parameter is enabled, and you do not specify a
16110
16979
  # value for the `KmsKeyId` parameter, then Amazon RDS will use your
16111
- # default CMK. There is a default CMK for your Amazon Web Services
16112
- # account. Your Amazon Web Services account has a different default CMK
16113
- # for each Amazon Web Services Region.
16980
+ # default KMS key. There is a default KMS key for your Amazon Web
16981
+ # Services account. Your Amazon Web Services account has a different
16982
+ # default KMS key for each Amazon Web Services Region.
16114
16983
  #
16115
16984
  # @option params [Boolean] :enable_iam_database_authentication
16116
16985
  # A value that indicates whether to enable mapping of Amazon Web
@@ -16486,17 +17355,16 @@ module Aws::RDS
16486
17355
  # encrypted DB cluster from a DB snapshot or DB cluster snapshot.
16487
17356
  #
16488
17357
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
16489
- # alias ARN, or alias name for the Amazon Web Services KMS customer
16490
- # master key (CMK). To use a CMK in a different Amazon Web Services
16491
- # account, specify the key ARN or alias ARN.
17358
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
17359
+ # different Amazon Web Services account, specify the key ARN or alias
17360
+ # ARN.
16492
17361
  #
16493
17362
  # When you don't specify a value for the `KmsKeyId` parameter, then the
16494
17363
  # following occurs:
16495
17364
  #
16496
17365
  # * If the DB snapshot or DB cluster snapshot in `SnapshotIdentifier` is
16497
- # encrypted, then the restored DB cluster is encrypted using the
16498
- # Amazon Web Services KMS CMK that was used to encrypt the DB snapshot
16499
- # or DB cluster snapshot.
17366
+ # encrypted, then the restored DB cluster is encrypted using the KMS
17367
+ # key that was used to encrypt the DB snapshot or DB cluster snapshot.
16500
17368
  #
16501
17369
  # * If the DB snapshot or DB cluster snapshot in `SnapshotIdentifier`
16502
17370
  # isn't encrypted, then the restored DB cluster isn't encrypted.
@@ -16885,22 +17753,21 @@ module Aws::RDS
16885
17753
  # encrypted DB cluster from an encrypted DB cluster.
16886
17754
  #
16887
17755
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
16888
- # alias ARN, or alias name for the Amazon Web Services KMS customer
16889
- # master key (CMK). To use a CMK in a different Amazon Web Services
16890
- # account, specify the key ARN or alias ARN.
17756
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
17757
+ # different Amazon Web Services account, specify the key ARN or alias
17758
+ # ARN.
16891
17759
  #
16892
17760
  # You can restore to a new DB cluster and encrypt the new DB cluster
16893
- # with a Amazon Web Services KMS CMK that is different than the Amazon
16894
- # Web Services KMS key used to encrypt the source DB cluster. The new DB
16895
- # cluster is encrypted with the Amazon Web Services KMS CMK identified
16896
- # by the `KmsKeyId` parameter.
17761
+ # with a KMS key that is different from the KMS key used to encrypt the
17762
+ # source DB cluster. The new DB cluster is encrypted with the KMS key
17763
+ # identified by the `KmsKeyId` parameter.
16897
17764
  #
16898
17765
  # If you don't specify a value for the `KmsKeyId` parameter, then the
16899
17766
  # following occurs:
16900
17767
  #
16901
17768
  # * If the DB cluster is encrypted, then the restored DB cluster is
16902
- # encrypted using the Amazon Web Services KMS CMK that was used to
16903
- # encrypt the source DB cluster.
17769
+ # encrypted using the KMS key that was used to encrypt the source DB
17770
+ # cluster.
16904
17771
  #
16905
17772
  # * If the DB cluster isn't encrypted, then the restored DB cluster
16906
17773
  # isn't encrypted.
@@ -17256,6 +18123,8 @@ module Aws::RDS
17256
18123
  # A value that indicates whether the DB instance is a Multi-AZ
17257
18124
  # deployment.
17258
18125
  #
18126
+ # This setting doesn't apply to RDS Custom.
18127
+ #
17259
18128
  # Constraint: You can't specify the `AvailabilityZone` parameter if the
17260
18129
  # DB instance is a Multi-AZ deployment.
17261
18130
  #
@@ -17278,9 +18147,14 @@ module Aws::RDS
17278
18147
  # A value that indicates whether minor version upgrades are applied
17279
18148
  # automatically to the DB instance during the maintenance window.
17280
18149
  #
18150
+ # If you restore an RDS Custom DB instance, you must disable this
18151
+ # parameter.
18152
+ #
17281
18153
  # @option params [String] :license_model
17282
18154
  # License model information for the restored DB instance.
17283
18155
  #
18156
+ # This setting doesn't apply to RDS Custom.
18157
+ #
17284
18158
  # Default: Same as source.
17285
18159
  #
17286
18160
  # Valid values: `license-included` \| `bring-your-own-license` \|
@@ -17289,14 +18163,14 @@ module Aws::RDS
17289
18163
  # @option params [String] :db_name
17290
18164
  # The database name for the restored DB instance.
17291
18165
  #
17292
- # <note markdown="1"> This parameter doesn't apply to the MySQL, PostgreSQL, or MariaDB
17293
- # engines.
17294
- #
17295
- # </note>
18166
+ # This parameter doesn't apply to the MySQL, PostgreSQL, or MariaDB
18167
+ # engines. It also doesn't apply to RDS Custom DB instances.
17296
18168
  #
17297
18169
  # @option params [String] :engine
17298
18170
  # The database engine to use for the new instance.
17299
18171
  #
18172
+ # This setting doesn't apply to RDS Custom.
18173
+ #
17300
18174
  # Default: The same as source
17301
18175
  #
17302
18176
  # Constraint: Must be compatible with the engine of the source. For
@@ -17351,8 +18225,10 @@ module Aws::RDS
17351
18225
  #
17352
18226
  # Permanent options, such as the TDE option for Oracle Advanced Security
17353
18227
  # TDE, can't be removed from an option group, and that option group
17354
- # can't be removed from a DB instance once it is associated with a DB
17355
- # instance
18228
+ # can't be removed from a DB instance after it is associated with a DB
18229
+ # instance.
18230
+ #
18231
+ # This setting doesn't apply to RDS Custom.
17356
18232
  #
17357
18233
  # @option params [Array<Types::Tag>] :tags
17358
18234
  # A list of tags. For more information, see [Tagging Amazon RDS
@@ -17376,10 +18252,14 @@ module Aws::RDS
17376
18252
  # The ARN from the key store with which to associate the instance for
17377
18253
  # TDE encryption.
17378
18254
  #
18255
+ # This setting doesn't apply to RDS Custom.
18256
+ #
17379
18257
  # @option params [String] :tde_credential_password
17380
18258
  # The password for the given ARN from the key store in order to access
17381
18259
  # the device.
17382
18260
  #
18261
+ # This setting doesn't apply to RDS Custom.
18262
+ #
17383
18263
  # @option params [Array<String>] :vpc_security_group_ids
17384
18264
  # A list of EC2 VPC security groups to associate with this DB instance.
17385
18265
  #
@@ -17388,13 +18268,15 @@ module Aws::RDS
17388
18268
  #
17389
18269
  # @option params [String] :domain
17390
18270
  # Specify the Active Directory directory ID to restore the DB instance
17391
- # in. The domain must be created prior to this operation. Currently,
17392
- # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
17393
- # can be created in an Active Directory Domain.
18271
+ # in. The domain/ must be created prior to this operation. Currently,
18272
+ # you can create only MySQL, Microsoft SQL Server, Oracle, and
18273
+ # PostgreSQL DB instances in an Active Directory Domain.
17394
18274
  #
17395
18275
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
17396
18276
  # RDS User Guide*.
17397
18277
  #
18278
+ # This setting doesn't apply to RDS Custom.
18279
+ #
17398
18280
  #
17399
18281
  #
17400
18282
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -17408,6 +18290,8 @@ module Aws::RDS
17408
18290
  # Specify the name of the IAM role to be used when making API calls to
17409
18291
  # the Directory Service.
17410
18292
  #
18293
+ # This setting doesn't apply to RDS Custom.
18294
+ #
17411
18295
  # @option params [Boolean] :enable_iam_database_authentication
17412
18296
  # A value that indicates whether to enable mapping of Amazon Web
17413
18297
  # Services Identity and Access Management (IAM) accounts to database
@@ -17417,6 +18301,8 @@ module Aws::RDS
17417
18301
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
17418
18302
  # RDS User Guide.*
17419
18303
  #
18304
+ # This setting doesn't apply to RDS Custom.
18305
+ #
17420
18306
  #
17421
18307
  #
17422
18308
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
@@ -17427,6 +18313,8 @@ module Aws::RDS
17427
18313
  # used. For more information, see [Publishing Database Logs to Amazon
17428
18314
  # CloudWatch Logs][1] in the *Amazon RDS User Guide*.
17429
18315
  #
18316
+ # This setting doesn't apply to RDS Custom.
18317
+ #
17430
18318
  #
17431
18319
  #
17432
18320
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -17435,15 +18323,21 @@ module Aws::RDS
17435
18323
  # The number of CPU cores and the number of threads per core for the DB
17436
18324
  # instance class of the DB instance.
17437
18325
  #
18326
+ # This setting doesn't apply to RDS Custom.
18327
+ #
17438
18328
  # @option params [Boolean] :use_default_processor_features
17439
18329
  # A value that indicates whether the DB instance class of the DB
17440
18330
  # instance uses its default processor features.
17441
18331
  #
18332
+ # This setting doesn't apply to RDS Custom.
18333
+ #
17442
18334
  # @option params [String] :db_parameter_group_name
17443
18335
  # The name of the DB parameter group to associate with this DB instance.
17444
18336
  #
17445
- # If you do not specify a value for `DBParameterGroupName`, then the
17446
- # default `DBParameterGroup` for the specified DB engine is used.
18337
+ # If you don't specify a value for `DBParameterGroupName`, then RDS
18338
+ # uses the default `DBParameterGroup` for the specified DB engine.
18339
+ #
18340
+ # This setting doesn't apply to RDS Custom.
17447
18341
  #
17448
18342
  # Constraints:
17449
18343
  #
@@ -17474,6 +18368,8 @@ module Aws::RDS
17474
18368
  # a CoIP can provide lower latency for connections to the DB instance
17475
18369
  # from outside of its virtual private cloud (VPC) on your local network.
17476
18370
  #
18371
+ # This setting doesn't apply to RDS Custom.
18372
+ #
17477
18373
  # For more information about RDS on Outposts, see [Working with Amazon
17478
18374
  # RDS on Amazon Web Services Outposts][1] in the *Amazon RDS User
17479
18375
  # Guide*.
@@ -17486,6 +18382,43 @@ module Aws::RDS
17486
18382
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
17487
18383
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
17488
18384
  #
18385
+ # @option params [String] :custom_iam_instance_profile
18386
+ # The instance profile associated with the underlying Amazon EC2
18387
+ # instance of an RDS Custom DB instance. The instance profile must meet
18388
+ # the following requirements:
18389
+ #
18390
+ # * The profile must exist in your account.
18391
+ #
18392
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
18393
+ # assume.
18394
+ #
18395
+ # * The instance profile name and the associated IAM role name must
18396
+ # start with the prefix `AWSRDSCustom`.
18397
+ #
18398
+ # For the list of permissions required for the IAM role, see [ Configure
18399
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
18400
+ # Guide*.
18401
+ #
18402
+ # This setting is required for RDS Custom.
18403
+ #
18404
+ #
18405
+ #
18406
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
18407
+ #
18408
+ # @option params [String] :backup_target
18409
+ # Specifies where automated backups and manual snapshots are stored for
18410
+ # the restored DB instance.
18411
+ #
18412
+ # Possible values are `outposts` (Amazon Web Services Outposts) and
18413
+ # `region` (Amazon Web Services Region). The default is `region`.
18414
+ #
18415
+ # For more information, see [Working with Amazon RDS on Amazon Web
18416
+ # Services Outposts][1] in the *Amazon RDS User Guide*.
18417
+ #
18418
+ #
18419
+ #
18420
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
18421
+ #
17489
18422
  # @return [Types::RestoreDBInstanceFromDBSnapshotResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
17490
18423
  #
17491
18424
  # * {Types::RestoreDBInstanceFromDBSnapshotResult#db_instance #db_instance} => Types::DBInstance
@@ -17627,6 +18560,8 @@ module Aws::RDS
17627
18560
  # db_parameter_group_name: "String",
17628
18561
  # deletion_protection: false,
17629
18562
  # enable_customer_owned_ip: false,
18563
+ # custom_iam_instance_profile: "String",
18564
+ # backup_target: "String",
17630
18565
  # })
17631
18566
  #
17632
18567
  # @example Response structure
@@ -17687,6 +18622,8 @@ module Aws::RDS
17687
18622
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
17688
18623
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
17689
18624
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
18625
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
18626
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
17690
18627
  # resp.db_instance.latest_restorable_time #=> Time
17691
18628
  # resp.db_instance.multi_az #=> Boolean
17692
18629
  # resp.db_instance.engine_version #=> String
@@ -17761,6 +18698,10 @@ module Aws::RDS
17761
18698
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
17762
18699
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
17763
18700
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
18701
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
18702
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
18703
+ # resp.db_instance.custom_iam_instance_profile #=> String
18704
+ # resp.db_instance.backup_target #=> String
17764
18705
  #
17765
18706
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshot AWS API Documentation
17766
18707
  #
@@ -17778,6 +18719,8 @@ module Aws::RDS
17778
18719
  # instance running MySQL. For more information, see [Importing Data into
17779
18720
  # an Amazon RDS MySQL DB Instance][1] in the *Amazon RDS User Guide.*
17780
18721
  #
18722
+ # This command doesn't apply to RDS Custom.
18723
+ #
17781
18724
  #
17782
18725
  #
17783
18726
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/MySQL.Procedural.Importing.html
@@ -18013,15 +18956,15 @@ module Aws::RDS
18013
18956
  # instance.
18014
18957
  #
18015
18958
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
18016
- # alias ARN, or alias name for the Amazon Web Services KMS customer
18017
- # master key (CMK). To use a CMK in a different Amazon Web Services
18018
- # account, specify the key ARN or alias ARN.
18959
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
18960
+ # different Amazon Web Services account, specify the key ARN or alias
18961
+ # ARN.
18019
18962
  #
18020
18963
  # If the `StorageEncrypted` parameter is enabled, and you do not specify
18021
18964
  # a value for the `KmsKeyId` parameter, then Amazon RDS will use your
18022
- # default CMK. There is a default CMK for your Amazon Web Services
18023
- # account. Your Amazon Web Services account has a different default CMK
18024
- # for each Amazon Web Services Region.
18965
+ # default KMS key. There is a default KMS key for your Amazon Web
18966
+ # Services account. Your Amazon Web Services account has a different
18967
+ # default KMS key for each Amazon Web Services Region.
18025
18968
  #
18026
18969
  # @option params [Boolean] :copy_tags_to_snapshot
18027
18970
  # A value that indicates whether to copy all tags from the DB instance
@@ -18105,13 +19048,12 @@ module Aws::RDS
18105
19048
  # Performance Insights data.
18106
19049
  #
18107
19050
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
18108
- # alias ARN, or alias name for the Amazon Web Services KMS customer
18109
- # master key (CMK).
19051
+ # alias ARN, or alias name for the KMS key.
18110
19052
  #
18111
19053
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
18112
- # Amazon RDS uses your default CMK. There is a default CMK for your
18113
- # Amazon Web Services account. Your Amazon Web Services account has a
18114
- # different default CMK for each Amazon Web Services Region.
19054
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
19055
+ # your Amazon Web Services account. Your Amazon Web Services account has
19056
+ # a different default KMS key for each Amazon Web Services Region.
18115
19057
  #
18116
19058
  # @option params [Integer] :performance_insights_retention_period
18117
19059
  # The amount of time, in days, to retain Performance Insights data.
@@ -18278,6 +19220,8 @@ module Aws::RDS
18278
19220
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
18279
19221
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
18280
19222
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
19223
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
19224
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
18281
19225
  # resp.db_instance.latest_restorable_time #=> Time
18282
19226
  # resp.db_instance.multi_az #=> Boolean
18283
19227
  # resp.db_instance.engine_version #=> String
@@ -18352,6 +19296,10 @@ module Aws::RDS
18352
19296
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
18353
19297
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
18354
19298
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
19299
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
19300
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
19301
+ # resp.db_instance.custom_iam_instance_profile #=> String
19302
+ # resp.db_instance.backup_target #=> String
18355
19303
  #
18356
19304
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromS3 AWS API Documentation
18357
19305
  #
@@ -18466,6 +19414,8 @@ module Aws::RDS
18466
19414
  # A value that indicates whether the DB instance is a Multi-AZ
18467
19415
  # deployment.
18468
19416
  #
19417
+ # This setting doesn't apply to RDS Custom.
19418
+ #
18469
19419
  # Constraint: You can't specify the `AvailabilityZone` parameter if the
18470
19420
  # DB instance is a Multi-AZ deployment.
18471
19421
  #
@@ -18488,9 +19438,13 @@ module Aws::RDS
18488
19438
  # A value that indicates whether minor version upgrades are applied
18489
19439
  # automatically to the DB instance during the maintenance window.
18490
19440
  #
19441
+ # This setting doesn't apply to RDS Custom.
19442
+ #
18491
19443
  # @option params [String] :license_model
18492
19444
  # License model information for the restored DB instance.
18493
19445
  #
19446
+ # This setting doesn't apply to RDS Custom.
19447
+ #
18494
19448
  # Default: Same as source.
18495
19449
  #
18496
19450
  # Valid values: `license-included` \| `bring-your-own-license` \|
@@ -18499,13 +19453,16 @@ module Aws::RDS
18499
19453
  # @option params [String] :db_name
18500
19454
  # The database name for the restored DB instance.
18501
19455
  #
18502
- # <note markdown="1"> This parameter isn't used for the MySQL or MariaDB engines.
19456
+ # <note markdown="1"> This parameter isn't supported for the MySQL or MariaDB engines. It
19457
+ # also doesn't apply to RDS Custom.
18503
19458
  #
18504
19459
  # </note>
18505
19460
  #
18506
19461
  # @option params [String] :engine
18507
19462
  # The database engine to use for the new instance.
18508
19463
  #
19464
+ # This setting doesn't apply to RDS Custom.
19465
+ #
18509
19466
  # Default: The same as source
18510
19467
  #
18511
19468
  # Constraint: Must be compatible with the engine of the source
@@ -18550,9 +19507,11 @@ module Aws::RDS
18550
19507
  #
18551
19508
  # Permanent options, such as the TDE option for Oracle Advanced Security
18552
19509
  # TDE, can't be removed from an option group, and that option group
18553
- # can't be removed from a DB instance once it is associated with a DB
19510
+ # can't be removed from a DB instance after it is associated with a DB
18554
19511
  # instance
18555
19512
  #
19513
+ # This setting doesn't apply to RDS Custom.
19514
+ #
18556
19515
  # @option params [Boolean] :copy_tags_to_snapshot
18557
19516
  # A value that indicates whether to copy all tags from the restored DB
18558
19517
  # instance to snapshots of the DB instance. By default, tags are not
@@ -18580,10 +19539,14 @@ module Aws::RDS
18580
19539
  # The ARN from the key store with which to associate the instance for
18581
19540
  # TDE encryption.
18582
19541
  #
19542
+ # This setting doesn't apply to RDS Custom.
19543
+ #
18583
19544
  # @option params [String] :tde_credential_password
18584
19545
  # The password for the given ARN from the key store in order to access
18585
19546
  # the device.
18586
19547
  #
19548
+ # This setting doesn't apply to RDS Custom.
19549
+ #
18587
19550
  # @option params [Array<String>] :vpc_security_group_ids
18588
19551
  # A list of EC2 VPC security groups to associate with this DB instance.
18589
19552
  #
@@ -18592,9 +19555,11 @@ module Aws::RDS
18592
19555
  #
18593
19556
  # @option params [String] :domain
18594
19557
  # Specify the Active Directory directory ID to restore the DB instance
18595
- # in. The domain must be created prior to this operation. Currently,
18596
- # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
18597
- # can be created in an Active Directory Domain.
19558
+ # in. Create the domain before running this command. Currently, you can
19559
+ # create only the MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
19560
+ # instances in an Active Directory Domain.
19561
+ #
19562
+ # This setting doesn't apply to RDS Custom.
18598
19563
  #
18599
19564
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
18600
19565
  # RDS User Guide*.
@@ -18607,11 +19572,15 @@ module Aws::RDS
18607
19572
  # Specify the name of the IAM role to be used when making API calls to
18608
19573
  # the Directory Service.
18609
19574
  #
19575
+ # This setting doesn't apply to RDS Custom.
19576
+ #
18610
19577
  # @option params [Boolean] :enable_iam_database_authentication
18611
19578
  # A value that indicates whether to enable mapping of Amazon Web
18612
19579
  # Services Identity and Access Management (IAM) accounts to database
18613
19580
  # accounts. By default, mapping is disabled.
18614
19581
  #
19582
+ # This setting doesn't apply to RDS Custom.
19583
+ #
18615
19584
  # For more information about IAM database authentication, see [ IAM
18616
19585
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
18617
19586
  # RDS User Guide.*
@@ -18626,6 +19595,8 @@ module Aws::RDS
18626
19595
  # used. For more information, see [Publishing Database Logs to Amazon
18627
19596
  # CloudWatch Logs][1] in the *Amazon RDS User Guide*.
18628
19597
  #
19598
+ # This setting doesn't apply to RDS Custom.
19599
+ #
18629
19600
  #
18630
19601
  #
18631
19602
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -18634,16 +19605,22 @@ module Aws::RDS
18634
19605
  # The number of CPU cores and the number of threads per core for the DB
18635
19606
  # instance class of the DB instance.
18636
19607
  #
19608
+ # This setting doesn't apply to RDS Custom.
19609
+ #
18637
19610
  # @option params [Boolean] :use_default_processor_features
18638
19611
  # A value that indicates whether the DB instance class of the DB
18639
19612
  # instance uses its default processor features.
18640
19613
  #
19614
+ # This setting doesn't apply to RDS Custom.
19615
+ #
18641
19616
  # @option params [String] :db_parameter_group_name
18642
19617
  # The name of the DB parameter group to associate with this DB instance.
18643
19618
  #
18644
19619
  # If you do not specify a value for `DBParameterGroupName`, then the
18645
19620
  # default `DBParameterGroup` for the specified DB engine is used.
18646
19621
  #
19622
+ # This setting doesn't apply to RDS Custom.
19623
+ #
18647
19624
  # Constraints:
18648
19625
  #
18649
19626
  # * If supplied, must match the name of an existing DBParameterGroup.
@@ -18675,6 +19652,8 @@ module Aws::RDS
18675
19652
  # apply to it, see [ Managing capacity automatically with Amazon RDS
18676
19653
  # storage autoscaling][1] in the *Amazon RDS User Guide*.
18677
19654
  #
19655
+ # This setting doesn't apply to RDS Custom.
19656
+ #
18678
19657
  #
18679
19658
  #
18680
19659
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -18684,6 +19663,8 @@ module Aws::RDS
18684
19663
  # from which to restore, for example,
18685
19664
  # `arn:aws:rds:useast-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
18686
19665
  #
19666
+ # This setting doesn't apply to RDS Custom.
19667
+ #
18687
19668
  # @option params [Boolean] :enable_customer_owned_ip
18688
19669
  # A value that indicates whether to enable a customer-owned IP address
18689
19670
  # (CoIP) for an RDS on Outposts DB instance.
@@ -18693,6 +19674,8 @@ module Aws::RDS
18693
19674
  # a CoIP can provide lower latency for connections to the DB instance
18694
19675
  # from outside of its virtual private cloud (VPC) on your local network.
18695
19676
  #
19677
+ # This setting doesn't apply to RDS Custom.
19678
+ #
18696
19679
  # For more information about RDS on Outposts, see [Working with Amazon
18697
19680
  # RDS on Amazon Web Services Outposts][1] in the *Amazon RDS User
18698
19681
  # Guide*.
@@ -18705,6 +19688,43 @@ module Aws::RDS
18705
19688
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
18706
19689
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
18707
19690
  #
19691
+ # @option params [String] :custom_iam_instance_profile
19692
+ # The instance profile associated with the underlying Amazon EC2
19693
+ # instance of an RDS Custom DB instance. The instance profile must meet
19694
+ # the following requirements:
19695
+ #
19696
+ # * The profile must exist in your account.
19697
+ #
19698
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
19699
+ # assume.
19700
+ #
19701
+ # * The instance profile name and the associated IAM role name must
19702
+ # start with the prefix `AWSRDSCustom`.
19703
+ #
19704
+ # For the list of permissions required for the IAM role, see [ Configure
19705
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
19706
+ # Guide*.
19707
+ #
19708
+ # This setting is required for RDS Custom.
19709
+ #
19710
+ #
19711
+ #
19712
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
19713
+ #
19714
+ # @option params [String] :backup_target
19715
+ # Specifies where automated backups and manual snapshots are stored for
19716
+ # the restored DB instance.
19717
+ #
19718
+ # Possible values are `outposts` (Amazon Web Services Outposts) and
19719
+ # `region` (Amazon Web Services Region). The default is `region`.
19720
+ #
19721
+ # For more information, see [Working with Amazon RDS on Amazon Web
19722
+ # Services Outposts][1] in the *Amazon RDS User Guide*.
19723
+ #
19724
+ #
19725
+ #
19726
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
19727
+ #
18708
19728
  # @return [Types::RestoreDBInstanceToPointInTimeResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
18709
19729
  #
18710
19730
  # * {Types::RestoreDBInstanceToPointInTimeResult#db_instance #db_instance} => Types::DBInstance
@@ -18852,6 +19872,8 @@ module Aws::RDS
18852
19872
  # max_allocated_storage: 1,
18853
19873
  # source_db_instance_automated_backups_arn: "String",
18854
19874
  # enable_customer_owned_ip: false,
19875
+ # custom_iam_instance_profile: "String",
19876
+ # backup_target: "String",
18855
19877
  # })
18856
19878
  #
18857
19879
  # @example Response structure
@@ -18912,6 +19934,8 @@ module Aws::RDS
18912
19934
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
18913
19935
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
18914
19936
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
19937
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
19938
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
18915
19939
  # resp.db_instance.latest_restorable_time #=> Time
18916
19940
  # resp.db_instance.multi_az #=> Boolean
18917
19941
  # resp.db_instance.engine_version #=> String
@@ -18986,6 +20010,10 @@ module Aws::RDS
18986
20010
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
18987
20011
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
18988
20012
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
20013
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
20014
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
20015
+ # resp.db_instance.custom_iam_instance_profile #=> String
20016
+ # resp.db_instance.backup_target #=> String
18989
20017
  #
18990
20018
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceToPointInTime AWS API Documentation
18991
20019
  #
@@ -19107,7 +20135,7 @@ module Aws::RDS
19107
20135
  # The Amazon Web Services KMS key identifier for encrypting messages in
19108
20136
  # the database activity stream. The Amazon Web Services KMS key
19109
20137
  # identifier is the key ARN, key ID, alias ARN, or alias name for the
19110
- # Amazon Web Services KMS customer master key (CMK).
20138
+ # KMS key.
19111
20139
  #
19112
20140
  # @option params [Boolean] :apply_immediately
19113
20141
  # Specifies whether or not the database activity stream is to start as
@@ -19294,8 +20322,8 @@ module Aws::RDS
19294
20322
  # For more information, see [ Starting an Amazon RDS DB instance That
19295
20323
  # Was Previously Stopped][1] in the *Amazon RDS User Guide.*
19296
20324
  #
19297
- # <note markdown="1"> This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For
19298
- # Aurora DB clusters, use `StartDBCluster` instead.
20325
+ # <note markdown="1"> This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora
20326
+ # PostgreSQL. For Aurora DB clusters, use `StartDBCluster` instead.
19299
20327
  #
19300
20328
  # </note>
19301
20329
  #
@@ -19374,6 +20402,8 @@ module Aws::RDS
19374
20402
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
19375
20403
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
19376
20404
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
20405
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
20406
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
19377
20407
  # resp.db_instance.latest_restorable_time #=> Time
19378
20408
  # resp.db_instance.multi_az #=> Boolean
19379
20409
  # resp.db_instance.engine_version #=> String
@@ -19448,6 +20478,10 @@ module Aws::RDS
19448
20478
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
19449
20479
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
19450
20480
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
20481
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
20482
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
20483
+ # resp.db_instance.custom_iam_instance_profile #=> String
20484
+ # resp.db_instance.backup_target #=> String
19451
20485
  #
19452
20486
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StartDBInstance AWS API Documentation
19453
20487
  #
@@ -19461,6 +20495,8 @@ module Aws::RDS
19461
20495
  # Enables replication of automated backups to a different Amazon Web
19462
20496
  # Services Region.
19463
20497
  #
20498
+ # This command doesn't apply to RDS Custom.
20499
+ #
19464
20500
  # For more information, see [ Replicating Automated Backups to Another
19465
20501
  # Amazon Web Services Region][1] in the *Amazon RDS User Guide.*
19466
20502
  #
@@ -19540,6 +20576,7 @@ module Aws::RDS
19540
20576
  # resp.db_instance_automated_backup.db_instance_automated_backups_arn #=> String
19541
20577
  # resp.db_instance_automated_backup.db_instance_automated_backups_replications #=> Array
19542
20578
  # resp.db_instance_automated_backup.db_instance_automated_backups_replications[0].db_instance_automated_backups_arn #=> String
20579
+ # resp.db_instance_automated_backup.backup_target #=> String
19543
20580
  #
19544
20581
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StartDBInstanceAutomatedBackupsReplication AWS API Documentation
19545
20582
  #
@@ -19553,6 +20590,8 @@ module Aws::RDS
19553
20590
  # Starts an export of a snapshot to Amazon S3. The provided IAM role
19554
20591
  # must have access to the S3 bucket.
19555
20592
  #
20593
+ # This command doesn't apply to RDS Custom.
20594
+ #
19556
20595
  # @option params [required, String] :export_task_identifier
19557
20596
  # A unique identifier for the snapshot export task. This ID isn't an
19558
20597
  # identifier for the Amazon S3 bucket where the snapshot is to be
@@ -19569,13 +20608,12 @@ module Aws::RDS
19569
20608
  # when exporting a snapshot.
19570
20609
  #
19571
20610
  # @option params [required, String] :kms_key_id
19572
- # The ID of the Amazon Web Services KMS customer master key (CMK) to use
19573
- # to encrypt the snapshot exported to Amazon S3. The Amazon Web Services
19574
- # KMS key identifier is the key ARN, key ID, alias ARN, or alias name
19575
- # for the Amazon Web Services KMS customer master key (CMK). The caller
19576
- # of this operation must be authorized to execute the following
19577
- # operations. These can be set in the Amazon Web Services KMS key
19578
- # policy:
20611
+ # The ID of the Amazon Web Services KMS key to use to encrypt the
20612
+ # snapshot exported to Amazon S3. The Amazon Web Services KMS key
20613
+ # identifier is the key ARN, key ID, alias ARN, or alias name for the
20614
+ # KMS key. The caller of this operation must be authorized to execute
20615
+ # the following operations. These can be set in the Amazon Web Services
20616
+ # KMS key policy:
19579
20617
  #
19580
20618
  # * GrantOperation.Encrypt
19581
20619
  #
@@ -19866,8 +20904,8 @@ module Aws::RDS
19866
20904
  # For more information, see [ Stopping an Amazon RDS DB Instance
19867
20905
  # Temporarily][1] in the *Amazon RDS User Guide.*
19868
20906
  #
19869
- # <note markdown="1"> This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For
19870
- # Aurora clusters, use `StopDBCluster` instead.
20907
+ # <note markdown="1"> This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora
20908
+ # PostgreSQL. For Aurora clusters, use `StopDBCluster` instead.
19871
20909
  #
19872
20910
  # </note>
19873
20911
  #
@@ -19951,6 +20989,8 @@ module Aws::RDS
19951
20989
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
19952
20990
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
19953
20991
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
20992
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
20993
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
19954
20994
  # resp.db_instance.latest_restorable_time #=> Time
19955
20995
  # resp.db_instance.multi_az #=> Boolean
19956
20996
  # resp.db_instance.engine_version #=> String
@@ -20025,6 +21065,10 @@ module Aws::RDS
20025
21065
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
20026
21066
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
20027
21067
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
21068
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
21069
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
21070
+ # resp.db_instance.custom_iam_instance_profile #=> String
21071
+ # resp.db_instance.backup_target #=> String
20028
21072
  #
20029
21073
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StopDBInstance AWS API Documentation
20030
21074
  #
@@ -20037,6 +21081,8 @@ module Aws::RDS
20037
21081
 
20038
21082
  # Stops automated backup replication for a DB instance.
20039
21083
  #
21084
+ # This command doesn't apply to RDS Custom.
21085
+ #
20040
21086
  # For more information, see [ Replicating Automated Backups to Another
20041
21087
  # Amazon Web Services Region][1] in the *Amazon RDS User Guide.*
20042
21088
  #
@@ -20089,6 +21135,7 @@ module Aws::RDS
20089
21135
  # resp.db_instance_automated_backup.db_instance_automated_backups_arn #=> String
20090
21136
  # resp.db_instance_automated_backup.db_instance_automated_backups_replications #=> Array
20091
21137
  # resp.db_instance_automated_backup.db_instance_automated_backups_replications[0].db_instance_automated_backups_arn #=> String
21138
+ # resp.db_instance_automated_backup.backup_target #=> String
20092
21139
  #
20093
21140
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StopDBInstanceAutomatedBackupsReplication AWS API Documentation
20094
21141
  #
@@ -20112,7 +21159,7 @@ module Aws::RDS
20112
21159
  params: params,
20113
21160
  config: config)
20114
21161
  context[:gem_name] = 'aws-sdk-rds'
20115
- context[:gem_version] = '1.127.0'
21162
+ context[:gem_version] = '1.131.0'
20116
21163
  Seahorse::Client::Request.new(handlers, context)
20117
21164
  end
20118
21165