신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# ListForecasts
[CreateForecast](API_CreateForecast.md) 작업을 사용하여 생성한 예측의 목록을 반환합니다. 이 작업은 각 예측마다 Amazon 리소스 이름(ARN)을 포함하여 예측의 속성 요약을 반환합니다. 전체 속성 세트를 검색하려면 [DescribeForecast](API_DescribeForecast.md) 작업을 사용하여 ARN을 지정하세요. [Filter](API_Filter.md) 객체 배열을 사용하여 목록을 필터링할 수 있습니다.
**중요**
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)
## 구문 요청
```
{
"Filters": [
{
"Condition": "string",
"Key": "string",
"Value": "string"
}
],
"MaxResults": number,
"NextToken": "string"
}
```
## 요청 파라미터
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [Filters](#API_ListForecasts_RequestSyntax) **
필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 명령문과 일치하는 예측을 목록에 포함할지 제외할지 여부를 각각 지정하는 `IS` 또는 `IS_NOT`입니다. 일치 문은 키와 값으로 구성됩니다.
**필터 속성**
+ `Condition` - 적용할 조건입니다. 유효 값은 `IS` 및 `IS_NOT`입니다. 문과 일치하는 예측을 포함하려면 `IS`를 지정합니다. 일치하는 예측을 제외하려면 `IS_NOT`을 지정합니다.
+ `Key` - 필터링할 파라미터의 이름입니다. 유효한 값은 `DatasetGroupArn`, `PredictorArn`, `Status`입니다.
+ `Value` - 일치시킬 값입니다.
예를 들어 상태가 ACTIVE가 아닌 모든 예측을 나열하려면 다음과 같이 지정합니다.
`"Filters": [ { "Condition": "IS_NOT", "Key": "Status", "Value": "ACTIVE" } ]`
타입: [Filter](API_Filter.md)객체 배열
필수: 아니요
** [MaxResults](#API_ListForecasts_RequestSyntax) **
응답에서 반환할 총 항목 수입니다.
타입: 정수
유효 범위: 최소값 1. 최댓값은 100입니다.
필수 여부: 아니요
** [NextToken](#API_ListForecasts_RequestSyntax) **
이전 요청의 결과가 잘린 경우 응답에는 `NextToken`이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.
패턴: `.+`
필수 여부: 아니요
## 응답 구문
```
{
"Forecasts": [
{
"CreatedUsingAutoPredictor": boolean,
"CreationTime": number,
"DatasetGroupArn": "string",
"ForecastArn": "string",
"ForecastName": "string",
"LastModificationTime": number,
"Message": "string",
"PredictorArn": "string",
"Status": "string"
}
],
"NextToken": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [Forecasts](#API_ListForecasts_ResponseSyntax) **
각 예측의 속성을 요약하는 객체의 배열입니다.
타입: [ForecastSummary](API_ForecastSummary.md)객체 배열
** [NextToken](#API_ListForecasts_ResponseSyntax) **
응답이 잘린 경우 Amazon Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.
패턴: `.+`
## 오류
** InvalidInputException **
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.
HTTP 상태 코드: 400
** InvalidNextTokenException **
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.
HTTP 상태 코드: 400
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/ListForecasts)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/ListForecasts)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/ListForecasts)
+ [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/ListForecasts)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/ListForecasts)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/ListForecasts)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/ListForecasts)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/ListForecasts)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/ListForecasts)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/ListForecasts)