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.
# ListForecasts
Devuelve una lista de las previsiones creadas mediante la operación [CreateForecast](API_CreateForecast.md). Para cada previsión, esta operación devuelve un resumen de sus propiedades, incluido su Nombre de recurso de Amazon (ARN). Para recuperar el conjunto completo de propiedades, especifique el ARN con la operación [DescribeForecast](API_DescribeForecast.md). Puede filtrar la lista mediante una matriz de objetos [Filter](API_Filter.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/)
## Sintaxis de la solicitud
```
{
"Filters": [
{
"Condition": "string",
"Key": "string",
"Value": "string"
}
],
"MaxResults": number,
"NextToken": "string"
}
```
## Parámetros de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
** [Filters](#API_ListForecasts_RequestSyntax) **
Matriz de filtros. Para cada filtro, proporcione una condición y una declaración de coincidencia. La condición es `IS` o `IS_NOT`, que especifica si se deben incluir o excluir de la lista las previsiones que coincidan con la declaración, respectivamente. La declaración de coincidencia consta de una clave y un valor.
**Propiedades del filtro**
+ `Condition`: la condición que se debe aplicar. Los valores válidos son `IS` y `IS_NOT`. Para incluir las previsiones que coincidan con la declaración, especifique `IS`. Para excluir las previsiones coincidentes, especifique `IS_NOT`.
+ `Key`: el nombre del parámetro con el que se va a filtrar. Los valores válidos son `DatasetGroupArn`, `PredictorArn` y `Status`.
+ `Value`: el valor que debe coincidir.
Por ejemplo, para enumerar todas las previsiones cuyo estado no sea ACTIVO, debe especificar:
`"Filters": [ { "Condition": "IS_NOT", "Key": "Status", "Value": "ACTIVE" } ]`
Tipo: matriz de objetos [Filter](API_Filter.md)
Obligatorio: no
** [MaxResults](#API_ListForecasts_RequestSyntax) **
El número de artículos que se devuelve en la respuesta.
Tipo: entero
Rango válido: valor mínimo de 1. Valor máximo de 100.
Obligatorio: no
** [NextToken](#API_ListForecasts_RequestSyntax) **
Si el resultado de la solicitud anterior se truncó, la respuesta incluye un `NextToken`. Para recuperar el siguiente conjunto de resultados, utilice el token en la siguiente solicitud. Los tokens caducan tras 24 horas.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 3000.
Patrón: `.+`
Obligatorio: no
## Sintaxis de la respuesta
```
{
"Forecasts": [
{
"CreatedUsingAutoPredictor": boolean,
"CreationTime": number,
"DatasetGroupArn": "string",
"ForecastArn": "string",
"ForecastName": "string",
"LastModificationTime": number,
"Message": "string",
"PredictorArn": "string",
"Status": "string"
}
],
"NextToken": "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.
** [Forecasts](#API_ListForecasts_ResponseSyntax) **
Una matriz de objetos que resumen las propiedades de cada previsión.
Tipo: matriz de objetos [ForecastSummary](API_ForecastSummary.md)
** [NextToken](#API_ListForecasts_ResponseSyntax) **
Si la respuesta está truncada, Amazon Forecast devuelve este token. Para recuperar el siguiente conjunto de resultados, utilice el token en la siguiente solicitud.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 3000.
Patrón: `.+`
## 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
** InvalidNextTokenException **
El token no es válido. Los tokens caducan tras 24 horas.
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, consulte lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListForecasts)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListForecasts)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListForecasts)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListForecasts)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListForecasts)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListForecasts)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListForecasts)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListForecasts)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListForecasts)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListForecasts)