신규 고객은 더 이상 Amazon Forecast를 사용할 수 없습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. 자세히 알아보기
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeAutoPredictor
CreateAutoPredictor 작업을 사용하여 만든 예측자를 설명합니다.
중요
신규 고객은 더 이상 Amazon Forecast를 사용할 수 없습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. 자세히 알아보기
구문 요청
{
"PredictorArn": "string
"
}
요청 파라미터
요청은 다음과 같은 JSON 형식의 데이터를 수락합니다.
- PredictorArn
-
예측자의 Amazon 리소스 이름 (ARN).
유형: 문자열
길이 제약: 최대 길이 256.
Pattern:
arn:([a-z\d-]+):forecast:.*:.*:.+
필수 여부: 예
응답 구문
{
"CreationTime": number,
"DataConfig": {
"AdditionalDatasets": [
{
"Configuration": {
"string" : [ "string" ]
},
"Name": "string"
}
],
"AttributeConfigs": [
{
"AttributeName": "string",
"Transformations": {
"string" : "string"
}
}
],
"DatasetGroupArn": "string"
},
"DatasetImportJobArns": [ "string" ],
"EncryptionConfig": {
"KMSKeyArn": "string",
"RoleArn": "string"
},
"EstimatedTimeRemainingInMinutes": number,
"ExplainabilityInfo": {
"ExplainabilityArn": "string",
"Status": "string"
},
"ForecastDimensions": [ "string" ],
"ForecastFrequency": "string",
"ForecastHorizon": number,
"ForecastTypes": [ "string" ],
"LastModificationTime": number,
"Message": "string",
"MonitorInfo": {
"MonitorArn": "string",
"Status": "string"
},
"OptimizationMetric": "string",
"PredictorArn": "string",
"PredictorName": "string",
"ReferencePredictorSummary": {
"Arn": "string",
"State": "string"
},
"Status": "string",
"TimeAlignmentBoundary": {
"DayOfMonth": number,
"DayOfWeek": "string",
"Hour": number,
"Month": "string"
}
}
Response Elements
작업이 성공하면 서비스는 HTTP 200개의 응답을 다시 보냅니다.
서비스는 다음 데이터를 JSON 형식으로 반환합니다.
- CreationTime
-
CreateAutoPredictor 요청의 타임스탬프.
유형: 타임스탬프
- DataConfig
-
데이터 세트 그룹 및 추가 데이터 세트의 데이터 구성입니다.
유형: DataConfig 객체
- DatasetImportJobArns
-
ARNs예측자의 훈련 데이터를 가져오는 데 사용되는 데이터세트 가져오기 작업의 배열입니다.
타입: 문자열 배열
길이 제약: 최대 길이 256.
패턴:
arn:([a-z\d-]+):forecast:.*:.*:.+
- EncryptionConfig
-
Amazon AWS Key Management Service Forecast가 키에 액세스하기 위해 맡을 수 있는 AWS Identity and Access Management (IAM) 키와 () 역할. KMS CreateDataset 및 CreatePredictor 요청에서 이 선택적 객체를 지정할 수 있습니다.
유형: EncryptionConfig 객체
- EstimatedTimeRemainingInMinutes
-
예측기 훈련 작업 완료까지 남은 예상 시간(분)입니다.
타입: Long
- ExplainabilityInfo
-
예측자 설명 ARN 가능성의 상태와 상태를 제공합니다.
유형: ExplainabilityInfo 객체
- ForecastDimensions
-
시계열을 그룹화하는 데 사용되는 속성을 지정하는 차원(필드) 이름의 배열입니다.
타입: 문자열 배열
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 10개입니다.
길이 제약: 최소 길이 1. 최대 길이 63.
패턴:
^[a-zA-Z][a-zA-Z0-9_]*
- ForecastFrequency
-
예측에서의 예측 빈도.
유효한 간격은 Y(년), M(월), W(주), D(일), H(시), 30min(30분), 15min(15분), 10min(10분), 5min(5분) 및 1min(1분)입니다. 예를 들어 “Y”는 매년을 나타내고 “5min”은 5분마다를 나타냅니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이는 5입니다.
패턴:
^Y|M|W|D|H|30min|15min|10min|5min|1min$
- ForecastHorizon
-
모델이 예측하는 시간 단계의 수입니다. 이 예상 구간은 또한 예측 길이라고도 합니다.
유형: 정수
- ForecastTypes
-
예측기 훈련 중에 사용되는 예측 유형입니다. 기본값은 ["0.1","0.5","0.9"]입니다.
타입: 문자열 배열
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다.
길이 제약: 최소 길이는 2입니다. 최대 길이는 4입니다.
패턴:
(^0?\.\d\d?$|^mean$)
- LastModificationTime
-
리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.
-
CREATE_PENDING
:CreationTime
. -
CREATE_IN_PROGRESS
- 현재 타임스탬프. -
CREATE_STOPPING
- 현재 타임스탬프. -
CREATE_STOPPED
- 작업이 중지된 시점. -
ACTIVE
또는CREATE_FAILED
- 작업이 완료되거나 실패한 경우.
유형: 타임스탬프
-
- Message
-
오류 발생 시 오류의 원인을 자세히 설명하는 메시지입니다.
유형: 문자열
- MonitorInfo
-
Amazon 리소스 이름 (ARN) 및 모니터 리소스 상태를 가진 MonitorInfo 객체입니다.
유형: MonitorInfo 객체
- OptimizationMetric
-
예측기를 최적화하는 데 사용되는 정확도 지표입니다.
타입: 문자열
유효 값:
WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE
- PredictorArn
-
예측자의 Amazon 리소스 이름 (ARN)
유형: 문자열
길이 제약: 최대 길이 256.
패턴:
arn:([a-z\d-]+):forecast:.*:.*:.+
- PredictorName
-
예측기의 이름입니다.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이 63.
패턴:
^[a-zA-Z][a-zA-Z0-9_]*
- ReferencePredictorSummary
-
참조 예측자의 ARN 및 상태. 이 파라미터는 재훈련되거나 업그레이드된 예측기인 경우에만 유효합니다.
유형: ReferencePredictorSummary 객체
- Status
-
예측기의 상태입니다. 상태는 다음을 포함합니다.
-
ACTIVE
-
CREATE_PENDING
,CREATE_IN_PROGRESS
,CREATE_FAILED
-
CREATE_STOPPING
,CREATE_STOPPED
-
DELETE_PENDING
,DELETE_IN_PROGRESS
,DELETE_FAILED
유형: 문자열
길이 제약: 최대 길이 256.
-
- TimeAlignmentBoundary
-
Forecast가 데이터를 집계할 때 사용하는 시간 경계입니다.
유형: TimeAlignmentBoundary 객체
Errors
- InvalidInputException
-
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.
HTTP상태 코드: 400
- ResourceNotFoundException
-
해당 Amazon 리소스 이름 (ARN) 을 가진 리소스를 찾을 수 없습니다. 를 ARN 확인하고 다시 시도하십시오.
HTTP상태 코드: 400
참고
언어별 사용 방법에 대한 자세한 내용은 AWS SDKs 다음을 참조하십시오. API