기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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
구문 요청
{
"domain": "string",
"kmsKeyArn": "string",
"name": "string",
"roleArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}요청 파라미터
요청은 JSON 형식으로 다음 데이터를 받습니다.
- domain
-
데이터세트 그룹의 도메인. 도메인 데이터세트 그룹을 생성하려면 도메인을 지정합니다. 지정하는 도메인에 따라 데이터세트의 기본 스키마와, 추천자가 사용할 수 있는 사용 사례가 결정됩니다. 도메인을 지정하지 않는 경우 캠페인과 함께 배포하는 솔루션 버전으로 사용자 지정 데이터세트 그룹을 생성합니다.
타입: 문자열
유효 값:
ECOMMERCE | VIDEO_ON_DEMAND필수 여부: 아니요
- kmsKeyArn
-
데이터세트를 암호화하는 데 사용되는 (KMS) 키의 Amazon 리소스 이름 AWS Key Management Service (ARN).
타입: 문자열
길이 제약: 최대 길이 2048.
패턴:
arn:aws.*:kms:.*:[0-9]{12}:key/.*Required: No
- name
-
새로운 데이터세트 그룹의 이름.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이 63.
패턴:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*필수 사항 여부: Yes
- roleArn
-
(KMS) 키에 액세스할 수 있는 권한이 있는 AWS Identity and Access Management (IAM) 역할의 AWS Key Management Service ARN. IAM 역할을 제공하는 것은 KMS 키를 함께 지정하는 경우에만 유효합니다.
타입: 문자열
길이 제약: 최대 길이 256.
패턴:
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+Required: No
-
데이터세트 그룹에 적용할 태그 목록입니다.
유형: 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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
