CreateAutoPredictor

Crea un predictor de Amazon Forecast.

importante

Amazon Forecast ya no está disponible para nuevos clientes. Los clientes actuales de Amazon Forecast pueden seguir utilizando el servicio con normalidad. Más información

Amazon Forecast crea predictores con AutoPredictor, lo que implica aplicar la combinación óptima de algoritmos a cada serie temporal de sus conjuntos de datos. Puede utilizar CreateAutoPredictor para crear nuevos predictores o actualizar o volver a entrenar los predictores existentes.

Creación de predictores nuevos

Se requieren los siguientes parámetros al crear un predictor nuevo:

• PredictorName: un nombre único para el predictor.

• DatasetGroupArn- El del grupo ARN de conjuntos de datos utilizado para entrenar el predictor.

• ForecastFrequency: la granularidad de sus previsiones (por hora, por día, por semana, etc.).

• ForecastHorizon: el número de pasos de tiempo que el modelo predice. El horizonte de previsión también se denomina longitud de predicción.

Al crear un nuevo predictor, no especifique un valor para ReferencePredictorArn.

Actualización y reentrenamiento de los predictores

Se requieren los siguientes parámetros al volver a entrenar o actualizar un predictor:

• PredictorName: un nombre único para el predictor.

• ReferencePredictorArn- El ARN del predictor que se va a volver a entrenar o actualizar.

Al actualizar o volver a entrenar un predictor, especifique únicamente los valores de ReferencePredictorArn y PredictorName.

Sintaxis de la solicitud

{
   "DataConfig": { 
      "AdditionalDatasets": [ 
         { 
            "Configuration": { 
               "string" : [ "string" ]
            },
            "Name": "string"
         }
      ],
      "AttributeConfigs": [ 
         { 
            "AttributeName": "string",
            "Transformations": { 
               "string" : "string" 
            }
         }
      ],
      "DatasetGroupArn": "string"
   },
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "ExplainPredictor": boolean,
   "ForecastDimensions": [ "string" ],
   "ForecastFrequency": "string",
   "ForecastHorizon": number,
   "ForecastTypes": [ "string" ],
   "MonitorConfig": { 
      "MonitorName": "string"
   },
   "OptimizationMetric": "string",
   "PredictorName": "string",
   "ReferencePredictorArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeAlignmentBoundary": { 
      "DayOfMonth": number,
      "DayOfWeek": "string",
      "Hour": number,
      "Month": "string"
   }
}

Parámetros de la solicitud

La solicitud acepta los siguientes datos en JSON formato.

DataConfig

La configuración de datos de su grupo de conjuntos de datos y de cualquier conjunto de datos adicional.

Tipo: objeto DataConfig

Obligatorio: no

EncryptionConfig

Una clave AWS Key Management Service (KMS) y una función AWS Identity and Access Management (IAM) que Amazon Forecast puede asumir para acceder a la clave. Puede especificar este objeto opcional en las solicitudes CreateDataset y CreatePredictor.

Tipo: objeto EncryptionConfig

Obligatorio: no

ExplainPredictor

Cree un recurso de Explicabilidad para el predictor.

Tipo: Booleano

Obligatorio: no

ForecastDimensions

Una matriz de nombres de dimensiones (campos) que especifican cómo agrupar la previsión generada.

Por ejemplo, si está generando previsiones de ventas de artículos en todas sus tiendas y su conjunto de datos contiene un campo store_id, debe especificar store_id como dimensión para agrupar las previsiones de ventas de cada tienda.

Tipo: matriz de cadenas

Miembros de la matriz: número mínimo de 1 artículo. Número máximo de 10 artículos.

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: no

ForecastFrequency

La frecuencia de las predicciones de una previsión.

Los intervalos válidos son un número entero seguido de Y (año), M (mes), W (semana), D (día), H (hora) y min (minuto). Por ejemplo, “1D” indica todos los días y “15min” indica cada 15 minutos. No puede especificar un valor que se superponga con la siguiente frecuencia mayor. Esto significa, por ejemplo, que no puede especificar una frecuencia de 60 minutos, porque equivale a 1 hora. Los valores válidos de cada frecuencia son los siguientes:

• Minuto: de 1 a 59

• Hora: de 1 a 23

• Día: de 1 a 6

• Semana: de 1 a 4

• Mes: de 1 a 11

• Año: 1

Por lo tanto, si desea previsiones cada dos semanas, especifique “2W”. O, si desea previsiones trimestrales, especifique “3M”.

La frecuencia debe ser mayor o igual a la frecuencia del SERIES conjunto de datos TARGET TIME _ _.

Cuando se proporciona un SERIES conjunto de datos RELATED TIME _ _, la frecuencia debe ser igual a la frecuencia del SERIES conjunto de datos RELATED TIME _ _.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 5.

Patrón: ^Y|M|W|D|H|30min|15min|10min|5min|1min$

Obligatorio: no

ForecastHorizon

El número de pasos de tiempo que el modelo predice. El horizonte de previsión también se denomina longitud de predicción.

El horizonte de pronóstico máximo es el menor de los 500 intervalos de tiempo o 1/4 de la longitud del SERIES conjunto de datos TARGET _ TIME _, que sea menor. Si está reentrenando un horizonte de previsión existente AutoPredictor, el horizonte de previsión máximo es el menor de los 500 intervalos de tiempo o 1/3 de la longitud del conjunto de datos TARGET _ TIME _SERIES, que sea menor.

Si va a actualizar a uno existente AutoPredictor o a volver a entrenarlo AutoPredictor, no podrá actualizar el parámetro del horizonte de previsión. Puede cumplir con este requisito proporcionando series temporales más largas en el conjunto de datos.

Tipo: entero

Obligatorio: no

ForecastTypes

Los tipos de previsión usados para entrenar un predictor. Puede especificar hasta cinco tipos de previsión. Los tipos de previsión pueden ser cuantiles de 0,01 a 0,99, por incrementos de 0,01 o más. También puede especificar la previsión media con mean.

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

MonitorConfig

Los detalles de configuración para la supervisión de los predictores. Proporcione un nombre para el recurso de monitor con el fin de habilitar la supervisión del predictor.

La supervisión del predictor le permite ver cómo cambia el rendimiento de su predictor a lo largo del tiempo. Para obtener más información, consulte Supervisión del predictor.

Tipo: objeto MonitorConfig

Obligatorio: no

OptimizationMetric

La métrica de precisión utilizada para optimizar el predictor.

Tipo: cadena

Valores válidos: WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE

Obligatorio: no

PredictorName

Un nombre único para el predictor

Tipo: cadena

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í

ReferencePredictorArn

El ARN del predictor que se va a volver a entrenar o actualizar. Este parámetro solo se usa al volver a entrenar o actualizar un predictor. Al crear un nuevo predictor, no especifique un valor para este parámetro.

Al actualizar o volver a entrenar un predictor, especifique únicamente los valores de ReferencePredictorArn y PredictorName. El valor de PredictorName debe ser un nombre de predictor único.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 256.

Patrón: arn:([a-z\d-]+):forecast:.*:.*:.+

Obligatorio: no

Tags

Los metadatos opcionales le ayudan a categorizar y organizar sus predictores. Cada etiqueta está formada por una clave y un valor opcional, ambos definidos por el usuario. Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.

Se aplican las siguientes restricciones a las etiquetas:

• Para cada recurso, cada clave de etiqueta debe ser única y solo debe tener un valor.

• Número máximo de etiquetas por recurso: 50

• Longitud máxima de clave: 128 caracteres Unicode en -8. UTF

• Longitud máxima del valor: 256 caracteres Unicode en UTF -8.

• Caracteres aceptados: todas las letras y números, los espacios se pueden representar en UTF -8 y + - =. _ : / @. Si se utiliza el esquema de etiquetado en otros servicios y recursos, también se aplican las limitaciones de caracteres de dichos servicios.

• Los prefijos clave no pueden incluir ninguna combinación en mayúsculas o minúsculas de aws: o AWS:. Los valores pueden tener este prefijo. Si el valor de una etiqueta tiene aws como 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 de aws no cuentan para el límite de etiquetas por recurso. Las claves de etiquetas que tienen este prefijo no se pueden editar ni eliminar.

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

TimeAlignmentBoundary

El límite de tiempo que Forecast utiliza para alinear y agregar cualquier dato que no se alinee con la frecuencia de su previsión. Proporcione la unidad de tiempo y el límite de tiempo como un par clave-valor. Para obtener más información sobre cómo especificar un límite de tiempo, consulte Especificación de un límite de tiempo. Si no proporciona un límite de tiempo, Forecast utiliza un conjunto de límites de tiempo predeterminados.

Tipo: objeto TimeAlignmentBoundary

Obligatorio: no

Sintaxis de la respuesta

{
   "PredictorArn": "string"
}

Elementos de respuesta

Si la acción se realiza correctamente, el servicio envía una respuesta de HTTP 200.

El servicio devuelve los siguientes datos en JSON formato.

PredictorArn

El nombre del recurso de Amazon (ARN) del predictor.

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.

HTTPCódigo de estado: 400

LimitExceededException

Se ha superado el límite en el número de recursos por cuenta.

HTTPCódigo de estado: 400

ResourceAlreadyExistsException

Ya existe un recurso con este nombre. Inténtelo de nuevo con un nombre diferente.

HTTPCódigo de estado: 400

ResourceInUseException

El recurso especificado está en uso.

HTTPCódigo de estado: 400

ResourceNotFoundException

No podemos encontrar un recurso con ese nombre de recurso de Amazon (ARN). Compruebe ARN y vuelva a intentarlo.

HTTPCódigo de estado: 400

Véase también

Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:

• Interfaz de la línea de comandos de AWS

• AWS SDKpara. NET

• AWS SDKpara C++

• AWS SDKpara Go v2

• AWS SDKpara Java V2

• AWS SDKpara JavaScript V3

• AWS SDKpara PHP V3

• AWS SDKpara Python

• AWS SDKpara Ruby V3