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

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

CreateDataDeletionJob

Amazon Personalize 데이터 세트 그룹에서 특정 사용자에 대한 모든 참조를 일괄적으로 삭제하는 배치 작업을 생성합니다. Amazon S3 버킷의 사용자 ID로 구성된 CSV 파일에서 삭제할 사용자를 지정합니다. 작업이 완료되면 Amazon Personalize는 더 이상 사용자 데이터를 기반으로 학습하지 않으며 사용자 세그먼트를 생성할 때 더 이상 사용자를 고려하지 않습니다. 데이터 삭제 작업 생성에 대한 자세한 내용은 사용자 삭제를 참조하십시오.

  • 입력 파일은 사용자 ID가 나열된 단일 USER_ID 열이 있는 CSV 파일이어야 합니다. CSV 파일 준비에 대한 자세한 내용은 데이터 삭제 파일 준비 및 Amazon S3에 업로드를 참조하십시오.

  • Amazon Personalize에 사용자 ID의 입력 CSV 파일에 액세스할 수 있는 권한을 부여하려면 데이터 소스에서 읽을 권한이 있는 IAM 서비스 역할을 지정해야 합니다. 이 역할에는 버킷 GetObject 및 ListBucket 해당 콘텐츠에 대한 권한이 필요합니다. 이러한 권한은 데이터를 가져오는 것과 동일합니다. S3 버킷에 대한 액세스 권한의 부여에 대한 자세한 내용은 S3 리소스에 대한 액세스 권한 Personalize에 부여 단원을 참조하세요.

작업을 생성한 후 데이터세트와 모델에서 사용자에 대한 모든 참조를 삭제하는 데 최대 하루가 걸릴 수 있습니다. 작업이 완료될 때까지 Amazon Personalize는 교육 시 데이터를 계속 사용합니다. 또한 사용자 세분화 레시피를 사용하면 사용자가 사용자 세그먼트에 나타날 수 있습니다.

상태

데이터 삭제 작업의 상태는 다음 중 하나일 수 있습니다.

  • [보류 중] > [진행 중] > [완료] 또는 [실패]

데이터 삭제 작업의 상태를 가져오려면 DescribeDataDeletionJobAPI 작업을 호출하고 작업의 Amazon 리소스 이름 (ARN) 을 지정하십시오. 상태가 FAILE인 경우 응답에는 작업이 실패한 이유를 설명하는 failureReason 키가 포함됩니다.

관련 API

구문 요청

{
   "datasetGroupArn": "string",
   "dataSource": { 
      "dataLocation": "string"
   },
   "jobName": "string",
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

요청 파라미터

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

datasetGroupArn

레코드를 삭제하려는 데이터세트가 있는 데이터세트 그룹의 Amazon 리소스 이름 (ARN)

타입: 문자열

길이 제약: 최대 길이 256.

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

필수 사항 여부: Yes

dataSource

삭제할 사용자의 사용자 ID 목록이 들어 있는 Amazon S3 버킷입니다.

유형: DataSource객체

필수 여부: 예

jobName

데이터 삭제 작업의 이름.

유형: 문자열

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

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

필수 사항 여부: Yes

roleArn

Amazon S3 데이터 소스에서 읽을 권한이 있는 IAM 역할의 Amazon 리소스 이름 (ARN).

타입: 문자열

길이 제약: 최대 길이 256.

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

필수 사항 여부: Yes

tags

데이터 삭제 작업에 적용할 태그 목록.

유형: Tag객체 어레이

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

필수 여부: 아니요

응답 구문

{
   "dataDeletionJobArn": "string"
}

응답 요소

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

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

dataDeletionJobArn

데이터 삭제 작업의 Amazon 리소스 이름 (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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.