@aws-sdk/client-personalize 3.489.0 → 3.493.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -35,27 +35,26 @@ declare const CreateCampaignCommand_base: {
35
35
  * <b>Minimum Provisioned TPS and Auto-Scaling</b>
36
36
  * </p>
37
37
  * <important>
38
- * <p> A high <code>minProvisionedTPS</code> will increase your bill. We recommend starting with 1 for <code>minProvisionedTPS</code> (the default). Track
38
+ * <p> A high <code>minProvisionedTPS</code> will increase your cost. We recommend starting with 1 for <code>minProvisionedTPS</code> (the default). Track
39
39
  * your usage using Amazon CloudWatch metrics, and increase the <code>minProvisionedTPS</code>
40
40
  * as necessary.</p>
41
41
  * </important>
42
- * <p>A transaction is a single <code>GetRecommendations</code> or
43
- * <code>GetPersonalizedRanking</code> call. Transactions per second (TPS) is the throughput
44
- * and unit of billing for Amazon Personalize. The minimum provisioned TPS
45
- * (<code>minProvisionedTPS</code>) specifies the baseline throughput provisioned by
46
- * Amazon Personalize, and thus, the minimum billing charge.
47
- * </p>
48
42
  * <p>
49
- * If your TPS increases beyond
50
- * <code>minProvisionedTPS</code>, Amazon Personalize auto-scales the provisioned capacity up and down,
51
- * but never below <code>minProvisionedTPS</code>.
52
- * There's a short time delay while the capacity is increased that might cause loss of
53
- * transactions.</p>
54
- * <p>The actual TPS used is calculated as the average requests/second within a 5-minute window.
55
- * You pay for maximum of either the minimum provisioned TPS or the actual TPS.
43
+ * When you create an Amazon Personalize campaign, you can specify the minimum provisioned transactions per second
44
+ * (<code>minProvisionedTPS</code>) for the campaign. This is the baseline transaction throughput for the campaign provisioned by
45
+ * Amazon Personalize. It sets the minimum billing charge for the campaign while it is active. A transaction is a single <code>GetRecommendations</code> or
46
+ * <code>GetPersonalizedRanking</code> request. The default <code>minProvisionedTPS</code> is 1.</p>
47
+ * <p> If your TPS increases beyond the <code>minProvisionedTPS</code>, Amazon Personalize auto-scales the provisioned capacity up
48
+ * and down, but never below <code>minProvisionedTPS</code>.
49
+ * There's a short time delay while the capacity is increased
50
+ * that might cause loss of transactions. When your traffic reduces, capacity returns to the <code>minProvisionedTPS</code>.
51
+ * </p>
52
+ * <p>You are charged for the
53
+ * the minimum provisioned TPS or, if your requests exceed the <code>minProvisionedTPS</code>, the actual TPS.
54
+ * The actual TPS is the total number of recommendation requests you make.
56
55
  * We recommend starting with a low <code>minProvisionedTPS</code>, track
57
- * your usage using Amazon CloudWatch metrics, and then increase the <code>minProvisionedTPS</code>
58
- * as necessary.</p>
56
+ * your usage using Amazon CloudWatch metrics, and then increase the <code>minProvisionedTPS</code> as necessary.</p>
57
+ * <p>For more information about campaign costs, see <a href="https://aws.amazon.com/personalize/pricing/">Amazon Personalize pricing</a>.</p>
59
58
  * <p>
60
59
  * <b>Status</b>
61
60
  * </p>
@@ -529,7 +529,8 @@ export interface CampaignConfig {
529
529
  /**
530
530
  * @public
531
531
  * <p>Whether metadata with recommendations is enabled for the campaign.
532
- * 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>
532
+ * 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.
533
+ * For information about enabling metadata for a campaign, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata">Enabling metadata in recommendations for a campaign</a>.</p>
533
534
  * <p>
534
535
  * 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>.
535
536
  * </p>
@@ -1064,7 +1065,8 @@ export interface RecommenderConfig {
1064
1065
  /**
1065
1066
  * @public
1066
1067
  * <p>Whether metadata with recommendations is enabled for the recommender.
1067
- * 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>
1068
+ * 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.
1069
+ * For information about enabling metadata for a recommender, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata">Enabling metadata in recommendations for a recommender</a>.</p>
1068
1070
  * <p>
1069
1071
  * 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>.
1070
1072
  * </p>
@@ -1417,8 +1419,7 @@ export interface CreateSolutionRequest {
1417
1419
  * @public
1418
1420
  * <important>
1419
1421
  * <p>We don't recommend enabling automated machine learning. Instead, match your use case to the available Amazon Personalize
1420
- * recipes. For more information, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/determining-use-case.html">Determining your use case.</a>
1421
- * </p>
1422
+ * recipes. For more information, see <a href="https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html">Choosing a recipe</a>.</p>
1422
1423
  * </important>
1423
1424
  * <p>Whether to perform automated machine learning (AutoML). The default is <code>false</code>.
1424
1425
  * For this case, you must specify <code>recipeArn</code>.</p>
@@ -1431,8 +1432,11 @@ export interface CreateSolutionRequest {
1431
1432
  performAutoML?: boolean;
1432
1433
  /**
1433
1434
  * @public
1434
- * <p>The ARN of the recipe to use for model training. This is required when
1435
- * <code>performAutoML</code> is false.</p>
1435
+ * <p>The Amazon Resource Name (ARN) of the recipe to use for model training. This is required when
1436
+ * <code>performAutoML</code> is false. For information about different Amazon Personalize recipes and their ARNs,
1437
+ * see <a href="https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html">Choosing a recipe</a>.
1438
+ *
1439
+ * </p>
1436
1440
  */
1437
1441
  recipeArn?: string;
1438
1442
  /**
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-personalize",
3
3
  "description": "AWS SDK for JavaScript Personalize Client for Node.js, Browser and React Native",
4
- "version": "3.489.0",
4
+ "version": "3.493.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -20,9 +20,9 @@
20
20
  "dependencies": {
21
21
  "@aws-crypto/sha256-browser": "3.0.0",
22
22
  "@aws-crypto/sha256-js": "3.0.0",
23
- "@aws-sdk/client-sts": "3.489.0",
24
- "@aws-sdk/core": "3.485.0",
25
- "@aws-sdk/credential-provider-node": "3.489.0",
23
+ "@aws-sdk/client-sts": "3.490.0",
24
+ "@aws-sdk/core": "3.490.0",
25
+ "@aws-sdk/credential-provider-node": "3.490.0",
26
26
  "@aws-sdk/middleware-host-header": "3.489.0",
27
27
  "@aws-sdk/middleware-logger": "3.489.0",
28
28
  "@aws-sdk/middleware-recursion-detection": "3.489.0",