View a markdown version of this page

함수 제한 - AWS Elemental MediaTailor

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

함수 제한

이 페이지에는 함수에 적용되는 제한이 나열되어 있습니다. 이러한 제한은 작성 시간(함수를 생성하거나 업데이트할 때) 및 런타임(함수가 실행될 때)에 적용됩니다.

후크 실행 제한

후크 한도 값
PRE_SESSION_INITIALIZATION 총 제한 시간 2,000ms
PRE_SESSION_INITIALIZATION 총 player_params 크기 1,000자
PRE_ADS_REQUEST 총 제한 시간 2,000ms
POST_ADS_RESPONSE 총 제한 시간 2,000ms
POST_ADS_RESPONSE 입력 페이로드 크기 128KB
POST_ADS_RESPONSE 출력 크기 256KB
PRE_MANIFEST_INSERTION 총 제한 시간 2,000ms
PRE_MANIFEST_INSERTION 입력 페이로드 크기 128KB
PRE_MANIFEST_INSERTION 출력 크기 256KB
PRE_MANIFEST_INSERTION 호출당 주입된 광고 10
요청 경로 후크 결합(요청당) 공유 실행 예산 2,000ms

이러한 제한 시간은 모든 함수 단계 및 HTTP 호출을 포함하여 전체 후크 실행을 포함합니다. 후크가 제한 시간을 초과하면 MediaTailor는 모든 출력을 삭제하고 연결된 함수가 없는 것처럼 진행합니다.

각 후크의 자체 제한 시간 외에도 단일 요청 내에서 실행되는 PRE_ADS_REQUESTPOST_ADS_RESPONSE, 및 PRE_MANIFEST_INSERTION 후크는 2,000ms의 통합 실행 예산을 공유합니다. 이전 후크에서 소요된 시간은 동일한 요청의 이후 후크에 사용할 수 있는 예산을 줄이고 후크의 유효 제한 시간은 자체 제한 시간과 나머지 예산 중 작은 값입니다. 후크가 시작되기 전에 예산이 소진되면 MediaTailor는 해당 후크를 완전히 건너뛰고 요청을 계속 처리합니다.는 세션 초기화 중에 PRE_SESSION_INITIALIZATION 실행되며 결합된 예산의 일부가 아닙니다.

입력 페이로드 크기 제한은 MediaTailor가 POST_ADS_RESPONSE 및 PRE_MANIFEST_INSERTION 후크에 대해 빌드하는 직렬화된 JSON 입력에 적용됩니다. 입력이 128KB를 초과하면 MediaTailor는 해당 요청에 대한 후크 호출을 건너뜁니다. 출력 크기 제한은 함수가 후크의 쓰기 가능한 네임스페이스에 쓸 수 있는 직렬화된 총 크기를 제한합니다. 256KB를 초과하는 출력은 삭제됩니다.

개별 함수 제한 시간(예: HTTP_REQUEST 함수RequestTimeoutMilliseconds의 경우)은 후크의 총 제한 시간 내에 있어야 합니다. 예를 들어 후크 제한 시간이 2,000ms이고 HTTP_REQUEST 함수가 2,000msRequestTimeoutMilliseconds로 설정된 경우 HTTP 호출 전후에 처리가 발생하는 경우 함수가 완료되기 전에 시간 초과될 수 있습니다.

player_params 총 크기에는 모든 출력 키 이름 및 값의 결합된 문자 수가 포함됩니다. 예를 들어 및를 출력하면 player_params.deviceType = "mobile" player_params.region = "us-east-1" deviceType, region, mobile및가 1,000자 합계에 us-east-1 포함됩니다.

표현식 제한

한도 값 에 적용됨
표현식당 CPU 시간 100ms 런타임
스택 깊이 100 런타임
표현식 길이 1,000자 작성

표현식이 런타임 시 제한을 초과하면 MediaTailor는 표현식을 중지하고 오류를 기록합니다. 특정 오류 유형에 대한 자세한 내용은 섹션을 참조하세요문제 해결 및 모니터링.

함수 구성 제한

한도 값
순차 실행기당 단계 1~10
동시 실행기당 하위 항목 1~10
최대 동시성(동시 실행기) 1~2
기본 제한 시간(동시 실행기) 2,000ms
동시 실행기당 고유한 네임스페이스 필수(작성 시 검증됨)
최대 중첩 깊이 2
후크당 총 함수 실행 수 20
함수당 출력 항목 20
순환 참조 허용되지 않음

이러한 제한은 작성 시 적용됩니다.

HTTP 요청 제한

한도 값
URL 표현식 길이 25,000자
URL 길이(평가 후) 2,048자
본문 표현식 길이 100,000자
요청 본문 크기(평가 후) 64KB
헤더 수 50
헤더 이름 길이 256자
헤더 값 길이 8,192자
요청 제한 시간 100~2,000ms(를 통해 고객 구성 가능RequestTimeoutMilliseconds)
허용된 URL 체계 https, http
제한된 헤더 Host, Transfer-Encoding, Content-Length, Connection

표현식 길이 제한 및 헤더 제한은 함수를 생성하거나 업데이트할 때 작성 시 적용됩니다. MediaTailor가 표현식을 평가한 후 런타임 시 평가된 URL 및 본문 크기 제한, 요청 제한 시간 및 제한된 헤더가 적용됩니다. 작성 시 수락되는 URL 표현식은 런타임 시 평가된 URL 제한을 여전히 초과할 수 있으며,이 경우에도 요청이 전송되지 않습니다.

함수가 제한된 헤더를 설정하는 경우 MediaTailor는 작성 시 함수 구성을 수락하지만 실행 중에 HTTP 요청이 전송될 때 헤더를 삭제합니다.

응답 제한

한도 값
response.body 최대 크기 20,000자
response.text 최대 길이 20,000자

이러한 제한은 런타임에 적용됩니다.

출력 제한

한도 값
출력 값 최대 길이(키당) 1,000자

이러한 제한은 런타임에 적용됩니다.

허용된 JSONata 함수

허용되는 함수의 전체 목록은 섹션을 참조하세요JSONata 표현식 참조.

이러한 제한과 관련된 오류를 진단하는 데 도움이 필요하면 섹션을 참조하세요문제 해결 및 모니터링.