aws-sdk-rds 1.126.0 → 1.130.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
@@ -1847,6 +1855,242 @@ module Aws::RDS
1847
1855
  req.send_request(options)
1848
1856
  end
1849
1857
 
1858
+ # Creates a custom DB engine version (CEV). A CEV is a binary volume
1859
+ # snapshot of a database engine and specific AMI. The only supported
1860
+ # engine is Oracle Database 19c Enterprise Edition with the January 2021
1861
+ # or later RU/RUR. For more information, see [ Amazon RDS Custom
1862
+ # requirements and limitations][1] in the *Amazon RDS User Guide*.
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. For more information,
1869
+ # see [ Preparing to create a CEV][2] in the *Amazon RDS User Guide*.
1870
+ #
1871
+ # When you create a custom engine version, you specify the files in a
1872
+ # JSON document called a CEV manifest. This document describes
1873
+ # installation .zip files stored in Amazon S3. RDS Custom creates your
1874
+ # CEV from the installation files that you provided. This service model
1875
+ # is called Bring Your Own Media (BYOM).
1876
+ #
1877
+ # Creation takes approximately two hours. If creation fails, RDS Custom
1878
+ # issues `RDS-EVENT-0196` with the message `Creation failed for custom
1879
+ # engine version`, and includes details about the failure. For example,
1880
+ # the event prints missing files.
1881
+ #
1882
+ # After you create the CEV, it is available for use. You can create
1883
+ # multiple CEVs, and create multiple RDS Custom instances from any CEV.
1884
+ # You can also change the status of a CEV to make it available or
1885
+ # inactive.
1886
+ #
1887
+ # <note markdown="1"> The MediaImport service that imports files from Amazon S3 to create
1888
+ # CEVs isn't integrated with Amazon Web Services CloudTrail. If you
1889
+ # turn on data logging for Amazon RDS in CloudTrail, calls to the
1890
+ # `CreateCustomDbEngineVersion` event aren't logged. However, you might
1891
+ # see calls from the API gateway that accesses your Amazon S3 bucket.
1892
+ # These calls originate from the MediaImport service for the
1893
+ # `CreateCustomDbEngineVersion` event.
1894
+ #
1895
+ # </note>
1896
+ #
1897
+ # For more information, see [ Creating a CEV][3] in the *Amazon RDS User
1898
+ # Guide*.
1899
+ #
1900
+ #
1901
+ #
1902
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.preparing.manifest
1903
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.html#custom-cev.preparing
1904
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.create
1905
+ #
1906
+ # @option params [required, String] :engine
1907
+ # The database engine to use for your custom engine version (CEV). The
1908
+ # only supported value is `custom-oracle-ee`.
1909
+ #
1910
+ # @option params [required, String] :engine_version
1911
+ # The name of your CEV. The name format is `19.customized_string `. For
1912
+ # example, a valid name is `19.my_cev1`. This setting is required for
1913
+ # RDS Custom, but optional for Amazon RDS. The combination of `Engine`
1914
+ # and `EngineVersion` is unique per customer per Region.
1915
+ #
1916
+ # @option params [required, String] :database_installation_files_s3_bucket_name
1917
+ # The name of an Amazon S3 bucket that contains database installation
1918
+ # files for your CEV. For example, a valid bucket name is
1919
+ # `my-custom-installation-files`.
1920
+ #
1921
+ # @option params [String] :database_installation_files_s3_prefix
1922
+ # The Amazon S3 directory that contains the database installation files
1923
+ # for your CEV. For example, a valid bucket name is `123456789012/cev1`.
1924
+ # If this setting isn't specified, no prefix is assumed.
1925
+ #
1926
+ # @option params [required, String] :kms_key_id
1927
+ # The Amazon Web Services KMS key identifier for an encrypted CEV. A
1928
+ # symmetric KMS key is required for RDS Custom, but optional for Amazon
1929
+ # RDS.
1930
+ #
1931
+ # If you have an existing symmetric KMS key in your account, you can use
1932
+ # it with RDS Custom. No further action is necessary. If you don't
1933
+ # already have a symmetric KMS key in your account, follow the
1934
+ # instructions in [ Creating symmetric KMS keys][1] in the *Amazon Web
1935
+ # Services Key Management Service Developer Guide*.
1936
+ #
1937
+ # You can choose the same symmetric key when you create a CEV and a DB
1938
+ # instance, or choose different keys.
1939
+ #
1940
+ #
1941
+ #
1942
+ # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html#create-symmetric-cmk
1943
+ #
1944
+ # @option params [String] :description
1945
+ # An optional description of your CEV.
1946
+ #
1947
+ # @option params [required, String] :manifest
1948
+ # The CEV manifest, which is a JSON document that describes the
1949
+ # installation .zip files stored in Amazon S3. Specify the name/value
1950
+ # pairs in a file or a quoted string. RDS Custom applies the patches in
1951
+ # the order in which they are listed.
1952
+ #
1953
+ # The following JSON fields are valid:
1954
+ #
1955
+ # MediaImportTemplateVersion
1956
+ #
1957
+ # : Version of the CEV manifest. The date is in the format `YYYY-MM-DD`.
1958
+ #
1959
+ # databaseInstallationFileNames
1960
+ #
1961
+ # : Ordered list of installation files for the CEV.
1962
+ #
1963
+ # opatchFileNames
1964
+ #
1965
+ # : Ordered list of OPatch installers used for the Oracle DB engine.
1966
+ #
1967
+ # psuRuPatchFileNames
1968
+ #
1969
+ # : The PSU and RU patches for this CEV.
1970
+ #
1971
+ # OtherPatchFileNames
1972
+ #
1973
+ # : The patches that are not in the list of PSU and RU patches. Amazon
1974
+ # RDS applies these patches after applying the PSU and RU patches.
1975
+ #
1976
+ # For more information, see [ Creating the CEV manifest][1] in the
1977
+ # *Amazon RDS User Guide*.
1978
+ #
1979
+ #
1980
+ #
1981
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.preparing.manifest
1982
+ #
1983
+ # @option params [Array<Types::Tag>] :tags
1984
+ # A list of tags. For more information, see [Tagging Amazon RDS
1985
+ # Resources][1] in the *Amazon RDS User Guide.*
1986
+ #
1987
+ #
1988
+ #
1989
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
1990
+ #
1991
+ # @return [Types::DBEngineVersion] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1992
+ #
1993
+ # * {Types::DBEngineVersion#engine #engine} => String
1994
+ # * {Types::DBEngineVersion#engine_version #engine_version} => String
1995
+ # * {Types::DBEngineVersion#db_parameter_group_family #db_parameter_group_family} => String
1996
+ # * {Types::DBEngineVersion#db_engine_description #db_engine_description} => String
1997
+ # * {Types::DBEngineVersion#db_engine_version_description #db_engine_version_description} => String
1998
+ # * {Types::DBEngineVersion#default_character_set #default_character_set} => Types::CharacterSet
1999
+ # * {Types::DBEngineVersion#supported_character_sets #supported_character_sets} => Array&lt;Types::CharacterSet&gt;
2000
+ # * {Types::DBEngineVersion#supported_nchar_character_sets #supported_nchar_character_sets} => Array&lt;Types::CharacterSet&gt;
2001
+ # * {Types::DBEngineVersion#valid_upgrade_target #valid_upgrade_target} => Array&lt;Types::UpgradeTarget&gt;
2002
+ # * {Types::DBEngineVersion#supported_timezones #supported_timezones} => Array&lt;Types::Timezone&gt;
2003
+ # * {Types::DBEngineVersion#exportable_log_types #exportable_log_types} => Array&lt;String&gt;
2004
+ # * {Types::DBEngineVersion#supports_log_exports_to_cloudwatch_logs #supports_log_exports_to_cloudwatch_logs} => Boolean
2005
+ # * {Types::DBEngineVersion#supports_read_replica #supports_read_replica} => Boolean
2006
+ # * {Types::DBEngineVersion#supported_engine_modes #supported_engine_modes} => Array&lt;String&gt;
2007
+ # * {Types::DBEngineVersion#supported_feature_names #supported_feature_names} => Array&lt;String&gt;
2008
+ # * {Types::DBEngineVersion#status #status} => String
2009
+ # * {Types::DBEngineVersion#supports_parallel_query #supports_parallel_query} => Boolean
2010
+ # * {Types::DBEngineVersion#supports_global_databases #supports_global_databases} => Boolean
2011
+ # * {Types::DBEngineVersion#major_engine_version #major_engine_version} => String
2012
+ # * {Types::DBEngineVersion#database_installation_files_s3_bucket_name #database_installation_files_s3_bucket_name} => String
2013
+ # * {Types::DBEngineVersion#database_installation_files_s3_prefix #database_installation_files_s3_prefix} => String
2014
+ # * {Types::DBEngineVersion#db_engine_version_arn #db_engine_version_arn} => String
2015
+ # * {Types::DBEngineVersion#kms_key_id #kms_key_id} => String
2016
+ # * {Types::DBEngineVersion#create_time #create_time} => Time
2017
+ # * {Types::DBEngineVersion#tag_list #tag_list} => Array&lt;Types::Tag&gt;
2018
+ #
2019
+ # @example Request syntax with placeholder values
2020
+ #
2021
+ # resp = client.create_custom_db_engine_version({
2022
+ # engine: "CustomEngineName", # required
2023
+ # engine_version: "CustomEngineVersion", # required
2024
+ # database_installation_files_s3_bucket_name: "BucketName", # required
2025
+ # database_installation_files_s3_prefix: "String255",
2026
+ # kms_key_id: "KmsKeyIdOrArn", # required
2027
+ # description: "Description",
2028
+ # manifest: "CustomDBEngineVersionManifest", # required
2029
+ # tags: [
2030
+ # {
2031
+ # key: "String",
2032
+ # value: "String",
2033
+ # },
2034
+ # ],
2035
+ # })
2036
+ #
2037
+ # @example Response structure
2038
+ #
2039
+ # resp.engine #=> String
2040
+ # resp.engine_version #=> String
2041
+ # resp.db_parameter_group_family #=> String
2042
+ # resp.db_engine_description #=> String
2043
+ # resp.db_engine_version_description #=> String
2044
+ # resp.default_character_set.character_set_name #=> String
2045
+ # resp.default_character_set.character_set_description #=> String
2046
+ # resp.supported_character_sets #=> Array
2047
+ # resp.supported_character_sets[0].character_set_name #=> String
2048
+ # resp.supported_character_sets[0].character_set_description #=> String
2049
+ # resp.supported_nchar_character_sets #=> Array
2050
+ # resp.supported_nchar_character_sets[0].character_set_name #=> String
2051
+ # resp.supported_nchar_character_sets[0].character_set_description #=> String
2052
+ # resp.valid_upgrade_target #=> Array
2053
+ # resp.valid_upgrade_target[0].engine #=> String
2054
+ # resp.valid_upgrade_target[0].engine_version #=> String
2055
+ # resp.valid_upgrade_target[0].description #=> String
2056
+ # resp.valid_upgrade_target[0].auto_upgrade #=> Boolean
2057
+ # resp.valid_upgrade_target[0].is_major_version_upgrade #=> Boolean
2058
+ # resp.valid_upgrade_target[0].supported_engine_modes #=> Array
2059
+ # resp.valid_upgrade_target[0].supported_engine_modes[0] #=> String
2060
+ # resp.valid_upgrade_target[0].supports_parallel_query #=> Boolean
2061
+ # resp.valid_upgrade_target[0].supports_global_databases #=> Boolean
2062
+ # resp.supported_timezones #=> Array
2063
+ # resp.supported_timezones[0].timezone_name #=> String
2064
+ # resp.exportable_log_types #=> Array
2065
+ # resp.exportable_log_types[0] #=> String
2066
+ # resp.supports_log_exports_to_cloudwatch_logs #=> Boolean
2067
+ # resp.supports_read_replica #=> Boolean
2068
+ # resp.supported_engine_modes #=> Array
2069
+ # resp.supported_engine_modes[0] #=> String
2070
+ # resp.supported_feature_names #=> Array
2071
+ # resp.supported_feature_names[0] #=> String
2072
+ # resp.status #=> String
2073
+ # resp.supports_parallel_query #=> Boolean
2074
+ # resp.supports_global_databases #=> Boolean
2075
+ # resp.major_engine_version #=> String
2076
+ # resp.database_installation_files_s3_bucket_name #=> String
2077
+ # resp.database_installation_files_s3_prefix #=> String
2078
+ # resp.db_engine_version_arn #=> String
2079
+ # resp.kms_key_id #=> String
2080
+ # resp.create_time #=> Time
2081
+ # resp.tag_list #=> Array
2082
+ # resp.tag_list[0].key #=> String
2083
+ # resp.tag_list[0].value #=> String
2084
+ #
2085
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateCustomDBEngineVersion AWS API Documentation
2086
+ #
2087
+ # @overload create_custom_db_engine_version(params = {})
2088
+ # @param [Hash] params ({})
2089
+ def create_custom_db_engine_version(params = {}, options = {})
2090
+ req = build_request(:create_custom_db_engine_version, params)
2091
+ req.send_request(options)
2092
+ end
2093
+
1850
2094
  # Creates a new Amazon Aurora DB cluster.
1851
2095
  #
1852
2096
  # You can use the `ReplicationSourceIdentifier` parameter to create the
@@ -2061,29 +2305,29 @@ module Aws::RDS
2061
2305
  # cluster.
2062
2306
  #
2063
2307
  # 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.
2308
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
2309
+ # different Amazon Web Services account, specify the key ARN or alias
2310
+ # ARN.
2067
2311
  #
2068
- # When a CMK isn't specified in `KmsKeyId`\:
2312
+ # When a KMS key isn't specified in `KmsKeyId`\:
2069
2313
  #
2070
2314
  # * 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.
2315
+ # then Amazon RDS will use the KMS key used to encrypt the source.
2316
+ # Otherwise, Amazon RDS will use your default KMS key.
2073
2317
  #
2074
2318
  # * If the `StorageEncrypted` parameter is enabled and
2075
2319
  # `ReplicationSourceIdentifier` isn't specified, then Amazon RDS will
2076
- # use your default CMK.
2320
+ # use your default KMS key.
2077
2321
  #
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
2322
+ # There is a default KMS key for your Amazon Web Services account. Your
2323
+ # Amazon Web Services account has a different default KMS key for each
2080
2324
  # Amazon Web Services Region.
2081
2325
  #
2082
2326
  # 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.
2327
+ # Amazon Web Services Region, you must set `KmsKeyId` to a KMS key
2328
+ # identifier that is valid in the destination Amazon Web Services
2329
+ # Region. This KMS key is used to encrypt the read replica in that
2330
+ # Amazon Web Services Region.
2087
2331
  #
2088
2332
  # @option params [String] :pre_signed_url
2089
2333
  # A URL that contains a Signature Version 4 signed request for the
@@ -2099,12 +2343,12 @@ module Aws::RDS
2099
2343
  # The pre-signed URL request must contain the following parameter
2100
2344
  # values:
2101
2345
  #
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.
2346
+ # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
2347
+ # key to use to encrypt the copy of the DB cluster in the destination
2348
+ # Amazon Web Services Region. This should refer to the same KMS key
2349
+ # for both the `CreateDBCluster` action that is called in the
2350
+ # destination Amazon Web Services Region, and the action contained in
2351
+ # the pre-signed URL.
2108
2352
  #
2109
2353
  # * `DestinationRegion` - The name of the Amazon Web Services Region
2110
2354
  # that Aurora read replica will be created in.
@@ -2360,6 +2604,7 @@ module Aws::RDS
2360
2604
  # auto_pause: false,
2361
2605
  # seconds_until_auto_pause: 1,
2362
2606
  # timeout_action: "String",
2607
+ # seconds_before_timeout: 1,
2363
2608
  # },
2364
2609
  # deletion_protection: false,
2365
2610
  # global_cluster_identifier: "String",
@@ -2436,6 +2681,7 @@ module Aws::RDS
2436
2681
  # resp.db_cluster.scaling_configuration_info.auto_pause #=> Boolean
2437
2682
  # resp.db_cluster.scaling_configuration_info.seconds_until_auto_pause #=> Integer
2438
2683
  # resp.db_cluster.scaling_configuration_info.timeout_action #=> String
2684
+ # resp.db_cluster.scaling_configuration_info.seconds_before_timeout #=> Integer
2439
2685
  # resp.db_cluster.deletion_protection #=> Boolean
2440
2686
  # resp.db_cluster.http_endpoint_enabled #=> Boolean
2441
2687
  # resp.db_cluster.activity_stream_mode #=> String, one of "sync", "async"
@@ -2881,6 +3127,21 @@ module Aws::RDS
2881
3127
  #
2882
3128
  # ^
2883
3129
  #
3130
+ # **Amazon RDS Custom**
3131
+ #
3132
+ # The Oracle System ID (SID) of the created RDS Custom DB instance. If
3133
+ # you don't specify a value, the default value is `ORCL`.
3134
+ #
3135
+ # Default: `ORCL`
3136
+ #
3137
+ # Constraints:
3138
+ #
3139
+ # * It must contain 1 to 8 alphanumeric characters.
3140
+ #
3141
+ # * It must contain a letter.
3142
+ #
3143
+ # * It can't be a word reserved by the database engine.
3144
+ #
2884
3145
  # **SQL Server**
2885
3146
  #
2886
3147
  # Not applicable. Must be null.
@@ -2940,6 +3201,16 @@ module Aws::RDS
2940
3201
  # amount of data in your database increases, though you are only charged
2941
3202
  # for the space that you use in an Aurora cluster volume.
2942
3203
  #
3204
+ # **Amazon RDS Custom**
3205
+ #
3206
+ # Constraints to the amount of storage for each storage type are the
3207
+ # following:
3208
+ #
3209
+ # * General Purpose (SSD) storage (gp2): Must be an integer from 40 to
3210
+ # 65536.
3211
+ #
3212
+ # * Provisioned IOPS storage (io1): Must be an integer from 40 to 65536.
3213
+ #
2943
3214
  # **MySQL**
2944
3215
  #
2945
3216
  # Constraints to the amount of storage for each storage type are the
@@ -3043,6 +3314,8 @@ module Aws::RDS
3043
3314
  #
3044
3315
  # * `aurora-postgresql`
3045
3316
  #
3317
+ # * `custom-oracle-ee (for RDS Custom instances)`
3318
+ #
3046
3319
  # * `mariadb`
3047
3320
  #
3048
3321
  # * `mysql`
@@ -3235,6 +3508,8 @@ module Aws::RDS
3235
3508
  # If you do not specify a value, then the default DB parameter group for
3236
3509
  # the specified DB engine and version is used.
3237
3510
  #
3511
+ # This setting doesn't apply to RDS Custom.
3512
+ #
3238
3513
  # Constraints:
3239
3514
  #
3240
3515
  # * Must be 1 to 255 letters, numbers, or hyphens.
@@ -3261,6 +3536,8 @@ module Aws::RDS
3261
3536
  #
3262
3537
  # * Can't be set to 0 if the DB instance is a source to read replicas
3263
3538
  #
3539
+ # * Can't be set to 0 or 35 for an RDS Custom DB instance
3540
+ #
3264
3541
  # @option params [String] :preferred_backup_window
3265
3542
  # The daily time range during which automated backups are created if
3266
3543
  # automated backups are enabled, using the `BackupRetentionPeriod`
@@ -3340,6 +3617,8 @@ module Aws::RDS
3340
3617
  # deployment. You can't set the `AvailabilityZone` parameter if the DB
3341
3618
  # instance is a Multi-AZ deployment.
3342
3619
  #
3620
+ # This setting doesn't apply to RDS Custom.
3621
+ #
3343
3622
  # @option params [String] :engine_version
3344
3623
  # The version number of the database engine to use.
3345
3624
  #
@@ -3356,49 +3635,63 @@ module Aws::RDS
3356
3635
  # Not applicable. The version number of the database engine to be used
3357
3636
  # by the DB instance is managed by the DB cluster.
3358
3637
  #
3638
+ # **Amazon RDS Custom**
3639
+ #
3640
+ # A custom engine version (CEV) that you have previously created. This
3641
+ # setting is required for RDS Custom. The CEV name has the following
3642
+ # format: `19.customized_string `. An example identifier is
3643
+ # `19.my_cev1`. For more information, see [ Creating an RDS Custom DB
3644
+ # instance][1] in the *Amazon RDS User Guide.*.
3645
+ #
3359
3646
  # **MariaDB**
3360
3647
  #
3361
- # See [MariaDB on Amazon RDS Versions][1] in the *Amazon RDS User
3648
+ # See [MariaDB on Amazon RDS Versions][2] in the *Amazon RDS User
3362
3649
  # Guide.*
3363
3650
  #
3364
3651
  # **Microsoft SQL Server**
3365
3652
  #
3366
- # See [Microsoft SQL Server Versions on Amazon RDS][2] in the *Amazon
3653
+ # See [Microsoft SQL Server Versions on Amazon RDS][3] in the *Amazon
3367
3654
  # RDS User Guide.*
3368
3655
  #
3369
3656
  # **MySQL**
3370
3657
  #
3371
- # See [MySQL on Amazon RDS Versions][3] in the *Amazon RDS User Guide.*
3658
+ # See [MySQL on Amazon RDS Versions][4] in the *Amazon RDS User Guide.*
3372
3659
  #
3373
3660
  # **Oracle**
3374
3661
  #
3375
- # See [Oracle Database Engine Release Notes][4] in the *Amazon RDS User
3662
+ # See [Oracle Database Engine Release Notes][5] in the *Amazon RDS User
3376
3663
  # Guide.*
3377
3664
  #
3378
3665
  # **PostgreSQL**
3379
3666
  #
3380
- # See [Amazon RDS for PostgreSQL versions and extensions][5] in the
3667
+ # See [Amazon RDS for PostgreSQL versions and extensions][6] in the
3381
3668
  # *Amazon RDS User Guide.*
3382
3669
  #
3383
3670
  #
3384
3671
  #
3385
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
3386
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
3387
- # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
3388
- # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
3389
- # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
3672
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-creating.html#custom-creating.create
3673
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
3674
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
3675
+ # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
3676
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
3677
+ # [6]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
3390
3678
  #
3391
3679
  # @option params [Boolean] :auto_minor_version_upgrade
3392
3680
  # A value that indicates whether minor engine upgrades are applied
3393
3681
  # automatically to the DB instance during the maintenance window. By
3394
3682
  # default, minor engine upgrades are applied automatically.
3395
3683
  #
3684
+ # If you create an RDS Custom DB instance, you must set
3685
+ # `AutoMinorVersionUpgrade` to `false`.
3686
+ #
3396
3687
  # @option params [String] :license_model
3397
3688
  # License model information for this DB instance.
3398
3689
  #
3399
3690
  # Valid values: `license-included` \| `bring-your-own-license` \|
3400
3691
  # `general-public-license`
3401
3692
  #
3693
+ # This setting doesn't apply to RDS Custom.
3694
+ #
3402
3695
  # @option params [Integer] :iops
3403
3696
  # The amount of Provisioned IOPS (input/output operations per second) to
3404
3697
  # be initially allocated for the DB instance. For information about
@@ -3420,12 +3713,17 @@ module Aws::RDS
3420
3713
  #
3421
3714
  # Permanent options, such as the TDE option for Oracle Advanced Security
3422
3715
  # TDE, can't be removed from an option group. Also, that option group
3423
- # can't be removed from a DB instance once it is associated with a DB
3424
- # instance
3716
+ # can't be removed from a DB instance after it is associated with a DB
3717
+ # instance.
3718
+ #
3719
+ # This setting doesn't apply to RDS Custom.
3425
3720
  #
3426
3721
  # @option params [String] :character_set_name
3427
- # For supported engines, indicates that the DB instance should be
3428
- # associated with the specified CharacterSet.
3722
+ # For supported engines, this value indicates that the DB instance
3723
+ # should be associated with the specified `CharacterSet`.
3724
+ #
3725
+ # This setting doesn't apply to RDS Custom. However, if you need to
3726
+ # change the character set, you can change it on the database itself.
3429
3727
  #
3430
3728
  # **Amazon Aurora**
3431
3729
  #
@@ -3435,6 +3733,8 @@ module Aws::RDS
3435
3733
  # @option params [String] :nchar_character_set_name
3436
3734
  # The name of the NCHAR character set for the Oracle DB instance.
3437
3735
  #
3736
+ # This parameter doesn't apply to RDS Custom.
3737
+ #
3438
3738
  # @option params [Boolean] :publicly_accessible
3439
3739
  # A value that indicates whether the DB instance is publicly accessible.
3440
3740
  #
@@ -3475,6 +3775,8 @@ module Aws::RDS
3475
3775
  # @option params [String] :db_cluster_identifier
3476
3776
  # The identifier of the DB cluster that the instance will belong to.
3477
3777
  #
3778
+ # This setting doesn't apply to RDS Custom.
3779
+ #
3478
3780
  # @option params [String] :storage_type
3479
3781
  # Specifies the storage type to be associated with the DB instance.
3480
3782
  #
@@ -3489,14 +3791,22 @@ module Aws::RDS
3489
3791
  # The ARN from the key store with which to associate the instance for
3490
3792
  # TDE encryption.
3491
3793
  #
3794
+ # This setting doesn't apply to RDS Custom.
3795
+ #
3492
3796
  # @option params [String] :tde_credential_password
3493
3797
  # The password for the given ARN from the key store in order to access
3494
3798
  # the device.
3495
3799
  #
3800
+ # This setting doesn't apply to RDS Custom.
3801
+ #
3496
3802
  # @option params [Boolean] :storage_encrypted
3497
3803
  # A value that indicates whether the DB instance is encrypted. By
3498
3804
  # default, it isn't encrypted.
3499
3805
  #
3806
+ # For RDS Custom Oracle instances, either set this parameter to `true`
3807
+ # or leave it unset. If you set this parameter to `false`, RDS reports
3808
+ # an error.
3809
+ #
3500
3810
  # **Amazon Aurora**
3501
3811
  #
3502
3812
  # Not applicable. The encryption for DB instances is managed by the DB
@@ -3507,9 +3817,9 @@ module Aws::RDS
3507
3817
  # instance.
3508
3818
  #
3509
3819
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
3510
- # alias ARN, or alias name for the Amazon Web Services KMS customer
3511
- # master key (CMK). To use a CMK in a different Amazon Web Services
3512
- # account, specify the key ARN or alias ARN.
3820
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
3821
+ # different Amazon Web Services account, specify the key ARN or alias
3822
+ # ARN.
3513
3823
  #
3514
3824
  # **Amazon Aurora**
3515
3825
  #
@@ -3517,10 +3827,18 @@ module Aws::RDS
3517
3827
  # by the DB cluster. For more information, see `CreateDBCluster`.
3518
3828
  #
3519
3829
  # If `StorageEncrypted` is enabled, and you do not specify a value for
3520
- # the `KmsKeyId` parameter, then Amazon RDS uses your default CMK. There
3521
- # is a default CMK for your Amazon Web Services account. Your Amazon Web
3522
- # Services account has a different default CMK for each Amazon Web
3523
- # Services Region.
3830
+ # the `KmsKeyId` parameter, then Amazon RDS uses your default KMS key.
3831
+ # There is a default KMS key for your Amazon Web Services account. Your
3832
+ # Amazon Web Services account has a different default KMS key for each
3833
+ # Amazon Web Services Region.
3834
+ #
3835
+ # **Amazon RDS Custom**
3836
+ #
3837
+ # A KMS key is required for RDS Custom Oracle instances. For most RDS
3838
+ # engines, if you leave this parameter empty while enabling
3839
+ # `StorageEncrypted`, the engine uses the default KMS key. However, RDS
3840
+ # Custom for Oracle doesn't use the default key when this parameter is
3841
+ # empty. You must explicitly specify a key.
3524
3842
  #
3525
3843
  # @option params [String] :domain
3526
3844
  # The Active Directory directory ID to create the DB instance in.
@@ -3530,6 +3848,8 @@ module Aws::RDS
3530
3848
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
3531
3849
  # RDS User Guide*.
3532
3850
  #
3851
+ # This setting doesn't apply to RDS Custom.
3852
+ #
3533
3853
  #
3534
3854
  #
3535
3855
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -3546,24 +3866,28 @@ module Aws::RDS
3546
3866
  #
3547
3867
  # @option params [Integer] :monitoring_interval
3548
3868
  # The interval, in seconds, between points when Enhanced Monitoring
3549
- # metrics are collected for the DB instance. To disable collecting
3869
+ # metrics are collected for the DB instance. To disable collection of
3550
3870
  # Enhanced Monitoring metrics, specify 0. The default is 0.
3551
3871
  #
3552
- # If `MonitoringRoleArn` is specified, then you must also set
3872
+ # If `MonitoringRoleArn` is specified, then you must set
3553
3873
  # `MonitoringInterval` to a value other than 0.
3554
3874
  #
3875
+ # This setting doesn't apply to RDS Custom.
3876
+ #
3555
3877
  # Valid Values: `0, 1, 5, 10, 15, 30, 60`
3556
3878
  #
3557
3879
  # @option params [String] :monitoring_role_arn
3558
3880
  # The ARN for the IAM role that permits RDS to send enhanced monitoring
3559
3881
  # metrics to Amazon CloudWatch Logs. For example,
3560
3882
  # `arn:aws:iam:123456789012:role/emaccess`. For information on creating
3561
- # a monitoring role, go to [Setting Up and Enabling Enhanced
3883
+ # a monitoring role, see [Setting Up and Enabling Enhanced
3562
3884
  # Monitoring][1] in the *Amazon RDS User Guide*.
3563
3885
  #
3564
3886
  # If `MonitoringInterval` is set to a value other than 0, then you must
3565
3887
  # supply a `MonitoringRoleArn` value.
3566
3888
  #
3889
+ # This setting doesn't apply to RDS Custom.
3890
+ #
3567
3891
  #
3568
3892
  #
3569
3893
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
@@ -3572,12 +3896,16 @@ module Aws::RDS
3572
3896
  # Specify the name of the IAM role to be used when making API calls to
3573
3897
  # the Directory Service.
3574
3898
  #
3899
+ # This setting doesn't apply to RDS Custom.
3900
+ #
3575
3901
  # @option params [Integer] :promotion_tier
3576
3902
  # A value that specifies the order in which an Aurora Replica is
3577
3903
  # promoted to the primary instance after a failure of the existing
3578
3904
  # primary instance. For more information, see [ Fault Tolerance for an
3579
3905
  # Aurora DB Cluster][1] in the *Amazon Aurora User Guide*.
3580
3906
  #
3907
+ # This setting doesn't apply to RDS Custom.
3908
+ #
3581
3909
  # Default: 1
3582
3910
  #
3583
3911
  # Valid Values: 0 - 15
@@ -3599,9 +3927,9 @@ module Aws::RDS
3599
3927
  # Services Identity and Access Management (IAM) accounts to database
3600
3928
  # accounts. By default, mapping is disabled.
3601
3929
  #
3602
- # This setting doesn't apply to Amazon Aurora. Mapping Amazon Web
3603
- # Services IAM accounts to database accounts is managed by the DB
3604
- # cluster.
3930
+ # This setting doesn't apply to RDS Custom or Amazon Aurora. In Aurora,
3931
+ # mapping Amazon Web Services IAM accounts to database accounts is
3932
+ # managed by the DB cluster.
3605
3933
  #
3606
3934
  # For more information, see [ IAM Database Authentication for MySQL and
3607
3935
  # PostgreSQL][1] in the *Amazon RDS User Guide.*
@@ -3612,10 +3940,10 @@ module Aws::RDS
3612
3940
  #
3613
3941
  # @option params [Boolean] :enable_performance_insights
3614
3942
  # A value that indicates whether to enable Performance Insights for the
3615
- # DB instance.
3943
+ # DB instance. For more information, see [Using Amazon Performance
3944
+ # Insights][1] in the *Amazon Relational Database Service User Guide*.
3616
3945
  #
3617
- # For more information, see [Using Amazon Performance Insights][1] in
3618
- # the *Amazon Relational Database Service User Guide*.
3946
+ # This setting doesn't apply to RDS Custom.
3619
3947
  #
3620
3948
  #
3621
3949
  #
@@ -3626,29 +3954,35 @@ module Aws::RDS
3626
3954
  # Performance Insights data.
3627
3955
  #
3628
3956
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
3629
- # alias ARN, or alias name for the Amazon Web Services KMS customer
3630
- # master key (CMK).
3957
+ # alias ARN, or alias name for the KMS key.
3631
3958
  #
3632
3959
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
3633
- # Amazon RDS uses your default CMK. There is a default CMK for your
3634
- # Amazon Web Services account. Your Amazon Web Services account has a
3635
- # different default CMK for each Amazon Web Services Region.
3960
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
3961
+ # your Amazon Web Services account. Your Amazon Web Services account has
3962
+ # a different default KMS key for each Amazon Web Services Region.
3963
+ #
3964
+ # This setting doesn't apply to RDS Custom.
3636
3965
  #
3637
3966
  # @option params [Integer] :performance_insights_retention_period
3638
3967
  # The amount of time, in days, to retain Performance Insights data.
3639
3968
  # Valid values are 7 or 731 (2 years).
3640
3969
  #
3970
+ # This setting doesn't apply to RDS Custom.
3971
+ #
3641
3972
  # @option params [Array<String>] :enable_cloudwatch_logs_exports
3642
3973
  # The list of log types that need to be enabled for exporting to
3643
- # CloudWatch Logs. The values in the list depend on the DB engine being
3644
- # used. For more information, see [Publishing Database Logs to Amazon
3645
- # CloudWatch Logs ][1] in the *Amazon Relational Database Service User
3646
- # Guide*.
3974
+ # CloudWatch Logs. The values in the list depend on the DB engine. For
3975
+ # more information, see [Publishing Database Logs to Amazon CloudWatch
3976
+ # Logs][1] in the *Amazon Relational Database Service User Guide*.
3647
3977
  #
3648
3978
  # **Amazon Aurora**
3649
3979
  #
3650
3980
  # Not applicable. CloudWatch Logs exports are managed by the DB cluster.
3651
3981
  #
3982
+ # **RDS Custom**
3983
+ #
3984
+ # Not applicable.
3985
+ #
3652
3986
  # **MariaDB**
3653
3987
  #
3654
3988
  # Possible values are `audit`, `error`, `general`, and `slowquery`.
@@ -3678,6 +4012,8 @@ module Aws::RDS
3678
4012
  # The number of CPU cores and the number of threads per core for the DB
3679
4013
  # instance class of the DB instance.
3680
4014
  #
4015
+ # This setting doesn't apply to RDS Custom.
4016
+ #
3681
4017
  # @option params [Boolean] :deletion_protection
3682
4018
  # A value that indicates whether the DB instance has deletion protection
3683
4019
  # enabled. The database can't be deleted when deletion protection is
@@ -3703,6 +4039,8 @@ module Aws::RDS
3703
4039
  # apply to it, see [ Managing capacity automatically with Amazon RDS
3704
4040
  # storage autoscaling][1] in the *Amazon RDS User Guide*.
3705
4041
  #
4042
+ # This setting doesn't apply to RDS Custom.
4043
+ #
3706
4044
  #
3707
4045
  #
3708
4046
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -3728,6 +4066,29 @@ module Aws::RDS
3728
4066
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
3729
4067
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
3730
4068
  #
4069
+ # @option params [String] :custom_iam_instance_profile
4070
+ # The instance profile associated with the underlying Amazon EC2
4071
+ # instance of an RDS Custom DB instance. The instance profile must meet
4072
+ # the following requirements:
4073
+ #
4074
+ # * The profile must exist in your account.
4075
+ #
4076
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
4077
+ # assume.
4078
+ #
4079
+ # * The instance profile name and the associated IAM role name must
4080
+ # start with the prefix `AWSRDSCustom`.
4081
+ #
4082
+ # For the list of permissions required for the IAM role, see [ Configure
4083
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
4084
+ # Guide*.
4085
+ #
4086
+ # This setting is required for RDS Custom.
4087
+ #
4088
+ #
4089
+ #
4090
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
4091
+ #
3731
4092
  # @return [Types::CreateDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3732
4093
  #
3733
4094
  # * {Types::CreateDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -3813,6 +4174,7 @@ module Aws::RDS
3813
4174
  # deletion_protection: false,
3814
4175
  # max_allocated_storage: 1,
3815
4176
  # enable_customer_owned_ip: false,
4177
+ # custom_iam_instance_profile: "String",
3816
4178
  # })
3817
4179
  #
3818
4180
  # @example Response structure
@@ -3873,6 +4235,8 @@ module Aws::RDS
3873
4235
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
3874
4236
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
3875
4237
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
4238
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
4239
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
3876
4240
  # resp.db_instance.latest_restorable_time #=> Time
3877
4241
  # resp.db_instance.multi_az #=> Boolean
3878
4242
  # resp.db_instance.engine_version #=> String
@@ -3947,6 +4311,9 @@ module Aws::RDS
3947
4311
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
3948
4312
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
3949
4313
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
4314
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
4315
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
4316
+ # resp.db_instance.custom_iam_instance_profile #=> String
3950
4317
  #
3951
4318
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstance AWS API Documentation
3952
4319
  #
@@ -4015,8 +4382,8 @@ module Aws::RDS
4015
4382
  # * If the source DB instance is in a different Amazon Web Services
4016
4383
  # Region from the read replica, specify a valid DB instance ARN. For
4017
4384
  # more information, see [Constructing an ARN for Amazon RDS][3] in the
4018
- # *Amazon RDS User Guide*. This doesn't apply to SQL Server, which
4019
- # doesn't support cross-region replicas.
4385
+ # *Amazon RDS User Guide*. This doesn't apply to SQL Server or RDS
4386
+ # Custom, which don't support cross-Region replicas.
4020
4387
  #
4021
4388
  #
4022
4389
  #
@@ -4062,10 +4429,14 @@ module Aws::RDS
4062
4429
  # instance is independent of whether the source database is a Multi-AZ
4063
4430
  # DB instance.
4064
4431
  #
4432
+ # This setting doesn't apply to RDS Custom.
4433
+ #
4065
4434
  # @option params [Boolean] :auto_minor_version_upgrade
4066
4435
  # A value that indicates whether minor engine upgrades are applied
4067
4436
  # automatically to the read replica during the maintenance window.
4068
4437
  #
4438
+ # This setting doesn't apply to RDS Custom.
4439
+ #
4069
4440
  # Default: Inherits from the source DB instance
4070
4441
  #
4071
4442
  # @option params [Integer] :iops
@@ -4081,6 +4452,8 @@ module Aws::RDS
4081
4452
  #
4082
4453
  # </note>
4083
4454
  #
4455
+ # This setting doesn't apply to RDS Custom.
4456
+ #
4084
4457
  # @option params [String] :db_parameter_group_name
4085
4458
  # The name of the DB parameter group to associate with this DB instance.
4086
4459
  #
@@ -4089,10 +4462,8 @@ module Aws::RDS
4089
4462
  # region read replica, or the default `DBParameterGroup` for the
4090
4463
  # specified DB engine for a cross region read replica.
4091
4464
  #
4092
- # <note markdown="1"> Currently, specifying a parameter group for this operation is only
4093
- # supported for Oracle DB instances.
4094
- #
4095
- # </note>
4465
+ # Specifying a parameter group for this operation is only supported for
4466
+ # Oracle DB instances. It isn't supported for RDS Custom.
4096
4467
  #
4097
4468
  # Constraints:
4098
4469
  #
@@ -4153,7 +4524,10 @@ module Aws::RDS
4153
4524
  # Example: `mySubnetgroup`
4154
4525
  #
4155
4526
  # @option params [Array<String>] :vpc_security_group_ids
4156
- # A list of EC2 VPC security groups to associate with the read replica.
4527
+ # A list of Amazon EC2 VPC security groups to associate with the read
4528
+ # replica.
4529
+ #
4530
+ # This setting doesn't apply to RDS Custom.
4157
4531
  #
4158
4532
  # Default: The default EC2 VPC security group for the DB subnet group's
4159
4533
  # VPC.
@@ -4180,6 +4554,8 @@ module Aws::RDS
4180
4554
  # If `MonitoringRoleArn` is specified, then you must also set
4181
4555
  # `MonitoringInterval` to a value other than 0.
4182
4556
  #
4557
+ # This setting doesn't apply to RDS Custom.
4558
+ #
4183
4559
  # Valid Values: `0, 1, 5, 10, 15, 30, 60`
4184
4560
  #
4185
4561
  # @option params [String] :monitoring_role_arn
@@ -4192,6 +4568,8 @@ module Aws::RDS
4192
4568
  # If `MonitoringInterval` is set to a value other than 0, then you must
4193
4569
  # supply a `MonitoringRoleArn` value.
4194
4570
  #
4571
+ # This setting doesn't apply to RDS Custom.
4572
+ #
4195
4573
  #
4196
4574
  #
4197
4575
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
@@ -4201,24 +4579,27 @@ module Aws::RDS
4201
4579
  # replica.
4202
4580
  #
4203
4581
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
4204
- # alias ARN, or alias name for the Amazon Web Services KMS CMK.
4582
+ # alias ARN, or alias name for the KMS key.
4205
4583
  #
4206
4584
  # If you create an encrypted read replica in the same Amazon Web
4207
4585
  # Services Region as the source DB instance, then do not specify a value
4208
- # for this parameter. A read replica in the same Region is always
4209
- # encrypted with the same Amazon Web Services KMS CMK as the source DB
4586
+ # for this parameter. A read replica in the same Amazon Web Services
4587
+ # Region is always encrypted with the same KMS key as the source DB
4210
4588
  # instance.
4211
4589
  #
4212
4590
  # If you create an encrypted read replica in a different Amazon Web
4213
- # Services Region, then you must specify a Amazon Web Services KMS key
4214
- # identifier for the destination Amazon Web Services Region. Amazon Web
4215
- # Services KMS CMKs are specific to the Amazon Web Services Region that
4216
- # they are created in, and you can't use CMKs from one Amazon Web
4217
- # Services Region in another Amazon Web Services Region.
4591
+ # Services Region, then you must specify a KMS key identifier for the
4592
+ # destination Amazon Web Services Region. KMS keys are specific to the
4593
+ # Amazon Web Services Region that they are created in, and you can't
4594
+ # use KMS keys from one Amazon Web Services Region in another Amazon Web
4595
+ # Services Region.
4218
4596
  #
4219
4597
  # You can't create an encrypted read replica from an unencrypted DB
4220
4598
  # instance.
4221
4599
  #
4600
+ # This setting doesn't apply to RDS Custom, which uses the same KMS key
4601
+ # as the primary replica.
4602
+ #
4222
4603
  # @option params [String] :pre_signed_url
4223
4604
  # The URL that contains a Signature Version 4 signed request for the
4224
4605
  # `CreateDBInstanceReadReplica` API action in the source Amazon Web
@@ -4282,6 +4663,8 @@ module Aws::RDS
4282
4663
  #
4283
4664
  # </note>
4284
4665
  #
4666
+ # This setting doesn't apply to RDS Custom.
4667
+ #
4285
4668
  #
4286
4669
  #
4287
4670
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html
@@ -4296,6 +4679,8 @@ module Aws::RDS
4296
4679
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
4297
4680
  # RDS User Guide.*
4298
4681
  #
4682
+ # This setting doesn't apply to RDS Custom.
4683
+ #
4299
4684
  #
4300
4685
  #
4301
4686
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
@@ -4307,6 +4692,8 @@ module Aws::RDS
4307
4692
  # For more information, see [Using Amazon Performance Insights][1] in
4308
4693
  # the *Amazon RDS User Guide*.
4309
4694
  #
4695
+ # This setting doesn't apply to RDS Custom.
4696
+ #
4310
4697
  #
4311
4698
  #
4312
4699
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
@@ -4316,24 +4703,29 @@ module Aws::RDS
4316
4703
  # Performance Insights data.
4317
4704
  #
4318
4705
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
4319
- # alias ARN, or alias name for the Amazon Web Services KMS customer
4320
- # master key (CMK).
4706
+ # alias ARN, or alias name for the KMS key.
4321
4707
  #
4322
4708
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
4323
- # Amazon RDS uses your default CMK. There is a default CMK for your
4324
- # Amazon Web Services account. Your Amazon Web Services account has a
4325
- # different default CMK for each Amazon Web Services Region.
4709
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
4710
+ # your Amazon Web Services account. Your Amazon Web Services account has
4711
+ # a different default KMS key for each Amazon Web Services Region.
4712
+ #
4713
+ # This setting doesn't apply to RDS Custom.
4326
4714
  #
4327
4715
  # @option params [Integer] :performance_insights_retention_period
4328
4716
  # The amount of time, in days, to retain Performance Insights data.
4329
4717
  # Valid values are 7 or 731 (2 years).
4330
4718
  #
4719
+ # This setting doesn't apply to RDS Custom.
4720
+ #
4331
4721
  # @option params [Array<String>] :enable_cloudwatch_logs_exports
4332
4722
  # The list of logs that the new DB instance is to export to CloudWatch
4333
4723
  # Logs. The values in the list depend on the DB engine being used. For
4334
4724
  # more information, see [Publishing Database Logs to Amazon CloudWatch
4335
4725
  # Logs ][1] in the *Amazon RDS User Guide*.
4336
4726
  #
4727
+ # This setting doesn't apply to RDS Custom.
4728
+ #
4337
4729
  #
4338
4730
  #
4339
4731
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -4342,10 +4734,14 @@ module Aws::RDS
4342
4734
  # The number of CPU cores and the number of threads per core for the DB
4343
4735
  # instance class of the DB instance.
4344
4736
  #
4737
+ # This setting doesn't apply to RDS Custom.
4738
+ #
4345
4739
  # @option params [Boolean] :use_default_processor_features
4346
4740
  # A value that indicates whether the DB instance class of the DB
4347
4741
  # instance uses its default processor features.
4348
4742
  #
4743
+ # This setting doesn't apply to RDS Custom.
4744
+ #
4349
4745
  # @option params [Boolean] :deletion_protection
4350
4746
  # A value that indicates whether the DB instance has deletion protection
4351
4747
  # enabled. The database can't be deleted when deletion protection is
@@ -4364,6 +4760,8 @@ module Aws::RDS
4364
4760
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
4365
4761
  # RDS User Guide*.
4366
4762
  #
4763
+ # This setting doesn't apply to RDS Custom.
4764
+ #
4367
4765
  #
4368
4766
  #
4369
4767
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -4372,6 +4770,8 @@ module Aws::RDS
4372
4770
  # Specify the name of the IAM role to be used when making API calls to
4373
4771
  # the Directory Service.
4374
4772
  #
4773
+ # This setting doesn't apply to RDS Custom.
4774
+ #
4375
4775
  # @option params [String] :replica_mode
4376
4776
  # The open mode of the replica database: mounted or read-only.
4377
4777
  #
@@ -4379,17 +4779,22 @@ module Aws::RDS
4379
4779
  #
4380
4780
  # </note>
4381
4781
  #
4382
- # Mounted DB replicas are included in Oracle Enterprise Edition. The
4383
- # main use case for mounted replicas is cross-Region disaster recovery.
4384
- # The primary database doesn't use Active Data Guard to transmit
4385
- # information to the mounted replica. Because it doesn't accept user
4386
- # connections, a mounted replica can't serve a read-only workload.
4782
+ # Mounted DB replicas are included in Oracle Database Enterprise
4783
+ # Edition. The main use case for mounted replicas is cross-Region
4784
+ # disaster recovery. The primary database doesn't use Active Data Guard
4785
+ # to transmit information to the mounted replica. Because it doesn't
4786
+ # accept user connections, a mounted replica can't serve a read-only
4787
+ # workload.
4387
4788
  #
4388
4789
  # You can create a combination of mounted and read-only DB replicas for
4389
4790
  # the same primary DB instance. For more information, see [Working with
4390
4791
  # Oracle Read Replicas for Amazon RDS][1] in the *Amazon RDS User
4391
4792
  # Guide*.
4392
4793
  #
4794
+ # For RDS Custom, you must specify this parameter and set it to
4795
+ # `mounted`. The value won't be set by default. After replica creation,
4796
+ # you can manage the open mode manually.
4797
+ #
4393
4798
  #
4394
4799
  #
4395
4800
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
@@ -4406,6 +4811,29 @@ module Aws::RDS
4406
4811
  #
4407
4812
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
4408
4813
  #
4814
+ # @option params [String] :custom_iam_instance_profile
4815
+ # The instance profile associated with the underlying Amazon EC2
4816
+ # instance of an RDS Custom DB instance. The instance profile must meet
4817
+ # the following requirements:
4818
+ #
4819
+ # * The profile must exist in your account.
4820
+ #
4821
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
4822
+ # assume.
4823
+ #
4824
+ # * The instance profile name and the associated IAM role name must
4825
+ # start with the prefix `AWSRDSCustom`.
4826
+ #
4827
+ # For the list of permissions required for the IAM role, see [ Configure
4828
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
4829
+ # Guide*.
4830
+ #
4831
+ # This setting is required for RDS Custom.
4832
+ #
4833
+ #
4834
+ #
4835
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
4836
+ #
4409
4837
  # @option params [String] :source_region
4410
4838
  # The source region of the snapshot. This is only needed when the
4411
4839
  # shapshot is encrypted and in a different region.
@@ -4486,6 +4914,7 @@ module Aws::RDS
4486
4914
  # domain_iam_role_name: "String",
4487
4915
  # replica_mode: "open-read-only", # accepts open-read-only, mounted
4488
4916
  # max_allocated_storage: 1,
4917
+ # custom_iam_instance_profile: "String",
4489
4918
  # source_region: "String",
4490
4919
  # })
4491
4920
  #
@@ -4547,6 +4976,8 @@ module Aws::RDS
4547
4976
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
4548
4977
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
4549
4978
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
4979
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
4980
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
4550
4981
  # resp.db_instance.latest_restorable_time #=> Time
4551
4982
  # resp.db_instance.multi_az #=> Boolean
4552
4983
  # resp.db_instance.engine_version #=> String
@@ -4621,6 +5052,9 @@ module Aws::RDS
4621
5052
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
4622
5053
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
4623
5054
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
5055
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
5056
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
5057
+ # resp.db_instance.custom_iam_instance_profile #=> String
4624
5058
  #
4625
5059
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceReadReplica AWS API Documentation
4626
5060
  #
@@ -4636,13 +5070,15 @@ module Aws::RDS
4636
5070
  # A DB parameter group is initially created with the default parameters
4637
5071
  # for the database engine used by the DB instance. To provide custom
4638
5072
  # values for any of the parameters, you must modify the group after
4639
- # creating it using *ModifyDBParameterGroup*. Once you've created a DB
5073
+ # creating it using `ModifyDBParameterGroup`. Once you've created a DB
4640
5074
  # parameter group, you need to associate it with your DB instance using
4641
- # *ModifyDBInstance*. When you associate a new DB parameter group with a
5075
+ # `ModifyDBInstance`. When you associate a new DB parameter group with a
4642
5076
  # running DB instance, you need to reboot the DB instance without
4643
5077
  # failover for the new DB parameter group and associated settings to
4644
5078
  # take effect.
4645
5079
  #
5080
+ # This command doesn't apply to RDS Custom.
5081
+ #
4646
5082
  # After you create a DB parameter group, you should wait at least 5
4647
5083
  # minutes before creating your first DB instance that uses that DB
4648
5084
  # parameter group as the default parameter group. This allows Amazon RDS
@@ -5521,6 +5957,8 @@ module Aws::RDS
5521
5957
 
5522
5958
  # Creates a new option group. You can create up to 20 option groups.
5523
5959
  #
5960
+ # This command doesn't apply to RDS Custom.
5961
+ #
5524
5962
  # @option params [required, String] :option_group_name
5525
5963
  # Specifies the name of the option group to be created.
5526
5964
  #
@@ -5697,6 +6135,136 @@ module Aws::RDS
5697
6135
  req.send_request(options)
5698
6136
  end
5699
6137
 
6138
+ # Deletes a custom engine version. To run this command, make sure you
6139
+ # meet the following prerequisites:
6140
+ #
6141
+ # * The CEV must not be the default for RDS Custom. If it is, change the
6142
+ # default before running this command.
6143
+ #
6144
+ # * The CEV must not be associated with an RDS Custom DB instance, RDS
6145
+ # Custom instance snapshot, or automated backup of your RDS Custom
6146
+ # instance.
6147
+ #
6148
+ # Typically, deletion takes a few minutes.
6149
+ #
6150
+ # <note markdown="1"> The MediaImport service that imports files from Amazon S3 to create
6151
+ # CEVs isn't integrated with Amazon Web Services CloudTrail. If you
6152
+ # turn on data logging for Amazon RDS in CloudTrail, calls to the
6153
+ # `DeleteCustomDbEngineVersion` event aren't logged. However, you might
6154
+ # see calls from the API gateway that accesses your Amazon S3 bucket.
6155
+ # These calls originate from the MediaImport service for the
6156
+ # `DeleteCustomDbEngineVersion` event.
6157
+ #
6158
+ # </note>
6159
+ #
6160
+ # For more information, see [ Deleting a CEV][1] in the *Amazon RDS User
6161
+ # Guide*.
6162
+ #
6163
+ #
6164
+ #
6165
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.delete
6166
+ #
6167
+ # @option params [required, String] :engine
6168
+ # The database engine. The only supported engine is `custom-oracle-ee`.
6169
+ #
6170
+ # @option params [required, String] :engine_version
6171
+ # The custom engine version (CEV) for your DB instance. This option is
6172
+ # required for RDS Custom, but optional for Amazon RDS. The combination
6173
+ # of `Engine` and `EngineVersion` is unique per customer per Amazon Web
6174
+ # Services Region.
6175
+ #
6176
+ # @return [Types::DBEngineVersion] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6177
+ #
6178
+ # * {Types::DBEngineVersion#engine #engine} => String
6179
+ # * {Types::DBEngineVersion#engine_version #engine_version} => String
6180
+ # * {Types::DBEngineVersion#db_parameter_group_family #db_parameter_group_family} => String
6181
+ # * {Types::DBEngineVersion#db_engine_description #db_engine_description} => String
6182
+ # * {Types::DBEngineVersion#db_engine_version_description #db_engine_version_description} => String
6183
+ # * {Types::DBEngineVersion#default_character_set #default_character_set} => Types::CharacterSet
6184
+ # * {Types::DBEngineVersion#supported_character_sets #supported_character_sets} => Array&lt;Types::CharacterSet&gt;
6185
+ # * {Types::DBEngineVersion#supported_nchar_character_sets #supported_nchar_character_sets} => Array&lt;Types::CharacterSet&gt;
6186
+ # * {Types::DBEngineVersion#valid_upgrade_target #valid_upgrade_target} => Array&lt;Types::UpgradeTarget&gt;
6187
+ # * {Types::DBEngineVersion#supported_timezones #supported_timezones} => Array&lt;Types::Timezone&gt;
6188
+ # * {Types::DBEngineVersion#exportable_log_types #exportable_log_types} => Array&lt;String&gt;
6189
+ # * {Types::DBEngineVersion#supports_log_exports_to_cloudwatch_logs #supports_log_exports_to_cloudwatch_logs} => Boolean
6190
+ # * {Types::DBEngineVersion#supports_read_replica #supports_read_replica} => Boolean
6191
+ # * {Types::DBEngineVersion#supported_engine_modes #supported_engine_modes} => Array&lt;String&gt;
6192
+ # * {Types::DBEngineVersion#supported_feature_names #supported_feature_names} => Array&lt;String&gt;
6193
+ # * {Types::DBEngineVersion#status #status} => String
6194
+ # * {Types::DBEngineVersion#supports_parallel_query #supports_parallel_query} => Boolean
6195
+ # * {Types::DBEngineVersion#supports_global_databases #supports_global_databases} => Boolean
6196
+ # * {Types::DBEngineVersion#major_engine_version #major_engine_version} => String
6197
+ # * {Types::DBEngineVersion#database_installation_files_s3_bucket_name #database_installation_files_s3_bucket_name} => String
6198
+ # * {Types::DBEngineVersion#database_installation_files_s3_prefix #database_installation_files_s3_prefix} => String
6199
+ # * {Types::DBEngineVersion#db_engine_version_arn #db_engine_version_arn} => String
6200
+ # * {Types::DBEngineVersion#kms_key_id #kms_key_id} => String
6201
+ # * {Types::DBEngineVersion#create_time #create_time} => Time
6202
+ # * {Types::DBEngineVersion#tag_list #tag_list} => Array&lt;Types::Tag&gt;
6203
+ #
6204
+ # @example Request syntax with placeholder values
6205
+ #
6206
+ # resp = client.delete_custom_db_engine_version({
6207
+ # engine: "CustomEngineName", # required
6208
+ # engine_version: "CustomEngineVersion", # required
6209
+ # })
6210
+ #
6211
+ # @example Response structure
6212
+ #
6213
+ # resp.engine #=> String
6214
+ # resp.engine_version #=> String
6215
+ # resp.db_parameter_group_family #=> String
6216
+ # resp.db_engine_description #=> String
6217
+ # resp.db_engine_version_description #=> String
6218
+ # resp.default_character_set.character_set_name #=> String
6219
+ # resp.default_character_set.character_set_description #=> String
6220
+ # resp.supported_character_sets #=> Array
6221
+ # resp.supported_character_sets[0].character_set_name #=> String
6222
+ # resp.supported_character_sets[0].character_set_description #=> String
6223
+ # resp.supported_nchar_character_sets #=> Array
6224
+ # resp.supported_nchar_character_sets[0].character_set_name #=> String
6225
+ # resp.supported_nchar_character_sets[0].character_set_description #=> String
6226
+ # resp.valid_upgrade_target #=> Array
6227
+ # resp.valid_upgrade_target[0].engine #=> String
6228
+ # resp.valid_upgrade_target[0].engine_version #=> String
6229
+ # resp.valid_upgrade_target[0].description #=> String
6230
+ # resp.valid_upgrade_target[0].auto_upgrade #=> Boolean
6231
+ # resp.valid_upgrade_target[0].is_major_version_upgrade #=> Boolean
6232
+ # resp.valid_upgrade_target[0].supported_engine_modes #=> Array
6233
+ # resp.valid_upgrade_target[0].supported_engine_modes[0] #=> String
6234
+ # resp.valid_upgrade_target[0].supports_parallel_query #=> Boolean
6235
+ # resp.valid_upgrade_target[0].supports_global_databases #=> Boolean
6236
+ # resp.supported_timezones #=> Array
6237
+ # resp.supported_timezones[0].timezone_name #=> String
6238
+ # resp.exportable_log_types #=> Array
6239
+ # resp.exportable_log_types[0] #=> String
6240
+ # resp.supports_log_exports_to_cloudwatch_logs #=> Boolean
6241
+ # resp.supports_read_replica #=> Boolean
6242
+ # resp.supported_engine_modes #=> Array
6243
+ # resp.supported_engine_modes[0] #=> String
6244
+ # resp.supported_feature_names #=> Array
6245
+ # resp.supported_feature_names[0] #=> String
6246
+ # resp.status #=> String
6247
+ # resp.supports_parallel_query #=> Boolean
6248
+ # resp.supports_global_databases #=> Boolean
6249
+ # resp.major_engine_version #=> String
6250
+ # resp.database_installation_files_s3_bucket_name #=> String
6251
+ # resp.database_installation_files_s3_prefix #=> String
6252
+ # resp.db_engine_version_arn #=> String
6253
+ # resp.kms_key_id #=> String
6254
+ # resp.create_time #=> Time
6255
+ # resp.tag_list #=> Array
6256
+ # resp.tag_list[0].key #=> String
6257
+ # resp.tag_list[0].value #=> String
6258
+ #
6259
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteCustomDBEngineVersion AWS API Documentation
6260
+ #
6261
+ # @overload delete_custom_db_engine_version(params = {})
6262
+ # @param [Hash] params ({})
6263
+ def delete_custom_db_engine_version(params = {}, options = {})
6264
+ req = build_request(:delete_custom_db_engine_version, params)
6265
+ req.send_request(options)
6266
+ end
6267
+
5700
6268
  # The DeleteDBCluster action deletes a previously provisioned DB
5701
6269
  # cluster. When you delete a DB cluster, all automated backups for that
5702
6270
  # DB cluster are deleted and can't be recovered. Manual DB cluster
@@ -5849,6 +6417,7 @@ module Aws::RDS
5849
6417
  # resp.db_cluster.scaling_configuration_info.auto_pause #=> Boolean
5850
6418
  # resp.db_cluster.scaling_configuration_info.seconds_until_auto_pause #=> Integer
5851
6419
  # resp.db_cluster.scaling_configuration_info.timeout_action #=> String
6420
+ # resp.db_cluster.scaling_configuration_info.seconds_before_timeout #=> Integer
5852
6421
  # resp.db_cluster.deletion_protection #=> Boolean
5853
6422
  # resp.db_cluster.http_endpoint_enabled #=> Boolean
5854
6423
  # resp.db_cluster.activity_stream_mode #=> String, one of "sync", "async"
@@ -6121,31 +6690,37 @@ module Aws::RDS
6121
6690
  #
6122
6691
  # @option params [Boolean] :skip_final_snapshot
6123
6692
  # A value that indicates whether to skip the creation of a final DB
6124
- # snapshot before the DB instance is deleted. If skip is specified, no
6125
- # DB snapshot is created. If skip isn't specified, a DB snapshot is
6126
- # created before the DB instance is deleted. By default, skip isn't
6127
- # specified, and the DB snapshot is created.
6693
+ # snapshot before deleting the instance. If you enable this parameter,
6694
+ # RDS doesn't create a DB snapshot. If you don't enable this
6695
+ # parameter, RDS creates a DB snapshot before the DB instance is
6696
+ # deleted. By default, skip isn't enabled, and the DB snapshot is
6697
+ # created.
6128
6698
  #
6129
- # When a DB instance is in a failure state and has a status of
6130
- # 'failed', 'incompatible-restore', or 'incompatible-network', it
6131
- # can only be deleted when skip is specified.
6699
+ # <note markdown="1"> If you don't enable this parameter, you must specify the
6700
+ # `FinalDBSnapshotIdentifier` parameter.
6132
6701
  #
6133
- # Specify skip when deleting a read replica.
6702
+ # </note>
6134
6703
  #
6135
- # <note markdown="1"> The FinalDBSnapshotIdentifier parameter must be specified if skip
6136
- # isn't specified.
6704
+ # When a DB instance is in a failure state and has a status of `failed`,
6705
+ # `incompatible-restore`, or `incompatible-network`, RDS can delete the
6706
+ # instance only if you enable this parameter.
6137
6707
  #
6138
- # </note>
6708
+ # If you delete a read replica or an RDS Custom instance, you must
6709
+ # enable this setting.
6710
+ #
6711
+ # This setting is required for RDS Custom.
6139
6712
  #
6140
6713
  # @option params [String] :final_db_snapshot_identifier
6141
6714
  # The `DBSnapshotIdentifier` of the new `DBSnapshot` created when the
6142
6715
  # `SkipFinalSnapshot` parameter is disabled.
6143
6716
  #
6144
- # <note markdown="1"> Specifying this parameter and also specifying to skip final DB
6145
- # snapshot creation in SkipFinalShapshot results in an error.
6717
+ # <note markdown="1"> If you enable this parameter and also enable SkipFinalShapshot, the
6718
+ # command results in an error.
6146
6719
  #
6147
6720
  # </note>
6148
6721
  #
6722
+ # This setting doesn't apply to RDS Custom.
6723
+ #
6149
6724
  # Constraints:
6150
6725
  #
6151
6726
  # * Must be 1 to 255 letters or numbers.
@@ -6249,6 +6824,8 @@ module Aws::RDS
6249
6824
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
6250
6825
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
6251
6826
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
6827
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
6828
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
6252
6829
  # resp.db_instance.latest_restorable_time #=> Time
6253
6830
  # resp.db_instance.multi_az #=> Boolean
6254
6831
  # resp.db_instance.engine_version #=> String
@@ -6323,6 +6900,9 @@ module Aws::RDS
6323
6900
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
6324
6901
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
6325
6902
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
6903
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
6904
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
6905
+ # resp.db_instance.custom_iam_instance_profile #=> String
6326
6906
  #
6327
6907
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstance AWS API Documentation
6328
6908
  #
@@ -6346,6 +6926,8 @@ module Aws::RDS
6346
6926
  # example,
6347
6927
  # `arn:aws:rds:us-east-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
6348
6928
  #
6929
+ # This setting doesn't apply to RDS Custom.
6930
+ #
6349
6931
  # @return [Types::DeleteDBInstanceAutomatedBackupResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6350
6932
  #
6351
6933
  # * {Types::DeleteDBInstanceAutomatedBackupResult#db_instance_automated_backup #db_instance_automated_backup} => Types::DBInstanceAutomatedBackup
@@ -7997,6 +8579,7 @@ module Aws::RDS
7997
8579
  # resp.db_clusters[0].scaling_configuration_info.auto_pause #=> Boolean
7998
8580
  # resp.db_clusters[0].scaling_configuration_info.seconds_until_auto_pause #=> Integer
7999
8581
  # resp.db_clusters[0].scaling_configuration_info.timeout_action #=> String
8582
+ # resp.db_clusters[0].scaling_configuration_info.seconds_before_timeout #=> Integer
8000
8583
  # resp.db_clusters[0].deletion_protection #=> Boolean
8001
8584
  # resp.db_clusters[0].http_endpoint_enabled #=> Boolean
8002
8585
  # resp.db_clusters[0].activity_stream_mode #=> String, one of "sync", "async"
@@ -8113,6 +8696,10 @@ module Aws::RDS
8113
8696
  # `CharacterSetName` parameter for `CreateDBInstance`, the response
8114
8697
  # includes a list of supported character sets for each engine version.
8115
8698
  #
8699
+ # For RDS Custom, the default is not to list supported character sets.
8700
+ # If you set `ListSupportedCharacterSets` to `true`, RDS Custom returns
8701
+ # no results.
8702
+ #
8116
8703
  # @option params [Boolean] :list_supported_timezones
8117
8704
  # A value that indicates whether to list the supported time zones for
8118
8705
  # each engine version.
@@ -8121,6 +8708,10 @@ module Aws::RDS
8121
8708
  # `TimeZone` parameter for `CreateDBInstance`, the response includes a
8122
8709
  # list of supported time zones for each engine version.
8123
8710
  #
8711
+ # For RDS Custom, the default is not to list supported time zones. If
8712
+ # you set `ListSupportedTimezones` to `true`, RDS Custom returns no
8713
+ # results.
8714
+ #
8124
8715
  # @option params [Boolean] :include_all
8125
8716
  # A value that indicates whether to include engine versions that aren't
8126
8717
  # available in the list. The default is to list only available engine
@@ -8210,6 +8801,15 @@ module Aws::RDS
8210
8801
  # resp.db_engine_versions[0].status #=> String
8211
8802
  # resp.db_engine_versions[0].supports_parallel_query #=> Boolean
8212
8803
  # resp.db_engine_versions[0].supports_global_databases #=> Boolean
8804
+ # resp.db_engine_versions[0].major_engine_version #=> String
8805
+ # resp.db_engine_versions[0].database_installation_files_s3_bucket_name #=> String
8806
+ # resp.db_engine_versions[0].database_installation_files_s3_prefix #=> String
8807
+ # resp.db_engine_versions[0].db_engine_version_arn #=> String
8808
+ # resp.db_engine_versions[0].kms_key_id #=> String
8809
+ # resp.db_engine_versions[0].create_time #=> Time
8810
+ # resp.db_engine_versions[0].tag_list #=> Array
8811
+ # resp.db_engine_versions[0].tag_list[0].key #=> String
8812
+ # resp.db_engine_versions[0].tag_list[0].value #=> String
8213
8813
  #
8214
8814
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBEngineVersions AWS API Documentation
8215
8815
  #
@@ -8281,6 +8881,8 @@ module Aws::RDS
8281
8881
  # for example,
8282
8882
  # `arn:aws:rds:us-east-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
8283
8883
  #
8884
+ # This setting doesn't apply to RDS Custom.
8885
+ #
8284
8886
  # @return [Types::DBInstanceAutomatedBackupMessage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8285
8887
  #
8286
8888
  # * {Types::DBInstanceAutomatedBackupMessage#marker #marker} => String
@@ -8500,6 +9102,8 @@ module Aws::RDS
8500
9102
  # resp.db_instances[0].pending_modified_values.processor_features[0].name #=> String
8501
9103
  # resp.db_instances[0].pending_modified_values.processor_features[0].value #=> String
8502
9104
  # resp.db_instances[0].pending_modified_values.iam_database_authentication_enabled #=> Boolean
9105
+ # resp.db_instances[0].pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
9106
+ # resp.db_instances[0].pending_modified_values.resume_full_automation_mode_time #=> Time
8503
9107
  # resp.db_instances[0].latest_restorable_time #=> Time
8504
9108
  # resp.db_instances[0].multi_az #=> Boolean
8505
9109
  # resp.db_instances[0].engine_version #=> String
@@ -8574,6 +9178,9 @@ module Aws::RDS
8574
9178
  # resp.db_instances[0].activity_stream_kinesis_stream_name #=> String
8575
9179
  # resp.db_instances[0].activity_stream_mode #=> String, one of "sync", "async"
8576
9180
  # resp.db_instances[0].activity_stream_engine_native_audit_fields_included #=> Boolean
9181
+ # resp.db_instances[0].automation_mode #=> String, one of "full", "all-paused"
9182
+ # resp.db_instances[0].resume_full_automation_mode_time #=> Time
9183
+ # resp.db_instances[0].custom_iam_instance_profile #=> String
8577
9184
  #
8578
9185
  #
8579
9186
  # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -8592,6 +9199,8 @@ module Aws::RDS
8592
9199
 
8593
9200
  # Returns a list of DB log files for the DB instance.
8594
9201
  #
9202
+ # This command doesn't apply to RDS Custom.
9203
+ #
8595
9204
  # @option params [required, String] :db_instance_identifier
8596
9205
  # The customer-assigned name of the DB instance that contains the log
8597
9206
  # files you want to list.
@@ -9437,6 +10046,8 @@ module Aws::RDS
9437
10046
  # manual DB snapshot from another Amazon Web Services account by using
9438
10047
  # the `ModifyDBSnapshotAttribute` API action.
9439
10048
  #
10049
+ # This setting doesn't apply to RDS Custom.
10050
+ #
9440
10051
  # @option params [Boolean] :include_public
9441
10052
  # A value that indicates whether to include manual DB cluster snapshots
9442
10053
  # that are public and can be copied or restored by any Amazon Web
@@ -9445,6 +10056,8 @@ module Aws::RDS
9445
10056
  # You can share a manual DB snapshot as public by using the
9446
10057
  # ModifyDBSnapshotAttribute API.
9447
10058
  #
10059
+ # This setting doesn't apply to RDS Custom.
10060
+ #
9448
10061
  # @option params [String] :dbi_resource_id
9449
10062
  # A specific DB resource ID to describe.
9450
10063
  #
@@ -10091,7 +10704,7 @@ module Aws::RDS
10091
10704
  #
10092
10705
  # resp = client.describe_events({
10093
10706
  # source_identifier: "String",
10094
- # source_type: "db-instance", # accepts db-instance, db-parameter-group, db-security-group, db-snapshot, db-cluster, db-cluster-snapshot
10707
+ # source_type: "db-instance", # accepts db-instance, db-parameter-group, db-security-group, db-snapshot, db-cluster, db-cluster-snapshot, custom-engine-version
10095
10708
  # start_time: Time.now,
10096
10709
  # end_time: Time.now,
10097
10710
  # duration: 1,
@@ -10111,7 +10724,7 @@ module Aws::RDS
10111
10724
  # resp.marker #=> String
10112
10725
  # resp.events #=> Array
10113
10726
  # resp.events[0].source_identifier #=> String
10114
- # resp.events[0].source_type #=> String, one of "db-instance", "db-parameter-group", "db-security-group", "db-snapshot", "db-cluster", "db-cluster-snapshot"
10727
+ # 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"
10115
10728
  # resp.events[0].message #=> String
10116
10729
  # resp.events[0].event_categories #=> Array
10117
10730
  # resp.events[0].event_categories[0] #=> String
@@ -10151,8 +10764,18 @@ module Aws::RDS
10151
10764
  # * `source-arn` - The Amazon Resource Name (ARN) of the snapshot
10152
10765
  # exported to Amazon S3
10153
10766
  #
10154
- # * `status` - The status of the export task. Must be lowercase, for
10155
- # example, `complete`.
10767
+ # * `status` - The status of the export task. Must be lowercase. Valid
10768
+ # statuses are the following:
10769
+ #
10770
+ # * `canceled`
10771
+ #
10772
+ # * `canceling`
10773
+ #
10774
+ # * `complete`
10775
+ #
10776
+ # * `failed`
10777
+ #
10778
+ # * `starting`
10156
10779
  #
10157
10780
  # @option params [String] :marker
10158
10781
  # An optional pagination token provided by a previous
@@ -10714,6 +11337,8 @@ module Aws::RDS
10714
11337
  # The license model filter value. Specify this parameter to show only
10715
11338
  # the available offerings matching the specified license model.
10716
11339
  #
11340
+ # RDS Custom supports only the BYOL licensing model.
11341
+ #
10717
11342
  # @option params [String] :availability_zone_group
10718
11343
  # The Availability Zone group associated with a Local Zone. Specify this
10719
11344
  # parameter to retrieve available offerings for the Local Zones in the
@@ -10722,8 +11347,14 @@ module Aws::RDS
10722
11347
  # Omit this parameter to show the available offerings in the specified
10723
11348
  # Amazon Web Services Region.
10724
11349
  #
11350
+ # This setting doesn't apply to RDS Custom.
11351
+ #
10725
11352
  # @option params [Boolean] :vpc
10726
11353
  # A value that indicates whether to show only VPC or non-VPC offerings.
11354
+ # RDS Custom supports only VPC offerings.
11355
+ #
11356
+ # RDS Custom supports only VPC offerings. If you describe non-VPC
11357
+ # offerings for RDS Custom, the output shows VPC offerings.
10727
11358
  #
10728
11359
  # @option params [Array<Types::Filter>] :filters
10729
11360
  # This parameter isn't currently supported.
@@ -11337,6 +11968,8 @@ module Aws::RDS
11337
11968
  # modifications you can make to your DB instance. You can use this
11338
11969
  # information when you call `ModifyDBInstance`.
11339
11970
  #
11971
+ # This command doesn't apply to RDS Custom.
11972
+ #
11340
11973
  # @option params [required, String] :db_instance_identifier
11341
11974
  # The customer identifier or the ARN of your DB instance.
11342
11975
  #
@@ -11383,6 +12016,8 @@ module Aws::RDS
11383
12016
  # Downloads all or a portion of the specified log file, up to 1 MB in
11384
12017
  # size.
11385
12018
  #
12019
+ # This command doesn't apply to RDS Custom.
12020
+ #
11386
12021
  # @option params [required, String] :db_instance_identifier
11387
12022
  # The customer-assigned name of the DB instance that contains the log
11388
12023
  # files you want to list.
@@ -11605,6 +12240,7 @@ module Aws::RDS
11605
12240
  # resp.db_cluster.scaling_configuration_info.auto_pause #=> Boolean
11606
12241
  # resp.db_cluster.scaling_configuration_info.seconds_until_auto_pause #=> Integer
11607
12242
  # resp.db_cluster.scaling_configuration_info.timeout_action #=> String
12243
+ # resp.db_cluster.scaling_configuration_info.seconds_before_timeout #=> Integer
11608
12244
  # resp.db_cluster.deletion_protection #=> Boolean
11609
12245
  # resp.db_cluster.http_endpoint_enabled #=> Boolean
11610
12246
  # resp.db_cluster.activity_stream_mode #=> String, one of "sync", "async"
@@ -11989,7 +12625,7 @@ module Aws::RDS
11989
12625
  # scaling points, see [ Autoscaling for Aurora Serverless][2] in the
11990
12626
  # *Amazon Aurora User Guide*.
11991
12627
  #
11992
- # <note markdown="1"> This action only applies to Aurora DB clusters.
12628
+ # <note markdown="1"> This action only applies to Aurora Serverless DB clusters.
11993
12629
  #
11994
12630
  # </note>
11995
12631
  #
@@ -12027,9 +12663,7 @@ module Aws::RDS
12027
12663
  # scaling point to perform seamless scaling before enforcing the timeout
12028
12664
  # action. The default is 300.
12029
12665
  #
12030
- # * Value must be from 10 through 600.
12031
- #
12032
- # ^
12666
+ # Specify a value between 10 and 600 seconds.
12033
12667
  #
12034
12668
  # @option params [String] :timeout_action
12035
12669
  # The action to take when the timeout is reached, either
@@ -12075,6 +12709,154 @@ module Aws::RDS
12075
12709
  req.send_request(options)
12076
12710
  end
12077
12711
 
12712
+ # Modifies the status of a custom engine version (CEV). You can find
12713
+ # CEVs to modify by calling `DescribeDBEngineVersions`.
12714
+ #
12715
+ # <note markdown="1"> The MediaImport service that imports files from Amazon S3 to create
12716
+ # CEVs isn't integrated with Amazon Web Services CloudTrail. If you
12717
+ # turn on data logging for Amazon RDS in CloudTrail, calls to the
12718
+ # `ModifyCustomDbEngineVersion` event aren't logged. However, you might
12719
+ # see calls from the API gateway that accesses your Amazon S3 bucket.
12720
+ # These calls originate from the MediaImport service for the
12721
+ # `ModifyCustomDbEngineVersion` event.
12722
+ #
12723
+ # </note>
12724
+ #
12725
+ # For more information, see [Modifying CEV status][1] in the *Amazon RDS
12726
+ # User Guide*.
12727
+ #
12728
+ #
12729
+ #
12730
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.preparing.manifest
12731
+ #
12732
+ # @option params [required, String] :engine
12733
+ # The DB engine. The only supported value is `custom-oracle-ee`.
12734
+ #
12735
+ # @option params [required, String] :engine_version
12736
+ # The custom engine version (CEV) that you want to modify. This option
12737
+ # is required for RDS Custom, but optional for Amazon RDS. The
12738
+ # combination of `Engine` and `EngineVersion` is unique per customer per
12739
+ # Amazon Web Services Region.
12740
+ #
12741
+ # @option params [String] :description
12742
+ # An optional description of your CEV.
12743
+ #
12744
+ # @option params [String] :status
12745
+ # The availability status to be assigned to the CEV. Valid values are as
12746
+ # follows:
12747
+ #
12748
+ # available
12749
+ #
12750
+ # : You can use this CEV to create a new RDS Custom DB instance.
12751
+ #
12752
+ # inactive
12753
+ #
12754
+ # : You can create a new RDS Custom instance by restoring a DB snapshot
12755
+ # with this CEV. You can't patch or create new instances with this
12756
+ # CEV.
12757
+ #
12758
+ # You can change any status to any status. A typical reason to change
12759
+ # status is to prevent the accidental use of a CEV, or to make a
12760
+ # deprecated CEV eligible for use again. For example, you might change
12761
+ # the status of your CEV from `available` to `inactive`, and from
12762
+ # `inactive` back to `available`. To change the availability status of
12763
+ # the CEV, it must not currently be in use by an RDS Custom instance,
12764
+ # snapshot, or automated backup.
12765
+ #
12766
+ # @return [Types::DBEngineVersion] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
12767
+ #
12768
+ # * {Types::DBEngineVersion#engine #engine} => String
12769
+ # * {Types::DBEngineVersion#engine_version #engine_version} => String
12770
+ # * {Types::DBEngineVersion#db_parameter_group_family #db_parameter_group_family} => String
12771
+ # * {Types::DBEngineVersion#db_engine_description #db_engine_description} => String
12772
+ # * {Types::DBEngineVersion#db_engine_version_description #db_engine_version_description} => String
12773
+ # * {Types::DBEngineVersion#default_character_set #default_character_set} => Types::CharacterSet
12774
+ # * {Types::DBEngineVersion#supported_character_sets #supported_character_sets} => Array&lt;Types::CharacterSet&gt;
12775
+ # * {Types::DBEngineVersion#supported_nchar_character_sets #supported_nchar_character_sets} => Array&lt;Types::CharacterSet&gt;
12776
+ # * {Types::DBEngineVersion#valid_upgrade_target #valid_upgrade_target} => Array&lt;Types::UpgradeTarget&gt;
12777
+ # * {Types::DBEngineVersion#supported_timezones #supported_timezones} => Array&lt;Types::Timezone&gt;
12778
+ # * {Types::DBEngineVersion#exportable_log_types #exportable_log_types} => Array&lt;String&gt;
12779
+ # * {Types::DBEngineVersion#supports_log_exports_to_cloudwatch_logs #supports_log_exports_to_cloudwatch_logs} => Boolean
12780
+ # * {Types::DBEngineVersion#supports_read_replica #supports_read_replica} => Boolean
12781
+ # * {Types::DBEngineVersion#supported_engine_modes #supported_engine_modes} => Array&lt;String&gt;
12782
+ # * {Types::DBEngineVersion#supported_feature_names #supported_feature_names} => Array&lt;String&gt;
12783
+ # * {Types::DBEngineVersion#status #status} => String
12784
+ # * {Types::DBEngineVersion#supports_parallel_query #supports_parallel_query} => Boolean
12785
+ # * {Types::DBEngineVersion#supports_global_databases #supports_global_databases} => Boolean
12786
+ # * {Types::DBEngineVersion#major_engine_version #major_engine_version} => String
12787
+ # * {Types::DBEngineVersion#database_installation_files_s3_bucket_name #database_installation_files_s3_bucket_name} => String
12788
+ # * {Types::DBEngineVersion#database_installation_files_s3_prefix #database_installation_files_s3_prefix} => String
12789
+ # * {Types::DBEngineVersion#db_engine_version_arn #db_engine_version_arn} => String
12790
+ # * {Types::DBEngineVersion#kms_key_id #kms_key_id} => String
12791
+ # * {Types::DBEngineVersion#create_time #create_time} => Time
12792
+ # * {Types::DBEngineVersion#tag_list #tag_list} => Array&lt;Types::Tag&gt;
12793
+ #
12794
+ # @example Request syntax with placeholder values
12795
+ #
12796
+ # resp = client.modify_custom_db_engine_version({
12797
+ # engine: "CustomEngineName", # required
12798
+ # engine_version: "CustomEngineVersion", # required
12799
+ # description: "Description",
12800
+ # status: "available", # accepts available, inactive, inactive-except-restore
12801
+ # })
12802
+ #
12803
+ # @example Response structure
12804
+ #
12805
+ # resp.engine #=> String
12806
+ # resp.engine_version #=> String
12807
+ # resp.db_parameter_group_family #=> String
12808
+ # resp.db_engine_description #=> String
12809
+ # resp.db_engine_version_description #=> String
12810
+ # resp.default_character_set.character_set_name #=> String
12811
+ # resp.default_character_set.character_set_description #=> String
12812
+ # resp.supported_character_sets #=> Array
12813
+ # resp.supported_character_sets[0].character_set_name #=> String
12814
+ # resp.supported_character_sets[0].character_set_description #=> String
12815
+ # resp.supported_nchar_character_sets #=> Array
12816
+ # resp.supported_nchar_character_sets[0].character_set_name #=> String
12817
+ # resp.supported_nchar_character_sets[0].character_set_description #=> String
12818
+ # resp.valid_upgrade_target #=> Array
12819
+ # resp.valid_upgrade_target[0].engine #=> String
12820
+ # resp.valid_upgrade_target[0].engine_version #=> String
12821
+ # resp.valid_upgrade_target[0].description #=> String
12822
+ # resp.valid_upgrade_target[0].auto_upgrade #=> Boolean
12823
+ # resp.valid_upgrade_target[0].is_major_version_upgrade #=> Boolean
12824
+ # resp.valid_upgrade_target[0].supported_engine_modes #=> Array
12825
+ # resp.valid_upgrade_target[0].supported_engine_modes[0] #=> String
12826
+ # resp.valid_upgrade_target[0].supports_parallel_query #=> Boolean
12827
+ # resp.valid_upgrade_target[0].supports_global_databases #=> Boolean
12828
+ # resp.supported_timezones #=> Array
12829
+ # resp.supported_timezones[0].timezone_name #=> String
12830
+ # resp.exportable_log_types #=> Array
12831
+ # resp.exportable_log_types[0] #=> String
12832
+ # resp.supports_log_exports_to_cloudwatch_logs #=> Boolean
12833
+ # resp.supports_read_replica #=> Boolean
12834
+ # resp.supported_engine_modes #=> Array
12835
+ # resp.supported_engine_modes[0] #=> String
12836
+ # resp.supported_feature_names #=> Array
12837
+ # resp.supported_feature_names[0] #=> String
12838
+ # resp.status #=> String
12839
+ # resp.supports_parallel_query #=> Boolean
12840
+ # resp.supports_global_databases #=> Boolean
12841
+ # resp.major_engine_version #=> String
12842
+ # resp.database_installation_files_s3_bucket_name #=> String
12843
+ # resp.database_installation_files_s3_prefix #=> String
12844
+ # resp.db_engine_version_arn #=> String
12845
+ # resp.kms_key_id #=> String
12846
+ # resp.create_time #=> Time
12847
+ # resp.tag_list #=> Array
12848
+ # resp.tag_list[0].key #=> String
12849
+ # resp.tag_list[0].value #=> String
12850
+ #
12851
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyCustomDBEngineVersion AWS API Documentation
12852
+ #
12853
+ # @overload modify_custom_db_engine_version(params = {})
12854
+ # @param [Hash] params ({})
12855
+ def modify_custom_db_engine_version(params = {}, options = {})
12856
+ req = build_request(:modify_custom_db_engine_version, params)
12857
+ req.send_request(options)
12858
+ end
12859
+
12078
12860
  # Modify a setting for an Amazon Aurora DB cluster. You can change one
12079
12861
  # or more database configuration parameters by specifying these
12080
12862
  # parameters and the new values in the request. For more information on
@@ -12418,6 +13200,7 @@ module Aws::RDS
12418
13200
  # auto_pause: false,
12419
13201
  # seconds_until_auto_pause: 1,
12420
13202
  # timeout_action: "String",
13203
+ # seconds_before_timeout: 1,
12421
13204
  # },
12422
13205
  # deletion_protection: false,
12423
13206
  # enable_http_endpoint: false,
@@ -12490,6 +13273,7 @@ module Aws::RDS
12490
13273
  # resp.db_cluster.scaling_configuration_info.auto_pause #=> Boolean
12491
13274
  # resp.db_cluster.scaling_configuration_info.seconds_until_auto_pause #=> Integer
12492
13275
  # resp.db_cluster.scaling_configuration_info.timeout_action #=> String
13276
+ # resp.db_cluster.scaling_configuration_info.seconds_before_timeout #=> Integer
12493
13277
  # resp.db_cluster.deletion_protection #=> Boolean
12494
13278
  # resp.db_cluster.http_endpoint_enabled #=> Boolean
12495
13279
  # resp.db_cluster.activity_stream_mode #=> String, one of "sync", "async"
@@ -12867,12 +13651,14 @@ module Aws::RDS
12867
13651
  # `db.m4.large`. Not all DB instance classes are available in all Amazon
12868
13652
  # Web Services Regions, or for all database engines. For the full list
12869
13653
  # of DB instance classes, and availability for your engine, see [DB
12870
- # Instance Class][1] in the *Amazon RDS User Guide.*
13654
+ # Instance Class][1] in the *Amazon RDS User Guide*.
12871
13655
  #
12872
13656
  # If you modify the DB instance class, an outage occurs during the
12873
13657
  # change. The change is applied during the next maintenance window,
12874
13658
  # unless `ApplyImmediately` is enabled for this request.
12875
13659
  #
13660
+ # This setting doesn't apply to RDS Custom.
13661
+ #
12876
13662
  # Default: Uses existing setting
12877
13663
  #
12878
13664
  #
@@ -12884,12 +13670,14 @@ module Aws::RDS
12884
13670
  # parameter to move your DB instance to a different VPC. If your DB
12885
13671
  # instance isn't in a VPC, you can also use this parameter to move your
12886
13672
  # DB instance into a VPC. For more information, see [Working with a DB
12887
- # instance in a VPC][1] in the *Amazon RDS User Guide.*
13673
+ # instance in a VPC][1] in the *Amazon RDS User Guide*.
12888
13674
  #
12889
13675
  # Changing the subnet group causes an outage during the change. The
12890
13676
  # change is applied during the next maintenance window, unless you
12891
13677
  # enable `ApplyImmediately`.
12892
13678
  #
13679
+ # This parameter doesn't apply to RDS Custom.
13680
+ #
12893
13681
  # Constraints: If supplied, must match the name of an existing
12894
13682
  # DBSubnetGroup.
12895
13683
  #
@@ -12904,6 +13692,8 @@ module Aws::RDS
12904
13692
  # Changing this setting doesn't result in an outage and the change is
12905
13693
  # asynchronously applied as soon as possible.
12906
13694
  #
13695
+ # This setting doesn't apply to RDS Custom.
13696
+ #
12907
13697
  # Constraints:
12908
13698
  #
12909
13699
  # * If supplied, must match existing DBSecurityGroups.
@@ -12911,8 +13701,10 @@ module Aws::RDS
12911
13701
  # ^
12912
13702
  #
12913
13703
  # @option params [Array<String>] :vpc_security_group_ids
12914
- # A list of EC2 VPC security groups to authorize on this DB instance.
12915
- # This change is asynchronously applied as soon as possible.
13704
+ # A list of Amazon EC2 VPC security groups to authorize on this DB
13705
+ # instance. This change is asynchronously applied as soon as possible.
13706
+ #
13707
+ # This setting doesn't apply to RDS Custom.
12916
13708
  #
12917
13709
  # **Amazon Aurora**
12918
13710
  #
@@ -12954,6 +13746,8 @@ module Aws::RDS
12954
13746
  # element exists in the `PendingModifiedValues` element of the operation
12955
13747
  # response.
12956
13748
  #
13749
+ # This setting doesn't apply to RDS Custom.
13750
+ #
12957
13751
  # **Amazon Aurora**
12958
13752
  #
12959
13753
  # Not applicable. The password for the master user is managed by the DB
@@ -12990,17 +13784,22 @@ module Aws::RDS
12990
13784
  #
12991
13785
  # @option params [String] :db_parameter_group_name
12992
13786
  # The name of the DB parameter group to apply to the DB instance.
13787
+ #
12993
13788
  # Changing this setting doesn't result in an outage. The parameter
12994
13789
  # group name itself is changed immediately, but the actual parameter
12995
13790
  # changes are not applied until you reboot the instance without
12996
- # failover. In this case, the DB instance isn't rebooted automatically
12997
- # and the parameter changes isn't applied during the next maintenance
12998
- # window.
13791
+ # failover. In this case, the DB instance isn't rebooted automatically,
13792
+ # and the parameter changes aren't applied during the next maintenance
13793
+ # window. However, if you modify dynamic parameters in the newly
13794
+ # associated DB parameter group, these changes are applied immediately
13795
+ # without a reboot.
13796
+ #
13797
+ # This setting doesn't apply to RDS Custom.
12999
13798
  #
13000
13799
  # Default: Uses existing setting
13001
13800
  #
13002
13801
  # Constraints: The DB parameter group must be in the same DB parameter
13003
- # group family as this DB instance.
13802
+ # group family as the DB instance.
13004
13803
  #
13005
13804
  # @option params [Integer] :backup_retention_period
13006
13805
  # The number of days to retain automated backups. Setting this parameter
@@ -13027,15 +13826,15 @@ module Aws::RDS
13027
13826
  #
13028
13827
  # Constraints:
13029
13828
  #
13030
- # * Must be a value from 0 to 35
13031
- #
13032
- # * Can be specified for a MySQL read replica only if the source is
13033
- # running MySQL 5.6 or later
13829
+ # * It must be a value from 0 to 35. It can't be set to 0 if the DB
13830
+ # instance is a source to read replicas. It can't be set to 0 or 35
13831
+ # for an RDS Custom DB instance.
13034
13832
  #
13035
- # * Can be specified for a PostgreSQL read replica only if the source is
13036
- # running PostgreSQL 9.3.5
13833
+ # * It can be specified for a MySQL read replica only if the source is
13834
+ # running MySQL 5.6 or later.
13037
13835
  #
13038
- # * Can't be set to 0 if the DB instance is a source to read replicas
13836
+ # * It can be specified for a PostgreSQL read replica only if the source
13837
+ # is running PostgreSQL 9.3.5.
13039
13838
  #
13040
13839
  # @option params [String] :preferred_backup_window
13041
13840
  # The daily time range during which automated backups are created if
@@ -13094,10 +13893,12 @@ module Aws::RDS
13094
13893
  #
13095
13894
  # @option params [Boolean] :multi_az
13096
13895
  # A value that indicates whether the DB instance is a Multi-AZ
13097
- # deployment. Changing this parameter doesn't result in an outage and
13098
- # the change is applied during the next maintenance window unless the
13896
+ # deployment. Changing this parameter doesn't result in an outage. The
13897
+ # change is applied during the next maintenance window unless the
13099
13898
  # `ApplyImmediately` parameter is enabled for this request.
13100
13899
  #
13900
+ # This setting doesn't apply to RDS Custom.
13901
+ #
13101
13902
  # @option params [String] :engine_version
13102
13903
  # The version number of the database engine to upgrade to. Changing this
13103
13904
  # parameter results in an outage and the change is applied during the
@@ -13114,27 +13915,42 @@ module Aws::RDS
13114
13915
  # lower. For information about valid engine versions, see
13115
13916
  # `CreateDBInstance`, or call `DescribeDBEngineVersions`.
13116
13917
  #
13918
+ # In RDS Custom, this parameter is supported for read replicas only if
13919
+ # they are in the `PATCH_DB_FAILURE` lifecycle.
13920
+ #
13117
13921
  # @option params [Boolean] :allow_major_version_upgrade
13118
13922
  # A value that indicates whether major version upgrades are allowed.
13119
13923
  # Changing this parameter doesn't result in an outage and the change is
13120
13924
  # asynchronously applied as soon as possible.
13121
13925
  #
13926
+ # This setting doesn't apply to RDS Custom.
13927
+ #
13122
13928
  # Constraints: Major version upgrades must be allowed when specifying a
13123
13929
  # value for the EngineVersion parameter that is a different major
13124
13930
  # version than the DB instance's current version.
13125
13931
  #
13126
13932
  # @option params [Boolean] :auto_minor_version_upgrade
13127
13933
  # A value that indicates whether minor version upgrades are applied
13128
- # automatically to the DB instance during the maintenance window.
13129
- # Changing this parameter doesn't result in an outage except in the
13130
- # following case and the change is asynchronously applied as soon as
13131
- # possible. An outage results if this parameter is enabled during the
13132
- # maintenance window, and a newer minor version is available, and RDS
13133
- # has enabled auto patching for that engine version.
13934
+ # automatically to the DB instance during the maintenance window. An
13935
+ # outage occurs when all the following conditions are met:
13936
+ #
13937
+ # * The automatic upgrade is enabled for the maintenance window.
13938
+ #
13939
+ # * A newer minor version is available.
13940
+ #
13941
+ # * RDS has enabled automatic patching for the engine version.
13942
+ #
13943
+ # If any of the preceding conditions isn't met, RDS applies the change
13944
+ # as soon as possible and doesn't cause an outage.
13945
+ #
13946
+ # For an RDS Custom DB instance, set `AutoMinorVersionUpgrade` to
13947
+ # `false`. Otherwise, the operation returns an error.
13134
13948
  #
13135
13949
  # @option params [String] :license_model
13136
13950
  # The license model for the DB instance.
13137
13951
  #
13952
+ # This setting doesn't apply to RDS Custom.
13953
+ #
13138
13954
  # Valid values: `license-included` \| `bring-your-own-license` \|
13139
13955
  # `general-public-license`
13140
13956
  #
@@ -13173,18 +13989,23 @@ module Aws::RDS
13173
13989
  #
13174
13990
  # @option params [String] :option_group_name
13175
13991
  # A value that indicates the DB instance should be associated with the
13176
- # specified option group. Changing this parameter doesn't result in an
13177
- # outage except in the following case and the change is applied during
13178
- # the next maintenance window unless the `ApplyImmediately` parameter is
13179
- # enabled for this request. If the parameter change results in an option
13180
- # group that enables OEM, this change can cause a brief (sub-second)
13181
- # period during which new connections are rejected but existing
13182
- # connections are not interrupted.
13992
+ # specified option group.
13993
+ #
13994
+ # Changing this parameter doesn't result in an outage, with one
13995
+ # exception. If the parameter change results in an option group that
13996
+ # enables OEM, it can cause a brief period, lasting less than a second,
13997
+ # during which new connections are rejected but existing connections
13998
+ # aren't interrupted.
13999
+ #
14000
+ # The change is applied during the next maintenance window unless the
14001
+ # `ApplyImmediately` parameter is enabled for this request.
13183
14002
  #
13184
14003
  # Permanent options, such as the TDE option for Oracle Advanced Security
13185
14004
  # TDE, can't be removed from an option group, and that option group
13186
- # can't be removed from a DB instance once it is associated with a DB
13187
- # instance
14005
+ # can't be removed from a DB instance after it is associated with a DB
14006
+ # instance.
14007
+ #
14008
+ # This setting doesn't apply to RDS Custom.
13188
14009
  #
13189
14010
  # @option params [String] :new_db_instance_identifier
13190
14011
  # The new DB instance identifier for the DB instance when renaming a DB
@@ -13193,6 +14014,8 @@ module Aws::RDS
13193
14014
  # occur during the next maintenance window if you disable Apply
13194
14015
  # Immediately. This value is stored as a lowercase string.
13195
14016
  #
14017
+ # This setting doesn't apply to RDS Custom.
14018
+ #
13196
14019
  # Constraints:
13197
14020
  #
13198
14021
  # * Must contain from 1 to 63 letters, numbers, or hyphens.
@@ -13232,24 +14055,31 @@ module Aws::RDS
13232
14055
  # The ARN from the key store with which to associate the instance for
13233
14056
  # TDE encryption.
13234
14057
  #
14058
+ # This setting doesn't apply to RDS Custom.
14059
+ #
13235
14060
  # @option params [String] :tde_credential_password
13236
14061
  # The password for the given ARN from the key store in order to access
13237
14062
  # the device.
13238
14063
  #
14064
+ # This setting doesn't apply to RDS Custom.
14065
+ #
13239
14066
  # @option params [String] :ca_certificate_identifier
13240
- # Indicates the certificate that needs to be associated with the
13241
- # instance.
14067
+ # Specifies the certificate to associate with the DB instance.
14068
+ #
14069
+ # This setting doesn't apply to RDS Custom.
13242
14070
  #
13243
14071
  # @option params [String] :domain
13244
14072
  # The Active Directory directory ID to move the DB instance to. Specify
13245
- # `none` to remove the instance from its current domain. The domain must
13246
- # be created prior to this operation. Currently, only MySQL, Microsoft
13247
- # SQL Server, Oracle, and PostgreSQL DB instances can be created in an
14073
+ # `none` to remove the instance from its current domain. You must create
14074
+ # the domain before this operation. Currently, you can create only
14075
+ # MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances in an
13248
14076
  # Active Directory Domain.
13249
14077
  #
13250
14078
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
13251
14079
  # RDS User Guide*.
13252
14080
  #
14081
+ # This setting doesn't apply to RDS Custom.
14082
+ #
13253
14083
  #
13254
14084
  #
13255
14085
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -13267,10 +14097,12 @@ module Aws::RDS
13267
14097
  # @option params [Integer] :monitoring_interval
13268
14098
  # The interval, in seconds, between points when Enhanced Monitoring
13269
14099
  # metrics are collected for the DB instance. To disable collecting
13270
- # Enhanced Monitoring metrics, specify 0. The default is 0.
14100
+ # Enhanced Monitoring metrics, specify 0, which is the default.
13271
14101
  #
13272
- # If `MonitoringRoleArn` is specified, then you must also set
13273
- # `MonitoringInterval` to a value other than 0.
14102
+ # If `MonitoringRoleArn` is specified, set `MonitoringInterval` to a
14103
+ # value other than 0.
14104
+ #
14105
+ # This setting doesn't apply to RDS Custom.
13274
14106
  #
13275
14107
  # Valid Values: `0, 1, 5, 10, 15, 30, 60`
13276
14108
  #
@@ -13281,9 +14113,11 @@ module Aws::RDS
13281
14113
  # port values specified for options in the option group for the DB
13282
14114
  # instance.
13283
14115
  #
13284
- # Your database will restart when you change the `DBPortNumber` value
14116
+ # If you change the `DBPortNumber` value, your database restarts
13285
14117
  # regardless of the value of the `ApplyImmediately` parameter.
13286
14118
  #
14119
+ # This setting doesn't apply to RDS Custom.
14120
+ #
13287
14121
  # **MySQL**
13288
14122
  #
13289
14123
  # Default: `3306`
@@ -13343,15 +14177,19 @@ module Aws::RDS
13343
14177
  # Changes to the `PubliclyAccessible` parameter are applied immediately
13344
14178
  # regardless of the value of the `ApplyImmediately` parameter.
13345
14179
  #
14180
+ # This setting doesn't apply to RDS Custom.
14181
+ #
13346
14182
  # @option params [String] :monitoring_role_arn
13347
14183
  # The ARN for the IAM role that permits RDS to send enhanced monitoring
13348
14184
  # metrics to Amazon CloudWatch Logs. For example,
13349
14185
  # `arn:aws:iam:123456789012:role/emaccess`. For information on creating
13350
- # a monitoring role, go to [To create an IAM role for Amazon RDS
13351
- # Enhanced Monitoring][1] in the *Amazon RDS User Guide.*
14186
+ # a monitoring role, see [To create an IAM role for Amazon RDS Enhanced
14187
+ # Monitoring][1] in the *Amazon RDS User Guide.*
13352
14188
  #
13353
- # If `MonitoringInterval` is set to a value other than 0, then you must
13354
- # supply a `MonitoringRoleArn` value.
14189
+ # If `MonitoringInterval` is set to a value other than 0, supply a
14190
+ # `MonitoringRoleArn` value.
14191
+ #
14192
+ # This setting doesn't apply to RDS Custom.
13355
14193
  #
13356
14194
  #
13357
14195
  #
@@ -13361,12 +14199,16 @@ module Aws::RDS
13361
14199
  # The name of the IAM role to use when making API calls to the Directory
13362
14200
  # Service.
13363
14201
  #
14202
+ # This setting doesn't apply to RDS Custom.
14203
+ #
13364
14204
  # @option params [Integer] :promotion_tier
13365
14205
  # A value that specifies the order in which an Aurora Replica is
13366
14206
  # promoted to the primary instance after a failure of the existing
13367
14207
  # primary instance. For more information, see [ Fault Tolerance for an
13368
14208
  # Aurora DB Cluster][1] in the *Amazon Aurora User Guide*.
13369
14209
  #
14210
+ # This setting doesn't apply to RDS Custom.
14211
+ #
13370
14212
  # Default: 1
13371
14213
  #
13372
14214
  # Valid Values: 0 - 15
@@ -13388,6 +14230,8 @@ module Aws::RDS
13388
14230
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
13389
14231
  # RDS User Guide.*
13390
14232
  #
14233
+ # This setting doesn't apply to RDS Custom.
14234
+ #
13391
14235
  #
13392
14236
  #
13393
14237
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
@@ -13399,6 +14243,8 @@ module Aws::RDS
13399
14243
  # For more information, see [Using Amazon Performance Insights][1] in
13400
14244
  # the *Amazon Relational Database Service User Guide*.
13401
14245
  #
14246
+ # This setting doesn't apply to RDS Custom.
14247
+ #
13402
14248
  #
13403
14249
  #
13404
14250
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
@@ -13408,18 +14254,21 @@ module Aws::RDS
13408
14254
  # Performance Insights data.
13409
14255
  #
13410
14256
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
13411
- # alias ARN, or alias name for the Amazon Web Services KMS customer
13412
- # master key (CMK).
14257
+ # alias ARN, or alias name for the KMS key.
13413
14258
  #
13414
14259
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
13415
- # Amazon RDS uses your default CMK. There is a default CMK for your
13416
- # Amazon Web Services account. Your Amazon Web Services account has a
13417
- # different default CMK for each Amazon Web Services Region.
14260
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
14261
+ # your Amazon Web Services account. Your Amazon Web Services account has
14262
+ # a different default KMS key for each Amazon Web Services Region.
14263
+ #
14264
+ # This setting doesn't apply to RDS Custom.
13418
14265
  #
13419
14266
  # @option params [Integer] :performance_insights_retention_period
13420
14267
  # The amount of time, in days, to retain Performance Insights data.
13421
14268
  # Valid values are 7 or 731 (2 years).
13422
14269
  #
14270
+ # This setting doesn't apply to RDS Custom.
14271
+ #
13423
14272
  # @option params [Types::CloudwatchLogsExportConfiguration] :cloudwatch_logs_export_configuration
13424
14273
  # The configuration setting for the log types to be enabled for export
13425
14274
  # to CloudWatch Logs for a specific DB instance.
@@ -13428,14 +14277,20 @@ module Aws::RDS
13428
14277
  # always applied to the DB instance immediately. Therefore, the
13429
14278
  # `ApplyImmediately` parameter has no effect.
13430
14279
  #
14280
+ # This setting doesn't apply to RDS Custom.
14281
+ #
13431
14282
  # @option params [Array<Types::ProcessorFeature>] :processor_features
13432
14283
  # The number of CPU cores and the number of threads per core for the DB
13433
14284
  # instance class of the DB instance.
13434
14285
  #
14286
+ # This setting doesn't apply to RDS Custom.
14287
+ #
13435
14288
  # @option params [Boolean] :use_default_processor_features
13436
14289
  # A value that indicates whether the DB instance class of the DB
13437
14290
  # instance uses its default processor features.
13438
14291
  #
14292
+ # This setting doesn't apply to RDS Custom.
14293
+ #
13439
14294
  # @option params [Boolean] :deletion_protection
13440
14295
  # A value that indicates whether the DB instance has deletion protection
13441
14296
  # enabled. The database can't be deleted when deletion protection is
@@ -13454,6 +14309,8 @@ module Aws::RDS
13454
14309
  # apply to it, see [ Managing capacity automatically with Amazon RDS
13455
14310
  # storage autoscaling][1] in the *Amazon RDS User Guide*.
13456
14311
  #
14312
+ # This setting doesn't apply to RDS Custom.
14313
+ #
13457
14314
  #
13458
14315
  #
13459
14316
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -13481,6 +14338,8 @@ module Aws::RDS
13481
14338
  # Aurora DB engines, see [ Rotating Your SSL/TLS Certificate][2] in
13482
14339
  # the *Amazon Aurora User Guide.*
13483
14340
  #
14341
+ # This setting doesn't apply to RDS Custom.
14342
+ #
13484
14343
  #
13485
14344
  #
13486
14345
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html
@@ -13502,6 +14361,8 @@ module Aws::RDS
13502
14361
  # more information, see [Working with Oracle Read Replicas for Amazon
13503
14362
  # RDS][1] in the *Amazon RDS User Guide*.
13504
14363
  #
14364
+ # This setting doesn't apply to RDS Custom.
14365
+ #
13505
14366
  #
13506
14367
  #
13507
14368
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
@@ -13531,6 +14392,19 @@ module Aws::RDS
13531
14392
  # The Amazon Resource Name (ARN) of the recovery point in Amazon Web
13532
14393
  # Services Backup.
13533
14394
  #
14395
+ # This setting doesn't apply to RDS Custom.
14396
+ #
14397
+ # @option params [String] :automation_mode
14398
+ # The automation mode of the RDS Custom DB instance: `full` or `all
14399
+ # paused`. If `full`, the DB instance automates monitoring and instance
14400
+ # recovery. If `all paused`, the instance pauses automation for the
14401
+ # duration set by `ResumeFullAutomationModeMinutes`.
14402
+ #
14403
+ # @option params [Integer] :resume_full_automation_mode_minutes
14404
+ # The number of minutes to pause the automation. When the time period
14405
+ # ends, RDS Custom resumes full automation. The minimum value is `60`
14406
+ # (default). The maximum value is `1,440`.
14407
+ #
13534
14408
  # @return [Types::ModifyDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
13535
14409
  #
13536
14410
  # * {Types::ModifyDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -13613,6 +14487,8 @@ module Aws::RDS
13613
14487
  # replica_mode: "open-read-only", # accepts open-read-only, mounted
13614
14488
  # enable_customer_owned_ip: false,
13615
14489
  # aws_backup_recovery_point_arn: "AwsBackupRecoveryPointArn",
14490
+ # automation_mode: "full", # accepts full, all-paused
14491
+ # resume_full_automation_mode_minutes: 1,
13616
14492
  # })
13617
14493
  #
13618
14494
  # @example Response structure
@@ -13673,6 +14549,8 @@ module Aws::RDS
13673
14549
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
13674
14550
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
13675
14551
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
14552
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
14553
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
13676
14554
  # resp.db_instance.latest_restorable_time #=> Time
13677
14555
  # resp.db_instance.multi_az #=> Boolean
13678
14556
  # resp.db_instance.engine_version #=> String
@@ -13747,6 +14625,9 @@ module Aws::RDS
13747
14625
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
13748
14626
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
13749
14627
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
14628
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
14629
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
14630
+ # resp.db_instance.custom_iam_instance_profile #=> String
13750
14631
  #
13751
14632
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstance AWS API Documentation
13752
14633
  #
@@ -14087,8 +14968,8 @@ module Aws::RDS
14087
14968
  # Updates a manual DB snapshot with a new engine version. The snapshot
14088
14969
  # can be encrypted or unencrypted, but not shared or public.
14089
14970
  #
14090
- # Amazon RDS supports upgrading DB snapshots for MySQL, Oracle, and
14091
- # PostgreSQL.
14971
+ # Amazon RDS supports upgrading DB snapshots for MySQL, PostgreSQL, and
14972
+ # Oracle. This command doesn't apply to RDS Custom.
14092
14973
  #
14093
14974
  # @option params [required, String] :db_snapshot_identifier
14094
14975
  # The identifier of the DB snapshot to modify.
@@ -14737,7 +15618,8 @@ module Aws::RDS
14737
15618
  # on your read replica, configure the automated backup window so that
14738
15619
  # daily backups do not interfere with read replica promotion.
14739
15620
  #
14740
- # * This command doesn't apply to Aurora MySQL and Aurora PostgreSQL.
15621
+ # * This command doesn't apply to Aurora MySQL, Aurora PostgreSQL, or
15622
+ # RDS Custom.
14741
15623
  #
14742
15624
  # </note>
14743
15625
  #
@@ -14877,6 +15759,8 @@ module Aws::RDS
14877
15759
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
14878
15760
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
14879
15761
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
15762
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
15763
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
14880
15764
  # resp.db_instance.latest_restorable_time #=> Time
14881
15765
  # resp.db_instance.multi_az #=> Boolean
14882
15766
  # resp.db_instance.engine_version #=> String
@@ -14951,6 +15835,9 @@ module Aws::RDS
14951
15835
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
14952
15836
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
14953
15837
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
15838
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
15839
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
15840
+ # resp.db_instance.custom_iam_instance_profile #=> String
14954
15841
  #
14955
15842
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplica AWS API Documentation
14956
15843
  #
@@ -15054,6 +15941,7 @@ module Aws::RDS
15054
15941
  # resp.db_cluster.scaling_configuration_info.auto_pause #=> Boolean
15055
15942
  # resp.db_cluster.scaling_configuration_info.seconds_until_auto_pause #=> Integer
15056
15943
  # resp.db_cluster.scaling_configuration_info.timeout_action #=> String
15944
+ # resp.db_cluster.scaling_configuration_info.seconds_before_timeout #=> Integer
15057
15945
  # resp.db_cluster.deletion_protection #=> Boolean
15058
15946
  # resp.db_cluster.http_endpoint_enabled #=> Boolean
15059
15947
  # resp.db_cluster.activity_stream_mode #=> String, one of "sync", "async"
@@ -15191,6 +16079,8 @@ module Aws::RDS
15191
16079
  # For more information about rebooting, see [Rebooting a DB Instance][1]
15192
16080
  # in the *Amazon RDS User Guide.*
15193
16081
  #
16082
+ # This command doesn't apply to RDS Custom.
16083
+ #
15194
16084
  #
15195
16085
  #
15196
16086
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RebootInstance.html
@@ -15297,6 +16187,8 @@ module Aws::RDS
15297
16187
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
15298
16188
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
15299
16189
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
16190
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
16191
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
15300
16192
  # resp.db_instance.latest_restorable_time #=> Time
15301
16193
  # resp.db_instance.multi_az #=> Boolean
15302
16194
  # resp.db_instance.engine_version #=> String
@@ -15371,6 +16263,9 @@ module Aws::RDS
15371
16263
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
15372
16264
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
15373
16265
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
16266
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
16267
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
16268
+ # resp.db_instance.custom_iam_instance_profile #=> String
15374
16269
  #
15375
16270
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RebootDBInstance AWS API Documentation
15376
16271
  #
@@ -15514,7 +16409,7 @@ module Aws::RDS
15514
16409
  #
15515
16410
  # @option params [String] :feature_name
15516
16411
  # The name of the feature for the DB cluster that the IAM role is to be
15517
- # disassociated from. For the list of supported feature names, see
16412
+ # disassociated from. For information about supported feature names, see
15518
16413
  # DBEngineVersion.
15519
16414
  #
15520
16415
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -15549,7 +16444,7 @@ module Aws::RDS
15549
16444
  #
15550
16445
  # @option params [required, String] :feature_name
15551
16446
  # The name of the feature for the DB instance that the IAM role is to be
15552
- # disassociated from. For the list of supported feature names, see
16447
+ # disassociated from. For information about supported feature names, see
15553
16448
  # `DBEngineVersion`.
15554
16449
  #
15555
16450
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -16096,15 +16991,15 @@ module Aws::RDS
16096
16991
  # cluster.
16097
16992
  #
16098
16993
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
16099
- # alias ARN, or alias name for the Amazon Web Services KMS customer
16100
- # master key (CMK). To use a CMK in a different Amazon Web Services
16101
- # account, specify the key ARN or alias ARN.
16994
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
16995
+ # different Amazon Web Services account, specify the key ARN or alias
16996
+ # ARN.
16102
16997
  #
16103
16998
  # If the StorageEncrypted parameter is enabled, and you do not specify a
16104
16999
  # value for the `KmsKeyId` parameter, then Amazon RDS will use your
16105
- # default CMK. There is a default CMK for your Amazon Web Services
16106
- # account. Your Amazon Web Services account has a different default CMK
16107
- # for each Amazon Web Services Region.
17000
+ # default KMS key. There is a default KMS key for your Amazon Web
17001
+ # Services account. Your Amazon Web Services account has a different
17002
+ # default KMS key for each Amazon Web Services Region.
16108
17003
  #
16109
17004
  # @option params [Boolean] :enable_iam_database_authentication
16110
17005
  # A value that indicates whether to enable mapping of Amazon Web
@@ -16310,6 +17205,7 @@ module Aws::RDS
16310
17205
  # resp.db_cluster.scaling_configuration_info.auto_pause #=> Boolean
16311
17206
  # resp.db_cluster.scaling_configuration_info.seconds_until_auto_pause #=> Integer
16312
17207
  # resp.db_cluster.scaling_configuration_info.timeout_action #=> String
17208
+ # resp.db_cluster.scaling_configuration_info.seconds_before_timeout #=> Integer
16313
17209
  # resp.db_cluster.deletion_protection #=> Boolean
16314
17210
  # resp.db_cluster.http_endpoint_enabled #=> Boolean
16315
17211
  # resp.db_cluster.activity_stream_mode #=> String, one of "sync", "async"
@@ -16479,17 +17375,16 @@ module Aws::RDS
16479
17375
  # encrypted DB cluster from a DB snapshot or DB cluster snapshot.
16480
17376
  #
16481
17377
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
16482
- # alias ARN, or alias name for the Amazon Web Services KMS customer
16483
- # master key (CMK). To use a CMK in a different Amazon Web Services
16484
- # account, specify the key ARN or alias ARN.
17378
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
17379
+ # different Amazon Web Services account, specify the key ARN or alias
17380
+ # ARN.
16485
17381
  #
16486
17382
  # When you don't specify a value for the `KmsKeyId` parameter, then the
16487
17383
  # following occurs:
16488
17384
  #
16489
17385
  # * If the DB snapshot or DB cluster snapshot in `SnapshotIdentifier` is
16490
- # encrypted, then the restored DB cluster is encrypted using the
16491
- # Amazon Web Services KMS CMK that was used to encrypt the DB snapshot
16492
- # or DB cluster snapshot.
17386
+ # encrypted, then the restored DB cluster is encrypted using the KMS
17387
+ # key that was used to encrypt the DB snapshot or DB cluster snapshot.
16493
17388
  #
16494
17389
  # * If the DB snapshot or DB cluster snapshot in `SnapshotIdentifier`
16495
17390
  # isn't encrypted, then the restored DB cluster isn't encrypted.
@@ -16641,6 +17536,7 @@ module Aws::RDS
16641
17536
  # auto_pause: false,
16642
17537
  # seconds_until_auto_pause: 1,
16643
17538
  # timeout_action: "String",
17539
+ # seconds_before_timeout: 1,
16644
17540
  # },
16645
17541
  # db_cluster_parameter_group_name: "String",
16646
17542
  # deletion_protection: false,
@@ -16714,6 +17610,7 @@ module Aws::RDS
16714
17610
  # resp.db_cluster.scaling_configuration_info.auto_pause #=> Boolean
16715
17611
  # resp.db_cluster.scaling_configuration_info.seconds_until_auto_pause #=> Integer
16716
17612
  # resp.db_cluster.scaling_configuration_info.timeout_action #=> String
17613
+ # resp.db_cluster.scaling_configuration_info.seconds_before_timeout #=> Integer
16717
17614
  # resp.db_cluster.deletion_protection #=> Boolean
16718
17615
  # resp.db_cluster.http_endpoint_enabled #=> Boolean
16719
17616
  # resp.db_cluster.activity_stream_mode #=> String, one of "sync", "async"
@@ -16876,22 +17773,21 @@ module Aws::RDS
16876
17773
  # encrypted DB cluster from an encrypted DB cluster.
16877
17774
  #
16878
17775
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
16879
- # alias ARN, or alias name for the Amazon Web Services KMS customer
16880
- # master key (CMK). To use a CMK in a different Amazon Web Services
16881
- # account, specify the key ARN or alias ARN.
17776
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
17777
+ # different Amazon Web Services account, specify the key ARN or alias
17778
+ # ARN.
16882
17779
  #
16883
17780
  # You can restore to a new DB cluster and encrypt the new DB cluster
16884
- # with a Amazon Web Services KMS CMK that is different than the Amazon
16885
- # Web Services KMS key used to encrypt the source DB cluster. The new DB
16886
- # cluster is encrypted with the Amazon Web Services KMS CMK identified
16887
- # by the `KmsKeyId` parameter.
17781
+ # with a KMS key that is different from the KMS key used to encrypt the
17782
+ # source DB cluster. The new DB cluster is encrypted with the KMS key
17783
+ # identified by the `KmsKeyId` parameter.
16888
17784
  #
16889
17785
  # If you don't specify a value for the `KmsKeyId` parameter, then the
16890
17786
  # following occurs:
16891
17787
  #
16892
17788
  # * If the DB cluster is encrypted, then the restored DB cluster is
16893
- # encrypted using the Amazon Web Services KMS CMK that was used to
16894
- # encrypt the source DB cluster.
17789
+ # encrypted using the KMS key that was used to encrypt the source DB
17790
+ # cluster.
16895
17791
  #
16896
17792
  # * If the DB cluster isn't encrypted, then the restored DB cluster
16897
17793
  # isn't encrypted.
@@ -17047,6 +17943,7 @@ module Aws::RDS
17047
17943
  # auto_pause: false,
17048
17944
  # seconds_until_auto_pause: 1,
17049
17945
  # timeout_action: "String",
17946
+ # seconds_before_timeout: 1,
17050
17947
  # },
17051
17948
  # engine_mode: "String",
17052
17949
  # })
@@ -17116,6 +18013,7 @@ module Aws::RDS
17116
18013
  # resp.db_cluster.scaling_configuration_info.auto_pause #=> Boolean
17117
18014
  # resp.db_cluster.scaling_configuration_info.seconds_until_auto_pause #=> Integer
17118
18015
  # resp.db_cluster.scaling_configuration_info.timeout_action #=> String
18016
+ # resp.db_cluster.scaling_configuration_info.seconds_before_timeout #=> Integer
17119
18017
  # resp.db_cluster.deletion_protection #=> Boolean
17120
18018
  # resp.db_cluster.http_endpoint_enabled #=> Boolean
17121
18019
  # resp.db_cluster.activity_stream_mode #=> String, one of "sync", "async"
@@ -17245,6 +18143,8 @@ module Aws::RDS
17245
18143
  # A value that indicates whether the DB instance is a Multi-AZ
17246
18144
  # deployment.
17247
18145
  #
18146
+ # This setting doesn't apply to RDS Custom.
18147
+ #
17248
18148
  # Constraint: You can't specify the `AvailabilityZone` parameter if the
17249
18149
  # DB instance is a Multi-AZ deployment.
17250
18150
  #
@@ -17267,9 +18167,14 @@ module Aws::RDS
17267
18167
  # A value that indicates whether minor version upgrades are applied
17268
18168
  # automatically to the DB instance during the maintenance window.
17269
18169
  #
18170
+ # If you restore an RDS Custom DB instance, you must disable this
18171
+ # parameter.
18172
+ #
17270
18173
  # @option params [String] :license_model
17271
18174
  # License model information for the restored DB instance.
17272
18175
  #
18176
+ # This setting doesn't apply to RDS Custom.
18177
+ #
17273
18178
  # Default: Same as source.
17274
18179
  #
17275
18180
  # Valid values: `license-included` \| `bring-your-own-license` \|
@@ -17278,14 +18183,14 @@ module Aws::RDS
17278
18183
  # @option params [String] :db_name
17279
18184
  # The database name for the restored DB instance.
17280
18185
  #
17281
- # <note markdown="1"> This parameter doesn't apply to the MySQL, PostgreSQL, or MariaDB
17282
- # engines.
17283
- #
17284
- # </note>
18186
+ # This parameter doesn't apply to the MySQL, PostgreSQL, or MariaDB
18187
+ # engines. It also doesn't apply to RDS Custom DB instances.
17285
18188
  #
17286
18189
  # @option params [String] :engine
17287
18190
  # The database engine to use for the new instance.
17288
18191
  #
18192
+ # This setting doesn't apply to RDS Custom.
18193
+ #
17289
18194
  # Default: The same as source
17290
18195
  #
17291
18196
  # Constraint: Must be compatible with the engine of the source. For
@@ -17340,8 +18245,10 @@ module Aws::RDS
17340
18245
  #
17341
18246
  # Permanent options, such as the TDE option for Oracle Advanced Security
17342
18247
  # TDE, can't be removed from an option group, and that option group
17343
- # can't be removed from a DB instance once it is associated with a DB
17344
- # instance
18248
+ # can't be removed from a DB instance after it is associated with a DB
18249
+ # instance.
18250
+ #
18251
+ # This setting doesn't apply to RDS Custom.
17345
18252
  #
17346
18253
  # @option params [Array<Types::Tag>] :tags
17347
18254
  # A list of tags. For more information, see [Tagging Amazon RDS
@@ -17365,10 +18272,14 @@ module Aws::RDS
17365
18272
  # The ARN from the key store with which to associate the instance for
17366
18273
  # TDE encryption.
17367
18274
  #
18275
+ # This setting doesn't apply to RDS Custom.
18276
+ #
17368
18277
  # @option params [String] :tde_credential_password
17369
18278
  # The password for the given ARN from the key store in order to access
17370
18279
  # the device.
17371
18280
  #
18281
+ # This setting doesn't apply to RDS Custom.
18282
+ #
17372
18283
  # @option params [Array<String>] :vpc_security_group_ids
17373
18284
  # A list of EC2 VPC security groups to associate with this DB instance.
17374
18285
  #
@@ -17377,13 +18288,15 @@ module Aws::RDS
17377
18288
  #
17378
18289
  # @option params [String] :domain
17379
18290
  # Specify the Active Directory directory ID to restore the DB instance
17380
- # in. The domain must be created prior to this operation. Currently,
17381
- # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
17382
- # can be created in an Active Directory Domain.
18291
+ # in. The domain/ must be created prior to this operation. Currently,
18292
+ # you can create only MySQL, Microsoft SQL Server, Oracle, and
18293
+ # PostgreSQL DB instances in an Active Directory Domain.
17383
18294
  #
17384
18295
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
17385
18296
  # RDS User Guide*.
17386
18297
  #
18298
+ # This setting doesn't apply to RDS Custom.
18299
+ #
17387
18300
  #
17388
18301
  #
17389
18302
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -17397,6 +18310,8 @@ module Aws::RDS
17397
18310
  # Specify the name of the IAM role to be used when making API calls to
17398
18311
  # the Directory Service.
17399
18312
  #
18313
+ # This setting doesn't apply to RDS Custom.
18314
+ #
17400
18315
  # @option params [Boolean] :enable_iam_database_authentication
17401
18316
  # A value that indicates whether to enable mapping of Amazon Web
17402
18317
  # Services Identity and Access Management (IAM) accounts to database
@@ -17406,6 +18321,8 @@ module Aws::RDS
17406
18321
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
17407
18322
  # RDS User Guide.*
17408
18323
  #
18324
+ # This setting doesn't apply to RDS Custom.
18325
+ #
17409
18326
  #
17410
18327
  #
17411
18328
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
@@ -17416,6 +18333,8 @@ module Aws::RDS
17416
18333
  # used. For more information, see [Publishing Database Logs to Amazon
17417
18334
  # CloudWatch Logs][1] in the *Amazon RDS User Guide*.
17418
18335
  #
18336
+ # This setting doesn't apply to RDS Custom.
18337
+ #
17419
18338
  #
17420
18339
  #
17421
18340
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -17424,15 +18343,21 @@ module Aws::RDS
17424
18343
  # The number of CPU cores and the number of threads per core for the DB
17425
18344
  # instance class of the DB instance.
17426
18345
  #
18346
+ # This setting doesn't apply to RDS Custom.
18347
+ #
17427
18348
  # @option params [Boolean] :use_default_processor_features
17428
18349
  # A value that indicates whether the DB instance class of the DB
17429
18350
  # instance uses its default processor features.
17430
18351
  #
18352
+ # This setting doesn't apply to RDS Custom.
18353
+ #
17431
18354
  # @option params [String] :db_parameter_group_name
17432
18355
  # The name of the DB parameter group to associate with this DB instance.
17433
18356
  #
17434
- # If you do not specify a value for `DBParameterGroupName`, then the
17435
- # default `DBParameterGroup` for the specified DB engine is used.
18357
+ # If you don't specify a value for `DBParameterGroupName`, then RDS
18358
+ # uses the default `DBParameterGroup` for the specified DB engine.
18359
+ #
18360
+ # This setting doesn't apply to RDS Custom.
17436
18361
  #
17437
18362
  # Constraints:
17438
18363
  #
@@ -17463,6 +18388,8 @@ module Aws::RDS
17463
18388
  # a CoIP can provide lower latency for connections to the DB instance
17464
18389
  # from outside of its virtual private cloud (VPC) on your local network.
17465
18390
  #
18391
+ # This setting doesn't apply to RDS Custom.
18392
+ #
17466
18393
  # For more information about RDS on Outposts, see [Working with Amazon
17467
18394
  # RDS on Amazon Web Services Outposts][1] in the *Amazon RDS User
17468
18395
  # Guide*.
@@ -17475,6 +18402,29 @@ module Aws::RDS
17475
18402
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
17476
18403
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
17477
18404
  #
18405
+ # @option params [String] :custom_iam_instance_profile
18406
+ # The instance profile associated with the underlying Amazon EC2
18407
+ # instance of an RDS Custom DB instance. The instance profile must meet
18408
+ # the following requirements:
18409
+ #
18410
+ # * The profile must exist in your account.
18411
+ #
18412
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
18413
+ # assume.
18414
+ #
18415
+ # * The instance profile name and the associated IAM role name must
18416
+ # start with the prefix `AWSRDSCustom`.
18417
+ #
18418
+ # For the list of permissions required for the IAM role, see [ Configure
18419
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
18420
+ # Guide*.
18421
+ #
18422
+ # This setting is required for RDS Custom.
18423
+ #
18424
+ #
18425
+ #
18426
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
18427
+ #
17478
18428
  # @return [Types::RestoreDBInstanceFromDBSnapshotResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
17479
18429
  #
17480
18430
  # * {Types::RestoreDBInstanceFromDBSnapshotResult#db_instance #db_instance} => Types::DBInstance
@@ -17616,6 +18566,7 @@ module Aws::RDS
17616
18566
  # db_parameter_group_name: "String",
17617
18567
  # deletion_protection: false,
17618
18568
  # enable_customer_owned_ip: false,
18569
+ # custom_iam_instance_profile: "String",
17619
18570
  # })
17620
18571
  #
17621
18572
  # @example Response structure
@@ -17676,6 +18627,8 @@ module Aws::RDS
17676
18627
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
17677
18628
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
17678
18629
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
18630
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
18631
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
17679
18632
  # resp.db_instance.latest_restorable_time #=> Time
17680
18633
  # resp.db_instance.multi_az #=> Boolean
17681
18634
  # resp.db_instance.engine_version #=> String
@@ -17750,6 +18703,9 @@ module Aws::RDS
17750
18703
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
17751
18704
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
17752
18705
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
18706
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
18707
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
18708
+ # resp.db_instance.custom_iam_instance_profile #=> String
17753
18709
  #
17754
18710
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshot AWS API Documentation
17755
18711
  #
@@ -17767,6 +18723,8 @@ module Aws::RDS
17767
18723
  # instance running MySQL. For more information, see [Importing Data into
17768
18724
  # an Amazon RDS MySQL DB Instance][1] in the *Amazon RDS User Guide.*
17769
18725
  #
18726
+ # This command doesn't apply to RDS Custom.
18727
+ #
17770
18728
  #
17771
18729
  #
17772
18730
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/MySQL.Procedural.Importing.html
@@ -18002,15 +18960,15 @@ module Aws::RDS
18002
18960
  # instance.
18003
18961
  #
18004
18962
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
18005
- # alias ARN, or alias name for the Amazon Web Services KMS customer
18006
- # master key (CMK). To use a CMK in a different Amazon Web Services
18007
- # account, specify the key ARN or alias ARN.
18963
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
18964
+ # different Amazon Web Services account, specify the key ARN or alias
18965
+ # ARN.
18008
18966
  #
18009
18967
  # If the `StorageEncrypted` parameter is enabled, and you do not specify
18010
18968
  # a value for the `KmsKeyId` parameter, then Amazon RDS will use your
18011
- # default CMK. There is a default CMK for your Amazon Web Services
18012
- # account. Your Amazon Web Services account has a different default CMK
18013
- # for each Amazon Web Services Region.
18969
+ # default KMS key. There is a default KMS key for your Amazon Web
18970
+ # Services account. Your Amazon Web Services account has a different
18971
+ # default KMS key for each Amazon Web Services Region.
18014
18972
  #
18015
18973
  # @option params [Boolean] :copy_tags_to_snapshot
18016
18974
  # A value that indicates whether to copy all tags from the DB instance
@@ -18094,13 +19052,12 @@ module Aws::RDS
18094
19052
  # Performance Insights data.
18095
19053
  #
18096
19054
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
18097
- # alias ARN, or alias name for the Amazon Web Services KMS customer
18098
- # master key (CMK).
19055
+ # alias ARN, or alias name for the KMS key.
18099
19056
  #
18100
19057
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
18101
- # Amazon RDS uses your default CMK. There is a default CMK for your
18102
- # Amazon Web Services account. Your Amazon Web Services account has a
18103
- # different default CMK for each Amazon Web Services Region.
19058
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
19059
+ # your Amazon Web Services account. Your Amazon Web Services account has
19060
+ # a different default KMS key for each Amazon Web Services Region.
18104
19061
  #
18105
19062
  # @option params [Integer] :performance_insights_retention_period
18106
19063
  # The amount of time, in days, to retain Performance Insights data.
@@ -18267,6 +19224,8 @@ module Aws::RDS
18267
19224
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
18268
19225
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
18269
19226
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
19227
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
19228
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
18270
19229
  # resp.db_instance.latest_restorable_time #=> Time
18271
19230
  # resp.db_instance.multi_az #=> Boolean
18272
19231
  # resp.db_instance.engine_version #=> String
@@ -18341,6 +19300,9 @@ module Aws::RDS
18341
19300
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
18342
19301
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
18343
19302
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
19303
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
19304
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
19305
+ # resp.db_instance.custom_iam_instance_profile #=> String
18344
19306
  #
18345
19307
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromS3 AWS API Documentation
18346
19308
  #
@@ -18455,6 +19417,8 @@ module Aws::RDS
18455
19417
  # A value that indicates whether the DB instance is a Multi-AZ
18456
19418
  # deployment.
18457
19419
  #
19420
+ # This setting doesn't apply to RDS Custom.
19421
+ #
18458
19422
  # Constraint: You can't specify the `AvailabilityZone` parameter if the
18459
19423
  # DB instance is a Multi-AZ deployment.
18460
19424
  #
@@ -18477,9 +19441,13 @@ module Aws::RDS
18477
19441
  # A value that indicates whether minor version upgrades are applied
18478
19442
  # automatically to the DB instance during the maintenance window.
18479
19443
  #
19444
+ # This setting doesn't apply to RDS Custom.
19445
+ #
18480
19446
  # @option params [String] :license_model
18481
19447
  # License model information for the restored DB instance.
18482
19448
  #
19449
+ # This setting doesn't apply to RDS Custom.
19450
+ #
18483
19451
  # Default: Same as source.
18484
19452
  #
18485
19453
  # Valid values: `license-included` \| `bring-your-own-license` \|
@@ -18488,13 +19456,16 @@ module Aws::RDS
18488
19456
  # @option params [String] :db_name
18489
19457
  # The database name for the restored DB instance.
18490
19458
  #
18491
- # <note markdown="1"> This parameter isn't used for the MySQL or MariaDB engines.
19459
+ # <note markdown="1"> This parameter isn't supported for the MySQL or MariaDB engines. It
19460
+ # also doesn't apply to RDS Custom.
18492
19461
  #
18493
19462
  # </note>
18494
19463
  #
18495
19464
  # @option params [String] :engine
18496
19465
  # The database engine to use for the new instance.
18497
19466
  #
19467
+ # This setting doesn't apply to RDS Custom.
19468
+ #
18498
19469
  # Default: The same as source
18499
19470
  #
18500
19471
  # Constraint: Must be compatible with the engine of the source
@@ -18539,9 +19510,11 @@ module Aws::RDS
18539
19510
  #
18540
19511
  # Permanent options, such as the TDE option for Oracle Advanced Security
18541
19512
  # TDE, can't be removed from an option group, and that option group
18542
- # can't be removed from a DB instance once it is associated with a DB
19513
+ # can't be removed from a DB instance after it is associated with a DB
18543
19514
  # instance
18544
19515
  #
19516
+ # This setting doesn't apply to RDS Custom.
19517
+ #
18545
19518
  # @option params [Boolean] :copy_tags_to_snapshot
18546
19519
  # A value that indicates whether to copy all tags from the restored DB
18547
19520
  # instance to snapshots of the DB instance. By default, tags are not
@@ -18569,10 +19542,14 @@ module Aws::RDS
18569
19542
  # The ARN from the key store with which to associate the instance for
18570
19543
  # TDE encryption.
18571
19544
  #
19545
+ # This setting doesn't apply to RDS Custom.
19546
+ #
18572
19547
  # @option params [String] :tde_credential_password
18573
19548
  # The password for the given ARN from the key store in order to access
18574
19549
  # the device.
18575
19550
  #
19551
+ # This setting doesn't apply to RDS Custom.
19552
+ #
18576
19553
  # @option params [Array<String>] :vpc_security_group_ids
18577
19554
  # A list of EC2 VPC security groups to associate with this DB instance.
18578
19555
  #
@@ -18581,9 +19558,11 @@ module Aws::RDS
18581
19558
  #
18582
19559
  # @option params [String] :domain
18583
19560
  # Specify the Active Directory directory ID to restore the DB instance
18584
- # in. The domain must be created prior to this operation. Currently,
18585
- # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
18586
- # can be created in an Active Directory Domain.
19561
+ # in. Create the domain before running this command. Currently, you can
19562
+ # create only the MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
19563
+ # instances in an Active Directory Domain.
19564
+ #
19565
+ # This setting doesn't apply to RDS Custom.
18587
19566
  #
18588
19567
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
18589
19568
  # RDS User Guide*.
@@ -18596,11 +19575,15 @@ module Aws::RDS
18596
19575
  # Specify the name of the IAM role to be used when making API calls to
18597
19576
  # the Directory Service.
18598
19577
  #
19578
+ # This setting doesn't apply to RDS Custom.
19579
+ #
18599
19580
  # @option params [Boolean] :enable_iam_database_authentication
18600
19581
  # A value that indicates whether to enable mapping of Amazon Web
18601
19582
  # Services Identity and Access Management (IAM) accounts to database
18602
19583
  # accounts. By default, mapping is disabled.
18603
19584
  #
19585
+ # This setting doesn't apply to RDS Custom.
19586
+ #
18604
19587
  # For more information about IAM database authentication, see [ IAM
18605
19588
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
18606
19589
  # RDS User Guide.*
@@ -18615,6 +19598,8 @@ module Aws::RDS
18615
19598
  # used. For more information, see [Publishing Database Logs to Amazon
18616
19599
  # CloudWatch Logs][1] in the *Amazon RDS User Guide*.
18617
19600
  #
19601
+ # This setting doesn't apply to RDS Custom.
19602
+ #
18618
19603
  #
18619
19604
  #
18620
19605
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -18623,16 +19608,22 @@ module Aws::RDS
18623
19608
  # The number of CPU cores and the number of threads per core for the DB
18624
19609
  # instance class of the DB instance.
18625
19610
  #
19611
+ # This setting doesn't apply to RDS Custom.
19612
+ #
18626
19613
  # @option params [Boolean] :use_default_processor_features
18627
19614
  # A value that indicates whether the DB instance class of the DB
18628
19615
  # instance uses its default processor features.
18629
19616
  #
19617
+ # This setting doesn't apply to RDS Custom.
19618
+ #
18630
19619
  # @option params [String] :db_parameter_group_name
18631
19620
  # The name of the DB parameter group to associate with this DB instance.
18632
19621
  #
18633
19622
  # If you do not specify a value for `DBParameterGroupName`, then the
18634
19623
  # default `DBParameterGroup` for the specified DB engine is used.
18635
19624
  #
19625
+ # This setting doesn't apply to RDS Custom.
19626
+ #
18636
19627
  # Constraints:
18637
19628
  #
18638
19629
  # * If supplied, must match the name of an existing DBParameterGroup.
@@ -18664,6 +19655,8 @@ module Aws::RDS
18664
19655
  # apply to it, see [ Managing capacity automatically with Amazon RDS
18665
19656
  # storage autoscaling][1] in the *Amazon RDS User Guide*.
18666
19657
  #
19658
+ # This setting doesn't apply to RDS Custom.
19659
+ #
18667
19660
  #
18668
19661
  #
18669
19662
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -18673,6 +19666,8 @@ module Aws::RDS
18673
19666
  # from which to restore, for example,
18674
19667
  # `arn:aws:rds:useast-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
18675
19668
  #
19669
+ # This setting doesn't apply to RDS Custom.
19670
+ #
18676
19671
  # @option params [Boolean] :enable_customer_owned_ip
18677
19672
  # A value that indicates whether to enable a customer-owned IP address
18678
19673
  # (CoIP) for an RDS on Outposts DB instance.
@@ -18682,6 +19677,8 @@ module Aws::RDS
18682
19677
  # a CoIP can provide lower latency for connections to the DB instance
18683
19678
  # from outside of its virtual private cloud (VPC) on your local network.
18684
19679
  #
19680
+ # This setting doesn't apply to RDS Custom.
19681
+ #
18685
19682
  # For more information about RDS on Outposts, see [Working with Amazon
18686
19683
  # RDS on Amazon Web Services Outposts][1] in the *Amazon RDS User
18687
19684
  # Guide*.
@@ -18694,6 +19691,29 @@ module Aws::RDS
18694
19691
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
18695
19692
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
18696
19693
  #
19694
+ # @option params [String] :custom_iam_instance_profile
19695
+ # The instance profile associated with the underlying Amazon EC2
19696
+ # instance of an RDS Custom DB instance. The instance profile must meet
19697
+ # the following requirements:
19698
+ #
19699
+ # * The profile must exist in your account.
19700
+ #
19701
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
19702
+ # assume.
19703
+ #
19704
+ # * The instance profile name and the associated IAM role name must
19705
+ # start with the prefix `AWSRDSCustom`.
19706
+ #
19707
+ # For the list of permissions required for the IAM role, see [ Configure
19708
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
19709
+ # Guide*.
19710
+ #
19711
+ # This setting is required for RDS Custom.
19712
+ #
19713
+ #
19714
+ #
19715
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
19716
+ #
18697
19717
  # @return [Types::RestoreDBInstanceToPointInTimeResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
18698
19718
  #
18699
19719
  # * {Types::RestoreDBInstanceToPointInTimeResult#db_instance #db_instance} => Types::DBInstance
@@ -18841,6 +19861,7 @@ module Aws::RDS
18841
19861
  # max_allocated_storage: 1,
18842
19862
  # source_db_instance_automated_backups_arn: "String",
18843
19863
  # enable_customer_owned_ip: false,
19864
+ # custom_iam_instance_profile: "String",
18844
19865
  # })
18845
19866
  #
18846
19867
  # @example Response structure
@@ -18901,6 +19922,8 @@ module Aws::RDS
18901
19922
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
18902
19923
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
18903
19924
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
19925
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
19926
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
18904
19927
  # resp.db_instance.latest_restorable_time #=> Time
18905
19928
  # resp.db_instance.multi_az #=> Boolean
18906
19929
  # resp.db_instance.engine_version #=> String
@@ -18975,6 +19998,9 @@ module Aws::RDS
18975
19998
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
18976
19999
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
18977
20000
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
20001
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
20002
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
20003
+ # resp.db_instance.custom_iam_instance_profile #=> String
18978
20004
  #
18979
20005
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceToPointInTime AWS API Documentation
18980
20006
  #
@@ -19096,7 +20122,7 @@ module Aws::RDS
19096
20122
  # The Amazon Web Services KMS key identifier for encrypting messages in
19097
20123
  # the database activity stream. The Amazon Web Services KMS key
19098
20124
  # identifier is the key ARN, key ID, alias ARN, or alias name for the
19099
- # Amazon Web Services KMS customer master key (CMK).
20125
+ # KMS key.
19100
20126
  #
19101
20127
  # @option params [Boolean] :apply_immediately
19102
20128
  # Specifies whether or not the database activity stream is to start as
@@ -19239,6 +20265,7 @@ module Aws::RDS
19239
20265
  # resp.db_cluster.scaling_configuration_info.auto_pause #=> Boolean
19240
20266
  # resp.db_cluster.scaling_configuration_info.seconds_until_auto_pause #=> Integer
19241
20267
  # resp.db_cluster.scaling_configuration_info.timeout_action #=> String
20268
+ # resp.db_cluster.scaling_configuration_info.seconds_before_timeout #=> Integer
19242
20269
  # resp.db_cluster.deletion_protection #=> Boolean
19243
20270
  # resp.db_cluster.http_endpoint_enabled #=> Boolean
19244
20271
  # resp.db_cluster.activity_stream_mode #=> String, one of "sync", "async"
@@ -19282,8 +20309,8 @@ module Aws::RDS
19282
20309
  # For more information, see [ Starting an Amazon RDS DB instance That
19283
20310
  # Was Previously Stopped][1] in the *Amazon RDS User Guide.*
19284
20311
  #
19285
- # <note markdown="1"> This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For
19286
- # Aurora DB clusters, use `StartDBCluster` instead.
20312
+ # <note markdown="1"> This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora
20313
+ # PostgreSQL. For Aurora DB clusters, use `StartDBCluster` instead.
19287
20314
  #
19288
20315
  # </note>
19289
20316
  #
@@ -19362,6 +20389,8 @@ module Aws::RDS
19362
20389
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
19363
20390
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
19364
20391
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
20392
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
20393
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
19365
20394
  # resp.db_instance.latest_restorable_time #=> Time
19366
20395
  # resp.db_instance.multi_az #=> Boolean
19367
20396
  # resp.db_instance.engine_version #=> String
@@ -19436,6 +20465,9 @@ module Aws::RDS
19436
20465
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
19437
20466
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
19438
20467
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
20468
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
20469
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
20470
+ # resp.db_instance.custom_iam_instance_profile #=> String
19439
20471
  #
19440
20472
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StartDBInstance AWS API Documentation
19441
20473
  #
@@ -19449,6 +20481,8 @@ module Aws::RDS
19449
20481
  # Enables replication of automated backups to a different Amazon Web
19450
20482
  # Services Region.
19451
20483
  #
20484
+ # This command doesn't apply to RDS Custom.
20485
+ #
19452
20486
  # For more information, see [ Replicating Automated Backups to Another
19453
20487
  # Amazon Web Services Region][1] in the *Amazon RDS User Guide.*
19454
20488
  #
@@ -19541,6 +20575,8 @@ module Aws::RDS
19541
20575
  # Starts an export of a snapshot to Amazon S3. The provided IAM role
19542
20576
  # must have access to the S3 bucket.
19543
20577
  #
20578
+ # This command doesn't apply to RDS Custom.
20579
+ #
19544
20580
  # @option params [required, String] :export_task_identifier
19545
20581
  # A unique identifier for the snapshot export task. This ID isn't an
19546
20582
  # identifier for the Amazon S3 bucket where the snapshot is to be
@@ -19557,13 +20593,12 @@ module Aws::RDS
19557
20593
  # when exporting a snapshot.
19558
20594
  #
19559
20595
  # @option params [required, String] :kms_key_id
19560
- # The ID of the Amazon Web Services KMS customer master key (CMK) to use
19561
- # to encrypt the snapshot exported to Amazon S3. The Amazon Web Services
19562
- # KMS key identifier is the key ARN, key ID, alias ARN, or alias name
19563
- # for the Amazon Web Services KMS customer master key (CMK). The caller
19564
- # of this operation must be authorized to execute the following
19565
- # operations. These can be set in the Amazon Web Services KMS key
19566
- # policy:
20596
+ # The ID of the Amazon Web Services KMS key to use to encrypt the
20597
+ # snapshot exported to Amazon S3. The Amazon Web Services KMS key
20598
+ # identifier is the key ARN, key ID, alias ARN, or alias name for the
20599
+ # KMS key. The caller of this operation must be authorized to execute
20600
+ # the following operations. These can be set in the Amazon Web Services
20601
+ # KMS key policy:
19567
20602
  #
19568
20603
  # * GrantOperation.Encrypt
19569
20604
  #
@@ -19808,6 +20843,7 @@ module Aws::RDS
19808
20843
  # resp.db_cluster.scaling_configuration_info.auto_pause #=> Boolean
19809
20844
  # resp.db_cluster.scaling_configuration_info.seconds_until_auto_pause #=> Integer
19810
20845
  # resp.db_cluster.scaling_configuration_info.timeout_action #=> String
20846
+ # resp.db_cluster.scaling_configuration_info.seconds_before_timeout #=> Integer
19811
20847
  # resp.db_cluster.deletion_protection #=> Boolean
19812
20848
  # resp.db_cluster.http_endpoint_enabled #=> Boolean
19813
20849
  # resp.db_cluster.activity_stream_mode #=> String, one of "sync", "async"
@@ -19853,8 +20889,8 @@ module Aws::RDS
19853
20889
  # For more information, see [ Stopping an Amazon RDS DB Instance
19854
20890
  # Temporarily][1] in the *Amazon RDS User Guide.*
19855
20891
  #
19856
- # <note markdown="1"> This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For
19857
- # Aurora clusters, use `StopDBCluster` instead.
20892
+ # <note markdown="1"> This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora
20893
+ # PostgreSQL. For Aurora clusters, use `StopDBCluster` instead.
19858
20894
  #
19859
20895
  # </note>
19860
20896
  #
@@ -19938,6 +20974,8 @@ module Aws::RDS
19938
20974
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
19939
20975
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
19940
20976
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
20977
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
20978
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
19941
20979
  # resp.db_instance.latest_restorable_time #=> Time
19942
20980
  # resp.db_instance.multi_az #=> Boolean
19943
20981
  # resp.db_instance.engine_version #=> String
@@ -20012,6 +21050,9 @@ module Aws::RDS
20012
21050
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
20013
21051
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
20014
21052
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
21053
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
21054
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
21055
+ # resp.db_instance.custom_iam_instance_profile #=> String
20015
21056
  #
20016
21057
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StopDBInstance AWS API Documentation
20017
21058
  #
@@ -20024,6 +21065,8 @@ module Aws::RDS
20024
21065
 
20025
21066
  # Stops automated backup replication for a DB instance.
20026
21067
  #
21068
+ # This command doesn't apply to RDS Custom.
21069
+ #
20027
21070
  # For more information, see [ Replicating Automated Backups to Another
20028
21071
  # Amazon Web Services Region][1] in the *Amazon RDS User Guide.*
20029
21072
  #
@@ -20099,7 +21142,7 @@ module Aws::RDS
20099
21142
  params: params,
20100
21143
  config: config)
20101
21144
  context[:gem_name] = 'aws-sdk-rds'
20102
- context[:gem_version] = '1.126.0'
21145
+ context[:gem_version] = '1.130.0'
20103
21146
  Seahorse::Client::Request.new(handlers, context)
20104
21147
  end
20105
21148