DatabaseMigrationService / Client / batch_start_recommendations

batch_start_recommendations#

DatabaseMigrationService.Client.batch_start_recommendations(**kwargs)#

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

  • DatabaseMigrationService.Client.exceptions.InvalidResourceStateFault

  • DatabaseMigrationService.Client.exceptions.AccessDeniedFault

  • DatabaseMigrationService.Client.exceptions.ResourceNotFoundFault