DescribeDataset - Amazon Forecast
구문 요청요청 파라미터응답 구문응답 요소오류참고

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

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

DescribeDataset

CreateDataset 작업을 사용하여 생성된 Amazon Forecast 데이터 세트를 설명합니다.

중요

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

CreateDataset 요청에 지정된 파라미터를 나열하는 것 외에도 이 작업에는 다음과 같은 데이터 세트 속성이 포함됩니다.

  • CreationTime

  • LastModificationTime

  • Status

구문 요청

{
   "DatasetArn": "string"
}

요청 파라미터

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

DatasetArn

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

유형: 문자열

길이 제약: 최대 길이 256.

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

필수 여부: 예

응답 구문

{
   "CreationTime": number,
   "DataFrequency": "string",
   "DatasetArn": "string",
   "DatasetName": "string",
   "DatasetType": "string",
   "Domain": "string",
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "LastModificationTime": number,
   "Schema": { 
      "Attributes": [ 
         { 
            "AttributeName": "string",
            "AttributeType": "string"
         }
      ]
   },
   "Status": "string"
}

응답 요소

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

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

CreationTime

데이터 세트를 생성한 시간입니다.

유형: 타임스탬프

DataFrequency

데이터 수집 빈도입니다.

유효한 간격은 Y(년), M(월), W(주), D(일), H(시), 30min(30분), 15min(15분), 10min(10분), 5min(5분) 및 1min(1분)입니다. 예를 들어 “M”는 매월을 나타내고 “30min”은 30분마다를 나타냅니다.

유형: 문자열

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

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

DatasetArn

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

유형: 문자열

길이 제약: 최대 길이 256.

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

DatasetName

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

유형: 문자열

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

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

DatasetType

데이터세트 유형.

타입: 문자열

유효 값: TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA

Domain

데이터 세트와 연결된 도메인입니다.

타입: 문자열

유효 값: RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS

EncryptionConfig

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

유형: EncryptionConfig객체

LastModificationTime

데이터 세트를 생성하는 경우 LastModificationTime은 CreationTime과 같습니다. 데이터를 데이터 세트로 가져오는 동안 LastModificationTime은 DescribeDataset 직접 호출의 현재 시간입니다. CreateDatasetImportJob 작업이 완료된 후 LastModificationTime은 가져오기 작업이 완료되거나 실패한 때입니다.

유형: 타임스탬프

Schema

데이터 세트 필드를 지정하는 SchemaAttribute 객체의 배열입니다. 각 SchemaAttribute는 필드의 이름과 데이터 형식을 지정합니다.

유형: Schema객체

Status

데이터세트의 상태입니다. 상태는 다음을 포함합니다.

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • UPDATE_PENDING, UPDATE_IN_PROGRESS, UPDATE_FAILED

UPDATE 상태는 CreateDatasetImportJob 작업 직접 호출로부터 데이터 세트로 데이터를 가져오는 동안 적용되며, 데이터 세트 가져오기 작업의 상태를 반영합니다. 예를 들어 가져오기 작업 상태가 CREATE_IN_PROGRESS인 경우 데이터 세트의 상태는 UPDATE_IN_PROGRESS입니다.

참고

훈련 데이터를 가져오려면 데이터 세트의 Status가 ACTIVE여야 합니다.

유형: 문자열

길이 제약: 최대 길이 256.

오류

InvalidInputException

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

HTTP 상태 코드: 400

ResourceNotFoundException

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

HTTP 상태 코드: 400

참고

언어별 AWS SDKs