Skip to content

batch_start_recommendations

batch_start_recommendations(
    *,
    config_overrides: Optional[DatabaseMigrationServiceClientConfig] = None,
    data: Optional[StartRecommendationsRequestEntryList] = None,
) -> BatchStartRecommendationsResponse

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.

Parameters:

Raises:

Source code in docs_src/capo_database_migration_service/_services/database_migration_service.py
def batch_start_recommendations(
    self,
    *,
    config_overrides: Optional[DatabaseMigrationServiceClientConfig] = None,
    data: Optional[
        "capo_database_migration_service.types.start_recommendations_request_entry_list.StartRecommendationsRequestEntryList"
    ] = None,
) -> "capo_database_migration_service.types.batch_start_recommendations_response.BatchStartRecommendationsResponse":
    """<important> <p> 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 <a href="https://docs.aws.amazon.com/dms/latest/userguide/dms_fleet.advisor-end-of-support.html">Amazon Web Services DMS Fleet Advisor end of support</a>. </p> </important> <p>Starts the analysis of up to 20 source databases to recommend target engines for each source database. This is a batch version of <a href="https://docs.aws.amazon.com/dms/latest/APIReference/API_StartRecommendations.html">StartRecommendations</a>.</p> <p>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 <code>200</code>.</p>

    Args:
        data: <p>Provides information about source databases to analyze. After this analysis, Fleet Advisor recommends target engines for each source database.</p>

    Raises:
        capo_database_migration_service.errors.access_denied_fault.AccessDeniedFault: <p>DMS was denied access to the endpoint. Check that the role is correctly configured.</p>
        capo_database_migration_service.errors.invalid_resource_state_fault.InvalidResourceStateFault: <p>The resource is in a state that prevents it from being used for database migration.</p>
        capo_database_migration_service.errors.resource_not_found_fault.ResourceNotFoundFault: <p>The resource could not be found.</p>
        capo_database_migration_service.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_database_migration_service.types.batch_start_recommendations_request.BatchStartRecommendationsRequest]",
    ) -> OperationResponse[
        "capo_database_migration_service.types.batch_start_recommendations_response.BatchStartRecommendationsResponse"
    ]:
        import capo_database_migration_service._operations.amazon_dm_sv20160101.batch_start_recommendations

        output, http_response = (
            capo_database_migration_service._operations.amazon_dm_sv20160101.batch_start_recommendations.batch_start_recommendations(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("BatchStartRecommendations")
    )
    input_: capo_database_migration_service.types.batch_start_recommendations_request.BatchStartRecommendationsRequest = {}
    if data is not None:
        input_["data"] = data

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output