Introduced : BIG-IP_v12.0.0
Sets the states to indicate whether to use dynamic ratio to modify the behavior of QOS. This option is disabled by default, and in that case the system uses only the server or virtual server with the best metrics, or highest quality of service (QoS) score, for load balancing. When dynamic ratio is enabled, the system treats QoS scores as ratios, and it uses each server or virtual server in proportion to the ratio determined by the QoS calculation. This option only applies when you are also using one of the following load balancing method on the given pool: LB_METHOD_HIT_RATIO, LB_METHOD_LOWEST_HOPS, LB_METHOD_BPS, LB_METHOD_LEAST_CONN, LB_METHOD_LOWEST_RTT, LB_METHOD_QOS, LB_METHOD_VS_CAPACITY, or LB_METHOD_VS_SCORE.


    in GlobalLB__PoolID [] pools,
    in EnabledState [] states


Parameter Type Description
pools PoolID [] The list of pools.
states EnabledState [] The states to set for the pools.

Return Type

Type Description


Exception Description
Common::AccessDenied Raised if the client credentials are not valid.
Common::InvalidArgument Raised if one of the arguments is invalid.
Common::OperationFailed Raised if an operation error occurs.

See Also


The links to the sample code below are remnants of the old DevCentral wiki and will result in a 404 error. For best results, please copy the link text and search the codeshare directly on DevCentral.

Sample Code

The BIG-IP API Reference documentation contains community-contributed content. F5 does not monitor or control community code contributions. We make no guarantees or warranties regarding the available code, and it may contain errors, defects, bugs, inaccuracies, or security vulnerabilities. Your access to and use of any code available in the BIG-IP API reference guides is solely at your own risk.