CreateBatchSegmentJob - Amazon Personalize

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

CreateBatchSegmentJob

배치 세그먼트 작업을 생성합니다. 이 작업은 최대 5천만 개의 레코드를 처리할 수 있으며 입력 파일은 JSON 형식이어야 합니다. 자세한 내용은 단원을 참조하십시오.배치 권장 사항 및 사용자 세그먼트 얻기.

요청 구문

{ "filterArn": "string", "jobInput": { "s3DataSource": { "kmsKeyArn": "string", "path": "string" } }, "jobName": "string", "jobOutput": { "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "numResults": number, "roleArn": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] }

요청 파라미터

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

filterArn

배치 세그먼트 작업에 적용할 필터의 ARN입니다. 필터 사용에 대한 자세한 내용은 단원을 참조하십시오.배치 권장 사항 필터링.

Type: String

길이 제약 조건: 최대 길이 256.

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

: 필수 아니요

jobInput

배치 세그먼트 작업을 생성하는 데 사용되는 입력 데이터에 대한 Amazon S3 경로입니다.

유형: BatchSegmentJobInput 객체

: 필수 예

jobName

생성할 배치 세그먼트 작업의 이름입니다.

Type: String

길이 제약 조건: 최소 길이는 1이고, 최대 길이 63.

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

: 필수 예

jobOutput

작업의 출력이 저장될 버킷에 대한 Amazon S3 경로입니다.

유형: BatchSegmentJobOutput 객체

: 필수 예

numResults

각 입력 데이터 라인에 대해 배치 세그먼트 작업에서 생성된 예측 사용자 수입니다.

Type: Integer

: 필수 아니요

roleArn

입력 및 출력 Amazon S3 버킷을 각각 읽고 쓸 수 있는 권한이 있는 Amazon 자격 증명 및 액세스 관리 역할의 ARN입니다.

Type: String

길이 제약 조건: 최대 길이 256.

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

: 필수 예

solutionVersionArn

배치 세그먼트 작업을 사용하여 배치 세그먼트를 생성할 수 있는 솔루션 버전의 Amazon 리소스 이름 (ARN)

Type: String

길이 제약 조건: 최대 길이 256.

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

: 필수 예

tags

목록태그배치 세그먼트 작업에 적용합니다.

Type: 배열Tag사물

배열 멤버: 최소 항목 수 0개. 최대 항목 수는 200개입니다.

: 필수 아니요

응답 구문

{ "batchSegmentJobArn": "string" }

응답 요소

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

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

batchSegmentJobArn

배치 세그먼트 작업의 ARN입니다.

Type: String

길이 제약 조건: 최대 길이 256.

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

오류

InvalidInputException

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

HTTP 상태 코드: 400

LimitExceededException

초당 요청 수에 대한 제한을 초과했습니다.

HTTP 상태 코드: 400

ResourceAlreadyExistsException

지정한 리소스가 이미 존재합니다.

HTTP 상태 코드: 400

ResourceInUseException

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

HTTP 상태 코드: 400

ResourceNotFoundException

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

HTTP 상태 코드: 400

TooManyTagsException

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

HTTP 상태 코드: 400

참고 항목

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