Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Handle AWS Cloud Map DiscoverInstances Limitación de solicitudes de API

AWS Cloud Map limita las solicitudes de DiscoverInstances API para cada AWS cuenta por región. Throttling ayuda a mejorar el rendimiento del servicio y a proporcionar un uso justo para todos los clientes. AWS Cloud Map La limitación garantiza que las llamadas a la AWS Cloud Map DiscoverInstances API no superen las cuotas máximas de solicitudes de API permitidas DiscoverInstances. DiscoverInstances Las llamadas a la API que se originan en cualquiera de las siguientes fuentes están sujetas a las cuotas de solicitudes:

Si supera una cuota de limitación de la API, aparece el código de error RequestLimitExceeded. Para obtener más información, consulte Limitación de velocidad de solicitudes.

Cómo se aplica la limitación

AWS Cloud Map usa el algoritmo token bucket para implementar la limitación de API. Con este algoritmo, su cuenta tiene un bucket que contiene un número específico de tokens. El número de tokens del bucket representa su cuota de limitación en un segundo determinado. Hay un bucket para una sola región, y este se aplica a todos los puntos de conexión de la región.

Limitación de velocidad de solicitudes

La limitación limita la cantidad de solicitudes de DiscoverInstances API que puedes realizar. Cada solicitud elimina un token del bucket. Por ejemplo, el tamaño del bucket para la operación de la DiscoverInstances API es de 2000 tokens, por lo que puedes realizar hasta 2000 DiscoverInstances solicitudes en un segundo. Si superan las 2000 solicitudes en un segundo, estará limitado y las solicitudes restantes dentro de ese segundo fallarán.

Los buckets se recargan automáticamente a una tasa fija. Si el bucket no ha alcanzado su capacidad máxima, se vuelve a agregar un número determinado de tokens cada segundo hasta que el bucket alcance su capacidad máxima. Si el bucket ha alcanzado su capacidad máxima cuando llegan los tokens de recarga, estos tokens se descartan. El tamaño del bucket para la operación de la DiscoverInstances API es de 2000 tokens y la tasa de recarga es de 1000 tokens por segundo. Si realizas 2000 solicitudes de DiscoverInstances API en un segundo, el bucket se reduce inmediatamente a cero (0) tokens. A continuación, el bucket se recarga con hasta 1000 tokens por segundo hasta alcanzar su capacidad máxima de 2000 tokens.

Puede usar los tokens a medida que se vayan agregando al bucket. No tiene que esperar a que el bucket esté al máximo de su capacidad para realizar solicitudes de la API. Si agotas el depósito realizando 2000 solicitudes de DiscoverInstances API en un segundo, puedes seguir realizando hasta 1000 solicitudes de DiscoverInstances API por segundo durante el tiempo que necesites. Esto significa que puede utilizar inmediatamente los tokens de recarga a medida que se vayan agregando a su bucket. El bucket solo comienza a recargarse hasta su capacidad máxima cuando realice menos solicitudes de API por segundo que la tasa de recarga.

Reintentos o procesamiento por lotes

Si se produce un error en una solicitud de la API, es posible que la aplicación tenga que volver a intentarlo. Para reducir el número de solicitudes de la API, use un intervalo de suspensión entre solicitudes sucesivas adecuado. Para obtener resultados óptimos, utilice un intervalo de suspensión creciente o variable.

Cálculo del intervalo de suspensión

Cuando tenga que sondear o reintentar una solicitud de API, recomendamos que utilice un algoritmo de retardo exponencial para calcular el intervalo de suspensión entre las llamadas al API. Al utilizar tiempos de espera cada vez más largos entre reintentos para las respuestas a errores consecutivos, puedes reducir el número de solicitudes erróneas. Para obtener más información y ejemplos de implementación de este algoritmo, consulta el artículo Retry Behavior en la guía de referencia sobre herramientas y AWS SDK.

Ajuste de las cuotas de limitación de las API

Puedes solicitar un aumento de las cuotas de limitación de la API para tu cuenta. AWS Para solicitar un ajuste de cuota, póngase en contacto con AWS Support Center.