기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# CreateEventTracker
[PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) API를 사용하여 지정된 데이터세트 그룹에 이벤트 데이터를 추가할 때 사용하는 이벤트 트래커를 만듭니다.
**참고**
이벤트 트래커 하나만 데이터세트 그룹과 연결할 수 있습니다. 기존의 이벤트 트래커와 동일한 데이터세트 그룹을 사용하여 `CreateEventTracker`를 호출하는 경우 오류가 발생합니다.
이벤트 트래커를 만들 때 응답에는 [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) 작업을 사용할 때 파라미터로 전달하는 추적 ID가 포함됩니다. 그러면 Amazon Personalize는 이벤트 트래커에서 지정한 데이터 세트 그룹의 항목 상호 작용 데이터 세트에 이벤트 데이터를 추가합니다.
이벤트 트래커는 다음 상태 중 하나일 수 있습니다.
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE 또는 CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
이벤트 트래커의 상태를 확인하려면 [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html)를 호출합니다.
**참고**
추적 ID를 사용하려면 이벤트 트래커가 ACTIVE 상태여야 합니다.
**관련 API**
+ [ListEventTrackers](https://docs.aws.amazon.com/personalize/latest/dg/API_ListEventTrackers.html)
+ [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html)
+ [DeleteEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteEventTracker.html)
## 구문 요청
```
{
"datasetGroupArn": "string",
"name": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}
```
## 요청 파라미터
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [datasetGroupArn](#API_CreateEventTracker_RequestSyntax) **
이벤트 데이터를 수신하는 데이터세트 그룹의 리소스 이름(ARN)입니다.
유형: 문자열
길이 제약: 최대 길이 256.
패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+`
필수 여부: 예
** [name](#API_CreateEventTracker_RequestSyntax) **
이벤트 트래커의 이름.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이 63.
패턴: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`
필수 여부: 예
** [tags](#API_CreateEventTracker_RequestSyntax) **
이벤트 트래커에 적용할 [태그](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)의 목록입니다.
유형: [Tag](API_Tag.md)객체 어레이
어레이 멤버: 최소 항목 수 0개. 최대 항목 수 200개.
필수 여부: 아니요
## 응답 구문
```
{
"eventTrackerArn": "string",
"trackingId": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [eventTrackerArn](#API_CreateEventTracker_ResponseSyntax) **
이벤트 트래커의 ARN입니다.
유형: 문자열
길이 제약: 최대 길이 256.
패턴: `arn:([a-z\d-]+):personalize:.*:.*:.+`
** [trackingId](#API_CreateEventTracker_ResponseSyntax) **
이벤트 트래커의 ID. [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) API에 대한 요청에 이 ID를 포함시킵니다.
유형: 문자열
길이 제약: 최대 길이 256.
## 오류
** InvalidInputException **
필드 또는 파라미터에 유효한 값을 제공합니다.
HTTP 상태 코드: 400
** LimitExceededException **
초당 요청 수 한도를 초과했습니다.
HTTP 상태 코드: 400
** ResourceAlreadyExistsException **
지정된 리소스가 이미 있습니다.
HTTP 상태 코드: 400
** ResourceInUseException **
지정된 리소스가 이미 사용 중입니다.
HTTP 상태 코드: 400
** ResourceNotFoundException **
지정된 리소스를 찾을 수 없습니다.
HTTP 상태 코드: 400
** TooManyTagsException **
이 리소스에 적용할 수 있는 최대 태그 수를 초과했습니다.
HTTP 상태 코드: 400
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateEventTracker)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateEventTracker)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateEventTracker)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateEventTracker)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateEventTracker)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateEventTracker)