@aws-sdk/client-personalize 3.451.0 → 3.458.0

package/dist-cjs/models/models_0.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DescribeFilterResponseFilterSensitiveLog = exports.FilterFilterSensitiveLog = exports.CreateFilterRequestFilterSensitiveLog = exports.TooManyTagKeysException = exports.RecipeProvider = exports.InvalidNextTokenException = exports.TrainingMode = exports.ObjectiveSensitivity = exports.ImportMode = exports.Domain = exports.IngestionMode = exports.TooManyTagsException = exports.ResourceNotFoundException = exports.ResourceInUseException = exports.ResourceAlreadyExistsException = exports.LimitExceededException = exports.InvalidInputException = void 0;
+exports.DescribeFilterResponseFilterSensitiveLog = exports.FilterFilterSensitiveLog = exports.CreateFilterRequestFilterSensitiveLog = exports.TooManyTagKeysException = exports.RecipeProvider = exports.InvalidNextTokenException = exports.TrainingMode = exports.ObjectiveSensitivity = exports.ImportMode = exports.Domain = exports.IngestionMode = exports.TooManyTagsException = exports.ResourceNotFoundException = exports.ResourceInUseException = exports.ResourceAlreadyExistsException = exports.LimitExceededException = exports.InvalidInputException = exports.BatchInferenceJobMode = void 0;
 const smithy_client_1 = require("@smithy/smithy-client");
 const PersonalizeServiceException_1 = require("./PersonalizeServiceException");
+exports.BatchInferenceJobMode = {
+    BATCH_INFERENCE: "BATCH_INFERENCE",
+    THEME_GENERATION: "THEME_GENERATION",
+};
 class InvalidInputException extends PersonalizeServiceException_1.PersonalizeServiceException {
     constructor(opts) {
         super({

package/dist-cjs/protocols/Aws_json1_1.js

@@ -3215,6 +3215,7 @@ const de_BatchInferenceJob = (output, context) => {
     return (0, smithy_client_1.take)(output, {
         batchInferenceJobArn: smithy_client_1.expectString,
         batchInferenceJobConfig: smithy_client_1._json,
+        batchInferenceJobMode: smithy_client_1.expectString,
         creationDateTime: (_) => (0, smithy_client_1.expectNonNull)((0, smithy_client_1.parseEpochTimestamp)((0, smithy_client_1.expectNumber)(_))),
         failureReason: smithy_client_1.expectString,
         filterArn: smithy_client_1.expectString,
@@ -3226,6 +3227,7 @@ const de_BatchInferenceJob = (output, context) => {
         roleArn: smithy_client_1.expectString,
         solutionVersionArn: smithy_client_1.expectString,
         status: smithy_client_1.expectString,
+        themeGenerationConfig: smithy_client_1._json,
     });
 };
 const de_BatchInferenceJobs = (output, context) => {
@@ -3239,6 +3241,7 @@ const de_BatchInferenceJobs = (output, context) => {
 const de_BatchInferenceJobSummary = (output, context) => {
     return (0, smithy_client_1.take)(output, {
         batchInferenceJobArn: smithy_client_1.expectString,
+        batchInferenceJobMode: smithy_client_1.expectString,
         creationDateTime: (_) => (0, smithy_client_1.expectNonNull)((0, smithy_client_1.parseEpochTimestamp)((0, smithy_client_1.expectNumber)(_))),
         failureReason: smithy_client_1.expectString,
         jobName: smithy_client_1.expectString,
@@ -3351,6 +3354,7 @@ const de_Dataset = (output, context) => {
         name: smithy_client_1.expectString,
         schemaArn: smithy_client_1.expectString,
         status: smithy_client_1.expectString,
+        trackingId: smithy_client_1.expectString,
     });
 };
 const de_DatasetExportJob = (output, context) => {

package/dist-es/models/models_0.js

@@ -1,5 +1,9 @@
 import { SENSITIVE_STRING } from "@smithy/smithy-client";
 import { PersonalizeServiceException as __BaseException } from "./PersonalizeServiceException";
+export const BatchInferenceJobMode = {
+    BATCH_INFERENCE: "BATCH_INFERENCE",
+    THEME_GENERATION: "THEME_GENERATION",
+};
 export class InvalidInputException extends __BaseException {
     constructor(opts) {
         super({

package/dist-es/protocols/Aws_json1_1.js

@@ -3076,6 +3076,7 @@ const de_BatchInferenceJob = (output, context) => {
     return take(output, {
         batchInferenceJobArn: __expectString,
         batchInferenceJobConfig: _json,
+        batchInferenceJobMode: __expectString,
         creationDateTime: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
         failureReason: __expectString,
         filterArn: __expectString,
@@ -3087,6 +3088,7 @@ const de_BatchInferenceJob = (output, context) => {
         roleArn: __expectString,
         solutionVersionArn: __expectString,
         status: __expectString,
+        themeGenerationConfig: _json,
     });
 };
 const de_BatchInferenceJobs = (output, context) => {
@@ -3100,6 +3102,7 @@ const de_BatchInferenceJobs = (output, context) => {
 const de_BatchInferenceJobSummary = (output, context) => {
     return take(output, {
         batchInferenceJobArn: __expectString,
+        batchInferenceJobMode: __expectString,
         creationDateTime: (_) => __expectNonNull(__parseEpochTimestamp(__expectNumber(_))),
         failureReason: __expectString,
         jobName: __expectString,
@@ -3212,6 +3215,7 @@ const de_Dataset = (output, context) => {
         name: __expectString,
         schemaArn: __expectString,
         status: __expectString,
+        trackingId: __expectString,
     });
 };
 const de_DatasetExportJob = (output, context) => {

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

@@ -23,10 +23,24 @@ export interface CreateBatchInferenceJobCommandOutput extends CreateBatchInferen
 }
 /**
  * @public
- * <p>Creates a batch inference job. The operation can handle up to 50 million records and the
- *       input file must be in JSON format. For more information, see
- *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/creating-batch-inference-job.html">Creating a batch inference job</a>.
+ * <p>Generates batch recommendations based on a list of items or users stored in Amazon S3
+ *       and exports the recommendations to an Amazon S3 bucket.</p>
+ *          <p>To generate batch recommendations, specify the ARN of a solution version and an Amazon S3 URI for the input and output data.
+ *       For user personalization, popular items, and personalized ranking solutions, the batch inference job generates a list of
+ *       recommended items for each user ID in the input file. For related items solutions, the job generates a list of recommended
+ *       items for each item ID in the input file.</p>
+ *          <p>For more information, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/getting-batch-recommendations.html">Creating a batch inference job
+ *     </a>.</p>
+ *          <p>
+ *       If you use the Similar-Items recipe, Amazon Personalize can add descriptive themes to batch recommendations.
+ *       To generate themes, set the job's mode to
+ *       <code>THEME_GENERATION</code> and specify the name of the field that contains item names in the
+ *       input data.</p>
+ *          <p>
+ *       For more information about generating themes, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/themed-batch-recommendations.html">Batch recommendations with themes from Content Generator
+ *       </a>.
  *     </p>
+ *          <p>You can't get batch recommendations with the Trending-Now or Next-Best-Action recipes.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -62,6 +76,12 @@ export interface CreateBatchInferenceJobCommandOutput extends CreateBatchInferen
  *       tagValue: "STRING_VALUE", // required
  *     },
  *   ],
+ *   batchInferenceJobMode: "BATCH_INFERENCE" || "THEME_GENERATION",
+ *   themeGenerationConfig: { // ThemeGenerationConfig
+ *     fieldsForThemeGeneration: { // FieldsForThemeGeneration
+ *       itemName: "STRING_VALUE", // required
+ *     },
+ *   },
  * };
  * const command = new CreateBatchInferenceJobCommand(input);
  * const response = await client.send(command);

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

@@ -37,22 +37,22 @@ export interface CreateCampaignCommandOutput extends CreateCampaignResponse, __M
  *         as necessary.</p>
  *          </important>
  *          <p>A transaction is a single <code>GetRecommendations</code> or
- *        <code>GetPersonalizedRanking</code> call. Transactions per second (TPS) is the throughput
- *        and unit of billing for Amazon Personalize. The minimum provisioned TPS
- *        (<code>minProvisionedTPS</code>) specifies the baseline throughput provisioned by
- *        Amazon Personalize, and thus, the minimum billing charge.
+ *       <code>GetPersonalizedRanking</code> call. Transactions per second (TPS) is the throughput
+ *       and unit of billing for Amazon Personalize. The minimum provisioned TPS
+ *       (<code>minProvisionedTPS</code>) specifies the baseline throughput provisioned by
+ *       Amazon Personalize, and thus, the minimum billing charge.
  *     </p>
  *          <p>
- *        If your TPS increases beyond
- *        <code>minProvisionedTPS</code>, Amazon Personalize auto-scales the provisioned capacity up and down,
- *        but never below <code>minProvisionedTPS</code>.
- *        There's a short time delay while the capacity is increased that might cause loss of
- *        transactions.</p>
+ *       If your TPS increases beyond
+ *       <code>minProvisionedTPS</code>, Amazon Personalize auto-scales the provisioned capacity up and down,
+ *       but never below <code>minProvisionedTPS</code>.
+ *       There's a short time delay while the capacity is increased that might cause loss of
+ *       transactions.</p>
  *          <p>The actual TPS used is calculated as the average requests/second within a 5-minute window.
  *       You pay for maximum of either the minimum provisioned TPS or the actual TPS.
  *       We recommend starting with a low <code>minProvisionedTPS</code>, track
- *        your usage using Amazon CloudWatch metrics, and then increase the <code>minProvisionedTPS</code>
- *        as necessary.</p>
+ *       your usage using Amazon CloudWatch metrics, and then increase the <code>minProvisionedTPS</code>
+ *       as necessary.</p>
  *          <p>
  *             <b>Status</b>
  *          </p>
@@ -109,6 +109,7 @@ export interface CreateCampaignCommandOutput extends CreateCampaignResponse, __M
  *     itemExplorationConfig: { // HyperParameters
  *       "<keys>": "STRING_VALUE",
  *     },
+ *     enableMetadataWithRecommendations: true || false,
  *   },
  *   tags: [ // Tags
  *     { // Tag

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

@@ -26,10 +26,10 @@ export interface CreateDatasetCommandOutput extends CreateDatasetResponse, __Met
  * <p>Creates an empty dataset and adds it to the specified dataset group.
  *       Use <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html">CreateDatasetImportJob</a> to import your training data to a
  *       dataset.</p>
- *          <p>There are three types of datasets:</p>
+ *          <p>There are 5 types of datasets:</p>
  *          <ul>
  *             <li>
- *                <p>Interactions</p>
+ *                <p>Item interactions</p>
  *             </li>
  *             <li>
  *                <p>Items</p>
@@ -37,9 +37,15 @@ export interface CreateDatasetCommandOutput extends CreateDatasetResponse, __Met
  *             <li>
  *                <p>Users</p>
  *             </li>
+ *             <li>
+ *                <p>Action interactions</p>
+ *             </li>
+ *             <li>
+ *                <p>Actions</p>
+ *             </li>
  *          </ul>
  *          <p>Each dataset type has an associated schema with required field types.
- *       Only the <code>Interactions</code> dataset is required in order to train a
+ *       Only the <code>Item interactions</code> dataset is required in order to train a
  *       model (also referred to as creating a solution).</p>
  *          <p>A dataset can be in one of the following states:</p>
  *          <ul>

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

@@ -28,7 +28,7 @@ export interface CreateDatasetGroupCommandOutput extends CreateDatasetGroupRespo
  *       for each type of dataset:</p>
  *          <ul>
  *             <li>
- *                <p>Interactions</p>
+ *                <p>Item interactions</p>
  *             </li>
  *             <li>
  *                <p>Items</p>
@@ -36,6 +36,12 @@ export interface CreateDatasetGroupCommandOutput extends CreateDatasetGroupRespo
  *             <li>
  *                <p>Users</p>
  *             </li>
+ *             <li>
+ *                <p>Actions</p>
+ *             </li>
+ *             <li>
+ *                <p>Action interactions</p>
+ *             </li>
  *          </ul>
  *          <p> A dataset group can be a Domain dataset group, where you specify a
  *       domain and use pre-configured resources like recommenders, or a

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

@@ -30,6 +30,9 @@ export interface CreateDatasetImportJobCommandOutput extends CreateDatasetImport
  *       processes it internally. For information on granting access to your Amazon S3
  *       bucket, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html">Giving
  *         Amazon Personalize Access to Amazon S3 Resources</a>. </p>
+ *          <p>If you already created a recommender or deployed a custom solution version with a campaign, how new bulk records
+ *       influence recommendations depends on the domain use case or recipe that you use. For more information, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/how-new-data-influences-recommendations.html">How new data influences
+ *         real-time recommendations</a>.</p>
  *          <important>
  *             <p>By default, a dataset import job replaces any existing data in the
  *         dataset that you imported in bulk. To add new records without replacing

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

@@ -33,7 +33,7 @@ export interface CreateEventTrackerCommandOutput extends CreateEventTrackerRespo
  *          </note>
  *          <p>When you create an event tracker, the response includes a tracking ID, which you pass as a parameter when you use the
  *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html">PutEvents</a> operation.
- *       Amazon Personalize then appends the event data to the Interactions dataset of the dataset group you specify
+ *       Amazon Personalize then appends the event data to the Item interactions dataset of the dataset group you specify
  *       in your event tracker.
  *     </p>
  *          <p>The event tracker can be in one of the following states:</p>

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

@@ -123,6 +123,7 @@ export interface CreateRecommenderCommandOutput extends CreateRecommenderRespons
  *         ],
  *       },
  *     },
+ *     enableMetadataWithRecommendations: true || false,
  *   },
  *   tags: [ // Tags
  *     { // Tag

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

@@ -23,8 +23,8 @@ export interface DeleteEventTrackerCommandOutput extends __MetadataBearer {
 }
 /**
  * @public
- * <p>Deletes the event tracker. Does not delete the event-interactions dataset from
- *         the associated dataset group. For more
+ * <p>Deletes the event tracker. Does not delete the dataset from
+ *         the dataset group. For more
  *         information on event trackers, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html">CreateEventTracker</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

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

@@ -63,6 +63,12 @@ export interface DescribeBatchInferenceJobCommandOutput extends DescribeBatchInf
  * //       },
  * //     },
  * //     roleArn: "STRING_VALUE",
+ * //     batchInferenceJobMode: "BATCH_INFERENCE" || "THEME_GENERATION",
+ * //     themeGenerationConfig: { // ThemeGenerationConfig
+ * //       fieldsForThemeGeneration: { // FieldsForThemeGeneration
+ * //         itemName: "STRING_VALUE", // required
+ * //       },
+ * //     },
  * //     status: "STRING_VALUE",
  * //     creationDateTime: new Date("TIMESTAMP"),
  * //     lastUpdatedDateTime: new Date("TIMESTAMP"),

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

@@ -57,6 +57,7 @@ export interface DescribeCampaignCommandOutput extends DescribeCampaignResponse,
  * //       itemExplorationConfig: { // HyperParameters
  * //         "<keys>": "STRING_VALUE",
  * //       },
+ * //       enableMetadataWithRecommendations: true || false,
  * //     },
  * //     status: "STRING_VALUE",
  * //     failureReason: "STRING_VALUE",
@@ -69,6 +70,7 @@ export interface DescribeCampaignCommandOutput extends DescribeCampaignResponse,
  * //         itemExplorationConfig: {
  * //           "<keys>": "STRING_VALUE",
  * //         },
+ * //         enableMetadataWithRecommendations: true || false,
  * //       },
  * //       status: "STRING_VALUE",
  * //       failureReason: "STRING_VALUE",

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

@@ -53,6 +53,7 @@ export interface DescribeDatasetCommandOutput extends DescribeDatasetResponse, _
  * //       creationDateTime: new Date("TIMESTAMP"),
  * //       lastUpdatedDateTime: new Date("TIMESTAMP"),
  * //     },
+ * //     trackingId: "STRING_VALUE",
  * //   },
  * // };
  *

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

@@ -70,6 +70,7 @@ export interface DescribeRecommenderCommandOutput extends DescribeRecommenderRes
  * //           ],
  * //         },
  * //       },
+ * //       enableMetadataWithRecommendations: true || false,
  * //     },
  * //     creationDateTime: new Date("TIMESTAMP"),
  * //     lastUpdatedDateTime: new Date("TIMESTAMP"),
@@ -88,6 +89,7 @@ export interface DescribeRecommenderCommandOutput extends DescribeRecommenderRes
  * //             ],
  * //           },
  * //         },
+ * //         enableMetadataWithRecommendations: true || false,
  * //       },
  * //       creationDateTime: new Date("TIMESTAMP"),
  * //       lastUpdatedDateTime: new Date("TIMESTAMP"),

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

@@ -48,6 +48,7 @@ export interface ListBatchInferenceJobsCommandOutput extends ListBatchInferenceJ
  * //       lastUpdatedDateTime: new Date("TIMESTAMP"),
  * //       failureReason: "STRING_VALUE",
  * //       solutionVersionArn: "STRING_VALUE",
+ * //       batchInferenceJobMode: "BATCH_INFERENCE" || "THEME_GENERATION",
  * //     },
  * //   ],
  * //   nextToken: "STRING_VALUE",

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

@@ -59,6 +59,7 @@ export interface ListRecommendersCommandOutput extends ListRecommendersResponse,
  * //             ],
  * //           },
  * //         },
+ * //         enableMetadataWithRecommendations: true || false,
  * //       },
  * //       status: "STRING_VALUE",
  * //       creationDateTime: new Date("TIMESTAMP"),

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

@@ -23,16 +23,19 @@ export interface UpdateCampaignCommandOutput extends UpdateCampaignResponse, __M
 }
 /**
  * @public
- * <p>Updates a campaign by either deploying a new solution or changing the value of the
- *       campaign's <code>minProvisionedTPS</code> parameter.</p>
+ * <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>
  *          <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>
  *             <p>You can still get recommendations from a campaign while an update is in progress.
- *       The campaign will use the previous solution version and campaign configuration to generate recommendations until the latest campaign update status is <code>Active</code>.
- *     </p>
+ *         The campaign will use the previous solution version and campaign configuration to generate recommendations until the latest campaign update status is <code>Active</code>.
+ *       </p>
  *          </note>
- *          <p>For more information on campaigns, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html">CreateCampaign</a>.</p>
+ *          <p>For more information about updating a campaign, including code samples, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/update-campaigns.html">Updating a campaign</a>.
+ *       For more information about campaigns, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html">Creating a campaign</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -47,6 +50,7 @@ export interface UpdateCampaignCommandOutput extends UpdateCampaignResponse, __M
  *     itemExplorationConfig: { // HyperParameters
  *       "<keys>": "STRING_VALUE",
  *     },
+ *     enableMetadataWithRecommendations: true || false,
  *   },
  * };
  * const command = new UpdateCampaignCommand(input);

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

@@ -51,6 +51,7 @@ export interface UpdateRecommenderCommandOutput extends UpdateRecommenderRespons
  *         ],
  *       },
  *     },
+ *     enableMetadataWithRecommendations: true || false,
  *   },
  * };
  * const command = new UpdateRecommenderCommand(input);

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

@@ -189,6 +189,18 @@ export interface BatchInferenceJobConfig {
      */
     itemExplorationConfig?: Record<string, string>;
 }
+/**
+ * @public
+ * @enum
+ */
+export declare const BatchInferenceJobMode: {
+    readonly BATCH_INFERENCE: "BATCH_INFERENCE";
+    readonly THEME_GENERATION: "THEME_GENERATION";
+};
+/**
+ * @public
+ */
+export type BatchInferenceJobMode = (typeof BatchInferenceJobMode)[keyof typeof BatchInferenceJobMode];
 /**
  * @public
  * <p>The configuration details of an Amazon S3 input or output bucket.</p>
@@ -247,6 +259,28 @@ export interface Tag {
      */
     tagValue: string | undefined;
 }
+/**
+ * @public
+ * <p>A string to string map of the configuration details for theme generation.</p>
+ */
+export interface FieldsForThemeGeneration {
+    /**
+     * @public
+     * <p>The name of the Items dataset column that stores the name of each item in the dataset.</p>
+     */
+    itemName: string | undefined;
+}
+/**
+ * @public
+ * <p>The configuration details for generating themes with a batch inference job.</p>
+ */
+export interface ThemeGenerationConfig {
+    /**
+     * @public
+     * <p>Fields used to generate descriptive themes for a batch inference job.</p>
+     */
+    fieldsForThemeGeneration: FieldsForThemeGeneration | undefined;
+}
 /**
  * @public
  */
@@ -301,6 +335,21 @@ export interface CreateBatchInferenceJobRequest {
      * <p>A list of <a href="https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html">tags</a> to apply to the batch inference job.</p>
      */
     tags?: Tag[];
+    /**
+     * @public
+     * <p>The mode of the batch inference job. To generate descriptive themes for groups of similar items, set the
+     *       job mode to <code>THEME_GENERATION</code>. If you don't want to generate themes, use the default <code>BATCH_INFERENCE</code>.</p>
+     *          <p>
+     *       When you get batch recommendations with themes, you will incur additional costs. For more information, see <a href="https://aws.amazon.com/personalize/pricing/">Amazon Personalize pricing</a>.
+     *     </p>
+     */
+    batchInferenceJobMode?: BatchInferenceJobMode;
+    /**
+     * @public
+     * <p>For theme generation jobs, specify the name of the column in your Items
+     *       dataset that contains each item's name.</p>
+     */
+    themeGenerationConfig?: ThemeGenerationConfig;
 }
 /**
  * @public
@@ -477,6 +526,15 @@ export interface CampaignConfig {
      *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html">User-Personalization</a> recipe.</p>
      */
     itemExplorationConfig?: Record<string, string>;
+    /**
+     * @public
+     * <p>Whether metadata with recommendations is enabled for the campaign.
+     *       If enabled, you can specify the columns from your Items dataset in your request for recommendations. Amazon Personalize returns this data for each item in the recommendation response. </p>
+     *          <p>
+     *       If you enable metadata in recommendations, you will incur additional costs. For more information, see <a href="https://aws.amazon.com/personalize/pricing/">Amazon Personalize pricing</a>.
+     *     </p>
+     */
+    enableMetadataWithRecommendations?: boolean;
 }
 /**
  * @public
@@ -555,6 +613,12 @@ export interface CreateDatasetRequest {
      *             <li>
      *                <p>Users</p>
      *             </li>
+     *             <li>
+     *                <p>Actions</p>
+     *             </li>
+     *             <li>
+     *                <p>Action_Interactions</p>
+     *             </li>
      *          </ul>
      */
     datasetType: string | undefined;
@@ -997,6 +1061,15 @@ export interface RecommenderConfig {
      *     </p>
      */
     trainingDataConfig?: TrainingDataConfig;
+    /**
+     * @public
+     * <p>Whether metadata with recommendations is enabled for the recommender.
+     *       If enabled, you can specify the columns from your Items dataset in your request for recommendations. Amazon Personalize returns this data for each item in the recommendation response. </p>
+     *          <p>
+     *       If you enable metadata in recommendations, you will incur additional costs. For more information, see <a href="https://aws.amazon.com/personalize/pricing/">Amazon Personalize pricing</a>.
+     *     </p>
+     */
+    enableMetadataWithRecommendations?: boolean;
 }
 /**
  * @public
@@ -1295,7 +1368,7 @@ export interface SolutionConfig {
     hpoConfig?: HPOConfig;
     /**
      * @public
-     * <p>Lists the hyperparameter names and ranges.</p>
+     * <p>Lists the algorithm hyperparameters and their values.</p>
      */
     algorithmHyperParameters?: Record<string, string>;
     /**
@@ -1432,19 +1505,25 @@ export interface CreateSolutionVersionRequest {
     solutionArn: string | undefined;
     /**
      * @public
-     * <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
+     * <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
+     *         recipe or the legacy
      *         <a href="https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-hrnn-coldstart.html">HRNN-Coldstart</a> recipe.</p>
-     *          </important>
      */
     trainingMode?: TrainingMode;
     /**
@@ -1641,6 +1720,16 @@ export interface BatchInferenceJob {
      * <p>The ARN of the Amazon Identity and Access Management (IAM) role that requested the batch inference job.</p>
      */
     roleArn?: string;
+    /**
+     * @public
+     * <p>The job's mode.</p>
+     */
+    batchInferenceJobMode?: BatchInferenceJobMode;
+    /**
+     * @public
+     * <p>The job's theme generation settings.</p>
+     */
+    themeGenerationConfig?: ThemeGenerationConfig;
     /**
      * @public
      * <p>The status of the batch inference job. The status is one of the following values:</p>
@@ -1997,6 +2086,12 @@ export interface Dataset {
      *             <li>
      *                <p>Users</p>
      *             </li>
+     *             <li>
+     *                <p>Actions</p>
+     *             </li>
+     *             <li>
+     *                <p>Action_Interactions</p>
+     *             </li>
      *          </ul>
      */
     datasetType?: string;
@@ -2035,6 +2130,12 @@ export interface Dataset {
      * <p>Describes the latest update to the dataset.</p>
      */
     latestDatasetUpdate?: DatasetUpdateSummary;
+    /**
+     * @public
+     * <p>The ID of the event tracker for an Action interactions dataset.
+     *       You specify the tracker's ID in the <code>PutActionInteractions</code> API operation. Amazon Personalize uses it to direct new data to the Action interactions dataset in your dataset group.</p>
+     */
+    trackingId?: string;
 }
 /**
  * @public
@@ -2177,8 +2278,8 @@ export interface DescribeDatasetGroupRequest {
 }
 /**
  * @public
- * <p>A dataset group is a collection of related datasets (Interactions,
- *       User, and Item). You create a dataset group by calling <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html">CreateDatasetGroup</a>. You then create a dataset and add it to a
+ * <p>A dataset group is a collection of related datasets (Item interactions,
+ *       Users, Items, Actions, Action interactions). You create a dataset group by calling <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html">CreateDatasetGroup</a>. You then create a dataset and add it to a
  *       dataset group by calling <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>. The dataset group is used to create and train a
  *       solution by calling <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html">CreateSolution</a>. A dataset group can contain only one of each
  *       type of dataset.</p>
@@ -2213,8 +2314,9 @@ export interface DatasetGroup {
     status?: string;
     /**
      * @public
-     * <p>The ARN of the IAM role that has permissions to create the dataset
-     *       group.</p>
+     * <p>The ARN of the Identity and Access Management (IAM) role that has permissions to access
+     *       the Key Management Service (KMS) key. Supplying an IAM role is only valid when also
+     *       specifying a KMS key.</p>
      */
     roleArn?: string;
     /**
@@ -3372,6 +3474,11 @@ export interface BatchInferenceJobSummary {
      * <p>The ARN of the solution version used by the batch inference job.</p>
      */
     solutionVersionArn?: string;
+    /**
+     * @public
+     * <p>The job's mode.</p>
+     */
+    batchInferenceJobMode?: BatchInferenceJobMode;
 }
 /**
  * @public
@@ -3490,7 +3597,7 @@ export interface ListCampaignsRequest {
     /**
      * @public
      * <p>The Amazon Resource Name (ARN) of the solution to list the campaigns for. When
-     *         a solution is not specified, all the campaigns associated with the account are listed.</p>
+     *       a solution is not specified, all the campaigns associated with the account are listed.</p>
      */
     solutionArn?: string;
     /**
@@ -3835,7 +3942,7 @@ export interface ListDatasetsRequest {
     /**
      * @public
      * <p>A token returned from the previous call to
-     *         <code>ListDatasetImportJobs</code> for getting the next set of dataset
+     *         <code>ListDatasets</code> for getting the next set of dataset
      *       import jobs (if they exist).</p>
      */
     nextToken?: string;