CreateEventTracker - Personalize
구문 요청요청 파라미터응답 구문응답 요소Errors참고

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

CreateEventTracker

PutEventsAPI를 사용하여 지정된 데이터세트 그룹에 이벤트 데이터를 추가할 때 사용하는 이벤트 트래커를 만듭니다.

참고

이벤트 트래커 하나만 데이터세트 그룹과 연결할 수 있습니다. 기존의 이벤트 트래커와 동일한 데이터세트 그룹을 사용하여 CreateEventTracker를 호출하는 경우 오류가 발생합니다.

이벤트 추적기를 만들면 응답에 추적 ID가 포함되며, 추적 ID는 PutEvents작업 사용 시 매개변수로 전달됩니다. 그러면 Amazon Personalize는 이벤트 트래커에서 지정한 데이터 세트 그룹의 항목 상호 작용 데이터 세트에 이벤트 데이터를 추가합니다.

이벤트 트래커는 다음 상태 중 하나일 수 있습니다.

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE 또는 CREATE FAILED

  • DELETE PENDING > DELETE IN_PROGRESS

이벤트 트래커의 상태를 확인하려면 를 호출하십시오 DescribeEventTracker.

참고

추적 ID를 사용하려면 이벤트 트래커가 ACTIVE 상태여야 합니다.

관련 API

구문 요청

{
   "datasetGroupArn": "string",
   "name": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

요청 파라미터

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

datasetGroupArn

이벤트 데이터를 수신하는 데이터세트 그룹의 리소스 이름(ARN)입니다.

타입: 문자열

길이 제약: 최대 길이 256.

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

필수 사항 여부: Yes

name

이벤트 트래커의 이름.

유형: 문자열

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

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

필수 사항 여부: Yes

tags

이벤트 트래커에 적용할 태그의 목록입니다.

유형: Tag객체 어레이

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

필수 여부: 아니요

응답 구문

{
   "eventTrackerArn": "string",
   "trackingId": "string"
}

응답 요소

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

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

eventTrackerArn

이벤트 트래커의 ARN입니다.

타입: 문자열

길이 제약: 최대 길이 256.

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

trackingId

이벤트 트래커의 ID. PutEventsAPI에 대한 요청에 이 ID를 포함시키십시오.

타입: 문자열

길이 제약: 최대 길이 256.

Errors

InvalidInputException

필드 또는 파라미터에 유효한 값을 제공합니다.

HTTP 상태 코드: 400

LimitExceededException

초당 요청 수 한도를 초과했습니다.

HTTP 상태 코드: 400

ResourceAlreadyExistsException

지정된 리소스가 이미 있습니다.

HTTP 상태 코드: 400

ResourceInUseException

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

HTTP 상태 코드: 400

ResourceNotFoundException

지정된 리소스를 찾을 수 없습니다.

HTTP 상태 코드: 400

TooManyTagsException

이 리소스에 적용할 수 있는 최대 태그 수를 초과했습니다.

HTTP 상태 코드: 400

참고

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