

 신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 서비스를 정상적으로 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

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

# CreateDatasetGroup
<a name="API_CreateDatasetGroup"></a>

관련 데이터 세트 모음을 보유하는 데이터 세트 그룹을 생성합니다. 데이터 세트 그룹을 생성할 때 또는 나중에 [UpdateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_UpdateDatasetGroup.html) 작업을 사용하여 데이터 세트 그룹에 데이터 세트를 추가할 수 있습니다.

**중요**  
신규 고객은 Amazon Forecast를 더 이상 사용할 수 없습니다. Amazon Forecast의 기존 고객은 평소와 같이 서비스를 계속 사용할 수 있습니다. [자세히 알아보기](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

데이터 세트 그룹을 생성하고 데이터 세트를 추가한 후에는 예측기를 생성할 때 이 데이터 세트 그룹을 사용합니다. 자세한 내용을 알아보려면 [데이터 세트 그룹](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html)을 참조하세요.

모든 데이터 세트 그룹의 목록을 가져오려면 [ListDatasetGroups](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasetGroups.html) 작업을 사용합니다.

**참고**  
데이터 세트 그룹을 사용하여 예측기를 생성하려면 먼저 데이터 세트 그룹의 `Status`가 `ACTIVE`여야 합니다. 상태를 가져오려면 [DescribeDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDatasetGroup.html) 작업을 사용합니다.

## 구문 요청
<a name="API_CreateDatasetGroup_RequestSyntax"></a>

```
{
   "DatasetArns": [ "string" ],
   "DatasetGroupName": "string",
   "Domain": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## 요청 파라미터
<a name="API_CreateDatasetGroup_RequestParameters"></a>

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

 ** [DatasetArns](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-DatasetArns"></a>
데이터 세트 그룹에 포함시키려는 데이터 세트의 Amazon 리소스 이름(ARN) 배열입니다.  
유형: 문자열 배열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
필수 여부: 아니요

 ** [DatasetGroupName](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-DatasetGroupName"></a>
데이터 세트 그룹의 이름입니다.  
유형: 문자열  
길이 제약: 최소 길이 1. 최대 길이 63.  
패턴: `^[a-zA-Z][a-zA-Z0-9_]*`   
필수 여부: 예

 ** [Domain](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-Domain"></a>
데이터 세트 그룹과 연결된 도메인입니다. 데이터 세트를 데이터 세트 그룹에 추가할 때 이 값과 [CreateDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html) 작업의 `Domain` 파라미터에 지정된 값이 일치해야 합니다.  
선택하는 `Domain` 및 `DatasetType`에 따라 데이터 세트로 가져오는 훈련 데이터에 있어야 하는 필드가 결정됩니다. 예를 들어 `RETAIL` 도메인과 `TARGET_TIME_SERIES`를 `DatasetType`으로 선택하면 Amazon Forecast에서 데이터에 `item_id`, `timestamp` 및 `demand` 필드가 있어야 합니다. 자세한 내용을 알아보려면 [데이터 세트 그룹](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html)을 참조하세요.  
타입: 문자열  
유효 값: `RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS`   
필수 사항 여부: 예

 ** [Tags](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-Tags"></a>
데이터 세트 그룹을 분류하고 구성하는 데 도움이 되도록 데이터 세트에 적용하는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.  
 태그에 적용되는 기본 제한 사항은 다음과 같습니다.  
+ 리소스당 최대 태그 수 - 50개.
+ 각 리소스에 대해 각 태그 키는 고유해야 하며 각 태그 키는 하나의 값만 가질 수 있습니다.
+ 최대 키 길이 - 유니코드 문자 128자(UTF-8).
+ 최대 값 길이 - 유니코드 문자 256자(UTF-8).
+ 태깅 스키마를 여러 서비스와 리소스에서 사용하는 경우 다른 서비스 또한 허용되는 문자에 대한 제한이 있을 수 있음을 유의합니다. 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 \$1 - = . \$1 : / @입니다.
+ 태그 키와 값은 대소문자를 구분합니다.
+ 키는 AWS 사용을 위해 예약되어 있으므로 `aws:`, `AWS:`또는 키의 접두사와 같은의 대문자 또는 소문자 조합을 사용하지 마십시오. 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 `aws`가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. `aws` 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다.
타입: [Tag](API_Tag.md)객체 배열  
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.  
필수 여부: 아니요

## 응답 구문
<a name="API_CreateDatasetGroup_ResponseSyntax"></a>

```
{
   "DatasetGroupArn": "string"
}
```

## 응답 요소
<a name="API_CreateDatasetGroup_ResponseElements"></a>

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

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

 ** [DatasetGroupArn](#API_CreateDatasetGroup_ResponseSyntax) **   <a name="forecast-CreateDatasetGroup-response-DatasetGroupArn"></a>
데이터세트 그룹의 Amazon 리소스 이름(ARN)입니다.  
유형: 문자열  
길이 제약: 최대 길이 256.  
패턴: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## 오류
<a name="API_CreateDatasetGroup_Errors"></a>

 ** InvalidInputException **   
요청에 잘못된 값이나 유효한 범위를 초과하는 값이 포함되어 있기 때문에 요청을 처리할 수 없습니다.  
HTTP 상태 코드: 400

 ** LimitExceededException **   
계정당 리소스 수 제한을 초과했습니다.  
HTTP 상태 코드: 400

 ** ResourceAlreadyExistsException **   
이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.  
HTTP 상태 코드: 400

 ** ResourceInUseException **   
지정된 리소스가 이미 사용 중입니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.  
HTTP 상태 코드: 400

## 참고
<a name="API_CreateDatasetGroup_SeeAlso"></a>

언어별 AWS SDKs
+  [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDatasetGroup) 