CreateAutoPredictor

Amazon Forecast 예측기를 생성합니다.

Amazon Forecast는 데이터 세트의 각 시계열에 최적의 알고리즘 조합을 적용하는 방식으로 예측자를 생성합니다. AutoPredictor CreateAutoPredictor를 사용하여 새 예측기를 생성하거나 기존 예측기를 업그레이드/재훈련할 수 있습니다.

새 예측기 생성

다음 파라미터는 새 예측기 생성 시 필수입니다.

PredictorName - 예측기의 고유한 이름입니다.
DatasetGroupArn - 예측기를 훈련하는 데 사용되는 데이터 세트 그룹의 ARN입니다.
ForecastFrequency - 예측의 세분 수준(시간별, 일별, 주별 등)입니다.
ForecastHorizon - 모델이 예측하는 시간 단계의 수입니다. 이 예상 구간은 또한 예측 길이라고도 합니다.

새 예측기를 생성할 때는 ReferencePredictorArn 값을 지정하지 마세요.

예측기 업그레이드 및 재훈련

예측기를 재훈련하거나 업그레이드할 경우 다음 파라미터가 필수입니다.

PredictorName - 예측기의 고유한 이름입니다.
ReferencePredictorArn - 재훈련 또는 업그레이드할 예측기의 ARN입니다.

예측기를 업그레이드하거나 재훈련할 때는 ReferencePredictorArn 및 PredictorName 값만 지정하세요.

구문 요청


{
   "DataConfig": { 
      "AdditionalDatasets": [ 
         { 
            "Configuration": { 
               "string" : [ "string" ]
            },
            "Name": "string"
         }
      ],
      "AttributeConfigs": [ 
         { 
            "AttributeName": "string",
            "Transformations": { 
               "string" : "string" 
            }
         }
      ],
      "DatasetGroupArn": "string"
   },
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "ExplainPredictor": boolean,
   "ForecastDimensions": [ "string" ],
   "ForecastFrequency": "string",
   "ForecastHorizon": number,
   "ForecastTypes": [ "string" ],
   "MonitorConfig": { 
      "MonitorName": "string"
   },
   "OptimizationMetric": "string",
   "PredictorName": "string",
   "ReferencePredictorArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeAlignmentBoundary": { 
      "DayOfMonth": number,
      "DayOfWeek": "string",
      "Hour": number,
      "Month": "string"
   }
}

요청 파라미터

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

DataConfig

데이터 세트 그룹 및 추가 데이터 세트의 데이터 구성입니다.

타입: DataConfig 객체

필수 항목 여부: 아니요

EncryptionConfig

Amazon Forecast가 키에 액세스하기 위해 수임할 수 있는 AWS Key Management Service(KMS) 키와 AWS Identity and Access Management(IAM) 역할입니다. CreateDataset 및 CreatePredictor 요청에서 필요에 따라 이 객체를 지정할 수 있습니다.

타입: EncryptionConfig 객체

필수 항목 여부: 아니요

ExplainPredictor

예측기의 설명 가능성 리소스를 생성합니다.

유형: 부울

필수 항목 여부: 아니요

ForecastDimensions

생성된 예측을 그룹화하는 방법을 지정하는 차원(필드) 이름의 배열입니다.

예를 들어, 모든 매장의 항목 판매 예측을 생성하고 데이터 세트에 store_id 필드가 포함된 경우, 각 매장의 판매 예측을 그룹화하는 차원으로 store_id를 지정할 수 있습니다.

유형: 문자열 어레이

어레이 멤버: 최소 항목 수 1개. 최대 항목 수는 10개입니다.

길이 제약: 최소 길이 1자. 최대 길이 63.

패턴: ^[a-zA-Z][a-zA-Z0-9_]*

Required: No

ForecastFrequency

예측의 예측 빈도입니다.

유효한 간격은 정수와 그 뒤에 붙은 Y(년), M(월), W(주), D(일), H(시) 및 min(분)입니다. 예를 들어 “1D”는 매일을 나타내고 “15min”은 15분마다를 나타냅니다. 한 단계 위로 큰 빈도와 겹치는 값은 지정할 수 없습니다. 예를 들어 60분은 1시간에 해당하므로 지정할 수 없습니다. 각 빈도의 유효한 값은 다음과 같습니다.

분 – 1~59
시 – 1~23
일 – 1~6
주 – 1~4
월 – 1~11
년 - 1

따라서 격주로 예측하려면 “2W”를 지정합니다. 또는 분기별 예측을 원하는 경우 “3M”을 지정합니다.

빈도는 TARGET_TIME_SERIES 데이터 세트 빈도보다 크거나 같아야 합니다.

RELATED_TIME_SERIES 데이터 세트를 제공하는 경우 빈도는 RELATED_TIME_SERIES 데이터 세트 빈도와 같아야 합니다.

유형: 문자열

길이 제약: 최소 길이는 1. 최대 길이는 5입니다.

패턴: ^Y|M|W|D|H|30min|15min|10min|5min|1min$

Required: No

ForecastHorizon

모델이 예측하는 시간 단계의 수입니다. 이 예상 구간은 또한 예측 길이라고도 합니다.

최대 예측 기간은 500 시간 단계 또는 TARGET_TIME_SERIES 데이터 세트 길이의 1/4 중 작은 값입니다. 기존 AutoPredictor 데이터를 재학습하는 경우 최대 예측 기간은 500개의 타임스텝 또는 TARGET_TIME_SERIES 데이터세트 길이의 1/3 중 더 작습니다.

기존 데이터로 AutoPredictor 업그레이드하거나 기존 매개변수를 재교육하는 경우 예측 대상 기간 매개변수를 업데이트할 수 없습니다. AutoPredictor 데이터 세트에 더 긴 시계열을 제공하면 이 요구 사항을 충족할 수 있습니다.

유형: 정수

필수 항목 여부: 아니요

ForecastTypes

예측기 훈련에 사용되는 예측 유형입니다. 최대 5개의 예측 유형을 지정할 수 있습니다. 예측 유형은 0.01에서 0.99까지의 사분위수(0.01 이상 증분)일 수 있습니다. mean을 사용하여 평균 예측을 지정할 수도 있습니다.

유형: 문자열 어레이

배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다.

길이 제약: 최소 길이는 2입니다. 최대 길이는 4입니다.

패턴: (^0?\.\d\d?$|^mean$)

Required: No

MonitorConfig

예측기 모니터링의 구성 세부 정보입니다. 예측기 모니터링을 활성화하려면 모니터 리소스의 이름을 제공하세요.

예측기 모니터링을 사용하면 시간 경과에 따라 예측기의 성능이 어떻게 변하는지 볼 수 있습니다. 자세한 내용은 예측기 모니터링을 참조하세요.

타입: MonitorConfig 객체

필수 항목 여부: 아니요

OptimizationMetric

예측기를 최적화하는 데 사용되는 정확도 지표입니다.

타입: 문자열

유효 값: WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE

필수 항목 여부: 아니요

PredictorName

예측기의 고유한 이름입니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이 63.

패턴: ^[a-zA-Z][a-zA-Z0-9_]*

필수 항목 여부: 예

ReferencePredictorArn

재훈련 또는 업그레이드할 예측기의 ARN입니다. 이 파라미터는 예측기를 재훈련하거나 업그레이드할 때만 사용됩니다. 새 예측기를 생성할 때는 이 파라미터의 값을 지정하지 마세요.

예측기를 업그레이드하거나 재훈련할 때는 ReferencePredictorArn 및 PredictorName 값만 지정하세요. PredictorName의 값은 고유한 예측기 이름이어야 합니다.

유형: 문자열

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

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

Required: No

Tags

예측기를 분류하고 구성하는 데 도움이 되는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다. 태그 키와 값은 대소문자를 구분합니다.

태그에 적용되는 제한은 다음과 같습니다.

리소스마다 각 태그 키는 고유해야 하며 하나의 값만 가질 수 있습니다.
리소스당 최대 태그 수: 50개.
최대 키 길이: 유니코드 문자 128자(UTF-8).
최대 값 길이: 유니코드 문자 256자(UTF-8).
허용되는 문자: UTF-8로 표현할 수 있는 모든 문자와 숫자, 공백 및 + - =. _ : / @. 태그 지정 스키마를 다른 서비스와 리소스에서 사용하는 경우 해당 서비스의 문자 제한도 적용됩니다.
키 접두사는 aws: 또는 AWS:의 대문자 또는 소문자 조합을 포함할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 aws가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. aws 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다.

유형: Tag 객체 어레이

어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.

필수 여부: 아니요

TimeAlignmentBoundary

예측 빈도와 일치하지 않는 데이터를 정렬하고 집계하는 데 Forecast가 사용하는 시간 경계입니다. 시간 단위와 시간 경계를 키 값 페어로 제공하세요. 시간 경계 지정에 대한 자세한 내용은 시간 경계 지정을 참조하세요. 시간 경계를 제공하지 않으면 Forecast는 기본 시간 경계 세트를 사용합니다.

타입: TimeAlignmentBoundary 객체

필수 항목 여부: 아니요

응답 구문


{
   "PredictorArn": "string"
}

응답 요소

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

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

PredictorArn

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

유형: 문자열

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

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

Errors

InvalidInputException

요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.

HTTP 상태 코드: 400

LimitExceededException

계정당 리소스 수 제한을 초과했습니다.

HTTP 상태 코드: 400

ResourceAlreadyExistsException

이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.

HTTP 상태 코드: 400

ResourceInUseException

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

HTTP 상태 코드: 400

ResourceNotFoundException

해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.

HTTP 상태 코드: 400

참고

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

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

Amazon Forecast 서비스

CreateDataset