@aws-sdk/client-forecast 3.262.0 → 3.263.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.
Files changed (28) hide show
  1. package/dist-cjs/endpoint/ruleset.js +3 -3
  2. package/dist-cjs/models/models_0.js +9 -4
  3. package/dist-cjs/protocols/Aws_json1_1.js +3 -0
  4. package/dist-es/endpoint/ruleset.js +3 -3
  5. package/dist-es/models/models_0.js +5 -0
  6. package/dist-es/protocols/Aws_json1_1.js +3 -0
  7. package/dist-types/Forecast.d.ts +102 -108
  8. package/dist-types/commands/CreateAutoPredictorCommand.d.ts +16 -18
  9. package/dist-types/commands/CreateDatasetImportJobCommand.d.ts +2 -2
  10. package/dist-types/commands/CreateExplainabilityCommand.d.ts +39 -39
  11. package/dist-types/commands/CreateExplainabilityExportCommand.d.ts +4 -4
  12. package/dist-types/commands/CreateForecastExportJobCommand.d.ts +1 -1
  13. package/dist-types/commands/CreatePredictorBacktestExportJobCommand.d.ts +7 -7
  14. package/dist-types/commands/CreatePredictorCommand.d.ts +0 -3
  15. package/dist-types/commands/CreateWhatIfAnalysisCommand.d.ts +7 -6
  16. package/dist-types/commands/CreateWhatIfForecastExportCommand.d.ts +1 -1
  17. package/dist-types/commands/DeleteExplainabilityCommand.d.ts +1 -1
  18. package/dist-types/commands/DeleteResourceTreeCommand.d.ts +9 -10
  19. package/dist-types/commands/DescribePredictorBacktestExportJobCommand.d.ts +12 -12
  20. package/dist-types/commands/GetAccuracyMetricsCommand.d.ts +0 -1
  21. package/dist-types/commands/ListExplainabilitiesCommand.d.ts +1 -1
  22. package/dist-types/commands/ListExplainabilityExportsCommand.d.ts +1 -1
  23. package/dist-types/commands/ListPredictorBacktestExportJobsCommand.d.ts +1 -1
  24. package/dist-types/endpoint/EndpointParameters.d.ts +1 -1
  25. package/dist-types/models/models_0.d.ts +448 -369
  26. package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts +1 -1
  27. package/dist-types/ts3.4/models/models_0.d.ts +7 -0
  28. package/package.json +1 -1
@@ -11,118 +11,118 @@ export interface CreateExplainabilityCommandOutput extends CreateExplainabilityR
11
11
  * <note>
12
12
  * <p>Explainability is only available for Forecasts and Predictors generated from an
13
13
  * AutoPredictor (<a>CreateAutoPredictor</a>)</p>
14
- * </note>
15
- * <p>Creates an Amazon Forecast Explainability.</p>
16
- * <p>Explainability helps you better understand how the attributes in your datasets impact
14
+ * </note>
15
+ * <p>Creates an Amazon Forecast Explainability.</p>
16
+ * <p>Explainability helps you better understand how the attributes in your datasets impact
17
17
  * forecast. Amazon Forecast uses a metric called Impact scores to quantify the relative
18
18
  * impact of each attribute and determine whether they increase or decrease forecast
19
19
  * values.</p>
20
- * <p>To enable Forecast Explainability, your predictor must include at least one of the
20
+ * <p>To enable Forecast Explainability, your predictor must include at least one of the
21
21
  * following: related time series, item metadata, or additional datasets like Holidays and
22
22
  * the Weather Index.</p>
23
- * <p>CreateExplainability accepts either a Predictor ARN or Forecast ARN. To receive
23
+ * <p>CreateExplainability accepts either a Predictor ARN or Forecast ARN. To receive
24
24
  * aggregated Impact scores for all time series and time points in your datasets, provide a
25
25
  * Predictor ARN. To receive Impact scores for specific time series and time points,
26
26
  * provide a Forecast ARN.</p>
27
- * <p>
27
+ * <p>
28
28
  * <b>CreateExplainability with a Predictor ARN</b>
29
- * </p>
30
- * <note>
29
+ * </p>
30
+ * <note>
31
31
  * <p>You can only have one Explainability resource per predictor. If you already
32
32
  * enabled <code>ExplainPredictor</code> in <a>CreateAutoPredictor</a>, that
33
33
  * predictor already has an Explainability resource.</p>
34
- * </note>
35
- * <p>The following parameters are required when providing a Predictor ARN:</p>
36
- * <ul>
34
+ * </note>
35
+ * <p>The following parameters are required when providing a Predictor ARN:</p>
36
+ * <ul>
37
37
  * <li>
38
- * <p>
38
+ * <p>
39
39
  * <code>ExplainabilityName</code> - A unique name for the Explainability.</p>
40
40
  * </li>
41
41
  * <li>
42
- * <p>
42
+ * <p>
43
43
  * <code>ResourceArn</code> - The Arn of the predictor.</p>
44
44
  * </li>
45
45
  * <li>
46
- * <p>
46
+ * <p>
47
47
  * <code>TimePointGranularity</code> - Must be set to “ALL”.</p>
48
48
  * </li>
49
49
  * <li>
50
- * <p>
50
+ * <p>
51
51
  * <code>TimeSeriesGranularity</code> - Must be set to “ALL”.</p>
52
52
  * </li>
53
53
  * </ul>
54
- * <p>Do not specify a value for the following parameters:</p>
55
- * <ul>
54
+ * <p>Do not specify a value for the following parameters:</p>
55
+ * <ul>
56
56
  * <li>
57
- * <p>
57
+ * <p>
58
58
  * <code>DataSource</code> - Only valid when TimeSeriesGranularity is
59
59
  * “SPECIFIC”.</p>
60
60
  * </li>
61
61
  * <li>
62
- * <p>
62
+ * <p>
63
63
  * <code>Schema</code> - Only valid when TimeSeriesGranularity is
64
64
  * “SPECIFIC”.</p>
65
65
  * </li>
66
66
  * <li>
67
- * <p>
67
+ * <p>
68
68
  * <code>StartDateTime</code> - Only valid when TimePointGranularity is
69
69
  * “SPECIFIC”.</p>
70
70
  * </li>
71
71
  * <li>
72
- * <p>
72
+ * <p>
73
73
  * <code>EndDateTime</code> - Only valid when TimePointGranularity is
74
74
  * “SPECIFIC”.</p>
75
75
  * </li>
76
76
  * </ul>
77
- * <p>
77
+ * <p>
78
78
  * <b>CreateExplainability with a Forecast ARN</b>
79
- * </p>
80
- * <note>
79
+ * </p>
80
+ * <note>
81
81
  * <p>You can specify a maximum of 50 time series and 500 time points.</p>
82
- * </note>
83
- * <p>The following parameters are required when providing a Predictor ARN:</p>
84
- * <ul>
82
+ * </note>
83
+ * <p>The following parameters are required when providing a Predictor ARN:</p>
84
+ * <ul>
85
85
  * <li>
86
- * <p>
86
+ * <p>
87
87
  * <code>ExplainabilityName</code> - A unique name for the Explainability.</p>
88
88
  * </li>
89
89
  * <li>
90
- * <p>
90
+ * <p>
91
91
  * <code>ResourceArn</code> - The Arn of the forecast.</p>
92
92
  * </li>
93
93
  * <li>
94
- * <p>
94
+ * <p>
95
95
  * <code>TimePointGranularity</code> - Either “ALL” or “SPECIFIC”.</p>
96
96
  * </li>
97
97
  * <li>
98
- * <p>
98
+ * <p>
99
99
  * <code>TimeSeriesGranularity</code> - Either “ALL” or “SPECIFIC”.</p>
100
100
  * </li>
101
101
  * </ul>
102
- * <p>If you set TimeSeriesGranularity to “SPECIFIC”, you must also provide the
102
+ * <p>If you set TimeSeriesGranularity to “SPECIFIC”, you must also provide the
103
103
  * following:</p>
104
- * <ul>
104
+ * <ul>
105
105
  * <li>
106
- * <p>
106
+ * <p>
107
107
  * <code>DataSource</code> - The S3 location of the CSV file specifying your time
108
108
  * series.</p>
109
109
  * </li>
110
110
  * <li>
111
- * <p>
111
+ * <p>
112
112
  * <code>Schema</code> - The Schema defines the attributes and attribute types
113
113
  * listed in the Data Source.</p>
114
114
  * </li>
115
115
  * </ul>
116
- * <p>If you set TimePointGranularity to “SPECIFIC”, you must also provide the
116
+ * <p>If you set TimePointGranularity to “SPECIFIC”, you must also provide the
117
117
  * following:</p>
118
- * <ul>
118
+ * <ul>
119
119
  * <li>
120
- * <p>
120
+ * <p>
121
121
  * <code>StartDateTime</code> - The first timestamp in the range of time
122
122
  * points.</p>
123
123
  * </li>
124
124
  * <li>
125
- * <p>
125
+ * <p>
126
126
  * <code>EndDateTime</code> - The last timestamp in the range of time
127
127
  * points.</p>
128
128
  * </li>
@@ -10,13 +10,13 @@ export interface CreateExplainabilityExportCommandOutput extends CreateExplainab
10
10
  /**
11
11
  * <p>Exports an Explainability resource created by the <a>CreateExplainability</a> operation. Exported files are exported to an Amazon Simple Storage Service (Amazon
12
12
  * S3) bucket.</p>
13
- * <p>You must specify a <a>DataDestination</a> object that includes an Amazon S3
14
- * bucket and an AWS Identity and Access Management (IAM) role that Amazon Forecast can assume to access the Amazon S3
13
+ * <p>You must specify a <a>DataDestination</a> object that includes an Amazon S3
14
+ * bucket and an Identity and Access Management (IAM) role that Amazon Forecast can assume to access the Amazon S3
15
15
  * bucket. For more information, see <a>aws-forecast-iam-roles</a>.</p>
16
- * <note>
16
+ * <note>
17
17
  * <p>The <code>Status</code> of the export job must be <code>ACTIVE</code> before you
18
18
  * can access the export in your Amazon S3 bucket. To get the status, use the <a>DescribeExplainabilityExport</a> operation.</p>
19
- * </note>
19
+ * </note>
20
20
  * @example
21
21
  * Use a bare-bones client and the command you need to make an API call.
22
22
  * ```javascript
@@ -13,7 +13,7 @@ export interface CreateForecastExportJobCommandOutput extends CreateForecastExpo
13
13
  * <p><ForecastExportJobName>_<ExportTimestamp>_<PartNumber></p>
14
14
  * <p>where the <ExportTimestamp> component is in Java SimpleDateFormat
15
15
  * (yyyy-MM-ddTHH-mm-ssZ).</p>
16
- * <p>You must specify a <a>DataDestination</a> object that includes an AWS Identity and Access Management
16
+ * <p>You must specify a <a>DataDestination</a> object that includes an Identity and Access Management
17
17
  * (IAM) role that Amazon Forecast can assume to access the Amazon S3 bucket. For more information, see
18
18
  * <a>aws-forecast-iam-roles</a>.</p>
19
19
  * <p>For more information, see <a>howitworks-forecast</a>.</p>
@@ -10,19 +10,19 @@ export interface CreatePredictorBacktestExportJobCommandOutput extends CreatePre
10
10
  /**
11
11
  * <p>Exports backtest forecasts and accuracy metrics generated by the <a>CreateAutoPredictor</a> or <a>CreatePredictor</a> operations. Two
12
12
  * folders containing CSV or Parquet files are exported to your specified S3 bucket.</p>
13
- * <p> The export file names will match the following conventions:</p>
14
- * <p>
13
+ * <p> The export file names will match the following conventions:</p>
14
+ * <p>
15
15
  * <code><ExportJobName>_<ExportTimestamp>_<PartNumber>.csv</code>
16
16
  * </p>
17
- * <p>The <ExportTimestamp> component is in Java SimpleDate format
17
+ * <p>The <ExportTimestamp> component is in Java SimpleDate format
18
18
  * (yyyy-MM-ddTHH-mm-ssZ).</p>
19
- * <p>You must specify a <a>DataDestination</a> object that includes an Amazon S3
20
- * bucket and an AWS Identity and Access Management (IAM) role that Amazon Forecast can assume to access the Amazon S3
19
+ * <p>You must specify a <a>DataDestination</a> object that includes an Amazon S3
20
+ * bucket and an Identity and Access Management (IAM) role that Amazon Forecast can assume to access the Amazon S3
21
21
  * bucket. For more information, see <a>aws-forecast-iam-roles</a>.</p>
22
- * <note>
22
+ * <note>
23
23
  * <p>The <code>Status</code> of the export job must be <code>ACTIVE</code> before you
24
24
  * can access the export in your Amazon S3 bucket. To get the status, use the <a>DescribePredictorBacktestExportJob</a> operation.</p>
25
- * </note>
25
+ * </note>
26
26
  * @example
27
27
  * Use a bare-bones client and the command you need to make an API call.
28
28
  * ```javascript
@@ -61,9 +61,6 @@ export interface CreatePredictorCommandOutput extends CreatePredictorResponse, _
61
61
  * </p>
62
62
  * </li>
63
63
  * </ul>
64
- *
65
- *
66
- *
67
64
  * <p>To get a list of all of your predictors, use the <a>ListPredictors</a>
68
65
  * operation.</p>
69
66
  * <note>
@@ -12,12 +12,13 @@ export interface CreateWhatIfAnalysisCommandOutput extends CreateWhatIfAnalysisR
12
12
  * compare the forecasts generated by these changes against the baseline, unchanged time series. It is important to
13
13
  * remember that the purpose of a what-if analysis is to understand how a forecast can change given different
14
14
  * modifications to the baseline time series.</p>
15
- * <p>For example, imagine you are a clothing retailer who is considering an end of season sale to clear space for
16
- * new styles. After creating a baseline forecast, you can use a what-if analysis to investigate how different sales
17
- * tactics might affect your goals. You could create a scenario where everything is given a 25% markdown and another
18
- * where everything is given a fixed dollar markdown. You can create a scenario where the sale lasts for 1 week and
19
- * another where the sale lasts for 1 month. Your what-if analysis enables you to compare many different scenarios
20
- * against each other.</p>
15
+ * <p>For example, imagine you are a clothing retailer who is considering an end of season sale
16
+ * to clear space for new styles. After creating a baseline forecast, you can use a what-if
17
+ * analysis to investigate how different sales tactics might affect your goals.</p>
18
+ * <p>You could create a scenario where everything is given a 25% markdown, and another where
19
+ * everything is given a fixed dollar markdown. You could create a scenario where the sale lasts for one week and
20
+ * another where the sale lasts for one month.
21
+ * With a what-if analysis, you can compare many different scenarios against each other.</p>
21
22
  * <p>Note that a what-if analysis is meant to display what the forecasting model has learned and how it will behave in the scenarios that you are evaluating. Do not blindly use the results of the what-if analysis to make business decisions. For instance, forecasts might not be accurate for novel scenarios where there is no reference available to determine whether a forecast is good.</p>
22
23
  * <p>The <a>TimeSeriesSelector</a> object defines the items that you want in the what-if analysis.</p>
23
24
  * @example
@@ -15,7 +15,7 @@ export interface CreateWhatIfForecastExportCommandOutput extends CreateWhatIfFor
15
15
  * </p>
16
16
  * <p>The <ExportTimestamp> component is in Java SimpleDateFormat
17
17
  * (yyyy-MM-ddTHH-mm-ssZ).</p>
18
- * <p>You must specify a <a>DataDestination</a> object that includes an AWS Identity and Access Management
18
+ * <p>You must specify a <a>DataDestination</a> object that includes an Identity and Access Management
19
19
  * (IAM) role that Amazon Forecast can assume to access the Amazon S3 bucket. For more information, see
20
20
  * <a>aws-forecast-iam-roles</a>.</p>
21
21
  * <p>For more information, see <a>howitworks-forecast</a>.</p>
@@ -9,7 +9,7 @@ export interface DeleteExplainabilityCommandOutput extends __MetadataBearer {
9
9
  }
10
10
  /**
11
11
  * <p>Deletes an Explainability resource.</p>
12
- * <p>You can delete only predictor that have a status of <code>ACTIVE</code> or
12
+ * <p>You can delete only predictor that have a status of <code>ACTIVE</code> or
13
13
  * <code>CREATE_FAILED</code>. To get the status, use the <a>DescribeExplainability</a> operation.</p>
14
14
  * @example
15
15
  * Use a bare-bones client and the command you need to make an API call.
@@ -10,36 +10,35 @@ export interface DeleteResourceTreeCommandOutput extends __MetadataBearer {
10
10
  /**
11
11
  * <p>Deletes an entire resource tree. This operation will delete the parent resource and
12
12
  * its child resources.</p>
13
- * <p>Child resources are resources that were created from another resource. For example,
13
+ * <p>Child resources are resources that were created from another resource. For example,
14
14
  * when a forecast is generated from a predictor, the forecast is the child resource and
15
15
  * the predictor is the parent resource.</p>
16
- * <p>Amazon Forecast resources possess the following parent-child resource hierarchies:</p>
17
- *
18
- * <ul>
16
+ * <p>Amazon Forecast resources possess the following parent-child resource hierarchies:</p>
17
+ * <ul>
19
18
  * <li>
20
- * <p>
19
+ * <p>
21
20
  * <b>Dataset</b>: dataset import jobs</p>
22
21
  * </li>
23
22
  * <li>
24
- * <p>
23
+ * <p>
25
24
  * <b>Dataset Group</b>: predictors, predictor backtest
26
25
  * export jobs, forecasts, forecast export jobs</p>
27
26
  * </li>
28
27
  * <li>
29
- * <p>
28
+ * <p>
30
29
  * <b>Predictor</b>: predictor backtest export jobs,
31
30
  * forecasts, forecast export jobs</p>
32
31
  * </li>
33
32
  * <li>
34
- * <p>
33
+ * <p>
35
34
  * <b>Forecast</b>: forecast export jobs</p>
36
35
  * </li>
37
36
  * </ul>
38
- * <note>
37
+ * <note>
39
38
  * <p>
40
39
  * <code>DeleteResourceTree</code> will only delete Amazon Forecast resources, and will not
41
40
  * delete datasets or exported files stored in Amazon S3. </p>
42
- * </note>
41
+ * </note>
43
42
  * @example
44
43
  * Use a bare-bones client and the command you need to make an API call.
45
44
  * ```javascript
@@ -9,27 +9,27 @@ export interface DescribePredictorBacktestExportJobCommandOutput extends Describ
9
9
  }
10
10
  /**
11
11
  * <p>Describes a predictor backtest export job created using the <a>CreatePredictorBacktestExportJob</a> operation.</p>
12
- * <p>In addition to listing the properties provided by the user in the
12
+ * <p>In addition to listing the properties provided by the user in the
13
13
  * <code>CreatePredictorBacktestExportJob</code> request, this operation lists the
14
14
  * following properties:</p>
15
- * <ul>
15
+ * <ul>
16
16
  * <li>
17
- * <p>
18
- * <code>CreationTime</code>
19
- * </p>
17
+ * <p>
18
+ * <code>CreationTime</code>
19
+ * </p>
20
20
  * </li>
21
21
  * <li>
22
- * <p>
23
- * <code>LastModificationTime</code>
24
- * </p>
22
+ * <p>
23
+ * <code>LastModificationTime</code>
24
+ * </p>
25
25
  * </li>
26
26
  * <li>
27
- * <p>
28
- * <code>Status</code>
29
- * </p>
27
+ * <p>
28
+ * <code>Status</code>
29
+ * </p>
30
30
  * </li>
31
31
  * <li>
32
- * <p>
32
+ * <p>
33
33
  * <code>Message</code> (if an error occurred)</p>
34
34
  * </li>
35
35
  * </ul>
@@ -20,7 +20,6 @@ export interface GetAccuracyMetricsCommandOutput extends GetAccuracyMetricsRespo
20
20
  * metrics. If you want all items to contribute, specify <code>zero</code>. If you want only
21
21
  * those items that have complete data in the range being evaluated to contribute, specify
22
22
  * <code>nan</code>. For more information, see <a>FeaturizationMethod</a>.</p>
23
- *
24
23
  * <note>
25
24
  * <p>Before you can get accuracy metrics, the <code>Status</code> of the predictor must be
26
25
  * <code>ACTIVE</code>, signifying that training has completed. To get the status, use the
@@ -11,7 +11,7 @@ export interface ListExplainabilitiesCommandOutput extends ListExplainabilitiesR
11
11
  * <p>Returns a list of Explainability resources created using the <a>CreateExplainability</a> operation. This operation returns a summary for
12
12
  * each Explainability. You can filter the list using an array of <a>Filter</a>
13
13
  * objects.</p>
14
- * <p>To retrieve the complete set of properties for a particular Explainability resource,
14
+ * <p>To retrieve the complete set of properties for a particular Explainability resource,
15
15
  * use the ARN with the <a>DescribeExplainability</a> operation.</p>
16
16
  * @example
17
17
  * Use a bare-bones client and the command you need to make an API call.
@@ -10,7 +10,7 @@ export interface ListExplainabilityExportsCommandOutput extends ListExplainabili
10
10
  /**
11
11
  * <p>Returns a list of Explainability exports created using the <a>CreateExplainabilityExport</a> operation. This operation returns a summary
12
12
  * for each Explainability export. You can filter the list using an array of <a>Filter</a> objects.</p>
13
- * <p>To retrieve the complete set of properties for a particular Explainability export, use
13
+ * <p>To retrieve the complete set of properties for a particular Explainability export, use
14
14
  * the ARN with the <a>DescribeExplainability</a> operation.</p>
15
15
  * @example
16
16
  * Use a bare-bones client and the command you need to make an API call.
@@ -10,7 +10,7 @@ export interface ListPredictorBacktestExportJobsCommandOutput extends ListPredic
10
10
  /**
11
11
  * <p>Returns a list of predictor backtest export jobs created using the <a>CreatePredictorBacktestExportJob</a> operation. This operation returns a
12
12
  * summary for each backtest export job. You can filter the list using an array of <a>Filter</a> objects.</p>
13
- * <p>To retrieve the complete set of properties for a particular backtest export job, use
13
+ * <p>To retrieve the complete set of properties for a particular backtest export job, use
14
14
  * the ARN with the <a>DescribePredictorBacktestExportJob</a> operation.</p>
15
15
  * @example
16
16
  * Use a bare-bones client and the command you need to make an API call.
@@ -12,7 +12,7 @@ export declare const resolveClientEndpointParameters: <T>(options: T & ClientInp
12
12
  defaultSigningName: string;
13
13
  };
14
14
  export interface EndpointParameters extends __EndpointParameters {
15
- Region?: string;
15
+ Region: string;
16
16
  UseDualStack?: boolean;
17
17
  UseFIPS?: boolean;
18
18
  Endpoint?: string;