기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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
-
데이터세트 내보내기 작업에 적용할 태그 목록입니다.
유형: 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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.