aws-sdk-rds 1.128.0 → 1.129.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -352,7 +352,7 @@ module Aws::RDS
352
352
  #
353
353
  # @option params [String] :feature_name
354
354
  # 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
355
+ # associated with. For information about supported feature names, see
356
356
  # DBEngineVersion.
357
357
  #
358
358
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -382,6 +382,8 @@ module Aws::RDS
382
382
  #
383
383
  # </note>
384
384
  #
385
+ # This command doesn't apply to RDS Custom.
386
+ #
385
387
  # @option params [required, String] :db_instance_identifier
386
388
  # The name of the DB instance to associate the IAM role with.
387
389
  #
@@ -391,7 +393,7 @@ module Aws::RDS
391
393
  #
392
394
  # @option params [required, String] :feature_name
393
395
  # 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
396
+ # associated with. For information about supported feature names, see
395
397
  # DBEngineVersion.
396
398
  #
397
399
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -1027,11 +1029,11 @@ module Aws::RDS
1027
1029
  # values:
1028
1030
  #
1029
1031
  # * `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.
1032
+ # KMS key to use to encrypt the copy of the DB cluster snapshot in
1033
+ # the destination Amazon Web Services Region. This is the same
1034
+ # identifier for both the `CopyDBClusterSnapshot` action that is
1035
+ # called in the destination Amazon Web Services Region, and the
1036
+ # action contained in the pre-signed URL.
1035
1037
  #
1036
1038
  # * `DestinationRegion` - The name of the Amazon Web Services Region
1037
1039
  # that the DB cluster snapshot is to be created in.
@@ -1133,15 +1135,13 @@ module Aws::RDS
1133
1135
  # @option params [String] :kms_key_id
1134
1136
  # The Amazon Web Services KMS key identifier for an encrypted DB cluster
1135
1137
  # 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).
1138
+ # key ID, alias ARN, or alias name for the Amazon Web Services KMS key.
1138
1139
  #
1139
1140
  # If you copy an encrypted DB cluster snapshot from your Amazon Web
1140
1141
  # 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.
1142
+ # the copy with a new KMS key. If you don't specify a value for
1143
+ # `KmsKeyId`, then the copy of the DB cluster snapshot is encrypted with
1144
+ # the same KMS key as the source DB cluster snapshot.
1145
1145
  #
1146
1146
  # If you copy an encrypted DB cluster snapshot that is shared from
1147
1147
  # another Amazon Web Services account, then you must specify a value for
@@ -1150,10 +1150,10 @@ module Aws::RDS
1150
1150
  # To copy an encrypted DB cluster snapshot to another Amazon Web
1151
1151
  # Services Region, you must set `KmsKeyId` to the Amazon Web Services
1152
1152
  # 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.
1153
+ # cluster snapshot in the destination Amazon Web Services Region. KMS
1154
+ # keys are specific to the Amazon Web Services Region that they are
1155
+ # created in, and you can't use KMS keys from one Amazon Web Services
1156
+ # Region in another Amazon Web Services Region.
1157
1157
  #
1158
1158
  # If you copy an unencrypted DB cluster snapshot and specify a value for
1159
1159
  # the `KmsKeyId` parameter, an error is returned.
@@ -1173,12 +1173,12 @@ module Aws::RDS
1173
1173
  # snapshot to be copied. The pre-signed URL request must contain the
1174
1174
  # following parameter values:
1175
1175
  #
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.
1176
+ # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
1177
+ # key to use to encrypt the copy of the DB cluster snapshot in the
1178
+ # destination Amazon Web Services Region. This is the same identifier
1179
+ # for both the `CopyDBClusterSnapshot` action that is called in the
1180
+ # destination Amazon Web Services Region, and the action contained in
1181
+ # the pre-signed URL.
1182
1182
  #
1183
1183
  # * `DestinationRegion` - The name of the Amazon Web Services Region
1184
1184
  # that the DB cluster snapshot is to be created in.
@@ -1404,6 +1404,8 @@ module Aws::RDS
1404
1404
  # the `CopyDBSnapshot` action is the destination Amazon Web Services
1405
1405
  # Region for the DB snapshot copy.
1406
1406
  #
1407
+ # This command doesn't apply to RDS Custom.
1408
+ #
1407
1409
  # For more information about copying snapshots, see [Copying a DB
1408
1410
  # Snapshot][1] in the *Amazon RDS User Guide.*
1409
1411
  #
@@ -1459,15 +1461,13 @@ module Aws::RDS
1459
1461
  # @option params [String] :kms_key_id
1460
1462
  # The Amazon Web Services KMS key identifier for an encrypted DB
1461
1463
  # 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).
1464
+ # key ID, alias ARN, or alias name for the KMS key.
1464
1465
  #
1465
1466
  # If you copy an encrypted DB snapshot from your Amazon Web Services
1466
1467
  # 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.
1468
+ # copy with a new KMS key. If you don't specify a value for this
1469
+ # parameter, then the copy of the DB snapshot is encrypted with the same
1470
+ # Amazon Web Services KMS key as the source DB snapshot.
1471
1471
  #
1472
1472
  # If you copy an encrypted DB snapshot that is shared from another
1473
1473
  # Amazon Web Services account, then you must specify a value for this
@@ -1477,11 +1477,11 @@ module Aws::RDS
1477
1477
  # the copy is encrypted.
1478
1478
  #
1479
1479
  # 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.
1480
+ # Region, then you must specify an Amazon Web Services KMS key
1481
+ # identifier for the destination Amazon Web Services Region. KMS keys
1482
+ # are specific to the Amazon Web Services Region that they are created
1483
+ # in, and you can't use KMS keys from one Amazon Web Services Region in
1484
+ # another Amazon Web Services Region.
1485
1485
  #
1486
1486
  # @option params [Array<Types::Tag>] :tags
1487
1487
  # A list of tags. For more information, see [Tagging Amazon RDS
@@ -1524,12 +1524,11 @@ module Aws::RDS
1524
1524
  # presigned URL must be set to the us-east-1 Amazon Web Services
1525
1525
  # Region.
1526
1526
  #
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.
1527
+ # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
1528
+ # key to use to encrypt the copy of the DB snapshot in the destination
1529
+ # Amazon Web Services Region. This is the same identifier for both the
1530
+ # `CopyDBSnapshot` action that is called in the destination Amazon Web
1531
+ # Services Region, and the action contained in the presigned URL.
1533
1532
  #
1534
1533
  # * `SourceDBSnapshotIdentifier` - The DB snapshot identifier for the
1535
1534
  # encrypted snapshot to be copied. This identifier must be in the
@@ -1847,6 +1846,242 @@ module Aws::RDS
1847
1846
  req.send_request(options)
1848
1847
  end
1849
1848
 
1849
+ # Creates a custom DB engine version (CEV). A CEV is a binary volume
1850
+ # snapshot of a database engine and specific AMI. The only supported
1851
+ # engine is Oracle Database 19c Enterprise Edition with the January 2021
1852
+ # or later RU/RUR. For more information, see [ Amazon RDS Custom
1853
+ # requirements and limitations][1] in the *Amazon RDS User Guide*.
1854
+ #
1855
+ # Amazon RDS, which is a fully managed service, supplies the Amazon
1856
+ # Machine Image (AMI) and database software. The Amazon RDS database
1857
+ # software is preinstalled, so you need only select a DB engine and
1858
+ # version, and create your database. With Amazon RDS Custom, you upload
1859
+ # your database installation files in Amazon S3. For more information,
1860
+ # see [ Preparing to create a CEV][2] in the *Amazon RDS User Guide*.
1861
+ #
1862
+ # When you create a custom engine version, you specify the files in a
1863
+ # JSON document called a CEV manifest. This document describes
1864
+ # installation .zip files stored in Amazon S3. RDS Custom creates your
1865
+ # CEV from the installation files that you provided. This service model
1866
+ # is called Bring Your Own Media (BYOM).
1867
+ #
1868
+ # Creation takes approximately two hours. If creation fails, RDS Custom
1869
+ # issues `RDS-EVENT-0196` with the message `Creation failed for custom
1870
+ # engine version`, and includes details about the failure. For example,
1871
+ # the event prints missing files.
1872
+ #
1873
+ # After you create the CEV, it is available for use. You can create
1874
+ # multiple CEVs, and create multiple RDS Custom instances from any CEV.
1875
+ # You can also change the status of a CEV to make it available or
1876
+ # inactive.
1877
+ #
1878
+ # <note markdown="1"> The MediaImport service that imports files from Amazon S3 to create
1879
+ # CEVs isn't integrated with Amazon Web Services CloudTrail. If you
1880
+ # turn on data logging for Amazon RDS in CloudTrail, calls to the
1881
+ # `CreateCustomDbEngineVersion` event aren't logged. However, you might
1882
+ # see calls from the API gateway that accesses your Amazon S3 bucket.
1883
+ # These calls originate from the MediaImport service for the
1884
+ # `CreateCustomDbEngineVersion` event.
1885
+ #
1886
+ # </note>
1887
+ #
1888
+ # For more information, see [ Creating a CEV][3] in the *Amazon RDS User
1889
+ # Guide*.
1890
+ #
1891
+ #
1892
+ #
1893
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.preparing.manifest
1894
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.html#custom-cev.preparing
1895
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.create
1896
+ #
1897
+ # @option params [required, String] :engine
1898
+ # The database engine to use for your custom engine version (CEV). The
1899
+ # only supported value is `custom-oracle-ee`.
1900
+ #
1901
+ # @option params [required, String] :engine_version
1902
+ # The name of your CEV. The name format is `19.customized_string `. For
1903
+ # example, a valid name is `19.my_cev1`. This setting is required for
1904
+ # RDS Custom, but optional for Amazon RDS. The combination of `Engine`
1905
+ # and `EngineVersion` is unique per customer per Region.
1906
+ #
1907
+ # @option params [required, String] :database_installation_files_s3_bucket_name
1908
+ # The name of an Amazon S3 bucket that contains database installation
1909
+ # files for your CEV. For example, a valid bucket name is
1910
+ # `my-custom-installation-files`.
1911
+ #
1912
+ # @option params [String] :database_installation_files_s3_prefix
1913
+ # The Amazon S3 directory that contains the database installation files
1914
+ # for your CEV. For example, a valid bucket name is `123456789012/cev1`.
1915
+ # If this setting isn't specified, no prefix is assumed.
1916
+ #
1917
+ # @option params [required, String] :kms_key_id
1918
+ # The Amazon Web Services KMS key identifier for an encrypted CEV. A
1919
+ # symmetric KMS key is required for RDS Custom, but optional for Amazon
1920
+ # RDS.
1921
+ #
1922
+ # If you have an existing symmetric KMS key in your account, you can use
1923
+ # it with RDS Custom. No further action is necessary. If you don't
1924
+ # already have a symmetric KMS key in your account, follow the
1925
+ # instructions in [ Creating symmetric KMS keys][1] in the *Amazon Web
1926
+ # Services Key Management Service Developer Guide*.
1927
+ #
1928
+ # You can choose the same symmetric key when you create a CEV and a DB
1929
+ # instance, or choose different keys.
1930
+ #
1931
+ #
1932
+ #
1933
+ # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html#create-symmetric-cmk
1934
+ #
1935
+ # @option params [String] :description
1936
+ # An optional description of your CEV.
1937
+ #
1938
+ # @option params [required, String] :manifest
1939
+ # The CEV manifest, which is a JSON document that describes the
1940
+ # installation .zip files stored in Amazon S3. Specify the name/value
1941
+ # pairs in a file or a quoted string. RDS Custom applies the patches in
1942
+ # the order in which they are listed.
1943
+ #
1944
+ # The following JSON fields are valid:
1945
+ #
1946
+ # MediaImportTemplateVersion
1947
+ #
1948
+ # : Version of the CEV manifest. The date is in the format `YYYY-MM-DD`.
1949
+ #
1950
+ # databaseInstallationFileNames
1951
+ #
1952
+ # : Ordered list of installation files for the CEV.
1953
+ #
1954
+ # opatchFileNames
1955
+ #
1956
+ # : Ordered list of OPatch installers used for the Oracle DB engine.
1957
+ #
1958
+ # psuRuPatchFileNames
1959
+ #
1960
+ # : The PSU and RU patches for this CEV.
1961
+ #
1962
+ # OtherPatchFileNames
1963
+ #
1964
+ # : The patches that are not in the list of PSU and RU patches. Amazon
1965
+ # RDS applies these patches after applying the PSU and RU patches.
1966
+ #
1967
+ # For more information, see [ Creating the CEV manifest][1] in the
1968
+ # *Amazon RDS User Guide*.
1969
+ #
1970
+ #
1971
+ #
1972
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.preparing.manifest
1973
+ #
1974
+ # @option params [Array<Types::Tag>] :tags
1975
+ # A list of tags. For more information, see [Tagging Amazon RDS
1976
+ # Resources][1] in the *Amazon RDS User Guide.*
1977
+ #
1978
+ #
1979
+ #
1980
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html
1981
+ #
1982
+ # @return [Types::DBEngineVersion] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1983
+ #
1984
+ # * {Types::DBEngineVersion#engine #engine} => String
1985
+ # * {Types::DBEngineVersion#engine_version #engine_version} => String
1986
+ # * {Types::DBEngineVersion#db_parameter_group_family #db_parameter_group_family} => String
1987
+ # * {Types::DBEngineVersion#db_engine_description #db_engine_description} => String
1988
+ # * {Types::DBEngineVersion#db_engine_version_description #db_engine_version_description} => String
1989
+ # * {Types::DBEngineVersion#default_character_set #default_character_set} => Types::CharacterSet
1990
+ # * {Types::DBEngineVersion#supported_character_sets #supported_character_sets} => Array&lt;Types::CharacterSet&gt;
1991
+ # * {Types::DBEngineVersion#supported_nchar_character_sets #supported_nchar_character_sets} => Array&lt;Types::CharacterSet&gt;
1992
+ # * {Types::DBEngineVersion#valid_upgrade_target #valid_upgrade_target} => Array&lt;Types::UpgradeTarget&gt;
1993
+ # * {Types::DBEngineVersion#supported_timezones #supported_timezones} => Array&lt;Types::Timezone&gt;
1994
+ # * {Types::DBEngineVersion#exportable_log_types #exportable_log_types} => Array&lt;String&gt;
1995
+ # * {Types::DBEngineVersion#supports_log_exports_to_cloudwatch_logs #supports_log_exports_to_cloudwatch_logs} => Boolean
1996
+ # * {Types::DBEngineVersion#supports_read_replica #supports_read_replica} => Boolean
1997
+ # * {Types::DBEngineVersion#supported_engine_modes #supported_engine_modes} => Array&lt;String&gt;
1998
+ # * {Types::DBEngineVersion#supported_feature_names #supported_feature_names} => Array&lt;String&gt;
1999
+ # * {Types::DBEngineVersion#status #status} => String
2000
+ # * {Types::DBEngineVersion#supports_parallel_query #supports_parallel_query} => Boolean
2001
+ # * {Types::DBEngineVersion#supports_global_databases #supports_global_databases} => Boolean
2002
+ # * {Types::DBEngineVersion#major_engine_version #major_engine_version} => String
2003
+ # * {Types::DBEngineVersion#database_installation_files_s3_bucket_name #database_installation_files_s3_bucket_name} => String
2004
+ # * {Types::DBEngineVersion#database_installation_files_s3_prefix #database_installation_files_s3_prefix} => String
2005
+ # * {Types::DBEngineVersion#db_engine_version_arn #db_engine_version_arn} => String
2006
+ # * {Types::DBEngineVersion#kms_key_id #kms_key_id} => String
2007
+ # * {Types::DBEngineVersion#create_time #create_time} => Time
2008
+ # * {Types::DBEngineVersion#tag_list #tag_list} => Array&lt;Types::Tag&gt;
2009
+ #
2010
+ # @example Request syntax with placeholder values
2011
+ #
2012
+ # resp = client.create_custom_db_engine_version({
2013
+ # engine: "CustomEngineName", # required
2014
+ # engine_version: "CustomEngineVersion", # required
2015
+ # database_installation_files_s3_bucket_name: "BucketName", # required
2016
+ # database_installation_files_s3_prefix: "String255",
2017
+ # kms_key_id: "KmsKeyIdOrArn", # required
2018
+ # description: "Description",
2019
+ # manifest: "CustomDBEngineVersionManifest", # required
2020
+ # tags: [
2021
+ # {
2022
+ # key: "String",
2023
+ # value: "String",
2024
+ # },
2025
+ # ],
2026
+ # })
2027
+ #
2028
+ # @example Response structure
2029
+ #
2030
+ # resp.engine #=> String
2031
+ # resp.engine_version #=> String
2032
+ # resp.db_parameter_group_family #=> String
2033
+ # resp.db_engine_description #=> String
2034
+ # resp.db_engine_version_description #=> String
2035
+ # resp.default_character_set.character_set_name #=> String
2036
+ # resp.default_character_set.character_set_description #=> String
2037
+ # resp.supported_character_sets #=> Array
2038
+ # resp.supported_character_sets[0].character_set_name #=> String
2039
+ # resp.supported_character_sets[0].character_set_description #=> String
2040
+ # resp.supported_nchar_character_sets #=> Array
2041
+ # resp.supported_nchar_character_sets[0].character_set_name #=> String
2042
+ # resp.supported_nchar_character_sets[0].character_set_description #=> String
2043
+ # resp.valid_upgrade_target #=> Array
2044
+ # resp.valid_upgrade_target[0].engine #=> String
2045
+ # resp.valid_upgrade_target[0].engine_version #=> String
2046
+ # resp.valid_upgrade_target[0].description #=> String
2047
+ # resp.valid_upgrade_target[0].auto_upgrade #=> Boolean
2048
+ # resp.valid_upgrade_target[0].is_major_version_upgrade #=> Boolean
2049
+ # resp.valid_upgrade_target[0].supported_engine_modes #=> Array
2050
+ # resp.valid_upgrade_target[0].supported_engine_modes[0] #=> String
2051
+ # resp.valid_upgrade_target[0].supports_parallel_query #=> Boolean
2052
+ # resp.valid_upgrade_target[0].supports_global_databases #=> Boolean
2053
+ # resp.supported_timezones #=> Array
2054
+ # resp.supported_timezones[0].timezone_name #=> String
2055
+ # resp.exportable_log_types #=> Array
2056
+ # resp.exportable_log_types[0] #=> String
2057
+ # resp.supports_log_exports_to_cloudwatch_logs #=> Boolean
2058
+ # resp.supports_read_replica #=> Boolean
2059
+ # resp.supported_engine_modes #=> Array
2060
+ # resp.supported_engine_modes[0] #=> String
2061
+ # resp.supported_feature_names #=> Array
2062
+ # resp.supported_feature_names[0] #=> String
2063
+ # resp.status #=> String
2064
+ # resp.supports_parallel_query #=> Boolean
2065
+ # resp.supports_global_databases #=> Boolean
2066
+ # resp.major_engine_version #=> String
2067
+ # resp.database_installation_files_s3_bucket_name #=> String
2068
+ # resp.database_installation_files_s3_prefix #=> String
2069
+ # resp.db_engine_version_arn #=> String
2070
+ # resp.kms_key_id #=> String
2071
+ # resp.create_time #=> Time
2072
+ # resp.tag_list #=> Array
2073
+ # resp.tag_list[0].key #=> String
2074
+ # resp.tag_list[0].value #=> String
2075
+ #
2076
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateCustomDBEngineVersion AWS API Documentation
2077
+ #
2078
+ # @overload create_custom_db_engine_version(params = {})
2079
+ # @param [Hash] params ({})
2080
+ def create_custom_db_engine_version(params = {}, options = {})
2081
+ req = build_request(:create_custom_db_engine_version, params)
2082
+ req.send_request(options)
2083
+ end
2084
+
1850
2085
  # Creates a new Amazon Aurora DB cluster.
1851
2086
  #
1852
2087
  # You can use the `ReplicationSourceIdentifier` parameter to create the
@@ -2061,29 +2296,29 @@ module Aws::RDS
2061
2296
  # cluster.
2062
2297
  #
2063
2298
  # 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.
2299
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
2300
+ # different Amazon Web Services account, specify the key ARN or alias
2301
+ # ARN.
2067
2302
  #
2068
- # When a CMK isn't specified in `KmsKeyId`\:
2303
+ # When a KMS key isn't specified in `KmsKeyId`\:
2069
2304
  #
2070
2305
  # * 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.
2306
+ # then Amazon RDS will use the KMS key used to encrypt the source.
2307
+ # Otherwise, Amazon RDS will use your default KMS key.
2073
2308
  #
2074
2309
  # * If the `StorageEncrypted` parameter is enabled and
2075
2310
  # `ReplicationSourceIdentifier` isn't specified, then Amazon RDS will
2076
- # use your default CMK.
2311
+ # use your default KMS key.
2077
2312
  #
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
2313
+ # There is a default KMS key for your Amazon Web Services account. Your
2314
+ # Amazon Web Services account has a different default KMS key for each
2080
2315
  # Amazon Web Services Region.
2081
2316
  #
2082
2317
  # 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.
2318
+ # Amazon Web Services Region, you must set `KmsKeyId` to a KMS key
2319
+ # identifier that is valid in the destination Amazon Web Services
2320
+ # Region. This KMS key is used to encrypt the read replica in that
2321
+ # Amazon Web Services Region.
2087
2322
  #
2088
2323
  # @option params [String] :pre_signed_url
2089
2324
  # A URL that contains a Signature Version 4 signed request for the
@@ -2099,12 +2334,12 @@ module Aws::RDS
2099
2334
  # The pre-signed URL request must contain the following parameter
2100
2335
  # values:
2101
2336
  #
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.
2337
+ # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
2338
+ # key to use to encrypt the copy of the DB cluster in the destination
2339
+ # Amazon Web Services Region. This should refer to the same KMS key
2340
+ # for both the `CreateDBCluster` action that is called in the
2341
+ # destination Amazon Web Services Region, and the action contained in
2342
+ # the pre-signed URL.
2108
2343
  #
2109
2344
  # * `DestinationRegion` - The name of the Amazon Web Services Region
2110
2345
  # that Aurora read replica will be created in.
@@ -2883,6 +3118,21 @@ module Aws::RDS
2883
3118
  #
2884
3119
  # ^
2885
3120
  #
3121
+ # **Amazon RDS Custom**
3122
+ #
3123
+ # The Oracle System ID (SID) of the created RDS Custom DB instance. If
3124
+ # you don't specify a value, the default value is `ORCL`.
3125
+ #
3126
+ # Default: `ORCL`
3127
+ #
3128
+ # Constraints:
3129
+ #
3130
+ # * It must contain 1 to 8 alphanumeric characters.
3131
+ #
3132
+ # * It must contain a letter.
3133
+ #
3134
+ # * It can't be a word reserved by the database engine.
3135
+ #
2886
3136
  # **SQL Server**
2887
3137
  #
2888
3138
  # Not applicable. Must be null.
@@ -2942,6 +3192,16 @@ module Aws::RDS
2942
3192
  # amount of data in your database increases, though you are only charged
2943
3193
  # for the space that you use in an Aurora cluster volume.
2944
3194
  #
3195
+ # **Amazon RDS Custom**
3196
+ #
3197
+ # Constraints to the amount of storage for each storage type are the
3198
+ # following:
3199
+ #
3200
+ # * General Purpose (SSD) storage (gp2): Must be an integer from 40 to
3201
+ # 65536.
3202
+ #
3203
+ # * Provisioned IOPS storage (io1): Must be an integer from 40 to 65536.
3204
+ #
2945
3205
  # **MySQL**
2946
3206
  #
2947
3207
  # Constraints to the amount of storage for each storage type are the
@@ -3045,6 +3305,8 @@ module Aws::RDS
3045
3305
  #
3046
3306
  # * `aurora-postgresql`
3047
3307
  #
3308
+ # * `custom-oracle-ee (for RDS Custom instances)`
3309
+ #
3048
3310
  # * `mariadb`
3049
3311
  #
3050
3312
  # * `mysql`
@@ -3237,6 +3499,8 @@ module Aws::RDS
3237
3499
  # If you do not specify a value, then the default DB parameter group for
3238
3500
  # the specified DB engine and version is used.
3239
3501
  #
3502
+ # This setting doesn't apply to RDS Custom.
3503
+ #
3240
3504
  # Constraints:
3241
3505
  #
3242
3506
  # * Must be 1 to 255 letters, numbers, or hyphens.
@@ -3263,6 +3527,8 @@ module Aws::RDS
3263
3527
  #
3264
3528
  # * Can't be set to 0 if the DB instance is a source to read replicas
3265
3529
  #
3530
+ # * Can't be set to 0 or 35 for an RDS Custom DB instance
3531
+ #
3266
3532
  # @option params [String] :preferred_backup_window
3267
3533
  # The daily time range during which automated backups are created if
3268
3534
  # automated backups are enabled, using the `BackupRetentionPeriod`
@@ -3342,6 +3608,8 @@ module Aws::RDS
3342
3608
  # deployment. You can't set the `AvailabilityZone` parameter if the DB
3343
3609
  # instance is a Multi-AZ deployment.
3344
3610
  #
3611
+ # This setting doesn't apply to RDS Custom.
3612
+ #
3345
3613
  # @option params [String] :engine_version
3346
3614
  # The version number of the database engine to use.
3347
3615
  #
@@ -3358,49 +3626,63 @@ module Aws::RDS
3358
3626
  # Not applicable. The version number of the database engine to be used
3359
3627
  # by the DB instance is managed by the DB cluster.
3360
3628
  #
3629
+ # **Amazon RDS Custom**
3630
+ #
3631
+ # A custom engine version (CEV) that you have previously created. This
3632
+ # setting is required for RDS Custom. The CEV name has the following
3633
+ # format: `19.customized_string `. An example identifier is
3634
+ # `19.my_cev1`. For more information, see [ Creating an RDS Custom DB
3635
+ # instance][1] in the *Amazon RDS User Guide.*.
3636
+ #
3361
3637
  # **MariaDB**
3362
3638
  #
3363
- # See [MariaDB on Amazon RDS Versions][1] in the *Amazon RDS User
3639
+ # See [MariaDB on Amazon RDS Versions][2] in the *Amazon RDS User
3364
3640
  # Guide.*
3365
3641
  #
3366
3642
  # **Microsoft SQL Server**
3367
3643
  #
3368
- # See [Microsoft SQL Server Versions on Amazon RDS][2] in the *Amazon
3644
+ # See [Microsoft SQL Server Versions on Amazon RDS][3] in the *Amazon
3369
3645
  # RDS User Guide.*
3370
3646
  #
3371
3647
  # **MySQL**
3372
3648
  #
3373
- # See [MySQL on Amazon RDS Versions][3] in the *Amazon RDS User Guide.*
3649
+ # See [MySQL on Amazon RDS Versions][4] in the *Amazon RDS User Guide.*
3374
3650
  #
3375
3651
  # **Oracle**
3376
3652
  #
3377
- # See [Oracle Database Engine Release Notes][4] in the *Amazon RDS User
3653
+ # See [Oracle Database Engine Release Notes][5] in the *Amazon RDS User
3378
3654
  # Guide.*
3379
3655
  #
3380
3656
  # **PostgreSQL**
3381
3657
  #
3382
- # See [Amazon RDS for PostgreSQL versions and extensions][5] in the
3658
+ # See [Amazon RDS for PostgreSQL versions and extensions][6] in the
3383
3659
  # *Amazon RDS User Guide.*
3384
3660
  #
3385
3661
  #
3386
3662
  #
3387
- # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
3388
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
3389
- # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
3390
- # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
3391
- # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
3663
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-creating.html#custom-creating.create
3664
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
3665
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
3666
+ # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
3667
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
3668
+ # [6]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
3392
3669
  #
3393
3670
  # @option params [Boolean] :auto_minor_version_upgrade
3394
3671
  # A value that indicates whether minor engine upgrades are applied
3395
3672
  # automatically to the DB instance during the maintenance window. By
3396
3673
  # default, minor engine upgrades are applied automatically.
3397
3674
  #
3675
+ # If you create an RDS Custom DB instance, you must set
3676
+ # `AutoMinorVersionUpgrade` to `false`.
3677
+ #
3398
3678
  # @option params [String] :license_model
3399
3679
  # License model information for this DB instance.
3400
3680
  #
3401
3681
  # Valid values: `license-included` \| `bring-your-own-license` \|
3402
3682
  # `general-public-license`
3403
3683
  #
3684
+ # This setting doesn't apply to RDS Custom.
3685
+ #
3404
3686
  # @option params [Integer] :iops
3405
3687
  # The amount of Provisioned IOPS (input/output operations per second) to
3406
3688
  # be initially allocated for the DB instance. For information about
@@ -3422,12 +3704,17 @@ module Aws::RDS
3422
3704
  #
3423
3705
  # Permanent options, such as the TDE option for Oracle Advanced Security
3424
3706
  # TDE, can't be removed from an option group. Also, that option group
3425
- # can't be removed from a DB instance once it is associated with a DB
3426
- # instance
3707
+ # can't be removed from a DB instance after it is associated with a DB
3708
+ # instance.
3709
+ #
3710
+ # This setting doesn't apply to RDS Custom.
3427
3711
  #
3428
3712
  # @option params [String] :character_set_name
3429
- # For supported engines, indicates that the DB instance should be
3430
- # associated with the specified CharacterSet.
3713
+ # For supported engines, this value indicates that the DB instance
3714
+ # should be associated with the specified `CharacterSet`.
3715
+ #
3716
+ # This setting doesn't apply to RDS Custom. However, if you need to
3717
+ # change the character set, you can change it on the database itself.
3431
3718
  #
3432
3719
  # **Amazon Aurora**
3433
3720
  #
@@ -3437,6 +3724,8 @@ module Aws::RDS
3437
3724
  # @option params [String] :nchar_character_set_name
3438
3725
  # The name of the NCHAR character set for the Oracle DB instance.
3439
3726
  #
3727
+ # This parameter doesn't apply to RDS Custom.
3728
+ #
3440
3729
  # @option params [Boolean] :publicly_accessible
3441
3730
  # A value that indicates whether the DB instance is publicly accessible.
3442
3731
  #
@@ -3477,6 +3766,8 @@ module Aws::RDS
3477
3766
  # @option params [String] :db_cluster_identifier
3478
3767
  # The identifier of the DB cluster that the instance will belong to.
3479
3768
  #
3769
+ # This setting doesn't apply to RDS Custom.
3770
+ #
3480
3771
  # @option params [String] :storage_type
3481
3772
  # Specifies the storage type to be associated with the DB instance.
3482
3773
  #
@@ -3491,14 +3782,22 @@ module Aws::RDS
3491
3782
  # The ARN from the key store with which to associate the instance for
3492
3783
  # TDE encryption.
3493
3784
  #
3785
+ # This setting doesn't apply to RDS Custom.
3786
+ #
3494
3787
  # @option params [String] :tde_credential_password
3495
3788
  # The password for the given ARN from the key store in order to access
3496
3789
  # the device.
3497
3790
  #
3791
+ # This setting doesn't apply to RDS Custom.
3792
+ #
3498
3793
  # @option params [Boolean] :storage_encrypted
3499
3794
  # A value that indicates whether the DB instance is encrypted. By
3500
3795
  # default, it isn't encrypted.
3501
3796
  #
3797
+ # For RDS Custom Oracle instances, either set this parameter to `true`
3798
+ # or leave it unset. If you set this parameter to `false`, RDS reports
3799
+ # an error.
3800
+ #
3502
3801
  # **Amazon Aurora**
3503
3802
  #
3504
3803
  # Not applicable. The encryption for DB instances is managed by the DB
@@ -3509,9 +3808,9 @@ module Aws::RDS
3509
3808
  # instance.
3510
3809
  #
3511
3810
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
3512
- # alias ARN, or alias name for the Amazon Web Services KMS customer
3513
- # master key (CMK). To use a CMK in a different Amazon Web Services
3514
- # account, specify the key ARN or alias ARN.
3811
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
3812
+ # different Amazon Web Services account, specify the key ARN or alias
3813
+ # ARN.
3515
3814
  #
3516
3815
  # **Amazon Aurora**
3517
3816
  #
@@ -3519,10 +3818,18 @@ module Aws::RDS
3519
3818
  # by the DB cluster. For more information, see `CreateDBCluster`.
3520
3819
  #
3521
3820
  # If `StorageEncrypted` is enabled, and you do not specify a value for
3522
- # the `KmsKeyId` parameter, then Amazon RDS uses your default CMK. There
3523
- # is a default CMK for your Amazon Web Services account. Your Amazon Web
3524
- # Services account has a different default CMK for each Amazon Web
3525
- # Services Region.
3821
+ # the `KmsKeyId` parameter, then Amazon RDS uses your default KMS key.
3822
+ # There is a default KMS key for your Amazon Web Services account. Your
3823
+ # Amazon Web Services account has a different default KMS key for each
3824
+ # Amazon Web Services Region.
3825
+ #
3826
+ # **Amazon RDS Custom**
3827
+ #
3828
+ # A KMS key is required for RDS Custom Oracle instances. For most RDS
3829
+ # engines, if you leave this parameter empty while enabling
3830
+ # `StorageEncrypted`, the engine uses the default KMS key. However, RDS
3831
+ # Custom for Oracle doesn't use the default key when this parameter is
3832
+ # empty. You must explicitly specify a key.
3526
3833
  #
3527
3834
  # @option params [String] :domain
3528
3835
  # The Active Directory directory ID to create the DB instance in.
@@ -3532,6 +3839,8 @@ module Aws::RDS
3532
3839
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
3533
3840
  # RDS User Guide*.
3534
3841
  #
3842
+ # This setting doesn't apply to RDS Custom.
3843
+ #
3535
3844
  #
3536
3845
  #
3537
3846
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -3548,24 +3857,28 @@ module Aws::RDS
3548
3857
  #
3549
3858
  # @option params [Integer] :monitoring_interval
3550
3859
  # The interval, in seconds, between points when Enhanced Monitoring
3551
- # metrics are collected for the DB instance. To disable collecting
3860
+ # metrics are collected for the DB instance. To disable collection of
3552
3861
  # Enhanced Monitoring metrics, specify 0. The default is 0.
3553
3862
  #
3554
- # If `MonitoringRoleArn` is specified, then you must also set
3863
+ # If `MonitoringRoleArn` is specified, then you must set
3555
3864
  # `MonitoringInterval` to a value other than 0.
3556
3865
  #
3866
+ # This setting doesn't apply to RDS Custom.
3867
+ #
3557
3868
  # Valid Values: `0, 1, 5, 10, 15, 30, 60`
3558
3869
  #
3559
3870
  # @option params [String] :monitoring_role_arn
3560
3871
  # The ARN for the IAM role that permits RDS to send enhanced monitoring
3561
3872
  # metrics to Amazon CloudWatch Logs. For example,
3562
3873
  # `arn:aws:iam:123456789012:role/emaccess`. For information on creating
3563
- # a monitoring role, go to [Setting Up and Enabling Enhanced
3874
+ # a monitoring role, see [Setting Up and Enabling Enhanced
3564
3875
  # Monitoring][1] in the *Amazon RDS User Guide*.
3565
3876
  #
3566
3877
  # If `MonitoringInterval` is set to a value other than 0, then you must
3567
3878
  # supply a `MonitoringRoleArn` value.
3568
3879
  #
3880
+ # This setting doesn't apply to RDS Custom.
3881
+ #
3569
3882
  #
3570
3883
  #
3571
3884
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
@@ -3574,12 +3887,16 @@ module Aws::RDS
3574
3887
  # Specify the name of the IAM role to be used when making API calls to
3575
3888
  # the Directory Service.
3576
3889
  #
3890
+ # This setting doesn't apply to RDS Custom.
3891
+ #
3577
3892
  # @option params [Integer] :promotion_tier
3578
3893
  # A value that specifies the order in which an Aurora Replica is
3579
3894
  # promoted to the primary instance after a failure of the existing
3580
3895
  # primary instance. For more information, see [ Fault Tolerance for an
3581
3896
  # Aurora DB Cluster][1] in the *Amazon Aurora User Guide*.
3582
3897
  #
3898
+ # This setting doesn't apply to RDS Custom.
3899
+ #
3583
3900
  # Default: 1
3584
3901
  #
3585
3902
  # Valid Values: 0 - 15
@@ -3601,9 +3918,9 @@ module Aws::RDS
3601
3918
  # Services Identity and Access Management (IAM) accounts to database
3602
3919
  # accounts. By default, mapping is disabled.
3603
3920
  #
3604
- # This setting doesn't apply to Amazon Aurora. Mapping Amazon Web
3605
- # Services IAM accounts to database accounts is managed by the DB
3606
- # cluster.
3921
+ # This setting doesn't apply to RDS Custom or Amazon Aurora. In Aurora,
3922
+ # mapping Amazon Web Services IAM accounts to database accounts is
3923
+ # managed by the DB cluster.
3607
3924
  #
3608
3925
  # For more information, see [ IAM Database Authentication for MySQL and
3609
3926
  # PostgreSQL][1] in the *Amazon RDS User Guide.*
@@ -3614,10 +3931,10 @@ module Aws::RDS
3614
3931
  #
3615
3932
  # @option params [Boolean] :enable_performance_insights
3616
3933
  # A value that indicates whether to enable Performance Insights for the
3617
- # DB instance.
3934
+ # DB instance. For more information, see [Using Amazon Performance
3935
+ # Insights][1] in the *Amazon Relational Database Service User Guide*.
3618
3936
  #
3619
- # For more information, see [Using Amazon Performance Insights][1] in
3620
- # the *Amazon Relational Database Service User Guide*.
3937
+ # This setting doesn't apply to RDS Custom.
3621
3938
  #
3622
3939
  #
3623
3940
  #
@@ -3628,29 +3945,35 @@ module Aws::RDS
3628
3945
  # Performance Insights data.
3629
3946
  #
3630
3947
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
3631
- # alias ARN, or alias name for the Amazon Web Services KMS customer
3632
- # master key (CMK).
3948
+ # alias ARN, or alias name for the KMS key.
3633
3949
  #
3634
3950
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
3635
- # Amazon RDS uses your default CMK. There is a default CMK for your
3636
- # Amazon Web Services account. Your Amazon Web Services account has a
3637
- # different default CMK for each Amazon Web Services Region.
3951
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
3952
+ # your Amazon Web Services account. Your Amazon Web Services account has
3953
+ # a different default KMS key for each Amazon Web Services Region.
3954
+ #
3955
+ # This setting doesn't apply to RDS Custom.
3638
3956
  #
3639
3957
  # @option params [Integer] :performance_insights_retention_period
3640
3958
  # The amount of time, in days, to retain Performance Insights data.
3641
3959
  # Valid values are 7 or 731 (2 years).
3642
3960
  #
3961
+ # This setting doesn't apply to RDS Custom.
3962
+ #
3643
3963
  # @option params [Array<String>] :enable_cloudwatch_logs_exports
3644
3964
  # The list of log types that need to be enabled for exporting to
3645
- # CloudWatch Logs. The values in the list depend on the DB engine being
3646
- # used. For more information, see [Publishing Database Logs to Amazon
3647
- # CloudWatch Logs ][1] in the *Amazon Relational Database Service User
3648
- # Guide*.
3965
+ # CloudWatch Logs. The values in the list depend on the DB engine. For
3966
+ # more information, see [Publishing Database Logs to Amazon CloudWatch
3967
+ # Logs][1] in the *Amazon Relational Database Service User Guide*.
3649
3968
  #
3650
3969
  # **Amazon Aurora**
3651
3970
  #
3652
3971
  # Not applicable. CloudWatch Logs exports are managed by the DB cluster.
3653
3972
  #
3973
+ # **RDS Custom**
3974
+ #
3975
+ # Not applicable.
3976
+ #
3654
3977
  # **MariaDB**
3655
3978
  #
3656
3979
  # Possible values are `audit`, `error`, `general`, and `slowquery`.
@@ -3680,6 +4003,8 @@ module Aws::RDS
3680
4003
  # The number of CPU cores and the number of threads per core for the DB
3681
4004
  # instance class of the DB instance.
3682
4005
  #
4006
+ # This setting doesn't apply to RDS Custom.
4007
+ #
3683
4008
  # @option params [Boolean] :deletion_protection
3684
4009
  # A value that indicates whether the DB instance has deletion protection
3685
4010
  # enabled. The database can't be deleted when deletion protection is
@@ -3705,6 +4030,8 @@ module Aws::RDS
3705
4030
  # apply to it, see [ Managing capacity automatically with Amazon RDS
3706
4031
  # storage autoscaling][1] in the *Amazon RDS User Guide*.
3707
4032
  #
4033
+ # This setting doesn't apply to RDS Custom.
4034
+ #
3708
4035
  #
3709
4036
  #
3710
4037
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -3730,6 +4057,29 @@ module Aws::RDS
3730
4057
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
3731
4058
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
3732
4059
  #
4060
+ # @option params [String] :custom_iam_instance_profile
4061
+ # The instance profile associated with the underlying Amazon EC2
4062
+ # instance of an RDS Custom DB instance. The instance profile must meet
4063
+ # the following requirements:
4064
+ #
4065
+ # * The profile must exist in your account.
4066
+ #
4067
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
4068
+ # assume.
4069
+ #
4070
+ # * The instance profile name and the associated IAM role name must
4071
+ # start with the prefix `AWSRDSCustom`.
4072
+ #
4073
+ # For the list of permissions required for the IAM role, see [ Configure
4074
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
4075
+ # Guide*.
4076
+ #
4077
+ # This setting is required for RDS Custom.
4078
+ #
4079
+ #
4080
+ #
4081
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
4082
+ #
3733
4083
  # @return [Types::CreateDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3734
4084
  #
3735
4085
  # * {Types::CreateDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -3815,6 +4165,7 @@ module Aws::RDS
3815
4165
  # deletion_protection: false,
3816
4166
  # max_allocated_storage: 1,
3817
4167
  # enable_customer_owned_ip: false,
4168
+ # custom_iam_instance_profile: "String",
3818
4169
  # })
3819
4170
  #
3820
4171
  # @example Response structure
@@ -3875,6 +4226,8 @@ module Aws::RDS
3875
4226
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
3876
4227
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
3877
4228
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
4229
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
4230
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
3878
4231
  # resp.db_instance.latest_restorable_time #=> Time
3879
4232
  # resp.db_instance.multi_az #=> Boolean
3880
4233
  # resp.db_instance.engine_version #=> String
@@ -3949,6 +4302,9 @@ module Aws::RDS
3949
4302
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
3950
4303
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
3951
4304
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
4305
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
4306
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
4307
+ # resp.db_instance.custom_iam_instance_profile #=> String
3952
4308
  #
3953
4309
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstance AWS API Documentation
3954
4310
  #
@@ -4017,8 +4373,8 @@ module Aws::RDS
4017
4373
  # * If the source DB instance is in a different Amazon Web Services
4018
4374
  # Region from the read replica, specify a valid DB instance ARN. For
4019
4375
  # more information, see [Constructing an ARN for Amazon RDS][3] in the
4020
- # *Amazon RDS User Guide*. This doesn't apply to SQL Server, which
4021
- # doesn't support cross-region replicas.
4376
+ # *Amazon RDS User Guide*. This doesn't apply to SQL Server or RDS
4377
+ # Custom, which don't support cross-Region replicas.
4022
4378
  #
4023
4379
  #
4024
4380
  #
@@ -4064,10 +4420,14 @@ module Aws::RDS
4064
4420
  # instance is independent of whether the source database is a Multi-AZ
4065
4421
  # DB instance.
4066
4422
  #
4423
+ # This setting doesn't apply to RDS Custom.
4424
+ #
4067
4425
  # @option params [Boolean] :auto_minor_version_upgrade
4068
4426
  # A value that indicates whether minor engine upgrades are applied
4069
4427
  # automatically to the read replica during the maintenance window.
4070
4428
  #
4429
+ # This setting doesn't apply to RDS Custom.
4430
+ #
4071
4431
  # Default: Inherits from the source DB instance
4072
4432
  #
4073
4433
  # @option params [Integer] :iops
@@ -4083,6 +4443,8 @@ module Aws::RDS
4083
4443
  #
4084
4444
  # </note>
4085
4445
  #
4446
+ # This setting doesn't apply to RDS Custom.
4447
+ #
4086
4448
  # @option params [String] :db_parameter_group_name
4087
4449
  # The name of the DB parameter group to associate with this DB instance.
4088
4450
  #
@@ -4091,10 +4453,8 @@ module Aws::RDS
4091
4453
  # region read replica, or the default `DBParameterGroup` for the
4092
4454
  # specified DB engine for a cross region read replica.
4093
4455
  #
4094
- # <note markdown="1"> Currently, specifying a parameter group for this operation is only
4095
- # supported for Oracle DB instances.
4096
- #
4097
- # </note>
4456
+ # Specifying a parameter group for this operation is only supported for
4457
+ # Oracle DB instances. It isn't supported for RDS Custom.
4098
4458
  #
4099
4459
  # Constraints:
4100
4460
  #
@@ -4155,7 +4515,10 @@ module Aws::RDS
4155
4515
  # Example: `mySubnetgroup`
4156
4516
  #
4157
4517
  # @option params [Array<String>] :vpc_security_group_ids
4158
- # A list of EC2 VPC security groups to associate with the read replica.
4518
+ # A list of Amazon EC2 VPC security groups to associate with the read
4519
+ # replica.
4520
+ #
4521
+ # This setting doesn't apply to RDS Custom.
4159
4522
  #
4160
4523
  # Default: The default EC2 VPC security group for the DB subnet group's
4161
4524
  # VPC.
@@ -4182,6 +4545,8 @@ module Aws::RDS
4182
4545
  # If `MonitoringRoleArn` is specified, then you must also set
4183
4546
  # `MonitoringInterval` to a value other than 0.
4184
4547
  #
4548
+ # This setting doesn't apply to RDS Custom.
4549
+ #
4185
4550
  # Valid Values: `0, 1, 5, 10, 15, 30, 60`
4186
4551
  #
4187
4552
  # @option params [String] :monitoring_role_arn
@@ -4194,6 +4559,8 @@ module Aws::RDS
4194
4559
  # If `MonitoringInterval` is set to a value other than 0, then you must
4195
4560
  # supply a `MonitoringRoleArn` value.
4196
4561
  #
4562
+ # This setting doesn't apply to RDS Custom.
4563
+ #
4197
4564
  #
4198
4565
  #
4199
4566
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.html#USER_Monitoring.OS.IAMRole
@@ -4203,24 +4570,27 @@ module Aws::RDS
4203
4570
  # replica.
4204
4571
  #
4205
4572
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
4206
- # alias ARN, or alias name for the Amazon Web Services KMS CMK.
4573
+ # alias ARN, or alias name for the KMS key.
4207
4574
  #
4208
4575
  # If you create an encrypted read replica in the same Amazon Web
4209
4576
  # Services Region as the source DB instance, then do not specify a value
4210
- # for this parameter. A read replica in the same Region is always
4211
- # encrypted with the same Amazon Web Services KMS CMK as the source DB
4577
+ # for this parameter. A read replica in the same Amazon Web Services
4578
+ # Region is always encrypted with the same KMS key as the source DB
4212
4579
  # instance.
4213
4580
  #
4214
4581
  # If you create an encrypted read replica in a different Amazon Web
4215
- # Services Region, then you must specify a Amazon Web Services KMS key
4216
- # identifier for the destination Amazon Web Services Region. Amazon Web
4217
- # Services KMS CMKs are specific to the Amazon Web Services Region that
4218
- # they are created in, and you can't use CMKs from one Amazon Web
4219
- # Services Region in another Amazon Web Services Region.
4582
+ # Services Region, then you must specify a KMS key identifier for the
4583
+ # destination Amazon Web Services Region. KMS keys are specific to the
4584
+ # Amazon Web Services Region that they are created in, and you can't
4585
+ # use KMS keys from one Amazon Web Services Region in another Amazon Web
4586
+ # Services Region.
4220
4587
  #
4221
4588
  # You can't create an encrypted read replica from an unencrypted DB
4222
4589
  # instance.
4223
4590
  #
4591
+ # This setting doesn't apply to RDS Custom, which uses the same KMS key
4592
+ # as the primary replica.
4593
+ #
4224
4594
  # @option params [String] :pre_signed_url
4225
4595
  # The URL that contains a Signature Version 4 signed request for the
4226
4596
  # `CreateDBInstanceReadReplica` API action in the source Amazon Web
@@ -4284,6 +4654,8 @@ module Aws::RDS
4284
4654
  #
4285
4655
  # </note>
4286
4656
  #
4657
+ # This setting doesn't apply to RDS Custom.
4658
+ #
4287
4659
  #
4288
4660
  #
4289
4661
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html
@@ -4298,6 +4670,8 @@ module Aws::RDS
4298
4670
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
4299
4671
  # RDS User Guide.*
4300
4672
  #
4673
+ # This setting doesn't apply to RDS Custom.
4674
+ #
4301
4675
  #
4302
4676
  #
4303
4677
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
@@ -4309,6 +4683,8 @@ module Aws::RDS
4309
4683
  # For more information, see [Using Amazon Performance Insights][1] in
4310
4684
  # the *Amazon RDS User Guide*.
4311
4685
  #
4686
+ # This setting doesn't apply to RDS Custom.
4687
+ #
4312
4688
  #
4313
4689
  #
4314
4690
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
@@ -4318,24 +4694,29 @@ module Aws::RDS
4318
4694
  # Performance Insights data.
4319
4695
  #
4320
4696
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
4321
- # alias ARN, or alias name for the Amazon Web Services KMS customer
4322
- # master key (CMK).
4697
+ # alias ARN, or alias name for the KMS key.
4323
4698
  #
4324
4699
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
4325
- # Amazon RDS uses your default CMK. There is a default CMK for your
4326
- # Amazon Web Services account. Your Amazon Web Services account has a
4327
- # different default CMK for each Amazon Web Services Region.
4700
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
4701
+ # your Amazon Web Services account. Your Amazon Web Services account has
4702
+ # a different default KMS key for each Amazon Web Services Region.
4703
+ #
4704
+ # This setting doesn't apply to RDS Custom.
4328
4705
  #
4329
4706
  # @option params [Integer] :performance_insights_retention_period
4330
4707
  # The amount of time, in days, to retain Performance Insights data.
4331
4708
  # Valid values are 7 or 731 (2 years).
4332
4709
  #
4710
+ # This setting doesn't apply to RDS Custom.
4711
+ #
4333
4712
  # @option params [Array<String>] :enable_cloudwatch_logs_exports
4334
4713
  # The list of logs that the new DB instance is to export to CloudWatch
4335
4714
  # Logs. The values in the list depend on the DB engine being used. For
4336
4715
  # more information, see [Publishing Database Logs to Amazon CloudWatch
4337
4716
  # Logs ][1] in the *Amazon RDS User Guide*.
4338
4717
  #
4718
+ # This setting doesn't apply to RDS Custom.
4719
+ #
4339
4720
  #
4340
4721
  #
4341
4722
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -4344,10 +4725,14 @@ module Aws::RDS
4344
4725
  # The number of CPU cores and the number of threads per core for the DB
4345
4726
  # instance class of the DB instance.
4346
4727
  #
4728
+ # This setting doesn't apply to RDS Custom.
4729
+ #
4347
4730
  # @option params [Boolean] :use_default_processor_features
4348
4731
  # A value that indicates whether the DB instance class of the DB
4349
4732
  # instance uses its default processor features.
4350
4733
  #
4734
+ # This setting doesn't apply to RDS Custom.
4735
+ #
4351
4736
  # @option params [Boolean] :deletion_protection
4352
4737
  # A value that indicates whether the DB instance has deletion protection
4353
4738
  # enabled. The database can't be deleted when deletion protection is
@@ -4366,6 +4751,8 @@ module Aws::RDS
4366
4751
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
4367
4752
  # RDS User Guide*.
4368
4753
  #
4754
+ # This setting doesn't apply to RDS Custom.
4755
+ #
4369
4756
  #
4370
4757
  #
4371
4758
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -4374,6 +4761,8 @@ module Aws::RDS
4374
4761
  # Specify the name of the IAM role to be used when making API calls to
4375
4762
  # the Directory Service.
4376
4763
  #
4764
+ # This setting doesn't apply to RDS Custom.
4765
+ #
4377
4766
  # @option params [String] :replica_mode
4378
4767
  # The open mode of the replica database: mounted or read-only.
4379
4768
  #
@@ -4381,17 +4770,22 @@ module Aws::RDS
4381
4770
  #
4382
4771
  # </note>
4383
4772
  #
4384
- # Mounted DB replicas are included in Oracle Enterprise Edition. The
4385
- # main use case for mounted replicas is cross-Region disaster recovery.
4386
- # The primary database doesn't use Active Data Guard to transmit
4387
- # information to the mounted replica. Because it doesn't accept user
4388
- # connections, a mounted replica can't serve a read-only workload.
4773
+ # Mounted DB replicas are included in Oracle Database Enterprise
4774
+ # Edition. The main use case for mounted replicas is cross-Region
4775
+ # disaster recovery. The primary database doesn't use Active Data Guard
4776
+ # to transmit information to the mounted replica. Because it doesn't
4777
+ # accept user connections, a mounted replica can't serve a read-only
4778
+ # workload.
4389
4779
  #
4390
4780
  # You can create a combination of mounted and read-only DB replicas for
4391
4781
  # the same primary DB instance. For more information, see [Working with
4392
4782
  # Oracle Read Replicas for Amazon RDS][1] in the *Amazon RDS User
4393
4783
  # Guide*.
4394
4784
  #
4785
+ # For RDS Custom, you must specify this parameter and set it to
4786
+ # `mounted`. The value won't be set by default. After replica creation,
4787
+ # you can manage the open mode manually.
4788
+ #
4395
4789
  #
4396
4790
  #
4397
4791
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
@@ -4408,6 +4802,29 @@ module Aws::RDS
4408
4802
  #
4409
4803
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
4410
4804
  #
4805
+ # @option params [String] :custom_iam_instance_profile
4806
+ # The instance profile associated with the underlying Amazon EC2
4807
+ # instance of an RDS Custom DB instance. The instance profile must meet
4808
+ # the following requirements:
4809
+ #
4810
+ # * The profile must exist in your account.
4811
+ #
4812
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
4813
+ # assume.
4814
+ #
4815
+ # * The instance profile name and the associated IAM role name must
4816
+ # start with the prefix `AWSRDSCustom`.
4817
+ #
4818
+ # For the list of permissions required for the IAM role, see [ Configure
4819
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
4820
+ # Guide*.
4821
+ #
4822
+ # This setting is required for RDS Custom.
4823
+ #
4824
+ #
4825
+ #
4826
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
4827
+ #
4411
4828
  # @option params [String] :source_region
4412
4829
  # The source region of the snapshot. This is only needed when the
4413
4830
  # shapshot is encrypted and in a different region.
@@ -4488,6 +4905,7 @@ module Aws::RDS
4488
4905
  # domain_iam_role_name: "String",
4489
4906
  # replica_mode: "open-read-only", # accepts open-read-only, mounted
4490
4907
  # max_allocated_storage: 1,
4908
+ # custom_iam_instance_profile: "String",
4491
4909
  # source_region: "String",
4492
4910
  # })
4493
4911
  #
@@ -4549,6 +4967,8 @@ module Aws::RDS
4549
4967
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
4550
4968
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
4551
4969
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
4970
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
4971
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
4552
4972
  # resp.db_instance.latest_restorable_time #=> Time
4553
4973
  # resp.db_instance.multi_az #=> Boolean
4554
4974
  # resp.db_instance.engine_version #=> String
@@ -4623,6 +5043,9 @@ module Aws::RDS
4623
5043
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
4624
5044
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
4625
5045
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
5046
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
5047
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
5048
+ # resp.db_instance.custom_iam_instance_profile #=> String
4626
5049
  #
4627
5050
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceReadReplica AWS API Documentation
4628
5051
  #
@@ -4638,13 +5061,15 @@ module Aws::RDS
4638
5061
  # A DB parameter group is initially created with the default parameters
4639
5062
  # for the database engine used by the DB instance. To provide custom
4640
5063
  # values for any of the parameters, you must modify the group after
4641
- # creating it using *ModifyDBParameterGroup*. Once you've created a DB
5064
+ # creating it using `ModifyDBParameterGroup`. Once you've created a DB
4642
5065
  # parameter group, you need to associate it with your DB instance using
4643
- # *ModifyDBInstance*. When you associate a new DB parameter group with a
5066
+ # `ModifyDBInstance`. When you associate a new DB parameter group with a
4644
5067
  # running DB instance, you need to reboot the DB instance without
4645
5068
  # failover for the new DB parameter group and associated settings to
4646
5069
  # take effect.
4647
5070
  #
5071
+ # This command doesn't apply to RDS Custom.
5072
+ #
4648
5073
  # After you create a DB parameter group, you should wait at least 5
4649
5074
  # minutes before creating your first DB instance that uses that DB
4650
5075
  # parameter group as the default parameter group. This allows Amazon RDS
@@ -5523,6 +5948,8 @@ module Aws::RDS
5523
5948
 
5524
5949
  # Creates a new option group. You can create up to 20 option groups.
5525
5950
  #
5951
+ # This command doesn't apply to RDS Custom.
5952
+ #
5526
5953
  # @option params [required, String] :option_group_name
5527
5954
  # Specifies the name of the option group to be created.
5528
5955
  #
@@ -5699,6 +6126,136 @@ module Aws::RDS
5699
6126
  req.send_request(options)
5700
6127
  end
5701
6128
 
6129
+ # Deletes a custom engine version. To run this command, make sure you
6130
+ # meet the following prerequisites:
6131
+ #
6132
+ # * The CEV must not be the default for RDS Custom. If it is, change the
6133
+ # default before running this command.
6134
+ #
6135
+ # * The CEV must not be associated with an RDS Custom DB instance, RDS
6136
+ # Custom instance snapshot, or automated backup of your RDS Custom
6137
+ # instance.
6138
+ #
6139
+ # Typically, deletion takes a few minutes.
6140
+ #
6141
+ # <note markdown="1"> The MediaImport service that imports files from Amazon S3 to create
6142
+ # CEVs isn't integrated with Amazon Web Services CloudTrail. If you
6143
+ # turn on data logging for Amazon RDS in CloudTrail, calls to the
6144
+ # `DeleteCustomDbEngineVersion` event aren't logged. However, you might
6145
+ # see calls from the API gateway that accesses your Amazon S3 bucket.
6146
+ # These calls originate from the MediaImport service for the
6147
+ # `DeleteCustomDbEngineVersion` event.
6148
+ #
6149
+ # </note>
6150
+ #
6151
+ # For more information, see [ Deleting a CEV][1] in the *Amazon RDS User
6152
+ # Guide*.
6153
+ #
6154
+ #
6155
+ #
6156
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.delete
6157
+ #
6158
+ # @option params [required, String] :engine
6159
+ # The database engine. The only supported engine is `custom-oracle-ee`.
6160
+ #
6161
+ # @option params [required, String] :engine_version
6162
+ # The custom engine version (CEV) for your DB instance. This option is
6163
+ # required for RDS Custom, but optional for Amazon RDS. The combination
6164
+ # of `Engine` and `EngineVersion` is unique per customer per Amazon Web
6165
+ # Services Region.
6166
+ #
6167
+ # @return [Types::DBEngineVersion] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6168
+ #
6169
+ # * {Types::DBEngineVersion#engine #engine} => String
6170
+ # * {Types::DBEngineVersion#engine_version #engine_version} => String
6171
+ # * {Types::DBEngineVersion#db_parameter_group_family #db_parameter_group_family} => String
6172
+ # * {Types::DBEngineVersion#db_engine_description #db_engine_description} => String
6173
+ # * {Types::DBEngineVersion#db_engine_version_description #db_engine_version_description} => String
6174
+ # * {Types::DBEngineVersion#default_character_set #default_character_set} => Types::CharacterSet
6175
+ # * {Types::DBEngineVersion#supported_character_sets #supported_character_sets} => Array&lt;Types::CharacterSet&gt;
6176
+ # * {Types::DBEngineVersion#supported_nchar_character_sets #supported_nchar_character_sets} => Array&lt;Types::CharacterSet&gt;
6177
+ # * {Types::DBEngineVersion#valid_upgrade_target #valid_upgrade_target} => Array&lt;Types::UpgradeTarget&gt;
6178
+ # * {Types::DBEngineVersion#supported_timezones #supported_timezones} => Array&lt;Types::Timezone&gt;
6179
+ # * {Types::DBEngineVersion#exportable_log_types #exportable_log_types} => Array&lt;String&gt;
6180
+ # * {Types::DBEngineVersion#supports_log_exports_to_cloudwatch_logs #supports_log_exports_to_cloudwatch_logs} => Boolean
6181
+ # * {Types::DBEngineVersion#supports_read_replica #supports_read_replica} => Boolean
6182
+ # * {Types::DBEngineVersion#supported_engine_modes #supported_engine_modes} => Array&lt;String&gt;
6183
+ # * {Types::DBEngineVersion#supported_feature_names #supported_feature_names} => Array&lt;String&gt;
6184
+ # * {Types::DBEngineVersion#status #status} => String
6185
+ # * {Types::DBEngineVersion#supports_parallel_query #supports_parallel_query} => Boolean
6186
+ # * {Types::DBEngineVersion#supports_global_databases #supports_global_databases} => Boolean
6187
+ # * {Types::DBEngineVersion#major_engine_version #major_engine_version} => String
6188
+ # * {Types::DBEngineVersion#database_installation_files_s3_bucket_name #database_installation_files_s3_bucket_name} => String
6189
+ # * {Types::DBEngineVersion#database_installation_files_s3_prefix #database_installation_files_s3_prefix} => String
6190
+ # * {Types::DBEngineVersion#db_engine_version_arn #db_engine_version_arn} => String
6191
+ # * {Types::DBEngineVersion#kms_key_id #kms_key_id} => String
6192
+ # * {Types::DBEngineVersion#create_time #create_time} => Time
6193
+ # * {Types::DBEngineVersion#tag_list #tag_list} => Array&lt;Types::Tag&gt;
6194
+ #
6195
+ # @example Request syntax with placeholder values
6196
+ #
6197
+ # resp = client.delete_custom_db_engine_version({
6198
+ # engine: "CustomEngineName", # required
6199
+ # engine_version: "CustomEngineVersion", # required
6200
+ # })
6201
+ #
6202
+ # @example Response structure
6203
+ #
6204
+ # resp.engine #=> String
6205
+ # resp.engine_version #=> String
6206
+ # resp.db_parameter_group_family #=> String
6207
+ # resp.db_engine_description #=> String
6208
+ # resp.db_engine_version_description #=> String
6209
+ # resp.default_character_set.character_set_name #=> String
6210
+ # resp.default_character_set.character_set_description #=> String
6211
+ # resp.supported_character_sets #=> Array
6212
+ # resp.supported_character_sets[0].character_set_name #=> String
6213
+ # resp.supported_character_sets[0].character_set_description #=> String
6214
+ # resp.supported_nchar_character_sets #=> Array
6215
+ # resp.supported_nchar_character_sets[0].character_set_name #=> String
6216
+ # resp.supported_nchar_character_sets[0].character_set_description #=> String
6217
+ # resp.valid_upgrade_target #=> Array
6218
+ # resp.valid_upgrade_target[0].engine #=> String
6219
+ # resp.valid_upgrade_target[0].engine_version #=> String
6220
+ # resp.valid_upgrade_target[0].description #=> String
6221
+ # resp.valid_upgrade_target[0].auto_upgrade #=> Boolean
6222
+ # resp.valid_upgrade_target[0].is_major_version_upgrade #=> Boolean
6223
+ # resp.valid_upgrade_target[0].supported_engine_modes #=> Array
6224
+ # resp.valid_upgrade_target[0].supported_engine_modes[0] #=> String
6225
+ # resp.valid_upgrade_target[0].supports_parallel_query #=> Boolean
6226
+ # resp.valid_upgrade_target[0].supports_global_databases #=> Boolean
6227
+ # resp.supported_timezones #=> Array
6228
+ # resp.supported_timezones[0].timezone_name #=> String
6229
+ # resp.exportable_log_types #=> Array
6230
+ # resp.exportable_log_types[0] #=> String
6231
+ # resp.supports_log_exports_to_cloudwatch_logs #=> Boolean
6232
+ # resp.supports_read_replica #=> Boolean
6233
+ # resp.supported_engine_modes #=> Array
6234
+ # resp.supported_engine_modes[0] #=> String
6235
+ # resp.supported_feature_names #=> Array
6236
+ # resp.supported_feature_names[0] #=> String
6237
+ # resp.status #=> String
6238
+ # resp.supports_parallel_query #=> Boolean
6239
+ # resp.supports_global_databases #=> Boolean
6240
+ # resp.major_engine_version #=> String
6241
+ # resp.database_installation_files_s3_bucket_name #=> String
6242
+ # resp.database_installation_files_s3_prefix #=> String
6243
+ # resp.db_engine_version_arn #=> String
6244
+ # resp.kms_key_id #=> String
6245
+ # resp.create_time #=> Time
6246
+ # resp.tag_list #=> Array
6247
+ # resp.tag_list[0].key #=> String
6248
+ # resp.tag_list[0].value #=> String
6249
+ #
6250
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteCustomDBEngineVersion AWS API Documentation
6251
+ #
6252
+ # @overload delete_custom_db_engine_version(params = {})
6253
+ # @param [Hash] params ({})
6254
+ def delete_custom_db_engine_version(params = {}, options = {})
6255
+ req = build_request(:delete_custom_db_engine_version, params)
6256
+ req.send_request(options)
6257
+ end
6258
+
5702
6259
  # The DeleteDBCluster action deletes a previously provisioned DB
5703
6260
  # cluster. When you delete a DB cluster, all automated backups for that
5704
6261
  # DB cluster are deleted and can't be recovered. Manual DB cluster
@@ -6124,31 +6681,37 @@ module Aws::RDS
6124
6681
  #
6125
6682
  # @option params [Boolean] :skip_final_snapshot
6126
6683
  # A value that indicates whether to skip the creation of a final DB
6127
- # snapshot before the DB instance is deleted. If skip is specified, no
6128
- # DB snapshot is created. If skip isn't specified, a DB snapshot is
6129
- # created before the DB instance is deleted. By default, skip isn't
6130
- # specified, and the DB snapshot is created.
6684
+ # snapshot before deleting the instance. If you enable this parameter,
6685
+ # RDS doesn't create a DB snapshot. If you don't enable this
6686
+ # parameter, RDS creates a DB snapshot before the DB instance is
6687
+ # deleted. By default, skip isn't enabled, and the DB snapshot is
6688
+ # created.
6131
6689
  #
6132
- # When a DB instance is in a failure state and has a status of
6133
- # 'failed', 'incompatible-restore', or 'incompatible-network', it
6134
- # can only be deleted when skip is specified.
6690
+ # <note markdown="1"> If you don't enable this parameter, you must specify the
6691
+ # `FinalDBSnapshotIdentifier` parameter.
6135
6692
  #
6136
- # Specify skip when deleting a read replica.
6693
+ # </note>
6137
6694
  #
6138
- # <note markdown="1"> The FinalDBSnapshotIdentifier parameter must be specified if skip
6139
- # isn't specified.
6695
+ # When a DB instance is in a failure state and has a status of `failed`,
6696
+ # `incompatible-restore`, or `incompatible-network`, RDS can delete the
6697
+ # instance only if you enable this parameter.
6140
6698
  #
6141
- # </note>
6699
+ # If you delete a read replica or an RDS Custom instance, you must
6700
+ # enable this setting.
6701
+ #
6702
+ # This setting is required for RDS Custom.
6142
6703
  #
6143
6704
  # @option params [String] :final_db_snapshot_identifier
6144
6705
  # The `DBSnapshotIdentifier` of the new `DBSnapshot` created when the
6145
6706
  # `SkipFinalSnapshot` parameter is disabled.
6146
6707
  #
6147
- # <note markdown="1"> Specifying this parameter and also specifying to skip final DB
6148
- # snapshot creation in SkipFinalShapshot results in an error.
6708
+ # <note markdown="1"> If you enable this parameter and also enable SkipFinalShapshot, the
6709
+ # command results in an error.
6149
6710
  #
6150
6711
  # </note>
6151
6712
  #
6713
+ # This setting doesn't apply to RDS Custom.
6714
+ #
6152
6715
  # Constraints:
6153
6716
  #
6154
6717
  # * Must be 1 to 255 letters or numbers.
@@ -6252,6 +6815,8 @@ module Aws::RDS
6252
6815
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
6253
6816
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
6254
6817
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
6818
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
6819
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
6255
6820
  # resp.db_instance.latest_restorable_time #=> Time
6256
6821
  # resp.db_instance.multi_az #=> Boolean
6257
6822
  # resp.db_instance.engine_version #=> String
@@ -6326,6 +6891,9 @@ module Aws::RDS
6326
6891
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
6327
6892
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
6328
6893
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
6894
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
6895
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
6896
+ # resp.db_instance.custom_iam_instance_profile #=> String
6329
6897
  #
6330
6898
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstance AWS API Documentation
6331
6899
  #
@@ -6349,6 +6917,8 @@ module Aws::RDS
6349
6917
  # example,
6350
6918
  # `arn:aws:rds:us-east-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
6351
6919
  #
6920
+ # This setting doesn't apply to RDS Custom.
6921
+ #
6352
6922
  # @return [Types::DeleteDBInstanceAutomatedBackupResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6353
6923
  #
6354
6924
  # * {Types::DeleteDBInstanceAutomatedBackupResult#db_instance_automated_backup #db_instance_automated_backup} => Types::DBInstanceAutomatedBackup
@@ -8117,6 +8687,10 @@ module Aws::RDS
8117
8687
  # `CharacterSetName` parameter for `CreateDBInstance`, the response
8118
8688
  # includes a list of supported character sets for each engine version.
8119
8689
  #
8690
+ # For RDS Custom, the default is not to list supported character sets.
8691
+ # If you set `ListSupportedCharacterSets` to `true`, RDS Custom returns
8692
+ # no results.
8693
+ #
8120
8694
  # @option params [Boolean] :list_supported_timezones
8121
8695
  # A value that indicates whether to list the supported time zones for
8122
8696
  # each engine version.
@@ -8125,6 +8699,10 @@ module Aws::RDS
8125
8699
  # `TimeZone` parameter for `CreateDBInstance`, the response includes a
8126
8700
  # list of supported time zones for each engine version.
8127
8701
  #
8702
+ # For RDS Custom, the default is not to list supported time zones. If
8703
+ # you set `ListSupportedTimezones` to `true`, RDS Custom returns no
8704
+ # results.
8705
+ #
8128
8706
  # @option params [Boolean] :include_all
8129
8707
  # A value that indicates whether to include engine versions that aren't
8130
8708
  # available in the list. The default is to list only available engine
@@ -8214,6 +8792,15 @@ module Aws::RDS
8214
8792
  # resp.db_engine_versions[0].status #=> String
8215
8793
  # resp.db_engine_versions[0].supports_parallel_query #=> Boolean
8216
8794
  # resp.db_engine_versions[0].supports_global_databases #=> Boolean
8795
+ # resp.db_engine_versions[0].major_engine_version #=> String
8796
+ # resp.db_engine_versions[0].database_installation_files_s3_bucket_name #=> String
8797
+ # resp.db_engine_versions[0].database_installation_files_s3_prefix #=> String
8798
+ # resp.db_engine_versions[0].db_engine_version_arn #=> String
8799
+ # resp.db_engine_versions[0].kms_key_id #=> String
8800
+ # resp.db_engine_versions[0].create_time #=> Time
8801
+ # resp.db_engine_versions[0].tag_list #=> Array
8802
+ # resp.db_engine_versions[0].tag_list[0].key #=> String
8803
+ # resp.db_engine_versions[0].tag_list[0].value #=> String
8217
8804
  #
8218
8805
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBEngineVersions AWS API Documentation
8219
8806
  #
@@ -8285,6 +8872,8 @@ module Aws::RDS
8285
8872
  # for example,
8286
8873
  # `arn:aws:rds:us-east-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
8287
8874
  #
8875
+ # This setting doesn't apply to RDS Custom.
8876
+ #
8288
8877
  # @return [Types::DBInstanceAutomatedBackupMessage] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8289
8878
  #
8290
8879
  # * {Types::DBInstanceAutomatedBackupMessage#marker #marker} => String
@@ -8504,6 +9093,8 @@ module Aws::RDS
8504
9093
  # resp.db_instances[0].pending_modified_values.processor_features[0].name #=> String
8505
9094
  # resp.db_instances[0].pending_modified_values.processor_features[0].value #=> String
8506
9095
  # resp.db_instances[0].pending_modified_values.iam_database_authentication_enabled #=> Boolean
9096
+ # resp.db_instances[0].pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
9097
+ # resp.db_instances[0].pending_modified_values.resume_full_automation_mode_time #=> Time
8507
9098
  # resp.db_instances[0].latest_restorable_time #=> Time
8508
9099
  # resp.db_instances[0].multi_az #=> Boolean
8509
9100
  # resp.db_instances[0].engine_version #=> String
@@ -8578,6 +9169,9 @@ module Aws::RDS
8578
9169
  # resp.db_instances[0].activity_stream_kinesis_stream_name #=> String
8579
9170
  # resp.db_instances[0].activity_stream_mode #=> String, one of "sync", "async"
8580
9171
  # resp.db_instances[0].activity_stream_engine_native_audit_fields_included #=> Boolean
9172
+ # resp.db_instances[0].automation_mode #=> String, one of "full", "all-paused"
9173
+ # resp.db_instances[0].resume_full_automation_mode_time #=> Time
9174
+ # resp.db_instances[0].custom_iam_instance_profile #=> String
8581
9175
  #
8582
9176
  #
8583
9177
  # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -8596,6 +9190,8 @@ module Aws::RDS
8596
9190
 
8597
9191
  # Returns a list of DB log files for the DB instance.
8598
9192
  #
9193
+ # This command doesn't apply to RDS Custom.
9194
+ #
8599
9195
  # @option params [required, String] :db_instance_identifier
8600
9196
  # The customer-assigned name of the DB instance that contains the log
8601
9197
  # files you want to list.
@@ -9441,6 +10037,8 @@ module Aws::RDS
9441
10037
  # manual DB snapshot from another Amazon Web Services account by using
9442
10038
  # the `ModifyDBSnapshotAttribute` API action.
9443
10039
  #
10040
+ # This setting doesn't apply to RDS Custom.
10041
+ #
9444
10042
  # @option params [Boolean] :include_public
9445
10043
  # A value that indicates whether to include manual DB cluster snapshots
9446
10044
  # that are public and can be copied or restored by any Amazon Web
@@ -9449,6 +10047,8 @@ module Aws::RDS
9449
10047
  # You can share a manual DB snapshot as public by using the
9450
10048
  # ModifyDBSnapshotAttribute API.
9451
10049
  #
10050
+ # This setting doesn't apply to RDS Custom.
10051
+ #
9452
10052
  # @option params [String] :dbi_resource_id
9453
10053
  # A specific DB resource ID to describe.
9454
10054
  #
@@ -10095,7 +10695,7 @@ module Aws::RDS
10095
10695
  #
10096
10696
  # resp = client.describe_events({
10097
10697
  # source_identifier: "String",
10098
- # source_type: "db-instance", # accepts db-instance, db-parameter-group, db-security-group, db-snapshot, db-cluster, db-cluster-snapshot
10698
+ # source_type: "db-instance", # accepts db-instance, db-parameter-group, db-security-group, db-snapshot, db-cluster, db-cluster-snapshot, custom-engine-version
10099
10699
  # start_time: Time.now,
10100
10700
  # end_time: Time.now,
10101
10701
  # duration: 1,
@@ -10115,7 +10715,7 @@ module Aws::RDS
10115
10715
  # resp.marker #=> String
10116
10716
  # resp.events #=> Array
10117
10717
  # resp.events[0].source_identifier #=> String
10118
- # resp.events[0].source_type #=> String, one of "db-instance", "db-parameter-group", "db-security-group", "db-snapshot", "db-cluster", "db-cluster-snapshot"
10718
+ # resp.events[0].source_type #=> String, one of "db-instance", "db-parameter-group", "db-security-group", "db-snapshot", "db-cluster", "db-cluster-snapshot", "custom-engine-version"
10119
10719
  # resp.events[0].message #=> String
10120
10720
  # resp.events[0].event_categories #=> Array
10121
10721
  # resp.events[0].event_categories[0] #=> String
@@ -10155,8 +10755,18 @@ module Aws::RDS
10155
10755
  # * `source-arn` - The Amazon Resource Name (ARN) of the snapshot
10156
10756
  # exported to Amazon S3
10157
10757
  #
10158
- # * `status` - The status of the export task. Must be lowercase, for
10159
- # example, `complete`.
10758
+ # * `status` - The status of the export task. Must be lowercase. Valid
10759
+ # statuses are the following:
10760
+ #
10761
+ # * `canceled`
10762
+ #
10763
+ # * `canceling`
10764
+ #
10765
+ # * `complete`
10766
+ #
10767
+ # * `failed`
10768
+ #
10769
+ # * `starting`
10160
10770
  #
10161
10771
  # @option params [String] :marker
10162
10772
  # An optional pagination token provided by a previous
@@ -10718,6 +11328,8 @@ module Aws::RDS
10718
11328
  # The license model filter value. Specify this parameter to show only
10719
11329
  # the available offerings matching the specified license model.
10720
11330
  #
11331
+ # RDS Custom supports only the BYOL licensing model.
11332
+ #
10721
11333
  # @option params [String] :availability_zone_group
10722
11334
  # The Availability Zone group associated with a Local Zone. Specify this
10723
11335
  # parameter to retrieve available offerings for the Local Zones in the
@@ -10726,8 +11338,14 @@ module Aws::RDS
10726
11338
  # Omit this parameter to show the available offerings in the specified
10727
11339
  # Amazon Web Services Region.
10728
11340
  #
11341
+ # This setting doesn't apply to RDS Custom.
11342
+ #
10729
11343
  # @option params [Boolean] :vpc
10730
11344
  # A value that indicates whether to show only VPC or non-VPC offerings.
11345
+ # RDS Custom supports only VPC offerings.
11346
+ #
11347
+ # RDS Custom supports only VPC offerings. If you describe non-VPC
11348
+ # offerings for RDS Custom, the output shows VPC offerings.
10731
11349
  #
10732
11350
  # @option params [Array<Types::Filter>] :filters
10733
11351
  # This parameter isn't currently supported.
@@ -11341,6 +11959,8 @@ module Aws::RDS
11341
11959
  # modifications you can make to your DB instance. You can use this
11342
11960
  # information when you call `ModifyDBInstance`.
11343
11961
  #
11962
+ # This command doesn't apply to RDS Custom.
11963
+ #
11344
11964
  # @option params [required, String] :db_instance_identifier
11345
11965
  # The customer identifier or the ARN of your DB instance.
11346
11966
  #
@@ -11387,6 +12007,8 @@ module Aws::RDS
11387
12007
  # Downloads all or a portion of the specified log file, up to 1 MB in
11388
12008
  # size.
11389
12009
  #
12010
+ # This command doesn't apply to RDS Custom.
12011
+ #
11390
12012
  # @option params [required, String] :db_instance_identifier
11391
12013
  # The customer-assigned name of the DB instance that contains the log
11392
12014
  # files you want to list.
@@ -12078,6 +12700,154 @@ module Aws::RDS
12078
12700
  req.send_request(options)
12079
12701
  end
12080
12702
 
12703
+ # Modifies the status of a custom engine version (CEV). You can find
12704
+ # CEVs to modify by calling `DescribeDBEngineVersions`.
12705
+ #
12706
+ # <note markdown="1"> The MediaImport service that imports files from Amazon S3 to create
12707
+ # CEVs isn't integrated with Amazon Web Services CloudTrail. If you
12708
+ # turn on data logging for Amazon RDS in CloudTrail, calls to the
12709
+ # `ModifyCustomDbEngineVersion` event aren't logged. However, you might
12710
+ # see calls from the API gateway that accesses your Amazon S3 bucket.
12711
+ # These calls originate from the MediaImport service for the
12712
+ # `ModifyCustomDbEngineVersion` event.
12713
+ #
12714
+ # </note>
12715
+ #
12716
+ # For more information, see [Modifying CEV status][1] in the *Amazon RDS
12717
+ # User Guide*.
12718
+ #
12719
+ #
12720
+ #
12721
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-cev.html#custom-cev.preparing.manifest
12722
+ #
12723
+ # @option params [required, String] :engine
12724
+ # The DB engine. The only supported value is `custom-oracle-ee`.
12725
+ #
12726
+ # @option params [required, String] :engine_version
12727
+ # The custom engine version (CEV) that you want to modify. This option
12728
+ # is required for RDS Custom, but optional for Amazon RDS. The
12729
+ # combination of `Engine` and `EngineVersion` is unique per customer per
12730
+ # Amazon Web Services Region.
12731
+ #
12732
+ # @option params [String] :description
12733
+ # An optional description of your CEV.
12734
+ #
12735
+ # @option params [String] :status
12736
+ # The availability status to be assigned to the CEV. Valid values are as
12737
+ # follows:
12738
+ #
12739
+ # available
12740
+ #
12741
+ # : You can use this CEV to create a new RDS Custom DB instance.
12742
+ #
12743
+ # inactive
12744
+ #
12745
+ # : You can create a new RDS Custom instance by restoring a DB snapshot
12746
+ # with this CEV. You can't patch or create new instances with this
12747
+ # CEV.
12748
+ #
12749
+ # You can change any status to any status. A typical reason to change
12750
+ # status is to prevent the accidental use of a CEV, or to make a
12751
+ # deprecated CEV eligible for use again. For example, you might change
12752
+ # the status of your CEV from `available` to `inactive`, and from
12753
+ # `inactive` back to `available`. To change the availability status of
12754
+ # the CEV, it must not currently be in use by an RDS Custom instance,
12755
+ # snapshot, or automated backup.
12756
+ #
12757
+ # @return [Types::DBEngineVersion] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
12758
+ #
12759
+ # * {Types::DBEngineVersion#engine #engine} => String
12760
+ # * {Types::DBEngineVersion#engine_version #engine_version} => String
12761
+ # * {Types::DBEngineVersion#db_parameter_group_family #db_parameter_group_family} => String
12762
+ # * {Types::DBEngineVersion#db_engine_description #db_engine_description} => String
12763
+ # * {Types::DBEngineVersion#db_engine_version_description #db_engine_version_description} => String
12764
+ # * {Types::DBEngineVersion#default_character_set #default_character_set} => Types::CharacterSet
12765
+ # * {Types::DBEngineVersion#supported_character_sets #supported_character_sets} => Array&lt;Types::CharacterSet&gt;
12766
+ # * {Types::DBEngineVersion#supported_nchar_character_sets #supported_nchar_character_sets} => Array&lt;Types::CharacterSet&gt;
12767
+ # * {Types::DBEngineVersion#valid_upgrade_target #valid_upgrade_target} => Array&lt;Types::UpgradeTarget&gt;
12768
+ # * {Types::DBEngineVersion#supported_timezones #supported_timezones} => Array&lt;Types::Timezone&gt;
12769
+ # * {Types::DBEngineVersion#exportable_log_types #exportable_log_types} => Array&lt;String&gt;
12770
+ # * {Types::DBEngineVersion#supports_log_exports_to_cloudwatch_logs #supports_log_exports_to_cloudwatch_logs} => Boolean
12771
+ # * {Types::DBEngineVersion#supports_read_replica #supports_read_replica} => Boolean
12772
+ # * {Types::DBEngineVersion#supported_engine_modes #supported_engine_modes} => Array&lt;String&gt;
12773
+ # * {Types::DBEngineVersion#supported_feature_names #supported_feature_names} => Array&lt;String&gt;
12774
+ # * {Types::DBEngineVersion#status #status} => String
12775
+ # * {Types::DBEngineVersion#supports_parallel_query #supports_parallel_query} => Boolean
12776
+ # * {Types::DBEngineVersion#supports_global_databases #supports_global_databases} => Boolean
12777
+ # * {Types::DBEngineVersion#major_engine_version #major_engine_version} => String
12778
+ # * {Types::DBEngineVersion#database_installation_files_s3_bucket_name #database_installation_files_s3_bucket_name} => String
12779
+ # * {Types::DBEngineVersion#database_installation_files_s3_prefix #database_installation_files_s3_prefix} => String
12780
+ # * {Types::DBEngineVersion#db_engine_version_arn #db_engine_version_arn} => String
12781
+ # * {Types::DBEngineVersion#kms_key_id #kms_key_id} => String
12782
+ # * {Types::DBEngineVersion#create_time #create_time} => Time
12783
+ # * {Types::DBEngineVersion#tag_list #tag_list} => Array&lt;Types::Tag&gt;
12784
+ #
12785
+ # @example Request syntax with placeholder values
12786
+ #
12787
+ # resp = client.modify_custom_db_engine_version({
12788
+ # engine: "CustomEngineName", # required
12789
+ # engine_version: "CustomEngineVersion", # required
12790
+ # description: "Description",
12791
+ # status: "available", # accepts available, inactive, inactive-except-restore
12792
+ # })
12793
+ #
12794
+ # @example Response structure
12795
+ #
12796
+ # resp.engine #=> String
12797
+ # resp.engine_version #=> String
12798
+ # resp.db_parameter_group_family #=> String
12799
+ # resp.db_engine_description #=> String
12800
+ # resp.db_engine_version_description #=> String
12801
+ # resp.default_character_set.character_set_name #=> String
12802
+ # resp.default_character_set.character_set_description #=> String
12803
+ # resp.supported_character_sets #=> Array
12804
+ # resp.supported_character_sets[0].character_set_name #=> String
12805
+ # resp.supported_character_sets[0].character_set_description #=> String
12806
+ # resp.supported_nchar_character_sets #=> Array
12807
+ # resp.supported_nchar_character_sets[0].character_set_name #=> String
12808
+ # resp.supported_nchar_character_sets[0].character_set_description #=> String
12809
+ # resp.valid_upgrade_target #=> Array
12810
+ # resp.valid_upgrade_target[0].engine #=> String
12811
+ # resp.valid_upgrade_target[0].engine_version #=> String
12812
+ # resp.valid_upgrade_target[0].description #=> String
12813
+ # resp.valid_upgrade_target[0].auto_upgrade #=> Boolean
12814
+ # resp.valid_upgrade_target[0].is_major_version_upgrade #=> Boolean
12815
+ # resp.valid_upgrade_target[0].supported_engine_modes #=> Array
12816
+ # resp.valid_upgrade_target[0].supported_engine_modes[0] #=> String
12817
+ # resp.valid_upgrade_target[0].supports_parallel_query #=> Boolean
12818
+ # resp.valid_upgrade_target[0].supports_global_databases #=> Boolean
12819
+ # resp.supported_timezones #=> Array
12820
+ # resp.supported_timezones[0].timezone_name #=> String
12821
+ # resp.exportable_log_types #=> Array
12822
+ # resp.exportable_log_types[0] #=> String
12823
+ # resp.supports_log_exports_to_cloudwatch_logs #=> Boolean
12824
+ # resp.supports_read_replica #=> Boolean
12825
+ # resp.supported_engine_modes #=> Array
12826
+ # resp.supported_engine_modes[0] #=> String
12827
+ # resp.supported_feature_names #=> Array
12828
+ # resp.supported_feature_names[0] #=> String
12829
+ # resp.status #=> String
12830
+ # resp.supports_parallel_query #=> Boolean
12831
+ # resp.supports_global_databases #=> Boolean
12832
+ # resp.major_engine_version #=> String
12833
+ # resp.database_installation_files_s3_bucket_name #=> String
12834
+ # resp.database_installation_files_s3_prefix #=> String
12835
+ # resp.db_engine_version_arn #=> String
12836
+ # resp.kms_key_id #=> String
12837
+ # resp.create_time #=> Time
12838
+ # resp.tag_list #=> Array
12839
+ # resp.tag_list[0].key #=> String
12840
+ # resp.tag_list[0].value #=> String
12841
+ #
12842
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyCustomDBEngineVersion AWS API Documentation
12843
+ #
12844
+ # @overload modify_custom_db_engine_version(params = {})
12845
+ # @param [Hash] params ({})
12846
+ def modify_custom_db_engine_version(params = {}, options = {})
12847
+ req = build_request(:modify_custom_db_engine_version, params)
12848
+ req.send_request(options)
12849
+ end
12850
+
12081
12851
  # Modify a setting for an Amazon Aurora DB cluster. You can change one
12082
12852
  # or more database configuration parameters by specifying these
12083
12853
  # parameters and the new values in the request. For more information on
@@ -12872,12 +13642,14 @@ module Aws::RDS
12872
13642
  # `db.m4.large`. Not all DB instance classes are available in all Amazon
12873
13643
  # Web Services Regions, or for all database engines. For the full list
12874
13644
  # of DB instance classes, and availability for your engine, see [DB
12875
- # Instance Class][1] in the *Amazon RDS User Guide.*
13645
+ # Instance Class][1] in the *Amazon RDS User Guide*.
12876
13646
  #
12877
13647
  # If you modify the DB instance class, an outage occurs during the
12878
13648
  # change. The change is applied during the next maintenance window,
12879
13649
  # unless `ApplyImmediately` is enabled for this request.
12880
13650
  #
13651
+ # This setting doesn't apply to RDS Custom.
13652
+ #
12881
13653
  # Default: Uses existing setting
12882
13654
  #
12883
13655
  #
@@ -12889,12 +13661,14 @@ module Aws::RDS
12889
13661
  # parameter to move your DB instance to a different VPC. If your DB
12890
13662
  # instance isn't in a VPC, you can also use this parameter to move your
12891
13663
  # DB instance into a VPC. For more information, see [Working with a DB
12892
- # instance in a VPC][1] in the *Amazon RDS User Guide.*
13664
+ # instance in a VPC][1] in the *Amazon RDS User Guide*.
12893
13665
  #
12894
13666
  # Changing the subnet group causes an outage during the change. The
12895
13667
  # change is applied during the next maintenance window, unless you
12896
13668
  # enable `ApplyImmediately`.
12897
13669
  #
13670
+ # This parameter doesn't apply to RDS Custom.
13671
+ #
12898
13672
  # Constraints: If supplied, must match the name of an existing
12899
13673
  # DBSubnetGroup.
12900
13674
  #
@@ -12909,6 +13683,8 @@ module Aws::RDS
12909
13683
  # Changing this setting doesn't result in an outage and the change is
12910
13684
  # asynchronously applied as soon as possible.
12911
13685
  #
13686
+ # This setting doesn't apply to RDS Custom.
13687
+ #
12912
13688
  # Constraints:
12913
13689
  #
12914
13690
  # * If supplied, must match existing DBSecurityGroups.
@@ -12916,8 +13692,10 @@ module Aws::RDS
12916
13692
  # ^
12917
13693
  #
12918
13694
  # @option params [Array<String>] :vpc_security_group_ids
12919
- # A list of EC2 VPC security groups to authorize on this DB instance.
12920
- # This change is asynchronously applied as soon as possible.
13695
+ # A list of Amazon EC2 VPC security groups to authorize on this DB
13696
+ # instance. This change is asynchronously applied as soon as possible.
13697
+ #
13698
+ # This setting doesn't apply to RDS Custom.
12921
13699
  #
12922
13700
  # **Amazon Aurora**
12923
13701
  #
@@ -12959,6 +13737,8 @@ module Aws::RDS
12959
13737
  # element exists in the `PendingModifiedValues` element of the operation
12960
13738
  # response.
12961
13739
  #
13740
+ # This setting doesn't apply to RDS Custom.
13741
+ #
12962
13742
  # **Amazon Aurora**
12963
13743
  #
12964
13744
  # Not applicable. The password for the master user is managed by the DB
@@ -12995,17 +13775,22 @@ module Aws::RDS
12995
13775
  #
12996
13776
  # @option params [String] :db_parameter_group_name
12997
13777
  # The name of the DB parameter group to apply to the DB instance.
13778
+ #
12998
13779
  # Changing this setting doesn't result in an outage. The parameter
12999
13780
  # group name itself is changed immediately, but the actual parameter
13000
13781
  # changes are not applied until you reboot the instance without
13001
- # failover. In this case, the DB instance isn't rebooted automatically
13002
- # and the parameter changes isn't applied during the next maintenance
13003
- # window.
13782
+ # failover. In this case, the DB instance isn't rebooted automatically,
13783
+ # and the parameter changes aren't applied during the next maintenance
13784
+ # window. However, if you modify dynamic parameters in the newly
13785
+ # associated DB parameter group, these changes are applied immediately
13786
+ # without a reboot.
13787
+ #
13788
+ # This setting doesn't apply to RDS Custom.
13004
13789
  #
13005
13790
  # Default: Uses existing setting
13006
13791
  #
13007
13792
  # Constraints: The DB parameter group must be in the same DB parameter
13008
- # group family as this DB instance.
13793
+ # group family as the DB instance.
13009
13794
  #
13010
13795
  # @option params [Integer] :backup_retention_period
13011
13796
  # The number of days to retain automated backups. Setting this parameter
@@ -13032,15 +13817,15 @@ module Aws::RDS
13032
13817
  #
13033
13818
  # Constraints:
13034
13819
  #
13035
- # * Must be a value from 0 to 35
13820
+ # * It must be a value from 0 to 35. It can't be set to 0 if the DB
13821
+ # instance is a source to read replicas. It can't be set to 0 or 35
13822
+ # for an RDS Custom DB instance.
13036
13823
  #
13037
- # * Can be specified for a MySQL read replica only if the source is
13038
- # running MySQL 5.6 or later
13824
+ # * It can be specified for a MySQL read replica only if the source is
13825
+ # running MySQL 5.6 or later.
13039
13826
  #
13040
- # * Can be specified for a PostgreSQL read replica only if the source is
13041
- # running PostgreSQL 9.3.5
13042
- #
13043
- # * Can't be set to 0 if the DB instance is a source to read replicas
13827
+ # * It can be specified for a PostgreSQL read replica only if the source
13828
+ # is running PostgreSQL 9.3.5.
13044
13829
  #
13045
13830
  # @option params [String] :preferred_backup_window
13046
13831
  # The daily time range during which automated backups are created if
@@ -13099,10 +13884,12 @@ module Aws::RDS
13099
13884
  #
13100
13885
  # @option params [Boolean] :multi_az
13101
13886
  # A value that indicates whether the DB instance is a Multi-AZ
13102
- # deployment. Changing this parameter doesn't result in an outage and
13103
- # the change is applied during the next maintenance window unless the
13887
+ # deployment. Changing this parameter doesn't result in an outage. The
13888
+ # change is applied during the next maintenance window unless the
13104
13889
  # `ApplyImmediately` parameter is enabled for this request.
13105
13890
  #
13891
+ # This setting doesn't apply to RDS Custom.
13892
+ #
13106
13893
  # @option params [String] :engine_version
13107
13894
  # The version number of the database engine to upgrade to. Changing this
13108
13895
  # parameter results in an outage and the change is applied during the
@@ -13119,27 +13906,42 @@ module Aws::RDS
13119
13906
  # lower. For information about valid engine versions, see
13120
13907
  # `CreateDBInstance`, or call `DescribeDBEngineVersions`.
13121
13908
  #
13909
+ # In RDS Custom, this parameter is supported for read replicas only if
13910
+ # they are in the `PATCH_DB_FAILURE` lifecycle.
13911
+ #
13122
13912
  # @option params [Boolean] :allow_major_version_upgrade
13123
13913
  # A value that indicates whether major version upgrades are allowed.
13124
13914
  # Changing this parameter doesn't result in an outage and the change is
13125
13915
  # asynchronously applied as soon as possible.
13126
13916
  #
13917
+ # This setting doesn't apply to RDS Custom.
13918
+ #
13127
13919
  # Constraints: Major version upgrades must be allowed when specifying a
13128
13920
  # value for the EngineVersion parameter that is a different major
13129
13921
  # version than the DB instance's current version.
13130
13922
  #
13131
13923
  # @option params [Boolean] :auto_minor_version_upgrade
13132
13924
  # A value that indicates whether minor version upgrades are applied
13133
- # automatically to the DB instance during the maintenance window.
13134
- # Changing this parameter doesn't result in an outage except in the
13135
- # following case and the change is asynchronously applied as soon as
13136
- # possible. An outage results if this parameter is enabled during the
13137
- # maintenance window, and a newer minor version is available, and RDS
13138
- # has enabled auto patching for that engine version.
13925
+ # automatically to the DB instance during the maintenance window. An
13926
+ # outage occurs when all the following conditions are met:
13927
+ #
13928
+ # * The automatic upgrade is enabled for the maintenance window.
13929
+ #
13930
+ # * A newer minor version is available.
13931
+ #
13932
+ # * RDS has enabled automatic patching for the engine version.
13933
+ #
13934
+ # If any of the preceding conditions isn't met, RDS applies the change
13935
+ # as soon as possible and doesn't cause an outage.
13936
+ #
13937
+ # For an RDS Custom DB instance, set `AutoMinorVersionUpgrade` to
13938
+ # `false`. Otherwise, the operation returns an error.
13139
13939
  #
13140
13940
  # @option params [String] :license_model
13141
13941
  # The license model for the DB instance.
13142
13942
  #
13943
+ # This setting doesn't apply to RDS Custom.
13944
+ #
13143
13945
  # Valid values: `license-included` \| `bring-your-own-license` \|
13144
13946
  # `general-public-license`
13145
13947
  #
@@ -13178,18 +13980,23 @@ module Aws::RDS
13178
13980
  #
13179
13981
  # @option params [String] :option_group_name
13180
13982
  # A value that indicates the DB instance should be associated with the
13181
- # specified option group. Changing this parameter doesn't result in an
13182
- # outage except in the following case and the change is applied during
13183
- # the next maintenance window unless the `ApplyImmediately` parameter is
13184
- # enabled for this request. If the parameter change results in an option
13185
- # group that enables OEM, this change can cause a brief (sub-second)
13186
- # period during which new connections are rejected but existing
13187
- # connections are not interrupted.
13983
+ # specified option group.
13984
+ #
13985
+ # Changing this parameter doesn't result in an outage, with one
13986
+ # exception. If the parameter change results in an option group that
13987
+ # enables OEM, it can cause a brief period, lasting less than a second,
13988
+ # during which new connections are rejected but existing connections
13989
+ # aren't interrupted.
13990
+ #
13991
+ # The change is applied during the next maintenance window unless the
13992
+ # `ApplyImmediately` parameter is enabled for this request.
13188
13993
  #
13189
13994
  # Permanent options, such as the TDE option for Oracle Advanced Security
13190
13995
  # TDE, can't be removed from an option group, and that option group
13191
- # can't be removed from a DB instance once it is associated with a DB
13192
- # instance
13996
+ # can't be removed from a DB instance after it is associated with a DB
13997
+ # instance.
13998
+ #
13999
+ # This setting doesn't apply to RDS Custom.
13193
14000
  #
13194
14001
  # @option params [String] :new_db_instance_identifier
13195
14002
  # The new DB instance identifier for the DB instance when renaming a DB
@@ -13198,6 +14005,8 @@ module Aws::RDS
13198
14005
  # occur during the next maintenance window if you disable Apply
13199
14006
  # Immediately. This value is stored as a lowercase string.
13200
14007
  #
14008
+ # This setting doesn't apply to RDS Custom.
14009
+ #
13201
14010
  # Constraints:
13202
14011
  #
13203
14012
  # * Must contain from 1 to 63 letters, numbers, or hyphens.
@@ -13237,24 +14046,31 @@ module Aws::RDS
13237
14046
  # The ARN from the key store with which to associate the instance for
13238
14047
  # TDE encryption.
13239
14048
  #
14049
+ # This setting doesn't apply to RDS Custom.
14050
+ #
13240
14051
  # @option params [String] :tde_credential_password
13241
14052
  # The password for the given ARN from the key store in order to access
13242
14053
  # the device.
13243
14054
  #
14055
+ # This setting doesn't apply to RDS Custom.
14056
+ #
13244
14057
  # @option params [String] :ca_certificate_identifier
13245
- # Indicates the certificate that needs to be associated with the
13246
- # instance.
14058
+ # Specifies the certificate to associate with the DB instance.
14059
+ #
14060
+ # This setting doesn't apply to RDS Custom.
13247
14061
  #
13248
14062
  # @option params [String] :domain
13249
14063
  # The Active Directory directory ID to move the DB instance to. Specify
13250
- # `none` to remove the instance from its current domain. The domain must
13251
- # be created prior to this operation. Currently, only MySQL, Microsoft
13252
- # SQL Server, Oracle, and PostgreSQL DB instances can be created in an
14064
+ # `none` to remove the instance from its current domain. You must create
14065
+ # the domain before this operation. Currently, you can create only
14066
+ # MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances in an
13253
14067
  # Active Directory Domain.
13254
14068
  #
13255
14069
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
13256
14070
  # RDS User Guide*.
13257
14071
  #
14072
+ # This setting doesn't apply to RDS Custom.
14073
+ #
13258
14074
  #
13259
14075
  #
13260
14076
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -13272,10 +14088,12 @@ module Aws::RDS
13272
14088
  # @option params [Integer] :monitoring_interval
13273
14089
  # The interval, in seconds, between points when Enhanced Monitoring
13274
14090
  # metrics are collected for the DB instance. To disable collecting
13275
- # Enhanced Monitoring metrics, specify 0. The default is 0.
14091
+ # Enhanced Monitoring metrics, specify 0, which is the default.
13276
14092
  #
13277
- # If `MonitoringRoleArn` is specified, then you must also set
13278
- # `MonitoringInterval` to a value other than 0.
14093
+ # If `MonitoringRoleArn` is specified, set `MonitoringInterval` to a
14094
+ # value other than 0.
14095
+ #
14096
+ # This setting doesn't apply to RDS Custom.
13279
14097
  #
13280
14098
  # Valid Values: `0, 1, 5, 10, 15, 30, 60`
13281
14099
  #
@@ -13286,9 +14104,11 @@ module Aws::RDS
13286
14104
  # port values specified for options in the option group for the DB
13287
14105
  # instance.
13288
14106
  #
13289
- # Your database will restart when you change the `DBPortNumber` value
14107
+ # If you change the `DBPortNumber` value, your database restarts
13290
14108
  # regardless of the value of the `ApplyImmediately` parameter.
13291
14109
  #
14110
+ # This setting doesn't apply to RDS Custom.
14111
+ #
13292
14112
  # **MySQL**
13293
14113
  #
13294
14114
  # Default: `3306`
@@ -13348,15 +14168,19 @@ module Aws::RDS
13348
14168
  # Changes to the `PubliclyAccessible` parameter are applied immediately
13349
14169
  # regardless of the value of the `ApplyImmediately` parameter.
13350
14170
  #
14171
+ # This setting doesn't apply to RDS Custom.
14172
+ #
13351
14173
  # @option params [String] :monitoring_role_arn
13352
14174
  # The ARN for the IAM role that permits RDS to send enhanced monitoring
13353
14175
  # metrics to Amazon CloudWatch Logs. For example,
13354
14176
  # `arn:aws:iam:123456789012:role/emaccess`. For information on creating
13355
- # a monitoring role, go to [To create an IAM role for Amazon RDS
13356
- # Enhanced Monitoring][1] in the *Amazon RDS User Guide.*
14177
+ # a monitoring role, see [To create an IAM role for Amazon RDS Enhanced
14178
+ # Monitoring][1] in the *Amazon RDS User Guide.*
13357
14179
  #
13358
- # If `MonitoringInterval` is set to a value other than 0, then you must
13359
- # supply a `MonitoringRoleArn` value.
14180
+ # If `MonitoringInterval` is set to a value other than 0, supply a
14181
+ # `MonitoringRoleArn` value.
14182
+ #
14183
+ # This setting doesn't apply to RDS Custom.
13360
14184
  #
13361
14185
  #
13362
14186
  #
@@ -13366,12 +14190,16 @@ module Aws::RDS
13366
14190
  # The name of the IAM role to use when making API calls to the Directory
13367
14191
  # Service.
13368
14192
  #
14193
+ # This setting doesn't apply to RDS Custom.
14194
+ #
13369
14195
  # @option params [Integer] :promotion_tier
13370
14196
  # A value that specifies the order in which an Aurora Replica is
13371
14197
  # promoted to the primary instance after a failure of the existing
13372
14198
  # primary instance. For more information, see [ Fault Tolerance for an
13373
14199
  # Aurora DB Cluster][1] in the *Amazon Aurora User Guide*.
13374
14200
  #
14201
+ # This setting doesn't apply to RDS Custom.
14202
+ #
13375
14203
  # Default: 1
13376
14204
  #
13377
14205
  # Valid Values: 0 - 15
@@ -13393,6 +14221,8 @@ module Aws::RDS
13393
14221
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
13394
14222
  # RDS User Guide.*
13395
14223
  #
14224
+ # This setting doesn't apply to RDS Custom.
14225
+ #
13396
14226
  #
13397
14227
  #
13398
14228
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
@@ -13404,6 +14234,8 @@ module Aws::RDS
13404
14234
  # For more information, see [Using Amazon Performance Insights][1] in
13405
14235
  # the *Amazon Relational Database Service User Guide*.
13406
14236
  #
14237
+ # This setting doesn't apply to RDS Custom.
14238
+ #
13407
14239
  #
13408
14240
  #
13409
14241
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html
@@ -13413,18 +14245,21 @@ module Aws::RDS
13413
14245
  # Performance Insights data.
13414
14246
  #
13415
14247
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
13416
- # alias ARN, or alias name for the Amazon Web Services KMS customer
13417
- # master key (CMK).
14248
+ # alias ARN, or alias name for the KMS key.
13418
14249
  #
13419
14250
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
13420
- # Amazon RDS uses your default CMK. There is a default CMK for your
13421
- # Amazon Web Services account. Your Amazon Web Services account has a
13422
- # different default CMK for each Amazon Web Services Region.
14251
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
14252
+ # your Amazon Web Services account. Your Amazon Web Services account has
14253
+ # a different default KMS key for each Amazon Web Services Region.
14254
+ #
14255
+ # This setting doesn't apply to RDS Custom.
13423
14256
  #
13424
14257
  # @option params [Integer] :performance_insights_retention_period
13425
14258
  # The amount of time, in days, to retain Performance Insights data.
13426
14259
  # Valid values are 7 or 731 (2 years).
13427
14260
  #
14261
+ # This setting doesn't apply to RDS Custom.
14262
+ #
13428
14263
  # @option params [Types::CloudwatchLogsExportConfiguration] :cloudwatch_logs_export_configuration
13429
14264
  # The configuration setting for the log types to be enabled for export
13430
14265
  # to CloudWatch Logs for a specific DB instance.
@@ -13433,14 +14268,20 @@ module Aws::RDS
13433
14268
  # always applied to the DB instance immediately. Therefore, the
13434
14269
  # `ApplyImmediately` parameter has no effect.
13435
14270
  #
14271
+ # This setting doesn't apply to RDS Custom.
14272
+ #
13436
14273
  # @option params [Array<Types::ProcessorFeature>] :processor_features
13437
14274
  # The number of CPU cores and the number of threads per core for the DB
13438
14275
  # instance class of the DB instance.
13439
14276
  #
14277
+ # This setting doesn't apply to RDS Custom.
14278
+ #
13440
14279
  # @option params [Boolean] :use_default_processor_features
13441
14280
  # A value that indicates whether the DB instance class of the DB
13442
14281
  # instance uses its default processor features.
13443
14282
  #
14283
+ # This setting doesn't apply to RDS Custom.
14284
+ #
13444
14285
  # @option params [Boolean] :deletion_protection
13445
14286
  # A value that indicates whether the DB instance has deletion protection
13446
14287
  # enabled. The database can't be deleted when deletion protection is
@@ -13459,6 +14300,8 @@ module Aws::RDS
13459
14300
  # apply to it, see [ Managing capacity automatically with Amazon RDS
13460
14301
  # storage autoscaling][1] in the *Amazon RDS User Guide*.
13461
14302
  #
14303
+ # This setting doesn't apply to RDS Custom.
14304
+ #
13462
14305
  #
13463
14306
  #
13464
14307
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -13486,6 +14329,8 @@ module Aws::RDS
13486
14329
  # Aurora DB engines, see [ Rotating Your SSL/TLS Certificate][2] in
13487
14330
  # the *Amazon Aurora User Guide.*
13488
14331
  #
14332
+ # This setting doesn't apply to RDS Custom.
14333
+ #
13489
14334
  #
13490
14335
  #
13491
14336
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL-certificate-rotation.html
@@ -13507,6 +14352,8 @@ module Aws::RDS
13507
14352
  # more information, see [Working with Oracle Read Replicas for Amazon
13508
14353
  # RDS][1] in the *Amazon RDS User Guide*.
13509
14354
  #
14355
+ # This setting doesn't apply to RDS Custom.
14356
+ #
13510
14357
  #
13511
14358
  #
13512
14359
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/oracle-read-replicas.html
@@ -13536,6 +14383,19 @@ module Aws::RDS
13536
14383
  # The Amazon Resource Name (ARN) of the recovery point in Amazon Web
13537
14384
  # Services Backup.
13538
14385
  #
14386
+ # This setting doesn't apply to RDS Custom.
14387
+ #
14388
+ # @option params [String] :automation_mode
14389
+ # The automation mode of the RDS Custom DB instance: `full` or `all
14390
+ # paused`. If `full`, the DB instance automates monitoring and instance
14391
+ # recovery. If `all paused`, the instance pauses automation for the
14392
+ # duration set by `ResumeFullAutomationModeMinutes`.
14393
+ #
14394
+ # @option params [Integer] :resume_full_automation_mode_minutes
14395
+ # The number of minutes to pause the automation. When the time period
14396
+ # ends, RDS Custom resumes full automation. The minimum value is `60`
14397
+ # (default). The maximum value is `1,440`.
14398
+ #
13539
14399
  # @return [Types::ModifyDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
13540
14400
  #
13541
14401
  # * {Types::ModifyDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -13618,6 +14478,8 @@ module Aws::RDS
13618
14478
  # replica_mode: "open-read-only", # accepts open-read-only, mounted
13619
14479
  # enable_customer_owned_ip: false,
13620
14480
  # aws_backup_recovery_point_arn: "AwsBackupRecoveryPointArn",
14481
+ # automation_mode: "full", # accepts full, all-paused
14482
+ # resume_full_automation_mode_minutes: 1,
13621
14483
  # })
13622
14484
  #
13623
14485
  # @example Response structure
@@ -13678,6 +14540,8 @@ module Aws::RDS
13678
14540
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
13679
14541
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
13680
14542
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
14543
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
14544
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
13681
14545
  # resp.db_instance.latest_restorable_time #=> Time
13682
14546
  # resp.db_instance.multi_az #=> Boolean
13683
14547
  # resp.db_instance.engine_version #=> String
@@ -13752,6 +14616,9 @@ module Aws::RDS
13752
14616
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
13753
14617
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
13754
14618
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
14619
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
14620
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
14621
+ # resp.db_instance.custom_iam_instance_profile #=> String
13755
14622
  #
13756
14623
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstance AWS API Documentation
13757
14624
  #
@@ -14092,8 +14959,8 @@ module Aws::RDS
14092
14959
  # Updates a manual DB snapshot with a new engine version. The snapshot
14093
14960
  # can be encrypted or unencrypted, but not shared or public.
14094
14961
  #
14095
- # Amazon RDS supports upgrading DB snapshots for MySQL, Oracle, and
14096
- # PostgreSQL.
14962
+ # Amazon RDS supports upgrading DB snapshots for MySQL, PostgreSQL, and
14963
+ # Oracle. This command doesn't apply to RDS Custom.
14097
14964
  #
14098
14965
  # @option params [required, String] :db_snapshot_identifier
14099
14966
  # The identifier of the DB snapshot to modify.
@@ -14742,7 +15609,8 @@ module Aws::RDS
14742
15609
  # on your read replica, configure the automated backup window so that
14743
15610
  # daily backups do not interfere with read replica promotion.
14744
15611
  #
14745
- # * This command doesn't apply to Aurora MySQL and Aurora PostgreSQL.
15612
+ # * This command doesn't apply to Aurora MySQL, Aurora PostgreSQL, or
15613
+ # RDS Custom.
14746
15614
  #
14747
15615
  # </note>
14748
15616
  #
@@ -14882,6 +15750,8 @@ module Aws::RDS
14882
15750
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
14883
15751
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
14884
15752
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
15753
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
15754
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
14885
15755
  # resp.db_instance.latest_restorable_time #=> Time
14886
15756
  # resp.db_instance.multi_az #=> Boolean
14887
15757
  # resp.db_instance.engine_version #=> String
@@ -14956,6 +15826,9 @@ module Aws::RDS
14956
15826
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
14957
15827
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
14958
15828
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
15829
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
15830
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
15831
+ # resp.db_instance.custom_iam_instance_profile #=> String
14959
15832
  #
14960
15833
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplica AWS API Documentation
14961
15834
  #
@@ -15197,6 +16070,8 @@ module Aws::RDS
15197
16070
  # For more information about rebooting, see [Rebooting a DB Instance][1]
15198
16071
  # in the *Amazon RDS User Guide.*
15199
16072
  #
16073
+ # This command doesn't apply to RDS Custom.
16074
+ #
15200
16075
  #
15201
16076
  #
15202
16077
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RebootInstance.html
@@ -15303,6 +16178,8 @@ module Aws::RDS
15303
16178
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
15304
16179
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
15305
16180
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
16181
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
16182
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
15306
16183
  # resp.db_instance.latest_restorable_time #=> Time
15307
16184
  # resp.db_instance.multi_az #=> Boolean
15308
16185
  # resp.db_instance.engine_version #=> String
@@ -15377,6 +16254,9 @@ module Aws::RDS
15377
16254
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
15378
16255
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
15379
16256
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
16257
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
16258
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
16259
+ # resp.db_instance.custom_iam_instance_profile #=> String
15380
16260
  #
15381
16261
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RebootDBInstance AWS API Documentation
15382
16262
  #
@@ -15520,7 +16400,7 @@ module Aws::RDS
15520
16400
  #
15521
16401
  # @option params [String] :feature_name
15522
16402
  # The name of the feature for the DB cluster that the IAM role is to be
15523
- # disassociated from. For the list of supported feature names, see
16403
+ # disassociated from. For information about supported feature names, see
15524
16404
  # DBEngineVersion.
15525
16405
  #
15526
16406
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -15555,7 +16435,7 @@ module Aws::RDS
15555
16435
  #
15556
16436
  # @option params [required, String] :feature_name
15557
16437
  # The name of the feature for the DB instance that the IAM role is to be
15558
- # disassociated from. For the list of supported feature names, see
16438
+ # disassociated from. For information about supported feature names, see
15559
16439
  # `DBEngineVersion`.
15560
16440
  #
15561
16441
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
@@ -16102,15 +16982,15 @@ module Aws::RDS
16102
16982
  # cluster.
16103
16983
  #
16104
16984
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
16105
- # alias ARN, or alias name for the Amazon Web Services KMS customer
16106
- # master key (CMK). To use a CMK in a different Amazon Web Services
16107
- # account, specify the key ARN or alias ARN.
16985
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
16986
+ # different Amazon Web Services account, specify the key ARN or alias
16987
+ # ARN.
16108
16988
  #
16109
16989
  # If the StorageEncrypted parameter is enabled, and you do not specify a
16110
16990
  # value for the `KmsKeyId` parameter, then Amazon RDS will use your
16111
- # default CMK. There is a default CMK for your Amazon Web Services
16112
- # account. Your Amazon Web Services account has a different default CMK
16113
- # for each Amazon Web Services Region.
16991
+ # default KMS key. There is a default KMS key for your Amazon Web
16992
+ # Services account. Your Amazon Web Services account has a different
16993
+ # default KMS key for each Amazon Web Services Region.
16114
16994
  #
16115
16995
  # @option params [Boolean] :enable_iam_database_authentication
16116
16996
  # A value that indicates whether to enable mapping of Amazon Web
@@ -16486,17 +17366,16 @@ module Aws::RDS
16486
17366
  # encrypted DB cluster from a DB snapshot or DB cluster snapshot.
16487
17367
  #
16488
17368
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
16489
- # alias ARN, or alias name for the Amazon Web Services KMS customer
16490
- # master key (CMK). To use a CMK in a different Amazon Web Services
16491
- # account, specify the key ARN or alias ARN.
17369
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
17370
+ # different Amazon Web Services account, specify the key ARN or alias
17371
+ # ARN.
16492
17372
  #
16493
17373
  # When you don't specify a value for the `KmsKeyId` parameter, then the
16494
17374
  # following occurs:
16495
17375
  #
16496
17376
  # * If the DB snapshot or DB cluster snapshot in `SnapshotIdentifier` is
16497
- # encrypted, then the restored DB cluster is encrypted using the
16498
- # Amazon Web Services KMS CMK that was used to encrypt the DB snapshot
16499
- # or DB cluster snapshot.
17377
+ # encrypted, then the restored DB cluster is encrypted using the KMS
17378
+ # key that was used to encrypt the DB snapshot or DB cluster snapshot.
16500
17379
  #
16501
17380
  # * If the DB snapshot or DB cluster snapshot in `SnapshotIdentifier`
16502
17381
  # isn't encrypted, then the restored DB cluster isn't encrypted.
@@ -16885,22 +17764,21 @@ module Aws::RDS
16885
17764
  # encrypted DB cluster from an encrypted DB cluster.
16886
17765
  #
16887
17766
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
16888
- # alias ARN, or alias name for the Amazon Web Services KMS customer
16889
- # master key (CMK). To use a CMK in a different Amazon Web Services
16890
- # account, specify the key ARN or alias ARN.
17767
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
17768
+ # different Amazon Web Services account, specify the key ARN or alias
17769
+ # ARN.
16891
17770
  #
16892
17771
  # You can restore to a new DB cluster and encrypt the new DB cluster
16893
- # with a Amazon Web Services KMS CMK that is different than the Amazon
16894
- # Web Services KMS key used to encrypt the source DB cluster. The new DB
16895
- # cluster is encrypted with the Amazon Web Services KMS CMK identified
16896
- # by the `KmsKeyId` parameter.
17772
+ # with a KMS key that is different from the KMS key used to encrypt the
17773
+ # source DB cluster. The new DB cluster is encrypted with the KMS key
17774
+ # identified by the `KmsKeyId` parameter.
16897
17775
  #
16898
17776
  # If you don't specify a value for the `KmsKeyId` parameter, then the
16899
17777
  # following occurs:
16900
17778
  #
16901
17779
  # * If the DB cluster is encrypted, then the restored DB cluster is
16902
- # encrypted using the Amazon Web Services KMS CMK that was used to
16903
- # encrypt the source DB cluster.
17780
+ # encrypted using the KMS key that was used to encrypt the source DB
17781
+ # cluster.
16904
17782
  #
16905
17783
  # * If the DB cluster isn't encrypted, then the restored DB cluster
16906
17784
  # isn't encrypted.
@@ -17256,6 +18134,8 @@ module Aws::RDS
17256
18134
  # A value that indicates whether the DB instance is a Multi-AZ
17257
18135
  # deployment.
17258
18136
  #
18137
+ # This setting doesn't apply to RDS Custom.
18138
+ #
17259
18139
  # Constraint: You can't specify the `AvailabilityZone` parameter if the
17260
18140
  # DB instance is a Multi-AZ deployment.
17261
18141
  #
@@ -17278,9 +18158,14 @@ module Aws::RDS
17278
18158
  # A value that indicates whether minor version upgrades are applied
17279
18159
  # automatically to the DB instance during the maintenance window.
17280
18160
  #
18161
+ # If you restore an RDS Custom DB instance, you must disable this
18162
+ # parameter.
18163
+ #
17281
18164
  # @option params [String] :license_model
17282
18165
  # License model information for the restored DB instance.
17283
18166
  #
18167
+ # This setting doesn't apply to RDS Custom.
18168
+ #
17284
18169
  # Default: Same as source.
17285
18170
  #
17286
18171
  # Valid values: `license-included` \| `bring-your-own-license` \|
@@ -17289,14 +18174,14 @@ module Aws::RDS
17289
18174
  # @option params [String] :db_name
17290
18175
  # The database name for the restored DB instance.
17291
18176
  #
17292
- # <note markdown="1"> This parameter doesn't apply to the MySQL, PostgreSQL, or MariaDB
17293
- # engines.
17294
- #
17295
- # </note>
18177
+ # This parameter doesn't apply to the MySQL, PostgreSQL, or MariaDB
18178
+ # engines. It also doesn't apply to RDS Custom DB instances.
17296
18179
  #
17297
18180
  # @option params [String] :engine
17298
18181
  # The database engine to use for the new instance.
17299
18182
  #
18183
+ # This setting doesn't apply to RDS Custom.
18184
+ #
17300
18185
  # Default: The same as source
17301
18186
  #
17302
18187
  # Constraint: Must be compatible with the engine of the source. For
@@ -17351,8 +18236,10 @@ module Aws::RDS
17351
18236
  #
17352
18237
  # Permanent options, such as the TDE option for Oracle Advanced Security
17353
18238
  # TDE, can't be removed from an option group, and that option group
17354
- # can't be removed from a DB instance once it is associated with a DB
17355
- # instance
18239
+ # can't be removed from a DB instance after it is associated with a DB
18240
+ # instance.
18241
+ #
18242
+ # This setting doesn't apply to RDS Custom.
17356
18243
  #
17357
18244
  # @option params [Array<Types::Tag>] :tags
17358
18245
  # A list of tags. For more information, see [Tagging Amazon RDS
@@ -17376,10 +18263,14 @@ module Aws::RDS
17376
18263
  # The ARN from the key store with which to associate the instance for
17377
18264
  # TDE encryption.
17378
18265
  #
18266
+ # This setting doesn't apply to RDS Custom.
18267
+ #
17379
18268
  # @option params [String] :tde_credential_password
17380
18269
  # The password for the given ARN from the key store in order to access
17381
18270
  # the device.
17382
18271
  #
18272
+ # This setting doesn't apply to RDS Custom.
18273
+ #
17383
18274
  # @option params [Array<String>] :vpc_security_group_ids
17384
18275
  # A list of EC2 VPC security groups to associate with this DB instance.
17385
18276
  #
@@ -17388,13 +18279,15 @@ module Aws::RDS
17388
18279
  #
17389
18280
  # @option params [String] :domain
17390
18281
  # Specify the Active Directory directory ID to restore the DB instance
17391
- # in. The domain must be created prior to this operation. Currently,
17392
- # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
17393
- # can be created in an Active Directory Domain.
18282
+ # in. The domain/ must be created prior to this operation. Currently,
18283
+ # you can create only MySQL, Microsoft SQL Server, Oracle, and
18284
+ # PostgreSQL DB instances in an Active Directory Domain.
17394
18285
  #
17395
18286
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
17396
18287
  # RDS User Guide*.
17397
18288
  #
18289
+ # This setting doesn't apply to RDS Custom.
18290
+ #
17398
18291
  #
17399
18292
  #
17400
18293
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -17408,6 +18301,8 @@ module Aws::RDS
17408
18301
  # Specify the name of the IAM role to be used when making API calls to
17409
18302
  # the Directory Service.
17410
18303
  #
18304
+ # This setting doesn't apply to RDS Custom.
18305
+ #
17411
18306
  # @option params [Boolean] :enable_iam_database_authentication
17412
18307
  # A value that indicates whether to enable mapping of Amazon Web
17413
18308
  # Services Identity and Access Management (IAM) accounts to database
@@ -17417,6 +18312,8 @@ module Aws::RDS
17417
18312
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
17418
18313
  # RDS User Guide.*
17419
18314
  #
18315
+ # This setting doesn't apply to RDS Custom.
18316
+ #
17420
18317
  #
17421
18318
  #
17422
18319
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
@@ -17427,6 +18324,8 @@ module Aws::RDS
17427
18324
  # used. For more information, see [Publishing Database Logs to Amazon
17428
18325
  # CloudWatch Logs][1] in the *Amazon RDS User Guide*.
17429
18326
  #
18327
+ # This setting doesn't apply to RDS Custom.
18328
+ #
17430
18329
  #
17431
18330
  #
17432
18331
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -17435,15 +18334,21 @@ module Aws::RDS
17435
18334
  # The number of CPU cores and the number of threads per core for the DB
17436
18335
  # instance class of the DB instance.
17437
18336
  #
18337
+ # This setting doesn't apply to RDS Custom.
18338
+ #
17438
18339
  # @option params [Boolean] :use_default_processor_features
17439
18340
  # A value that indicates whether the DB instance class of the DB
17440
18341
  # instance uses its default processor features.
17441
18342
  #
18343
+ # This setting doesn't apply to RDS Custom.
18344
+ #
17442
18345
  # @option params [String] :db_parameter_group_name
17443
18346
  # The name of the DB parameter group to associate with this DB instance.
17444
18347
  #
17445
- # If you do not specify a value for `DBParameterGroupName`, then the
17446
- # default `DBParameterGroup` for the specified DB engine is used.
18348
+ # If you don't specify a value for `DBParameterGroupName`, then RDS
18349
+ # uses the default `DBParameterGroup` for the specified DB engine.
18350
+ #
18351
+ # This setting doesn't apply to RDS Custom.
17447
18352
  #
17448
18353
  # Constraints:
17449
18354
  #
@@ -17474,6 +18379,8 @@ module Aws::RDS
17474
18379
  # a CoIP can provide lower latency for connections to the DB instance
17475
18380
  # from outside of its virtual private cloud (VPC) on your local network.
17476
18381
  #
18382
+ # This setting doesn't apply to RDS Custom.
18383
+ #
17477
18384
  # For more information about RDS on Outposts, see [Working with Amazon
17478
18385
  # RDS on Amazon Web Services Outposts][1] in the *Amazon RDS User
17479
18386
  # Guide*.
@@ -17486,6 +18393,29 @@ module Aws::RDS
17486
18393
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
17487
18394
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
17488
18395
  #
18396
+ # @option params [String] :custom_iam_instance_profile
18397
+ # The instance profile associated with the underlying Amazon EC2
18398
+ # instance of an RDS Custom DB instance. The instance profile must meet
18399
+ # the following requirements:
18400
+ #
18401
+ # * The profile must exist in your account.
18402
+ #
18403
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
18404
+ # assume.
18405
+ #
18406
+ # * The instance profile name and the associated IAM role name must
18407
+ # start with the prefix `AWSRDSCustom`.
18408
+ #
18409
+ # For the list of permissions required for the IAM role, see [ Configure
18410
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
18411
+ # Guide*.
18412
+ #
18413
+ # This setting is required for RDS Custom.
18414
+ #
18415
+ #
18416
+ #
18417
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
18418
+ #
17489
18419
  # @return [Types::RestoreDBInstanceFromDBSnapshotResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
17490
18420
  #
17491
18421
  # * {Types::RestoreDBInstanceFromDBSnapshotResult#db_instance #db_instance} => Types::DBInstance
@@ -17627,6 +18557,7 @@ module Aws::RDS
17627
18557
  # db_parameter_group_name: "String",
17628
18558
  # deletion_protection: false,
17629
18559
  # enable_customer_owned_ip: false,
18560
+ # custom_iam_instance_profile: "String",
17630
18561
  # })
17631
18562
  #
17632
18563
  # @example Response structure
@@ -17687,6 +18618,8 @@ module Aws::RDS
17687
18618
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
17688
18619
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
17689
18620
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
18621
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
18622
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
17690
18623
  # resp.db_instance.latest_restorable_time #=> Time
17691
18624
  # resp.db_instance.multi_az #=> Boolean
17692
18625
  # resp.db_instance.engine_version #=> String
@@ -17761,6 +18694,9 @@ module Aws::RDS
17761
18694
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
17762
18695
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
17763
18696
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
18697
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
18698
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
18699
+ # resp.db_instance.custom_iam_instance_profile #=> String
17764
18700
  #
17765
18701
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshot AWS API Documentation
17766
18702
  #
@@ -17778,6 +18714,8 @@ module Aws::RDS
17778
18714
  # instance running MySQL. For more information, see [Importing Data into
17779
18715
  # an Amazon RDS MySQL DB Instance][1] in the *Amazon RDS User Guide.*
17780
18716
  #
18717
+ # This command doesn't apply to RDS Custom.
18718
+ #
17781
18719
  #
17782
18720
  #
17783
18721
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/MySQL.Procedural.Importing.html
@@ -18013,15 +18951,15 @@ module Aws::RDS
18013
18951
  # instance.
18014
18952
  #
18015
18953
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
18016
- # alias ARN, or alias name for the Amazon Web Services KMS customer
18017
- # master key (CMK). To use a CMK in a different Amazon Web Services
18018
- # account, specify the key ARN or alias ARN.
18954
+ # alias ARN, or alias name for the KMS key. To use a KMS key in a
18955
+ # different Amazon Web Services account, specify the key ARN or alias
18956
+ # ARN.
18019
18957
  #
18020
18958
  # If the `StorageEncrypted` parameter is enabled, and you do not specify
18021
18959
  # a value for the `KmsKeyId` parameter, then Amazon RDS will use your
18022
- # default CMK. There is a default CMK for your Amazon Web Services
18023
- # account. Your Amazon Web Services account has a different default CMK
18024
- # for each Amazon Web Services Region.
18960
+ # default KMS key. There is a default KMS key for your Amazon Web
18961
+ # Services account. Your Amazon Web Services account has a different
18962
+ # default KMS key for each Amazon Web Services Region.
18025
18963
  #
18026
18964
  # @option params [Boolean] :copy_tags_to_snapshot
18027
18965
  # A value that indicates whether to copy all tags from the DB instance
@@ -18105,13 +19043,12 @@ module Aws::RDS
18105
19043
  # Performance Insights data.
18106
19044
  #
18107
19045
  # The Amazon Web Services KMS key identifier is the key ARN, key ID,
18108
- # alias ARN, or alias name for the Amazon Web Services KMS customer
18109
- # master key (CMK).
19046
+ # alias ARN, or alias name for the KMS key.
18110
19047
  #
18111
19048
  # If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
18112
- # Amazon RDS uses your default CMK. There is a default CMK for your
18113
- # Amazon Web Services account. Your Amazon Web Services account has a
18114
- # different default CMK for each Amazon Web Services Region.
19049
+ # Amazon RDS uses your default KMS key. There is a default KMS key for
19050
+ # your Amazon Web Services account. Your Amazon Web Services account has
19051
+ # a different default KMS key for each Amazon Web Services Region.
18115
19052
  #
18116
19053
  # @option params [Integer] :performance_insights_retention_period
18117
19054
  # The amount of time, in days, to retain Performance Insights data.
@@ -18278,6 +19215,8 @@ module Aws::RDS
18278
19215
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
18279
19216
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
18280
19217
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
19218
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
19219
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
18281
19220
  # resp.db_instance.latest_restorable_time #=> Time
18282
19221
  # resp.db_instance.multi_az #=> Boolean
18283
19222
  # resp.db_instance.engine_version #=> String
@@ -18352,6 +19291,9 @@ module Aws::RDS
18352
19291
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
18353
19292
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
18354
19293
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
19294
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
19295
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
19296
+ # resp.db_instance.custom_iam_instance_profile #=> String
18355
19297
  #
18356
19298
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromS3 AWS API Documentation
18357
19299
  #
@@ -18466,6 +19408,8 @@ module Aws::RDS
18466
19408
  # A value that indicates whether the DB instance is a Multi-AZ
18467
19409
  # deployment.
18468
19410
  #
19411
+ # This setting doesn't apply to RDS Custom.
19412
+ #
18469
19413
  # Constraint: You can't specify the `AvailabilityZone` parameter if the
18470
19414
  # DB instance is a Multi-AZ deployment.
18471
19415
  #
@@ -18488,9 +19432,13 @@ module Aws::RDS
18488
19432
  # A value that indicates whether minor version upgrades are applied
18489
19433
  # automatically to the DB instance during the maintenance window.
18490
19434
  #
19435
+ # This setting doesn't apply to RDS Custom.
19436
+ #
18491
19437
  # @option params [String] :license_model
18492
19438
  # License model information for the restored DB instance.
18493
19439
  #
19440
+ # This setting doesn't apply to RDS Custom.
19441
+ #
18494
19442
  # Default: Same as source.
18495
19443
  #
18496
19444
  # Valid values: `license-included` \| `bring-your-own-license` \|
@@ -18499,13 +19447,16 @@ module Aws::RDS
18499
19447
  # @option params [String] :db_name
18500
19448
  # The database name for the restored DB instance.
18501
19449
  #
18502
- # <note markdown="1"> This parameter isn't used for the MySQL or MariaDB engines.
19450
+ # <note markdown="1"> This parameter isn't supported for the MySQL or MariaDB engines. It
19451
+ # also doesn't apply to RDS Custom.
18503
19452
  #
18504
19453
  # </note>
18505
19454
  #
18506
19455
  # @option params [String] :engine
18507
19456
  # The database engine to use for the new instance.
18508
19457
  #
19458
+ # This setting doesn't apply to RDS Custom.
19459
+ #
18509
19460
  # Default: The same as source
18510
19461
  #
18511
19462
  # Constraint: Must be compatible with the engine of the source
@@ -18550,9 +19501,11 @@ module Aws::RDS
18550
19501
  #
18551
19502
  # Permanent options, such as the TDE option for Oracle Advanced Security
18552
19503
  # TDE, can't be removed from an option group, and that option group
18553
- # can't be removed from a DB instance once it is associated with a DB
19504
+ # can't be removed from a DB instance after it is associated with a DB
18554
19505
  # instance
18555
19506
  #
19507
+ # This setting doesn't apply to RDS Custom.
19508
+ #
18556
19509
  # @option params [Boolean] :copy_tags_to_snapshot
18557
19510
  # A value that indicates whether to copy all tags from the restored DB
18558
19511
  # instance to snapshots of the DB instance. By default, tags are not
@@ -18580,10 +19533,14 @@ module Aws::RDS
18580
19533
  # The ARN from the key store with which to associate the instance for
18581
19534
  # TDE encryption.
18582
19535
  #
19536
+ # This setting doesn't apply to RDS Custom.
19537
+ #
18583
19538
  # @option params [String] :tde_credential_password
18584
19539
  # The password for the given ARN from the key store in order to access
18585
19540
  # the device.
18586
19541
  #
19542
+ # This setting doesn't apply to RDS Custom.
19543
+ #
18587
19544
  # @option params [Array<String>] :vpc_security_group_ids
18588
19545
  # A list of EC2 VPC security groups to associate with this DB instance.
18589
19546
  #
@@ -18592,9 +19549,11 @@ module Aws::RDS
18592
19549
  #
18593
19550
  # @option params [String] :domain
18594
19551
  # Specify the Active Directory directory ID to restore the DB instance
18595
- # in. The domain must be created prior to this operation. Currently,
18596
- # only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB instances
18597
- # can be created in an Active Directory Domain.
19552
+ # in. Create the domain before running this command. Currently, you can
19553
+ # create only the MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
19554
+ # instances in an Active Directory Domain.
19555
+ #
19556
+ # This setting doesn't apply to RDS Custom.
18598
19557
  #
18599
19558
  # For more information, see [ Kerberos Authentication][1] in the *Amazon
18600
19559
  # RDS User Guide*.
@@ -18607,11 +19566,15 @@ module Aws::RDS
18607
19566
  # Specify the name of the IAM role to be used when making API calls to
18608
19567
  # the Directory Service.
18609
19568
  #
19569
+ # This setting doesn't apply to RDS Custom.
19570
+ #
18610
19571
  # @option params [Boolean] :enable_iam_database_authentication
18611
19572
  # A value that indicates whether to enable mapping of Amazon Web
18612
19573
  # Services Identity and Access Management (IAM) accounts to database
18613
19574
  # accounts. By default, mapping is disabled.
18614
19575
  #
19576
+ # This setting doesn't apply to RDS Custom.
19577
+ #
18615
19578
  # For more information about IAM database authentication, see [ IAM
18616
19579
  # Database Authentication for MySQL and PostgreSQL][1] in the *Amazon
18617
19580
  # RDS User Guide.*
@@ -18626,6 +19589,8 @@ module Aws::RDS
18626
19589
  # used. For more information, see [Publishing Database Logs to Amazon
18627
19590
  # CloudWatch Logs][1] in the *Amazon RDS User Guide*.
18628
19591
  #
19592
+ # This setting doesn't apply to RDS Custom.
19593
+ #
18629
19594
  #
18630
19595
  #
18631
19596
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
@@ -18634,16 +19599,22 @@ module Aws::RDS
18634
19599
  # The number of CPU cores and the number of threads per core for the DB
18635
19600
  # instance class of the DB instance.
18636
19601
  #
19602
+ # This setting doesn't apply to RDS Custom.
19603
+ #
18637
19604
  # @option params [Boolean] :use_default_processor_features
18638
19605
  # A value that indicates whether the DB instance class of the DB
18639
19606
  # instance uses its default processor features.
18640
19607
  #
19608
+ # This setting doesn't apply to RDS Custom.
19609
+ #
18641
19610
  # @option params [String] :db_parameter_group_name
18642
19611
  # The name of the DB parameter group to associate with this DB instance.
18643
19612
  #
18644
19613
  # If you do not specify a value for `DBParameterGroupName`, then the
18645
19614
  # default `DBParameterGroup` for the specified DB engine is used.
18646
19615
  #
19616
+ # This setting doesn't apply to RDS Custom.
19617
+ #
18647
19618
  # Constraints:
18648
19619
  #
18649
19620
  # * If supplied, must match the name of an existing DBParameterGroup.
@@ -18675,6 +19646,8 @@ module Aws::RDS
18675
19646
  # apply to it, see [ Managing capacity automatically with Amazon RDS
18676
19647
  # storage autoscaling][1] in the *Amazon RDS User Guide*.
18677
19648
  #
19649
+ # This setting doesn't apply to RDS Custom.
19650
+ #
18678
19651
  #
18679
19652
  #
18680
19653
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -18684,6 +19657,8 @@ module Aws::RDS
18684
19657
  # from which to restore, for example,
18685
19658
  # `arn:aws:rds:useast-1:123456789012:auto-backup:ab-L2IJCEXJP7XQ7HOJ4SIEXAMPLE`.
18686
19659
  #
19660
+ # This setting doesn't apply to RDS Custom.
19661
+ #
18687
19662
  # @option params [Boolean] :enable_customer_owned_ip
18688
19663
  # A value that indicates whether to enable a customer-owned IP address
18689
19664
  # (CoIP) for an RDS on Outposts DB instance.
@@ -18693,6 +19668,8 @@ module Aws::RDS
18693
19668
  # a CoIP can provide lower latency for connections to the DB instance
18694
19669
  # from outside of its virtual private cloud (VPC) on your local network.
18695
19670
  #
19671
+ # This setting doesn't apply to RDS Custom.
19672
+ #
18696
19673
  # For more information about RDS on Outposts, see [Working with Amazon
18697
19674
  # RDS on Amazon Web Services Outposts][1] in the *Amazon RDS User
18698
19675
  # Guide*.
@@ -18705,6 +19682,29 @@ module Aws::RDS
18705
19682
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
18706
19683
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
18707
19684
  #
19685
+ # @option params [String] :custom_iam_instance_profile
19686
+ # The instance profile associated with the underlying Amazon EC2
19687
+ # instance of an RDS Custom DB instance. The instance profile must meet
19688
+ # the following requirements:
19689
+ #
19690
+ # * The profile must exist in your account.
19691
+ #
19692
+ # * The profile must have an IAM role that Amazon EC2 has permissions to
19693
+ # assume.
19694
+ #
19695
+ # * The instance profile name and the associated IAM role name must
19696
+ # start with the prefix `AWSRDSCustom`.
19697
+ #
19698
+ # For the list of permissions required for the IAM role, see [ Configure
19699
+ # IAM and your VPC][1] in the *Amazon Relational Database Service User
19700
+ # Guide*.
19701
+ #
19702
+ # This setting is required for RDS Custom.
19703
+ #
19704
+ #
19705
+ #
19706
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
19707
+ #
18708
19708
  # @return [Types::RestoreDBInstanceToPointInTimeResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
18709
19709
  #
18710
19710
  # * {Types::RestoreDBInstanceToPointInTimeResult#db_instance #db_instance} => Types::DBInstance
@@ -18852,6 +19852,7 @@ module Aws::RDS
18852
19852
  # max_allocated_storage: 1,
18853
19853
  # source_db_instance_automated_backups_arn: "String",
18854
19854
  # enable_customer_owned_ip: false,
19855
+ # custom_iam_instance_profile: "String",
18855
19856
  # })
18856
19857
  #
18857
19858
  # @example Response structure
@@ -18912,6 +19913,8 @@ module Aws::RDS
18912
19913
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
18913
19914
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
18914
19915
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
19916
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
19917
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
18915
19918
  # resp.db_instance.latest_restorable_time #=> Time
18916
19919
  # resp.db_instance.multi_az #=> Boolean
18917
19920
  # resp.db_instance.engine_version #=> String
@@ -18986,6 +19989,9 @@ module Aws::RDS
18986
19989
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
18987
19990
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
18988
19991
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
19992
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
19993
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
19994
+ # resp.db_instance.custom_iam_instance_profile #=> String
18989
19995
  #
18990
19996
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceToPointInTime AWS API Documentation
18991
19997
  #
@@ -19107,7 +20113,7 @@ module Aws::RDS
19107
20113
  # The Amazon Web Services KMS key identifier for encrypting messages in
19108
20114
  # the database activity stream. The Amazon Web Services KMS key
19109
20115
  # identifier is the key ARN, key ID, alias ARN, or alias name for the
19110
- # Amazon Web Services KMS customer master key (CMK).
20116
+ # KMS key.
19111
20117
  #
19112
20118
  # @option params [Boolean] :apply_immediately
19113
20119
  # Specifies whether or not the database activity stream is to start as
@@ -19294,8 +20300,8 @@ module Aws::RDS
19294
20300
  # For more information, see [ Starting an Amazon RDS DB instance That
19295
20301
  # Was Previously Stopped][1] in the *Amazon RDS User Guide.*
19296
20302
  #
19297
- # <note markdown="1"> This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For
19298
- # Aurora DB clusters, use `StartDBCluster` instead.
20303
+ # <note markdown="1"> This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora
20304
+ # PostgreSQL. For Aurora DB clusters, use `StartDBCluster` instead.
19299
20305
  #
19300
20306
  # </note>
19301
20307
  #
@@ -19374,6 +20380,8 @@ module Aws::RDS
19374
20380
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
19375
20381
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
19376
20382
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
20383
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
20384
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
19377
20385
  # resp.db_instance.latest_restorable_time #=> Time
19378
20386
  # resp.db_instance.multi_az #=> Boolean
19379
20387
  # resp.db_instance.engine_version #=> String
@@ -19448,6 +20456,9 @@ module Aws::RDS
19448
20456
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
19449
20457
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
19450
20458
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
20459
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
20460
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
20461
+ # resp.db_instance.custom_iam_instance_profile #=> String
19451
20462
  #
19452
20463
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StartDBInstance AWS API Documentation
19453
20464
  #
@@ -19461,6 +20472,8 @@ module Aws::RDS
19461
20472
  # Enables replication of automated backups to a different Amazon Web
19462
20473
  # Services Region.
19463
20474
  #
20475
+ # This command doesn't apply to RDS Custom.
20476
+ #
19464
20477
  # For more information, see [ Replicating Automated Backups to Another
19465
20478
  # Amazon Web Services Region][1] in the *Amazon RDS User Guide.*
19466
20479
  #
@@ -19553,6 +20566,8 @@ module Aws::RDS
19553
20566
  # Starts an export of a snapshot to Amazon S3. The provided IAM role
19554
20567
  # must have access to the S3 bucket.
19555
20568
  #
20569
+ # This command doesn't apply to RDS Custom.
20570
+ #
19556
20571
  # @option params [required, String] :export_task_identifier
19557
20572
  # A unique identifier for the snapshot export task. This ID isn't an
19558
20573
  # identifier for the Amazon S3 bucket where the snapshot is to be
@@ -19569,13 +20584,12 @@ module Aws::RDS
19569
20584
  # when exporting a snapshot.
19570
20585
  #
19571
20586
  # @option params [required, String] :kms_key_id
19572
- # The ID of the Amazon Web Services KMS customer master key (CMK) to use
19573
- # to encrypt the snapshot exported to Amazon S3. The Amazon Web Services
19574
- # KMS key identifier is the key ARN, key ID, alias ARN, or alias name
19575
- # for the Amazon Web Services KMS customer master key (CMK). The caller
19576
- # of this operation must be authorized to execute the following
19577
- # operations. These can be set in the Amazon Web Services KMS key
19578
- # policy:
20587
+ # The ID of the Amazon Web Services KMS key to use to encrypt the
20588
+ # snapshot exported to Amazon S3. The Amazon Web Services KMS key
20589
+ # identifier is the key ARN, key ID, alias ARN, or alias name for the
20590
+ # KMS key. The caller of this operation must be authorized to execute
20591
+ # the following operations. These can be set in the Amazon Web Services
20592
+ # KMS key policy:
19579
20593
  #
19580
20594
  # * GrantOperation.Encrypt
19581
20595
  #
@@ -19866,8 +20880,8 @@ module Aws::RDS
19866
20880
  # For more information, see [ Stopping an Amazon RDS DB Instance
19867
20881
  # Temporarily][1] in the *Amazon RDS User Guide.*
19868
20882
  #
19869
- # <note markdown="1"> This command doesn't apply to Aurora MySQL and Aurora PostgreSQL. For
19870
- # Aurora clusters, use `StopDBCluster` instead.
20883
+ # <note markdown="1"> This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora
20884
+ # PostgreSQL. For Aurora clusters, use `StopDBCluster` instead.
19871
20885
  #
19872
20886
  # </note>
19873
20887
  #
@@ -19951,6 +20965,8 @@ module Aws::RDS
19951
20965
  # resp.db_instance.pending_modified_values.processor_features[0].name #=> String
19952
20966
  # resp.db_instance.pending_modified_values.processor_features[0].value #=> String
19953
20967
  # resp.db_instance.pending_modified_values.iam_database_authentication_enabled #=> Boolean
20968
+ # resp.db_instance.pending_modified_values.automation_mode #=> String, one of "full", "all-paused"
20969
+ # resp.db_instance.pending_modified_values.resume_full_automation_mode_time #=> Time
19954
20970
  # resp.db_instance.latest_restorable_time #=> Time
19955
20971
  # resp.db_instance.multi_az #=> Boolean
19956
20972
  # resp.db_instance.engine_version #=> String
@@ -20025,6 +21041,9 @@ module Aws::RDS
20025
21041
  # resp.db_instance.activity_stream_kinesis_stream_name #=> String
20026
21042
  # resp.db_instance.activity_stream_mode #=> String, one of "sync", "async"
20027
21043
  # resp.db_instance.activity_stream_engine_native_audit_fields_included #=> Boolean
21044
+ # resp.db_instance.automation_mode #=> String, one of "full", "all-paused"
21045
+ # resp.db_instance.resume_full_automation_mode_time #=> Time
21046
+ # resp.db_instance.custom_iam_instance_profile #=> String
20028
21047
  #
20029
21048
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StopDBInstance AWS API Documentation
20030
21049
  #
@@ -20037,6 +21056,8 @@ module Aws::RDS
20037
21056
 
20038
21057
  # Stops automated backup replication for a DB instance.
20039
21058
  #
21059
+ # This command doesn't apply to RDS Custom.
21060
+ #
20040
21061
  # For more information, see [ Replicating Automated Backups to Another
20041
21062
  # Amazon Web Services Region][1] in the *Amazon RDS User Guide.*
20042
21063
  #
@@ -20112,7 +21133,7 @@ module Aws::RDS
20112
21133
  params: params,
20113
21134
  config: config)
20114
21135
  context[:gem_name] = 'aws-sdk-rds'
20115
- context[:gem_version] = '1.128.0'
21136
+ context[:gem_version] = '1.129.0'
20116
21137
  Seahorse::Client::Request.new(handlers, context)
20117
21138
  end
20118
21139