O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# ListForecasts
Exibe uma lista de previsões criadas por meio da operação [CreateForecast](API_CreateForecast.md). Para cada previsão, essa operação exibe um resumo das propriedades, incluindo o nome do recurso da Amazon (ARN). Para recuperar o conjunto completo de propriedades, especifique o ARN com a operação [DescribeForecast](API_DescribeForecast.md). É possível filtrar a lista usando uma matriz de objetos [Filter](API_Filter.md).
**Importante**
O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)
## Sintaxe da solicitação
```
{
"Filters": [
{
"Condition": "string",
"Key": "string",
"Value": "string"
}
],
"MaxResults": number,
"NextToken": "string"
}
```
## Parâmetros da solicitação
A solicitação aceita os dados a seguir no formato JSON.
** [Filters](#API_ListForecasts_RequestSyntax) **
Uma matriz de filtros. Para cada filtro, são fornecidas uma condição e uma declaração de correspondência. A condição é `IS` ou `IS_NOT`, que especifica se as previsões correspondentes à declaração devem ser incluídas ou excluídas da lista, respectivamente. A declaração de correspondência consiste em uma chave e um valor.
**Propriedades do filtro**
+ `Condition`: a condição a ser aplicada. Os valores válidos são `IS` e `IS_NOT`. Para incluir as previsões correspondentes à declaração, especifique `IS`. Para excluir previsões correspondentes, especifique `IS_NOT`.
+ `Key`: o nome do parâmetro a ser filtrado. Os valores válidos são `DatasetGroupArn`, `PredictorArn` e `Status`.
+ `Value`: o valor a ser comparado.
Por exemplo, para listar todas as previsões cujo status não seja ATIVO, especifique:
`"Filters": [ { "Condition": "IS_NOT", "Key": "Status", "Value": "ACTIVE" } ]`
Tipo: matriz de objetos [Filter](API_Filter.md)
Obrigatório: não
** [MaxResults](#API_ListForecasts_RequestSyntax) **
O número de itens a serem exibidos na resposta.
Tipo: inteiro
Faixa válida: valor mínimo de 1. Valor máximo de 100.
Obrigatório: não
** [NextToken](#API_ListForecasts_RequestSyntax) **
Se o resultado da solicitação anterior estava truncado, a resposta incluirá um `NextToken`. Para recuperar o próximo conjunto de resultados, use o token na próxima solicitação. Os tokens expiram após 24 horas.
Tipo: string
Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 3.000.
Padrão: `.+`
Obrigatório: Não
## Sintaxe da resposta
```
{
"Forecasts": [
{
"CreatedUsingAutoPredictor": boolean,
"CreationTime": number,
"DatasetGroupArn": "string",
"ForecastArn": "string",
"ForecastName": "string",
"LastModificationTime": number,
"Message": "string",
"PredictorArn": "string",
"Status": "string"
}
],
"NextToken": "string"
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [Forecasts](#API_ListForecasts_ResponseSyntax) **
Uma matriz de objetos que resumem as propriedades de cada previsão.
Tipo: matriz de objetos [ForecastSummary](API_ForecastSummary.md)
** [NextToken](#API_ListForecasts_ResponseSyntax) **
Se a resposta estiver truncada, o Amazon Forecast vai gerar esse token. Para recuperar o próximo conjunto de resultados, use o token na próxima solicitação.
Tipo: string
Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 3.000.
Padrão: `.+`
## Erros
** InvalidInputException **
Não podemos processar a solicitação porque ela inclui um valor inválido ou um valor que excede o intervalo válido.
Código de status HTTP: 400
** InvalidNextTokenException **
O token não é válido. Os tokens expiram após 24 horas.
Código de Status HTTP: 400
## Consulte também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+ [AWS Interface de linha de comando 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)