GuideReference
TrainingSupportCommunity
Reference

cache_​tag_​visible

  • Property Manager name: Cache Tag Visibility
  • Behavior version: The v2024-01-09 rule format supports the cache_​tag_​visible behavior v1.0.
  • Rule format status: GA, stable
  • Access: Read/Write
  • Allowed in includes: Yes

Cache tags are comma-separated string values you define within an Edge-Cache-Tag header. You can use them to flexibly fast purge tagged segments of your cached content. You can either define these headers at the origin server level, or use the modify​_outgoing​_response​_header behavior to configure them at the edge. Apply this behavior to confirm you're deploying the intended set of cache tags to your content.

See Fast Purge for guidance on best practices to deploy cache tags. Use the Fast Purge API to purge by cache tag programmatically.

OptionTypeDescriptionRequires
behaviorenum

Specifies when to include the Edge-Cache-Tag in responses.

{"displayType":"enum","options":["NEVER","PRAGMA_HEADER","ALWAYS"],"tag":"select"}
NEVER

Strip out the Edge-Cache-Tag header, edge servers' default response.

PRAGMA_​HEADER

Edge servers respond with the Edge-Cache-Tag header only when you pass in a Pragma: akamai-x-get-cache-tags header as part of the request.

ALWAYS

Include the Edge-Cache-Tag header in all responses.