schedule_invalidation

Property Manager name: Scheduled Invalidation
Behavior version: The v2024-05-31 rule format supports the schedule_invalidation behavior v1.2.
Rule format status: GA, stable
Access: Read/Write
Allowed in includes: Yes

Specifies when cached content that satisfies a rule's criteria expires, optionally at repeating intervals. In addition to periodic cache flushes, you can use this behavior to minimize potential conflicts when related objects expire at different times.

Warning. scheduled invalidations can significantly increase origin servers' load when matching content expires simultaneously across all edge servers. As best practice, schedule expirations during periods of lowest traffic.

Option	Type	Description	Requires
`start`	string (timestamp)	The UTC date and time when matching cached content is to expire.		{"displayType":"string","tag":"input","type":"datetime-local"}
`repeat`	boolean	When enabled, invalidation recurs periodically from the `start` time based on the `repeat_interval` time.		{"displayType":"boolean","tag":"input","type":"checkbox"}
`repeat_interval`	string (duration)	Specifies how often to invalidate content from the `start` time, expressed in seconds. For example, an expiration set to midnight and an interval of `86400` seconds invalidates content once a day. Repeating intervals of less than 5 minutes are not allowed for NetStorage origins.	`repeat` is `true`	{"displayType":"string","tag":"input","type":"text"} {"if":{"attribute":"repeat","op":"eq","value":true}}
`refresh_method`	enum	Specifies how to invalidate the content.		{"displayType":"enum","options":["INVALIDATE","PURGE"],"tag":"select"}
	`INVALIDATE`	Sends an `If-Modified-Since` request to the origin, re-caching the content only if it is fresher.
	`PURGE`	Re-caches content regardless of its freshness, potentially creating more traffic at the origin.