ltm rule command CACHE header

iRule(1)					  BIG-IP TMSH Manual					     iRule(1)

CACHE::header
       Get/modify the content of an header related to an object stored in the RAM Cache.

SYNOPSIS
       CACHE::header ('exists' | 'remove' | 'value') HEADER_NAME

       CACHE::header ('insert' | 'replace') HEADER_NAME HEADER_VALUE

DESCRIPTION
       The command is used to gather or modify the content of a header stored in the cache.

       CACHE::header 

	    * Get the content of the requested header

       CACHE::header insert  

	    * Add the header with the specified value to the list of headers sent to the
	      client when delivering an object from the cache.

       CACHE::header remove 

	    * Remove the header with the specified name.

       CACHE::header replace  

	    * Replace the header with the specified value.

       CACHE::header value 

	    * Return the header value for the specified header name.

RETURN VALUE
VALID DURING
       CACHE_RESPONSE, CACHE_UPDATE

EXAMPLES
	when CACHE_RESPONSE {
	    # response being sent to the client - the object in the cache is not accessed/modified
	    # modifications will be seen only in the current response
	    CACHE::header insert X-Via F5-Local-Cache
	    CACHE::header replace Server Big-IP-Server
	}

	when CACHE_UPDATE {
	    # cached object's headers manipulation
	    # modifications will be seen whenever the object is served from cache
	    CACHE::header replace Server Big-IP-Server
	}

HINTS
SEE ALSO
CHANGE LOG
       @BIGIP-9.4.2 --First introduced the command.

BIG-IP						      2020-06-23					     iRule(1)