

# 태그를 무효화할 때 알아야 할 사항
<a name="invalidation-specifying-tags"></a>

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

 **옵트인 필요**   
태그 무효화는 `CacheTagConfig`가 구성된 배포에서만 작동합니다. 이 구성이 없는 배포는 오리진의 캐시 태그 헤더를 무시합니다. 자세한 내용은 [캐시 태그로 콘텐츠 무효화](invalidation-by-tags.md) 섹션을 참조하세요.

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

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

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

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

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

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

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

 **최대 허용**   
태그 무효화 항목은 경로 항목과 동일한 동시 무효화 제한에 따라 계산됩니다. 각 항목은 하나의 무효화 경로로 계산됩니다. 자세한 내용은 [무효화에 대한 할당량](cloudfront-limits.md#limits-invalidations) 섹션을 참조하세요.

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

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

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

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

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

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