aws-sdk-rds 1.125.0 → 1.129.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +20 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-rds/client.rb +1296 -262
- data/lib/aws-sdk-rds/client_api.rb +95 -0
- data/lib/aws-sdk-rds/db_cluster.rb +33 -34
- data/lib/aws-sdk-rds/db_cluster_snapshot.rb +21 -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 +187 -59
- data/lib/aws-sdk-rds/types.rb +1090 -291
- data/lib/aws-sdk-rds.rb +1 -1
- metadata +5 -5
data/lib/aws-sdk-rds/resource.rb
CHANGED
@@ -74,6 +74,7 @@ module Aws::RDS
|
|
74
74
|
# auto_pause: false,
|
75
75
|
# seconds_until_auto_pause: 1,
|
76
76
|
# timeout_action: "String",
|
77
|
+
# seconds_before_timeout: 1,
|
77
78
|
# },
|
78
79
|
# deletion_protection: false,
|
79
80
|
# global_cluster_identifier: "String",
|
@@ -261,29 +262,29 @@ module Aws::RDS
|
|
261
262
|
# cluster.
|
262
263
|
#
|
263
264
|
# The Amazon Web Services KMS key identifier is the key ARN, key ID,
|
264
|
-
# alias ARN, or alias name for the
|
265
|
-
#
|
266
|
-
#
|
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.
|
267
268
|
#
|
268
|
-
# When a
|
269
|
+
# When a KMS key isn't specified in `KmsKeyId`\:
|
269
270
|
#
|
270
271
|
# * If `ReplicationSourceIdentifier` identifies an encrypted source,
|
271
|
-
# then Amazon RDS will use the
|
272
|
-
# 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.
|
273
274
|
#
|
274
275
|
# * If the `StorageEncrypted` parameter is enabled and
|
275
276
|
# `ReplicationSourceIdentifier` isn't specified, then Amazon RDS will
|
276
|
-
# use your default
|
277
|
+
# use your default KMS key.
|
277
278
|
#
|
278
|
-
# There is a default
|
279
|
-
# 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
|
280
281
|
# Amazon Web Services Region.
|
281
282
|
#
|
282
283
|
# If you create a read replica of an encrypted DB cluster in another
|
283
|
-
# Amazon Web Services Region, you must set `KmsKeyId` to a
|
284
|
-
#
|
285
|
-
#
|
286
|
-
#
|
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.
|
287
288
|
# @option options [String] :pre_signed_url
|
288
289
|
# A URL that contains a Signature Version 4 signed request for the
|
289
290
|
# `CreateDBCluster` action to be called in the source Amazon Web
|
@@ -298,12 +299,12 @@ module Aws::RDS
|
|
298
299
|
# The pre-signed URL request must contain the following parameter
|
299
300
|
# values:
|
300
301
|
#
|
301
|
-
# * `KmsKeyId` - The Amazon Web Services KMS key identifier for the
|
302
|
-
# to use to encrypt the copy of the DB cluster in the destination
|
303
|
-
# Amazon Web Services Region. This should refer to the same
|
304
|
-
#
|
305
|
-
#
|
306
|
-
#
|
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.
|
307
308
|
#
|
308
309
|
# * `DestinationRegion` - The name of the Amazon Web Services Region
|
309
310
|
# that Aurora read replica will be created in.
|
@@ -625,6 +626,7 @@ module Aws::RDS
|
|
625
626
|
# deletion_protection: false,
|
626
627
|
# max_allocated_storage: 1,
|
627
628
|
# enable_customer_owned_ip: false,
|
629
|
+
# custom_iam_instance_profile: "String",
|
628
630
|
# })
|
629
631
|
# @param [Hash] options ({})
|
630
632
|
# @option options [String] :db_name
|
@@ -690,6 +692,21 @@ module Aws::RDS
|
|
690
692
|
#
|
691
693
|
# ^
|
692
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
|
+
#
|
693
710
|
# **SQL Server**
|
694
711
|
#
|
695
712
|
# Not applicable. Must be null.
|
@@ -747,6 +764,16 @@ module Aws::RDS
|
|
747
764
|
# amount of data in your database increases, though you are only charged
|
748
765
|
# for the space that you use in an Aurora cluster volume.
|
749
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
|
+
#
|
750
777
|
# **MySQL**
|
751
778
|
#
|
752
779
|
# Constraints to the amount of storage for each storage type are the
|
@@ -848,6 +875,8 @@ module Aws::RDS
|
|
848
875
|
#
|
849
876
|
# * `aurora-postgresql`
|
850
877
|
#
|
878
|
+
# * `custom-oracle-ee (for RDS Custom instances)`
|
879
|
+
#
|
851
880
|
# * `mariadb`
|
852
881
|
#
|
853
882
|
# * `mysql`
|
@@ -1032,6 +1061,8 @@ module Aws::RDS
|
|
1032
1061
|
# If you do not specify a value, then the default DB parameter group for
|
1033
1062
|
# the specified DB engine and version is used.
|
1034
1063
|
#
|
1064
|
+
# This setting doesn't apply to RDS Custom.
|
1065
|
+
#
|
1035
1066
|
# Constraints:
|
1036
1067
|
#
|
1037
1068
|
# * Must be 1 to 255 letters, numbers, or hyphens.
|
@@ -1056,6 +1087,8 @@ module Aws::RDS
|
|
1056
1087
|
# * Must be a value from 0 to 35
|
1057
1088
|
#
|
1058
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
|
1059
1092
|
# @option options [String] :preferred_backup_window
|
1060
1093
|
# The daily time range during which automated backups are created if
|
1061
1094
|
# automated backups are enabled, using the `BackupRetentionPeriod`
|
@@ -1132,6 +1165,8 @@ module Aws::RDS
|
|
1132
1165
|
# A value that indicates whether the DB instance is a Multi-AZ
|
1133
1166
|
# deployment. You can't set the `AvailabilityZone` parameter if the DB
|
1134
1167
|
# instance is a Multi-AZ deployment.
|
1168
|
+
#
|
1169
|
+
# This setting doesn't apply to RDS Custom.
|
1135
1170
|
# @option options [String] :engine_version
|
1136
1171
|
# The version number of the database engine to use.
|
1137
1172
|
#
|
@@ -1148,46 +1183,60 @@ module Aws::RDS
|
|
1148
1183
|
# Not applicable. The version number of the database engine to be used
|
1149
1184
|
# by the DB instance is managed by the DB cluster.
|
1150
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
|
+
#
|
1151
1194
|
# **MariaDB**
|
1152
1195
|
#
|
1153
|
-
# See [MariaDB on Amazon RDS Versions][
|
1196
|
+
# See [MariaDB on Amazon RDS Versions][2] in the *Amazon RDS User
|
1154
1197
|
# Guide.*
|
1155
1198
|
#
|
1156
1199
|
# **Microsoft SQL Server**
|
1157
1200
|
#
|
1158
|
-
# See [Microsoft SQL Server Versions on Amazon RDS][
|
1201
|
+
# See [Microsoft SQL Server Versions on Amazon RDS][3] in the *Amazon
|
1159
1202
|
# RDS User Guide.*
|
1160
1203
|
#
|
1161
1204
|
# **MySQL**
|
1162
1205
|
#
|
1163
|
-
# See [MySQL on Amazon RDS Versions][
|
1206
|
+
# See [MySQL on Amazon RDS Versions][4] in the *Amazon RDS User Guide.*
|
1164
1207
|
#
|
1165
1208
|
# **Oracle**
|
1166
1209
|
#
|
1167
|
-
# See [Oracle Database Engine Release Notes][
|
1210
|
+
# See [Oracle Database Engine Release Notes][5] in the *Amazon RDS User
|
1168
1211
|
# Guide.*
|
1169
1212
|
#
|
1170
1213
|
# **PostgreSQL**
|
1171
1214
|
#
|
1172
|
-
# See [Amazon RDS for PostgreSQL versions and extensions][
|
1215
|
+
# See [Amazon RDS for PostgreSQL versions and extensions][6] in the
|
1173
1216
|
# *Amazon RDS User Guide.*
|
1174
1217
|
#
|
1175
1218
|
#
|
1176
1219
|
#
|
1177
|
-
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/
|
1178
|
-
# [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/
|
1179
|
-
# [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/
|
1180
|
-
# [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/
|
1181
|
-
# [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
|
1182
1226
|
# @option options [Boolean] :auto_minor_version_upgrade
|
1183
1227
|
# A value that indicates whether minor engine upgrades are applied
|
1184
1228
|
# automatically to the DB instance during the maintenance window. By
|
1185
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`.
|
1186
1233
|
# @option options [String] :license_model
|
1187
1234
|
# License model information for this DB instance.
|
1188
1235
|
#
|
1189
1236
|
# Valid values: `license-included` \| `bring-your-own-license` \|
|
1190
1237
|
# `general-public-license`
|
1238
|
+
#
|
1239
|
+
# This setting doesn't apply to RDS Custom.
|
1191
1240
|
# @option options [Integer] :iops
|
1192
1241
|
# The amount of Provisioned IOPS (input/output operations per second) to
|
1193
1242
|
# be initially allocated for the DB instance. For information about
|
@@ -1208,11 +1257,16 @@ module Aws::RDS
|
|
1208
1257
|
#
|
1209
1258
|
# Permanent options, such as the TDE option for Oracle Advanced Security
|
1210
1259
|
# TDE, can't be removed from an option group. Also, that option group
|
1211
|
-
# can't be removed from a DB instance
|
1212
|
-
# 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.
|
1213
1264
|
# @option options [String] :character_set_name
|
1214
|
-
# For supported engines, indicates that the DB instance
|
1215
|
-
# 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.
|
1216
1270
|
#
|
1217
1271
|
# **Amazon Aurora**
|
1218
1272
|
#
|
@@ -1220,6 +1274,8 @@ module Aws::RDS
|
|
1220
1274
|
# more information, see `CreateDBCluster`.
|
1221
1275
|
# @option options [String] :nchar_character_set_name
|
1222
1276
|
# The name of the NCHAR character set for the Oracle DB instance.
|
1277
|
+
#
|
1278
|
+
# This parameter doesn't apply to RDS Custom.
|
1223
1279
|
# @option options [Boolean] :publicly_accessible
|
1224
1280
|
# A value that indicates whether the DB instance is publicly accessible.
|
1225
1281
|
#
|
@@ -1257,6 +1313,8 @@ module Aws::RDS
|
|
1257
1313
|
# Tags to assign to the DB instance.
|
1258
1314
|
# @option options [String] :db_cluster_identifier
|
1259
1315
|
# The identifier of the DB cluster that the instance will belong to.
|
1316
|
+
#
|
1317
|
+
# This setting doesn't apply to RDS Custom.
|
1260
1318
|
# @option options [String] :storage_type
|
1261
1319
|
# Specifies the storage type to be associated with the DB instance.
|
1262
1320
|
#
|
@@ -1269,13 +1327,21 @@ module Aws::RDS
|
|
1269
1327
|
# @option options [String] :tde_credential_arn
|
1270
1328
|
# The ARN from the key store with which to associate the instance for
|
1271
1329
|
# TDE encryption.
|
1330
|
+
#
|
1331
|
+
# This setting doesn't apply to RDS Custom.
|
1272
1332
|
# @option options [String] :tde_credential_password
|
1273
1333
|
# The password for the given ARN from the key store in order to access
|
1274
1334
|
# the device.
|
1335
|
+
#
|
1336
|
+
# This setting doesn't apply to RDS Custom.
|
1275
1337
|
# @option options [Boolean] :storage_encrypted
|
1276
1338
|
# A value that indicates whether the DB instance is encrypted. By
|
1277
1339
|
# default, it isn't encrypted.
|
1278
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
|
+
#
|
1279
1345
|
# **Amazon Aurora**
|
1280
1346
|
#
|
1281
1347
|
# Not applicable. The encryption for DB instances is managed by the DB
|
@@ -1285,9 +1351,9 @@ module Aws::RDS
|
|
1285
1351
|
# instance.
|
1286
1352
|
#
|
1287
1353
|
# The Amazon Web Services KMS key identifier is the key ARN, key ID,
|
1288
|
-
# alias ARN, or alias name for the
|
1289
|
-
#
|
1290
|
-
#
|
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.
|
1291
1357
|
#
|
1292
1358
|
# **Amazon Aurora**
|
1293
1359
|
#
|
@@ -1295,10 +1361,18 @@ module Aws::RDS
|
|
1295
1361
|
# by the DB cluster. For more information, see `CreateDBCluster`.
|
1296
1362
|
#
|
1297
1363
|
# If `StorageEncrypted` is enabled, and you do not specify a value for
|
1298
|
-
# the `KmsKeyId` parameter, then Amazon RDS uses your default
|
1299
|
-
# is a default
|
1300
|
-
# Services account has a different default
|
1301
|
-
# 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.
|
1302
1376
|
# @option options [String] :domain
|
1303
1377
|
# The Active Directory directory ID to create the DB instance in.
|
1304
1378
|
# Currently, only MySQL, Microsoft SQL Server, Oracle, and PostgreSQL DB
|
@@ -1307,6 +1381,8 @@ module Aws::RDS
|
|
1307
1381
|
# For more information, see [ Kerberos Authentication][1] in the *Amazon
|
1308
1382
|
# RDS User Guide*.
|
1309
1383
|
#
|
1384
|
+
# This setting doesn't apply to RDS Custom.
|
1385
|
+
#
|
1310
1386
|
#
|
1311
1387
|
#
|
1312
1388
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
|
@@ -1321,35 +1397,43 @@ module Aws::RDS
|
|
1321
1397
|
# the DB cluster setting.
|
1322
1398
|
# @option options [Integer] :monitoring_interval
|
1323
1399
|
# The interval, in seconds, between points when Enhanced Monitoring
|
1324
|
-
# metrics are collected for the DB instance. To disable
|
1400
|
+
# metrics are collected for the DB instance. To disable collection of
|
1325
1401
|
# Enhanced Monitoring metrics, specify 0. The default is 0.
|
1326
1402
|
#
|
1327
|
-
# If `MonitoringRoleArn` is specified, then you must
|
1403
|
+
# If `MonitoringRoleArn` is specified, then you must set
|
1328
1404
|
# `MonitoringInterval` to a value other than 0.
|
1329
1405
|
#
|
1406
|
+
# This setting doesn't apply to RDS Custom.
|
1407
|
+
#
|
1330
1408
|
# Valid Values: `0, 1, 5, 10, 15, 30, 60`
|
1331
1409
|
# @option options [String] :monitoring_role_arn
|
1332
1410
|
# The ARN for the IAM role that permits RDS to send enhanced monitoring
|
1333
1411
|
# metrics to Amazon CloudWatch Logs. For example,
|
1334
1412
|
# `arn:aws:iam:123456789012:role/emaccess`. For information on creating
|
1335
|
-
# a monitoring role,
|
1413
|
+
# a monitoring role, see [Setting Up and Enabling Enhanced
|
1336
1414
|
# Monitoring][1] in the *Amazon RDS User Guide*.
|
1337
1415
|
#
|
1338
1416
|
# If `MonitoringInterval` is set to a value other than 0, then you must
|
1339
1417
|
# supply a `MonitoringRoleArn` value.
|
1340
1418
|
#
|
1419
|
+
# This setting doesn't apply to RDS Custom.
|
1420
|
+
#
|
1341
1421
|
#
|
1342
1422
|
#
|
1343
1423
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.html#USER_Monitoring.OS.Enabling
|
1344
1424
|
# @option options [String] :domain_iam_role_name
|
1345
1425
|
# Specify the name of the IAM role to be used when making API calls to
|
1346
1426
|
# the Directory Service.
|
1427
|
+
#
|
1428
|
+
# This setting doesn't apply to RDS Custom.
|
1347
1429
|
# @option options [Integer] :promotion_tier
|
1348
1430
|
# A value that specifies the order in which an Aurora Replica is
|
1349
1431
|
# promoted to the primary instance after a failure of the existing
|
1350
1432
|
# primary instance. For more information, see [ Fault Tolerance for an
|
1351
1433
|
# Aurora DB Cluster][1] in the *Amazon Aurora User Guide*.
|
1352
1434
|
#
|
1435
|
+
# This setting doesn't apply to RDS Custom.
|
1436
|
+
#
|
1353
1437
|
# Default: 1
|
1354
1438
|
#
|
1355
1439
|
# Valid Values: 0 - 15
|
@@ -1369,9 +1453,9 @@ module Aws::RDS
|
|
1369
1453
|
# Services Identity and Access Management (IAM) accounts to database
|
1370
1454
|
# accounts. By default, mapping is disabled.
|
1371
1455
|
#
|
1372
|
-
# This setting doesn't apply to Amazon Aurora.
|
1373
|
-
# Services IAM accounts to database accounts is
|
1374
|
-
# 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.
|
1375
1459
|
#
|
1376
1460
|
# For more information, see [ IAM Database Authentication for MySQL and
|
1377
1461
|
# PostgreSQL][1] in the *Amazon RDS User Guide.*
|
@@ -1381,10 +1465,10 @@ module Aws::RDS
|
|
1381
1465
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
|
1382
1466
|
# @option options [Boolean] :enable_performance_insights
|
1383
1467
|
# A value that indicates whether to enable Performance Insights for the
|
1384
|
-
# DB instance.
|
1468
|
+
# DB instance. For more information, see [Using Amazon Performance
|
1469
|
+
# Insights][1] in the *Amazon Relational Database Service User Guide*.
|
1385
1470
|
#
|
1386
|
-
#
|
1387
|
-
# the *Amazon Relational Database Service User Guide*.
|
1471
|
+
# This setting doesn't apply to RDS Custom.
|
1388
1472
|
#
|
1389
1473
|
#
|
1390
1474
|
#
|
@@ -1394,27 +1478,33 @@ module Aws::RDS
|
|
1394
1478
|
# Performance Insights data.
|
1395
1479
|
#
|
1396
1480
|
# The Amazon Web Services KMS key identifier is the key ARN, key ID,
|
1397
|
-
# alias ARN, or alias name for the
|
1398
|
-
# master key (CMK).
|
1481
|
+
# alias ARN, or alias name for the KMS key.
|
1399
1482
|
#
|
1400
1483
|
# If you do not specify a value for `PerformanceInsightsKMSKeyId`, then
|
1401
|
-
# Amazon RDS uses your default
|
1402
|
-
# Amazon Web Services account. Your Amazon Web Services account has
|
1403
|
-
# 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.
|
1404
1489
|
# @option options [Integer] :performance_insights_retention_period
|
1405
1490
|
# The amount of time, in days, to retain Performance Insights data.
|
1406
1491
|
# Valid values are 7 or 731 (2 years).
|
1492
|
+
#
|
1493
|
+
# This setting doesn't apply to RDS Custom.
|
1407
1494
|
# @option options [Array<String>] :enable_cloudwatch_logs_exports
|
1408
1495
|
# The list of log types that need to be enabled for exporting to
|
1409
|
-
# CloudWatch Logs. The values in the list depend on the DB engine
|
1410
|
-
#
|
1411
|
-
#
|
1412
|
-
# 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*.
|
1413
1499
|
#
|
1414
1500
|
# **Amazon Aurora**
|
1415
1501
|
#
|
1416
1502
|
# Not applicable. CloudWatch Logs exports are managed by the DB cluster.
|
1417
1503
|
#
|
1504
|
+
# **RDS Custom**
|
1505
|
+
#
|
1506
|
+
# Not applicable.
|
1507
|
+
#
|
1418
1508
|
# **MariaDB**
|
1419
1509
|
#
|
1420
1510
|
# Possible values are `audit`, `error`, `general`, and `slowquery`.
|
@@ -1442,6 +1532,8 @@ module Aws::RDS
|
|
1442
1532
|
# @option options [Array<Types::ProcessorFeature>] :processor_features
|
1443
1533
|
# The number of CPU cores and the number of threads per core for the DB
|
1444
1534
|
# instance class of the DB instance.
|
1535
|
+
#
|
1536
|
+
# This setting doesn't apply to RDS Custom.
|
1445
1537
|
# @option options [Boolean] :deletion_protection
|
1446
1538
|
# A value that indicates whether the DB instance has deletion protection
|
1447
1539
|
# enabled. The database can't be deleted when deletion protection is
|
@@ -1466,6 +1558,8 @@ module Aws::RDS
|
|
1466
1558
|
# apply to it, see [ Managing capacity automatically with Amazon RDS
|
1467
1559
|
# storage autoscaling][1] in the *Amazon RDS User Guide*.
|
1468
1560
|
#
|
1561
|
+
# This setting doesn't apply to RDS Custom.
|
1562
|
+
#
|
1469
1563
|
#
|
1470
1564
|
#
|
1471
1565
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
|
@@ -1489,6 +1583,28 @@ module Aws::RDS
|
|
1489
1583
|
#
|
1490
1584
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
|
1491
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
|
1492
1608
|
# @return [DBInstance]
|
1493
1609
|
def create_db_instance(options = {})
|
1494
1610
|
resp = @client.create_db_instance(options)
|
@@ -2130,6 +2246,10 @@ module Aws::RDS
|
|
2130
2246
|
# If this parameter is enabled and the requested engine supports the
|
2131
2247
|
# `CharacterSetName` parameter for `CreateDBInstance`, the response
|
2132
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.
|
2133
2253
|
# @option options [Boolean] :list_supported_timezones
|
2134
2254
|
# A value that indicates whether to list the supported time zones for
|
2135
2255
|
# each engine version.
|
@@ -2137,6 +2257,10 @@ module Aws::RDS
|
|
2137
2257
|
# If this parameter is enabled and the requested engine supports the
|
2138
2258
|
# `TimeZone` parameter for `CreateDBInstance`, the response includes a
|
2139
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.
|
2140
2264
|
# @option options [Boolean] :include_all
|
2141
2265
|
# A value that indicates whether to include engine versions that aren't
|
2142
2266
|
# available in the list. The default is to list only available engine
|
@@ -2440,6 +2564,8 @@ module Aws::RDS
|
|
2440
2564
|
# You can give an Amazon Web Services account permission to restore a
|
2441
2565
|
# manual DB snapshot from another Amazon Web Services account by using
|
2442
2566
|
# the `ModifyDBSnapshotAttribute` API action.
|
2567
|
+
#
|
2568
|
+
# This setting doesn't apply to RDS Custom.
|
2443
2569
|
# @option options [Boolean] :include_public
|
2444
2570
|
# A value that indicates whether to include manual DB cluster snapshots
|
2445
2571
|
# that are public and can be copied or restored by any Amazon Web
|
@@ -2447,6 +2573,8 @@ module Aws::RDS
|
|
2447
2573
|
#
|
2448
2574
|
# You can share a manual DB snapshot as public by using the
|
2449
2575
|
# ModifyDBSnapshotAttribute API.
|
2576
|
+
#
|
2577
|
+
# This setting doesn't apply to RDS Custom.
|
2450
2578
|
# @option options [String] :dbi_resource_id
|
2451
2579
|
# A specific DB resource ID to describe.
|
2452
2580
|
# @return [DBSnapshot::Collection]
|
@@ -2607,7 +2735,7 @@ module Aws::RDS
|
|
2607
2735
|
#
|
2608
2736
|
# events = rds.events({
|
2609
2737
|
# source_identifier: "String",
|
2610
|
-
# 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
|
2611
2739
|
# start_time: Time.now,
|
2612
2740
|
# end_time: Time.now,
|
2613
2741
|
# duration: 1,
|