일반 헬퍼 메서드

이 페이지에서는 CloudFront Functions 내의 추가 헬퍼 메서드를 제공합니다. 이러한 메서드를 사용하려면 JavaScript 런타임 2.0을 사용하여 CloudFront Functions를 생성합니다.

import cf from 'cloudfront';

자세한 내용은 CloudFront Functions를 위한 JavaScript 런타임 2.0 기능 섹션을 참조하세요.

edgeLocation 메타데이터

이 메서드를 사용하려면 cloudfront 모듈을 사용해야 합니다.

이 JavaScript 객체를 사용하여 요청을 처리하는 데 사용되는 엣지 로케이션 공항 코드, 예상 리전 엣지 캐시 리전 또는 CloudFront 서버 IP 주소를 가져옵니다. 이 메타데이터는 뷰어 요청 이벤트 트리거만 사용할 수 있습니다.

cf.edgeLocation = {
    name: SEA
    serverIp: 1.2.3.4
    region: us-west-2
}

cf.edgeLocation 객체에는 다음 사항이 포함될 수 있습니다.

rawQueryString() 메서드

이 메서드에는 cloudFront 모듈이 필요하지 않습니다.

rawQueryString() 메서드를 사용하여 구문 분석되지 않은 쿼리 문자열과 변경되지 않은 쿼리 문자열을 문자열로 검색합니다.

요청

function handler(event) {
    var request = event.request;
    const qs = request.rawQueryString();
}

응답

수신 요청의 전체 쿼리 문자열을 선행 ? 없이 문자열 값으로 반환합니다.

logCustomData() 메서드

이 방법을 사용하려면 cloudfront 모듈을 가져옵니다.

logCustomData() 메서드를 사용하여 Amazon CloudFront 함수의 사용자 지정 데이터를 CloudFront 액세스 로그로 전송합니다. 함수가 뷰어 요청과 연결되어 있는지 아니면 뷰어 응답 이벤트와 연결되어 있는지에 따라 데이터가 viewer-request-log-data 또는 viewer-response-log-data 로그 필드에 기록됩니다.

메서드는 단일 문자열 인수를 허용합니다. 객체를 로깅하려면 먼저 JSON.stringify()를 사용하여 객체를 문자열로 변환합니다. 예제:

const resp_obj = JSON.stringify(some_obj);
cf.logCustomData(resp_obj);

각 필드는 최대 800바이트의 데이터를 지원합니다. CloudFront는 데이터를 로그 필드에 쓰기 전에 자동으로 URL 인코딩합니다. CloudFront는 URL 인코딩 후 800바이트를 초과하는 모든 데이터를 잘라냅니다. 함수가 단일 실행 내에서 logCustomData()를 여러 번 직접 호출하는 경우 CloudFront는 마지막 값만 사용합니다.

메서드는 다음과 같은 구문을 사용합니다.

cf.logCustomData(String);

import cf from 'cloudfront';

function handler(event) {
    var request = event.request;

    // Check if the debug header exists, if so log it
    if (request.headers['x-debug-header']) {
        // Log the debug header value
        cf.logCustomData("debug header found: " + request.headers['x-debug-header'].value);
    }

    return request;
}