기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeAutoPredictor
CreateAutoPredictor 작업을 사용하여 만든 예측자를 설명합니다.
구문 요청
{
"PredictorArn": "string"
}요청 파라미터
요청은 JSON 형식으로 다음 데이터를 받습니다.
- PredictorArn
-
예측기의 Amazon 리소스 이름(ARN)입니다.
타입: 문자열
길이 제약: 최대 길이 256.
패턴:
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"
}
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- CreationTime
-
요청의 CreateAutoPredictor 타임스탬프.
유형: 타임스탬프
- DataConfig
-
데이터 세트 그룹 및 추가 데이터 세트의 데이터 구성입니다.
유형: DataConfig객체
- DatasetImportJobArns
-
예측기의 훈련 데이터를 가져오는 데 사용되는 데이터 세트 가져오기 작업의 ARN 배열입니다.
유형: 문자열 어레이
길이 제약: 최대 길이 256.
패턴:
arn:([a-z\d-]+):forecast:.*:.*:.+ - EncryptionConfig
-
Amazon Forecast가 키에 액세스하기 위해 맡을 수 있는 AWS Key Management Service AWS Identity and Access Management (KMS) 키 및 (IAM) 역할. 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 및 상태입니다. 이 파라미터는 재훈련되거나 업그레이드된 예측기인 경우에만 유효합니다.
- 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 SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
