본문으로 바로가기 본문 바로가기
WIKI 기술 지식 베이스

사용 가능한 설정

원문 보기 위키 갱신

사용 가능한 설정 (Available settings)

Cache Response Rule을 만들 때 구성할 수 있는 설정이에요. Cache Response Rules는 Cloudflare가 오리진 응답을 받은 후에 실행되므로, 규칙 일치에 요청 및 응답 필드가 모두 사용 가능해요.

출처: 문서

본문

표현식 필드

요청 필드

필드 유형 설명
http.cookie String 전체 쿠키 헤더 값
http.host String HTTP Host 헤더
http.referer String HTTP Referer 헤더
http.user_agent String HTTP User-Agent 헤더
http.request.method String HTTP 요청 메서드
http.request.uri String 요청 URI
http.request.uri.path String URI 경로
http.request.uri.path.basename String URI 경로의 basename
http.request.uri.path.extension String URI 경로의 파일 확장자
http.request.uri.query String 쿼리 문자열
http.request.uri.args Map 키-값 쌍으로 된 쿼리 문자열 인자
http.request.uri.args.names Array 쿼리 문자열 인자 이름
http.request.uri.args.values Array 쿼리 문자열 인자 값
http.request.full_uri String scheme과 host를 포함한 전체 요청 URI
http.request.headers Map 키-값 쌍으로 된 요청 헤더
http.request.headers.names Array 요청 헤더 이름
http.request.headers.values Array 요청 헤더 값
http.request.cookies Map 키-값 쌍으로 파싱된 쿠키
http.request.accepted_languages Array 파싱된 Accept-Language 헤더 값

응답 필드

필드 유형 설명
http.response.code Integer 오리진의 HTTP 응답 상태 코드
http.response.headers Map 키-값 쌍으로 된 응답 헤더
http.response.headers.names Array 응답 헤더 이름
http.response.headers.values Array 응답 헤더 값

Edit expression 옵션을 선택하면 위 응답 필드 중 어떤 것이든 입력할 수 있어요.

함수

이 단계에서 사용할 수 있는 함수:

  • all
  • any
  • concat
  • decode_base64
  • ends_with
  • len
  • lookup_json_integer
  • lookup_json_string
  • lower
  • regex_replace
  • remove_bytes
  • remove_query_args
  • split
  • starts_with
  • substring
  • to_string
  • upper
  • url_decode
  • wildcard_replace

각 함수의 설명은 Functions를 참고해요.

연산자

전체 연산자 목록은 Operators를 참고해요.

사용 가능한 액션

Cache Response Rules는 세 가지 액션을 지원해요:

액션 설명
set_cache_settings 캐싱 전에 오리진 응답에서 헤더(ETags, Set-Cookie, Last-Modified)를 제거해요.
set_cache_tags 대상 제거(purging)를 위해 응답에 캐시 태그를 추가, 제거, 또는 설정해요.
set_cache_control 오리진 응답의 Cache-Control 헤더 지시어를 수정해요.

액션: set_cache_settings

오리진 응답의 캐싱과 관련된 설정을 구성해요. 다음 매개변수를 사용할 수 있어요:

매개변수 유형 설명
strip_etags Boolean 캐싱 전에 오리진 응답에서 ETag 헤더를 제거해요.
strip_set_cookie Boolean 캐싱 전에 오리진 응답에서 Set-Cookie 헤더를 제거해요.
strip_last_modified Boolean 캐싱 전에 오리진 응답에서 Last-Modified 헤더를 제거해요.

참고 — 일치하는 모든 규칙을 적용한 후 strip_etags 또는 strip_last_modified가 true이면, 오리진 응답에 대해 Smart Edge Revalidation ↗︎이 비활성화돼요.

API 정보

API 액션: set_cache_settings.

API 구성 예시json

"action_parameters": {
  "strip_etags": true,
  "strip_set_cookie": true,
  "strip_last_modified": true
}

전체 API 예시는 Create a rule via API를 참고해요.

액션: set_cache_tags

응답과 연결된 캐시 태그를 수정해요. 캐시 태그는 대상 캐시 제거(purging)에 사용할 수 있어요.

매개변수 유형 설명
operation String 필수. add, remove, set 중 하나.
values Array 캐시 태그 문자열 목록. expression과 상호 배타적.
expression String 캐시 태그 배열로 평가되는 표현식. values와 상호 배타적.

API 정보

API 액션: set_cache_tags.

API 구성 예시 (정적 값)json

"action_parameters": {
  "operation": "set",
  "values": ["api-response", "dynamic-content"]
}

API 구성 예시 (표현식)json

"action_parameters": {
  "operation": "add",
  "expression": "split(http.response.headers[\"Surrogate-Keys\"][0], \",\", 1)"
}

전체 API 예시는 Create a rule via API를 참고해요.

액션: set_cache_control

오리진 응답의 Cache-Control 헤더 지시어를 수정해요.

지원되는 지시어

기간 값(초)이 있는 지시어:

  • max-age
  • s-maxage
  • stale-if-error
  • stale-while-revalidate

선택적 한정자(헤더 이름)가 있는 지시어:

  • private
  • no-cache

불리언 지시어:

  • no-store
  • no-transform
  • must-revalidate
  • proxy-revalidate
  • must-understand
  • public
  • immutable

지시어 구성

사용 가능한 매개변수는 지시어 유형에 따라 달라져요.

기간 값이 있는 지시어

max-age, s-maxage, stale-if-error, stale-while-revalidate에 적용돼요.

매개변수 유형 설명
operation String 필수. set 또는 remove.
cloudflare_only Boolean 활성화하면 이 설정은 Cloudflare가 콘텐츠를 캐시하는 방식에만 영향을 줘요. 방문자는 여전히 원래 지시어를 받아요.
value Integer 초 단위 기간. operation이 set일 때 필수.
선택적 한정자가 있는 지시어

private와 no-cache에 적용돼요.

매개변수 유형 설명
operation String 필수. set 또는 remove.
cloudflare_only Boolean 활성화하면 이 설정은 Cloudflare가 콘텐츠를 캐시하는 방식에만 영향을 줘요. 방문자는 여전히 원래 지시어를 받아요.
qualifiers Array 지시어를 한정하는 선택적 헤더 이름 목록.
불리언 지시어

no-store, no-transform, must-revalidate, proxy-revalidate, must-understand, public, immutable에 적용돼요.

매개변수 유형 설명
operation String 필수. set 또는 remove.
cloudflare_only Boolean 활성화하면 이 설정은 Cloudflare가 콘텐츠를 캐시하는 방식에만 영향을 줘요. 방문자는 여전히 원래 지시어를 받아요.

API 정보

API 액션: set_cache_control.

API 구성 예시json

"action_parameters": {
  "max-age": {
    "operation": "set",
    "value": 3600,
    "cloudflare_only": true
  },
  "stale-if-error": {
    "operation": "remove"
  }
}

전체 API 예시는 Create a rule via API를 참고해요.

더 알아보기 (Learn more)

Cache Response Rule의 일치에 사용할 요청·응답 필드, 함수, 연산자, 그리고 set_cache_settings·set_cache_tags·set_cache_control 액션의 매개변수 구성을 정리한 참조 문서예요.