ltm rule command CACHE useragent

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

CACHE::useragent
       Overrides the useragent value used by the cache to reference the cached content.

SYNOPSIS
       CACHE::useragent AGENT

DESCRIPTION
       By default, cached content is stored with a unique key that consists of the Host header, URI, Accept-Encoding
       and User-Agent.	If the content is generated the same for multiple User-Agents, this command can be used to
       group various User-Agent values into a single group, thus minimizing duplicated cached content.

       CACHE::useragent 

	    * Overrides the useragent value used by the cache to store the cached
	      content.

RETURN VALUE
VALID DURING
       HTTP_REQUEST, HTTP_REQUEST_DATA

EXAMPLES
	This will put all MSIE based browsers into a single cache group.

	when HTTP_REQUEST {
	  if {[HTTP::header User-Agent] contains "MSIE"} {
	    CACHE::useragent "MSIE"
	  }
	}

	This will ignore all client user agents and put all clients into the
	same cache group.

	when HTTP_REQUEST {
	  CACHE::useragent "GENERIC-UA"
	}

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

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