aws-sdk-rds 1.110.0 → 1.115.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.
@@ -38,6 +38,7 @@ module Aws::RDS
38
38
  AvailabilityZones = Shapes::ListShape.new(name: 'AvailabilityZones')
39
39
  AvailableProcessorFeature = Shapes::StructureShape.new(name: 'AvailableProcessorFeature')
40
40
  AvailableProcessorFeatureList = Shapes::ListShape.new(name: 'AvailableProcessorFeatureList')
41
+ AwsBackupRecoveryPointArn = Shapes::StringShape.new(name: 'AwsBackupRecoveryPointArn')
41
42
  BacktrackDBClusterMessage = Shapes::StructureShape.new(name: 'BacktrackDBClusterMessage')
42
43
  BackupPolicyNotFoundFault = Shapes::StructureShape.new(name: 'BackupPolicyNotFoundFault')
43
44
  Boolean = Shapes::BooleanShape.new(name: 'Boolean')
@@ -110,6 +111,7 @@ module Aws::RDS
110
111
  DBClusterEndpointMessage = Shapes::StructureShape.new(name: 'DBClusterEndpointMessage')
111
112
  DBClusterEndpointNotFoundFault = Shapes::StructureShape.new(name: 'DBClusterEndpointNotFoundFault')
112
113
  DBClusterEndpointQuotaExceededFault = Shapes::StructureShape.new(name: 'DBClusterEndpointQuotaExceededFault')
114
+ DBClusterIdentifier = Shapes::StringShape.new(name: 'DBClusterIdentifier')
113
115
  DBClusterList = Shapes::ListShape.new(name: 'DBClusterList')
114
116
  DBClusterMember = Shapes::StructureShape.new(name: 'DBClusterMember')
115
117
  DBClusterMemberList = Shapes::ListShape.new(name: 'DBClusterMemberList')
@@ -319,12 +321,17 @@ module Aws::RDS
319
321
  ExportTasksMessage = Shapes::StructureShape.new(name: 'ExportTasksMessage')
320
322
  FailoverDBClusterMessage = Shapes::StructureShape.new(name: 'FailoverDBClusterMessage')
321
323
  FailoverDBClusterResult = Shapes::StructureShape.new(name: 'FailoverDBClusterResult')
324
+ FailoverGlobalClusterMessage = Shapes::StructureShape.new(name: 'FailoverGlobalClusterMessage')
325
+ FailoverGlobalClusterResult = Shapes::StructureShape.new(name: 'FailoverGlobalClusterResult')
326
+ FailoverState = Shapes::StructureShape.new(name: 'FailoverState')
327
+ FailoverStatus = Shapes::StringShape.new(name: 'FailoverStatus')
322
328
  FeatureNameList = Shapes::ListShape.new(name: 'FeatureNameList')
323
329
  Filter = Shapes::StructureShape.new(name: 'Filter')
324
330
  FilterList = Shapes::ListShape.new(name: 'FilterList')
325
331
  FilterValueList = Shapes::ListShape.new(name: 'FilterValueList')
326
332
  GlobalCluster = Shapes::StructureShape.new(name: 'GlobalCluster')
327
333
  GlobalClusterAlreadyExistsFault = Shapes::StructureShape.new(name: 'GlobalClusterAlreadyExistsFault')
334
+ GlobalClusterIdentifier = Shapes::StringShape.new(name: 'GlobalClusterIdentifier')
328
335
  GlobalClusterList = Shapes::ListShape.new(name: 'GlobalClusterList')
329
336
  GlobalClusterMember = Shapes::StructureShape.new(name: 'GlobalClusterMember')
330
337
  GlobalClusterMemberList = Shapes::ListShape.new(name: 'GlobalClusterMemberList')
@@ -1193,6 +1200,7 @@ module Aws::RDS
1193
1200
  DBClusterSnapshot.add_member(:db_cluster_identifier, Shapes::ShapeRef.new(shape: String, location_name: "DBClusterIdentifier"))
1194
1201
  DBClusterSnapshot.add_member(:snapshot_create_time, Shapes::ShapeRef.new(shape: TStamp, location_name: "SnapshotCreateTime"))
1195
1202
  DBClusterSnapshot.add_member(:engine, Shapes::ShapeRef.new(shape: String, location_name: "Engine"))
1203
+ DBClusterSnapshot.add_member(:engine_mode, Shapes::ShapeRef.new(shape: String, location_name: "EngineMode"))
1196
1204
  DBClusterSnapshot.add_member(:allocated_storage, Shapes::ShapeRef.new(shape: Integer, location_name: "AllocatedStorage"))
1197
1205
  DBClusterSnapshot.add_member(:status, Shapes::ShapeRef.new(shape: String, location_name: "Status"))
1198
1206
  DBClusterSnapshot.add_member(:port, Shapes::ShapeRef.new(shape: Integer, location_name: "Port"))
@@ -1320,6 +1328,7 @@ module Aws::RDS
1320
1328
  DBInstance.add_member(:tag_list, Shapes::ShapeRef.new(shape: TagList, location_name: "TagList"))
1321
1329
  DBInstance.add_member(:db_instance_automated_backups_replications, Shapes::ShapeRef.new(shape: DBInstanceAutomatedBackupsReplicationList, location_name: "DBInstanceAutomatedBackupsReplications"))
1322
1330
  DBInstance.add_member(:customer_owned_ip_enabled, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "CustomerOwnedIpEnabled"))
1331
+ DBInstance.add_member(:aws_backup_recovery_point_arn, Shapes::ShapeRef.new(shape: String, location_name: "AwsBackupRecoveryPointArn"))
1323
1332
  DBInstance.struct_class = Types::DBInstance
1324
1333
 
1325
1334
  DBInstanceAlreadyExistsFault.struct_class = Types::DBInstanceAlreadyExistsFault
@@ -2113,6 +2122,18 @@ module Aws::RDS
2113
2122
  FailoverDBClusterResult.add_member(:db_cluster, Shapes::ShapeRef.new(shape: DBCluster, location_name: "DBCluster"))
2114
2123
  FailoverDBClusterResult.struct_class = Types::FailoverDBClusterResult
2115
2124
 
2125
+ FailoverGlobalClusterMessage.add_member(:global_cluster_identifier, Shapes::ShapeRef.new(shape: GlobalClusterIdentifier, required: true, location_name: "GlobalClusterIdentifier"))
2126
+ FailoverGlobalClusterMessage.add_member(:target_db_cluster_identifier, Shapes::ShapeRef.new(shape: DBClusterIdentifier, required: true, location_name: "TargetDbClusterIdentifier"))
2127
+ FailoverGlobalClusterMessage.struct_class = Types::FailoverGlobalClusterMessage
2128
+
2129
+ FailoverGlobalClusterResult.add_member(:global_cluster, Shapes::ShapeRef.new(shape: GlobalCluster, location_name: "GlobalCluster"))
2130
+ FailoverGlobalClusterResult.struct_class = Types::FailoverGlobalClusterResult
2131
+
2132
+ FailoverState.add_member(:status, Shapes::ShapeRef.new(shape: FailoverStatus, location_name: "Status"))
2133
+ FailoverState.add_member(:from_db_cluster_arn, Shapes::ShapeRef.new(shape: String, location_name: "FromDbClusterArn"))
2134
+ FailoverState.add_member(:to_db_cluster_arn, Shapes::ShapeRef.new(shape: String, location_name: "ToDbClusterArn"))
2135
+ FailoverState.struct_class = Types::FailoverState
2136
+
2116
2137
  FeatureNameList.member = Shapes::ShapeRef.new(shape: String)
2117
2138
 
2118
2139
  Filter.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Name"))
@@ -2133,6 +2154,7 @@ module Aws::RDS
2133
2154
  GlobalCluster.add_member(:storage_encrypted, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "StorageEncrypted"))
2134
2155
  GlobalCluster.add_member(:deletion_protection, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "DeletionProtection"))
2135
2156
  GlobalCluster.add_member(:global_cluster_members, Shapes::ShapeRef.new(shape: GlobalClusterMemberList, location_name: "GlobalClusterMembers"))
2157
+ GlobalCluster.add_member(:failover_state, Shapes::ShapeRef.new(shape: FailoverState, location_name: "FailoverState"))
2136
2158
  GlobalCluster.struct_class = Types::GlobalCluster
2137
2159
 
2138
2160
  GlobalClusterAlreadyExistsFault.struct_class = Types::GlobalClusterAlreadyExistsFault
@@ -2372,6 +2394,7 @@ module Aws::RDS
2372
2394
  ModifyDBInstanceMessage.add_member(:certificate_rotation_restart, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "CertificateRotationRestart"))
2373
2395
  ModifyDBInstanceMessage.add_member(:replica_mode, Shapes::ShapeRef.new(shape: ReplicaMode, location_name: "ReplicaMode"))
2374
2396
  ModifyDBInstanceMessage.add_member(:enable_customer_owned_ip, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "EnableCustomerOwnedIp"))
2397
+ ModifyDBInstanceMessage.add_member(:aws_backup_recovery_point_arn, Shapes::ShapeRef.new(shape: AwsBackupRecoveryPointArn, location_name: "AwsBackupRecoveryPointArn"))
2375
2398
  ModifyDBInstanceMessage.struct_class = Types::ModifyDBInstanceMessage
2376
2399
 
2377
2400
  ModifyDBInstanceResult.add_member(:db_instance, Shapes::ShapeRef.new(shape: DBInstance, location_name: "DBInstance"))
@@ -3215,6 +3238,9 @@ module Aws::RDS
3215
3238
  UpgradeTarget.add_member(:description, Shapes::ShapeRef.new(shape: String, location_name: "Description"))
3216
3239
  UpgradeTarget.add_member(:auto_upgrade, Shapes::ShapeRef.new(shape: Boolean, location_name: "AutoUpgrade"))
3217
3240
  UpgradeTarget.add_member(:is_major_version_upgrade, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsMajorVersionUpgrade"))
3241
+ UpgradeTarget.add_member(:supported_engine_modes, Shapes::ShapeRef.new(shape: EngineModeList, location_name: "SupportedEngineModes"))
3242
+ UpgradeTarget.add_member(:supports_parallel_query, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "SupportsParallelQuery"))
3243
+ UpgradeTarget.add_member(:supports_global_databases, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "SupportsGlobalDatabases"))
3218
3244
  UpgradeTarget.struct_class = Types::UpgradeTarget
3219
3245
 
3220
3246
  UserAuthConfig.add_member(:description, Shapes::ShapeRef.new(shape: String, location_name: "Description"))
@@ -4412,6 +4438,18 @@ module Aws::RDS
4412
4438
  o.errors << Shapes::ShapeRef.new(shape: InvalidDBInstanceStateFault)
4413
4439
  end)
4414
4440
 
4441
+ api.add_operation(:failover_global_cluster, Seahorse::Model::Operation.new.tap do |o|
4442
+ o.name = "FailoverGlobalCluster"
4443
+ o.http_method = "POST"
4444
+ o.http_request_uri = "/"
4445
+ o.input = Shapes::ShapeRef.new(shape: FailoverGlobalClusterMessage)
4446
+ o.output = Shapes::ShapeRef.new(shape: FailoverGlobalClusterResult)
4447
+ o.errors << Shapes::ShapeRef.new(shape: GlobalClusterNotFoundFault)
4448
+ o.errors << Shapes::ShapeRef.new(shape: InvalidGlobalClusterStateFault)
4449
+ o.errors << Shapes::ShapeRef.new(shape: InvalidDBClusterStateFault)
4450
+ o.errors << Shapes::ShapeRef.new(shape: DBClusterNotFoundFault)
4451
+ end)
4452
+
4415
4453
  api.add_operation(:import_installation_media, Seahorse::Model::Operation.new.tap do |o|
4416
4454
  o.name = "ImportInstallationMedia"
4417
4455
  o.http_method = "POST"
@@ -929,13 +929,13 @@ module Aws::RDS
929
929
  #
930
930
  # **Aurora PostgreSQL**
931
931
  #
932
- # Possible values are `postgresql` and `upgrade`.
932
+ # Possible value is `postgresql`.
933
933
  #
934
934
  #
935
935
  #
936
936
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
937
937
  # @option options [String] :engine_mode
938
- # The DB engine mode of the DB cluster, either `provisioned`
938
+ # The DB engine mode of the DB cluster, either `provisioned`,
939
939
  # `serverless`, `parallelquery`, `global`, or `multimaster`.
940
940
  #
941
941
  # The `parallelquery` engine mode isn't required for Aurora MySQL
@@ -1015,12 +1015,19 @@ module Aws::RDS
1015
1015
  # Specify the name of the IAM role to be used when making API calls to
1016
1016
  # the Directory Service.
1017
1017
  # @option options [Boolean] :enable_global_write_forwarding
1018
- # A value that indicates whether to enable write operations to be
1019
- # forwarded from this cluster to the primary cluster in an Aurora global
1020
- # database. The resulting changes are replicated back to this cluster.
1021
- # This parameter only applies to DB clusters that are secondary clusters
1022
- # in an Aurora global database. By default, Aurora disallows write
1023
- # operations for secondary clusters.
1018
+ # A value that indicates whether to enable this DB cluster to forward
1019
+ # write operations to the primary cluster of an Aurora global database
1020
+ # (GlobalCluster). By default, write operations are not allowed on
1021
+ # Aurora DB clusters that are secondary clusters in an Aurora global
1022
+ # database.
1023
+ #
1024
+ # You can set this value only on Aurora DB clusters that are members of
1025
+ # an Aurora global database. With this parameter enabled, a secondary
1026
+ # cluster can forward writes to the current primary cluster and the
1027
+ # resulting changes are replicated back to this cluster. For the primary
1028
+ # DB cluster of an Aurora global database, this value is used
1029
+ # immediately if the primary is demoted by the FailoverGlobalCluster API
1030
+ # operation, but it does nothing until then.
1024
1031
  # @option options [String] :source_region
1025
1032
  # The source region of the snapshot. This is only needed when the
1026
1033
  # shapshot is encrypted and in a different region.
@@ -1410,12 +1417,19 @@ module Aws::RDS
1410
1417
  # A value that indicates whether to copy all tags from the DB cluster to
1411
1418
  # snapshots of the DB cluster. The default is not to copy them.
1412
1419
  # @option options [Boolean] :enable_global_write_forwarding
1413
- # A value that indicates whether to enable write operations to be
1414
- # forwarded from this cluster to the primary cluster in an Aurora global
1415
- # database. The resulting changes are replicated back to this cluster.
1416
- # This parameter only applies to DB clusters that are secondary clusters
1417
- # in an Aurora global database. By default, Aurora disallows write
1418
- # operations for secondary clusters.
1420
+ # A value that indicates whether to enable this DB cluster to forward
1421
+ # write operations to the primary cluster of an Aurora global database
1422
+ # (GlobalCluster). By default, write operations are not allowed on
1423
+ # Aurora DB clusters that are secondary clusters in an Aurora global
1424
+ # database.
1425
+ #
1426
+ # You can set this value only on Aurora DB clusters that are members of
1427
+ # an Aurora global database. With this parameter enabled, a secondary
1428
+ # cluster can forward writes to the current primary cluster and the
1429
+ # resulting changes are replicated back to this cluster. For the primary
1430
+ # DB cluster of an Aurora global database, this value is used
1431
+ # immediately if the primary is demoted by the FailoverGlobalCluster API
1432
+ # operation, but it does nothing until then.
1419
1433
  # @return [DBCluster]
1420
1434
  def modify(options = {})
1421
1435
  options = options.merge(db_cluster_identifier: @id)
@@ -58,12 +58,20 @@ module Aws::RDS
58
58
  data[:snapshot_create_time]
59
59
  end
60
60
 
61
- # Specifies the name of the database engine.
61
+ # Specifies the name of the database engine for this DB cluster
62
+ # snapshot.
62
63
  # @return [String]
63
64
  def engine
64
65
  data[:engine]
65
66
  end
66
67
 
68
+ # Provides the engine mode of the database engine for this DB cluster
69
+ # snapshot.
70
+ # @return [String]
71
+ def engine_mode
72
+ data[:engine_mode]
73
+ end
74
+
67
75
  # Specifies the allocated storage size in gibibytes (GiB).
68
76
  # @return [Integer]
69
77
  def allocated_storage
@@ -96,7 +104,7 @@ module Aws::RDS
96
104
  data[:cluster_create_time]
97
105
  end
98
106
 
99
- # Provides the master username for the DB cluster snapshot.
107
+ # Provides the master username for this DB cluster snapshot.
100
108
  # @return [String]
101
109
  def master_username
102
110
  data[:master_username]
@@ -570,6 +570,12 @@ module Aws::RDS
570
570
  data[:customer_owned_ip_enabled]
571
571
  end
572
572
 
573
+ # The Amazon Resource Name (ARN) of the recovery point in AWS Backup.
574
+ # @return [String]
575
+ def aws_backup_recovery_point_arn
576
+ data[:aws_backup_recovery_point_arn]
577
+ end
578
+
573
579
  # @!endgroup
574
580
 
575
581
  # @return [Client]
@@ -803,8 +809,8 @@ module Aws::RDS
803
809
  # **PostgreSQL**
804
810
  #
805
811
  # The name of the database to create when the DB instance is created. If
806
- # this parameter isn't specified, no database is created in the DB
807
- # instance.
812
+ # this parameter isn't specified, a database named `postgres` is
813
+ # created in the DB instance.
808
814
  #
809
815
  # Constraints:
810
816
  #
@@ -833,17 +839,34 @@ module Aws::RDS
833
839
  #
834
840
  # Not applicable. Must be null.
835
841
  #
836
- # **Amazon Aurora**
842
+ # **Amazon Aurora MySQL**
837
843
  #
838
- # The name of the database to create when the primary instance of the DB
839
- # cluster is created. If this parameter isn't specified, no database is
840
- # created in the DB instance.
844
+ # The name of the database to create when the primary DB instance of the
845
+ # Aurora MySQL DB cluster is created. If this parameter isn't specified
846
+ # for an Aurora MySQL DB cluster, no database is created in the DB
847
+ # cluster.
841
848
  #
842
849
  # Constraints:
843
850
  #
844
- # * Must contain 1 to 64 letters or numbers.
851
+ # * It must contain 1 to 64 alphanumeric characters.
845
852
  #
846
- # * Can't be a word reserved by the specified database engine
853
+ # * It can't be a word reserved by the database engine.
854
+ #
855
+ # **Amazon Aurora PostgreSQL**
856
+ #
857
+ # The name of the database to create when the primary DB instance of the
858
+ # Aurora PostgreSQL DB cluster is created. If this parameter isn't
859
+ # specified for an Aurora PostgreSQL DB cluster, a database named
860
+ # `postgres` is created in the DB cluster.
861
+ #
862
+ # Constraints:
863
+ #
864
+ # * It must contain 1 to 63 alphanumeric characters.
865
+ #
866
+ # * It must begin with a letter or an underscore. Subsequent characters
867
+ # can be letters, underscores, or digits (0 to 9).
868
+ #
869
+ # * It can't be a word reserved by the database engine.
847
870
  # @option options [Integer] :allocated_storage
848
871
  # The amount of storage (in gibibytes) to allocate for the DB instance.
849
872
  #
@@ -1566,6 +1589,14 @@ module Aws::RDS
1566
1589
  # @option options [Integer] :max_allocated_storage
1567
1590
  # The upper limit to which Amazon RDS can automatically scale the
1568
1591
  # storage of the DB instance.
1592
+ #
1593
+ # For more information about this setting, including limitations that
1594
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
1595
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
1596
+ #
1597
+ #
1598
+ #
1599
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
1569
1600
  # @option options [Boolean] :enable_customer_owned_ip
1570
1601
  # A value that indicates whether to enable a customer-owned IP address
1571
1602
  # (CoIP) for an RDS on Outposts DB instance.
@@ -1981,6 +2012,14 @@ module Aws::RDS
1981
2012
  # @option options [Integer] :max_allocated_storage
1982
2013
  # The upper limit to which Amazon RDS can automatically scale the
1983
2014
  # storage of the DB instance.
2015
+ #
2016
+ # For more information about this setting, including limitations that
2017
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
2018
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
2019
+ #
2020
+ #
2021
+ #
2022
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
1984
2023
  # @option options [String] :source_region
1985
2024
  # The source region of the snapshot. This is only needed when the
1986
2025
  # shapshot is encrypted and in a different region.
@@ -2153,6 +2192,7 @@ module Aws::RDS
2153
2192
  # certificate_rotation_restart: false,
2154
2193
  # replica_mode: "open-read-only", # accepts open-read-only, mounted
2155
2194
  # enable_customer_owned_ip: false,
2195
+ # aws_backup_recovery_point_arn: "AwsBackupRecoveryPointArn",
2156
2196
  # })
2157
2197
  # @param [Hash] options ({})
2158
2198
  # @option options [Integer] :allocated_storage
@@ -2696,6 +2736,14 @@ module Aws::RDS
2696
2736
  # @option options [Integer] :max_allocated_storage
2697
2737
  # The upper limit to which Amazon RDS can automatically scale the
2698
2738
  # storage of the DB instance.
2739
+ #
2740
+ # For more information about this setting, including limitations that
2741
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
2742
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
2743
+ #
2744
+ #
2745
+ #
2746
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
2699
2747
  # @option options [Boolean] :certificate_rotation_restart
2700
2748
  # A value that indicates whether the DB instance is restarted when you
2701
2749
  # rotate your SSL/TLS certificate.
@@ -2761,6 +2809,8 @@ module Aws::RDS
2761
2809
  #
2762
2810
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
2763
2811
  # [2]: https://docs.aws.amazon.com/outposts/latest/userguide/outposts-networking-components.html#ip-addressing
2812
+ # @option options [String] :aws_backup_recovery_point_arn
2813
+ # The Amazon Resource Name (ARN) of the recovery point in AWS Backup.
2764
2814
  # @return [DBInstance]
2765
2815
  def modify(options = {})
2766
2816
  options = options.merge(db_instance_identifier: @id)
@@ -3146,6 +3196,14 @@ module Aws::RDS
3146
3196
  # @option options [Integer] :max_allocated_storage
3147
3197
  # The upper limit to which Amazon RDS can automatically scale the
3148
3198
  # storage of the DB instance.
3199
+ #
3200
+ # For more information about this setting, including limitations that
3201
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
3202
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
3203
+ #
3204
+ #
3205
+ #
3206
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
3149
3207
  # @option options [String] :source_db_instance_automated_backups_arn
3150
3208
  # The Amazon Resource Name (ARN) of the replicated automated backups
3151
3209
  # from which to restore, for example,
@@ -236,6 +236,30 @@ module Aws::RDS
236
236
  # @option options [required, String] :engine_name
237
237
  # Specifies the name of the engine that this option group should be
238
238
  # associated with.
239
+ #
240
+ # Valid Values:
241
+ #
242
+ # * `mariadb`
243
+ #
244
+ # * `mysql`
245
+ #
246
+ # * `oracle-ee`
247
+ #
248
+ # * `oracle-se2`
249
+ #
250
+ # * `oracle-se1`
251
+ #
252
+ # * `oracle-se`
253
+ #
254
+ # * `postgres`
255
+ #
256
+ # * `sqlserver-ee`
257
+ #
258
+ # * `sqlserver-se`
259
+ #
260
+ # * `sqlserver-ex`
261
+ #
262
+ # * `sqlserver-web`
239
263
  # @option options [required, String] :major_engine_version
240
264
  # Specifies the major version of the engine that this option group
241
265
  # should be associated with.
@@ -365,13 +365,13 @@ module Aws::RDS
365
365
  #
366
366
  # **Aurora PostgreSQL**
367
367
  #
368
- # Possible values are `postgresql` and `upgrade`.
368
+ # Possible value is `postgresql`.
369
369
  #
370
370
  #
371
371
  #
372
372
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
373
373
  # @option options [String] :engine_mode
374
- # The DB engine mode of the DB cluster, either `provisioned`
374
+ # The DB engine mode of the DB cluster, either `provisioned`,
375
375
  # `serverless`, `parallelquery`, `global`, or `multimaster`.
376
376
  #
377
377
  # The `parallelquery` engine mode isn't required for Aurora MySQL
@@ -451,12 +451,19 @@ module Aws::RDS
451
451
  # Specify the name of the IAM role to be used when making API calls to
452
452
  # the Directory Service.
453
453
  # @option options [Boolean] :enable_global_write_forwarding
454
- # A value that indicates whether to enable write operations to be
455
- # forwarded from this cluster to the primary cluster in an Aurora global
456
- # database. The resulting changes are replicated back to this cluster.
457
- # This parameter only applies to DB clusters that are secondary clusters
458
- # in an Aurora global database. By default, Aurora disallows write
459
- # operations for secondary clusters.
454
+ # A value that indicates whether to enable this DB cluster to forward
455
+ # write operations to the primary cluster of an Aurora global database
456
+ # (GlobalCluster). By default, write operations are not allowed on
457
+ # Aurora DB clusters that are secondary clusters in an Aurora global
458
+ # database.
459
+ #
460
+ # You can set this value only on Aurora DB clusters that are members of
461
+ # an Aurora global database. With this parameter enabled, a secondary
462
+ # cluster can forward writes to the current primary cluster and the
463
+ # resulting changes are replicated back to this cluster. For the primary
464
+ # DB cluster of an Aurora global database, this value is used
465
+ # immediately if the primary is demoted by the FailoverGlobalCluster API
466
+ # operation, but it does nothing until then.
460
467
  # @option options [String] :source_region
461
468
  # The source region of the snapshot. This is only needed when the
462
469
  # shapshot is encrypted and in a different region.
@@ -624,8 +631,8 @@ module Aws::RDS
624
631
  # **PostgreSQL**
625
632
  #
626
633
  # The name of the database to create when the DB instance is created. If
627
- # this parameter isn't specified, no database is created in the DB
628
- # instance.
634
+ # this parameter isn't specified, a database named `postgres` is
635
+ # created in the DB instance.
629
636
  #
630
637
  # Constraints:
631
638
  #
@@ -654,17 +661,34 @@ module Aws::RDS
654
661
  #
655
662
  # Not applicable. Must be null.
656
663
  #
657
- # **Amazon Aurora**
664
+ # **Amazon Aurora MySQL**
658
665
  #
659
- # The name of the database to create when the primary instance of the DB
660
- # cluster is created. If this parameter isn't specified, no database is
661
- # created in the DB instance.
666
+ # The name of the database to create when the primary DB instance of the
667
+ # Aurora MySQL DB cluster is created. If this parameter isn't specified
668
+ # for an Aurora MySQL DB cluster, no database is created in the DB
669
+ # cluster.
662
670
  #
663
671
  # Constraints:
664
672
  #
665
- # * Must contain 1 to 64 letters or numbers.
673
+ # * It must contain 1 to 64 alphanumeric characters.
666
674
  #
667
- # * Can't be a word reserved by the specified database engine
675
+ # * It can't be a word reserved by the database engine.
676
+ #
677
+ # **Amazon Aurora PostgreSQL**
678
+ #
679
+ # The name of the database to create when the primary DB instance of the
680
+ # Aurora PostgreSQL DB cluster is created. If this parameter isn't
681
+ # specified for an Aurora PostgreSQL DB cluster, a database named
682
+ # `postgres` is created in the DB cluster.
683
+ #
684
+ # Constraints:
685
+ #
686
+ # * It must contain 1 to 63 alphanumeric characters.
687
+ #
688
+ # * It must begin with a letter or an underscore. Subsequent characters
689
+ # can be letters, underscores, or digits (0 to 9).
690
+ #
691
+ # * It can't be a word reserved by the database engine.
668
692
  # @option options [required, String] :db_instance_identifier
669
693
  # The DB instance identifier. This parameter is stored as a lowercase
670
694
  # string.
@@ -1400,6 +1424,14 @@ module Aws::RDS
1400
1424
  # @option options [Integer] :max_allocated_storage
1401
1425
  # The upper limit to which Amazon RDS can automatically scale the
1402
1426
  # storage of the DB instance.
1427
+ #
1428
+ # For more information about this setting, including limitations that
1429
+ # apply to it, see [ Managing capacity automatically with Amazon RDS
1430
+ # storage autoscaling][1] in the *Amazon RDS User Guide*.
1431
+ #
1432
+ #
1433
+ #
1434
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
1403
1435
  # @option options [Boolean] :enable_customer_owned_ip
1404
1436
  # A value that indicates whether to enable a customer-owned IP address
1405
1437
  # (CoIP) for an RDS on Outposts DB instance.
@@ -1688,6 +1720,30 @@ module Aws::RDS
1688
1720
  # @option options [required, String] :engine_name
1689
1721
  # Specifies the name of the engine that this option group should be
1690
1722
  # associated with.
1723
+ #
1724
+ # Valid Values:
1725
+ #
1726
+ # * `mariadb`
1727
+ #
1728
+ # * `mysql`
1729
+ #
1730
+ # * `oracle-ee`
1731
+ #
1732
+ # * `oracle-se2`
1733
+ #
1734
+ # * `oracle-se1`
1735
+ #
1736
+ # * `oracle-se`
1737
+ #
1738
+ # * `postgres`
1739
+ #
1740
+ # * `sqlserver-ee`
1741
+ #
1742
+ # * `sqlserver-se`
1743
+ #
1744
+ # * `sqlserver-ex`
1745
+ #
1746
+ # * `sqlserver-web`
1691
1747
  # @option options [required, String] :major_engine_version
1692
1748
  # Specifies the major version of the engine that this option group
1693
1749
  # should be associated with.
@@ -1936,6 +1992,36 @@ module Aws::RDS
1936
1992
  # @param [Hash] options ({})
1937
1993
  # @option options [String] :engine
1938
1994
  # The database engine to return.
1995
+ #
1996
+ # Valid Values:
1997
+ #
1998
+ # * `aurora` (for MySQL 5.6-compatible Aurora)
1999
+ #
2000
+ # * `aurora-mysql` (for MySQL 5.7-compatible Aurora)
2001
+ #
2002
+ # * `aurora-postgresql`
2003
+ #
2004
+ # * `mariadb`
2005
+ #
2006
+ # * `mysql`
2007
+ #
2008
+ # * `oracle-ee`
2009
+ #
2010
+ # * `oracle-se2`
2011
+ #
2012
+ # * `oracle-se1`
2013
+ #
2014
+ # * `oracle-se`
2015
+ #
2016
+ # * `postgres`
2017
+ #
2018
+ # * `sqlserver-ee`
2019
+ #
2020
+ # * `sqlserver-se`
2021
+ #
2022
+ # * `sqlserver-ex`
2023
+ #
2024
+ # * `sqlserver-web`
1939
2025
  # @option options [String] :engine_version
1940
2026
  # The database engine version to return.
1941
2027
  #
@@ -2562,6 +2648,30 @@ module Aws::RDS
2562
2648
  # @option options [String] :engine_name
2563
2649
  # Filters the list of option groups to only include groups associated
2564
2650
  # with a specific database engine.
2651
+ #
2652
+ # Valid Values:
2653
+ #
2654
+ # * `mariadb`
2655
+ #
2656
+ # * `mysql`
2657
+ #
2658
+ # * `oracle-ee`
2659
+ #
2660
+ # * `oracle-se2`
2661
+ #
2662
+ # * `oracle-se1`
2663
+ #
2664
+ # * `oracle-se`
2665
+ #
2666
+ # * `postgres`
2667
+ #
2668
+ # * `sqlserver-ee`
2669
+ #
2670
+ # * `sqlserver-se`
2671
+ #
2672
+ # * `sqlserver-ex`
2673
+ #
2674
+ # * `sqlserver-web`
2565
2675
  # @option options [String] :major_engine_version
2566
2676
  # Filters the list of option groups to only include groups associated
2567
2677
  # with a specific database engine version. If specified, then EngineName