aws_sdk_personalize/client/

create_solution_version.rs

// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
impl super::Client {
    /// Constructs a fluent builder for the [`CreateSolutionVersion`](crate::operation::create_solution_version::builders::CreateSolutionVersionFluentBuilder) operation.
    ///
    /// - The fluent builder is configurable:
    ///   - [`name(impl Into<String>)`](crate::operation::create_solution_version::builders::CreateSolutionVersionFluentBuilder::name) / [`set_name(Option<String>)`](crate::operation::create_solution_version::builders::CreateSolutionVersionFluentBuilder::set_name):<br>required: **false**<br><p>The name of the solution version.</p><br>
    ///   - [`solution_arn(impl Into<String>)`](crate::operation::create_solution_version::builders::CreateSolutionVersionFluentBuilder::solution_arn) / [`set_solution_arn(Option<String>)`](crate::operation::create_solution_version::builders::CreateSolutionVersionFluentBuilder::set_solution_arn):<br>required: **true**<br><p>The Amazon Resource Name (ARN) of the solution containing the training configuration information.</p><br>
    ///   - [`training_mode(TrainingMode)`](crate::operation::create_solution_version::builders::CreateSolutionVersionFluentBuilder::training_mode) / [`set_training_mode(Option<TrainingMode>)`](crate::operation::create_solution_version::builders::CreateSolutionVersionFluentBuilder::set_training_mode):<br>required: **false**<br><p>The scope of training to be performed when creating the solution version. The default is <code>FULL</code>. This creates a completely new model based on the entirety of the training data from the datasets in your dataset group.</p> <p>If you use <a href="https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html">User-Personalization</a>, you can specify a training mode of <code>UPDATE</code>. This updates the model to consider new items for recommendations. It is not a full retraining. You should still complete a full retraining weekly. If you specify <code>UPDATE</code>, Amazon Personalize will stop automatic updates for the solution version. To resume updates, create a new solution with training mode set to <code>FULL</code> and deploy it in a campaign. For more information about automatic updates, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#maintaining-with-automatic-updates">Automatic updates</a>.</p> <p>The <code>UPDATE</code> option can only be used when you already have an active solution version created from the input solution using the <code>FULL</code> option and the input solution was trained with the <a href="https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html">User-Personalization</a> recipe or the legacy <a href="https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-hrnn-coldstart.html">HRNN-Coldstart</a> recipe.</p><br>
    ///   - [`tags(Tag)`](crate::operation::create_solution_version::builders::CreateSolutionVersionFluentBuilder::tags) / [`set_tags(Option<Vec::<Tag>>)`](crate::operation::create_solution_version::builders::CreateSolutionVersionFluentBuilder::set_tags):<br>required: **false**<br><p>A list of <a href="https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html">tags</a> to apply to the solution version.</p><br>
    /// - On success, responds with [`CreateSolutionVersionOutput`](crate::operation::create_solution_version::CreateSolutionVersionOutput) with field(s):
    ///   - [`solution_version_arn(Option<String>)`](crate::operation::create_solution_version::CreateSolutionVersionOutput::solution_version_arn): <p>The ARN of the new solution version.</p>
    /// - On failure, responds with [`SdkError<CreateSolutionVersionError>`](crate::operation::create_solution_version::CreateSolutionVersionError)
    pub fn create_solution_version(&self) -> crate::operation::create_solution_version::builders::CreateSolutionVersionFluentBuilder {
        crate::operation::create_solution_version::builders::CreateSolutionVersionFluentBuilder::new(self.handle.clone())
    }
}