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](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 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](API_forecastquery_QueryForecast.md). Para exportar la previsión completa a su bucket de Amazon Simple Storage Service (Amazon S3), utilice la operación [CreateForecastExportJob](API_CreateForecastExportJob.md). **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](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) El rango de la previsión viene determinado por el valor de `ForecastHorizon` que especifique en la solicitud [CreatePredictor](API_CreatePredictor.md). 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](API_ListForecasts.md). **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](howitworks-forecast.md). **nota** El `Status` de la previsión debe ser `ACTIVE` antes de poder consultarla o exportarla. Utilice la operación [DescribeForecast](API_DescribeForecast.md) 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](#API_CreateForecast_RequestSyntax) ** Un nombre para la previsión. 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í ** [ForecastTypes](#API_CreateForecast_RequestSyntax) ** 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) y `mean`. 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](#API_CreateForecast_RequestSyntax) ** 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](#API_CreateForecast_RequestSyntax) ** 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 de : + Número máximo de etiquetas por recurso: 50. + Para cada recurso, cada clave de etiqueta debe ser única y cada clave de etiqueta 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 generalmente permitidos son: letras, números y espacios representables en UTF-8, y los siguientes caracteres: \$1 - =. \$1:/@. + 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 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. Tipo: matriz de objetos [Tag](API_Tag.md) Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos. Obligatorio: no ** [TimeSeriesSelector](#API_CreateForecast_RequestSyntax) ** Define el conjunto de series temporales que se utilizan para crear las previsiones en un objeto `TimeSeriesIdentifiers`. El objeto `TimeSeriesIdentifiers` necesita la siguiente información: + `DataSource` + `Format` + `Schema` Tipo: objeto [TimeSeriesSelector](API_TimeSeriesSelector.md) 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](#API_CreateForecast_ResponseSyntax) ** 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 idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateForecast) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateForecast) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateForecast) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateForecast) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateForecast) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateForecast) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateForecast) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateForecast) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateForecast) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateForecast)