aws-sdk-databasemigrationservice 1.75.0 → 1.76.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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