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

# 함수 생성 및 관리
<a name="monetization-functions-managing"></a>

이 페이지에서는 MediaTailor 콘솔을 사용하여 함수를 생성, 연결, 업데이트 및 삭제하는 방법을 안내합니다. 함수를 사용하면 재생 중에 키 포인트에서 로직을 실행하여 세션 동작 및 광고 요청을 사용자 지정할 수 있습니다.

## 함수 설정
<a name="monetization-functions-managing-setup"></a>

### 콘솔을 사용하여 함수 생성
<a name="monetization-functions-managing-create-console"></a>

1. [https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/) MediaTailor 콘솔을 엽니다.

1. 탐색 창에서 **함수**를 선택합니다.

1. **함수 생성**을 선택합니다.

1. **함수 ID**에 함수의 고유한 이름(예: `fetchIdentity`)을 입력합니다.

1. **함수 유형**에서 , 또는 `CUSTOM_OUTPUT``HTTP_REQUEST`를 선택합니다`SEQUENTIAL_EXECUTOR`. 콘솔에 선택한 유형의 구성 필드가 표시됩니다.

1. 유형별 구성 필드를 입력합니다. 각 함수 유형 및 해당 필드에 대한 설명은 섹션을 참조하세요[함수 유형 및 구성](monetization-functions-types.md).

1. **함수 생성**을 선택합니다.

### 재생 구성에 함수 연결
<a name="monetization-functions-managing-attach"></a>

함수 매핑(수명 주기 후크와 함수 간의 링크)을 통해 재생 구성에 연결할 때까지 함수는 실행되지 않습니다. 함수 매핑은 함수를 트리거하는 수명 주기 후크를 지정합니다.

1. MediaTailor 콘솔을 엽니다.

1. 탐색 창에서 **구성을** 선택합니다.

1. 업데이트할 재생 구성을 선택합니다.

1. **함수 매핑** 섹션에서 **편집**을 선택합니다.

1. 각 수명 주기 후크에 대해 연결할 함수를 선택합니다.
   + **세션 초기화 후크** - 세션 시작 시 한 번 실행할 함수를 선택합니다.
   + **광고 요청 후크** - 각 ADS 요청 전에 실행할 함수를 선택합니다.

1. **저장**을 선택합니다.

## 함수 관리
<a name="monetization-functions-managing-ops"></a>

### 함수 보기
<a name="monetization-functions-managing-view"></a>

**함수**로 이동하여 계정의 모든 함수를 확인합니다. 함수 이름을 선택하여 구성을 확인합니다.

### 기존 함수 업데이트
<a name="monetization-functions-managing-update"></a>

함수를 업데이트하려면 **함수**로 이동하여 함수를 선택하고 구성을 수정합니다. 업데이트는 전체 함수 정의를 대체합니다.

**작은 정보**  
변경하기 전에 함수 구성의 사본을 저장합니다. 함수에 대한 기본 제공 버전 관리 또는 롤백은 없습니다.

## 함수 제거
<a name="monetization-functions-managing-remove"></a>

### 재생 구성에서 함수 분리
<a name="monetization-functions-managing-detach"></a>

함수를 삭제하기 전에 함수를 참조하는 모든 재생 구성에서 함수를 제거합니다.

1. MediaTailor 콘솔을 엽니다.

1. 탐색 창에서 **구성을** 선택합니다.

1. 재생 구성을 선택합니다.

1. **함수 매핑** 섹션에서 **편집**을 선택합니다.

1. 수명 주기 후크에서 함수를 제거합니다.

1. **저장**을 선택합니다.

### 함수 삭제
<a name="monetization-functions-managing-delete"></a>

**함수**로 이동하여 함수를 선택한 다음 **삭제**를 선택합니다.

### 삭제 차단 규칙
<a name="monetization-functions-managing-delete-blocking"></a>

MediaTailor는 아직 사용 중인 함수를 삭제하지 못하도록 합니다.


| 조건 | 결과 | 
| --- | --- | 
| 함수는 함수 매핑을 통해 재생 구성에 연결됩니다. | 삭제가 차단되었습니다. 먼저 함수를 분리합니다. | 
| 함수는에서 참조됩니다. SEQUENTIAL\_EXECUTOR  | 삭제가 차단되었습니다. 먼저 상위 함수에서 참조를 제거합니다. | 
| 함수는 어디에서도 참조되지 않음 | 삭제에 성공합니다. | 

## 검증 규칙
<a name="monetization-functions-managing-validation"></a>

MediaTailor는 함수를 생성하거나 업데이트할 때 함수를 검증합니다. 다음 검사가 수행됩니다.
+ **표현식 구문 **- 모든 표현식은 유효한 JSONata여야 합니다.
+ **제한된 함수** - 표현식은 제한된 JSONata 함수를 호출할 수 없습니다. 전체 목록은 섹션을 참조[JSONata 표현식 참조](monetization-functions-jsonata.md)하세요.
+ **출력 키 접두사** - 모든 출력 키는 인식된 네임스페이스 접두사로 시작해야 합니다. 허용되는 접두사 목록은 섹션을 참조하세요[수명 주기 후크](monetization-functions-hooks.md).
+ **함수 참조 **-의 모든 함수 IDs는 기존 함수를 참조`FunctionList`해야 합니다.
+ **순환 참조 **- 함수는 직접 또는 간접적으로 자신을 참조할 수 없습니다.
+ **중첩 깊이 **-는 다른 함수를 호출할 `SEQUENTIAL_EXECUTOR` 수 있지만 해당 함수 자체`SEQUENTIAL_EXECUTOR`는 일 수 없습니다.

특정 값 및 크기 제한은 섹션을 참조하세요[한도](monetization-functions-limits.md).

## API 참조
<a name="monetization-functions-managing-api-ref"></a>

프로그래밍 방식으로 함수를 관리하려면 [AWS Elemental MediaTailor API 참조](https://docs.aws.amazon.com/mediatailor/latest/apireference/)를 참조하세요.