Amazon Forecast는 더 이상 신규 고객에게 제공되지 않습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. 자세히 알아보기
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
QueryWhatIfForecast
what-if 예측을 검색합니다.
구문 요청
{
"EndDate": "string",
"Filters": {
"string" : "string"
},
"NextToken": "string",
"StartDate": "string",
"WhatIfForecastArn": "string"
}요청 파라미터
요청은 JSON 형식으로 다음 데이터를 받습니다.
- EndDate
-
what-if 예측의 종료 날짜입니다. yyyy-MM-dd'T'HH:mm:ss(ISO 8601 형식) 형식을 사용하여 날짜를 지정합니다. 예: 2015-01-01T20:00:00.
타입: 문자열
필수사항: 아니요
- Filters
-
예측을 검색할 때 적용할 필터링 기준입니다. 예를 들어 전기 사용량 데이터 세트에서
client_21에 대한 예측을 가져오려면 다음을 지정합니다.{"item_id" : "client_21"}전체 가정 예측 결과를 얻으려면 작업을 사용하십시오. CreateForecastExportJob
유형: 문자열-문자열 맵
맵 항목: 최대 항목 수는 50입니다.
키 길이 제약: 최대 길이는 256입니다.
키 패턴:
^[a-zA-Z0-9\_\-]+$값 길이 제약: 최대 길이는 256입니다.
필수 여부: 예
- NextToken
-
이전 요청의 결과가 잘린 경우 응답에는
NextToken이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 3,000입니다.
필수 여부: 아니요
- StartDate
-
what-if 예측의 시작 날짜입니다. yyyy-MM-dd'T'HH:mm:ss(ISO 8601 형식) 형식을 사용하여 날짜를 지정합니다. 예: 2015-01-01T08:00:00.
타입: 문자열
필수사항: 아니요
- WhatIfForecastArn
-
쿼리할 what-if 예측의 Amazon 리소스 이름(ARN)입니다.
타입: 문자열
길이 제약 조건: 최대 길이는 300입니다.
패턴:
arn:([a-z\d-]+):forecast:.*:.*:.+필수 항목 여부: 예
응답 구문
{
"Forecast": {
"Predictions": {
"string" : [
{
"Timestamp": "string",
"Value": number
}
]
}
}
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- Forecast
-
예측에 대한 정보를 제공합니다. QueryForecast 응답의 일부로 반환됩니다.
유형: Forecast객체
Errors
- InvalidInputException
-
값이 유효하지 않거나 너무 깁니다.
HTTP 상태 코드: 400
- InvalidNextTokenException
-
토큰이 유효하지 않습니다. 토큰은 24시간 후 만료됩니다.
HTTP 상태 코드: 400
- LimitExceededException
-
초당 요청 수 한도를 초과했습니다.
HTTP 상태 코드: 400
- ResourceInUseException
-
지정된 리소스가 이미 사용 중입니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
해당 리소스를 찾을 수 없습니다. 제공한 정보를 확인하고 다시 시도하세요.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
