![]() |
![]()
| ![]() |
![]()
NAMEPaws::Forecast - Perl Interface to AWS Amazon Forecast Service SYNOPSISuse Paws; my $obj = Paws->service('Forecast'); my $res = $obj->Method( Arg1 => $val1, Arg2 => [ 'V1', 'V2' ], # if Arg3 is an object, the HashRef will be used as arguments to the constructor # of the arguments type Arg3 => { Att1 => 'Val1' }, # if Arg4 is an array of objects, the HashRefs will be passed as arguments to # the constructor of the arguments type Arg4 => [ { Att1 => 'Val1' }, { Att1 => 'Val2' } ], ); DESCRIPTIONProvides APIs for creating and managing Amazon Forecast resources. For the AWS API documentation, see <https://docs.aws.amazon.com/goto/WebAPI/forecast-2018-06-26> METHODSCreateDataset
Each argument is described in detail in: Paws::Forecast::CreateDataset Returns: a Paws::Forecast::CreateDatasetResponse instance Creates an Amazon Forecast dataset. The information about the dataset that you provide helps Forecast understand how to consume the data for model training. This includes the following:
After creating a dataset, you import your training data into it and add the dataset to a dataset group. You use the dataset group to create a predictor. For more information, see howitworks-datasets-groups. To get a list of all your datasets, use the ListDatasets operation. For example Forecast datasets, see the Amazon Forecast Sample GitHub repository (https://github.com/aws-samples/amazon-forecast-samples). The "Status" of a dataset must be "ACTIVE" before you can import training data. Use the DescribeDataset operation to get the status. CreateDatasetGroup
Each argument is described in detail in: Paws::Forecast::CreateDatasetGroup Returns: a Paws::Forecast::CreateDatasetGroupResponse instance Creates a dataset group, which holds a collection of related datasets. You can add datasets to the dataset group when you create the dataset group, or later by using the UpdateDatasetGroup operation. After creating a dataset group and adding datasets, you use the dataset group when you create a predictor. For more information, see howitworks-datasets-groups. To get a list of all your datasets groups, use the ListDatasetGroups operation. The "Status" of a dataset group must be "ACTIVE" before you can use the dataset group to create a predictor. To get the status, use the DescribeDatasetGroup operation. CreateDatasetImportJob
Each argument is described in detail in: Paws::Forecast::CreateDatasetImportJob Returns: a Paws::Forecast::CreateDatasetImportJobResponse instance Imports your training data to an Amazon Forecast dataset. You provide the location of your training data in an Amazon Simple Storage Service (Amazon S3) bucket and the Amazon Resource Name (ARN) of the dataset that you want to import the data to. You must specify a DataSource object that includes an AWS Identity and Access Management (IAM) role that Amazon Forecast can assume to access the data, as Amazon Forecast makes a copy of your data and processes it in an internal AWS system. For more information, see aws-forecast-iam-roles. The training data must be in CSV format. The delimiter must be a comma (,). You can specify the path to a specific CSV file, the S3 bucket, or to a folder in the S3 bucket. For the latter two cases, Amazon Forecast imports all files up to the limit of 10,000 files. Because dataset imports are not aggregated, your most recent dataset import is the one that is used when training a predictor or generating a forecast. Make sure that your most recent dataset import contains all of the data you want to model off of, and not just the new data collected since the previous import. To get a list of all your dataset import jobs, filtered by specified criteria, use the ListDatasetImportJobs operation. CreateForecast
Each argument is described in detail in: Paws::Forecast::CreateForecast Returns: a Paws::Forecast::CreateForecastResponse instance Creates a forecast for each item in the "TARGET_TIME_SERIES" dataset that was used to train the predictor. This is known as inference. To retrieve the forecast for a single item at low latency, use the operation. To export the complete forecast into your Amazon Simple Storage Service (Amazon S3) bucket, use the CreateForecastExportJob operation. The range of the forecast is determined by the "ForecastHorizon" value, which you specify in the CreatePredictor request. When you query a forecast, you can request a specific date range within the forecast. To get a list of all your forecasts, use the ListForecasts operation. The forecasts generated by Amazon Forecast are in the same time zone as the dataset that was used to create the predictor. For more information, see howitworks-forecast. The "Status" of the forecast must be "ACTIVE" before you can query or export the forecast. Use the DescribeForecast operation to get the status. CreateForecastExportJob
Each argument is described in detail in: Paws::Forecast::CreateForecastExportJob Returns: a Paws::Forecast::CreateForecastExportJobResponse instance Exports a forecast created by the CreateForecast operation to your Amazon Simple Storage Service (Amazon S3) bucket. The forecast file name will match the following conventions: <ForecastExportJobName>_<ExportTimestamp>_<PartNumber> where the <ExportTimestamp> component is in Java SimpleDateFormat (yyyy-MM-ddTHH-mm-ssZ). You must specify a DataDestination object that includes an AWS Identity and Access Management (IAM) role that Amazon Forecast can assume to access the Amazon S3 bucket. For more information, see aws-forecast-iam-roles. For more information, see howitworks-forecast. To get a list of all your forecast export jobs, use the ListForecastExportJobs operation. The "Status" of the forecast export job must be "ACTIVE" before you can access the forecast in your Amazon S3 bucket. To get the status, use the DescribeForecastExportJob operation. CreatePredictor
Each argument is described in detail in: Paws::Forecast::CreatePredictor Returns: a Paws::Forecast::CreatePredictorResponse instance Creates an Amazon Forecast predictor. In the request, provide a dataset group and either specify an algorithm or let Amazon Forecast choose an algorithm for you using AutoML. If you specify an algorithm, you also can override algorithm-specific hyperparameters. Amazon Forecast uses the algorithm to train a predictor using the latest version of the datasets in the specified dataset group. You can then generate a forecast using the CreateForecast operation. To see the evaluation metrics, use the GetAccuracyMetrics operation. You can specify a featurization configuration to fill and aggregate the data fields in the "TARGET_TIME_SERIES" dataset to improve model training. For more information, see FeaturizationConfig. For RELATED_TIME_SERIES datasets, "CreatePredictor" verifies that the "DataFrequency" specified when the dataset was created matches the "ForecastFrequency". TARGET_TIME_SERIES datasets don't have this restriction. Amazon Forecast also verifies the delimiter and timestamp format. For more information, see howitworks-datasets-groups. By default, predictors are trained and evaluated at the 0.1 (P10), 0.5 (P50), and 0.9 (P90) quantiles. You can choose custom forecast types to train and evaluate your predictor by setting the "ForecastTypes". AutoML If you want Amazon Forecast to evaluate each algorithm and choose the one that minimizes the "objective function", set "PerformAutoML" to "true". The "objective function" is defined as the mean of the weighted losses over the forecast types. By default, these are the p10, p50, and p90 quantile losses. For more information, see EvaluationResult. When AutoML is enabled, the following properties are disallowed:
To get a list of all of your predictors, use the ListPredictors operation. Before you can use the predictor to create a forecast, the "Status" of the predictor must be "ACTIVE", signifying that training has completed. To get the status, use the DescribePredictor operation. CreatePredictorBacktestExportJob
Each argument is described in detail in: Paws::Forecast::CreatePredictorBacktestExportJob Returns: a Paws::Forecast::CreatePredictorBacktestExportJobResponse instance Exports backtest forecasts and accuracy metrics generated by the CreatePredictor operation. Two folders containing CSV files are exported to your specified S3 bucket. The export file names will match the following conventions: "<ExportJobName>_<ExportTimestamp>_<PartNumber>.csv" The <ExportTimestamp> component is in Java SimpleDate format (yyyy-MM-ddTHH-mm-ssZ). You must specify a DataDestination object that includes an Amazon S3 bucket and an AWS Identity and Access Management (IAM) role that Amazon Forecast can assume to access the Amazon S3 bucket. For more information, see aws-forecast-iam-roles. The "Status" of the export job must be "ACTIVE" before you can access the export in your Amazon S3 bucket. To get the status, use the DescribePredictorBacktestExportJob operation. DeleteDatasetEach argument is described in detail in: Paws::Forecast::DeleteDataset Returns: nothing Deletes an Amazon Forecast dataset that was created using the CreateDataset operation. You can only delete datasets that have a status of "ACTIVE" or "CREATE_FAILED". To get the status use the DescribeDataset operation. Forecast does not automatically update any dataset groups that contain the deleted dataset. In order to update the dataset group, use the operation, omitting the deleted dataset's ARN. DeleteDatasetGroupEach argument is described in detail in: Paws::Forecast::DeleteDatasetGroup Returns: nothing Deletes a dataset group created using the CreateDatasetGroup operation. You can only delete dataset groups that have a status of "ACTIVE", "CREATE_FAILED", or "UPDATE_FAILED". To get the status, use the DescribeDatasetGroup operation. This operation deletes only the dataset group, not the datasets in the group. DeleteDatasetImportJobEach argument is described in detail in: Paws::Forecast::DeleteDatasetImportJob Returns: nothing Deletes a dataset import job created using the CreateDatasetImportJob operation. You can delete only dataset import jobs that have a status of "ACTIVE" or "CREATE_FAILED". To get the status, use the DescribeDatasetImportJob operation. DeleteForecastEach argument is described in detail in: Paws::Forecast::DeleteForecast Returns: nothing Deletes a forecast created using the CreateForecast operation. You can delete only forecasts that have a status of "ACTIVE" or "CREATE_FAILED". To get the status, use the DescribeForecast operation. You can't delete a forecast while it is being exported. After a forecast is deleted, you can no longer query the forecast. DeleteForecastExportJobEach argument is described in detail in: Paws::Forecast::DeleteForecastExportJob Returns: nothing Deletes a forecast export job created using the CreateForecastExportJob operation. You can delete only export jobs that have a status of "ACTIVE" or "CREATE_FAILED". To get the status, use the DescribeForecastExportJob operation. DeletePredictorEach argument is described in detail in: Paws::Forecast::DeletePredictor Returns: nothing Deletes a predictor created using the CreatePredictor operation. You can delete only predictor that have a status of "ACTIVE" or "CREATE_FAILED". To get the status, use the DescribePredictor operation. DeletePredictorBacktestExportJobEach argument is described in detail in: Paws::Forecast::DeletePredictorBacktestExportJob Returns: nothing Deletes a predictor backtest export job. DeleteResourceTreeEach argument is described in detail in: Paws::Forecast::DeleteResourceTree Returns: nothing Deletes an entire resource tree. This operation will delete the parent resource and its child resources. Child resources are resources that were created from another resource. For example, when a forecast is generated from a predictor, the forecast is the child resource and the predictor is the parent resource. Amazon Forecast resources possess the following parent-child resource hierarchies:
"DeleteResourceTree" will only delete Amazon Forecast resources, and will not delete datasets or exported files stored in Amazon S3. DescribeDatasetEach argument is described in detail in: Paws::Forecast::DescribeDataset Returns: a Paws::Forecast::DescribeDatasetResponse instance Describes an Amazon Forecast dataset created using the CreateDataset operation. In addition to listing the parameters specified in the "CreateDataset" request, this operation includes the following dataset properties:
DescribeDatasetGroupEach argument is described in detail in: Paws::Forecast::DescribeDatasetGroup Returns: a Paws::Forecast::DescribeDatasetGroupResponse instance Describes a dataset group created using the CreateDatasetGroup operation. In addition to listing the parameters provided in the "CreateDatasetGroup" request, this operation includes the following properties:
DescribeDatasetImportJobEach argument is described in detail in: Paws::Forecast::DescribeDatasetImportJob Returns: a Paws::Forecast::DescribeDatasetImportJobResponse instance Describes a dataset import job created using the CreateDatasetImportJob operation. In addition to listing the parameters provided in the "CreateDatasetImportJob" request, this operation includes the following properties:
DescribeForecastEach argument is described in detail in: Paws::Forecast::DescribeForecast Returns: a Paws::Forecast::DescribeForecastResponse instance Describes a forecast created using the CreateForecast operation. In addition to listing the properties provided in the "CreateForecast" request, this operation lists the following properties:
DescribeForecastExportJobEach argument is described in detail in: Paws::Forecast::DescribeForecastExportJob Returns: a Paws::Forecast::DescribeForecastExportJobResponse instance Describes a forecast export job created using the CreateForecastExportJob operation. In addition to listing the properties provided by the user in the "CreateForecastExportJob" request, this operation lists the following properties:
DescribePredictorEach argument is described in detail in: Paws::Forecast::DescribePredictor Returns: a Paws::Forecast::DescribePredictorResponse instance Describes a predictor created using the CreatePredictor operation. In addition to listing the properties provided in the "CreatePredictor" request, this operation lists the following properties:
DescribePredictorBacktestExportJobEach argument is described in detail in: Paws::Forecast::DescribePredictorBacktestExportJob Returns: a Paws::Forecast::DescribePredictorBacktestExportJobResponse instance Describes a predictor backtest export job created using the CreatePredictorBacktestExportJob operation. In addition to listing the properties provided by the user in the "CreatePredictorBacktestExportJob" request, this operation lists the following properties:
GetAccuracyMetricsEach argument is described in detail in: Paws::Forecast::GetAccuracyMetrics Returns: a Paws::Forecast::GetAccuracyMetricsResponse instance Provides metrics on the accuracy of the models that were trained by the CreatePredictor operation. Use metrics to see how well the model performed and to decide whether to use the predictor to generate a forecast. For more information, see Predictor Metrics (https://docs.aws.amazon.com/forecast/latest/dg/metrics.html). This operation generates metrics for each backtest window that was evaluated. The number of backtest windows ("NumberOfBacktestWindows") is specified using the EvaluationParameters object, which is optionally included in the "CreatePredictor" request. If "NumberOfBacktestWindows" isn't specified, the number defaults to one. The parameters of the "filling" method determine which items contribute to the metrics. If you want all items to contribute, specify "zero". If you want only those items that have complete data in the range being evaluated to contribute, specify "nan". For more information, see FeaturizationMethod. Before you can get accuracy metrics, the "Status" of the predictor must be "ACTIVE", signifying that training has completed. To get the status, use the DescribePredictor operation. ListDatasetGroups
Each argument is described in detail in: Paws::Forecast::ListDatasetGroups Returns: a Paws::Forecast::ListDatasetGroupsResponse instance Returns a list of dataset groups created using the CreateDatasetGroup operation. For each dataset group, this operation returns a summary of its properties, including its Amazon Resource Name (ARN). You can retrieve the complete set of properties by using the dataset group ARN with the DescribeDatasetGroup operation. ListDatasetImportJobs
Each argument is described in detail in: Paws::Forecast::ListDatasetImportJobs Returns: a Paws::Forecast::ListDatasetImportJobsResponse instance Returns a list of dataset import jobs created using the CreateDatasetImportJob operation. For each import job, this operation returns a summary of its properties, including its Amazon Resource Name (ARN). You can retrieve the complete set of properties by using the ARN with the DescribeDatasetImportJob operation. You can filter the list by providing an array of Filter objects. ListDatasets
Each argument is described in detail in: Paws::Forecast::ListDatasets Returns: a Paws::Forecast::ListDatasetsResponse instance Returns a list of datasets created using the CreateDataset operation. For each dataset, a summary of its properties, including its Amazon Resource Name (ARN), is returned. To retrieve the complete set of properties, use the ARN with the DescribeDataset operation. ListForecastExportJobs
Each argument is described in detail in: Paws::Forecast::ListForecastExportJobs Returns: a Paws::Forecast::ListForecastExportJobsResponse instance Returns a list of forecast export jobs created using the CreateForecastExportJob operation. For each forecast export job, this operation returns a summary of its properties, including its Amazon Resource Name (ARN). To retrieve the complete set of properties, use the ARN with the DescribeForecastExportJob operation. You can filter the list using an array of Filter objects. ListForecasts
Each argument is described in detail in: Paws::Forecast::ListForecasts Returns: a Paws::Forecast::ListForecastsResponse instance Returns a list of forecasts created using the CreateForecast operation. For each forecast, this operation returns a summary of its properties, including its Amazon Resource Name (ARN). To retrieve the complete set of properties, specify the ARN with the DescribeForecast operation. You can filter the list using an array of Filter objects. ListPredictorBacktestExportJobs
Each argument is described in detail in: Paws::Forecast::ListPredictorBacktestExportJobs Returns: a Paws::Forecast::ListPredictorBacktestExportJobsResponse instance Returns a list of predictor backtest export jobs created using the CreatePredictorBacktestExportJob operation. This operation returns a summary for each backtest export job. You can filter the list using an array of Filter objects. To retrieve the complete set of properties for a particular backtest export job, use the ARN with the DescribePredictorBacktestExportJob operation. ListPredictors
Each argument is described in detail in: Paws::Forecast::ListPredictors Returns: a Paws::Forecast::ListPredictorsResponse instance Returns a list of predictors created using the CreatePredictor operation. For each predictor, this operation returns a summary of its properties, including its Amazon Resource Name (ARN). You can retrieve the complete set of properties by using the ARN with the DescribePredictor operation. You can filter the list using an array of Filter objects. ListTagsForResourceEach argument is described in detail in: Paws::Forecast::ListTagsForResource Returns: a Paws::Forecast::ListTagsForResourceResponse instance Lists the tags for an Amazon Forecast resource. StopResourceEach argument is described in detail in: Paws::Forecast::StopResource Returns: nothing Stops a resource. The resource undergoes the following states: "CREATE_STOPPING" and "CREATE_STOPPED". You cannot resume a resource once it has been stopped. This operation can be applied to the following resources (and their corresponding child resources):
TagResourceEach argument is described in detail in: Paws::Forecast::TagResource Returns: a Paws::Forecast::TagResourceResponse instance Associates the specified tags to a resource with the specified "resourceArn". If existing tags on a resource are not specified in the request parameters, they are not changed. When a resource is deleted, the tags associated with that resource are also deleted. UntagResourceEach argument is described in detail in: Paws::Forecast::UntagResource Returns: a Paws::Forecast::UntagResourceResponse instance Deletes the specified tags from a resource. UpdateDatasetGroupEach argument is described in detail in: Paws::Forecast::UpdateDatasetGroup Returns: a Paws::Forecast::UpdateDatasetGroupResponse instance Replaces the datasets in a dataset group with the specified datasets. The "Status" of the dataset group must be "ACTIVE" before you can use the dataset group to create a predictor. Use the DescribeDatasetGroup operation to get the status. PAGINATORSPaginator methods are helpers that repetively call methods that return partial results ListAllDatasetGroups(sub { },[MaxResults => Int, NextToken => Str])ListAllDatasetGroups([MaxResults => Int, NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - DatasetGroups, passing the object as the first parameter, and the string 'DatasetGroups' as the second parameter If not, it will return a a Paws::Forecast::ListDatasetGroupsResponse instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. ListAllDatasetImportJobs(sub { },[Filters => ArrayRef[Paws::Forecast::Filter], MaxResults => Int, NextToken => Str])ListAllDatasetImportJobs([Filters => ArrayRef[Paws::Forecast::Filter], MaxResults => Int, NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - DatasetImportJobs, passing the object as the first parameter, and the string 'DatasetImportJobs' as the second parameter If not, it will return a a Paws::Forecast::ListDatasetImportJobsResponse instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. ListAllDatasets(sub { },[MaxResults => Int, NextToken => Str])ListAllDatasets([MaxResults => Int, NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - Datasets, passing the object as the first parameter, and the string 'Datasets' as the second parameter If not, it will return a a Paws::Forecast::ListDatasetsResponse instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. ListAllForecastExportJobs(sub { },[Filters => ArrayRef[Paws::Forecast::Filter], MaxResults => Int, NextToken => Str])ListAllForecastExportJobs([Filters => ArrayRef[Paws::Forecast::Filter], MaxResults => Int, NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - ForecastExportJobs, passing the object as the first parameter, and the string 'ForecastExportJobs' as the second parameter If not, it will return a a Paws::Forecast::ListForecastExportJobsResponse instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. ListAllForecasts(sub { },[Filters => ArrayRef[Paws::Forecast::Filter], MaxResults => Int, NextToken => Str])ListAllForecasts([Filters => ArrayRef[Paws::Forecast::Filter], MaxResults => Int, NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - Forecasts, passing the object as the first parameter, and the string 'Forecasts' as the second parameter If not, it will return a a Paws::Forecast::ListForecastsResponse instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. ListAllPredictorBacktestExportJobs(sub { },[Filters => ArrayRef[Paws::Forecast::Filter], MaxResults => Int, NextToken => Str])ListAllPredictorBacktestExportJobs([Filters => ArrayRef[Paws::Forecast::Filter], MaxResults => Int, NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - PredictorBacktestExportJobs, passing the object as the first parameter, and the string 'PredictorBacktestExportJobs' as the second parameter If not, it will return a a Paws::Forecast::ListPredictorBacktestExportJobsResponse instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. ListAllPredictors(sub { },[Filters => ArrayRef[Paws::Forecast::Filter], MaxResults => Int, NextToken => Str])ListAllPredictors([Filters => ArrayRef[Paws::Forecast::Filter], MaxResults => Int, NextToken => Str])If passed a sub as first parameter, it will call the sub for each element found in : - Predictors, passing the object as the first parameter, and the string 'Predictors' as the second parameter If not, it will return a a Paws::Forecast::ListPredictorsResponse instance with all the "param"s; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory. SEE ALSOThis service class forms part of Paws BUGS and CONTRIBUTIONSThe source code is located here: <https://github.com/pplu/aws-sdk-perl> Please report bugs to: <https://github.com/pplu/aws-sdk-perl/issues>
|