Alibaba Cloud SDK:Mecanismo de retroceso avanzado basado en la política de limitación

Habilitar la política de retroceso basada en la política de limitación

De forma predeterminada, la política de retroceso basada en la limitación está deshabilitada. Puede habilitarla con uno de los métodos a continuación:

1. Configure una política de reintento.

RetryPolicy retryPolicy = RetryPolicy.builder()
                .maxNumberOfRetries(3) // The maximum number of retries.
                .maxDelayTimeMillis(20 * 1000) // The maximum retry interval. Unit: milliseconds. If the interval is exceeded, no retries are performed.
                //.retryConditions(retryConditions) // The policy that is used to trigger retries.
                .enableAliyunThrottlingControl(true) // Enable the backoff policy based on the throttling policy. 
                //.throttlingConditions(throttlingConditions) // The policy that is used to restrict retries.
                .build();

request.setSysRetryPolicy(retryPolicy);

2. Utilice la política de reintento predeterminada.

// The default policy. The request parameter is enableAliyunThrottlingControl. The value true specifies that the backoff policy based on the throttling policy is enabled. The value false specifies that the backoff policy based on the throttling policy is disabled.
RetryPolicy retryPolicy = RetryPolicy.defaultRetryPolicy( 
true 
);

request.setSysRetryPolicy(retryPolicy);

Beneficios de habilitar la política de retroceso basada en la política de limitación

1. Reduce los reintentos innecesarios y disminuye el consumo de recursos del sistema.

2. Calcula intervalos de retroceso más precisos, lo que mejora las tasas de éxito de los reintentos.

Política de retroceso: cálculo del tiempo de retroceso según la política de limitación

Cuando se habilita la política de retroceso basada en la limitación, el tiempo de retroceso se calcula de la siguiente manera:

1. Si no se activa ninguna limitación, se usa EqualJitter para calcular un intervalo de reintento.

2. Si se activa una limitación, el intervalo de reintento corresponde al valor mayor entre el tiempo restante del ciclo de limitación actual y el resultado de EqualJitter. Si este intervalo supera el intervalo máximo de reintento, se genera una excepción. Además, el tiempo restante del ciclo de limitación se almacena en caché para que lo utilice la política de desactivación de solicitudes.

Política de desactivación de solicitudes de API durante la limitación

Cuando la política de retroceso basada en la limitación está habilitada y se activa una limitación, el servidor devuelve información sobre la cuota restante en el encabezado de respuesta. Esta información incluye el número de llamadas de API restantes y el tiempo restante del ciclo de limitación actual, reportados en las dimensiones "User" y "API + User". Si las llamadas de API están limitadas, el recuento de llamadas restantes es 0.

Limit: the maximum throttling threshold. The value is of the INT type.
Time: the time span of throttling. The value is of the LONG type. Unit: milliseconds.
TimeLeft: the remaining time of the current throttling cycle. The value is of the LONG type. Unit: milliseconds.
Reset: the start time of the next throttling cycle. The value is of the LONG type and is a timestamp in milliseconds

El SDK rastrea el tiempo restante del ciclo de limitación actual y bloquea las nuevas llamadas o los reintentos durante ese periodo. Si el tiempo restante supera el intervalo máximo de reintento, se genera un error. De lo contrario, el sistema espera hasta que termine el ciclo de limitación antes de iniciar o reintentar la llamada.

Habilitar la depuración de limitaciones

Para recuperar la información de cuota de limitación sin esperar a que esta se active, establezca X-RateLimit-Mode como debug en el encabezado de la solicitud.

request.putHeadParameter("X-RateLimit-Mode", "debug");