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

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						      2020-06-23					     iRule(1)