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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-rds/client.rb +1279 -258
- data/lib/aws-sdk-rds/client_api.rb +93 -0
- data/lib/aws-sdk-rds/db_cluster.rb +30 -34
- data/lib/aws-sdk-rds/db_cluster_snapshot.rb +20 -24
- data/lib/aws-sdk-rds/db_engine.rb +8 -0
- data/lib/aws-sdk-rds/db_engine_version.rb +66 -4
- data/lib/aws-sdk-rds/db_instance.rb +514 -139
- data/lib/aws-sdk-rds/db_snapshot.rb +78 -30
- data/lib/aws-sdk-rds/errors.rb +44 -0
- data/lib/aws-sdk-rds/resource.rb +186 -59
- data/lib/aws-sdk-rds/types.rb +1058 -285
- data/lib/aws-sdk-rds.rb +1 -1
- metadata +2 -2
data/lib/aws-sdk-rds/resource.rb
CHANGED
@@ -262,29 +262,29 @@ module Aws::RDS
|
|
262
262
|
# cluster.
|
263
263
|
#
|
264
264
|
# The Amazon Web Services KMS key identifier is the key ARN, key ID,
|
265
|
-
# alias ARN, or alias name for the
|
266
|
-
#
|
267
|
-
#
|
265
|
+
# alias ARN, or alias name for the KMS key. To use a KMS key in a
|
266
|
+
# different Amazon Web Services account, specify the key ARN or alias
|
267
|
+
# ARN.
|
268
268
|
#
|
269
|
-
# When a
|
269
|
+
# When a KMS key isn't specified in `KmsKeyId`\:
|
270
270
|
#
|
271
271
|
# * If `ReplicationSourceIdentifier` identifies an encrypted source,
|
272
|
-
# then Amazon RDS will use the
|
273
|
-
# Otherwise, Amazon RDS will use your default
|
272
|
+
# then Amazon RDS will use the KMS key used to encrypt the source.
|
273
|
+
# Otherwise, Amazon RDS will use your default KMS key.
|
274
274
|
#
|
275
275
|
# * If the `StorageEncrypted` parameter is enabled and
|
276
276
|
# `ReplicationSourceIdentifier` isn't specified, then Amazon RDS will
|
277
|
-
# use your default
|
277
|
+
# use your default KMS key.
|
278
278
|
#
|
279
|
-
# There is a default
|
280
|
-
# Amazon Web Services account has a different default
|
279
|
+
# There is a default KMS key for your Amazon Web Services account. Your
|
280
|
+
# Amazon Web Services account has a different default KMS key for each
|
281
281
|
# Amazon Web Services Region.
|
282
282
|
#
|
283
283
|
# If you create a read replica of an encrypted DB cluster in another
|
284
|
-
# Amazon Web Services Region, you must set `KmsKeyId` to a
|
285
|
-
#
|
286
|
-
#
|
287
|
-
#
|
284
|
+
# Amazon Web Services Region, you must set `KmsKeyId` to a KMS key
|
285
|
+
# identifier that is valid in the destination Amazon Web Services
|
286
|
+
# Region. This KMS key is used to encrypt the read replica in that
|
287
|
+
# Amazon Web Services Region.
|
288
288
|
# @option options [String] :pre_signed_url
|
289
289
|
# A URL that contains a Signature Version 4 signed request for the
|
290
290
|
# `CreateDBCluster` action to be called in the source Amazon Web
|
@@ -299,12 +299,12 @@ module Aws::RDS
|
|
299
299
|
# The pre-signed URL request must contain the following parameter
|
300
300
|
# values:
|
301
301
|
#
|
302
|
-
# * `KmsKeyId` - The Amazon Web Services KMS key identifier for the
|
303
|
-
# to use to encrypt the copy of the DB cluster in the destination
|
304
|
-
# Amazon Web Services Region. This should refer to the same
|
305
|
-
#
|
306
|
-
#
|
307
|
-
#
|
302
|
+
# * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
|
303
|
+
# key to use to encrypt the copy of the DB cluster in the destination
|
304
|
+
# Amazon Web Services Region. This should refer to the same KMS key
|
305
|
+
# for both the `CreateDBCluster` action that is called in the
|
306
|
+
# destination Amazon Web Services Region, and the action contained in
|
307
|
+
# the pre-signed URL.
|
308
308
|
#
|
309
309
|
# * `DestinationRegion` - The name of the Amazon Web Services Region
|
310
310
|
# that Aurora read replica will be created in.
|
@@ -626,6 +626,7 @@ module Aws::RDS
|
|
626
626
|
# deletion_protection: false,
|
627
627
|
# max_allocated_storage: 1,
|
628
628
|
# enable_customer_owned_ip: false,
|
629
|
+
# custom_iam_instance_profile: "String",
|
629
630
|
# })
|
630
631
|
# @param [Hash] options ({})
|
631
632
|
# @option options [String] :db_name
|
@@ -691,6 +692,21 @@ module Aws::RDS
|
|
691
692
|
#
|
692
693
|
# ^
|
693
694
|
#
|
695
|
+
# **Amazon RDS Custom**
|
696
|
+
#
|
697
|
+
# The Oracle System ID (SID) of the created RDS Custom DB instance. If
|
698
|
+
# you don't specify a value, the default value is `ORCL`.
|
699
|
+
#
|
700
|
+
# Default: `ORCL`
|
701
|
+
#
|
702
|
+
# Constraints:
|
703
|
+
#
|
704
|
+
# * It must contain 1 to 8 alphanumeric characters.
|
705
|
+
#
|
706
|
+
# * It must contain a letter.
|
707
|
+
#
|
708
|
+
# * It can't be a word reserved by the database engine.
|
709
|
+
#
|
694
710
|
# **SQL Server**
|
695
711
|
#
|
696
712
|
# Not applicable. Must be null.
|
@@ -748,6 +764,16 @@ module Aws::RDS
|
|
748
764
|
# amount of data in your database increases, though you are only charged
|
749
765
|
# for the space that you use in an Aurora cluster volume.
|
750
766
|
#
|
767
|
+
# **Amazon RDS Custom**
|
768
|
+
#
|
769
|
+
# Constraints to the amount of storage for each storage type are the
|
770
|
+
# following:
|
771
|
+
#
|
772
|
+
# * General Purpose (SSD) storage (gp2): Must be an integer from 40 to
|
773
|
+
# 65536.
|
774
|
+
#
|
775
|
+
# * Provisioned IOPS storage (io1): Must be an integer from 40 to 65536.
|
776
|
+
#
|
751
777
|
# **MySQL**
|
752
778
|
#
|
753
779
|
# Constraints to the amount of storage for each storage type are the
|
@@ -849,6 +875,8 @@ module Aws::RDS
|
|
849
875
|
#
|
850
876
|
# * `aurora-postgresql`
|
851
877
|
#
|
878
|
+
# * `custom-oracle-ee (for RDS Custom instances)`
|
879
|
+
#
|
852
880
|
# * `mariadb`
|
853
881
|
#
|
854
882
|
# * `mysql`
|
@@ -1033,6 +1061,8 @@ module Aws::RDS
|
|
1033
1061
|
# If you do not specify a value, then the default DB parameter group for
|
1034
1062
|
# the specified DB engine and version is used.
|
1035
1063
|
#
|
1064
|
+
# This setting doesn't apply to RDS Custom.
|
1065
|
+
#
|
1036
1066
|
# Constraints:
|
1037
1067
|
#
|
1038
1068
|
# * Must be 1 to 255 letters, numbers, or hyphens.
|
@@ -1057,6 +1087,8 @@ module Aws::RDS
|
|
1057
1087
|
# * Must be a value from 0 to 35
|
1058
1088
|
#
|
1059
1089
|
# * Can't be set to 0 if the DB instance is a source to read replicas
|
1090
|
+
#
|
1091
|
+
# * Can't be set to 0 or 35 for an RDS Custom DB instance
|
1060
1092
|
# @option options [String] :preferred_backup_window
|
1061
1093
|
# The daily time range during which automated backups are created if
|
1062
1094
|
# automated backups are enabled, using the `BackupRetentionPeriod`
|
@@ -1133,6 +1165,8 @@ module Aws::RDS
|
|
1133
1165
|
# A value that indicates whether the DB instance is a Multi-AZ
|
1134
1166
|
# deployment. You can't set the `AvailabilityZone` parameter if the DB
|
1135
1167
|
# instance is a Multi-AZ deployment.
|
1168
|
+
#
|
1169
|
+
# This setting doesn't apply to RDS Custom.
|
1136
1170
|
# @option options [String] :engine_version
|
1137
1171
|
# The version number of the database engine to use.
|
1138
1172
|
#
|
@@ -1149,46 +1183,60 @@ module Aws::RDS
|
|
1149
1183
|
# Not applicable. The version number of the database engine to be used
|
1150
1184
|
# by the DB instance is managed by the DB cluster.
|
1151
1185
|
#
|
1186
|
+
# **Amazon RDS Custom**
|
1187
|
+
#
|
1188
|
+
# A custom engine version (CEV) that you have previously created. This
|
1189
|
+
# setting is required for RDS Custom. The CEV name has the following
|
1190
|
+
# format: `19.customized_string `. An example identifier is
|
1191
|
+
# `19.my_cev1`. For more information, see [ Creating an RDS Custom DB
|
1192
|
+
# instance][1] in the *Amazon RDS User Guide.*.
|
1193
|
+
#
|
1152
1194
|
# **MariaDB**
|
1153
1195
|
#
|
1154
|
-
# See [MariaDB on Amazon RDS Versions][
|
1196
|
+
# See [MariaDB on Amazon RDS Versions][2] in the *Amazon RDS User
|
1155
1197
|
# Guide.*
|
1156
1198
|
#
|
1157
1199
|
# **Microsoft SQL Server**
|
1158
1200
|
#
|
1159
|
-
# See [Microsoft SQL Server Versions on Amazon RDS][
|
1201
|
+
# See [Microsoft SQL Server Versions on Amazon RDS][3] in the *Amazon
|
1160
1202
|
# RDS User Guide.*
|
1161
1203
|
#
|
1162
1204
|
# **MySQL**
|
1163
1205
|
#
|
1164
|
-
# See [MySQL on Amazon RDS Versions][
|
1206
|
+
# See [MySQL on Amazon RDS Versions][4] in the *Amazon RDS User Guide.*
|
1165
1207
|
#
|
1166
1208
|
# **Oracle**
|
1167
1209
|
#
|
1168
|
-
# See [Oracle Database Engine Release Notes][
|
1210
|
+
# See [Oracle Database Engine Release Notes][5] in the *Amazon RDS User
|
1169
1211
|
# Guide.*
|
1170
1212
|
#
|
1171
1213
|
# **PostgreSQL**
|
1172
1214
|
#
|
1173
|
-
# See [Amazon RDS for PostgreSQL versions and extensions][
|
1215
|
+
# See [Amazon RDS for PostgreSQL versions and extensions][6] in the
|
1174
1216
|
# *Amazon RDS User Guide.*
|
1175
1217
|
#
|
1176
1218
|
#
|
1177
1219
|
#
|
1178
|
-
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/
|
1179
|
-
# [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/
|
1180
|
-
# [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/
|
1181
|
-
# [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/
|
1182
|
-
# [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/
|
1220
|
+
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-creating.html#custom-creating.create
|
1221
|
+
# [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
|
1222
|
+
# [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
|
1223
|
+
# [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
|
1224
|
+
# [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.Oracle.PatchComposition.html
|
1225
|
+
# [6]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_PostgreSQL.html#PostgreSQL.Concepts
|
1183
1226
|
# @option options [Boolean] :auto_minor_version_upgrade
|
1184
1227
|
# A value that indicates whether minor engine upgrades are applied
|
1185
1228
|
# automatically to the DB instance during the maintenance window. By
|
1186
1229
|
# default, minor engine upgrades are applied automatically.
|
1230
|
+
#
|
1231
|
+
# If you create an RDS Custom DB instance, you must set
|
1232
|
+
# `AutoMinorVersionUpgrade` to `false`.
|
1187
1233
|
# @option options [String] :license_model
|
1188
1234
|
# License model information for this DB instance.
|
1189
1235
|
#
|
1190
1236
|
# Valid values: `license-included` \| `bring-your-own-license` \|
|
1191
1237
|
# `general-public-license`
|
1238
|
+
#
|
1239
|
+
# This setting doesn't apply to RDS Custom.
|
1192
1240
|
# @option options [Integer] :iops
|
1193
1241
|
# The amount of Provisioned IOPS (input/output operations per second) to
|
1194
1242
|
# be initially allocated for the DB instance. For information about
|
@@ -1209,11 +1257,16 @@ module Aws::RDS
|
|
1209
1257
|
#
|
1210
1258
|
# Permanent options, such as the TDE option for Oracle Advanced Security
|
1211
1259
|
# TDE, can't be removed from an option group. Also, that option group
|
1212
|
-
# can't be removed from a DB instance
|
1213
|
-
# instance
|
1260
|
+
# can't be removed from a DB instance after it is associated with a DB
|
1261
|
+
# instance.
|
1262
|
+
#
|
1263
|
+
# This setting doesn't apply to RDS Custom.
|
1214
1264
|
# @option options [String] :character_set_name
|
1215
|
-
# For supported engines, indicates that the DB instance
|
1216
|
-
# associated with the specified CharacterSet
|
1265
|
+
# For supported engines, this value indicates that the DB instance
|
1266
|
+
# should be associated with the specified `CharacterSet`.
|
1267
|
+
#
|
1268
|
+
# This setting doesn't apply to RDS Custom. However, if you need to
|
1269
|
+
# change the character set, you can change it on the database itself.
|
1217
1270
|
#
|
1218
1271
|
# **Amazon Aurora**
|
1219
1272
|
#
|
@@ -1221,6 +1274,8 @@ module Aws::RDS
|
|
1221
1274
|
# more information, see `CreateDBCluster`.
|
1222
1275
|
# @option options [String] :nchar_character_set_name
|
1223
1276
|
# The name of the NCHAR character set for the Oracle DB instance.
|
1277
|
+
#
|
1278
|
+
# This parameter doesn't apply to RDS Custom.
|
1224
1279
|
# @option options [Boolean] :publicly_accessible
|
1225
1280
|
# A value that indicates whether the DB instance is publicly accessible.
|
1226
1281
|
#
|
@@ -1258,6 +1313,8 @@ module Aws::RDS
|
|
1258
1313
|
# Tags to assign to the DB instance.
|
1259
1314
|
# @option options [String] :db_cluster_identifier
|
1260
1315
|
# The identifier of the DB cluster that the instance will belong to.
|
1316
|
+
#
|
1317
|
+
# This setting doesn't apply to RDS Custom.
|
1261
1318
|
# @option options [String] :storage_type
|
1262
1319
|
# Specifies the storage type to be associated with the DB instance.
|
1263
1320
|
#
|
@@ -1270,13 +1327,21 @@ module Aws::RDS
|
|
1270
1327
|
# @option options [String] :tde_credential_arn
|
1271
1328
|
# The ARN from the key store with which to associate the instance for
|
1272
1329
|
# TDE encryption.
|
1330
|
+
#
|
1331
|
+
# This setting doesn't apply to RDS Custom.
|
1273
1332
|
# @option options [String] :tde_credential_password
|
1274
1333
|
# The password for the given ARN from the key store in order to access
|
1275
1334
|
# the device.
|
1335
|
+
#
|
1336
|
+
# This setting doesn't apply to RDS Custom.
|
1276
1337
|
# @option options [Boolean] :storage_encrypted
|
1277
1338
|
# A value that indicates whether the DB instance is encrypted. By
|
1278
1339
|
# default, it isn't encrypted.
|
1279
1340
|
#
|
1341
|
+
# For RDS Custom Oracle instances, either set this parameter to `true`
|
1342
|
+
# or leave it unset. If you set this parameter to `false`, RDS reports
|
1343
|
+
# an error.
|
1344
|
+
#
|
1280
1345
|
# **Amazon Aurora**
|
1281
1346
|
#
|
1282
1347
|
# Not applicable. The encryption for DB instances is managed by the DB
|
@@ -1286,9 +1351,9 @@ module Aws::RDS
|
|
1286
1351
|
# instance.
|
1287
1352
|
#
|
1288
1353
|
# The Amazon Web Services KMS key identifier is the key ARN, key ID,
|
1289
|
-
# alias ARN, or alias name for the
|
1290
|
-
#
|
1291
|
-
#
|
1354
|
+
# alias ARN, or alias name for the KMS key. To use a KMS key in a
|
1355
|
+
# different Amazon Web Services account, specify the key ARN or alias
|
1356
|
+
# ARN.
|
1292
1357
|
#
|
1293
1358
|
# **Amazon Aurora**
|
1294
1359
|
#
|
@@ -1296,10 +1361,18 @@ module Aws::RDS
|
|
1296
1361
|
# by the DB cluster. For more information, see `CreateDBCluster`.
|
1297
1362
|
#
|
1298
1363
|
# If `StorageEncrypted` is enabled, and you do not specify a value for
|
1299
|
-
# the `KmsKeyId` parameter, then Amazon RDS uses your default
|
1300
|
-
# is a default
|
1301
|
-
# Services account has a different default
|
1302
|
-
# Services Region.
|
1364
|
+
# the `KmsKeyId` parameter, then Amazon RDS uses your default KMS key.
|
1365
|
+
# There is a default KMS key for your Amazon Web Services account. Your
|
1366
|
+
# Amazon Web Services account has a different default KMS key for each
|
1367
|
+
# Amazon Web Services Region.
|
1368
|
+
#
|
1369
|
+
# **Amazon RDS Custom**
|
1370
|
+
#
|
1371
|
+
# A KMS key is required for RDS Custom Oracle instances. For most RDS
|
1372
|
+
# engines, if you leave this parameter empty while enabling
|
1373
|
+
# `StorageEncrypted`, the engine uses the default KMS key. However, RDS
|
1374
|
+
# Custom for Oracle doesn't use the default key when this parameter is
|
1375
|
+
# empty. You must explicitly specify a key.
|
1303
1376
|
# @option options [String] :domain
|
1304
1377
|
# The Active Directory directory ID to create the DB instance in.
|
1305
1378
|
# Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
|
@@ -1308,6 +1381,8 @@ module Aws::RDS
|
|
1308
1381
|
# For more information, see [ Kerberos Authentication][1] in the *Amazon
|
1309
1382
|
# RDS User Guide*.
|
1310
1383
|
#
|
1384
|
+
# This setting doesn't apply to RDS Custom.
|
1385
|
+
#
|
1311
1386
|
#
|
1312
1387
|
#
|
1313
1388
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
|
@@ -1322,35 +1397,43 @@ module Aws::RDS
|
|
1322
1397
|
# the DB cluster setting.
|
1323
1398
|
# @option options [Integer] :monitoring_interval
|
1324
1399
|
# The interval, in seconds, between points when Enhanced Monitoring
|
1325
|
-
# metrics are collected for the DB instance. To disable
|
1400
|
+
# metrics are collected for the DB instance. To disable collection of
|
1326
1401
|
# Enhanced Monitoring metrics, specify 0. The default is 0.
|
1327
1402
|
#
|
1328
|
-
# If `MonitoringRoleArn` is specified, then you must
|
1403
|
+
# If `MonitoringRoleArn` is specified, then you must set
|
1329
1404
|
# `MonitoringInterval` to a value other than 0.
|
1330
1405
|
#
|
1406
|
+
# This setting doesn't apply to RDS Custom.
|
1407
|
+
#
|
1331
1408
|
# Valid Values: `0, 1, 5, 10, 15, 30, 60`
|
1332
1409
|
# @option options [String] :monitoring_role_arn
|
1333
1410
|
# The ARN for the IAM role that permits RDS to send enhanced monitoring
|
1334
1411
|
# metrics to Amazon CloudWatch Logs. For example,
|
1335
1412
|
# `arn:aws:iam:123456789012:role/emaccess`. For information on creating
|
1336
|
-
# a monitoring role,
|
1413
|
+
# a monitoring role, see [Setting Up and Enabling Enhanced
|
1337
1414
|
# Monitoring][1] in the *Amazon RDS User Guide*.
|
1338
1415
|
#
|
1339
1416
|
# If `MonitoringInterval` is set to a value other than 0, then you must
|
1340
1417
|
# supply a `MonitoringRoleArn` value.
|
1341
1418
|
#
|
1419
|
+
# This setting doesn't apply to RDS Custom.
|
1420
|
+
#
|
1342
1421
|
#
|
1343
1422
|
#
|
1344
1423
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
|
1345
1424
|
# @option options [String] :domain_iam_role_name
|
1346
1425
|
# Specify the name of the IAM role to be used when making API calls to
|
1347
1426
|
# the Directory Service.
|
1427
|
+
#
|
1428
|
+
# This setting doesn't apply to RDS Custom.
|
1348
1429
|
# @option options [Integer] :promotion_tier
|
1349
1430
|
# A value that specifies the order in which an Aurora Replica is
|
1350
1431
|
# promoted to the primary instance after a failure of the existing
|
1351
1432
|
# primary instance. For more information, see [ Fault Tolerance for an
|
1352
1433
|
# Aurora DB Cluster][1] in the *Amazon Aurora User Guide*.
|
1353
1434
|
#
|
1435
|
+
# This setting doesn't apply to RDS Custom.
|
1436
|
+
#
|
1354
1437
|
# Default: 1
|
1355
1438
|
#
|
1356
1439
|
# Valid Values: 0 - 15
|
@@ -1370,9 +1453,9 @@ module Aws::RDS
|
|
1370
1453
|
# Services Identity and Access Management (IAM) accounts to database
|
1371
1454
|
# accounts. By default, mapping is disabled.
|
1372
1455
|
#
|
1373
|
-
# This setting doesn't apply to Amazon Aurora.
|
1374
|
-
# Services IAM accounts to database accounts is
|
1375
|
-
# cluster.
|
1456
|
+
# This setting doesn't apply to RDS Custom or Amazon Aurora. In Aurora,
|
1457
|
+
# mapping Amazon Web Services IAM accounts to database accounts is
|
1458
|
+
# managed by the DB cluster.
|
1376
1459
|
#
|
1377
1460
|
# For more information, see [ IAM Database Authentication for MySQL and
|
1378
1461
|
# PostgreSQL][1] in the *Amazon RDS User Guide.*
|
@@ -1382,10 +1465,10 @@ module Aws::RDS
|
|
1382
1465
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
|
1383
1466
|
# @option options [Boolean] :enable_performance_insights
|
1384
1467
|
# A value that indicates whether to enable Performance Insights for the
|
1385
|
-
# DB instance.
|
1468
|
+
# DB instance. For more information, see [Using Amazon Performance
|
1469
|
+
# Insights][1] in the *Amazon Relational Database Service User Guide*.
|
1386
1470
|
#
|
1387
|
-
#
|
1388
|
-
# the *Amazon Relational Database Service User Guide*.
|
1471
|
+
# This setting doesn't apply to RDS Custom.
|
1389
1472
|
#
|
1390
1473
|
#
|
1391
1474
|
#
|
@@ -1395,27 +1478,33 @@ module Aws::RDS
|
|
1395
1478
|
# Performance Insights data.
|
1396
1479
|
#
|
1397
1480
|
# The Amazon Web Services KMS key identifier is the key ARN, key ID,
|
1398
|
-
# alias ARN, or alias name for the
|
1399
|
-
# master key (CMK).
|
1481
|
+
# alias ARN, or alias name for the KMS key.
|
1400
1482
|
#
|
1401
1483
|
# If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
|
1402
|
-
# Amazon RDS uses your default
|
1403
|
-
# Amazon Web Services account. Your Amazon Web Services account has
|
1404
|
-
# different default
|
1484
|
+
# Amazon RDS uses your default KMS key. There is a default KMS key for
|
1485
|
+
# your Amazon Web Services account. Your Amazon Web Services account has
|
1486
|
+
# a different default KMS key for each Amazon Web Services Region.
|
1487
|
+
#
|
1488
|
+
# This setting doesn't apply to RDS Custom.
|
1405
1489
|
# @option options [Integer] :performance_insights_retention_period
|
1406
1490
|
# The amount of time, in days, to retain Performance Insights data.
|
1407
1491
|
# Valid values are 7 or 731 (2 years).
|
1492
|
+
#
|
1493
|
+
# This setting doesn't apply to RDS Custom.
|
1408
1494
|
# @option options [Array<String>] :enable_cloudwatch_logs_exports
|
1409
1495
|
# The list of log types that need to be enabled for exporting to
|
1410
|
-
# CloudWatch Logs. The values in the list depend on the DB engine
|
1411
|
-
#
|
1412
|
-
#
|
1413
|
-
# Guide*.
|
1496
|
+
# CloudWatch Logs. The values in the list depend on the DB engine. For
|
1497
|
+
# more information, see [Publishing Database Logs to Amazon CloudWatch
|
1498
|
+
# Logs][1] in the *Amazon Relational Database Service User Guide*.
|
1414
1499
|
#
|
1415
1500
|
# **Amazon Aurora**
|
1416
1501
|
#
|
1417
1502
|
# Not applicable. CloudWatch Logs exports are managed by the DB cluster.
|
1418
1503
|
#
|
1504
|
+
# **RDS Custom**
|
1505
|
+
#
|
1506
|
+
# Not applicable.
|
1507
|
+
#
|
1419
1508
|
# **MariaDB**
|
1420
1509
|
#
|
1421
1510
|
# Possible values are `audit`, `error`, `general`, and `slowquery`.
|
@@ -1443,6 +1532,8 @@ module Aws::RDS
|
|
1443
1532
|
# @option options [Array<Types::ProcessorFeature>] :processor_features
|
1444
1533
|
# The number of CPU cores and the number of threads per core for the DB
|
1445
1534
|
# instance class of the DB instance.
|
1535
|
+
#
|
1536
|
+
# This setting doesn't apply to RDS Custom.
|
1446
1537
|
# @option options [Boolean] :deletion_protection
|
1447
1538
|
# A value that indicates whether the DB instance has deletion protection
|
1448
1539
|
# enabled. The database can't be deleted when deletion protection is
|
@@ -1467,6 +1558,8 @@ module Aws::RDS
|
|
1467
1558
|
# apply to it, see [ Managing capacity automatically with Amazon RDS
|
1468
1559
|
# storage autoscaling][1] in the *Amazon RDS User Guide*.
|
1469
1560
|
#
|
1561
|
+
# This setting doesn't apply to RDS Custom.
|
1562
|
+
#
|
1470
1563
|
#
|
1471
1564
|
#
|
1472
1565
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
|
@@ -1490,6 +1583,28 @@ module Aws::RDS
|
|
1490
1583
|
#
|
1491
1584
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
|
1492
1585
|
# [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
|
1586
|
+
# @option options [String] :custom_iam_instance_profile
|
1587
|
+
# The instance profile associated with the underlying Amazon EC2
|
1588
|
+
# instance of an RDS Custom DB instance. The instance profile must meet
|
1589
|
+
# the following requirements:
|
1590
|
+
#
|
1591
|
+
# * The profile must exist in your account.
|
1592
|
+
#
|
1593
|
+
# * The profile must have an IAM role that Amazon EC2 has permissions to
|
1594
|
+
# assume.
|
1595
|
+
#
|
1596
|
+
# * The instance profile name and the associated IAM role name must
|
1597
|
+
# start with the prefix `AWSRDSCustom`.
|
1598
|
+
#
|
1599
|
+
# For the list of permissions required for the IAM role, see [ Configure
|
1600
|
+
# IAM and your VPC][1] in the *Amazon Relational Database Service User
|
1601
|
+
# Guide*.
|
1602
|
+
#
|
1603
|
+
# This setting is required for RDS Custom.
|
1604
|
+
#
|
1605
|
+
#
|
1606
|
+
#
|
1607
|
+
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
|
1493
1608
|
# @return [DBInstance]
|
1494
1609
|
def create_db_instance(options = {})
|
1495
1610
|
resp = @client.create_db_instance(options)
|
@@ -2131,6 +2246,10 @@ module Aws::RDS
|
|
2131
2246
|
# If this parameter is enabled and the requested engine supports the
|
2132
2247
|
# `CharacterSetName` parameter for `CreateDBInstance`, the response
|
2133
2248
|
# includes a list of supported character sets for each engine version.
|
2249
|
+
#
|
2250
|
+
# For RDS Custom, the default is not to list supported character sets.
|
2251
|
+
# If you set `ListSupportedCharacterSets` to `true`, RDS Custom returns
|
2252
|
+
# no results.
|
2134
2253
|
# @option options [Boolean] :list_supported_timezones
|
2135
2254
|
# A value that indicates whether to list the supported time zones for
|
2136
2255
|
# each engine version.
|
@@ -2138,6 +2257,10 @@ module Aws::RDS
|
|
2138
2257
|
# If this parameter is enabled and the requested engine supports the
|
2139
2258
|
# `TimeZone` parameter for `CreateDBInstance`, the response includes a
|
2140
2259
|
# list of supported time zones for each engine version.
|
2260
|
+
#
|
2261
|
+
# For RDS Custom, the default is not to list supported time zones. If
|
2262
|
+
# you set `ListSupportedTimezones` to `true`, RDS Custom returns no
|
2263
|
+
# results.
|
2141
2264
|
# @option options [Boolean] :include_all
|
2142
2265
|
# A value that indicates whether to include engine versions that aren't
|
2143
2266
|
# available in the list. The default is to list only available engine
|
@@ -2441,6 +2564,8 @@ module Aws::RDS
|
|
2441
2564
|
# You can give an Amazon Web Services account permission to restore a
|
2442
2565
|
# manual DB snapshot from another Amazon Web Services account by using
|
2443
2566
|
# the `ModifyDBSnapshotAttribute` API action.
|
2567
|
+
#
|
2568
|
+
# This setting doesn't apply to RDS Custom.
|
2444
2569
|
# @option options [Boolean] :include_public
|
2445
2570
|
# A value that indicates whether to include manual DB cluster snapshots
|
2446
2571
|
# that are public and can be copied or restored by any Amazon Web
|
@@ -2448,6 +2573,8 @@ module Aws::RDS
|
|
2448
2573
|
#
|
2449
2574
|
# You can share a manual DB snapshot as public by using the
|
2450
2575
|
# ModifyDBSnapshotAttribute API.
|
2576
|
+
#
|
2577
|
+
# This setting doesn't apply to RDS Custom.
|
2451
2578
|
# @option options [String] :dbi_resource_id
|
2452
2579
|
# A specific DB resource ID to describe.
|
2453
2580
|
# @return [DBSnapshot::Collection]
|
@@ -2608,7 +2735,7 @@ module Aws::RDS
|
|
2608
2735
|
#
|
2609
2736
|
# events = rds.events({
|
2610
2737
|
# source_identifier: "String",
|
2611
|
-
# source_type: "db-instance", # accepts db-instance, db-parameter-group, db-security-group, db-snapshot, db-cluster, db-cluster-snapshot
|
2738
|
+
# source_type: "db-instance", # accepts db-instance, db-parameter-group, db-security-group, db-snapshot, db-cluster, db-cluster-snapshot, custom-engine-version
|
2612
2739
|
# start_time: Time.now,
|
2613
2740
|
# end_time: Time.now,
|
2614
2741
|
# duration: 1,
|