Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
CreateForecast
Crea una previsión para cada artículo en el conjunto de datos de TARGET_TIME_SERIES que se utilizó para entrenar el predictor. Esto se conoce como inferencia. Para recuperar la previsión de un solo artículo con una latencia baja, utilice la operación QueryForecast. Para exportar la previsión completa a su bucket de Amazon Simple Storage Service (Amazon S3), utilice la operación CreateForecastExportJob.
El rango de la previsión viene determinado por el valor de ForecastHorizon que especifique en la solicitud CreatePredictor. Al consultar una previsión, puede solicitar un intervalo de fechas específico dentro de la previsión.
Para obtener una lista de todas sus previsiones, utilice la operación ListForecasts.
nota
Las previsiones generadas por Amazon Forecast se encuentran en la misma zona horaria que el conjunto de datos que se utilizó para crear el predictor.
Para obtener más información, consulte Generación de previsiones.
nota
El Status de la previsión debe ser ACTIVE antes de poder consultarla o exportarla. Utilice la operación DescribeForecast para obtener el estado.
De forma predeterminada, una previsión incluye predicciones para cada artículo (item_id) del grupo de conjuntos de datos que se utilizó para entrenar el predictor. Sin embargo, puede usar el objeto TimeSeriesSelector para generar una previsión en un subconjunto de series temporales. La creación de previsiones se omite para cualquier serie temporal que especifique y que no esté en el conjunto de datos de entrada. El archivo de exportación de previsiones no contendrá estas series temporales ni sus valores previstos.
Sintaxis de la solicitud
{
"ForecastName": "string",
"ForecastTypes": [ "string" ],
"PredictorArn": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"TimeSeriesSelector": {
"TimeSeriesIdentifiers": {
"DataSource": {
"S3Config": {
"KMSKeyArn": "string",
"Path": "string",
"RoleArn": "string"
}
},
"Format": "string",
"Schema": {
"Attributes": [
{
"AttributeName": "string",
"AttributeType": "string"
}
]
}
}
}
}Parámetros de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- ForecastName
-
Un nombre para la previsión.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63.
Patrón:
^[a-zA-Z][a-zA-Z0-9_]*Obligatorio: sí
- ForecastTypes
-
Los cuantiles en los que se generan las previsiones probabilísticas. Actualmente, puede especificar hasta 5 cuantiles por previsión. Los valores aceptados incluyen
0.01 to 0.99(solo incrementos de 0,01) ymean. La previsión media es diferente de la mediana (0,50) cuando la distribución no es simétrica (por ejemplo, beta y binomial negativo).Los cuantiles predeterminados son los cuantiles que especificó durante la creación del predictor. Si no especificó los cuantiles, los valores predeterminados son
["0.1", "0.5", "0.9"].Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 20 artículos.
Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 4 caracteres.
Patrón:
(^0?\.\d\d?$|^mean$)Obligatorio: no
- PredictorArn
-
El nombre de recurso de Amazon (ARN) del predictor que se va a utilizar para generar la previsión.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):forecast:.*:.*:.+Obligatorio: sí
- Tags
-
Los metadatos opcionales que se aplican a la previsión para ayudarle a categorizarlas y organizarlas. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario.
Se aplican las siguientes restricciones básicas a las etiquetas:
-
Número máximo de etiquetas por recurso: 50.
-
Para cada recurso, cada clave de etiqueta debe ser única y solo puede tener un valor.
-
Longitud máxima de la clave: 128 caracteres Unicode en UTF-8
-
Longitud máxima del valor: 256 caracteres Unicode en UTF-8
-
Si se utiliza su esquema de etiquetado en múltiples servicios y recursos, recuerde que otros servicios pueden tener otras restricciones sobre caracteres permitidos. Los caracteres permitidos generalmente son: letras, números y espacios representables en UTF-8, además de los siguientes caracteres: + - = . _ : / @.
-
Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.
-
No utilice
aws:AWS:, ni ninguna combinación de mayúsculas o minúsculas, como un prefijo para las teclas, ya que está reservado para su uso. AWS Las claves de etiquetas que tienen este prefijo no se pueden editar ni eliminar. Los valores pueden tener este prefijo. Si el valor de una etiqueta tieneawscomo prefijo pero la clave no, Forecast la considera una etiqueta de usuario y se contabilizará en el límite de 50 etiquetas. Las etiquetas que tengan solo el prefijo de clave deawsno cuentan para el límite de etiquetas por recurso.
Tipo: matriz de objetos Tag
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.
Obligatorio: no
-
- TimeSeriesSelector
-
Define el conjunto de series temporales que se utilizan para crear las previsiones en un objeto
TimeSeriesIdentifiers.El objeto
TimeSeriesIdentifiersnecesita la siguiente información:-
DataSource -
Format -
Schema
Tipo: objeto TimeSeriesSelector
Obligatorio: no
-
Sintaxis de la respuesta
{
"ForecastArn": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- ForecastArn
-
El nombre de recurso de Amazon (ARN) de la previsión.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):forecast:.*:.*:.+
Errores
- InvalidInputException
-
No podemos procesar la solicitud porque incluye un valor no válido o un valor que supera el rango válido.
Código de estado HTTP: 400
- LimitExceededException
-
Se ha superado el límite en el número de recursos por cuenta.
Código de estado HTTP: 400
- ResourceAlreadyExistsException
-
Ya existe un recurso con este nombre. Inténtelo de nuevo con un nombre diferente.
Código de estado HTTP: 400
- ResourceInUseException
-
El recurso especificado está en uso.
Código de estado HTTP: 400
- ResourceNotFoundException
-
No podemos encontrar un recurso con ese nombre de recurso de Amazon (ARN). Compruebe el ARN e inténtelo de nuevo.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente:
