ltm rule command HTTP query

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

HTTP::query
       Returns or sets the query part of the HTTP request.

SYNOPSIS
       HTTP::query (QUERY_STRING)?

DESCRIPTION
       Returns or sets the query part of the HTTP request. The query is defined as the part of the request past a ?
       character, if any.  For the following URL: http://www.example.com:8080/main/index.jsp?user=test&login=check
       The query is: user=test&login=check

       Syntax

       HTTP::query

	    * Returns the query part of the HTTP request.

       HTTP::query 

	    * Changes the query part of the HTTP request. Rewriting the URI will only
	      affect the request to the pool member. The client will not see the
	      update unless the web application uses the requested URI to
	      generate response headers and/or content. If you want the client to
	      see the update to the URI in the browser's address bar, you can
	      send an HTTP redirect using HTTP::redirect or HTTP::respond.

       HTTP::query -normalized

	    * Returns the query part of the HTTP request normalized in a form
	      for consistent comparisons.

RETURN VALUE
       Returns the query part of the HTTP request.

VALID DURING
       HTTP_REQUEST, HTTP_REQUEST_DATA, SERVER_CONNECTED, MR_INGRESS

EXAMPLES
	when HTTP_REQUEST {
	  log local0. "http_path [HTTP::path]"
	  log local0. "http_query [HTTP::query]"
	  HTTP::query user=test_user&login=test_login
	}

	when HTTP_REQUEST {
	 if {[string tolower [HTTP::query]] contains "utm" || [string tolower [HTTP::query]] contains "gclid"} {
	    set query [string tolower [HTTP::query]]
	 }
	}

HINTS
SEE ALSO
       See HTTP::uri and HTTP::path for other ways to inspect and alter the URI.

CHANGE LOG
       @BIGIP-9.0.0 --First introduced the command.  @BIGIP-11.5.0 --Added ability to modify/set

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