All Products
Search

This Product

    Dynamic Content Delivery Network:Throttling functions

    Document Center

    Dynamic Content Delivery Network:Throttling functions

    Last Updated:Dec 20, 2023

    This topic describes the syntax, features, parameters, and return values of throttling functions. This topic also provides examples of these functions.

    limit_rate_after

    The following table describes the details about this function.

    Item

    Description

    Syntax

    limit_rate_after(n, unit)

    Description

    Sets the maximum amount of data transfer before the data transfer rate is throttled. If the upper limit is reached, the data transfer rate is throttled.

    Note

    This function sets the maximum amount of data transfer only for individual requests.

    Parameters

    • n: the maximum amount of data transfer before the data transfer rate is throttled. Data type: integer. If you do not set the unit parameter, the unit is byte.

    • unit: the unit to measure the amount of data transfer. Data type: char. This parameter is optional. Valid values for unit: K, M, and G. These values are not case-sensitive.

    Return value

    If the function succeeds, true is returned. Otherwise, false is returned.

    Examples

    limit_rate_after(100, 'k')                                                                                                                                                              
limit_rate(1, 'm') 
//Note: Before the amount of data transfer reaches 100 KB, the data transfer rate is not throttled. If the amount of data transfer reaches 10 KB, the data transfer rate is throttled to 1 MB/s.

    limit_rate

    The following table describes the details about this function.

    Item

    Description

    Syntax

    limit_rate(n, unit)

    Description

    Sets a value to which the data transfer rate is throttled. By default, the lowest data transfer rate is 50 KB/s. If you specify a data transfer rate that is lower than 50 KB/s, the data transfer rate is throttled to 50 KB/s.

    Note

    This function throttles only individual requests.

    Parameters

    • n: the maximum amount of data transfer before the data transfer rate is throttled. Data type: integer. If you do not set the unit parameter, the unit is byte/s.

    • unit: the unit to measure the amount of data transfer. Data type: char. This parameter is optional. Valid values of unit: K, M, and G. These values are not case-sensitive.

    Return value

    If the function succeeds, true is returned. Otherwise, false is returned.

    Examples

    limit_rate_after(100, 'k')                                                                                                                                                              
limit_rate(1, 'm') 
//Note: Before the amount of data transfer reaches 100 KB, the data transfer rate is not throttled. If the amount of data transfer reaches 10 KB, the data transfer rate is throttled to 1 MB/s.