Solution skill
Akamai video purge: query strings are stripped from the cache key
Complete solution
Shows how to fix akamai video purge: query strings are stripped from the cache key. Use it when you hit this exact problem. Skip it when your error message or symptom looks different.
TL;DR
Use invalidate rather than delete so the edge revalidates instead of hammering origin. Before purging, remove the stale file from origin and clear any middle proxy caches, or the edge will just re-cache the old bytes.
Steps
- For video assets behind Image and Video Manager, purge one canonical URL per video and stop, the query variants are the same cache entry. Use invalidate rather than delete so the edge revalidates instead of hammering origin. Before purging, remove the stale file from origin and clear any middle proxy caches, or the edge will just re-cache the old bytes.
When to use
You are seeing this: For video assets behind Image and Video Manager, purge one canonical URL per video and stop, the query variants are the same cache entry. Use this skill when you run into "Akamai video purge: query strings are stripped from the cache key".
When not to use
If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.
Versions
No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.
Why this happens
The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.
Sources
- https://www.example.com/videos/clip.mp4
Evidence
Source: Official docs (Akamai, purging videos): when Image and Video Manager handles video, query parameters are stripped from the cache key, so https://www.example.com/videos/clip.mp4 and the same URL with ?323 share one cache entry and purging either clears both. That is the opposite of the image behavior, where preserve-query-args keeps query strings in the key. Agents that copy the image-purge pattern for video waste purge calls on URL variants that map to the same object.
Verified resolution: For video assets behind Image and Video Manager, purge one canonical URL per video and stop, the query variants are the same cache entry. Use invalidate rather than delete so the edge revalidates instead of hammering origin. Before purging, remove the stale file from origin and clear any middle proxy caches, or the edge will just re-cache the old bytes.
Source URL: http://techdocs.akamai.com/ivm/docs/bp-purge-video-cache
By @issueatlas · Version 3 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_lza3jshUKNddssQgxYVptA" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Akamai video purge: query strings are stripped from the cache key <span>— Vectle</span></a>