DatabaseMigrationService / Client / batch_start_recommendations

batch_start_recommendations

DatabaseMigrationService.Client.batch_start_recommendations(**kwargs)

Warning

End of support notice: On May 20, 2026, Amazon Web Services will end support for Amazon Web Services DMS Fleet Advisor;. After May 20, 2026, you will no longer be able to access the Amazon Web Services DMS Fleet Advisor; console or Amazon Web Services DMS Fleet Advisor; resources. For more information, see Amazon Web Services DMS Fleet Advisor end of support.

Starts the analysis of up to 20 source databases to recommend target engines for each source database. This is a batch version of StartRecommendations.

The result of analysis of each source database is reported individually in the response. Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of 200.

See also: AWS API Documentation

Request Syntax

response = client.batch_start_recommendations(
    Data=[
        {
            'DatabaseId': 'string',
            'Settings': {
                'InstanceSizingType': 'string',
                'WorkloadType': 'string'
            }
        },
    ]
)
Parameters:

Data (list) –

Provides information about source databases to analyze. After this analysis, Fleet Advisor recommends target engines for each source database.

  • (dict) –

    Provides information about the source database to analyze and provide target recommendations according to the specified requirements.

    • DatabaseId (string) – [REQUIRED]

      The identifier of the source database.

    • Settings (dict) – [REQUIRED]

      The required target engine settings.

      • InstanceSizingType (string) – [REQUIRED]

        The size of your target instance. Fleet Advisor calculates this value based on your data collection type, such as total capacity and resource utilization. Valid values include "total-capacity" and "utilization".

      • WorkloadType (string) – [REQUIRED]

        The deployment option for your target engine. For production databases, Fleet Advisor chooses Multi-AZ deployment. For development or test databases, Fleet Advisor chooses Single-AZ deployment. Valid values include "development" and "production".

Return type:

dict

Returns:

Response Syntax

{
    'ErrorEntries': [
        {
            'DatabaseId': 'string',
            'Message': 'string',
            'Code': 'string'
        },
    ]
}

Response Structure

  • (dict) –

    • ErrorEntries (list) –

      A list with error details about the analysis of each source database.

      • (dict) –

        Provides information about the errors that occurred during the analysis of the source database.

        • DatabaseId (string) –

          The identifier of the source database.

        • Message (string) –

          The information about the error.

        • Code (string) –

          The code of an error that occurred during the analysis of the source database.

Exceptions