CreateForecast

예측기 훈련에 사용된 TARGET_TIME_SERIES 데이터 세트의 모든 항목에 대한 예측을 생성합니다. 이를 추론이라고 합니다. 짧은 지연 시간으로 단일 항목에 대한 예측을 검색하려면 QueryForecast 작업을 사용하세요. 전체 예측을 Amazon Simple Storage Service(S3) 버킷으로 내보내려면 CreateForecastExportJob 작업을 사용합니다.

중요

Amazon Forecast는 더 이상 신규 고객이 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. 자세히 알아보기

예측 범위는 CreatePredictor 요청에서 지정한 ForecastHorizon 값에 따라 결정됩니다. 예측을 쿼리할 때 예측 내의 특정 날짜 범위를 요청할 수 있습니다.

모든 예측 목록을 가져오려면 ListForecasts 작업을 사용합니다.

참고

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

자세한 내용은 예측 생성 단원을 참조하십시오.

참고

예측을 쿼리하거나 내보내려면 예측의 Status가 ACTIVE여야 합니다. DescribeForecast 작업을 사용하여 상태를 가져옵니다.

기본적으로 예측에는 예측기를 훈련하는 데 사용된 데이터 세트 그룹의 모든 항목(item_id)에 대한 예측이 포함됩니다. 하지만 TimeSeriesSelector 객체를 사용하여 시계열의 하위 집합에 대한 예측을 생성할 수 있습니다. 지정한 시계열 중 입력 데이터 세트에 없는 시계열에 대해서는 예측 생성이 생략됩니다. 예측 내보내기 파일에는 이러한 시계열 또는 예측 값이 포함되지 않습니다.

구문 요청


{
   "ForecastName": "string",
   "ForecastTypes": [ "string" ],
   "PredictorArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeSeriesSelector": { 
      "TimeSeriesIdentifiers": { 
         "DataSource": { 
            "S3Config": { 
               "KMSKeyArn": "string",
               "Path": "string",
               "RoleArn": "string"
            }
         },
         "Format": "string",
         "Schema": { 
            "Attributes": [ 
               { 
                  "AttributeName": "string",
                  "AttributeType": "string"
               }
            ]
         }
      }
   }
}

요청 파라미터

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

ForecastName

예측의 이름.

유형: 문자열

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

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

필수 여부: 예

ForecastTypes

확률적 예측이 생성되는 분위수입니다. 현재 예측당 최대 5개의 분위수를 지정할 수 있습니다. 허용되는 값에는 0.01 to 0.99(0.01씩만 증분) 및 mean이 포함됩니다. 분포가 대칭적이지 않은 경우(예: 베타 및 음이항) 평균 예측치는 중앙값(0.50)과 다릅니다.

기본 분위수는 예측기 생성 중에 지정한 분위수입니다. 분위수를 지정하지 않은 경우 기본값은 ["0.1", "0.5", "0.9"]입니다.

타입: 문자열 배열

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

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

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

Required: No

PredictorArn

예측 생성에 사용할 예측기의 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

길이 제약: 최대 길이 256.

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

필수 여부: 예

Tags

예측을 분류하고 구성하는 데 도움이 되도록 예측에 적용하는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.

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

리소스당 최대 태그 수 - 50개.
각 리소스에 대해 각 태그 키는 고유하며 하나의 값만 가질 수 있습니다.
최대 키 길이 - 유니코드 문자 128자(UTF-8).
최대 값 길이 - 유니코드 문자 256자(UTF-8).
태깅 스키마를 여러 서비스와 리소스에서 사용하는 경우 다른 서비스 또한 허용되는 문자에 대한 제한이 있을 수 있음을 유의합니다. 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 특수 문자 + - = . _ : / @.
태그 키와 값은 대소문자를 구분합니다.
키의 접두사와 같은 aws:, AWS:또는의 대문자 또는 소문자 조합을 사용하지 마세요. 키는 AWS 사용을 위해 예약되어 있기 때문입니다. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 aws가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. aws 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다.

유형: Tag객체 어레이

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

필수 여부: 아니요

TimeSeriesSelector

TimeSeriesIdentifiers 객체에서 예측을 생성하는 데 사용되는 시계열 세트를 정의합니다.

TimeSeriesIdentifiers 객체에는 다음과 같은 정보가 있어야 합니다.

DataSource
Format
Schema

유형: TimeSeriesSelector 객체

필수 항목 여부: 아니요

응답 구문


{
   "ForecastArn": "string"
}

응답 요소

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

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

ForecastArn

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

유형: 문자열

길이 제약: 최대 길이 256.

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

오류

InvalidInputException

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

HTTP 상태 코드: 400

LimitExceededException

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

HTTP 상태 코드: 400

ResourceAlreadyExistsException

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

HTTP 상태 코드: 400

ResourceInUseException

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

HTTP 상태 코드: 400

ResourceNotFoundException

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

HTTP 상태 코드: 400

참고

언어별 AWS SDKs

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

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

문서 규칙

CreateExplainabilityExport

CreateForecastExportJob