Refresh CDN Cache

Last update:2026-07-13 15:45:52

Cache Purging allows you to force CDN servers to retrieve the latest files from the origin server and refresh the existing cached content.

Cache Refresh is suitable for the following scenarios:

  • When cached files on the CDN are outdated and you want CDN servers to retrieve the latest content from the origin immediately, so that end users no longer access outdated resources.
  • When cached files on the CDN violate policies and you want to remove them from CDN servers immediately, so that end users can no longer access non-compliant resources.

Cache Purging supports multiple types: By URL, By Directory, By Regex, and By Domain.

How to Create a Cache Refresh Task

  1. Before creating a task, make sure you have purchased an Atomile CDN product, configured acceleration services for your domain, and contacted Atomile technical support to enable Cache Refresh permissions.
  2. Log in to Atomile Console, go to Products > Application > Content Management > Purge Cache, and click Create Task.
  3. Configure the cache refresh task according to your needs.

Refresh Types

Refresh Type Description Notes
URL Refresh Refreshes cache at the URL level and is suitable for refreshing a small number of files. 1. Submitted URLs are case-sensitive.
2. URLs must start with a protocol such as http:// or mms://. For example: http://www.test.com/index.html
3. Enter one URL per line. Separate multiple URLs with line breaks.
Directory Refresh Refreshes cache at the directory level and is recommended when more than 100 URLs under a directory need to be updated. 1. Submitted directories are case-sensitive.
2. Directory paths must start with a protocol such as http:// or mms://. For example: http://www.test.com/news/
3. Enter one directory per line. Separate multiple directories with line breaks.
4. To refresh all directories under a domain, enter the root directory of the domain, for example: http://www.test.com/
5. If your domain is configured with a cache host or any rewriting configuration, contact Atomile technical support to confirm how to submit the refresh task. We will evaluate it based on your configuration.
Regex Refresh Refreshes cache using URL patterns based on regular expressions. Enter one URL pattern per line. Each line must start with a protocol such as http://. Supported protocols are http, https, and mms. For example, to refresh JS files under a specific directory, submit http://www.test.com/test/(.*).js(.*).
Domain Refresh Refreshes cache at the domain level. We strongly recommend contacting technical support for evaluation before using this option. 1. Enter the domain directly, without any protocol.
2. By default, the system refreshes cache files for both http:// and https://. If you need to refresh other protocols, use Directory Refresh or URL Refresh instead.

If your domain is configured with a cache host or any rewriting configuration, contact Atomile technical support to confirm how to submit the refresh task. We will evaluate it based on your specific setup.

After selecting the refresh type, enter the required configuration items and submit the refresh task.

Note: Different refresh types have different configuration items.

Common URL / Common Directory

Click + Common URL or + Common Directory to select and add frequently used URLs or directories. Select the items you want and click Add to Push Box to automatically insert them into the text box for the refresh task.

This feature also allows you to manage common URLs and directories, including adding and deleting entries.

Task Types

  • Immediate: The task is executed immediately after submission. If you do not want immediate execution, you can set a Delay Time to define when the task should run.
  • Cycle: The task is executed repeatedly. You can configure the recurrence time and frequency.

All in Lowercase

  • Yes: Converts each letter in the URI portion of the refresh target to lowercase.
  • No: Does not convert the URI to lowercase.

How to View Cache Refresh Tasks

Log in to Atomile Console, go to Products > Application > Content Management > Purge Cache, and click Task Query.

You can query cache refresh tasks by time, domain, or full URL. The console displays the following information about the selected task.

Success Ratio

Success Rate = Number of successful executions / Total number of executions

A single refresh task must be distributed to multiple Atomile CDN servers for execution, so the task may be executed multiple times across the platform.

How to Manage Recurring Cache Refresh Tasks

Recurring tasks are cache refresh tasks configured with the recurring execution option when the task is created. After a recurring task is submitted successfully, you can view and edit all recurring tasks under Timing Management.

  1. Log in to Atomile Console, go to Products > Application > Content Management > Purge Cache, and click Timing Management. By default, all recurring tasks are displayed. You can also search using filter criteria.
  2. Find the recurring task you want to manage, then click the Edit button on the right to edit it again, or click the Delete button to delete it.

Notes

When submitting cache refresh tasks for the same URL, directory, or domain within a short period of time, wait at least 5 minutes between submissions. For example, if the system has not yet completed the first URL refresh task and receives another task for the same URL, the later task may be ignored by the system.