ListForecasts - Amazon Forecast
구문 요청요청 파라미터응답 구문Response ElementsErrors참고

Amazon Forecast는 더 이상 신규 고객에게 제공되지 않습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. 자세히 알아보기

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

ListForecasts

CreateForecast 작업을 사용하여 생성한 예측의 목록을 반환합니다. 이 작업은 각 예측에 대해 Amazon 리소스 이름 (ARN) 을 포함한 속성 요약을 반환합니다. 전체 속성 세트를 검색하려면 DescribeForecast 연산에 를 ARN 지정하십시오. Filter 객체 배열을 사용하여 목록을 필터링할 수 있습니다.

중요

신규 고객은 더 이상 Amazon Forecast를 사용할 수 없습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. 자세히 알아보기

구문 요청

{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "NextToken": "string"
}

요청 파라미터

요청은 다음과 같은 JSON 형식의 데이터를 수락합니다.

Filters

필터 배열입니다. 각 필터마다 조건과 일치 문을 제공합니다. 조건은 명령문과 일치하는 예측을 목록에 포함할지 제외할지 여부를 각각 지정하는 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 객체 배열

필수 여부: 아니요

MaxResults

응답에서 반환할 총 항목 수입니다.

타입: 정수

유효 범위: 최소값 1. 최댓값은 100입니다.

필수 여부: 아니요

NextToken

이전 요청의 결과가 잘린 경우 응답에는 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"
}

Response Elements

작업이 성공하면 서비스는 HTTP 200개의 응답을 다시 보냅니다.

서비스는 다음 데이터를 JSON 형식으로 반환합니다.

Forecasts

각 예측의 속성을 요약하는 객체의 배열입니다.

유형: ForecastSummary객체 어레이

NextToken

응답이 잘린 경우 Amazon Forecast는 이 토큰을 반환합니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.

패턴: .+

Errors

InvalidInputException

요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.

HTTP상태 코드: 400

InvalidNextTokenException

토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.

HTTP상태 코드: 400

참고

언어별 사용 방법에 대한 자세한 내용은 AWS SDKs 다음을 참조하십시오. API