@aws-sdk/client-personalize 3.554.0 → 3.559.0

package/dist-cjs/index.js

@@ -104,6 +104,7 @@ __export(src_exports, {
   TooManyTagKeysException: () => TooManyTagKeysException,
   TooManyTagsException: () => TooManyTagsException,
   TrainingMode: () => TrainingMode,
+  TrainingType: () => TrainingType,
   UntagResourceCommand: () => UntagResourceCommand,
   UpdateCampaignCommand: () => UpdateCampaignCommand,
   UpdateDatasetCommand: () => UpdateDatasetCommand,
@@ -430,9 +431,14 @@ var ObjectiveSensitivity = {
   OFF: "OFF"
 };
 var TrainingMode = {
+  AUTOTRAIN: "AUTOTRAIN",
   FULL: "FULL",
   UPDATE: "UPDATE"
 };
+var TrainingType = {
+  AUTOMATIC: "AUTOMATIC",
+  MANUAL: "MANUAL"
+};
 var _InvalidNextTokenException = class _InvalidNextTokenException extends PersonalizeServiceException {
   /**
    * @internal
@@ -1857,6 +1863,7 @@ var se_CreateSolutionRequest = /* @__PURE__ */ __name((input, context) => {
     eventType: [],
     name: [],
     performAutoML: [],
+    performAutoTraining: [],
     performHPO: [],
     recipeArn: [],
     solutionConfig: (_) => se_SolutionConfig(_, context),
@@ -1881,6 +1888,7 @@ var se_SolutionConfig = /* @__PURE__ */ __name((input, context) => {
   return (0, import_smithy_client.take)(input, {
     algorithmHyperParameters: import_smithy_client._json,
     autoMLConfig: import_smithy_client._json,
+    autoTrainingConfig: import_smithy_client._json,
     eventValueThreshold: [],
     featureTransformationParameters: import_smithy_client._json,
     hpoConfig: (_) => se_HPOConfig(_, context),
@@ -2582,6 +2590,7 @@ var de_Solution = /* @__PURE__ */ __name((output, context) => {
     latestSolutionVersion: (_) => de_SolutionVersionSummary(_, context),
     name: import_smithy_client.expectString,
     performAutoML: import_smithy_client.expectBoolean,
+    performAutoTraining: import_smithy_client.expectBoolean,
     performHPO: import_smithy_client.expectBoolean,
     recipeArn: import_smithy_client.expectString,
     solutionArn: import_smithy_client.expectString,
@@ -2593,6 +2602,7 @@ var de_SolutionConfig = /* @__PURE__ */ __name((output, context) => {
   return (0, import_smithy_client.take)(output, {
     algorithmHyperParameters: import_smithy_client._json,
     autoMLConfig: import_smithy_client._json,
+    autoTrainingConfig: import_smithy_client._json,
     eventValueThreshold: import_smithy_client.expectString,
     featureTransformationParameters: import_smithy_client._json,
     hpoConfig: (_) => de_HPOConfig(_, context),
@@ -2633,6 +2643,7 @@ var de_SolutionVersion = /* @__PURE__ */ __name((output, context) => {
     status: import_smithy_client.expectString,
     trainingHours: import_smithy_client.limitedParseDouble,
     trainingMode: import_smithy_client.expectString,
+    trainingType: import_smithy_client.expectString,
     tunedHPOParams: import_smithy_client._json
   });
 }, "de_SolutionVersion");
@@ -2648,7 +2659,9 @@ var de_SolutionVersionSummary = /* @__PURE__ */ __name((output, context) => {
     failureReason: import_smithy_client.expectString,
     lastUpdatedDateTime: (_) => (0, import_smithy_client.expectNonNull)((0, import_smithy_client.parseEpochTimestamp)((0, import_smithy_client.expectNumber)(_))),
     solutionVersionArn: import_smithy_client.expectString,
-    status: import_smithy_client.expectString
+    status: import_smithy_client.expectString,
+    trainingMode: import_smithy_client.expectString,
+    trainingType: import_smithy_client.expectString
   });
 }, "de_SolutionVersionSummary");
 var deserializeMetadata = /* @__PURE__ */ __name((output) => ({
@@ -4061,6 +4074,7 @@ var paginateListSolutions = (0, import_core.createPaginator)(PersonalizeClient,
   ImportMode,
   ObjectiveSensitivity,
   TrainingMode,
+  TrainingType,
   InvalidNextTokenException,
   RecipeProvider,
   TooManyTagKeysException,

package/dist-es/models/models_0.js

@@ -96,9 +96,14 @@ export const ObjectiveSensitivity = {
     OFF: "OFF",
 };
 export const TrainingMode = {
+    AUTOTRAIN: "AUTOTRAIN",
     FULL: "FULL",
     UPDATE: "UPDATE",
 };
+export const TrainingType = {
+    AUTOMATIC: "AUTOMATIC",
+    MANUAL: "MANUAL",
+};
 export class InvalidNextTokenException extends __BaseException {
     constructor(opts) {
         super({

package/dist-es/protocols/Aws_json1_1.js

@@ -1378,6 +1378,7 @@ const se_CreateSolutionRequest = (input, context) => {
         eventType: [],
         name: [],
         performAutoML: [],
+        performAutoTraining: [],
         performHPO: [],
         recipeArn: [],
         solutionConfig: (_) => se_SolutionConfig(_, context),
@@ -1402,6 +1403,7 @@ const se_SolutionConfig = (input, context) => {
     return take(input, {
         algorithmHyperParameters: _json,
         autoMLConfig: _json,
+        autoTrainingConfig: _json,
         eventValueThreshold: [],
         featureTransformationParameters: _json,
         hpoConfig: (_) => se_HPOConfig(_, context),
@@ -2133,6 +2135,7 @@ const de_Solution = (output, context) => {
         latestSolutionVersion: (_) => de_SolutionVersionSummary(_, context),
         name: __expectString,
         performAutoML: __expectBoolean,
+        performAutoTraining: __expectBoolean,
         performHPO: __expectBoolean,
         recipeArn: __expectString,
         solutionArn: __expectString,
@@ -2144,6 +2147,7 @@ const de_SolutionConfig = (output, context) => {
     return take(output, {
         algorithmHyperParameters: _json,
         autoMLConfig: _json,
+        autoTrainingConfig: _json,
         eventValueThreshold: __expectString,
         featureTransformationParameters: _json,
         hpoConfig: (_) => de_HPOConfig(_, context),
@@ -2186,6 +2190,7 @@ const de_SolutionVersion = (output, context) => {
         status: __expectString,
         trainingHours: __limitedParseDouble,
         trainingMode: __expectString,
+        trainingType: __expectString,
         tunedHPOParams: _json,
     });
 };
@@ -2204,6 +2209,8 @@ const de_SolutionVersionSummary = (output, context) => {
         lastUpdatedDateTime: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
         solutionVersionArn: __expectString,
         status: __expectString,
+        trainingMode: __expectString,
+        trainingType: __expectString,
     });
 };
 const deserializeMetadata = (output) => ({

package/dist-types/commands/CreateCampaignCommand.d.ts

@@ -26,7 +26,11 @@ declare const CreateCampaignCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Creates a campaign that deploys a solution version. When a client calls the
+ * <important>
+ *             <p> You incur campaign costs while it is active. To avoid unnecessary costs, make sure to delete the campaign when you are finished. For information about campaign
+ *         costs, see <a href="https://aws.amazon.com/personalize/pricing/">Amazon Personalize pricing</a>.</p>
+ *          </important>
+ *          <p>Creates a campaign that deploys a solution version. When a client calls the
  *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html">GetRecommendations</a>
  *       and
  *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html">GetPersonalizedRanking</a>
@@ -112,6 +116,7 @@ declare const CreateCampaignCommand_base: {
  *       "<keys>": "STRING_VALUE",
  *     },
  *     enableMetadataWithRecommendations: true || false,
+ *     syncWithLatestSolutionVersion: true || false,
  *   },
  *   tags: [ // Tags
  *     { // Tag

package/dist-types/commands/CreateSolutionCommand.d.ts

@@ -26,19 +26,32 @@ declare const CreateSolutionCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Creates the configuration for training a model. A trained model is known as
- *       a solution version. After the configuration is created, you train the model (create a solution version)
- *       by calling the <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html">CreateSolutionVersion</a> operation. Every time you call
- *       <code>CreateSolutionVersion</code>, a new version of the solution is created.</p>
- *          <p>After creating a solution version, you check its accuracy by calling
- *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html">GetSolutionMetrics</a>. When you are satisfied with the version, you
+ * <important>
+ *             <p>After you create a solution, you can’t change its configuration. By default, all new solutions use automatic training. With automatic training, you incur training costs while
+ *            your solution is active. You can't stop automatic training for a solution. To avoid unnecessary costs, make sure to delete the solution when you are finished. For information about training
+ *   costs, see <a href="https://aws.amazon.com/personalize/pricing/">Amazon Personalize pricing</a>.</p>
+ *          </important>
+ *          <p>Creates the configuration for training a model (creating a solution version). This configuration
+ *       includes the recipe to use for model training and optional training configuration, such as columns to use
+ *       in training and feature transformation parameters. For more information about configuring a solution, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html">Creating and configuring a solution</a>.
+ *     </p>
+ *          <p>
+ *       By default, new solutions use automatic training to create solution versions every 7 days. You can change the training frequency.
+ *       Automatic solution version creation starts one hour after the solution is ACTIVE. If you manually create a solution version within
+ *       the hour, the solution skips the first automatic training. For more information,
+ *         see <a href="https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html">Configuring automatic training</a>.</p>
+ *          <p>
+ *       To turn off automatic training, set <code>performAutoTraining</code> to false. If you turn off automatic training, you must manually create a solution version
+ *       by calling the <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html">CreateSolutionVersion</a> operation.</p>
+ *          <p>After training starts, you can
+ *         get the solution version's Amazon Resource Name (ARN) with the <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html">ListSolutionVersions</a> API operation.
+ *         To get its status, use the <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html">DescribeSolutionVersion</a>.
+ *       </p>
+ *          <p>After training completes you can evaluate model accuracy by calling
+ *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html">GetSolutionMetrics</a>. When you are satisfied with the solution version, you
  *       deploy it using <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html">CreateCampaign</a>. The campaign provides recommendations
  *       to a client through the
  *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html">GetRecommendations</a> API.</p>
- *          <p>To train a model, Amazon Personalize requires training data and a recipe. The training data
- *       comes from the dataset group that you provide in the request. A recipe specifies
- *       the training algorithm and a feature transformation. You can specify one of the predefined
- *       recipes provided by Amazon Personalize. </p>
  *          <note>
  *             <p>Amazon Personalize doesn't support configuring the <code>hpoObjective</code>
  *         for solution hyperparameter optimization at this time.</p>
@@ -55,8 +68,8 @@ declare const CreateSolutionCommand_base: {
  *                <p>DELETE PENDING > DELETE IN_PROGRESS</p>
  *             </li>
  *          </ul>
- *          <p>To get the status of the solution, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html">DescribeSolution</a>. Wait
- *       until the status shows as ACTIVE before calling <code>CreateSolutionVersion</code>.</p>
+ *          <p>To get the status of the solution, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html">DescribeSolution</a>. If you use
+ *       manual training, the status must be ACTIVE before you call <code>CreateSolutionVersion</code>.</p>
  *          <p class="title">
  *             <b>Related APIs</b>
  *          </p>
@@ -104,6 +117,7 @@ declare const CreateSolutionCommand_base: {
  *   name: "STRING_VALUE", // required
  *   performHPO: true || false,
  *   performAutoML: true || false,
+ *   performAutoTraining: true || false,
  *   recipeArn: "STRING_VALUE",
  *   datasetGroupArn: "STRING_VALUE", // required
  *   eventType: "STRING_VALUE",
@@ -167,6 +181,9 @@ declare const CreateSolutionCommand_base: {
  *         ],
  *       },
  *     },
+ *     autoTrainingConfig: { // AutoTrainingConfig
+ *       schedulingExpression: "STRING_VALUE",
+ *     },
  *   },
  *   tags: [ // Tags
  *     { // Tag

package/dist-types/commands/CreateSolutionVersionCommand.d.ts

@@ -102,7 +102,7 @@ declare const CreateSolutionVersionCommand_base: {
  * const input = { // CreateSolutionVersionRequest
  *   name: "STRING_VALUE",
  *   solutionArn: "STRING_VALUE", // required
- *   trainingMode: "FULL" || "UPDATE",
+ *   trainingMode: "FULL" || "UPDATE" || "AUTOTRAIN",
  *   tags: [ // Tags
  *     { // Tag
  *       tagKey: "STRING_VALUE", // required

package/dist-types/commands/DescribeCampaignCommand.d.ts

@@ -61,6 +61,7 @@ declare const DescribeCampaignCommand_base: {
  * //         "<keys>": "STRING_VALUE",
  * //       },
  * //       enableMetadataWithRecommendations: true || false,
+ * //       syncWithLatestSolutionVersion: true || false,
  * //     },
  * //     status: "STRING_VALUE",
  * //     failureReason: "STRING_VALUE",
@@ -74,6 +75,7 @@ declare const DescribeCampaignCommand_base: {
  * //           "<keys>": "STRING_VALUE",
  * //         },
  * //         enableMetadataWithRecommendations: true || false,
+ * //         syncWithLatestSolutionVersion: true || false,
  * //       },
  * //       status: "STRING_VALUE",
  * //       failureReason: "STRING_VALUE",

package/dist-types/commands/DescribeSolutionCommand.d.ts

@@ -45,6 +45,7 @@ declare const DescribeSolutionCommand_base: {
  * //     solutionArn: "STRING_VALUE",
  * //     performHPO: true || false,
  * //     performAutoML: true || false,
+ * //     performAutoTraining: true || false,
  * //     recipeArn: "STRING_VALUE",
  * //     datasetGroupArn: "STRING_VALUE",
  * //     eventType: "STRING_VALUE",
@@ -108,6 +109,9 @@ declare const DescribeSolutionCommand_base: {
  * //           ],
  * //         },
  * //       },
+ * //       autoTrainingConfig: { // AutoTrainingConfig
+ * //         schedulingExpression: "STRING_VALUE",
+ * //       },
  * //     },
  * //     autoMLResult: { // AutoMLResult
  * //       bestRecipeArn: "STRING_VALUE",
@@ -118,6 +122,8 @@ declare const DescribeSolutionCommand_base: {
  * //     latestSolutionVersion: { // SolutionVersionSummary
  * //       solutionVersionArn: "STRING_VALUE",
  * //       status: "STRING_VALUE",
+ * //       trainingMode: "FULL" || "UPDATE" || "AUTOTRAIN",
+ * //       trainingType: "AUTOMATIC" || "MANUAL",
  * //       creationDateTime: new Date("TIMESTAMP"),
  * //       lastUpdatedDateTime: new Date("TIMESTAMP"),
  * //       failureReason: "STRING_VALUE",

package/dist-types/commands/DescribeSolutionVersionCommand.d.ts

@@ -109,9 +109,12 @@ declare const DescribeSolutionVersionCommand_base: {
  * //           ],
  * //         },
  * //       },
+ * //       autoTrainingConfig: { // AutoTrainingConfig
+ * //         schedulingExpression: "STRING_VALUE",
+ * //       },
  * //     },
  * //     trainingHours: Number("double"),
- * //     trainingMode: "FULL" || "UPDATE",
+ * //     trainingMode: "FULL" || "UPDATE" || "AUTOTRAIN",
  * //     tunedHPOParams: { // TunedHPOParams
  * //       algorithmHyperParameters: {
  * //         "<keys>": "STRING_VALUE",
@@ -121,6 +124,7 @@ declare const DescribeSolutionVersionCommand_base: {
  * //     failureReason: "STRING_VALUE",
  * //     creationDateTime: new Date("TIMESTAMP"),
  * //     lastUpdatedDateTime: new Date("TIMESTAMP"),
+ * //     trainingType: "AUTOMATIC" || "MANUAL",
  * //   },
  * // };
  *

package/dist-types/commands/ListSolutionVersionsCommand.d.ts

@@ -47,6 +47,8 @@ declare const ListSolutionVersionsCommand_base: {
  * //     { // SolutionVersionSummary
  * //       solutionVersionArn: "STRING_VALUE",
  * //       status: "STRING_VALUE",
+ * //       trainingMode: "FULL" || "UPDATE" || "AUTOTRAIN",
+ * //       trainingType: "AUTOMATIC" || "MANUAL",
  * //       creationDateTime: new Date("TIMESTAMP"),
  * //       lastUpdatedDateTime: new Date("TIMESTAMP"),
  * //       failureReason: "STRING_VALUE",

package/dist-types/commands/ListSolutionsCommand.d.ts

@@ -26,7 +26,7 @@ declare const ListSolutionsCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Returns a list of solutions that use the given dataset group.
+ * <p>Returns a list of solutions in a given dataset group.
  *       When a dataset group is not specified, all the solutions associated with the account are listed.
  *       The response provides the properties for each solution, including the Amazon Resource Name (ARN).
  *       For more information on solutions, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html">CreateSolution</a>.</p>

package/dist-types/commands/UntagResourceCommand.d.ts

@@ -26,7 +26,7 @@ declare const UntagResourceCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Remove <a href="https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html">tags</a> that are attached to a resource.</p>
+ * <p>Removes the specified tags that are attached to a resource. For more information, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/tags-remove.html">Removing tags from Amazon Personalize resources</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/UpdateCampaignCommand.d.ts

@@ -28,8 +28,19 @@ declare const UpdateCampaignCommand_base: {
 /**
  * <p>
  *       Updates a campaign to deploy a retrained solution version with an existing campaign, change your campaign's <code>minProvisionedTPS</code>,
- *       or modify your campaign's configuration, such as the exploration configuration.
- *     </p>
+ *       or modify your campaign's configuration. For example, you can set <code>enableMetadataWithRecommendations</code> to true for an existing campaign.</p>
+ *          <p>
+ *       To update a campaign to start automatically using the latest solution version, specify the following:</p>
+ *          <ul>
+ *             <li>
+ *                <p>For the <code>SolutionVersionArn</code> parameter, specify the Amazon Resource Name (ARN) of your solution in
+ *             <code>SolutionArn/$LATEST</code> format. </p>
+ *             </li>
+ *             <li>
+ *                <p> In the <code>campaignConfig</code>, set <code>syncWithLatestSolutionVersion</code> to <code>true</code>.
+ *         </p>
+ *             </li>
+ *          </ul>
  *          <p>To update a campaign, the campaign status must be ACTIVE or CREATE FAILED.
  *       Check the campaign status using the <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html">DescribeCampaign</a> operation.</p>
  *          <note>
@@ -54,6 +65,7 @@ declare const UpdateCampaignCommand_base: {
  *       "<keys>": "STRING_VALUE",
  *     },
  *     enableMetadataWithRecommendations: true || false,
+ *     syncWithLatestSolutionVersion: true || false,
  *   },
  * };
  * const command = new UpdateCampaignCommand(input);

package/dist-types/models/models_0.d.ts

@@ -243,7 +243,7 @@ export interface BatchInferenceJobOutput {
 }
 /**
  * <p>The optional metadata that you apply to resources to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define.
- *       For more information see <a href="https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html">Tagging Amazon Personalize recources</a>.
+ *       For more information see <a href="https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html">Tagging Amazon Personalize resources</a>.
  *     </p>
  * @public
  */
@@ -536,6 +536,18 @@ export interface CampaignConfig {
      * @public
      */
     enableMetadataWithRecommendations?: boolean;
+    /**
+     * <p>Whether the campaign automatically updates to use the latest solution version (trained model) of a solution. If you specify <code>True</code>,
+     *       you must specify the ARN of your <i>solution</i> for the <code>SolutionVersionArn</code> parameter. It must be in <code>SolutionArn/$LATEST</code> format.
+     *       The default is <code>False</code> and you must manually update the campaign to deploy the latest solution version.
+     *     </p>
+     *          <p>
+     *       For more information about automatic campaign updates, see
+     *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update">Enabling automatic campaign updates</a>.
+     *     </p>
+     * @public
+     */
+    syncWithLatestSolutionVersion?: boolean;
 }
 /**
  * @public
@@ -547,7 +559,18 @@ export interface CreateCampaignRequest {
      */
     name: string | undefined;
     /**
-     * <p>The Amazon Resource Name (ARN) of the solution version to deploy.</p>
+     * <p>The Amazon Resource Name (ARN) of the trained model to deploy with the campaign. To specify the latest solution version of your solution,
+     *       specify the ARN of your <i>solution</i> in <code>SolutionArn/$LATEST</code> format.
+     *       You must use this format if you set <code>syncWithLatestSolutionVersion</code> to <code>True</code> in the
+     *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html">CampaignConfig</a>.
+     *     </p>
+     *          <p>
+     *       To deploy a model that isn't the latest solution version of your solution, specify the ARN of the solution version.
+     *     </p>
+     *          <p>
+     *       For more information about automatic campaign updates, see
+     *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update">Enabling automatic campaign updates</a>.
+     *     </p>
      * @public
      */
     solutionVersionArn: string | undefined;
@@ -1026,7 +1049,8 @@ export interface CreateMetricAttributionResponse {
 export interface TrainingDataConfig {
     /**
      * <p>Specifies the columns to exclude from training. Each key is a dataset type, and each value is a list of columns.
-     *       Exclude columns to control what data Amazon Personalize uses to generate recommendations.
+     *       Exclude columns to control what data Amazon Personalize uses to generate recommendations.</p>
+     *          <p>
      *       For example, you might have a column that you want to use only to filter recommendations. You can
      *       exclude this column from training and Amazon Personalize considers it only when filtering.
      *     </p>
@@ -1165,6 +1189,21 @@ export interface AutoMLConfig {
      */
     recipeList?: string[];
 }
+/**
+ * <p>The automatic training configuration to use when <code>performAutoTraining</code> is true.</p>
+ * @public
+ */
+export interface AutoTrainingConfig {
+    /**
+     * <p>Specifies how often to automatically train new solution versions. Specify a rate expression in rate(<i>value</i>
+     *             <i>unit</i>) format.
+     *       For value, specify a number between 1 and 30. For unit, specify <code>day</code> or <code>days</code>.
+     *       For example, to automatically create a new solution version every 5 days, specify <code>rate(5 days)</code>. The default is every 7 days.</p>
+     *          <p>For more information about auto training, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html">Creating and configuring a solution</a>.</p>
+     * @public
+     */
+    schedulingExpression?: string;
+}
 /**
  * <p>Provides the name and range of a categorical hyperparameter.</p>
  * @public
@@ -1397,6 +1436,11 @@ export interface SolutionConfig {
      * @public
      */
     trainingDataConfig?: TrainingDataConfig;
+    /**
+     * <p>Specifies the automatic training configuration to use.</p>
+     * @public
+     */
+    autoTrainingConfig?: AutoTrainingConfig;
 }
 /**
  * @public
@@ -1430,11 +1474,28 @@ export interface CreateSolutionRequest {
      * @public
      */
     performAutoML?: boolean;
+    /**
+     * <p>Whether the solution uses automatic training to create new solution versions (trained models). The default is
+     *         <code>True</code> and the solution automatically creates new solution versions every 7 days. You can change the training
+     *       frequency by specifying a <code>schedulingExpression</code> in the <code>AutoTrainingConfig</code> as part of solution
+     *       configuration. For more information about automatic training,
+     *       see <a href="https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html">Configuring automatic training</a>.</p>
+     *          <p>
+     *       Automatic solution version creation starts one hour after the solution is ACTIVE. If you manually create a solution version within
+     *       the hour, the solution skips the first automatic training.
+     *     </p>
+     *          <p>
+     *       After training starts, you can
+     *       get the solution version's Amazon Resource Name (ARN) with the <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html">ListSolutionVersions</a> API operation.
+     *       To get its status, use the <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html">DescribeSolutionVersion</a>.
+     *     </p>
+     * @public
+     */
+    performAutoTraining?: boolean;
     /**
      * <p>The Amazon Resource Name (ARN) of the recipe to use for model training. This is required when
      *       <code>performAutoML</code> is false. For information about different Amazon Personalize recipes and their ARNs,
      *       see <a href="https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html">Choosing a recipe</a>.
-     *
      *     </p>
      * @public
      */
@@ -1485,6 +1546,7 @@ export interface CreateSolutionResponse {
  * @enum
  */
 export declare const TrainingMode: {
+    readonly AUTOTRAIN: "AUTOTRAIN";
     readonly FULL: "FULL";
     readonly UPDATE: "UPDATE";
 };
@@ -1953,7 +2015,7 @@ export interface Campaign {
      */
     campaignArn?: string;
     /**
-     * <p>The Amazon Resource Name (ARN) of a specific version of the solution.</p>
+     * <p>The Amazon Resource Name (ARN) of the solution version the campaign uses.</p>
      * @public
      */
     solutionVersionArn?: string;
@@ -3060,6 +3122,18 @@ export interface AutoMLResult {
      */
     bestRecipeArn?: string;
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const TrainingType: {
+    readonly AUTOMATIC: "AUTOMATIC";
+    readonly MANUAL: "MANUAL";
+};
+/**
+ * @public
+ */
+export type TrainingType = (typeof TrainingType)[keyof typeof TrainingType];
 /**
  * <p>Provides a summary of the properties of a solution version. For a complete listing, call the
  *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html">DescribeSolutionVersion</a> API.</p>
@@ -3082,6 +3156,21 @@ export interface SolutionVersionSummary {
      * @public
      */
     status?: string;
+    /**
+     * <p>The scope of training to be performed when creating the solution version. A
+     *       <code>FULL</code> training considers all of the data in your dataset group.
+     *       An <code>UPDATE</code> processes only the data that
+     *       has changed since the latest training. Only solution versions created with the User-Personalization
+     *       recipe can use <code>UPDATE</code>.
+     *     </p>
+     * @public
+     */
+    trainingMode?: TrainingMode;
+    /**
+     * <p>Whether the solution version was created automatically or manually.</p>
+     * @public
+     */
+    trainingType?: TrainingType;
     /**
      * <p>The date and time (in Unix time) that this version of a solution was created.</p>
      * @public
@@ -3099,8 +3188,15 @@ export interface SolutionVersionSummary {
     failureReason?: string;
 }
 /**
- * <p>An object that provides information about a solution. A solution is a trained model
- *       that can be deployed as a campaign.</p>
+ * <important>
+ *             <p>After you create a solution, you can’t change its configuration. By default, all new solutions use automatic training. With automatic training, you incur training costs while
+ *            your solution is active. You can't stop automatic training for a solution. To avoid unnecessary costs, make sure to delete the solution when you are finished. For information about training
+ *   costs, see <a href="https://aws.amazon.com/personalize/pricing/">Amazon Personalize pricing</a>.</p>
+ *          </important>
+ *          <p>An object that provides information about a solution. A solution includes the custom recipe, customized parameters, and
+ *       trained models (Solution Versions) that Amazon Personalize uses to generate recommendations. </p>
+ *          <p>After you create a solution, you can’t change its configuration. If you need to make changes, you can <a href="https://docs.aws.amazon.com/personalize/latest/dg/cloning-solution.html">clone the solution</a> with the Amazon Personalize console
+ *       or create a new one.</p>
  * @public
  */
 export interface Solution {
@@ -3132,6 +3228,13 @@ export interface Solution {
      * @public
      */
     performAutoML?: boolean;
+    /**
+     * <p>Specifies whether the solution automatically creates solution versions. The default is <code>True</code>
+     *       and the solution automatically creates new solution versions every 7 days.</p>
+     *          <p>For more information about auto training, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html">Creating and configuring a solution</a>.</p>
+     * @public
+     */
+    performAutoTraining?: boolean;
     /**
      * <p>The ARN of the recipe used to create the solution. This is required when
      *       <code>performAutoML</code> is false.</p>
@@ -3282,19 +3385,12 @@ export interface SolutionVersion {
      */
     trainingHours?: number;
     /**
-     * <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 href="https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html">User-Personalization</a>
-     *         recipe or the
-     *         <a href="https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-hrnn-coldstart.html">HRNN-Coldstart</a> recipe.</p>
-     *          </important>
+     * <p>The scope of training to be performed when creating the solution version. A
+     *       <code>FULL</code> training considers all of the data in your dataset group.
+     *       An <code>UPDATE</code> processes only the data that
+     *       has changed since the latest training. Only solution versions created with the User-Personalization
+     *       recipe can use <code>UPDATE</code>.
+     *     </p>
      * @public
      */
     trainingMode?: TrainingMode;
@@ -3349,6 +3445,11 @@ export interface SolutionVersion {
      * @public
      */
     lastUpdatedDateTime?: Date;
+    /**
+     * <p>Whether the solution version was created automatically or manually.</p>
+     * @public
+     */
+    trainingType?: TrainingType;
 }
 /**
  * @public
@@ -4664,7 +4765,7 @@ export interface ListSolutionVersionsResponse {
  */
 export interface ListTagsForResourceRequest {
     /**
-     * <p>The resource's Amazon Resource Name.</p>
+     * <p>The resource's Amazon Resource Name (ARN).</p>
      * @public
      */
     resourceArn: string | undefined;
@@ -4739,7 +4840,7 @@ export interface TagResourceRequest {
      */
     resourceArn: string | undefined;
     /**
-     * <p>Tags to apply to the resource. For more information see <a href="https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html">Tagging Amazon Personalize recources</a>.</p>
+     * <p>Tags to apply to the resource. For more information see <a href="https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html">Tagging Amazon Personalize resources</a>.</p>
      * @public
      */
     tags: Tag[] | undefined;
@@ -4771,7 +4872,7 @@ export interface UntagResourceRequest {
      */
     resourceArn: string | undefined;
     /**
-     * <p>Keys to remove from the resource's tags.</p>
+     * <p>The keys of the tags to be removed.</p>
      * @public
      */
     tagKeys: string[] | undefined;
@@ -4791,7 +4892,18 @@ export interface UpdateCampaignRequest {
      */
     campaignArn: string | undefined;
     /**
-     * <p>The ARN of a new solution version to deploy.</p>
+     * <p>The Amazon Resource Name (ARN) of a new model to deploy. To specify the latest solution version of your solution,
+     *       specify the ARN of your <i>solution</i> in <code>SolutionArn/$LATEST</code> format.
+     *       You must use this format if you set <code>syncWithLatestSolutionVersion</code> to <code>True</code> in the
+     *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html">CampaignConfig</a>.
+     *     </p>
+     *          <p>
+     *       To deploy a model that isn't the latest solution version of your solution, specify the ARN of the solution version.
+     *     </p>
+     *          <p>
+     *       For more information about automatic campaign updates, see
+     *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update">Enabling automatic campaign updates</a>.
+     *     </p>
      * @public
      */
     solutionVersionArn?: string;

package/dist-types/ts3.4/models/models_0.d.ts

@@ -147,6 +147,7 @@ export interface CreateBatchSegmentJobResponse {
 export interface CampaignConfig {
   itemExplorationConfig?: Record<string, string>;
   enableMetadataWithRecommendations?: boolean;
+  syncWithLatestSolutionVersion?: boolean;
 }
 export interface CreateCampaignRequest {
   name: string | undefined;
@@ -291,6 +292,9 @@ export interface AutoMLConfig {
   metricName?: string;
   recipeList?: string[];
 }
+export interface AutoTrainingConfig {
+  schedulingExpression?: string;
+}
 export interface CategoricalHyperParameterRange {
   name?: string;
   values?: string[];
@@ -344,11 +348,13 @@ export interface SolutionConfig {
   autoMLConfig?: AutoMLConfig;
   optimizationObjective?: OptimizationObjective;
   trainingDataConfig?: TrainingDataConfig;
+  autoTrainingConfig?: AutoTrainingConfig;
 }
 export interface CreateSolutionRequest {
   name: string | undefined;
   performHPO?: boolean;
   performAutoML?: boolean;
+  performAutoTraining?: boolean;
   recipeArn?: string;
   datasetGroupArn: string | undefined;
   eventType?: string;
@@ -359,6 +365,7 @@ export interface CreateSolutionResponse {
   solutionArn?: string;
 }
 export declare const TrainingMode: {
+  readonly AUTOTRAIN: "AUTOTRAIN";
   readonly FULL: "FULL";
   readonly UPDATE: "UPDATE";
 };
@@ -679,9 +686,16 @@ export interface DescribeSolutionRequest {
 export interface AutoMLResult {
   bestRecipeArn?: string;
 }
+export declare const TrainingType: {
+  readonly AUTOMATIC: "AUTOMATIC";
+  readonly MANUAL: "MANUAL";
+};
+export type TrainingType = (typeof TrainingType)[keyof typeof TrainingType];
 export interface SolutionVersionSummary {
   solutionVersionArn?: string;
   status?: string;
+  trainingMode?: TrainingMode;
+  trainingType?: TrainingType;
   creationDateTime?: Date;
   lastUpdatedDateTime?: Date;
   failureReason?: string;
@@ -691,6 +705,7 @@ export interface Solution {
   solutionArn?: string;
   performHPO?: boolean;
   performAutoML?: boolean;
+  performAutoTraining?: boolean;
   recipeArn?: string;
   datasetGroupArn?: string;
   eventType?: string;
@@ -727,6 +742,7 @@ export interface SolutionVersion {
   failureReason?: string;
   creationDateTime?: Date;
   lastUpdatedDateTime?: Date;
+  trainingType?: TrainingType;
 }
 export interface DescribeSolutionVersionResponse {
   solutionVersion?: SolutionVersion;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-personalize",
   "description": "AWS SDK for JavaScript Personalize Client for Node.js, Browser and React Native",
-  "version": "3.554.0",
+  "version": "3.559.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-personalize",
@@ -20,9 +20,9 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "3.0.0",
     "@aws-crypto/sha256-js": "3.0.0",
-    "@aws-sdk/client-sts": "3.554.0",
-    "@aws-sdk/core": "3.554.0",
-    "@aws-sdk/credential-provider-node": "3.554.0",
+    "@aws-sdk/client-sts": "3.556.0",
+    "@aws-sdk/core": "3.556.0",
+    "@aws-sdk/credential-provider-node": "3.556.0",
     "@aws-sdk/middleware-host-header": "3.535.0",
     "@aws-sdk/middleware-logger": "3.535.0",
     "@aws-sdk/middleware-recursion-detection": "3.535.0",