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

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

CreateDatasetGroup

빈 데이터세트 그룹을 생성합니다. 데이터세트 그룹은 Personalize 리소스를 위한 컨테이너입니다. 데이터세트 그룹은 데이터세트 유형별로 하나씩, 최대 3개의 데이터세트를 포함할 수 있습니다.

  • 항목 상호 작용

  • Items

  • 사용자

  • 작업

  • 작업 상호 작용

데이터세트 그룹은 도메인을 지정하고 추천자와 같은 사전 구성된 리소스를 사용하는 도메인 데이터세트 그룹이나, 캠페인과 함께 배포하는 솔루션 버전이 포함된 솔루션과 같은 사용자 지정 리소스를 사용하는 사용자 지정 데이터세트 그룹일 수 있습니다. 도메인 데이터세트 그룹으로 시작하는 경우에도 사용자 지정 사용 사례에 대한 레시피로 학습하고 캠페인과 함께 배포한 솔루션 및 솔루션 버전과 같은 사용자 지정 리소스를 추가할 수 있습니다.

데이터세트 그룹은 다음 상태 중 하나일 수 있습니다.

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

  • DELETE PENDING

데이터세트 그룹의 상태를 가져오려면 DescribeDatasetGroup를 호출합니다. 상태가 CREATE FAILED로 표시되는 경우 응답에는 생성이 실패한 이유를 설명하는 failureReason키가 포함됩니다.

참고

데이터세트를 그룹에 추가하기 전에 데이터세트 그룹의 status이 ACTIVE가 될 때까지 기다려야 합니다.

AWS Key Management Service(KMS) 키를 지정하여 그룹의 데이터세트를 암호화할 수 있습니다. KMS 키를 지정하는 경우 키에 액세스할 권한이 있는 AWS Identity and Access Management(IAM) 역할도 포함시켜야 합니다.

요청 시 데이터세트 그룹 ARN이 필요한 API
관련 API

구문 요청

{
   "domain": "string",
   "kmsKeyArn": "string",
   "name": "string",
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

요청 파라미터

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

domain

데이터세트 그룹의 도메인. 도메인 데이터세트 그룹을 생성하려면 도메인을 지정합니다. 지정하는 도메인에 따라 데이터세트의 기본 스키마와, 추천자가 사용할 수 있는 사용 사례가 결정됩니다. 도메인을 지정하지 않는 경우 캠페인과 함께 배포하는 솔루션 버전으로 사용자 지정 데이터세트 그룹을 생성합니다.

타입: 문자열

유효 값: ECOMMERCE | VIDEO_ON_DEMAND

필수 항목 여부: 아니요

kmsKeyArn

데이터세트를 암호화하는 데 사용되는 AWS Key Management Service(KMS) 키의 리소스 이름(ARN)입니다.

유형: 문자열

길이 제약: 최대 길이 2048.

패턴: arn:aws.*:kms:.*:[0-9]{12}:key/.*

Required: No

name

새로운 데이터세트 그룹의 이름.

유형: 문자열

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

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

필수 여부: 예

roleArn

AWS Key Management Service(KMS) 키에 액세스할 수 있는 권한이 있는 AWS Identity and Access Management(IAM) 역할의 ARN입니다. IAM 역할을 제공하는 것은 KMS 키를 함께 지정하는 경우에만 유효합니다.

유형: 문자열

길이 제약: 최대 길이 256.

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

Required: No

tags

데이터세트 그룹에 적용할 태그 목록입니다.

유형: Tag객체 어레이

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

필수 여부: 아니요

응답 구문

{
   "datasetGroupArn": "string",
   "domain": "string"
}

응답 요소

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

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

datasetGroupArn

새 데이터세트 그룹의 리소스 이름(ARN)입니다.

유형: 문자열

길이 제약: 최대 길이 256.

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

domain

새 도메인 데이터세트 그룹의 도메인.

타입: 문자열

유효 값: ECOMMERCE | VIDEO_ON_DEMAND

Errors

InvalidInputException

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

HTTP 상태 코드: 400

LimitExceededException

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

HTTP 상태 코드: 400

ResourceAlreadyExistsException

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

HTTP 상태 코드: 400

TooManyTagsException

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

HTTP 상태 코드: 400

참고

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