Amazon Personalize Update: AWS Personalize: Adds ability to create a solution version using FULL or UPDATE training mode

Author: AWS

.changes/next-release/feature-AmazonPersonalize-64d9729.json

@@ -0,0 +1,5 @@
+{
+    "type": "feature",
+    "category": "Amazon Personalize",
+    "description": "AWS Personalize: Adds ability to create a solution version using FULL or UPDATE training mode"
+}

services/personalize/src/main/resources/codegen-resources/service-2.json

@@ -1074,6 +1074,10 @@
         "solutionArn":{
           "shape":"Arn",
           "documentation":"<p>The Amazon Resource Name (ARN) of the solution containing the training configuration information.</p>"
+        },
+        "trainingMode":{
+          "shape":"TrainingMode",
+          "documentation":"<p>The scope of training to be performed when creating the solution version. The <code>FULL</code> option trains the solution version based on the entirety of the input solution's training data, while the <code>UPDATE</code> option processes only the data that has changed in comparison to the input solution. Choose <code>UPDATE</code> when you want to incrementally update your solution version instead of creating an entirely new one.</p> <important> <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>native-recipe-hrnn-coldstart</a> recipe.</p> </important>"
         }
       }
     },
@@ -1934,11 +1938,11 @@
       "members":{
         "maxNumberOfTrainingJobs":{
           "shape":"HPOResource",
-          "documentation":"<p>The maximum number of training jobs.</p>"
+          "documentation":"<p>The maximum number of training jobs when you create a solution version. The maximum value for <code>maxNumberOfTrainingJobs</code> is <code>40</code>.</p>"
         },
         "maxParallelTrainingJobs":{
           "shape":"HPOResource",
-          "documentation":"<p>The maximum number of parallel training jobs.</p>"
+          "documentation":"<p>The maximum number of parallel training jobs when you create a solution version. The maximum value for <code>maxParallelTrainingJobs</code> is <code>10</code>.</p>"
         }
       },
       "documentation":"<p>Describes the resource configuration for hyperparameter optimization (HPO).</p>"
@@ -2577,7 +2581,7 @@
         },
         "performAutoML":{
           "shape":"PerformAutoML",
-          "documentation":"<p>When true, Amazon Personalize performs a search for the most optimal recipe according to the solution configuration. When false (the default), Amazon Personalize uses <code>recipeArn</code>.</p>"
+          "documentation":"<p>When true, Amazon Personalize searches for the most optimal recipe according to the solution configuration. When false (the default), Amazon Personalize uses <code>recipeArn</code>.</p>"
         },
         "recipeArn":{
           "shape":"Arn",
@@ -2597,15 +2601,19 @@
         },
         "trainingHours":{
           "shape":"TrainingHours",
-          "documentation":"<p>The time used to train the model. </p>"
+          "documentation":"<p>The time used to train the model. You are billed for the time it takes to train a model. This field is visible only after Amazon Personalize successfully trains a model.</p>"
+        },
+        "trainingMode":{
+          "shape":"TrainingMode",
+          "documentation":"<p>The scope of training used to create the solution version. The <code>FULL</code> option trains the solution version based on the entirety of the input solution's training data, while the <code>UPDATE</code> option processes only the training data that has changed since the creation of the last solution version. Choose <code>UPDATE</code> when you want to start recommending items added to the dataset without retraining the model.</p> <important> <p>The <code>UPDATE</code> option can only be used after you've created a solution version with the <code>FULL</code> option and the training solution uses the <a>native-recipe-hrnn-coldstart</a>.</p> </important>"
         },
         "status":{
           "shape":"Status",
-          "documentation":"<p>The status of the solution version.</p> <p>A solution version can be in one of the following states:</p> <ul> <li> <p>CREATE PENDING &gt; CREATE IN_PROGRESS &gt; ACTIVE -or- CREATE FAILED</p> </li> </ul>"
+          "documentation":"<p>The status of the solution version.</p> <p>A solution version can be in one of the following states:</p> <ul> <li> <p>CREATE PENDING</p> </li> <li> <p>CREATE IN_PROGRESS</p> </li> <li> <p>ACTIVE</p> </li> <li> <p>CREATE FAILED</p> </li> </ul>"
         },
         "failureReason":{
           "shape":"FailureReason",
-          "documentation":"<p>If training a solution version fails, the reason behind the failure.</p>"
+          "documentation":"<p>If training a solution version fails, the reason for the failure.</p>"
         },
         "creationDateTime":{
           "shape":"Date",
@@ -2670,6 +2678,13 @@
       "type":"string",
       "max":256
     },
+    "TrainingMode":{
+      "type":"string",
+      "enum":[
+        "FULL",
+        "UPDATE"
+      ]
+    },
     "TransactionsPerSecond":{
       "type":"integer",
       "min":1