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.
CreateAutoPredictor
Crea un predictor de Amazon Forecast.
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 ARN del grupo 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 formato JSON.
- 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 especificarstore_idcomo 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 mayor o igual que la frecuencia del conjunto de datos TARGET_TIME_SERIES.
Cuando se proporciona un conjunto de datos RELATED_TIME_SERIES, la frecuencia debe ser igual a la frecuencia del conjunto de datos RELATED_TIME_SERIES.
Tipo: string
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 máximo de previsión es 500 pasos de tiempo o 1/4 de la longitud del conjunto de datos TARGET_TIME_SERIES (el valor más pequeño). Si está reentrenando uno ya existente AutoPredictor, el horizonte de previsión máximo será 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 | MAPEObligatorio: no
- PredictorName
-
Un nombre único para el predictor
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í
- 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
ReferencePredictorArnyPredictorName. El valor dePredictorNamedebe 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 la clave: 128 caracteres Unicode en UTF-8
-
Longitud máxima del valor: 256 caracteres Unicode en UTF-8
-
Los caracteres aceptados son letras y números, espacios representables 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:oAWS:. 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. 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 devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- PredictorArn
-
El nombre de 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.
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:
