AWS CLI Command Reference

[ aws . forecast ]

describe-auto-predictor

Description

Describes a predictor created using the CreateAutoPredictor operation.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  describe-auto-predictor
--predictor-arn <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--predictor-arn (string)

The Amazon Resource Name (ARN) of the predictor.

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Output

PredictorArn -> (string)

The Amazon Resource Name (ARN) of the predictor

PredictorName -> (string)

The name of the predictor.

ForecastHorizon -> (integer)

The number of time-steps that the model predicts. The forecast horizon is also called the prediction length.

ForecastTypes -> (list)

The forecast types used during predictor training. Default value is [“0.1”,”0.5”,”0.9”].

(string)

ForecastFrequency -> (string)

The frequency of predictions in a forecast.

Valid intervals are Y (Year), M (Month), W (Week), D (Day), H (Hour), 30min (30 minutes), 15min (15 minutes), 10min (10 minutes), 5min (5 minutes), and 1min (1 minute). For example, “Y” indicates every year and “5min” indicates every five minutes.

ForecastDimensions -> (list)

An array of dimension (field) names that specify the attributes used to group your time series.

(string)

DatasetImportJobArns -> (list)

An array of the ARNs of the dataset import jobs used to import training data for the predictor.

(string)

DataConfig -> (structure)

The data configuration for your dataset group and any additional datasets.

DatasetGroupArn -> (string)

The ARN of the dataset group used to train the predictor.

AttributeConfigs -> (list)

Aggregation and filling options for attributes in your dataset group.

(structure)

Provides information about the method used to transform attributes.

The following is an example using the RETAIL domain:

{

"AttributeName": "demand",

"Transformations": {"aggregation": "sum", "middlefill": "zero", "backfill": "zero"}

}

AttributeName -> (string)

The name of the attribute as specified in the schema. Amazon Forecast supports the target field of the target time series and the related time series datasets. For example, for the RETAIL domain, the target is demand .

Transformations -> (map)

The method parameters (key-value pairs), which are a map of override parameters. Specify these parameters to override the default values. Related Time Series attributes do not accept aggregation parameters.

The following list shows the parameters and their valid values for the “filling” featurization method for a Target Time Series dataset. Default values are bolded.

  • aggregation : sum , avg , first , min , max

  • frontfill : none

  • middlefill : zero , nan (not a number), value , median , mean , min , max

  • backfill : zero , nan , value , median , mean , min , max

The following list shows the parameters and their valid values for a Related Time Series featurization method (there are no defaults):

  • middlefill : zero , value , median , mean , min , max

  • backfill : zero , value , median , mean , min , max

  • futurefill : zero , value , median , mean , min , max

To set a filling method to a specific value, set the fill parameter to value and define the value in a corresponding _value parameter. For example, to set backfilling to a value of 2, include the following: "backfill": "value" and "backfill_value":"2" .

key -> (string)

value -> (string)

AdditionalDatasets -> (list)

Additional built-in datasets like Holidays and the Weather Index.

(structure)

Describes an additional dataset. This object is part of the DataConfig object. Forecast supports the Weather Index and Holidays additional datasets.

Weather Index

The Amazon Forecast Weather Index is a built-in dataset that incorporates historical and projected weather information into your model. The Weather Index supplements your datasets with over two years of historical weather data and up to 14 days of projected weather data. For more information, see Amazon Forecast Weather Index .

Holidays

Holidays is a built-in dataset that incorporates national holiday information into your model. It provides native support for the holiday calendars of 66 countries. To view the holiday calendars, refer to the Jollyday library. For more information, see Holidays Featurization .

Name -> (string)

The name of the additional dataset. Valid names: "holiday" and "weather" .

Configuration -> (map)

Weather Index

To enable the Weather Index, do not specify a value for Configuration .

Holidays

Holidays

To enable Holidays, set CountryCode to one of the following two-letter country codes:

  • “AL” - ALBANIA

  • “AR” - ARGENTINA

  • “AT” - AUSTRIA

  • “AU” - AUSTRALIA

  • “BA” - BOSNIA HERZEGOVINA

  • “BE” - BELGIUM

  • “BG” - BULGARIA

  • “BO” - BOLIVIA

  • “BR” - BRAZIL

  • “BY” - BELARUS

  • “CA” - CANADA

  • “CL” - CHILE

  • “CO” - COLOMBIA

  • “CR” - COSTA RICA

  • “HR” - CROATIA

  • “CZ” - CZECH REPUBLIC

  • “DK” - DENMARK

  • “EC” - ECUADOR

  • “EE” - ESTONIA

  • “ET” - ETHIOPIA

  • “FI” - FINLAND

  • “FR” - FRANCE

  • “DE” - GERMANY

  • “GR” - GREECE

  • “HU” - HUNGARY

  • “IS” - ICELAND

  • “IN” - INDIA

  • “IE” - IRELAND

  • “IT” - ITALY

  • “JP” - JAPAN

  • “KZ” - KAZAKHSTAN

  • “KR” - KOREA

  • “LV” - LATVIA

  • “LI” - LIECHTENSTEIN

  • “LT” - LITHUANIA

  • “LU” - LUXEMBOURG

  • “MK” - MACEDONIA

  • “MT” - MALTA

  • “MX” - MEXICO

  • “MD” - MOLDOVA

  • “ME” - MONTENEGRO

  • “NL” - NETHERLANDS

  • “NZ” - NEW ZEALAND

  • “NI” - NICARAGUA

  • “NG” - NIGERIA

  • “NO” - NORWAY

  • “PA” - PANAMA

  • “PY” - PARAGUAY

  • “PE” - PERU

  • “PL” - POLAND

  • “PT” - PORTUGAL

  • “RO” - ROMANIA

  • “RU” - RUSSIA

  • “RS” - SERBIA

  • “SK” - SLOVAKIA

  • “SI” - SLOVENIA

  • “ZA” - SOUTH AFRICA

  • “ES” - SPAIN

  • “SE” - SWEDEN

  • “CH” - SWITZERLAND

  • “UA” - UKRAINE

  • “AE” - UNITED ARAB EMIRATES

  • “US” - UNITED STATES

  • “UK” - UNITED KINGDOM

  • “UY” - URUGUAY

  • “VE” - VENEZUELA

key -> (string)

value -> (list)

(string)

EncryptionConfig -> (structure)

An AWS Key Management Service (KMS) key and an AWS Identity and Access Management (IAM) role that Amazon Forecast can assume to access the key. You can specify this optional object in the CreateDataset and CreatePredictor requests.

RoleArn -> (string)

The ARN of the IAM role that Amazon Forecast can assume to access the AWS KMS key.

Passing a role across AWS accounts is not allowed. If you pass a role that isn’t in your account, you get an InvalidInputException error.

KMSKeyArn -> (string)

The Amazon Resource Name (ARN) of the KMS key.

ReferencePredictorSummary -> (structure)

The ARN and state of the reference predictor. This parameter is only valid for retrained or upgraded predictors.

Arn -> (string)

The ARN of the reference predictor.

State -> (string)

Whether the reference predictor is Active or Deleted .

EstimatedTimeRemainingInMinutes -> (long)

The estimated time remaining in minutes for the predictor training job to complete.

Status -> (string)

The status of the predictor. States include:

  • ACTIVE

  • CREATE_PENDING , CREATE_IN_PROGRESS , CREATE_FAILED

  • CREATE_STOPPING , CREATE_STOPPED

  • DELETE_PENDING , DELETE_IN_PROGRESS , DELETE_FAILED

Message -> (string)

In the event of an error, a message detailing the cause of the error.

CreationTime -> (timestamp)

The timestamp of the CreateAutoPredictor request.

LastModificationTime -> (timestamp)

The last time the resource was modified. The timestamp depends on the status of the job:

  • CREATE_PENDING - The CreationTime .

  • CREATE_IN_PROGRESS - The current timestamp.

  • CREATE_STOPPING - The current timestamp.

  • CREATE_STOPPED - When the job stopped.

  • ACTIVE or CREATE_FAILED - When the job finished or failed.

OptimizationMetric -> (string)

The accuracy metric used to optimize the predictor.

ExplainabilityInfo -> (structure)

Provides the status and ARN of the Predictor Explainability.

ExplainabilityArn -> (string)

The Amazon Resource Name (ARN) of the Explainability.

Status -> (string)

The status of the Explainability. States include:

  • ACTIVE

  • CREATE_PENDING , CREATE_IN_PROGRESS , CREATE_FAILED

  • CREATE_STOPPING , CREATE_STOPPED

  • DELETE_PENDING , DELETE_IN_PROGRESS , DELETE_FAILED

MonitorInfo -> (structure)

A object with the Amazon Resource Name (ARN) and status of the monitor resource.

MonitorArn -> (string)

The Amazon Resource Name (ARN) of the monitor resource.

Status -> (string)

The status of the monitor. States include:

  • ACTIVE

  • ACTIVE_STOPPING , ACTIVE_STOPPED

  • UPDATE_IN_PROGRESS

  • CREATE_PENDING , CREATE_IN_PROGRESS , CREATE_FAILED

  • DELETE_PENDING , DELETE_IN_PROGRESS , DELETE_FAILED

TimeAlignmentBoundary -> (structure)

The time boundary Forecast uses when aggregating data.

Month -> (string)

The month to use for time alignment during aggregation. The month must be in uppercase.

DayOfMonth -> (integer)

The day of the month to use for time alignment during aggregation.

DayOfWeek -> (string)

The day of week to use for time alignment during aggregation. The day must be in uppercase.

Hour -> (integer)

The hour of day to use for time alignment during aggregation.

© Copyright 2018, Amazon Web Services. Created using Sphinx.