Purge content by directory and extensions

📘

Enhanced purge takes longer to complete

This advanced option may take up to 40 minutes to process.

How you can use this service

With Enhanced Content Control Utility (ECCU), you can refresh cached objects in two ways:

  • Use rules that specify the extensions and directories for objects you want to purge.

  • Upload the ECCU file that specifies more complex rules to refresh cached objects. Apart from extensions or directories, you can also purge by additional criteria such as the protocol, cookies, or contents of requests.

You can use ECCU in a web interface or through the Enhanced Content Control Utility API, which lets you specify these complex rules in JSON requests.

ECCU uses an invalidation-based refresh method. See Purge methods for more information.

Before you begin

Get familiar with digital properties and the ECCU request file structure.

How to

  1. Under Purge content by, select Directory and Extensions (Advanced).

    The ECCU landing page opens, showing all of the current ECCU requests. Use filters to quickly find a request by name, request ID, property, or status.

  2. Click New Request.

  3. Enter the request name.

  4. Select at least one digital property. You can select up to 20 properties per request. See Digital properties for more information.

  5. Enter the email addresses of users or administrators that you want to notify once the content is refreshed.

  6. Select how you want to refresh your files:

    • Directory. Select this option if you want to refresh all files in a directory, including its subdirectories. The path must start with /. If you enter /by itself, ECCU refreshes all content for the digital properties you selected. For example, if the property uses a wildcard such as *.example.com, specifying a single /for the directory refreshes everything under test.example.com/, www2.example.com/, and another.example.com/. Regular expressions and special characters are not supported in the Directory field.

    • ECCU File. Select this option if you want to upload an ECCU file that specifies what content to refresh. See Create the ECCU request file for more information.

  7. Optionally, to refresh only specific kinds of files, specify the file extensions without a preceding ., such as gif, html, or jpg. Regular expressions and special characters are not supported.

  8. Click Next. Review the details of the purge request and click Submit. The ECCU Request Confirmation page appears. It may take up to 30-40 minutes for the refresh request to complete.

    The metadata you submitted appears at the top of the page.

    🚧

    • If you refresh large numbers of files at the same time, the origin may experience an increased load as new files are retrieved.
    • All failed requests are listed on this page as well.
  9. Note the Request IDs that appear, as you may need them for tracking and problem solving.

  10. Click OK to return to the ECCU landing page.