DescribeDataset - Amazon Forecast
구문 요청요청 파라미터응답 구문Response ElementsErrors참고

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

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

DescribeDataset

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

중요

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

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

  • CreationTime

  • LastModificationTime

  • Status

구문 요청

{
   "DatasetArn": "string"
}

요청 파라미터

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

DatasetArn

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

유형: 문자열

길이 제약: 최대 길이 256.

Pattern: 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"
}

Response Elements

작업이 성공하면 서비스는 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

데이터세트의 Amazon 리소스 이름 (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

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

유형: 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.

Errors

InvalidInputException

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

HTTP상태 코드: 400

ResourceNotFoundException

해당 Amazon 리소스 이름 (ARN) 을 가진 리소스를 찾을 수 없습니다. 를 ARN 확인하고 다시 시도하십시오.

HTTP상태 코드: 400

참고

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