기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CreateDatasetGroup 빈 데이터세트 그룹을 생성합니다. 데이터세트 그룹은 Personalize 리소스를 위한 컨테이너입니다. 데이터세트 그룹은 데이터세트 유형별로 하나씩, 최대 3개의 데이터세트를 포함할 수 있습니다. + 항목 상호 작용 + Items + Users + 작업 + 작업 상호 작용 데이터세트 그룹은 도메인을 지정하고 추천자와 같은 사전 구성된 리소스를 사용하는 도메인 데이터세트 그룹이나, 캠페인과 함께 배포하는 솔루션 버전이 포함된 솔루션과 같은 사용자 지정 리소스를 사용하는 사용자 지정 데이터세트 그룹일 수 있습니다. 도메인 데이터세트 그룹으로 시작하는 경우에도 사용자 지정 사용 사례에 대한 레시피로 학습하고 캠페인과 함께 배포한 솔루션 및 솔루션 버전과 같은 사용자 지정 리소스를 추가할 수 있습니다. 데이터세트 그룹은 다음 상태 중 하나일 수 있습니다. + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED + DELETE PENDING 데이터세트 그룹의 상태를 가져오려면 [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html)를 호출합니다. 상태가 CREATE FAILED로 표시되는 경우 응답에는 생성이 실패한 이유를 설명하는 `failureReason`키가 포함됩니다. **참고** 데이터세트를 그룹에 추가하기 전에 데이터세트 그룹의 `status`이 `ACTIVE`가 될 때까지 기다려야 합니다. AWS Key Management Service (KMS) 키를 지정하여 그룹의 데이터 세트를 암호화할 수 있습니다. KMS 키를 지정하는 경우 키에 액세스할 권한이 있는 AWS Identity and Access Management (IAM) 역할도 포함시켜야 합니다. **요청 시 데이터세트 그룹 ARN이 필요한 API** + [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) + [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) + [솔루션 생성](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) **관련 API** + [ListDatasetGroups](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetGroups.html) + [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) + [DeleteDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDatasetGroup.html) ## 구문 요청 ``` { "domain": "string", "kmsKeyArn": "string", "name": "string", "roleArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 요청 파라미터 요청은 JSON 형식으로 다음 데이터를 받습니다. ** [domain](#API_CreateDatasetGroup_RequestSyntax) ** 데이터세트 그룹의 도메인. 도메인 데이터세트 그룹을 생성하려면 도메인을 지정합니다. 지정하는 도메인에 따라 데이터세트의 기본 스키마와, 추천자가 사용할 수 있는 사용 사례가 결정됩니다. 도메인을 지정하지 않는 경우 캠페인과 함께 배포하는 솔루션 버전으로 사용자 지정 데이터세트 그룹을 생성합니다. 타입: 문자열 유효 값: `ECOMMERCE | VIDEO_ON_DEMAND` 필수 여부: 아니요 ** [kmsKeyArn](#API_CreateDatasetGroup_RequestSyntax) ** 데이터 세트를 암호화하는 데 사용되는 (KMS) 키의 Amazon 리소스 이름 AWS Key Management Service (ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 2048. 패턴: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` 필수 여부: 아니요 ** [name](#API_CreateDatasetGroup_RequestSyntax) ** 새로운 데이터세트 그룹의 이름. 유형: 문자열 길이 제약: 최소 길이 1. 최대 길이 63. 패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 필수 여부: 예 ** [roleArn](#API_CreateDatasetGroup_RequestSyntax) ** AWS Identity and Access Management (KMS) 키에 액세스할 수 있는 권한이 있는 AWS Key Management Service (IAM) 역할의 ARN입니다. IAM 역할을 제공하는 것은 KMS 키를 함께 지정하는 경우에만 유효합니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` 필수 여부: 아니요 ** [tags](#API_CreateDatasetGroup_RequestSyntax) ** 데이터세트 그룹에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) 목록입니다. 유형: [Tag](API_Tag.md)객체 어레이 어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개. 필수 여부: 아니요 ## 응답 구문 ``` { "datasetGroupArn": "string", "domain": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [datasetGroupArn](#API_CreateDatasetGroup_ResponseSyntax) ** 새 데이터세트 그룹의 리소스 이름(ARN)입니다. 유형: 문자열 길이 제약: 최대 길이 256. 패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+` ** [domain](#API_CreateDatasetGroup_ResponseSyntax) ** 새 도메인 데이터세트 그룹의 도메인. 타입: 문자열 유효 값: `ECOMMERCE | VIDEO_ON_DEMAND` ## 오류 ** InvalidInputException ** 필드 또는 파라미터에 유효한 값을 제공합니다. HTTP 상태 코드: 400 ** LimitExceededException ** 초당 요청 수 한도를 초과했습니다. HTTP 상태 코드: 400 ** ResourceAlreadyExistsException ** 지정된 리소스가 이미 있습니다. HTTP 상태 코드: 400 ** TooManyTagsException ** 이 리소스에 적용할 수 있는 최대 태그 수를 초과했습니다. HTTP 상태 코드: 400 ## 참고 언어별 AWS SDKs + [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDatasetGroup) + [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetGroup) + [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetGroup) + [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetGroup) + [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetGroup) + [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetGroup)