aws-sdk-rds 1.17.0 → 1.18.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.
@@ -30,6 +30,7 @@ module Aws::RDS
30
30
  AvailabilityZone = Shapes::StructureShape.new(name: 'AvailabilityZone')
31
31
  AvailabilityZoneList = Shapes::ListShape.new(name: 'AvailabilityZoneList')
32
32
  AvailabilityZones = Shapes::ListShape.new(name: 'AvailabilityZones')
33
+ BacktrackDBClusterMessage = Shapes::StructureShape.new(name: 'BacktrackDBClusterMessage')
33
34
  Boolean = Shapes::BooleanShape.new(name: 'Boolean')
34
35
  BooleanOptional = Shapes::BooleanShape.new(name: 'BooleanOptional')
35
36
  Certificate = Shapes::StructureShape.new(name: 'Certificate')
@@ -72,6 +73,10 @@ module Aws::RDS
72
73
  CreateOptionGroupResult = Shapes::StructureShape.new(name: 'CreateOptionGroupResult')
73
74
  DBCluster = Shapes::StructureShape.new(name: 'DBCluster')
74
75
  DBClusterAlreadyExistsFault = Shapes::StructureShape.new(name: 'DBClusterAlreadyExistsFault')
76
+ DBClusterBacktrack = Shapes::StructureShape.new(name: 'DBClusterBacktrack')
77
+ DBClusterBacktrackList = Shapes::ListShape.new(name: 'DBClusterBacktrackList')
78
+ DBClusterBacktrackMessage = Shapes::StructureShape.new(name: 'DBClusterBacktrackMessage')
79
+ DBClusterBacktrackNotFoundFault = Shapes::StructureShape.new(name: 'DBClusterBacktrackNotFoundFault')
75
80
  DBClusterList = Shapes::ListShape.new(name: 'DBClusterList')
76
81
  DBClusterMember = Shapes::StructureShape.new(name: 'DBClusterMember')
77
82
  DBClusterMemberList = Shapes::ListShape.new(name: 'DBClusterMemberList')
@@ -165,6 +170,7 @@ module Aws::RDS
165
170
  DeleteOptionGroupMessage = Shapes::StructureShape.new(name: 'DeleteOptionGroupMessage')
166
171
  DescribeAccountAttributesMessage = Shapes::StructureShape.new(name: 'DescribeAccountAttributesMessage')
167
172
  DescribeCertificatesMessage = Shapes::StructureShape.new(name: 'DescribeCertificatesMessage')
173
+ DescribeDBClusterBacktracksMessage = Shapes::StructureShape.new(name: 'DescribeDBClusterBacktracksMessage')
168
174
  DescribeDBClusterParameterGroupsMessage = Shapes::StructureShape.new(name: 'DescribeDBClusterParameterGroupsMessage')
169
175
  DescribeDBClusterParametersMessage = Shapes::StructureShape.new(name: 'DescribeDBClusterParametersMessage')
170
176
  DescribeDBClusterSnapshotAttributesMessage = Shapes::StructureShape.new(name: 'DescribeDBClusterSnapshotAttributesMessage')
@@ -257,6 +263,7 @@ module Aws::RDS
257
263
  ListTagsForResourceMessage = Shapes::StructureShape.new(name: 'ListTagsForResourceMessage')
258
264
  LogTypeList = Shapes::ListShape.new(name: 'LogTypeList')
259
265
  Long = Shapes::IntegerShape.new(name: 'Long')
266
+ LongOptional = Shapes::IntegerShape.new(name: 'LongOptional')
260
267
  ModifyDBClusterMessage = Shapes::StructureShape.new(name: 'ModifyDBClusterMessage')
261
268
  ModifyDBClusterParameterGroupMessage = Shapes::StructureShape.new(name: 'ModifyDBClusterParameterGroupMessage')
262
269
  ModifyDBClusterResult = Shapes::StructureShape.new(name: 'ModifyDBClusterResult')
@@ -453,6 +460,12 @@ module Aws::RDS
453
460
 
454
461
  AvailabilityZones.member = Shapes::ShapeRef.new(shape: String, location_name: "AvailabilityZone")
455
462
 
463
+ BacktrackDBClusterMessage.add_member(:db_cluster_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBClusterIdentifier"))
464
+ BacktrackDBClusterMessage.add_member(:backtrack_to, Shapes::ShapeRef.new(shape: TStamp, required: true, location_name: "BacktrackTo"))
465
+ BacktrackDBClusterMessage.add_member(:force, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "Force"))
466
+ BacktrackDBClusterMessage.add_member(:use_earliest_time_on_point_in_time_unavailable, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "UseEarliestTimeOnPointInTimeUnavailable"))
467
+ BacktrackDBClusterMessage.struct_class = Types::BacktrackDBClusterMessage
468
+
456
469
  Certificate.add_member(:certificate_identifier, Shapes::ShapeRef.new(shape: String, location_name: "CertificateIdentifier"))
457
470
  Certificate.add_member(:certificate_type, Shapes::ShapeRef.new(shape: String, location_name: "CertificateType"))
458
471
  Certificate.add_member(:thumbprint, Shapes::ShapeRef.new(shape: String, location_name: "Thumbprint"))
@@ -551,6 +564,7 @@ module Aws::RDS
551
564
  CreateDBClusterMessage.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "KmsKeyId"))
552
565
  CreateDBClusterMessage.add_member(:pre_signed_url, Shapes::ShapeRef.new(shape: String, location_name: "PreSignedUrl"))
553
566
  CreateDBClusterMessage.add_member(:enable_iam_database_authentication, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "EnableIAMDatabaseAuthentication"))
567
+ CreateDBClusterMessage.add_member(:backtrack_window, Shapes::ShapeRef.new(shape: LongOptional, location_name: "BacktrackWindow"))
554
568
  CreateDBClusterMessage.add_member(:destination_region, Shapes::ShapeRef.new(shape: String, location_name: "DestinationRegion", metadata: {"documented"=>false}))
555
569
  CreateDBClusterMessage.add_member(:source_region, Shapes::ShapeRef.new(shape: String, location_name: "SourceRegion"))
556
570
  CreateDBClusterMessage.struct_class = Types::CreateDBClusterMessage
@@ -742,8 +756,25 @@ module Aws::RDS
742
756
  DBCluster.add_member(:iam_database_authentication_enabled, Shapes::ShapeRef.new(shape: Boolean, location_name: "IAMDatabaseAuthenticationEnabled"))
743
757
  DBCluster.add_member(:clone_group_id, Shapes::ShapeRef.new(shape: String, location_name: "CloneGroupId"))
744
758
  DBCluster.add_member(:cluster_create_time, Shapes::ShapeRef.new(shape: TStamp, location_name: "ClusterCreateTime"))
759
+ DBCluster.add_member(:earliest_backtrack_time, Shapes::ShapeRef.new(shape: TStamp, location_name: "EarliestBacktrackTime"))
760
+ DBCluster.add_member(:backtrack_window, Shapes::ShapeRef.new(shape: LongOptional, location_name: "BacktrackWindow"))
761
+ DBCluster.add_member(:backtrack_consumed_change_records, Shapes::ShapeRef.new(shape: LongOptional, location_name: "BacktrackConsumedChangeRecords"))
745
762
  DBCluster.struct_class = Types::DBCluster
746
763
 
764
+ DBClusterBacktrack.add_member(:db_cluster_identifier, Shapes::ShapeRef.new(shape: String, location_name: "DBClusterIdentifier"))
765
+ DBClusterBacktrack.add_member(:backtrack_identifier, Shapes::ShapeRef.new(shape: String, location_name: "BacktrackIdentifier"))
766
+ DBClusterBacktrack.add_member(:backtrack_to, Shapes::ShapeRef.new(shape: TStamp, location_name: "BacktrackTo"))
767
+ DBClusterBacktrack.add_member(:backtracked_from, Shapes::ShapeRef.new(shape: TStamp, location_name: "BacktrackedFrom"))
768
+ DBClusterBacktrack.add_member(:backtrack_request_creation_time, Shapes::ShapeRef.new(shape: TStamp, location_name: "BacktrackRequestCreationTime"))
769
+ DBClusterBacktrack.add_member(:status, Shapes::ShapeRef.new(shape: String, location_name: "Status"))
770
+ DBClusterBacktrack.struct_class = Types::DBClusterBacktrack
771
+
772
+ DBClusterBacktrackList.member = Shapes::ShapeRef.new(shape: DBClusterBacktrack, location_name: "DBClusterBacktrack")
773
+
774
+ DBClusterBacktrackMessage.add_member(:marker, Shapes::ShapeRef.new(shape: String, location_name: "Marker"))
775
+ DBClusterBacktrackMessage.add_member(:db_cluster_backtracks, Shapes::ShapeRef.new(shape: DBClusterBacktrackList, location_name: "DBClusterBacktracks"))
776
+ DBClusterBacktrackMessage.struct_class = Types::DBClusterBacktrackMessage
777
+
747
778
  DBClusterList.member = Shapes::ShapeRef.new(shape: DBCluster, location_name: "DBCluster")
748
779
 
749
780
  DBClusterMember.add_member(:db_instance_identifier, Shapes::ShapeRef.new(shape: String, location_name: "DBInstanceIdentifier"))
@@ -1078,6 +1109,13 @@ module Aws::RDS
1078
1109
  DescribeCertificatesMessage.add_member(:marker, Shapes::ShapeRef.new(shape: String, location_name: "Marker"))
1079
1110
  DescribeCertificatesMessage.struct_class = Types::DescribeCertificatesMessage
1080
1111
 
1112
+ DescribeDBClusterBacktracksMessage.add_member(:db_cluster_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBClusterIdentifier"))
1113
+ DescribeDBClusterBacktracksMessage.add_member(:backtrack_identifier, Shapes::ShapeRef.new(shape: String, location_name: "BacktrackIdentifier"))
1114
+ DescribeDBClusterBacktracksMessage.add_member(:filters, Shapes::ShapeRef.new(shape: FilterList, location_name: "Filters"))
1115
+ DescribeDBClusterBacktracksMessage.add_member(:max_records, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "MaxRecords"))
1116
+ DescribeDBClusterBacktracksMessage.add_member(:marker, Shapes::ShapeRef.new(shape: String, location_name: "Marker"))
1117
+ DescribeDBClusterBacktracksMessage.struct_class = Types::DescribeDBClusterBacktracksMessage
1118
+
1081
1119
  DescribeDBClusterParameterGroupsMessage.add_member(:db_cluster_parameter_group_name, Shapes::ShapeRef.new(shape: String, location_name: "DBClusterParameterGroupName"))
1082
1120
  DescribeDBClusterParameterGroupsMessage.add_member(:filters, Shapes::ShapeRef.new(shape: FilterList, location_name: "Filters"))
1083
1121
  DescribeDBClusterParameterGroupsMessage.add_member(:max_records, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "MaxRecords"))
@@ -1423,6 +1461,7 @@ module Aws::RDS
1423
1461
  ModifyDBClusterMessage.add_member(:preferred_backup_window, Shapes::ShapeRef.new(shape: String, location_name: "PreferredBackupWindow"))
1424
1462
  ModifyDBClusterMessage.add_member(:preferred_maintenance_window, Shapes::ShapeRef.new(shape: String, location_name: "PreferredMaintenanceWindow"))
1425
1463
  ModifyDBClusterMessage.add_member(:enable_iam_database_authentication, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "EnableIAMDatabaseAuthentication"))
1464
+ ModifyDBClusterMessage.add_member(:backtrack_window, Shapes::ShapeRef.new(shape: LongOptional, location_name: "BacktrackWindow"))
1426
1465
  ModifyDBClusterMessage.add_member(:engine_version, Shapes::ShapeRef.new(shape: String, location_name: "EngineVersion"))
1427
1466
  ModifyDBClusterMessage.struct_class = Types::ModifyDBClusterMessage
1428
1467
 
@@ -1859,6 +1898,7 @@ module Aws::RDS
1859
1898
  RestoreDBClusterFromS3Message.add_member(:s3_bucket_name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "S3BucketName"))
1860
1899
  RestoreDBClusterFromS3Message.add_member(:s3_prefix, Shapes::ShapeRef.new(shape: String, location_name: "S3Prefix"))
1861
1900
  RestoreDBClusterFromS3Message.add_member(:s3_ingestion_role_arn, Shapes::ShapeRef.new(shape: String, required: true, location_name: "S3IngestionRoleArn"))
1901
+ RestoreDBClusterFromS3Message.add_member(:backtrack_window, Shapes::ShapeRef.new(shape: LongOptional, location_name: "BacktrackWindow"))
1862
1902
  RestoreDBClusterFromS3Message.struct_class = Types::RestoreDBClusterFromS3Message
1863
1903
 
1864
1904
  RestoreDBClusterFromS3Result.add_member(:db_cluster, Shapes::ShapeRef.new(shape: DBCluster, location_name: "DBCluster"))
@@ -1877,6 +1917,7 @@ module Aws::RDS
1877
1917
  RestoreDBClusterFromSnapshotMessage.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
1878
1918
  RestoreDBClusterFromSnapshotMessage.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "KmsKeyId"))
1879
1919
  RestoreDBClusterFromSnapshotMessage.add_member(:enable_iam_database_authentication, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "EnableIAMDatabaseAuthentication"))
1920
+ RestoreDBClusterFromSnapshotMessage.add_member(:backtrack_window, Shapes::ShapeRef.new(shape: LongOptional, location_name: "BacktrackWindow"))
1880
1921
  RestoreDBClusterFromSnapshotMessage.struct_class = Types::RestoreDBClusterFromSnapshotMessage
1881
1922
 
1882
1923
  RestoreDBClusterFromSnapshotResult.add_member(:db_cluster, Shapes::ShapeRef.new(shape: DBCluster, location_name: "DBCluster"))
@@ -1894,6 +1935,7 @@ module Aws::RDS
1894
1935
  RestoreDBClusterToPointInTimeMessage.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
1895
1936
  RestoreDBClusterToPointInTimeMessage.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "KmsKeyId"))
1896
1937
  RestoreDBClusterToPointInTimeMessage.add_member(:enable_iam_database_authentication, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "EnableIAMDatabaseAuthentication"))
1938
+ RestoreDBClusterToPointInTimeMessage.add_member(:backtrack_window, Shapes::ShapeRef.new(shape: LongOptional, location_name: "BacktrackWindow"))
1897
1939
  RestoreDBClusterToPointInTimeMessage.struct_class = Types::RestoreDBClusterToPointInTimeMessage
1898
1940
 
1899
1941
  RestoreDBClusterToPointInTimeResult.add_member(:db_cluster, Shapes::ShapeRef.new(shape: DBCluster, location_name: "DBCluster"))
@@ -2158,6 +2200,16 @@ module Aws::RDS
2158
2200
  o.errors << Shapes::ShapeRef.new(shape: AuthorizationQuotaExceededFault)
2159
2201
  end)
2160
2202
 
2203
+ api.add_operation(:backtrack_db_cluster, Seahorse::Model::Operation.new.tap do |o|
2204
+ o.name = "BacktrackDBCluster"
2205
+ o.http_method = "POST"
2206
+ o.http_request_uri = "/"
2207
+ o.input = Shapes::ShapeRef.new(shape: BacktrackDBClusterMessage)
2208
+ o.output = Shapes::ShapeRef.new(shape: DBClusterBacktrack)
2209
+ o.errors << Shapes::ShapeRef.new(shape: DBClusterNotFoundFault)
2210
+ o.errors << Shapes::ShapeRef.new(shape: InvalidDBClusterStateFault)
2211
+ end)
2212
+
2161
2213
  api.add_operation(:copy_db_cluster_parameter_group, Seahorse::Model::Operation.new.tap do |o|
2162
2214
  o.name = "CopyDBClusterParameterGroup"
2163
2215
  o.http_method = "POST"
@@ -2511,6 +2563,16 @@ module Aws::RDS
2511
2563
  o.errors << Shapes::ShapeRef.new(shape: CertificateNotFoundFault)
2512
2564
  end)
2513
2565
 
2566
+ api.add_operation(:describe_db_cluster_backtracks, Seahorse::Model::Operation.new.tap do |o|
2567
+ o.name = "DescribeDBClusterBacktracks"
2568
+ o.http_method = "POST"
2569
+ o.http_request_uri = "/"
2570
+ o.input = Shapes::ShapeRef.new(shape: DescribeDBClusterBacktracksMessage)
2571
+ o.output = Shapes::ShapeRef.new(shape: DBClusterBacktrackMessage)
2572
+ o.errors << Shapes::ShapeRef.new(shape: DBClusterNotFoundFault)
2573
+ o.errors << Shapes::ShapeRef.new(shape: DBClusterBacktrackNotFoundFault)
2574
+ end)
2575
+
2514
2576
  api.add_operation(:describe_db_cluster_parameter_groups, Seahorse::Model::Operation.new.tap do |o|
2515
2577
  o.name = "DescribeDBClusterParameterGroups"
2516
2578
  o.http_method = "POST"
@@ -96,7 +96,7 @@ module Aws::RDS
96
96
  data[:percent_progress]
97
97
  end
98
98
 
99
- # Specifies the earliest time to which a database can be restored with
99
+ # The earliest time to which a database can be restored with
100
100
  # point-in-time restore.
101
101
  # @return [Time]
102
102
  def earliest_restorable_time
@@ -275,6 +275,26 @@ module Aws::RDS
275
275
  data[:cluster_create_time]
276
276
  end
277
277
 
278
+ # The earliest time to which a DB cluster can be backtracked.
279
+ # @return [Time]
280
+ def earliest_backtrack_time
281
+ data[:earliest_backtrack_time]
282
+ end
283
+
284
+ # The target backtrack window, in seconds. If this value is set to 0,
285
+ # backtracking is disabled for the DB cluster. Otherwise, backtracking
286
+ # is enabled.
287
+ # @return [Integer]
288
+ def backtrack_window
289
+ data[:backtrack_window]
290
+ end
291
+
292
+ # The number of change records stored for Backtrack.
293
+ # @return [Integer]
294
+ def backtrack_consumed_change_records
295
+ data[:backtrack_consumed_change_records]
296
+ end
297
+
278
298
  # @!endgroup
279
299
 
280
300
  # @return [Client]
@@ -436,6 +456,7 @@ module Aws::RDS
436
456
  # kms_key_id: "String",
437
457
  # pre_signed_url: "String",
438
458
  # enable_iam_database_authentication: false,
459
+ # backtrack_window: 1,
439
460
  # source_region: "String",
440
461
  # })
441
462
  # @param [Hash] options ({})
@@ -652,6 +673,18 @@ module Aws::RDS
652
673
  # accounts to database accounts, and otherwise false.
653
674
  #
654
675
  # Default: `false`
676
+ # @option options [Integer] :backtrack_window
677
+ # The target backtrack window, in seconds. To disable backtracking, set
678
+ # this value to 0.
679
+ #
680
+ # Default: 0
681
+ #
682
+ # Constraints:
683
+ #
684
+ # * If specified, this value must be set to a number from 0 to 259,200
685
+ # (72 hours).
686
+ #
687
+ # ^
655
688
  # @option options [String] :destination_region
656
689
  # @option options [String] :source_region
657
690
  # The source region of the snapshot. This is only needed when the
@@ -788,6 +821,7 @@ module Aws::RDS
788
821
  # preferred_backup_window: "String",
789
822
  # preferred_maintenance_window: "String",
790
823
  # enable_iam_database_authentication: false,
824
+ # backtrack_window: 1,
791
825
  # engine_version: "String",
792
826
  # })
793
827
  # @param [Hash] options ({})
@@ -905,6 +939,18 @@ module Aws::RDS
905
939
  # accounts to database accounts, and otherwise false.
906
940
  #
907
941
  # Default: `false`
942
+ # @option options [Integer] :backtrack_window
943
+ # The target backtrack window, in seconds. To disable backtracking, set
944
+ # this value to 0.
945
+ #
946
+ # Default: 0
947
+ #
948
+ # Constraints:
949
+ #
950
+ # * If specified, this value must be set to a number from 0 to 259,200
951
+ # (72 hours).
952
+ #
953
+ # ^
908
954
  # @option options [String] :engine_version
909
955
  # The version number of the database engine to which you want to
910
956
  # upgrade. Changing this parameter results in an outage. The change is
@@ -943,6 +989,7 @@ module Aws::RDS
943
989
  # ],
944
990
  # kms_key_id: "String",
945
991
  # enable_iam_database_authentication: false,
992
+ # backtrack_window: 1,
946
993
  # })
947
994
  # @param [Hash] options ({})
948
995
  # @option options [required, String] :db_cluster_identifier
@@ -1052,6 +1099,18 @@ module Aws::RDS
1052
1099
  # accounts to database accounts, and otherwise false.
1053
1100
  #
1054
1101
  # Default: `false`
1102
+ # @option options [Integer] :backtrack_window
1103
+ # The target backtrack window, in seconds. To disable backtracking, set
1104
+ # this value to 0.
1105
+ #
1106
+ # Default: 0
1107
+ #
1108
+ # Constraints:
1109
+ #
1110
+ # * If specified, this value must be set to a number from 0 to 259,200
1111
+ # (72 hours).
1112
+ #
1113
+ # ^
1055
1114
  # @return [DBCluster]
1056
1115
  def restore(options = {})
1057
1116
  options = options.merge(source_db_cluster_identifier: @id)
@@ -471,6 +471,7 @@ module Aws::RDS
471
471
  # ],
472
472
  # kms_key_id: "String",
473
473
  # enable_iam_database_authentication: false,
474
+ # backtrack_window: 1,
474
475
  # })
475
476
  # @param [Hash] options ({})
476
477
  # @option options [Array<String>] :availability_zones
@@ -542,6 +543,18 @@ module Aws::RDS
542
543
  # accounts to database accounts, and otherwise false.
543
544
  #
544
545
  # Default: `false`
546
+ # @option options [Integer] :backtrack_window
547
+ # The target backtrack window, in seconds. To disable backtracking, set
548
+ # this value to 0.
549
+ #
550
+ # Default: 0
551
+ #
552
+ # Constraints:
553
+ #
554
+ # * If specified, this value must be set to a number from 0 to 259,200
555
+ # (72 hours).
556
+ #
557
+ # ^
545
558
  # @return [DBCluster]
546
559
  def restore(options = {})
547
560
  options = options.merge(snapshot_identifier: @snapshot_id)
@@ -274,7 +274,7 @@ module Aws::RDS
274
274
  #
275
275
  # ^
276
276
  # @option options [Array<Types::Filter>] :filters
277
- # Not currently supported.
277
+ # This parameter is not currently supported.
278
278
  # @option options [Boolean] :default_only
279
279
  # Indicates that only the default version of the specified engine or
280
280
  # engine and major version combination is returned.
@@ -214,7 +214,7 @@ module Aws::RDS
214
214
  # })
215
215
  # @param [Hash] options ({})
216
216
  # @option options [Array<Types::Filter>] :filters
217
- # Not currently supported.
217
+ # This parameter is not currently supported.
218
218
  # @return [Parameter::Collection]
219
219
  def engine_default_parameters(options = {})
220
220
  batches = Enumerator.new do |y|
@@ -51,6 +51,7 @@ module Aws::RDS
51
51
  # kms_key_id: "String",
52
52
  # pre_signed_url: "String",
53
53
  # enable_iam_database_authentication: false,
54
+ # backtrack_window: 1,
54
55
  # source_region: "String",
55
56
  # })
56
57
  # @param [Hash] options ({})
@@ -280,6 +281,18 @@ module Aws::RDS
280
281
  # accounts to database accounts, and otherwise false.
281
282
  #
282
283
  # Default: `false`
284
+ # @option options [Integer] :backtrack_window
285
+ # The target backtrack window, in seconds. To disable backtracking, set
286
+ # this value to 0.
287
+ #
288
+ # Default: 0
289
+ #
290
+ # Constraints:
291
+ #
292
+ # * If specified, this value must be set to a number from 0 to 259,200
293
+ # (72 hours).
294
+ #
295
+ # ^
283
296
  # @option options [String] :destination_region
284
297
  # @option options [String] :source_region
285
298
  # The source region of the snapshot. This is only needed when the
@@ -1839,7 +1852,7 @@ module Aws::RDS
1839
1852
  #
1840
1853
  # ^
1841
1854
  # @option options [Array<Types::Filter>] :filters
1842
- # Not currently supported.
1855
+ # This parameter is not currently supported.
1843
1856
  # @option options [Boolean] :default_only
1844
1857
  # Indicates that only the default version of the specified engine or
1845
1858
  # engine and major version combination is returned.
@@ -306,6 +306,77 @@ module Aws::RDS
306
306
  include Aws::Structure
307
307
  end
308
308
 
309
+ # @note When making an API call, you may pass BacktrackDBClusterMessage
310
+ # data as a hash:
311
+ #
312
+ # {
313
+ # db_cluster_identifier: "String", # required
314
+ # backtrack_to: Time.now, # required
315
+ # force: false,
316
+ # use_earliest_time_on_point_in_time_unavailable: false,
317
+ # }
318
+ #
319
+ # @!attribute [rw] db_cluster_identifier
320
+ # The DB cluster identifier of the DB cluster to be backtracked. This
321
+ # parameter is stored as a lowercase string.
322
+ #
323
+ # Constraints:
324
+ #
325
+ # * Must contain from 1 to 63 alphanumeric characters or hyphens.
326
+ #
327
+ # * First character must be a letter.
328
+ #
329
+ # * Cannot end with a hyphen or contain two consecutive hyphens.
330
+ #
331
+ # Example: `my-cluster1`
332
+ # @return [String]
333
+ #
334
+ # @!attribute [rw] backtrack_to
335
+ # The timestamp of the time to backtrack the DB cluster to, specified
336
+ # in ISO 8601 format. For more information about ISO 8601, see the
337
+ # [ISO8601 Wikipedia page.][1]
338
+ #
339
+ # <note markdown="1"> If the specified time is not a consistent time for the DB cluster,
340
+ # Aurora automatically chooses the nearest possible consistent time
341
+ # for the DB cluster.
342
+ #
343
+ # </note>
344
+ #
345
+ # Constraints:
346
+ #
347
+ # * Must contain a valid ISO 8601 timestamp.
348
+ #
349
+ # * Cannot contain a timestamp set in the future.
350
+ #
351
+ # Example: `2017-07-08T18:00Z`
352
+ #
353
+ #
354
+ #
355
+ # [1]: http://en.wikipedia.org/wiki/ISO_8601
356
+ # @return [Time]
357
+ #
358
+ # @!attribute [rw] force
359
+ # A value that, if specified, forces the DB cluster to backtrack when
360
+ # binary logging is enabled. Otherwise, an error occurs when binary
361
+ # logging is enabled.
362
+ # @return [Boolean]
363
+ #
364
+ # @!attribute [rw] use_earliest_time_on_point_in_time_unavailable
365
+ # If *BacktrackTo* is set to a timestamp earlier than the earliest
366
+ # backtrack time, this value backtracks the DB cluster to the earliest
367
+ # possible backtrack time. Otherwise, an error occurs.
368
+ # @return [Boolean]
369
+ #
370
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/BacktrackDBClusterMessage AWS API Documentation
371
+ #
372
+ class BacktrackDBClusterMessage < Struct.new(
373
+ :db_cluster_identifier,
374
+ :backtrack_to,
375
+ :force,
376
+ :use_earliest_time_on_point_in_time_unavailable)
377
+ include Aws::Structure
378
+ end
379
+
309
380
  # A CA certificate for an AWS account.
310
381
  #
311
382
  # @!attribute [rw] certificate_identifier
@@ -1088,6 +1159,7 @@ module Aws::RDS
1088
1159
  # kms_key_id: "String",
1089
1160
  # pre_signed_url: "String",
1090
1161
  # enable_iam_database_authentication: false,
1162
+ # backtrack_window: 1,
1091
1163
  # source_region: "String",
1092
1164
  # }
1093
1165
  #
@@ -1362,6 +1434,20 @@ module Aws::RDS
1362
1434
  # Default: `false`
1363
1435
  # @return [Boolean]
1364
1436
  #
1437
+ # @!attribute [rw] backtrack_window
1438
+ # The target backtrack window, in seconds. To disable backtracking,
1439
+ # set this value to 0.
1440
+ #
1441
+ # Default: 0
1442
+ #
1443
+ # Constraints:
1444
+ #
1445
+ # * If specified, this value must be set to a number from 0 to 259,200
1446
+ # (72 hours).
1447
+ #
1448
+ # ^
1449
+ # @return [Integer]
1450
+ #
1365
1451
  # @!attribute [rw] destination_region
1366
1452
  # @return [String]
1367
1453
  #
@@ -1395,6 +1481,7 @@ module Aws::RDS
1395
1481
  :kms_key_id,
1396
1482
  :pre_signed_url,
1397
1483
  :enable_iam_database_authentication,
1484
+ :backtrack_window,
1398
1485
  :destination_region,
1399
1486
  :source_region)
1400
1487
  include Aws::Structure
@@ -3563,7 +3650,7 @@ module Aws::RDS
3563
3650
  # @return [String]
3564
3651
  #
3565
3652
  # @!attribute [rw] earliest_restorable_time
3566
- # Specifies the earliest time to which a database can be restored with
3653
+ # The earliest time to which a database can be restored with
3567
3654
  # point-in-time restore.
3568
3655
  # @return [Time]
3569
3656
  #
@@ -3694,6 +3781,20 @@ module Aws::RDS
3694
3781
  # Coordinated Time (UTC).
3695
3782
  # @return [Time]
3696
3783
  #
3784
+ # @!attribute [rw] earliest_backtrack_time
3785
+ # The earliest time to which a DB cluster can be backtracked.
3786
+ # @return [Time]
3787
+ #
3788
+ # @!attribute [rw] backtrack_window
3789
+ # The target backtrack window, in seconds. If this value is set to 0,
3790
+ # backtracking is disabled for the DB cluster. Otherwise, backtracking
3791
+ # is enabled.
3792
+ # @return [Integer]
3793
+ #
3794
+ # @!attribute [rw] backtrack_consumed_change_records
3795
+ # The number of change records stored for Backtrack.
3796
+ # @return [Integer]
3797
+ #
3697
3798
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBCluster AWS API Documentation
3698
3799
  #
3699
3800
  class DBCluster < Struct.new(
@@ -3731,7 +3832,83 @@ module Aws::RDS
3731
3832
  :associated_roles,
3732
3833
  :iam_database_authentication_enabled,
3733
3834
  :clone_group_id,
3734
- :cluster_create_time)
3835
+ :cluster_create_time,
3836
+ :earliest_backtrack_time,
3837
+ :backtrack_window,
3838
+ :backtrack_consumed_change_records)
3839
+ include Aws::Structure
3840
+ end
3841
+
3842
+ # This data type is used as a response element in the
3843
+ # DescribeDBClusterBacktracks action.
3844
+ #
3845
+ # @!attribute [rw] db_cluster_identifier
3846
+ # Contains a user-supplied DB cluster identifier. This identifier is
3847
+ # the unique key that identifies a DB cluster.
3848
+ # @return [String]
3849
+ #
3850
+ # @!attribute [rw] backtrack_identifier
3851
+ # Contains the backtrack identifier.
3852
+ # @return [String]
3853
+ #
3854
+ # @!attribute [rw] backtrack_to
3855
+ # The timestamp of the time to which the DB cluster was backtracked.
3856
+ # @return [Time]
3857
+ #
3858
+ # @!attribute [rw] backtracked_from
3859
+ # The timestamp of the time from which the DB cluster was backtracked.
3860
+ # @return [Time]
3861
+ #
3862
+ # @!attribute [rw] backtrack_request_creation_time
3863
+ # The timestamp of the time at which the backtrack was requested.
3864
+ # @return [Time]
3865
+ #
3866
+ # @!attribute [rw] status
3867
+ # The status of the backtrack. This property returns one of the
3868
+ # following values:
3869
+ #
3870
+ # * `applying` - The backtrack is currently being applied to or rolled
3871
+ # back from the DB cluster.
3872
+ #
3873
+ # * `completed` - The backtrack has successfully been applied to or
3874
+ # rolled back from the DB cluster.
3875
+ #
3876
+ # * `failed` - An error occurred while the backtrack was applied to or
3877
+ # rolled back from the DB cluster.
3878
+ #
3879
+ # * `pending` - The backtrack is currently pending application to or
3880
+ # rollback from the DB cluster.
3881
+ # @return [String]
3882
+ #
3883
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBClusterBacktrack AWS API Documentation
3884
+ #
3885
+ class DBClusterBacktrack < Struct.new(
3886
+ :db_cluster_identifier,
3887
+ :backtrack_identifier,
3888
+ :backtrack_to,
3889
+ :backtracked_from,
3890
+ :backtrack_request_creation_time,
3891
+ :status)
3892
+ include Aws::Structure
3893
+ end
3894
+
3895
+ # Contains the result of a successful invocation of the
3896
+ # DescribeDBClusterBacktracks action.
3897
+ #
3898
+ # @!attribute [rw] marker
3899
+ # A pagination token that can be used in a subsequent
3900
+ # DescribeDBClusterBacktracks request.
3901
+ # @return [String]
3902
+ #
3903
+ # @!attribute [rw] db_cluster_backtracks
3904
+ # Contains a list of backtracks for the user.
3905
+ # @return [Array<Types::DBClusterBacktrack>]
3906
+ #
3907
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DBClusterBacktrackMessage AWS API Documentation
3908
+ #
3909
+ class DBClusterBacktrackMessage < Struct.new(
3910
+ :marker,
3911
+ :db_cluster_backtracks)
3735
3912
  include Aws::Structure
3736
3913
  end
3737
3914
 
@@ -5627,6 +5804,109 @@ module Aws::RDS
5627
5804
  include Aws::Structure
5628
5805
  end
5629
5806
 
5807
+ # @note When making an API call, you may pass DescribeDBClusterBacktracksMessage
5808
+ # data as a hash:
5809
+ #
5810
+ # {
5811
+ # db_cluster_identifier: "String", # required
5812
+ # backtrack_identifier: "String",
5813
+ # filters: [
5814
+ # {
5815
+ # name: "String", # required
5816
+ # values: ["String"], # required
5817
+ # },
5818
+ # ],
5819
+ # max_records: 1,
5820
+ # marker: "String",
5821
+ # }
5822
+ #
5823
+ # @!attribute [rw] db_cluster_identifier
5824
+ # The DB cluster identifier of the DB cluster to be described. This
5825
+ # parameter is stored as a lowercase string.
5826
+ #
5827
+ # Constraints:
5828
+ #
5829
+ # * Must contain from 1 to 63 alphanumeric characters or hyphens.
5830
+ #
5831
+ # * First character must be a letter.
5832
+ #
5833
+ # * Cannot end with a hyphen or contain two consecutive hyphens.
5834
+ #
5835
+ # Example: `my-cluster1`
5836
+ # @return [String]
5837
+ #
5838
+ # @!attribute [rw] backtrack_identifier
5839
+ # If specified, this value is the backtrack identifier of the
5840
+ # backtrack to be described.
5841
+ #
5842
+ # Constraints:
5843
+ #
5844
+ # * Must contain a valid universally unique identifier (UUID). For
5845
+ # more information about UUIDs, see [A Universally Unique Identifier
5846
+ # (UUID) URN Namespace][1].
5847
+ #
5848
+ # ^
5849
+ #
5850
+ # Example: `123e4567-e89b-12d3-a456-426655440000`
5851
+ #
5852
+ #
5853
+ #
5854
+ # [1]: http://www.ietf.org/rfc/rfc4122.txt
5855
+ # @return [String]
5856
+ #
5857
+ # @!attribute [rw] filters
5858
+ # A filter that specifies one or more DB clusters to describe.
5859
+ # Supported filters include the following:
5860
+ #
5861
+ # * `db-cluster-backtrack-id` - Accepts backtrack identifiers. The
5862
+ # results list includes information about only the backtracks
5863
+ # identified by these identifiers.
5864
+ #
5865
+ # * `db-cluster-backtrack-status` - Accepts any of the following
5866
+ # backtrack status values:
5867
+ #
5868
+ # * `applying`
5869
+ #
5870
+ # * `completed`
5871
+ #
5872
+ # * `failed`
5873
+ #
5874
+ # * `pending`
5875
+ #
5876
+ # The results list includes information about only the backtracks
5877
+ # identified by these values. For more information about backtrack
5878
+ # status values, see DBClusterBacktrack.
5879
+ # @return [Array<Types::Filter>]
5880
+ #
5881
+ # @!attribute [rw] max_records
5882
+ # The maximum number of records to include in the response. If more
5883
+ # records exist than the specified `MaxRecords` value, a pagination
5884
+ # token called a marker is included in the response so that the
5885
+ # remaining results can be retrieved.
5886
+ #
5887
+ # Default: 100
5888
+ #
5889
+ # Constraints: Minimum 20, maximum 100.
5890
+ # @return [Integer]
5891
+ #
5892
+ # @!attribute [rw] marker
5893
+ # An optional pagination token provided by a previous
5894
+ # DescribeDBClusterBacktracks request. If this parameter is specified,
5895
+ # the response includes only records beyond the marker, up to the
5896
+ # value specified by `MaxRecords`.
5897
+ # @return [String]
5898
+ #
5899
+ # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBClusterBacktracksMessage AWS API Documentation
5900
+ #
5901
+ class DescribeDBClusterBacktracksMessage < Struct.new(
5902
+ :db_cluster_identifier,
5903
+ :backtrack_identifier,
5904
+ :filters,
5905
+ :max_records,
5906
+ :marker)
5907
+ include Aws::Structure
5908
+ end
5909
+
5630
5910
  # @note When making an API call, you may pass DescribeDBClusterParameterGroupsMessage
5631
5911
  # data as a hash:
5632
5912
  #
@@ -6029,7 +6309,7 @@ module Aws::RDS
6029
6309
  # @return [String]
6030
6310
  #
6031
6311
  # @!attribute [rw] filters
6032
- # Not currently supported.
6312
+ # This parameter is not currently supported.
6033
6313
  # @return [Array<Types::Filter>]
6034
6314
  #
6035
6315
  # @!attribute [rw] max_records
@@ -6741,7 +7021,7 @@ module Aws::RDS
6741
7021
  # @return [String]
6742
7022
  #
6743
7023
  # @!attribute [rw] filters
6744
- # Not currently supported.
7024
+ # This parameter is not currently supported.
6745
7025
  # @return [Array<Types::Filter>]
6746
7026
  #
6747
7027
  # @!attribute [rw] max_records
@@ -8009,7 +8289,25 @@ module Aws::RDS
8009
8289
  include Aws::Structure
8010
8290
  end
8011
8291
 
8012
- # This type is not currently supported.
8292
+ # A filter name and value pair that is used to return a more specific
8293
+ # list of results from a describe operation. Filters can be used to
8294
+ # match a set of resources by specific criteria, such as IDs. The
8295
+ # filters supported by a describe operation are documented with the
8296
+ # describe operation.
8297
+ #
8298
+ # <note markdown="1"> Currently, wildcards are not supported in filters.
8299
+ #
8300
+ # </note>
8301
+ #
8302
+ # The following actions can be filtered:
8303
+ #
8304
+ # * DescribeDBClusterBacktracks
8305
+ #
8306
+ # * DescribeDBClusters
8307
+ #
8308
+ # * DescribeDBInstances
8309
+ #
8310
+ # * DescribePendingMaintenanceActions
8013
8311
  #
8014
8312
  # @note When making an API call, you may pass Filter
8015
8313
  # data as a hash:
@@ -8020,11 +8318,11 @@ module Aws::RDS
8020
8318
  # }
8021
8319
  #
8022
8320
  # @!attribute [rw] name
8023
- # This parameter is not currently supported.
8321
+ # The name of the filter. Filter names are case-sensitive.
8024
8322
  # @return [String]
8025
8323
  #
8026
8324
  # @!attribute [rw] values
8027
- # This parameter is not currently supported.
8325
+ # One or more filter values. Filter values are case-sensitive.
8028
8326
  # @return [Array<String>]
8029
8327
  #
8030
8328
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/Filter AWS API Documentation
@@ -8106,6 +8404,7 @@ module Aws::RDS
8106
8404
  # preferred_backup_window: "String",
8107
8405
  # preferred_maintenance_window: "String",
8108
8406
  # enable_iam_database_authentication: false,
8407
+ # backtrack_window: 1,
8109
8408
  # engine_version: "String",
8110
8409
  # }
8111
8410
  #
@@ -8258,6 +8557,20 @@ module Aws::RDS
8258
8557
  # Default: `false`
8259
8558
  # @return [Boolean]
8260
8559
  #
8560
+ # @!attribute [rw] backtrack_window
8561
+ # The target backtrack window, in seconds. To disable backtracking,
8562
+ # set this value to 0.
8563
+ #
8564
+ # Default: 0
8565
+ #
8566
+ # Constraints:
8567
+ #
8568
+ # * If specified, this value must be set to a number from 0 to 259,200
8569
+ # (72 hours).
8570
+ #
8571
+ # ^
8572
+ # @return [Integer]
8573
+ #
8261
8574
  # @!attribute [rw] engine_version
8262
8575
  # The version number of the database engine to which you want to
8263
8576
  # upgrade. Changing this parameter results in an outage. The change is
@@ -8283,6 +8596,7 @@ module Aws::RDS
8283
8596
  :preferred_backup_window,
8284
8597
  :preferred_maintenance_window,
8285
8598
  :enable_iam_database_authentication,
8599
+ :backtrack_window,
8286
8600
  :engine_version)
8287
8601
  include Aws::Structure
8288
8602
  end
@@ -11097,6 +11411,7 @@ module Aws::RDS
11097
11411
  # s3_bucket_name: "String", # required
11098
11412
  # s3_prefix: "String",
11099
11413
  # s3_ingestion_role_arn: "String", # required
11414
+ # backtrack_window: 1,
11100
11415
  # }
11101
11416
  #
11102
11417
  # @!attribute [rw] availability_zones
@@ -11336,6 +11651,20 @@ module Aws::RDS
11336
11651
  # Amazon S3 bucket on your behalf.
11337
11652
  # @return [String]
11338
11653
  #
11654
+ # @!attribute [rw] backtrack_window
11655
+ # The target backtrack window, in seconds. To disable backtracking,
11656
+ # set this value to 0.
11657
+ #
11658
+ # Default: 0
11659
+ #
11660
+ # Constraints:
11661
+ #
11662
+ # * If specified, this value must be set to a number from 0 to 259,200
11663
+ # (72 hours).
11664
+ #
11665
+ # ^
11666
+ # @return [Integer]
11667
+ #
11339
11668
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterFromS3Message AWS API Documentation
11340
11669
  #
11341
11670
  class RestoreDBClusterFromS3Message < Struct.new(
@@ -11363,7 +11692,8 @@ module Aws::RDS
11363
11692
  :source_engine_version,
11364
11693
  :s3_bucket_name,
11365
11694
  :s3_prefix,
11366
- :s3_ingestion_role_arn)
11695
+ :s3_ingestion_role_arn,
11696
+ :backtrack_window)
11367
11697
  include Aws::Structure
11368
11698
  end
11369
11699
 
@@ -11403,6 +11733,7 @@ module Aws::RDS
11403
11733
  # ],
11404
11734
  # kms_key_id: "String",
11405
11735
  # enable_iam_database_authentication: false,
11736
+ # backtrack_window: 1,
11406
11737
  # }
11407
11738
  #
11408
11739
  # @!attribute [rw] availability_zones
@@ -11515,6 +11846,20 @@ module Aws::RDS
11515
11846
  # Default: `false`
11516
11847
  # @return [Boolean]
11517
11848
  #
11849
+ # @!attribute [rw] backtrack_window
11850
+ # The target backtrack window, in seconds. To disable backtracking,
11851
+ # set this value to 0.
11852
+ #
11853
+ # Default: 0
11854
+ #
11855
+ # Constraints:
11856
+ #
11857
+ # * If specified, this value must be set to a number from 0 to 259,200
11858
+ # (72 hours).
11859
+ #
11860
+ # ^
11861
+ # @return [Integer]
11862
+ #
11518
11863
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterFromSnapshotMessage AWS API Documentation
11519
11864
  #
11520
11865
  class RestoreDBClusterFromSnapshotMessage < Struct.new(
@@ -11530,7 +11875,8 @@ module Aws::RDS
11530
11875
  :vpc_security_group_ids,
11531
11876
  :tags,
11532
11877
  :kms_key_id,
11533
- :enable_iam_database_authentication)
11878
+ :enable_iam_database_authentication,
11879
+ :backtrack_window)
11534
11880
  include Aws::Structure
11535
11881
  end
11536
11882
 
@@ -11569,6 +11915,7 @@ module Aws::RDS
11569
11915
  # ],
11570
11916
  # kms_key_id: "String",
11571
11917
  # enable_iam_database_authentication: false,
11918
+ # backtrack_window: 1,
11572
11919
  # }
11573
11920
  #
11574
11921
  # @!attribute [rw] db_cluster_identifier
@@ -11710,6 +12057,20 @@ module Aws::RDS
11710
12057
  # Default: `false`
11711
12058
  # @return [Boolean]
11712
12059
  #
12060
+ # @!attribute [rw] backtrack_window
12061
+ # The target backtrack window, in seconds. To disable backtracking,
12062
+ # set this value to 0.
12063
+ #
12064
+ # Default: 0
12065
+ #
12066
+ # Constraints:
12067
+ #
12068
+ # * If specified, this value must be set to a number from 0 to 259,200
12069
+ # (72 hours).
12070
+ #
12071
+ # ^
12072
+ # @return [Integer]
12073
+ #
11713
12074
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBClusterToPointInTimeMessage AWS API Documentation
11714
12075
  #
11715
12076
  class RestoreDBClusterToPointInTimeMessage < Struct.new(
@@ -11724,7 +12085,8 @@ module Aws::RDS
11724
12085
  :vpc_security_group_ids,
11725
12086
  :tags,
11726
12087
  :kms_key_id,
11727
- :enable_iam_database_authentication)
12088
+ :enable_iam_database_authentication,
12089
+ :backtrack_window)
11728
12090
  include Aws::Structure
11729
12091
  end
11730
12092