기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
함수 생성 및 관리
이 페이지에서는 MediaTailor 콘솔을 사용하여 함수를 생성, 연결, 업데이트 및 삭제하는 방법을 안내합니다. 함수를 사용하면 재생 중에 키 포인트에서 로직을 실행하여 세션 동작 및 광고 요청을 사용자 지정할 수 있습니다.
함수 설정
콘솔을 사용하여 함수 생성
-
https://console.aws.amazon.com/mediatailor/
MediaTailor 콘솔을 엽니다. -
탐색 창에서 함수를 선택합니다.
-
함수 생성을 선택합니다.
-
함수 ID에 함수의 고유한 이름(예:
fetchIdentity)을 입력합니다. -
함수 유형에서 , 또는
CUSTOM_OUTPUTHTTP_REQUEST를 선택합니다SEQUENTIAL_EXECUTOR. 콘솔에 선택한 유형의 구성 필드가 표시됩니다. -
유형별 구성 필드를 입력합니다. 각 함수 유형 및 해당 필드에 대한 설명은 섹션을 참조하세요함수 유형 및 구성.
-
함수 생성을 선택합니다.
재생 구성에 함수 연결
함수 매핑(수명 주기 후크와 함수 간의 링크)을 통해 재생 구성에 연결할 때까지 함수는 실행되지 않습니다. 함수 매핑은 함수를 트리거하는 수명 주기 후크를 지정합니다.
-
MediaTailor 콘솔을 엽니다.
-
탐색 창에서 구성을 선택합니다.
-
업데이트할 재생 구성을 선택합니다.
-
함수 매핑 섹션에서 편집을 선택합니다.
-
각 수명 주기 후크에 대해 연결할 함수를 선택합니다.
-
세션 초기화 후크 - 세션 시작 시 한 번 실행할 함수를 선택합니다.
-
광고 요청 후크 - 각 ADS 요청 전에 실행할 함수를 선택합니다.
-
-
저장을 선택합니다.
함수 관리
함수 보기
함수로 이동하여 계정의 모든 함수를 확인합니다. 함수 이름을 선택하여 구성을 확인합니다.
기존 함수 업데이트
함수를 업데이트하려면 함수로 이동하여 함수를 선택하고 구성을 수정합니다. 업데이트는 전체 함수 정의를 대체합니다.
작은 정보
변경하기 전에 함수 구성의 사본을 저장합니다. 함수에 대한 기본 제공 버전 관리 또는 롤백은 없습니다.
함수 제거
재생 구성에서 함수 분리
함수를 삭제하기 전에 함수를 참조하는 모든 재생 구성에서 함수를 제거합니다.
-
MediaTailor 콘솔을 엽니다.
-
탐색 창에서 구성을 선택합니다.
-
재생 구성을 선택합니다.
-
함수 매핑 섹션에서 편집을 선택합니다.
-
수명 주기 후크에서 함수를 제거합니다.
-
저장을 선택합니다.
함수 삭제
함수로 이동하여 함수를 선택한 다음 삭제를 선택합니다.
삭제 차단 규칙
MediaTailor는 아직 사용 중인 함수를 삭제하지 못하도록 합니다.
| 조건 | 결과 |
|---|---|
| 함수는 함수 매핑을 통해 재생 구성에 연결됩니다. | 삭제가 차단되었습니다. 먼저 함수를 분리합니다. |
함수는에서 참조됩니다. SEQUENTIAL_EXECUTOR |
삭제가 차단되었습니다. 먼저 상위 함수에서 참조를 제거합니다. |
| 함수는 어디에서도 참조되지 않음 | 삭제에 성공합니다. |
검증 규칙
MediaTailor는 함수를 생성하거나 업데이트할 때 함수를 검증합니다. 다음 검사가 수행됩니다.
-
표현식 구문 - 모든 표현식은 유효한 JSONata여야 합니다.
-
제한된 함수 - 표현식은 제한된 JSONata 함수를 호출할 수 없습니다. 전체 목록은 섹션을 참조JSONata 표현식 참조하세요.
-
출력 키 접두사 - 모든 출력 키는 인식된 네임스페이스 접두사로 시작해야 합니다. 허용되는 접두사 목록은 섹션을 참조하세요수명 주기 후크.
-
함수 참조 -의 모든 함수 IDs는 기존 함수를 참조
FunctionList해야 합니다. -
순환 참조 - 함수는 직접 또는 간접적으로 자신을 참조할 수 없습니다.
-
중첩 깊이 -는 다른 함수를 호출할
SEQUENTIAL_EXECUTOR수 있지만 해당 함수 자체SEQUENTIAL_EXECUTOR는 일 수 없습니다.
특정 값 및 크기 제한은 섹션을 참조하세요한도.
API 참조
프로그래밍 방식으로 함수를 관리하려면 AWS Elemental MediaTailor API 참조를 참조하세요.
