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

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

CreateDatasetGroup

빈 데이터 세트 그룹을 생성합니다. 데이터 세트 그룹은 Amazon 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) 키의 Amazon 리소스 이름(ARN).

유형: 문자열

길이 제약: 최대 길이 2048.

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

필수 항목 여부: 아니요

name

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

유형: 문자열

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

패턴: ^[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+=,.@\-_/]+

필수 항목 여부: 아니요

tags

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

유형: Tag 객체 어레이

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

필수 여부: 아니요

응답 구문

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

응답 요소

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

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

datasetGroupArn

새 데이터 세트 그룹의 Amazon 리소스 이름(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

참고

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