CreateDatasetExportJob - Personalize
구문 요청요청 파라미터응답 구문응답 요소Errors참고

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

CreateDatasetExportJob

데이터세트의 데이터를 S3 버킷으로 내보내는 작업을 생성합니다. Personalize에서 학습 데이터를 내보내도록 허용하려면 S3 버킷에 대한 PutObject권한을 Personalize에 부여하는 서비스 연결 IAM 역할을 지정해야 합니다. 자세한 내용은 Personalize 개발자 안내서의 데이터세트 내보내기 단원을 참조하세요.

상태

데이터세트 내보내기 작업은 다음 상태 중 하나일 수 있습니다.

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE 또는 CREATE FAILED

내보내기 작업의 상태를 가져오려면 데이터세트 내보내기 작업의 Amazon 리소스 이름 (ARN) 을 DescribeDatasetExportJob호출하고 지정합니다. 상태가 ACTIVE로 표시되면 데이터세트 가져오기가 완료된 것입니다, 상태가 CREATE FAILED로 표시되는 경우 응답에는 작업이 실패한 이유를 설명하는 failureReason키가 포함됩니다.

구문 요청

{
   "datasetArn": "string",
   "ingestionMode": "string",
   "jobName": "string",
   "jobOutput": { 
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

요청 파라미터

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

datasetArn

가져온 데이터를 수신하는 데이터세트의 리소스 이름(ARN)입니다.

타입: 문자열

길이 제약: 최대 길이 256.

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

필수 사항 여부: Yes

ingestionMode

데이터를 가져온 방식에 따라 내보낼 데이터 데이터세트 가져오기 작업을 사용하여 가져온 BULK 데이터만 내보내거나, 콘솔, PutUsers 및 PutItems 작업을 사용하여 점진적으로 가져온 PUT 데이터만 내보내거나 PutEventsALL, 두 유형 모두에 대해 내보내도록 선택할 수 있습니다. 기본 값은 PUT입니다.

타입: 문자열

유효 값: BULK | PUT | ALL

필수 여부: 아니요

jobName

데이터세트 내보내기 작업의 이름.

유형: 문자열

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

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

필수 사항 여부: Yes

jobOutput

작업의 출력이 저장되는 S3 버킷의 경로.

유형: DatasetExportJobOutput객체

필수 여부: 예

roleArn

출력 S3 버킷에 데이터를 추가할 권한이 있는 IAM 서비스 역할의 리소스 이름(ARN)입니다.

타입: 문자열

길이 제약: 최대 길이 256.

패턴: arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+

필수 사항 여부: Yes

tags

데이터세트 내보내기 작업에 적용할 태그 목록입니다.

유형: Tag객체 어레이

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

필수 여부: 아니요

응답 구문

{
   "datasetExportJobArn": "string"
}

응답 요소

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

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

datasetExportJobArn

데이터세트 내보내기 작업의 리소스 이름(ARN)입니다.

타입: 문자열

길이 제약: 최대 길이 256.

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

Errors

InvalidInputException

필드 또는 파라미터에 유효한 값을 제공합니다.

HTTP 상태 코드: 400

LimitExceededException

초당 요청 수 한도를 초과했습니다.

HTTP 상태 코드: 400

ResourceAlreadyExistsException

지정된 리소스가 이미 있습니다.

HTTP 상태 코드: 400

ResourceInUseException

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

HTTP 상태 코드: 400

ResourceNotFoundException

지정된 리소스를 찾을 수 없습니다.

HTTP 상태 코드: 400

TooManyTagsException

이 리소스에 적용할 수 있는 최대 태그 수를 초과했습니다.

HTTP 상태 코드: 400

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.