Skip to content

Updates an Amazon Personalize solution to use a different automatic training configuration

Description

Updates an Amazon Personalize solution to use a different automatic training configuration. When you update a solution, you can change whether the solution uses automatic training, and you can change the training frequency. For more information about updating a solution, see Updating a solution.

A solution update can be in one of the following states:

CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

To get the status of a solution update, call the describe_solution API operation and find the status in the latestSolutionUpdate.

Usage

personalize_update_solution(solutionArn, performAutoTraining,
  performIncrementalUpdate, solutionUpdateConfig)

Arguments

  • solutionArn

    [required] The Amazon Resource Name (ARN) of the solution to update.

  • performAutoTraining

    Whether the solution uses automatic training to create new solution versions (trained models). You can change the training frequency by specifying a schedulingExpression in the AutoTrainingConfig as part of solution configuration.

    If you turn on automatic training, the first automatic training starts within one hour after the solution update completes. If you manually create a solution version within the hour, the solution skips the first automatic training. For more information about automatic training, see Configuring automatic training.

    After training starts, you can get the solution version's Amazon Resource Name (ARN) with the list_solution_versions API operation. To get its status, use the describe_solution_version.

  • performIncrementalUpdate

    Whether to perform incremental training updates on your model. When enabled, this allows the model to learn from new data more frequently without requiring full retraining, which enables near real-time personalization. This parameter is supported only for solutions that use the semantic-similarity recipe.

  • solutionUpdateConfig

    The new configuration details of the solution.

Value

A list with the following syntax:

list(
  solutionArn = "string"
)

Request syntax

svc$update_solution(
  solutionArn = "string",
  performAutoTraining = TRUE|FALSE,
  performIncrementalUpdate = TRUE|FALSE,
  solutionUpdateConfig = list(
    autoTrainingConfig = list(
      schedulingExpression = "string"
    ),
    eventsConfig = list(
      eventParametersList = list(
        list(
          eventType = "string",
          eventValueThreshold = 123.0,
          weight = 123.0
        )
      )
    )
  )
)