Invalidating Cached Content

This page describes how to invalidate your Cloud CDN cached content. To learn more about cache invalidation, read Cache Invalidation Overview.

Before you begin

The steps on this page can be completed using the Google Cloud Console UI or the gcloud command line tool.

You can access the gcloud command line tool in two ways:

• Install the Google Cloud SDK by following the instructions at /sdk/downloads. If you haven't used the gcloud command line tool previously, first run gcloud init to authenticate.

• Use Google Cloud Shell, which comes with gcloud already installed.

Invalidating cached content

Permissions required for this task

To perform this task, you must have been granted the following permissions OR the following IAM roles.

Permissions

• compute.urlMaps.invalidateCache

Roles

• roles/compute.networkAdmin
• roles/compute.loadBalancerAdmin

You can perform invalidations using the gcloud command-line interface or the Google Cloud Console.

Examples

If a file located at /images/foo.jpg has been cached and needs to be invalidated, there are several methods you can use to invalidate it, depending on whether you wanted to affect just that file or a wider scope. In each case, you can invalidate for all hostnames or for just one hostname.

To invalidate just one file:

Console

1. Go to the Cloud CDN page in the Google Cloud Console.
   Go to the Cloud CDN page
2. Click on the origin name of the relevant origin.
3. Click Cache invalidation.
4. Enter the path to the file.
   • If you want to invalidate a path for all hostnames, enter just the path. (Ex: /images/foo.jpg)
   • If you want to invalidate a path for one hostname only, specify the the hostname as part of the path. (For example: example.com/images/foo.jpg)
5. Click Invalidate.

gcloud

gcloud compute url-maps invalidate-cdn-cache [URL_MAP_NAME] \
    --path "/images/foo.jpg"

• [URL_MAP_NAME] - The name of the URL map resource in your load balancer.

Optional: To invalidate for only one host, add the --host flag. (--host example.com)

gcloud compute url-maps invalidate-cdn-cache [URL_MAP_NAME] \
    --host [HOSTNAME] \
    --path "/images/foo.jpg"

By default, the gcloud command-line tool waits until the invalidation has completed. To perform the invalidation in the background, append --async to the command line.

To invalidate the whole directory:

Console

1. Go to the Cloud CDN page in the Google Cloud Console.
   Go to the Cloud CDN page
2. Click on the origin name of the relevant origin.
3. Click Cache invalidation.
4. Enter the directory path and wildcard (/path/to/file/*).
   • If you want to invalidate the whole directory for all hostnames, enter just the path and wildcard. (Ex: /images/*)
   • If you want to invalidate the whole directory for one hostname only, specify the hostname as part of the path. (For example: example.com/images/*)
5. Click Invalidate.

gcloud

gcloud compute url-maps invalidate-cdn-cache [URL_MAP_NAME] \
    --path "/images/*"

• [URL_MAP_NAME] - The name of the URL map resource in your load balancer.

Optional: To invalidate for only one host, add the --host flag. (--host example.com)

gcloud compute url-maps invalidate-cdn-cache [URL_MAP_NAME] \
    --host [HOSTNAME] \
    --path "/images/*"

By default, the gcloud command-line tool waits until the invalidation has completed. To perform the invalidation in the background, append --async to the command line.

To invalidate everything:

Console

1. Go to the Cloud CDN page in the Google Cloud Console.
   Go to the Cloud CDN page
2. Click on the origin name of the relevant origin.
3. Click Cache invalidation.
4. Enter just the root and the wildcard (/*).
   • If you want to invalidate everything for all hostnames, enter just /* into the field.
   • If you want to invalidate everything for one hostname only, specify the hostname as part of the path. (For example: example.com/*)
5. Click Invalidate.

gcloud

gcloud compute url-maps invalidate-cdn-cache [URL_MAP_NAME] \
    --host [HOSTNAME] \
    --path "/*"

• [URL_MAP_NAME] - The name of the URL map resource in your load balancer.
• path - The URL path you wish to invalidate. Does not include the host name. The path may use an explicit filename or a wildcard.

Optional: To invalidate for only one host, add the --host flag. (--host example.com)

gcloud compute url-maps invalidate-cdn-cache [URL_MAP_NAME] \
    --host [HOSTNAME] \
    --path "/*"

By default, the gcloud command-line tool waits until the invalidation has completed. To perform the invalidation in the background, append --async to the command line.

What's next

• View logs to check whether Cloud CDN is serving responses from cache.
• Caching Details provides details on what content is cached.
• Consult a list of caching locations.