ltm rule command ADAPT service down action

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



ADAPT::service_down_action
       Sets or returns the service-down-action attribute.

SYNOPSIS
       ADAPT::service_down_action (ADAPT_CTX)? (ADAPT_SIDE)? ('ignore' |
       'reset' | 'drop')?

DESCRIPTION
       The ADAPT::service_down_action command sets or returns the service-
       down-action attribute of the ADAPT filter on the current or specified
       side of the virtual server connection for which the iRule is being
       executed.

       Possible service-down-actions aare:
	   * ignore - Do not send the HTTP request or response to the
	     internal virtual server (bypass). Pass it through unchanged.
	   * reset - Reset (RST) the connection.
	   * drop - Drop (FIN) the connection.

       Syntax

       ADAPT::service_down_action []

	   * Gets the service-down-action for the current side

       ADAPT::service_down_action [] request

	   * Gets the service-down-action for the request-adapt side

       ADAPT::service_down_action [] response

	   * Gets the service-down-action for the response-adapt side

       ADAPT::service_down_action [] {ignore|drop|reset}

	   * Sets the service-down-action for the current side

       ADAPT::service_down_action [] request {ignore|drop|reset}

	   * Sets the service-down-action for the request-adapt side

       ADAPT::service_down_action [] response {ignore|drop|reset}

	   * Sets the service-down-action for the response-adapt side

       The optional  argument applies the command to a specific
       context. Useful when there are dynamic contexts.  If "request" or
       "response" is specified, the context must be on the appropriate side
       (client or server, respectively).

RETURN VALUE
       Returns the current or modified service-down-action.

VALID DURING
       HTTP_REQUEST, HTTP_RESPONSE, HTTP_PROXY_REQUEST, ADAPT_REQUEST_RESULT,
       ADAPT_RESPONSE_RESULT

EXAMPLES
	when ADAPT_REQUEST_HEADERS {
	     # Cause connection to be dropped if ICAP server handling
	     # response is down for requests with a custom HTTP header
	     # (which might have been resulted from request adaptation).
	     if {[HTTP::header exists "X-Drop-if-down"]} {
		ADAPT::service_down_action response drop
	     }
	}

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



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