ltm rule command HTTP2 stream

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



HTTP2::stream
       Gets or sets the stream attributes including id and priority. The
       subcommands include commands to get the current stream id. The
       subcommands also include commands to get or set the current stream
       priority.

SYNOPSIS
       HTTP2::stream (id | (priority (PRIORITY)?))?

DESCRIPTION
       This command can be used to determine the stream attributes including
       id and priority. This command can also be used to set the priority for
       a current active stream.

       HTTP2::stream
	   Returns the stream id. Returns 0 if HTTP/2 is not active.

       HTTP2::stream id
	   Returns the stream id. Returns 0 if HTTP/2 is not active.

       HTTP2::stream priority
	   Returns the priority of the current stream.

       HTTP2::stream priority 
	   Sets the priority of the current active stream. The return is 0 is
       the priority was set. Return is an error if the priority is out of
       bounds (exceeding 8 bits).

RETURN VALUE
VALID DURING
       HTTP TCP

EXAMPLES
	when HTTP_REQUEST {
	    if {[HTTP2::version] != 0} {
		set new_pri [URI::query [HTTP::uri] pri]
		if { $new_pri != "" } {
		     HTTP2::stream priority $new_pri
		}
		HTTP::header insert "X-HTTP2-Values stream/pritority " "[HTTP2::stream]/[HTTP2::stream priority]"
	    }
	}

HINTS
       When using the set current stream priority command, an error will be
       returned if the priority value is out of bounds.

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



BIG-IP				  2017-01-31			      iRule(1)