@aws-sdk/client-personalize 3.137.0 → 3.145.0

package/dist-types/Personalize.d.ts

@@ -158,8 +158,9 @@ export declare class Personalize extends PersonalizeClient {
     createCampaign(args: CreateCampaignCommandInput, cb: (err: any, data?: CreateCampaignCommandOutput) => void): void;
     createCampaign(args: CreateCampaignCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateCampaignCommandOutput) => void): void;
     /**
-     * <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>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>
      *          <ul>
@@ -173,13 +174,14 @@ export declare class Personalize extends PersonalizeClient {
      *                <p>Users</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 model (also referred to as
-     *       creating a solution).</p>
+     *          <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
+     *       model (also referred to as creating a solution).</p>
      *          <p>A dataset can be in one of the following states:</p>
      *          <ul>
      *             <li>
-     *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED</p>
+     *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE
+     *           FAILED</p>
      *             </li>
      *             <li>
      *                <p>DELETE PENDING > DELETE IN_PROGRESS</p>
@@ -216,36 +218,33 @@ export declare class Personalize extends PersonalizeClient {
     createDataset(args: CreateDatasetCommandInput, cb: (err: any, data?: CreateDatasetCommandOutput) => void): void;
     createDataset(args: CreateDatasetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateDatasetCommandOutput) => void): void;
     /**
-     * <p>
-     *       Creates a job that exports data from your dataset to an Amazon S3 bucket.
+     * <p> Creates a job that exports data from your dataset to an Amazon S3 bucket.
      *       To allow Amazon Personalize to export the training data, you must specify an
-     *       service-linked IAM role that gives Amazon Personalize <code>PutObject</code> permissions for your Amazon S3 bucket.
-     *       For information, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/export-data.html">Exporting a dataset</a>
-     *       in the Amazon Personalize developer guide.
-     *     </p>
+     *       service-linked IAM role that gives Amazon Personalize <code>PutObject</code>
+     *       permissions for your Amazon S3 bucket. For information, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/export-data.html">Exporting a dataset</a> in the Amazon Personalize developer guide. </p>
      *          <p>
      *             <b>Status</b>
      *          </p>
      *          <p>A dataset export job can be in one of the following states:</p>
      *          <ul>
      *             <li>
-     *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED</p>
+     *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE
+     *           FAILED</p>
      *             </li>
      *          </ul>
-     *          <p>
-     *       To get the status of the export job, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html">DescribeDatasetExportJob</a>,
-     *       and specify the Amazon Resource Name (ARN) of the dataset export job. The dataset export is
-     *       complete when the status shows as ACTIVE. If the status shows as CREATE FAILED, the response
-     *       includes a <code>failureReason</code> key, which describes why the job failed.
-     *     </p>
+     *          <p> To get the status of the export job, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html">DescribeDatasetExportJob</a>, and specify the Amazon Resource Name
+     *       (ARN) of the dataset export job. The dataset export is complete when the
+     *       status shows as ACTIVE. If the status shows as CREATE FAILED, the response
+     *       includes a <code>failureReason</code> key, which describes why the job
+     *       failed. </p>
      */
     createDatasetExportJob(args: CreateDatasetExportJobCommandInput, options?: __HttpHandlerOptions): Promise<CreateDatasetExportJobCommandOutput>;
     createDatasetExportJob(args: CreateDatasetExportJobCommandInput, cb: (err: any, data?: CreateDatasetExportJobCommandOutput) => void): void;
     createDatasetExportJob(args: CreateDatasetExportJobCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateDatasetExportJobCommandOutput) => void): void;
     /**
-     * <p>Creates an empty dataset group. A dataset group is a container for Amazon Personalize resources.
-     *       A dataset group can contain at most three datasets, one for each type of
-     *       dataset:</p>
+     * <p>Creates an empty dataset group. A dataset group is a container for
+     *       Amazon Personalize resources. A dataset group can contain at most three datasets, one
+     *       for each type of dataset:</p>
      *          <ul>
      *             <li>
      *                <p>Interactions</p>
@@ -257,31 +256,33 @@ export declare class Personalize extends PersonalizeClient {
      *                <p>Users</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 Custom dataset group, where you use custom resources, such as a solution with a solution version, that
-     *       you deploy with a campaign.  If you start with a Domain dataset group, you can still add custom resources such as
-     *       solutions and solution versions trained with recipes for custom use cases and deployed with campaigns.
-     *     </p>
+     *          <p> A dataset group can be a Domain dataset group, where you specify a
+     *       domain and use pre-configured resources like recommenders, or a
+     *       Custom dataset group, where you use custom resources, such as a solution
+     *       with a solution version, that you deploy with a campaign. If you start
+     *       with a Domain dataset group, you can still add custom resources such as
+     *       solutions and solution versions trained with recipes for custom use cases
+     *       and deployed with campaigns. </p>
      *          <p>A dataset group can be in one of the following states:</p>
      *          <ul>
      *             <li>
-     *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED</p>
+     *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE
+     *           FAILED</p>
      *             </li>
      *             <li>
      *                <p>DELETE PENDING</p>
      *             </li>
      *          </ul>
-     *          <p>To get the status of the dataset group, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html">DescribeDatasetGroup</a>. If
-     *       the status shows as CREATE FAILED, the response includes a <code>failureReason</code> key,
-     *       which describes why the creation failed.</p>
+     *          <p>To get the status of the dataset group, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html">DescribeDatasetGroup</a>. If the status shows as CREATE FAILED, the
+     *       response includes a <code>failureReason</code> key, which describes why
+     *       the creation failed.</p>
      *          <note>
-     *             <p>You must wait until the <code>status</code> of the dataset group is <code>ACTIVE</code>
-     *         before adding a dataset to the group.</p>
+     *             <p>You must wait until the <code>status</code> of the dataset group is
+     *           <code>ACTIVE</code> before adding a dataset to the group.</p>
      *          </note>
-     *          <p>You can specify an Key Management Service (KMS) key to encrypt the datasets in the group. If you
-     *       specify a KMS key, you must also include an Identity and Access Management (IAM) role that has permission to
-     *       access the key.</p>
+     *          <p>You can specify an Key Management Service (KMS) key to encrypt the datasets in
+     *       the group. If you specify a KMS key, you must also include an Identity and Access Management
+     *       (IAM) role that has permission to access the key.</p>
      *          <p class="title">
      *             <b>APIs that require a dataset group ARN in the request</b>
      *          </p>
@@ -327,14 +328,18 @@ export declare class Personalize extends PersonalizeClient {
     createDatasetGroup(args: CreateDatasetGroupCommandInput, cb: (err: any, data?: CreateDatasetGroupCommandOutput) => void): void;
     createDatasetGroup(args: CreateDatasetGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateDatasetGroupCommandOutput) => void): void;
     /**
-     * <p>Creates a job that imports training data from your data source (an Amazon S3 bucket) to an
-     *       Amazon Personalize dataset. To allow Amazon Personalize to import the training data, you must specify an
-     *       IAM service role that has permission to read from the data source, as Amazon Personalize makes a
-     *       copy of your data and 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>Creates a job that imports training data from your data source (an
+     *       Amazon S3 bucket) to an Amazon Personalize dataset. To allow Amazon Personalize to import the
+     *       training data, you must specify an IAM service role that has permission to
+     *       read from the data source, as Amazon Personalize makes a copy of your data and
+     *       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>
      *          <important>
-     *             <p>The dataset import job replaces any existing data in the dataset that you imported in bulk.</p>
+     *             <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
+     *         existing data, specify INCREMENTAL for the import mode in the
+     *         CreateDatasetImportJob operation.</p>
      *          </important>
      *          <p>
      *             <b>Status</b>
@@ -342,16 +347,18 @@ export declare class Personalize extends PersonalizeClient {
      *          <p>A dataset import job can be in one of the following states:</p>
      *          <ul>
      *             <li>
-     *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED</p>
+     *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE
+     *           FAILED</p>
      *             </li>
      *          </ul>
-     *          <p>To get the status of the import job, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html">DescribeDatasetImportJob</a>,
-     *       providing the Amazon Resource Name (ARN) of the dataset import job. The dataset import is
-     *       complete when the status shows as ACTIVE. If the status shows as CREATE FAILED, the response
-     *       includes a <code>failureReason</code> key, which describes why the job failed.</p>
+     *          <p>To get the status of the import job, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html">DescribeDatasetImportJob</a>, providing the Amazon Resource Name
+     *       (ARN) of the dataset import job. The dataset import is complete when the
+     *       status shows as ACTIVE. If the status shows as CREATE FAILED, the response
+     *       includes a <code>failureReason</code> key, which describes why the job
+     *       failed.</p>
      *          <note>
-     *             <p>Importing takes time. You must wait until the status shows as ACTIVE before training a
-     *         model using the dataset.</p>
+     *             <p>Importing takes time. You must wait until the status shows as ACTIVE
+     *         before training a model using the dataset.</p>
      *          </note>
      *
      *          <p class="title">
@@ -706,15 +713,16 @@ export declare class Personalize extends PersonalizeClient {
     deleteCampaign(args: DeleteCampaignCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteCampaignCommandOutput) => void): void;
     /**
      * <p>Deletes a dataset. You can't delete a dataset if an associated
-     *         <code>DatasetImportJob</code> or <code>SolutionVersion</code> is in the CREATE PENDING or IN
-     *       PROGRESS state. For more information on datasets, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
+     *         <code>DatasetImportJob</code> or <code>SolutionVersion</code> is in the
+     *       CREATE PENDING or IN PROGRESS state. For more information on datasets, see
+     *         <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
      */
     deleteDataset(args: DeleteDatasetCommandInput, options?: __HttpHandlerOptions): Promise<DeleteDatasetCommandOutput>;
     deleteDataset(args: DeleteDatasetCommandInput, cb: (err: any, data?: DeleteDatasetCommandOutput) => void): void;
     deleteDataset(args: DeleteDatasetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteDatasetCommandOutput) => void): void;
     /**
-     * <p>Deletes a dataset group. Before you delete a dataset group, you must delete the
-     *       following:</p>
+     * <p>Deletes a dataset group. Before you delete a dataset group, you must
+     *       delete the following:</p>
      *          <ul>
      *             <li>
      *                <p>All associated event trackers.</p>
@@ -812,27 +820,27 @@ export declare class Personalize extends PersonalizeClient {
     describeCampaign(args: DescribeCampaignCommandInput, cb: (err: any, data?: DescribeCampaignCommandOutput) => void): void;
     describeCampaign(args: DescribeCampaignCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeCampaignCommandOutput) => void): void;
     /**
-     * <p>Describes the given dataset. For more information on datasets, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
+     * <p>Describes the given dataset. For more information on datasets, see
+     *         <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
      */
     describeDataset(args: DescribeDatasetCommandInput, options?: __HttpHandlerOptions): Promise<DescribeDatasetCommandOutput>;
     describeDataset(args: DescribeDatasetCommandInput, cb: (err: any, data?: DescribeDatasetCommandOutput) => void): void;
     describeDataset(args: DescribeDatasetCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeDatasetCommandOutput) => void): void;
     /**
-     * <p>Describes the dataset export job created by <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html">CreateDatasetExportJob</a>,
-     *       including the export job status.</p>
+     * <p>Describes the dataset export job created by <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html">CreateDatasetExportJob</a>, including the export job status.</p>
      */
     describeDatasetExportJob(args: DescribeDatasetExportJobCommandInput, options?: __HttpHandlerOptions): Promise<DescribeDatasetExportJobCommandOutput>;
     describeDatasetExportJob(args: DescribeDatasetExportJobCommandInput, cb: (err: any, data?: DescribeDatasetExportJobCommandOutput) => void): void;
     describeDatasetExportJob(args: DescribeDatasetExportJobCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeDatasetExportJobCommandOutput) => void): void;
     /**
-     * <p>Describes the given dataset group. For more information on dataset groups, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html">CreateDatasetGroup</a>.</p>
+     * <p>Describes the given dataset group. For more information on dataset
+     *       groups, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html">CreateDatasetGroup</a>.</p>
      */
     describeDatasetGroup(args: DescribeDatasetGroupCommandInput, options?: __HttpHandlerOptions): Promise<DescribeDatasetGroupCommandOutput>;
     describeDatasetGroup(args: DescribeDatasetGroupCommandInput, cb: (err: any, data?: DescribeDatasetGroupCommandOutput) => void): void;
     describeDatasetGroup(args: DescribeDatasetGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeDatasetGroupCommandOutput) => void): void;
     /**
-     * <p>Describes the dataset import job created by <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html">CreateDatasetImportJob</a>,
-     *       including the import job status.</p>
+     * <p>Describes the dataset import job created by <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html">CreateDatasetImportJob</a>, including the import job status.</p>
      */
     describeDatasetImportJob(args: DescribeDatasetImportJobCommandInput, options?: __HttpHandlerOptions): Promise<DescribeDatasetImportJobCommandOutput>;
     describeDatasetImportJob(args: DescribeDatasetImportJobCommandInput, cb: (err: any, data?: DescribeDatasetImportJobCommandOutput) => void): void;
@@ -955,37 +963,39 @@ export declare class Personalize extends PersonalizeClient {
     listCampaigns(args: ListCampaignsCommandInput, cb: (err: any, data?: ListCampaignsCommandOutput) => void): void;
     listCampaigns(args: ListCampaignsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListCampaignsCommandOutput) => void): void;
     /**
-     * <p>Returns a list of dataset export jobs that use the given dataset. When a dataset is not
-     *       specified, all the dataset export jobs associated with the account are listed. The response
-     *       provides the properties for each dataset export job, including the Amazon Resource Name (ARN).
-     *       For more information on dataset export jobs, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html">CreateDatasetExportJob</a>. For
-     *       more information on datasets, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
+     * <p>Returns a list of dataset export jobs that use the given dataset. When
+     *       a dataset is not specified, all the dataset export jobs associated with
+     *       the account are listed. The response provides the properties for each
+     *       dataset export job, including the Amazon Resource Name (ARN). For more
+     *       information on dataset export jobs, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html">CreateDatasetExportJob</a>. For more information on datasets, see
+     *         <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
      */
     listDatasetExportJobs(args: ListDatasetExportJobsCommandInput, options?: __HttpHandlerOptions): Promise<ListDatasetExportJobsCommandOutput>;
     listDatasetExportJobs(args: ListDatasetExportJobsCommandInput, cb: (err: any, data?: ListDatasetExportJobsCommandOutput) => void): void;
     listDatasetExportJobs(args: ListDatasetExportJobsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListDatasetExportJobsCommandOutput) => void): void;
     /**
-     * <p>Returns a list of dataset groups. The response provides the properties for each dataset
-     *       group, including the Amazon Resource Name (ARN). For more information on dataset groups, see
-     *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html">CreateDatasetGroup</a>.</p>
+     * <p>Returns a list of dataset groups. The response provides the properties
+     *       for each dataset group, including the Amazon Resource Name (ARN). For more
+     *       information on dataset groups, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html">CreateDatasetGroup</a>.</p>
      */
     listDatasetGroups(args: ListDatasetGroupsCommandInput, options?: __HttpHandlerOptions): Promise<ListDatasetGroupsCommandOutput>;
     listDatasetGroups(args: ListDatasetGroupsCommandInput, cb: (err: any, data?: ListDatasetGroupsCommandOutput) => void): void;
     listDatasetGroups(args: ListDatasetGroupsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListDatasetGroupsCommandOutput) => void): void;
     /**
-     * <p>Returns a list of dataset import jobs that use the given dataset. When a dataset is not
-     *       specified, all the dataset import jobs associated with the account are listed. The response
-     *       provides the properties for each dataset import job, including the Amazon Resource Name (ARN).
-     *       For more information on dataset import jobs, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html">CreateDatasetImportJob</a>. For
-     *       more information on datasets, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
+     * <p>Returns a list of dataset import jobs that use the given dataset. When
+     *       a dataset is not specified, all the dataset import jobs associated with
+     *       the account are listed. The response provides the properties for each
+     *       dataset import job, including the Amazon Resource Name (ARN). For more
+     *       information on dataset import jobs, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html">CreateDatasetImportJob</a>. For more information on datasets, see
+     *         <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
      */
     listDatasetImportJobs(args: ListDatasetImportJobsCommandInput, options?: __HttpHandlerOptions): Promise<ListDatasetImportJobsCommandOutput>;
     listDatasetImportJobs(args: ListDatasetImportJobsCommandInput, cb: (err: any, data?: ListDatasetImportJobsCommandOutput) => void): void;
     listDatasetImportJobs(args: ListDatasetImportJobsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListDatasetImportJobsCommandOutput) => void): void;
     /**
-     * <p>Returns the list of datasets contained in the given dataset group. The response provides
-     *       the properties for each dataset, including the Amazon Resource Name (ARN). For more
-     *       information on datasets, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
+     * <p>Returns the list of datasets contained in the given dataset group. The
+     *       response provides the properties for each dataset, including the Amazon
+     *       Resource Name (ARN). For more information on datasets, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
      */
     listDatasets(args: ListDatasetsCommandInput, options?: __HttpHandlerOptions): Promise<ListDatasetsCommandOutput>;
     listDatasets(args: ListDatasetsCommandInput, cb: (err: any, data?: ListDatasetsCommandOutput) => void): void;

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

@@ -7,8 +7,9 @@ export interface CreateDatasetCommandInput extends CreateDatasetRequest {
 export interface CreateDatasetCommandOutput extends CreateDatasetResponse, __MetadataBearer {
 }
 /**
- * <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>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>
  *          <ul>
@@ -22,13 +23,14 @@ export interface CreateDatasetCommandOutput extends CreateDatasetResponse, __Met
  *                <p>Users</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 model (also referred to as
- *       creating a solution).</p>
+ *          <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
+ *       model (also referred to as creating a solution).</p>
  *          <p>A dataset can be in one of the following states:</p>
  *          <ul>
  *             <li>
- *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED</p>
+ *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE
+ *           FAILED</p>
  *             </li>
  *             <li>
  *                <p>DELETE PENDING > DELETE IN_PROGRESS</p>

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

@@ -7,28 +7,25 @@ export interface CreateDatasetExportJobCommandInput extends CreateDatasetExportJ
 export interface CreateDatasetExportJobCommandOutput extends CreateDatasetExportJobResponse, __MetadataBearer {
 }
 /**
- * <p>
- *       Creates a job that exports data from your dataset to an Amazon S3 bucket.
+ * <p> Creates a job that exports data from your dataset to an Amazon S3 bucket.
  *       To allow Amazon Personalize to export the training data, you must specify an
- *       service-linked IAM role that gives Amazon Personalize <code>PutObject</code> permissions for your Amazon S3 bucket.
- *       For information, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/export-data.html">Exporting a dataset</a>
- *       in the Amazon Personalize developer guide.
- *     </p>
+ *       service-linked IAM role that gives Amazon Personalize <code>PutObject</code>
+ *       permissions for your Amazon S3 bucket. For information, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/export-data.html">Exporting a dataset</a> in the Amazon Personalize developer guide. </p>
  *          <p>
  *             <b>Status</b>
  *          </p>
  *          <p>A dataset export job can be in one of the following states:</p>
  *          <ul>
  *             <li>
- *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED</p>
+ *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE
+ *           FAILED</p>
  *             </li>
  *          </ul>
- *          <p>
- *       To get the status of the export job, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html">DescribeDatasetExportJob</a>,
- *       and specify the Amazon Resource Name (ARN) of the dataset export job. The dataset export is
- *       complete when the status shows as ACTIVE. If the status shows as CREATE FAILED, the response
- *       includes a <code>failureReason</code> key, which describes why the job failed.
- *     </p>
+ *          <p> To get the status of the export job, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html">DescribeDatasetExportJob</a>, and specify the Amazon Resource Name
+ *       (ARN) of the dataset export job. The dataset export is complete when the
+ *       status shows as ACTIVE. If the status shows as CREATE FAILED, the response
+ *       includes a <code>failureReason</code> key, which describes why the job
+ *       failed. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,9 +7,9 @@ export interface CreateDatasetGroupCommandInput extends CreateDatasetGroupReques
 export interface CreateDatasetGroupCommandOutput extends CreateDatasetGroupResponse, __MetadataBearer {
 }
 /**
- * <p>Creates an empty dataset group. A dataset group is a container for Amazon Personalize resources.
- *       A dataset group can contain at most three datasets, one for each type of
- *       dataset:</p>
+ * <p>Creates an empty dataset group. A dataset group is a container for
+ *       Amazon Personalize resources. A dataset group can contain at most three datasets, one
+ *       for each type of dataset:</p>
  *          <ul>
  *             <li>
  *                <p>Interactions</p>
@@ -21,31 +21,33 @@ export interface CreateDatasetGroupCommandOutput extends CreateDatasetGroupRespo
  *                <p>Users</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 Custom dataset group, where you use custom resources, such as a solution with a solution version, that
- *       you deploy with a campaign.  If you start with a Domain dataset group, you can still add custom resources such as
- *       solutions and solution versions trained with recipes for custom use cases and deployed with campaigns.
- *     </p>
+ *          <p> A dataset group can be a Domain dataset group, where you specify a
+ *       domain and use pre-configured resources like recommenders, or a
+ *       Custom dataset group, where you use custom resources, such as a solution
+ *       with a solution version, that you deploy with a campaign. If you start
+ *       with a Domain dataset group, you can still add custom resources such as
+ *       solutions and solution versions trained with recipes for custom use cases
+ *       and deployed with campaigns. </p>
  *          <p>A dataset group can be in one of the following states:</p>
  *          <ul>
  *             <li>
- *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED</p>
+ *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE
+ *           FAILED</p>
  *             </li>
  *             <li>
  *                <p>DELETE PENDING</p>
  *             </li>
  *          </ul>
- *          <p>To get the status of the dataset group, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html">DescribeDatasetGroup</a>. If
- *       the status shows as CREATE FAILED, the response includes a <code>failureReason</code> key,
- *       which describes why the creation failed.</p>
+ *          <p>To get the status of the dataset group, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html">DescribeDatasetGroup</a>. If the status shows as CREATE FAILED, the
+ *       response includes a <code>failureReason</code> key, which describes why
+ *       the creation failed.</p>
  *          <note>
- *             <p>You must wait until the <code>status</code> of the dataset group is <code>ACTIVE</code>
- *         before adding a dataset to the group.</p>
+ *             <p>You must wait until the <code>status</code> of the dataset group is
+ *           <code>ACTIVE</code> before adding a dataset to the group.</p>
  *          </note>
- *          <p>You can specify an Key Management Service (KMS) key to encrypt the datasets in the group. If you
- *       specify a KMS key, you must also include an Identity and Access Management (IAM) role that has permission to
- *       access the key.</p>
+ *          <p>You can specify an Key Management Service (KMS) key to encrypt the datasets in
+ *       the group. If you specify a KMS key, you must also include an Identity and Access Management
+ *       (IAM) role that has permission to access the key.</p>
  *          <p class="title">
  *             <b>APIs that require a dataset group ARN in the request</b>
  *          </p>

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

@@ -7,14 +7,18 @@ export interface CreateDatasetImportJobCommandInput extends CreateDatasetImportJ
 export interface CreateDatasetImportJobCommandOutput extends CreateDatasetImportJobResponse, __MetadataBearer {
 }
 /**
- * <p>Creates a job that imports training data from your data source (an Amazon S3 bucket) to an
- *       Amazon Personalize dataset. To allow Amazon Personalize to import the training data, you must specify an
- *       IAM service role that has permission to read from the data source, as Amazon Personalize makes a
- *       copy of your data and 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>Creates a job that imports training data from your data source (an
+ *       Amazon S3 bucket) to an Amazon Personalize dataset. To allow Amazon Personalize to import the
+ *       training data, you must specify an IAM service role that has permission to
+ *       read from the data source, as Amazon Personalize makes a copy of your data and
+ *       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>
  *          <important>
- *             <p>The dataset import job replaces any existing data in the dataset that you imported in bulk.</p>
+ *             <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
+ *         existing data, specify INCREMENTAL for the import mode in the
+ *         CreateDatasetImportJob operation.</p>
  *          </important>
  *          <p>
  *             <b>Status</b>
@@ -22,16 +26,18 @@ export interface CreateDatasetImportJobCommandOutput extends CreateDatasetImport
  *          <p>A dataset import job can be in one of the following states:</p>
  *          <ul>
  *             <li>
- *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED</p>
+ *                <p>CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE
+ *           FAILED</p>
  *             </li>
  *          </ul>
- *          <p>To get the status of the import job, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html">DescribeDatasetImportJob</a>,
- *       providing the Amazon Resource Name (ARN) of the dataset import job. The dataset import is
- *       complete when the status shows as ACTIVE. If the status shows as CREATE FAILED, the response
- *       includes a <code>failureReason</code> key, which describes why the job failed.</p>
+ *          <p>To get the status of the import job, call <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html">DescribeDatasetImportJob</a>, providing the Amazon Resource Name
+ *       (ARN) of the dataset import job. The dataset import is complete when the
+ *       status shows as ACTIVE. If the status shows as CREATE FAILED, the response
+ *       includes a <code>failureReason</code> key, which describes why the job
+ *       failed.</p>
  *          <note>
- *             <p>Importing takes time. You must wait until the status shows as ACTIVE before training a
- *         model using the dataset.</p>
+ *             <p>Importing takes time. You must wait until the status shows as ACTIVE
+ *         before training a model using the dataset.</p>
  *          </note>
  *
  *          <p class="title">

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

@@ -8,8 +8,9 @@ export interface DeleteDatasetCommandOutput extends __MetadataBearer {
 }
 /**
  * <p>Deletes a dataset. You can't delete a dataset if an associated
- *         <code>DatasetImportJob</code> or <code>SolutionVersion</code> is in the CREATE PENDING or IN
- *       PROGRESS state. For more information on datasets, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
+ *         <code>DatasetImportJob</code> or <code>SolutionVersion</code> is in the
+ *       CREATE PENDING or IN PROGRESS state. For more information on datasets, see
+ *         <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,8 +7,8 @@ export interface DeleteDatasetGroupCommandInput extends DeleteDatasetGroupReques
 export interface DeleteDatasetGroupCommandOutput extends __MetadataBearer {
 }
 /**
- * <p>Deletes a dataset group. Before you delete a dataset group, you must delete the
- *       following:</p>
+ * <p>Deletes a dataset group. Before you delete a dataset group, you must
+ *       delete the following:</p>
  *          <ul>
  *             <li>
  *                <p>All associated event trackers.</p>

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

@@ -7,7 +7,8 @@ export interface DescribeDatasetCommandInput extends DescribeDatasetRequest {
 export interface DescribeDatasetCommandOutput extends DescribeDatasetResponse, __MetadataBearer {
 }
 /**
- * <p>Describes the given dataset. For more information on datasets, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
+ * <p>Describes the given dataset. For more information on datasets, see
+ *         <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,8 +7,7 @@ export interface DescribeDatasetExportJobCommandInput extends DescribeDatasetExp
 export interface DescribeDatasetExportJobCommandOutput extends DescribeDatasetExportJobResponse, __MetadataBearer {
 }
 /**
- * <p>Describes the dataset export job created by <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html">CreateDatasetExportJob</a>,
- *       including the export job status.</p>
+ * <p>Describes the dataset export job created by <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html">CreateDatasetExportJob</a>, including the export job status.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,7 +7,8 @@ export interface DescribeDatasetGroupCommandInput extends DescribeDatasetGroupRe
 export interface DescribeDatasetGroupCommandOutput extends DescribeDatasetGroupResponse, __MetadataBearer {
 }
 /**
- * <p>Describes the given dataset group. For more information on dataset groups, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html">CreateDatasetGroup</a>.</p>
+ * <p>Describes the given dataset group. For more information on dataset
+ *       groups, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html">CreateDatasetGroup</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,8 +7,7 @@ export interface DescribeDatasetImportJobCommandInput extends DescribeDatasetImp
 export interface DescribeDatasetImportJobCommandOutput extends DescribeDatasetImportJobResponse, __MetadataBearer {
 }
 /**
- * <p>Describes the dataset import job created by <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html">CreateDatasetImportJob</a>,
- *       including the import job status.</p>
+ * <p>Describes the dataset import job created by <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html">CreateDatasetImportJob</a>, including the import job status.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,11 +7,12 @@ export interface ListDatasetExportJobsCommandInput extends ListDatasetExportJobs
 export interface ListDatasetExportJobsCommandOutput extends ListDatasetExportJobsResponse, __MetadataBearer {
 }
 /**
- * <p>Returns a list of dataset export jobs that use the given dataset. When a dataset is not
- *       specified, all the dataset export jobs associated with the account are listed. The response
- *       provides the properties for each dataset export job, including the Amazon Resource Name (ARN).
- *       For more information on dataset export jobs, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html">CreateDatasetExportJob</a>. For
- *       more information on datasets, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
+ * <p>Returns a list of dataset export jobs that use the given dataset. When
+ *       a dataset is not specified, all the dataset export jobs associated with
+ *       the account are listed. The response provides the properties for each
+ *       dataset export job, including the Amazon Resource Name (ARN). For more
+ *       information on dataset export jobs, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html">CreateDatasetExportJob</a>. For more information on datasets, see
+ *         <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html">CreateDataset</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

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

@@ -7,9 +7,9 @@ export interface ListDatasetGroupsCommandInput extends ListDatasetGroupsRequest
 export interface ListDatasetGroupsCommandOutput extends ListDatasetGroupsResponse, __MetadataBearer {
 }
 /**
- * <p>Returns a list of dataset groups. The response provides the properties for each dataset
- *       group, including the Amazon Resource Name (ARN). For more information on dataset groups, see
- *       <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html">CreateDatasetGroup</a>.</p>
+ * <p>Returns a list of dataset groups. The response provides the properties
+ *       for each dataset group, including the Amazon Resource Name (ARN). For more
+ *       information on dataset groups, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html">CreateDatasetGroup</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript