구문 요청 요청 파라미터 응답 구문 Response Elements Errors 참고

CreateDataset

Amazon Forecast 데이터 세트를 생성합니다.

중요

신규 고객은 더 이상 Amazon Forecast를 사용할 수 없습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. 자세히 알아보기

제공하는 데이터 세트에 대한 정보는 Forecast가 모델 훈련에 데이터를 사용하는 방법을 이해하는 데 도움이 됩니다. 다음 내용이 포함됩니다:

DataFrequency - 과거 시계열 데이터가 수집되는 빈도입니다.
Domain 및 DatasetType - 각 데이터 세트에는 연결된 데이터 세트 도메인과 도메인 내의 유형이 있습니다. Amazon Forecast는 각 도메인 내의 사전 정의된 도메인 및 유형 목록을 제공합니다. 각 고유한 데이터 세트 도메인과 도메인 내 유형에 대해 Amazon Forecast는 데이터에 미리 정의된 필드의 최소 세트를 포함시키도록 요구합니다.
Schema - 스키마는 필드 이름과 데이터 유형을 포함하여 데이터 세트의 필드를 지정합니다.

데이터 세트를 생성한 후에는 교육 데이터를 여기로 가져오고 데이터 세트 그룹에 데이터 세트를 추가합니다. 데이터 세트 그룹을 사용하여 예측기를 생성합니다. 자세한 내용을 알아보려면 데이터 세트 가져오기를 참조하세요.

모든 데이터세트 목록을 가져오려면 ListDatasets작업을 사용하십시오.

예측 데이터세트의 예는 Amazon Forecast 샘플 GitHub 리포지토리를 참조하십시오.

참고

교육 데이터를 가져오려면 데이터 세트의 Status가 ACTIVE여야 합니다. DescribeDataset작업을 사용하여 상태를 가져올 수 있습니다.

구문 요청


{
   "DataFrequency": "string",
   "DatasetName": "string",
   "DatasetType": "string",
   "Domain": "string",
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "Schema": { 
      "Attributes": [ 
         { 
            "AttributeName": "string",
            "AttributeType": "string"
         }
      ]
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

요청 파라미터

요청은 다음과 같은 JSON 형식의 데이터를 수락합니다.

DataFrequency

데이터 수집 빈도입니다. 이 매개변수는 RELATED TIME _ SERIES 데이터셋에 필요합니다.

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

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

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

유형: 문자열

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

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

Required: No

DatasetName

데이터 세트의 이름입니다.

유형: 문자열

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

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

필수 여부: 예

DatasetType

데이터세트 유형. 유효한 값은 선택한 Domain에 따라 다릅니다.

타입: 문자열

유효 값: TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA

필수 사항 여부: 예

Domain

데이터 세트와 연결된 도메인입니다. 데이터세트 그룹에 데이터세트를 추가할 때 이 값과 CreateDatasetGroup작업 Domain 매개변수에 지정된 값이 일치해야 합니다.

선택하는 Domain 및 DatasetType에 따라 데이터 세트로 가져오는 훈련 데이터에 있어야 하는 필드가 결정됩니다. 예를 들어 RETAIL 도메인과 TARGET_TIME_SERIES를 DatasetType으로 선택하면 Amazon Forecast에서 데이터에 item_id, timestamp 및 demand 필드가 있어야 합니다. 자세한 내용을 알아보려면 데이터 세트 가져오기를 참조하세요.

타입: 문자열

필수 사항 여부: 예

EncryptionConfig

Amazon AWS Key Management Service Forecast가 키에 액세스하기 위해 맡을 수 있는 AWS Identity and Access Management (IAM) 키와 () 역할. KMS

유형: EncryptionConfig 객체

필수 여부: 아니요

Schema

데이터 세트의 스키마입니다. 스키마 속성과 순서는 데이터의 필드와 일치해야 합니다. 선택한 데이터 세트 Domain 및 DatasetType은 훈련 데이터의 최소 필수 필드를 결정합니다. 특정 데이터 세트 도메인과 유형의 필수 필드에 대한 자세한 내용을 알아보려면 데이터 세트 도메인 및 데이터 세트 유형을 참조하세요.

유형: Schema 객체

필수 여부: 예

Tags

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

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

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

유형: Tag객체 어레이

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

필수 여부: 아니요

응답 구문


{
   "DatasetArn": "string"
}

Response Elements

작업이 성공하면 서비스는 200개의 응답을 다시 보냅니다. HTTP

서비스는 다음 데이터를 JSON 형식으로 반환합니다.

DatasetArn

데이터세트의 Amazon 리소스 이름 (ARN).

유형: 문자열

길이 제약: 최대 길이 256.

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

Errors

InvalidInputException

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

HTTP상태 코드: 400

LimitExceededException

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

HTTP상태 코드: 400

ResourceAlreadyExistsException

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

HTTP상태 코드: 400

참고

언어별 사용 방법에 대한 자세한 내용은 AWS SDKs 다음을 참조하십시오. API

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

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

문서 규칙

CreateAutoPredictor

CreateDatasetGroup