QueryForecast - Amazon Forecast

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

QueryForecast

제공된 기준에 따라 필터링된 단일 항목에 대한 예측을 검색합니다.

기준은 키-값 페어입니다. 키는 TARGET_TIME_SERIES 데이터 세트의 item_id(또는 이에 상응하는 비타임스탬프, 비대상 필드)이거나 FeaturizationConfig 객체의 일부로 지정된 예측 차원 중 하나입니다.

기본적으로 QueryForecast는 필터링된 예측의 전체 날짜 범위를 반환합니다. 특정 날짜 범위를 요청할 수 있습니다.

전체 예측을 얻으려면 CreateForecastExportJob작업을 사용하십시오.

참고

Amazon Forecast에서 생성되는 예측은 예측기를 생성하는 데 사용된 데이터 세트와 시간대가 동일합니다.

구문 요청

{ "EndDate": "string", "Filters": { "string" : "string" }, "ForecastArn": "string", "NextToken": "string", "StartDate": "string" }

요청 파라미터

요청은 JSON 형식으로 다음 데이터를 받습니다.

EndDate

예측의 종료 날짜입니다. yyyy-MM-dd'T'HH:mm:ss(ISO 8601 형식) 형식을 사용하여 날짜를 지정합니다. 예: 2015-01-01T20:00:00.

유형: String

필수 사항 여부: 아니요

Filters

예측을 검색할 때 적용할 필터링 기준입니다. 예를 들어, 전기 사용량 데이터 세트에서 client_21에 대한 예측을 가져오려면 다음을 지정합니다.

{"item_id" : "client_21"}

전체 예측을 가져오려면 CreateForecastExportJob작업을 사용하십시오.

유형: 문자열-문자열 맵

맵 항목: 최대 항목 수는 50입니다.

키 길이 제약: 최대 길이는 256입니다.

키 패턴: ^[a-zA-Z0-9\_\-]+$

값 길이 제약: 최대 길이는 256입니다.

필수 항목 여부: 예

ForecastArn

쿼리할 예측의 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

길이 제약: 최대 길이는 256입니다.

패턴: arn:([a-z\d-]+):forecast:.*:.*:.+

필수 항목 여부: 예

NextToken

이전 요청의 결과가 잘린 경우 응답에는 NextToken이 포함됩니다. 다음 결과 세트를 검색하려면 다음 요청에서 토큰을 사용하세요. 토큰은 24시간 후 만료됩니다.

유형: 문자열

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

필수 항목 여부: 아니요

StartDate

예측의 시작 날짜입니다. yyyy-MM-dd'T'HH:mm:ss(ISO 8601 형식) 형식을 사용하여 날짜를 지정합니다. 예: 2015-01-01T08:00:00.

유형: String

필수 사항 여부: 아니요

응답 구문

{ "Forecast": { "Predictions": { "string" : [ { "Timestamp": "string", "Value": number } ] } } }

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

Forecast

예측입니다.

타입: Forecast 객체

Errors

InvalidInputException

값이 유효하지 않거나 너무 깁니다.

HTTP 상태 코드: 400

InvalidNextTokenException

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

HTTP 상태 코드: 400

LimitExceededException

초당 요청 수 한도를 초과했습니다.

HTTP 상태 코드: 400

ResourceInUseException

지정된 리소스가 이미 사용 중입니다.

HTTP 상태 코드: 400

ResourceNotFoundException

해당 리소스를 찾을 수 없습니다. 제공한 정보를 확인하고 다시 시도하세요.

HTTP 상태 코드: 400

참고

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요.