DescribeDatasetImportJob - Amazon Forecast

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

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

DescribeDatasetImportJob

CreateDatasetImportJob 작업을 사용하여 생성한 데이터 세트 가져오기 작업을 설명합니다.

중요

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

CreateDatasetImportJob 요청에 제공된 파라미터를 나열하는 것 외에도 이 작업에는 다음과 같은 속성이 포함됩니다.

  • CreationTime

  • LastModificationTime

  • DataSize

  • FieldStatistics

  • Status

  • Message - 오류가 발생한 경우 오류에 대한 정보.

구문 요청

{ "DatasetImportJobArn": "string" }

요청 파라미터

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

DatasetImportJobArn

데이터세트 가져오기 작업의 리소스 이름(ARN).

유형: 문자열

길이 제약: 최대 길이 256.

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

필수 여부: 예

응답 구문

{ "CreationTime": number, "DatasetArn": "string", "DatasetImportJobArn": "string", "DatasetImportJobName": "string", "DataSize": number, "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "EstimatedTimeRemainingInMinutes": number, "FieldStatistics": { "string" : { "Avg": number, "Count": number, "CountDistinct": number, "CountDistinctLong": number, "CountLong": number, "CountNan": number, "CountNanLong": number, "CountNull": number, "CountNullLong": number, "Max": "string", "Min": "string", "Stddev": number } }, "Format": "string", "GeolocationFormat": "string", "ImportMode": "string", "LastModificationTime": number, "Message": "string", "Status": "string", "TimestampFormat": "string", "TimeZone": "string", "UseGeolocationForTimeZone": boolean }

응답 요소

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

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

CreationTime

데이터 세트 가져오기 작업이 생성된 시간입니다.

유형: 타임스탬프

DatasetArn

훈련 데이터를 가져온 데이터 세트의 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

길이 제약: 최대 길이 256.

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

DatasetImportJobArn

데이터세트 가져오기 작업의 ARN입니다.

유형: 문자열

길이 제약: 최대 길이 256.

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

DatasetImportJobName

데이터세트 가져오기 작업의 이름.

유형: 문자열

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

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

DataSize

가져오기 작업이 완료된 후 데이터 세트 크기(GB)입니다.

유형: Double

DataSource

가져올 훈련 데이터의 위치와 Amazon Forecast가 데이터에 액세스하기 위해 수임할 수 있는 AWS Identity and Access Management (IAM) 역할입니다.

암호화를 사용하는 경우 에는 AWS Key Management Service (KMS) 키가 DataSource 포함됩니다.

유형: DataSource객체

EstimatedTimeRemainingInMinutes

데이터 세트 가져오기 작업 완료까지 남은 예상 시간(분)입니다.

타입: Long

FieldStatistics

입력 데이터의 각 필드에 대한 통계 정보입니다.

유형: 문자열-Statistics 객체 맵

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

키 패턴: ^[a-zA-Z0-9\_]+$

Format

가져온 데이터의 형식, CSV 또는 PARQUET.

유형: 문자열

길이 제약 조건: 최대 길이는 7입니다.

패턴: ^CSV|PARQUET$

GeolocationFormat

지리적 위치 속성의 형식입니다. 유효한 값: "LAT_LONG""CC_POSTALCODE"

유형: 문자열

길이 제약: 최대 길이 256.

패턴: ^[a-zA-Z0-9_]+$

ImportMode

데이터 세트 가져오기 작업의 가져오기 모드, FULL 또는 INCREMENTAL.

타입: 문자열

유효 값: FULL | INCREMENTAL

LastModificationTime

리소스가 마지막으로 수정된 시간입니다. 타임스탬프는 작업 상태에 따라 달라집니다.

  • CREATE_PENDING: CreationTime.

  • CREATE_IN_PROGRESS - 현재 타임스탬프.

  • CREATE_STOPPING - 현재 타임스탬프.

  • CREATE_STOPPED - 작업이 중지된 시점.

  • ACTIVE 또는 CREATE_FAILED - 작업이 완료되거나 실패한 경우.

유형: 타임스탬프

Message

오류가 발생한 경우 오류에 대한 정보 메시지.

유형: 문자열

Status

데이터 세트 가져오기 작업의 상태. 상태는 다음을 포함합니다.

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • CREATE_STOPPING, CREATE_STOPPED

유형: 문자열

길이 제약: 최대 길이 256.

TimestampFormat

데이터 세트의 타임스탬프 형식입니다. 지정하는 형식은 데이터 세트가 생성될 때 지정한 DataFrequency에 따라 달라집니다. 지원되는 형식은 다음과 같습니다.

  • "yyyy-MM-dd"

    다음 데이터 빈도의 경우: Y, M, W, D

  • "yyyy-MM-dd HH:mm:ss"

    다음 데이터 빈도의 경우: H, 30분, 15분, 1분 및 선택적으로 Y, M, W, D

유형: 문자열

길이 제약: 최대 길이 256.

패턴: ^[a-zA-Z0-9\-\:\.\,\'\s]+$

TimeZone

데이터 세트의 모든 항목에 적용되는 단일 시간대입니다.

유형: 문자열

길이 제약: 최대 길이 256.

패턴: ^[a-zA-Z0-9\/\+\-\_]+$

UseGeolocationForTimeZone

TimeZone이 지리적 위치 속성에서 자동으로 파생되는지 여부입니다.

유형: 부울

오류

InvalidInputException

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

HTTP 상태 코드: 400

ResourceNotFoundException

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

HTTP 상태 코드: 400

참고

언어별 AWS SDKs