CreateDatasetGroup - Amazon Forecast

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

CreateDatasetGroup

관련 데이터 세트 모음을 보유하는 데이터 세트 그룹을 생성합니다. 데이터세트 그룹을 만들 때 또는 나중에 작업을 사용하여 데이터셋 그룹에 데이터세트를 추가할 수 있습니다. UpdateDatasetGroup

데이터 세트 그룹을 생성하고 데이터 세트를 추가한 후에는 예측기를 생성할 때 이 데이터 세트 그룹을 사용합니다. 자세한 내용을 알아보려면 데이터 세트 그룹을 참조하세요.

모든 데이터세트 그룹의 목록을 가져오려면 작업을 사용하세요. ListDatasetGroups

참고

데이터 세트 그룹을 사용하여 예측기를 생성하려면 먼저 데이터 세트 그룹의 StatusACTIVE여야 합니다. 상태를 확인하려면 DescribeDatasetGroup작업을 사용하세요.

구문 요청

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

요청 파라미터

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

DatasetArns

데이터 세트 그룹에 포함시키려는 데이터 세트의 Amazon 리소스 이름(ARN) 배열입니다.

유형: 문자열 어레이

길이 제약: 최대 길이 256.

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

Required: No

DatasetGroupName

데이터 세트 그룹의 이름입니다.

유형: 문자열

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

패턴: ^[a-zA-Z][a-zA-Z0-9_]*

필수 사항 여부: Yes

Domain

데이터 세트 그룹과 연결된 도메인입니다. 데이터셋 그룹에 데이터세트를 추가할 때 이 값과 CreateDataset작업 Domain 매개변수에 지정된 값이 일치해야 합니다.

선택하는 DomainDatasetType에 따라 데이터 세트로 가져오는 훈련 데이터에 있어야 하는 필드가 결정됩니다. 예를 들어 RETAIL 도메인과 TARGET_TIME_SERIESDatasetType으로 선택하면 Amazon Forecast에서 데이터에 item_id, timestampdemand 필드가 있어야 합니다. 자세한 내용을 알아보려면 데이터 세트 그룹을 참조하세요.

타입: 문자열

유효 값: RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS

필수 사항 여부: 예

Tags

데이터 세트 그룹을 분류하고 구성하는 데 도움이 되도록 데이터 세트에 적용하는 선택적 메타데이터입니다. 각 태그는 사용자가 정의하는 키와 선택적 값으로 구성됩니다.

태그에 적용되는 기본 제한은 다음과 같습니다.

  • 리소스당 최대 태그 수 - 50개.

  • 각 리소스에 대해 각 태그 키는 고유하며 하나의 값만 가질 수 있습니다.

  • 최대 키 길이 - 유니코드 문자 128자(UTF-8).

  • 최대 값 길이 - 유니코드 문자 256자(UTF-8).

  • 태깅 스키마를 여러 서비스와 리소스에서 사용하는 경우 다른 서비스 또한 허용되는 문자에 대한 제한이 있을 수 있음을 유의합니다. 일반적으로 허용되는 문자는 UTF-8로 표현할 수 있는 문자, 숫자 및 공백과 특수 문자 + - = . _ : / @.

  • 태그 키와 값은 대소문자를 구분합니다.

  • 키 접두사와 같은 대문자 또는 소문자 조합은 사용하도록 aws: 예약되어 있으므로 사용하지 마세요. AWS: AWS 이 접두사가 있는 태그 키는 편집하거나 삭제할 수 없습니다. 값에 이 접두사가 포함될 수 있습니다. 태그 값에는 접두사로 aws가 있지만 키에는 없는 경우 Forecast는 해당 태그를 사용자 태그로 간주하여 50개 태그 한도에 포함합니다. aws 키 접두사만 있는 태그는 리소스당 태그 수 한도에 포함되지 않습니다.

유형: Tag객체 어레이

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

필수 여부: 아니요

응답 구문

{ "DatasetGroupArn": "string" }

응답 요소

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

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

DatasetGroupArn

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

타입: 문자열

길이 제약: 최대 길이 256.

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

Errors

InvalidInputException

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

HTTP 상태 코드: 400

LimitExceededException

계정당 리소스 수 제한을 초과했습니다.

HTTP 상태 코드: 400

ResourceAlreadyExistsException

이 이름을 가진 리소스가 이미 있습니다. 다른 이름으로 다시 시도하세요.

HTTP 상태 코드: 400

ResourceInUseException

지정된 리소스가 이미 사용 중입니다.

HTTP 상태 코드: 400

ResourceNotFoundException

해당 Amazon 리소스 이름(ARN)으로 리소스를 찾을 수 없습니다. ARN을 확인하고 다시 시도하세요.

HTTP 상태 코드: 400

참고

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