신규 고객은 더 이상 Amazon Forecast를 사용할 수 없습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. 자세히 알아보기
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeForecast
CreateForecast 작업을 사용하여 생성된 예측을 설명합니다.
중요
신규 고객은 더 이상 Amazon Forecast를 사용할 수 없습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. 자세히 알아보기
이 작업은 CreateForecast 요청에서 제공된 속성을 나열하는 것 외에도 다음 속성을 나열합니다.
-
DatasetGroupArn- 훈련 데이터를 제공한 데이터 세트 그룹. -
CreationTime -
LastModificationTime -
Status -
Message- 오류가 발생한 경우 오류에 대한 정보.
구문 요청
{
"ForecastArn": "string"
}요청 파라미터
요청은 다음과 같은 JSON 형식의 데이터를 수락합니다.
- ForecastArn
-
예측의 Amazon 리소스 이름 (ARN)
유형: 문자열
길이 제약: 최대 길이 256.
Pattern:
arn:([a-z\d-]+):forecast:.*:.*:.+필수 여부: 예
응답 구문
{
"CreationTime": number,
"DatasetGroupArn": "string",
"EstimatedTimeRemainingInMinutes": number,
"ForecastArn": "string",
"ForecastName": "string",
"ForecastTypes": [ "string" ],
"LastModificationTime": number,
"Message": "string",
"PredictorArn": "string",
"Status": "string",
"TimeSeriesSelector": {
"TimeSeriesIdentifiers": {
"DataSource": {
"S3Config": {
"KMSKeyArn": "string",
"Path": "string",
"RoleArn": "string"
}
},
"Format": "string",
"Schema": {
"Attributes": [
{
"AttributeName": "string",
"AttributeType": "string"
}
]
}
}
}
}Response Elements
작업이 성공하면 서비스는 HTTP 200개의 응답을 다시 보냅니다.
서비스는 다음 데이터를 JSON 형식으로 반환합니다.
- CreationTime
-
예측 생성 작업이 생성된 때입니다.
유형: 타임스탬프
- DatasetGroupArn
-
예측 변수를 훈련시키는 데 사용된 데이터를 제공한 데이터셋 그룹의 데이터셋. ARN
유형: 문자열
길이 제약: 최대 길이 256.
패턴:
arn:([a-z\d-]+):forecast:.*:.*:.+ - EstimatedTimeRemainingInMinutes
-
예측 작업 완료까지 남은 예상 시간(분)입니다.
타입: Long
- ForecastArn
-
ARN요청에 지정된 예측.
유형: 문자열
길이 제약: 최대 길이 256.
패턴:
arn:([a-z\d-]+):forecast:.*:.*:.+ - ForecastName
-
예측의 이름입니다.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이 63.
패턴:
^[a-zA-Z][a-zA-Z0-9_]* - ForecastTypes
-
확률적 예측이 생성된 시점의 분위수입니다.
타입: 문자열 배열
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다.
길이 제약: 최소 길이는 2입니다. 최대 길이는 4입니다.
패턴:
(^0?\.\d\d?$|^mean$) - LastModificationTime
-
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.
-
CREATE_PENDING:CreationTime. -
CREATE_IN_PROGRESS- 현재 타임스탬프. -
CREATE_STOPPING- 현재 타임스탬프. -
CREATE_STOPPED- 작업이 중지된 시점. -
ACTIVE또는CREATE_FAILED- 작업이 완료되거나 실패한 경우.
유형: 타임스탬프
-
- Message
-
오류가 발생한 경우 오류에 대한 정보 메시지.
유형: 문자열
- PredictorArn
-
예측 ARN 생성에 사용된 예측자.
유형: 문자열
길이 제약: 최대 길이 256.
패턴:
arn:([a-z\d-]+):forecast:.*:.*:.+ - Status
-
예측의 상태입니다. 상태는 다음을 포함합니다.
-
ACTIVE -
CREATE_PENDING,CREATE_IN_PROGRESS,CREATE_FAILED -
CREATE_STOPPING,CREATE_STOPPED -
DELETE_PENDING,DELETE_IN_PROGRESS,DELETE_FAILED
참고
예측을 쿼리하거나 내보내려면 먼저 예측의
Status가ACTIVE여야 합니다.유형: 문자열
길이 제약: 최대 길이 256.
패턴:
^[a-zA-Z0-9\_]+$ -
- TimeSeriesSelector
-
예측에 포함할 시계열입니다.
유형: TimeSeriesSelector 객체
Errors
- InvalidInputException
-
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.
HTTP상태 코드: 400
- ResourceNotFoundException
-
해당 Amazon 리소스 이름 (ARN) 을 가진 리소스를 찾을 수 없습니다. 를 ARN 확인하고 다시 시도하십시오.
HTTP상태 코드: 400
참고
언어별 사용 방법에 대한 자세한 내용은 AWS SDKs 다음을 참조하십시오. API
