start_migration async ¶

async def start_migration(
    self,
    v1_bot_name: "capo_lex_model_building_service.types.bot_name.BotName",
    v1_bot_version: "capo_lex_model_building_service.types.version.Version",
    v2_bot_name: "capo_lex_model_building_service.types.v2_bot_name.V2BotName",
    v2_bot_role: "capo_lex_model_building_service.types.iam_role_arn.IamRoleArn",
    migration_strategy: "capo_lex_model_building_service.types.migration_strategy.MigrationStrategy",
    *,
    config_overrides: Optional[AsyncLexModelBuildingServiceClientConfig] = None,
) -> "capo_lex_model_building_service.types.start_migration_response.StartMigrationResponse":
    """<p>Starts migrating a bot from Amazon Lex V1 to Amazon Lex V2. Migrate your bot when you want to take advantage of the new features of Amazon Lex V2.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/lex/latest/dg/migrate.html">Migrating a bot</a> in the <i>Amazon Lex developer guide</i>.</p>

    Args:
        v1_bot_name: <p>The name of the Amazon Lex V1 bot that you are migrating to Amazon Lex V2.</p>
        v1_bot_version: <p>The version of the bot to migrate to Amazon Lex V2. You can migrate the <code>$LATEST</code> version as well as any numbered version.</p>
        v2_bot_name: <p>The name of the Amazon Lex V2 bot that you are migrating the Amazon Lex V1 bot to. </p> <ul> <li> <p>If the Amazon Lex V2 bot doesn't exist, you must use the <code>CREATE_NEW</code> migration strategy.</p> </li> <li> <p>If the Amazon Lex V2 bot exists, you must use the <code>UPDATE_EXISTING</code> migration strategy to change the contents of the Amazon Lex V2 bot.</p> </li> </ul>
        v2_bot_role: <p>The IAM role that Amazon Lex uses to run the Amazon Lex V2 bot.</p>
        migration_strategy: <p>The strategy used to conduct the migration.</p> <ul> <li> <p> <code>CREATE_NEW</code> - Creates a new Amazon Lex V2 bot and migrates the Amazon Lex V1 bot to the new bot.</p> </li> <li> <p> <code>UPDATE_EXISTING</code> - Overwrites the existing Amazon Lex V2 bot metadata and the locale being migrated. It doesn't change any other locales in the Amazon Lex V2 bot. If the locale doesn't exist, a new locale is created in the Amazon Lex V2 bot.</p> </li> </ul>

    Raises:
        capo_lex_model_building_service.errors.access_denied_exception.AccessDeniedException: <p>Your IAM user or role does not have permission to call the Amazon Lex V2 APIs required to migrate your bot.</p>
        capo_lex_model_building_service.errors.bad_request_exception.BadRequestException: <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the field values, and try again.</p>
        capo_lex_model_building_service.errors.internal_failure_exception.InternalFailureException: <p>An internal Amazon Lex error occurred. Try your request again.</p>
        capo_lex_model_building_service.errors.limit_exceeded_exception.LimitExceededException: <p>The request exceeded a limit. Try your request again.</p>
        capo_lex_model_building_service.errors.not_found_exception.NotFoundException: <p>The resource specified in the request was not found. Check the resource and try again.</p>
        capo_lex_model_building_service.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_lex_model_building_service.types.start_migration_request.StartMigrationRequest]",
    ) -> AsyncOperationResponse[
        "capo_lex_model_building_service.types.start_migration_response.StartMigrationResponse"
    ]:
        import capo_lex_model_building_service._operations.aws_deep_sense_model_building_service.start_migration

        (
            output,
            http_response,
        ) = await capo_lex_model_building_service._operations.aws_deep_sense_model_building_service.start_migration.async_start_migration(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("StartMigration")
    )
    input_: capo_lex_model_building_service.types.start_migration_request.StartMigrationRequest = {
        "v1_bot_name": v1_bot_name,
        "v1_bot_version": v1_bot_version,
        "v2_bot_name": v2_bot_name,
        "v2_bot_role": v2_bot_role,
        "migration_strategy": migration_strategy,
    }

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output