Cache settings

Configures cache lifetime for objects stored in the Fastly cache, overriding cache freshness information that would otherwise be determined from cache-related headers on the HTTP response. When used in conjunction with conditions, cache settings objects provide detailed control over how long content persists in the cache.

Data model

actionstringIf set, will cause vcl_fetch to terminate after processing this rule with the return state specified. If not set, other configuration logic in vcl_fetch with a lower priority will run after this rule.
cache_conditionstringName of the cache condition controlling when this configuration applies.
namestringName for the cache settings object.
stale_ttlintegerMaximum time in seconds to continue to use a stale version of the object if future requests to your backend server fail (also known as 'stale if error').
ttlintegerMaximum time to consider the object fresh in the cache (the cache 'time to live').
created_atstringDate and time in ISO 8601 format.
deleted_atstringDate and time in ISO 8601 format.
service_idstringAlphanumeric string identifying the service.
updated_atstringDate and time in ISO 8601 format.
versionintegerInteger identifying a service version.

Endpoints

List cache settings objects

GET/service/service_id/version/version_id/cache_settings

Create a cache settings object

POST/service/service_id/version/version_id/cache_settings

Get a cache settings object

GET/service/service_id/version/version_id/cache_settings/cache_settings_name

Update a cache settings object

PUT/service/service_id/version/version_id/cache_settings/cache_settings_name

Delete a cache settings object

DELETE/service/service_id/version/version_id/cache_settings/cache_settings_name