aws-sdk-databasemigrationservice 1.75.0 → 1.76.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.
@@ -149,6 +149,59 @@ module Aws::DatabaseMigrationService
149
149
  include Aws::Structure
150
150
  end
151
151
 
152
+ # Provides information about the errors that occurred during the
153
+ # analysis of the source database.
154
+ #
155
+ # @!attribute [rw] database_id
156
+ # The identifier of the source database.
157
+ # @return [String]
158
+ #
159
+ # @!attribute [rw] message
160
+ # The information about the error.
161
+ # @return [String]
162
+ #
163
+ # @!attribute [rw] code
164
+ # The code of an error that occurred during the analysis of the source
165
+ # database.
166
+ # @return [String]
167
+ #
168
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/BatchStartRecommendationsErrorEntry AWS API Documentation
169
+ #
170
+ class BatchStartRecommendationsErrorEntry < Struct.new(
171
+ :database_id,
172
+ :message,
173
+ :code)
174
+ SENSITIVE = []
175
+ include Aws::Structure
176
+ end
177
+
178
+ # @!attribute [rw] data
179
+ # Provides information about source databases to analyze. After this
180
+ # analysis, Fleet Advisor recommends target engines for each source
181
+ # database.
182
+ # @return [Array<Types::StartRecommendationsRequestEntry>]
183
+ #
184
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/BatchStartRecommendationsRequest AWS API Documentation
185
+ #
186
+ class BatchStartRecommendationsRequest < Struct.new(
187
+ :data)
188
+ SENSITIVE = []
189
+ include Aws::Structure
190
+ end
191
+
192
+ # @!attribute [rw] error_entries
193
+ # A list with error details about the analysis of each source
194
+ # database.
195
+ # @return [Array<Types::BatchStartRecommendationsErrorEntry>]
196
+ #
197
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/BatchStartRecommendationsResponse AWS API Documentation
198
+ #
199
+ class BatchStartRecommendationsResponse < Struct.new(
200
+ :error_entries)
201
+ SENSITIVE = []
202
+ include Aws::Structure
203
+ end
204
+
152
205
  # @!attribute [rw] replication_task_assessment_run_arn
153
206
  # Amazon Resource Name (ARN) of the premigration assessment run to be
154
207
  # canceled.
@@ -1011,6 +1064,15 @@ module Aws::DatabaseMigrationService
1011
1064
  # window. This parameter defaults to `true`.
1012
1065
  #
1013
1066
  # Default: `true`
1067
+ #
1068
+ # When `AutoMinorVersionUpgrade` is enabled, DMS uses the current
1069
+ # default engine version when you create a replication instance. For
1070
+ # example, if you set `EngineVersion` to a lower version number than
1071
+ # the current default version, DMS uses the default version.
1072
+ #
1073
+ # If `AutoMinorVersionUpgrade` *isn’t* enabled when you create a
1074
+ # replication instance, DMS uses the engine version specified by the
1075
+ # `EngineVersion` parameter.
1014
1076
  # @return [Boolean]
1015
1077
  #
1016
1078
  # @!attribute [rw] tags
@@ -1242,7 +1304,7 @@ module Aws::DatabaseMigrationService
1242
1304
  # “server\_time:2018-02-09T12:12:12”
1243
1305
  #
1244
1306
  # Commit time example: --cdc-stop-position “commit\_time:
1245
- # 2018-02-09T12:12:12
1307
+ # 2018-02-09T12:12:12“
1246
1308
  # @return [String]
1247
1309
  #
1248
1310
  # @!attribute [rw] tags
@@ -2584,6 +2646,118 @@ module Aws::DatabaseMigrationService
2584
2646
  include Aws::Structure
2585
2647
  end
2586
2648
 
2649
+ # @!attribute [rw] filters
2650
+ # Filters applied to the limitations described in the form of
2651
+ # key-value pairs.
2652
+ # @return [Array<Types::Filter>]
2653
+ #
2654
+ # @!attribute [rw] max_records
2655
+ # The maximum number of records to include in the response. If more
2656
+ # records exist than the specified `MaxRecords` value, Fleet Advisor
2657
+ # includes a pagination token in the response so that you can retrieve
2658
+ # the remaining results.
2659
+ # @return [Integer]
2660
+ #
2661
+ # @!attribute [rw] next_token
2662
+ # Specifies the unique pagination token that makes it possible to
2663
+ # display the next page of results. If this parameter is specified,
2664
+ # the response includes only records beyond the marker, up to the
2665
+ # value specified by `MaxRecords`.
2666
+ #
2667
+ # If `NextToken` is returned by a previous response, there are more
2668
+ # results available. The value of `NextToken` is a unique pagination
2669
+ # token for each page. Make the call again using the returned token to
2670
+ # retrieve the next page. Keep all other arguments unchanged.
2671
+ # @return [String]
2672
+ #
2673
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/DescribeRecommendationLimitationsRequest AWS API Documentation
2674
+ #
2675
+ class DescribeRecommendationLimitationsRequest < Struct.new(
2676
+ :filters,
2677
+ :max_records,
2678
+ :next_token)
2679
+ SENSITIVE = []
2680
+ include Aws::Structure
2681
+ end
2682
+
2683
+ # @!attribute [rw] next_token
2684
+ # The unique pagination token returned for you to pass to a subsequent
2685
+ # request. Fleet Advisor returns this token when the number of records
2686
+ # in the response is greater than the `MaxRecords` value. To retrieve
2687
+ # the next page, make the call again using the returned token and
2688
+ # keeping all other arguments unchanged.
2689
+ # @return [String]
2690
+ #
2691
+ # @!attribute [rw] limitations
2692
+ # The list of limitations for recommendations of target Amazon Web
2693
+ # Services engines.
2694
+ # @return [Array<Types::Limitation>]
2695
+ #
2696
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/DescribeRecommendationLimitationsResponse AWS API Documentation
2697
+ #
2698
+ class DescribeRecommendationLimitationsResponse < Struct.new(
2699
+ :next_token,
2700
+ :limitations)
2701
+ SENSITIVE = []
2702
+ include Aws::Structure
2703
+ end
2704
+
2705
+ # @!attribute [rw] filters
2706
+ # Filters applied to the target engine recommendations described in
2707
+ # the form of key-value pairs.
2708
+ # @return [Array<Types::Filter>]
2709
+ #
2710
+ # @!attribute [rw] max_records
2711
+ # The maximum number of records to include in the response. If more
2712
+ # records exist than the specified `MaxRecords` value, Fleet Advisor
2713
+ # includes a pagination token in the response so that you can retrieve
2714
+ # the remaining results.
2715
+ # @return [Integer]
2716
+ #
2717
+ # @!attribute [rw] next_token
2718
+ # Specifies the unique pagination token that makes it possible to
2719
+ # display the next page of results. If this parameter is specified,
2720
+ # the response includes only records beyond the marker, up to the
2721
+ # value specified by `MaxRecords`.
2722
+ #
2723
+ # If `NextToken` is returned by a previous response, there are more
2724
+ # results available. The value of `NextToken` is a unique pagination
2725
+ # token for each page. Make the call again using the returned token to
2726
+ # retrieve the next page. Keep all other arguments unchanged.
2727
+ # @return [String]
2728
+ #
2729
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/DescribeRecommendationsRequest AWS API Documentation
2730
+ #
2731
+ class DescribeRecommendationsRequest < Struct.new(
2732
+ :filters,
2733
+ :max_records,
2734
+ :next_token)
2735
+ SENSITIVE = []
2736
+ include Aws::Structure
2737
+ end
2738
+
2739
+ # @!attribute [rw] next_token
2740
+ # The unique pagination token returned for you to pass to a subsequent
2741
+ # request. Fleet Advisor returns this token when the number of records
2742
+ # in the response is greater than the `MaxRecords` value. To retrieve
2743
+ # the next page, make the call again using the returned token and
2744
+ # keeping all other arguments unchanged.
2745
+ # @return [String]
2746
+ #
2747
+ # @!attribute [rw] recommendations
2748
+ # The list of recommendations of target engines that Fleet Advisor
2749
+ # created for the source database.
2750
+ # @return [Array<Types::Recommendation>]
2751
+ #
2752
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/DescribeRecommendationsResponse AWS API Documentation
2753
+ #
2754
+ class DescribeRecommendationsResponse < Struct.new(
2755
+ :next_token,
2756
+ :recommendations)
2757
+ SENSITIVE = []
2758
+ include Aws::Structure
2759
+ end
2760
+
2587
2761
  # @!attribute [rw] endpoint_arn
2588
2762
  # The Amazon Resource Name (ARN) string that uniquely identifies the
2589
2763
  # endpoint.
@@ -3820,10 +3994,10 @@ module Aws::DatabaseMigrationService
3820
3994
  # @return [String]
3821
3995
  #
3822
3996
  # @!attribute [rw] clean_source_metadata_on_mismatch
3823
- # Adjusts the behavior of DMS when migrating from an SQL Server source
3824
- # database that is hosted as part of an Always On availability group
3825
- # cluster. If you need DMS to poll all the nodes in the Always On
3826
- # cluster for transaction backups, set this attribute to `false`.
3997
+ # Cleans and recreates table metadata information on the replication
3998
+ # instance when a mismatch occurs. For example, in a situation where
3999
+ # running an alter DDL on the table could result in different
4000
+ # information about the table cached in the replication instance.
3827
4001
  # @return [Boolean]
3828
4002
  #
3829
4003
  # @!attribute [rw] database_name
@@ -3877,10 +4051,11 @@ module Aws::DatabaseMigrationService
3877
4051
  # @return [String]
3878
4052
  #
3879
4053
  # @!attribute [rw] port
4054
+ # Endpoint TCP port.
3880
4055
  # @return [Integer]
3881
4056
  #
3882
4057
  # @!attribute [rw] server_name
3883
- # Endpoint TCP port.
4058
+ # The MySQL host name.
3884
4059
  # @return [String]
3885
4060
  #
3886
4061
  # @!attribute [rw] server_timezone
@@ -4494,6 +4669,61 @@ module Aws::DatabaseMigrationService
4494
4669
  include Aws::Structure
4495
4670
  end
4496
4671
 
4672
+ # Provides information about the limitations of target Amazon Web
4673
+ # Services engines.
4674
+ #
4675
+ # Your source database might include features that the target Amazon Web
4676
+ # Services engine doesn't support. Fleet Advisor lists these features
4677
+ # as limitations. You should consider these limitations during database
4678
+ # migration. For each limitation, Fleet Advisor recommends an action
4679
+ # that you can take to address or avoid this limitation.
4680
+ #
4681
+ # @!attribute [rw] database_id
4682
+ # The identifier of the source database.
4683
+ # @return [String]
4684
+ #
4685
+ # @!attribute [rw] engine_name
4686
+ # The name of the target engine that Fleet Advisor should use in the
4687
+ # target engine recommendation. Valid values include
4688
+ # `"rds-aurora-mysql"`, `"rds-aurora-postgresql"`, `"rds-mysql"`,
4689
+ # `"rds-oracle"`, `"rds-sql-server"`, and `"rds-postgresql"`.
4690
+ # @return [String]
4691
+ #
4692
+ # @!attribute [rw] name
4693
+ # The name of the limitation. Describes unsupported database features,
4694
+ # migration action items, and other limitations.
4695
+ # @return [String]
4696
+ #
4697
+ # @!attribute [rw] description
4698
+ # A description of the limitation. Provides additional information
4699
+ # about the limitation, and includes recommended actions that you can
4700
+ # take to address or avoid this limitation.
4701
+ # @return [String]
4702
+ #
4703
+ # @!attribute [rw] impact
4704
+ # The impact of the limitation. You can use this parameter to
4705
+ # prioritize limitations that you want to address. Valid values
4706
+ # include `"Blocker"`, `"High"`, `"Medium"`, and `"Low"`.
4707
+ # @return [String]
4708
+ #
4709
+ # @!attribute [rw] type
4710
+ # The type of the limitation, such as action required, upgrade
4711
+ # required, and limited feature.
4712
+ # @return [String]
4713
+ #
4714
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/Limitation AWS API Documentation
4715
+ #
4716
+ class Limitation < Struct.new(
4717
+ :database_id,
4718
+ :engine_name,
4719
+ :name,
4720
+ :description,
4721
+ :impact,
4722
+ :type)
4723
+ SENSITIVE = []
4724
+ include Aws::Structure
4725
+ end
4726
+
4497
4727
  # @!attribute [rw] resource_arn
4498
4728
  # The Amazon Resource Name (ARN) string that uniquely identifies the
4499
4729
  # DMS resource to list tags for. This returns a list of keys (names of
@@ -4594,7 +4824,13 @@ module Aws::DatabaseMigrationService
4594
4824
  # @return [String]
4595
4825
  #
4596
4826
  # @!attribute [rw] server_name
4597
- # Fully qualified domain name of the endpoint.
4827
+ # Fully qualified domain name of the endpoint. For an Amazon RDS SQL
4828
+ # Server instance, this is the output of [DescribeDBInstances][1], in
4829
+ # the ` Endpoint.Address` field.
4830
+ #
4831
+ #
4832
+ #
4833
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html
4598
4834
  # @return [String]
4599
4835
  #
4600
4836
  # @!attribute [rw] username
@@ -5157,6 +5393,15 @@ module Aws::DatabaseMigrationService
5157
5393
  # * A newer minor version is available.
5158
5394
  #
5159
5395
  # * DMS has enabled automatic patching for the given engine version.
5396
+ #
5397
+ # When `AutoMinorVersionUpgrade` is enabled, DMS uses the current
5398
+ # default engine version when you modify a replication instance. For
5399
+ # example, if you set `EngineVersion` to a lower version number than
5400
+ # the current default version, DMS uses the default version.
5401
+ #
5402
+ # If `AutoMinorVersionUpgrade` *isn’t* enabled when you modify a
5403
+ # replication instance, DMS uses the engine version specified by the
5404
+ # `EngineVersion` parameter.
5160
5405
  # @return [Boolean]
5161
5406
  #
5162
5407
  # @!attribute [rw] replication_instance_identifier
@@ -5314,7 +5559,7 @@ module Aws::DatabaseMigrationService
5314
5559
  # “server\_time:2018-02-09T12:12:12”
5315
5560
  #
5316
5561
  # Commit time example: --cdc-stop-position “commit\_time:
5317
- # 2018-02-09T12:12:12
5562
+ # 2018-02-09T12:12:12“
5318
5563
  # @return [String]
5319
5564
  #
5320
5565
  # @!attribute [rw] task_data
@@ -5529,10 +5774,10 @@ module Aws::DatabaseMigrationService
5529
5774
  # @return [String]
5530
5775
  #
5531
5776
  # @!attribute [rw] clean_source_metadata_on_mismatch
5532
- # Adjusts the behavior of DMS when migrating from an SQL Server source
5533
- # database that is hosted as part of an Always On availability group
5534
- # cluster. If you need DMS to poll all the nodes in the Always On
5535
- # cluster for transaction backups, set this attribute to `false`.
5777
+ # Cleans and recreates table metadata information on the replication
5778
+ # instance when a mismatch occurs. For example, in a situation where
5779
+ # running an alter DDL on the table could result in different
5780
+ # information about the table cached in the replication instance.
5536
5781
  # @return [Boolean]
5537
5782
  #
5538
5783
  # @!attribute [rw] database_name
@@ -5592,7 +5837,18 @@ module Aws::DatabaseMigrationService
5592
5837
  # @return [Integer]
5593
5838
  #
5594
5839
  # @!attribute [rw] server_name
5595
- # Fully qualified domain name of the endpoint.
5840
+ # The host name of the endpoint database.
5841
+ #
5842
+ # For an Amazon RDS MySQL instance, this is the output of
5843
+ # [DescribeDBInstances][1], in the ` Endpoint.Address` field.
5844
+ #
5845
+ # For an Aurora MySQL instance, this is the output of
5846
+ # [DescribeDBClusters][2], in the `Endpoint` field.
5847
+ #
5848
+ #
5849
+ #
5850
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html
5851
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusters.html
5596
5852
  # @return [String]
5597
5853
  #
5598
5854
  # @!attribute [rw] server_timezone
@@ -6000,6 +6256,13 @@ module Aws::DatabaseMigrationService
6000
6256
  #
6001
6257
  # @!attribute [rw] server_name
6002
6258
  # Fully qualified domain name of the endpoint.
6259
+ #
6260
+ # For an Amazon RDS Oracle instance, this is the output of
6261
+ # [DescribeDBInstances][1], in the ` Endpoint.Address` field.
6262
+ #
6263
+ #
6264
+ #
6265
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html
6003
6266
  # @return [String]
6004
6267
  #
6005
6268
  # @!attribute [rw] spatial_data_option_to_geo_json_function_name
@@ -6387,7 +6650,18 @@ module Aws::DatabaseMigrationService
6387
6650
  # @return [Integer]
6388
6651
  #
6389
6652
  # @!attribute [rw] server_name
6390
- # Fully qualified domain name of the endpoint.
6653
+ # The host name of the endpoint database.
6654
+ #
6655
+ # For an Amazon RDS PostgreSQL instance, this is the output of
6656
+ # [DescribeDBInstances][1], in the ` Endpoint.Address` field.
6657
+ #
6658
+ # For an Aurora PostgreSQL instance, this is the output of
6659
+ # [DescribeDBClusters][2], in the `Endpoint` field.
6660
+ #
6661
+ #
6662
+ #
6663
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html
6664
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusters.html
6391
6665
  # @return [String]
6392
6666
  #
6393
6667
  # @!attribute [rw] username
@@ -6487,6 +6761,134 @@ module Aws::DatabaseMigrationService
6487
6761
  include Aws::Structure
6488
6762
  end
6489
6763
 
6764
+ # Provides information that describes the configuration of the
6765
+ # recommended target engine on Amazon RDS.
6766
+ #
6767
+ # @!attribute [rw] engine_edition
6768
+ # Describes the recommended target Amazon RDS engine edition.
6769
+ # @return [String]
6770
+ #
6771
+ # @!attribute [rw] instance_type
6772
+ # Describes the recommended target Amazon RDS instance type.
6773
+ # @return [String]
6774
+ #
6775
+ # @!attribute [rw] instance_vcpu
6776
+ # Describes the number of virtual CPUs (vCPU) on the recommended
6777
+ # Amazon RDS DB instance that meets your requirements.
6778
+ # @return [Float]
6779
+ #
6780
+ # @!attribute [rw] instance_memory
6781
+ # Describes the memory on the recommended Amazon RDS DB instance that
6782
+ # meets your requirements.
6783
+ # @return [Float]
6784
+ #
6785
+ # @!attribute [rw] storage_type
6786
+ # Describes the storage type of the recommended Amazon RDS DB instance
6787
+ # that meets your requirements.
6788
+ #
6789
+ # Amazon RDS provides three storage types: General Purpose SSD (also
6790
+ # known as gp2 and gp3), Provisioned IOPS SSD (also known as io1), and
6791
+ # magnetic (also known as standard).
6792
+ # @return [String]
6793
+ #
6794
+ # @!attribute [rw] storage_size
6795
+ # Describes the storage size of the recommended Amazon RDS DB instance
6796
+ # that meets your requirements.
6797
+ # @return [Integer]
6798
+ #
6799
+ # @!attribute [rw] storage_iops
6800
+ # Describes the number of I/O operations completed each second (IOPS)
6801
+ # on the recommended Amazon RDS DB instance that meets your
6802
+ # requirements.
6803
+ # @return [Integer]
6804
+ #
6805
+ # @!attribute [rw] deployment_option
6806
+ # Describes the deployment option for the recommended Amazon RDS DB
6807
+ # instance. The deployment options include Multi-AZ and Single-AZ
6808
+ # deployments. Valid values include `"MULTI_AZ"` and `"SINGLE_AZ"`.
6809
+ # @return [String]
6810
+ #
6811
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/RdsConfiguration AWS API Documentation
6812
+ #
6813
+ class RdsConfiguration < Struct.new(
6814
+ :engine_edition,
6815
+ :instance_type,
6816
+ :instance_vcpu,
6817
+ :instance_memory,
6818
+ :storage_type,
6819
+ :storage_size,
6820
+ :storage_iops,
6821
+ :deployment_option)
6822
+ SENSITIVE = []
6823
+ include Aws::Structure
6824
+ end
6825
+
6826
+ # Provides information that describes a recommendation of a target
6827
+ # engine on Amazon RDS.
6828
+ #
6829
+ # @!attribute [rw] requirements_to_target
6830
+ # Supplemental information about the requirements to the recommended
6831
+ # target database on Amazon RDS.
6832
+ # @return [Types::RdsRequirements]
6833
+ #
6834
+ # @!attribute [rw] target_configuration
6835
+ # Supplemental information about the configuration of the recommended
6836
+ # target database on Amazon RDS.
6837
+ # @return [Types::RdsConfiguration]
6838
+ #
6839
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/RdsRecommendation AWS API Documentation
6840
+ #
6841
+ class RdsRecommendation < Struct.new(
6842
+ :requirements_to_target,
6843
+ :target_configuration)
6844
+ SENSITIVE = []
6845
+ include Aws::Structure
6846
+ end
6847
+
6848
+ # Provides information that describes the requirements to the target
6849
+ # engine on Amazon RDS.
6850
+ #
6851
+ # @!attribute [rw] engine_edition
6852
+ # The required target Amazon RDS engine edition.
6853
+ # @return [String]
6854
+ #
6855
+ # @!attribute [rw] instance_vcpu
6856
+ # The required number of virtual CPUs (vCPU) on the Amazon RDS DB
6857
+ # instance.
6858
+ # @return [Float]
6859
+ #
6860
+ # @!attribute [rw] instance_memory
6861
+ # The required memory on the Amazon RDS DB instance.
6862
+ # @return [Float]
6863
+ #
6864
+ # @!attribute [rw] storage_size
6865
+ # The required Amazon RDS DB instance storage size.
6866
+ # @return [Integer]
6867
+ #
6868
+ # @!attribute [rw] storage_iops
6869
+ # The required number of I/O operations completed each second (IOPS)
6870
+ # on your Amazon RDS DB instance.
6871
+ # @return [Integer]
6872
+ #
6873
+ # @!attribute [rw] deployment_option
6874
+ # The required deployment option for the Amazon RDS DB instance. Valid
6875
+ # values include `"MULTI_AZ"` for Multi-AZ deployments and
6876
+ # `"SINGLE_AZ"` for Single-AZ deployments.
6877
+ # @return [String]
6878
+ #
6879
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/RdsRequirements AWS API Documentation
6880
+ #
6881
+ class RdsRequirements < Struct.new(
6882
+ :engine_edition,
6883
+ :instance_vcpu,
6884
+ :instance_memory,
6885
+ :storage_size,
6886
+ :storage_iops,
6887
+ :deployment_option)
6888
+ SENSITIVE = []
6889
+ include Aws::Structure
6890
+ end
6891
+
6490
6892
  # @!attribute [rw] replication_instance_arn
6491
6893
  # The Amazon Resource Name (ARN) of the replication instance.
6492
6894
  # @return [String]
@@ -6529,6 +6931,111 @@ module Aws::DatabaseMigrationService
6529
6931
  include Aws::Structure
6530
6932
  end
6531
6933
 
6934
+ # Provides information that describes a recommendation of a target
6935
+ # engine.
6936
+ #
6937
+ # A *recommendation* is a set of possible Amazon Web Services target
6938
+ # engines that you can choose to migrate your source on-premises
6939
+ # database. In this set, Fleet Advisor suggests a single target engine
6940
+ # as the right sized migration destination. To determine this rightsized
6941
+ # migration destination, Fleet Advisor uses the inventory metadata and
6942
+ # metrics from data collector. You can use recommendations before the
6943
+ # start of migration to save costs and reduce risks.
6944
+ #
6945
+ # With recommendations, you can explore different target options and
6946
+ # compare metrics, so you can make an informed decision when you choose
6947
+ # the migration target.
6948
+ #
6949
+ # @!attribute [rw] database_id
6950
+ # The identifier of the source database for which Fleet Advisor
6951
+ # provided this recommendation.
6952
+ # @return [String]
6953
+ #
6954
+ # @!attribute [rw] engine_name
6955
+ # The name of the target engine. Valid values include
6956
+ # `"rds-aurora-mysql"`, `"rds-aurora-postgresql"`, `"rds-mysql"`,
6957
+ # `"rds-oracle"`, `"rds-sql-server"`, and `"rds-postgresql"`.
6958
+ # @return [String]
6959
+ #
6960
+ # @!attribute [rw] created_date
6961
+ # The date when Fleet Advisor created the target engine
6962
+ # recommendation.
6963
+ # @return [String]
6964
+ #
6965
+ # @!attribute [rw] status
6966
+ # The status of the target engine recommendation. Valid values include
6967
+ # `"alternate"`, `"in-progress"`, `"not-viable"`, and `"recommended"`.
6968
+ # @return [String]
6969
+ #
6970
+ # @!attribute [rw] preferred
6971
+ # Indicates that this target is the rightsized migration destination.
6972
+ # @return [Boolean]
6973
+ #
6974
+ # @!attribute [rw] settings
6975
+ # The settings in JSON format for the preferred target engine
6976
+ # parameters. These parameters include capacity, resource utilization,
6977
+ # and the usage type (production, development, or testing).
6978
+ # @return [Types::RecommendationSettings]
6979
+ #
6980
+ # @!attribute [rw] data
6981
+ # The recommendation of a target engine for the specified source
6982
+ # database.
6983
+ # @return [Types::RecommendationData]
6984
+ #
6985
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/Recommendation AWS API Documentation
6986
+ #
6987
+ class Recommendation < Struct.new(
6988
+ :database_id,
6989
+ :engine_name,
6990
+ :created_date,
6991
+ :status,
6992
+ :preferred,
6993
+ :settings,
6994
+ :data)
6995
+ SENSITIVE = []
6996
+ include Aws::Structure
6997
+ end
6998
+
6999
+ # Provides information about the target engine for the specified source
7000
+ # database.
7001
+ #
7002
+ # @!attribute [rw] rds_engine
7003
+ # The recommendation of a target Amazon RDS database engine.
7004
+ # @return [Types::RdsRecommendation]
7005
+ #
7006
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/RecommendationData AWS API Documentation
7007
+ #
7008
+ class RecommendationData < Struct.new(
7009
+ :rds_engine)
7010
+ SENSITIVE = []
7011
+ include Aws::Structure
7012
+ end
7013
+
7014
+ # Provides information about the required target engine settings.
7015
+ #
7016
+ # @!attribute [rw] instance_sizing_type
7017
+ # The size of your target instance. Fleet Advisor calculates this
7018
+ # value based on your data collection type, such as total capacity and
7019
+ # resource utilization. Valid values include `"total-capacity"` and
7020
+ # `"utilization"`.
7021
+ # @return [String]
7022
+ #
7023
+ # @!attribute [rw] workload_type
7024
+ # The deployment option for your target engine. For production
7025
+ # databases, Fleet Advisor chooses Multi-AZ deployment. For
7026
+ # development or test databases, Fleet Advisor chooses Single-AZ
7027
+ # deployment. Valid values include `"development"` and `"production"`.
7028
+ # @return [String]
7029
+ #
7030
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/RecommendationSettings AWS API Documentation
7031
+ #
7032
+ class RecommendationSettings < Struct.new(
7033
+ :instance_sizing_type,
7034
+ :workload_type)
7035
+ SENSITIVE = []
7036
+ include Aws::Structure
7037
+ end
7038
+
6532
7039
  # Provides information that defines a Redis target endpoint.
6533
7040
  #
6534
7041
  # @!attribute [rw] server_name
@@ -7534,7 +8041,7 @@ module Aws::DatabaseMigrationService
7534
8041
  # “server\_time:2018-02-09T12:12:12”
7535
8042
  #
7536
8043
  # Commit time example: --cdc-stop-position “commit\_time:
7537
- # 2018-02-09T12:12:12
8044
+ # 2018-02-09T12:12:12“
7538
8045
  # @return [String]
7539
8046
  #
7540
8047
  # @!attribute [rw] recovery_checkpoint
@@ -8785,6 +9292,51 @@ module Aws::DatabaseMigrationService
8785
9292
  include Aws::Structure
8786
9293
  end
8787
9294
 
9295
+ # @!attribute [rw] database_id
9296
+ # The identifier of the source database to analyze and provide
9297
+ # recommendations for.
9298
+ # @return [String]
9299
+ #
9300
+ # @!attribute [rw] settings
9301
+ # The settings in JSON format that Fleet Advisor uses to determine
9302
+ # target engine recommendations. These parameters include target
9303
+ # instance sizing and availability and durability settings. For target
9304
+ # instance sizing, Fleet Advisor supports the following two options:
9305
+ # total capacity and resource utilization. For availability and
9306
+ # durability, Fleet Advisor supports the following two options:
9307
+ # production (Multi-AZ deployments) and Dev/Test (Single-AZ
9308
+ # deployments).
9309
+ # @return [Types::RecommendationSettings]
9310
+ #
9311
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/StartRecommendationsRequest AWS API Documentation
9312
+ #
9313
+ class StartRecommendationsRequest < Struct.new(
9314
+ :database_id,
9315
+ :settings)
9316
+ SENSITIVE = []
9317
+ include Aws::Structure
9318
+ end
9319
+
9320
+ # Provides information about the source database to analyze and provide
9321
+ # target recommendations according to the specified requirements.
9322
+ #
9323
+ # @!attribute [rw] database_id
9324
+ # The identifier of the source database.
9325
+ # @return [String]
9326
+ #
9327
+ # @!attribute [rw] settings
9328
+ # The required target engine settings.
9329
+ # @return [Types::RecommendationSettings]
9330
+ #
9331
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/StartRecommendationsRequestEntry AWS API Documentation
9332
+ #
9333
+ class StartRecommendationsRequestEntry < Struct.new(
9334
+ :database_id,
9335
+ :settings)
9336
+ SENSITIVE = []
9337
+ include Aws::Structure
9338
+ end
9339
+
8788
9340
  # @!attribute [rw] replication_task_arn
8789
9341
  # The Amazon Resource Name (ARN) of the replication task.
8790
9342
  # @return [String]
@@ -8924,13 +9476,20 @@ module Aws::DatabaseMigrationService
8924
9476
  #
8925
9477
  # When the migration type is `full-load` or `full-load-and-cdc`, the
8926
9478
  # only valid value for the first run of the task is
8927
- # `start-replication`. You use `reload-target` to restart the task and
8928
- # `resume-processing` to resume the task.
9479
+ # `start-replication`. This option will start the migration.
9480
+ #
9481
+ # You can also use ReloadTables to reload specific tables that failed
9482
+ # during migration instead of restarting the task.
9483
+ #
9484
+ # The `resume-processing` option isn't applicable for a full-load
9485
+ # task, because you can't resume partially loaded tables during the
9486
+ # full load phase.
8929
9487
  #
8930
- # When the migration type is `cdc`, you use `start-replication` to
8931
- # start or restart the task, and `resume-processing` to resume the
8932
- # task. `reload-target` is not a valid value for a task with migration
8933
- # type of `cdc`.
9488
+ # For a `full-load-and-cdc` task, DMS migrates table data, and then
9489
+ # applies data changes that occur on the source. To load all the
9490
+ # tables again, and start capturing source changes, use
9491
+ # `reload-target`. Otherwise use `resume-processing`, to replicate the
9492
+ # changes from the last stop position.
8934
9493
  # @return [String]
8935
9494
  #
8936
9495
  # @!attribute [rw] cdc_start_time
@@ -8979,7 +9538,7 @@ module Aws::DatabaseMigrationService
8979
9538
  # “server\_time:2018-02-09T12:12:12”
8980
9539
  #
8981
9540
  # Commit time example: --cdc-stop-position “commit\_time:
8982
- # 2018-02-09T12:12:12
9541
+ # 2018-02-09T12:12:12“
8983
9542
  # @return [String]
8984
9543
  #
8985
9544
  # @see http://docs.aws.amazon.com/goto/WebAPI/dms-2016-01-01/StartReplicationTaskMessage AWS API Documentation