View a markdown version of this page

태그를 무효화할 때 알아야 할 사항 - Amazon CloudFront

태그를 무효화할 때 알아야 할 사항

무효화할 태그를 지정할 때 다음 정보를 참조합니다.

옵트인 필요

태그 무효화는 CacheTagConfig가 구성된 배포에서만 작동합니다. 이 구성이 없는 배포는 오리진의 캐시 태그 헤더를 무시합니다. 자세한 내용은 캐시 태그로 콘텐츠 무효화 섹션을 참조하세요.

태그 무효화 접두사

태그 무효화 항목은 # 문자로 시작해야 합니다. 예를 들어, product:electronics 태그가 지정된 모든 캐시된 객체를 무효화하려면 Paths.Items 목록에 #product:electronics를 지정합니다.

대/소문자를 구분하나요?

태그 값은 대소문자를 구분하지 않습니다. 예를 들어, #Product:Electronics와 #product:electronics는 동일한 태그를 나타냅니다.

태그 형식

각 태그 값은 쉼표를 제외하고 ASCII 문자(33~126자)만 포함해야 합니다. 태그의 최대 길이는 256자입니다.

와일드카드 미지원

경로 무효화와 달리 태그 무효화 항목은 * 와일드카드를 지원하지 않습니다. # 접두사가 붙은 각 항목은 정확한 태그 값과 일치합니다.

캐시된 객체당 최대 태그 수

CloudFront는 캐시된 객체당 최대 50개의 태그를 처리합니다. 오리진 응답의 구성된 헤더에 50개 이상의 태그가 포함된 경우, 제한을 초과하는 추가 태그는 저장되지 않으며 무효화에 사용할 수 없습니다.

쿠키, 헤더 및 쿼리 문자열 전달

태그를 기반으로 무효화하는 경우, CloudFront는 연결된 쿠키, 헤더 또는 쿼리 문자열 파라미터와 관계없이 지정된 태그를 포함하는 모든 객체의 캐시된 모든 변형을 무효화합니다. 특정 변형만 선택적으로 무효화할 수는 없습니다.

혼합 경로 및 태그 무효화

CreateInvalidation 요청의 동일한 무효화 배치에 경로 항목(예: /images/*)과 태그 항목(예: #brand:acme)을 모두 포함할 수 있습니다. 각 항목은 제한에 따라 하나의 무효화 경로로 계산됩니다.

최대 허용

태그 무효화 항목은 경로 항목과 동일한 동시 무효화 제한에 따라 계산됩니다. 각 항목은 하나의 무효화 경로로 계산됩니다. 자세한 내용은 무효화에 대한 할당량 섹션을 참조하세요.

헤더 이름 변경

CacheTagConfig에서 HeaderName을 변경하면 이전 헤더 이름으로 추출된 태그에 대해 발행된 무효화는 더 이상 평가되지 않습니다. 헤더 이름을 변경하기 전에 다음을 수행합니다.

  1. 오리진에서 이전 캐시 태그 헤더와 새 캐시 태그 헤더의 반환을 시작합니다.

  2. 경로 무효화(예: /*)를 실행하거나 기존 태그를 무효화합니다.

  3. CacheTagConfig를 새 HeaderName으로 업데이트합니다.

  4. 오리진에서 이전 헤더의 반환을 중지합니다.

배포 테넌트

CreateInvalidationForDistributionTenant API를 통해 배포 테넌트에 대한 태그 무효화도 지원됩니다.