Publicado originalmente el 10 de febrero de 2020
El registro de límite de velocidad de la API ha estado en funcionamiento desde octubre de 2019. Desde entonces, hemos estado monitoreando los registros de límite de velocidad que se han generado. También hemos pasado tiempo reuniéndonos con muchos clientes y socios para analizar los datos de registro. El siguiente es un resumen de cómo nos hemos adaptado en función de lo que hemos aprendido.
Encabezados de respuesta de API
En el caso de los sitios de Brightspace con la limitación de velocidad de API activada, cada llamada a la API de Brightspace ahora incluye 3 datos adicionales en su encabezado de respuesta:
X-Tasa-Límite-Restante - el número restante de créditos disponibles dentro del minuto actual.
Nota: Este valor solo es significativo en los sitios de Brightspace que tienen activada la limitación de velocidad de API
Restablecimiento del límite de velocidad X - proporciona al desarrollador la cantidad de tiempo, en segundos, hasta que se reinicia su bucket.
X-Costo-Solicitud - informa al desarrollador de la cantidad de créditos que cuesta la ruta actual de la API.
Para algunas soluciones, estos valores de encabezado pueden proporcionar una forma de evitar que se supere el umbral del límite de frecuencia.
Limitación de velocidad de giro activada para sitios que no son de producción - 9 de marzo de 2020
Con el fin de proporcionar a todos acceso a un entorno de Brightspace que tenga activada la limitación de velocidad, planeamos hacerlo en todos los No producción Brightspace Sites el 9 de marzo de 2020. Esto proporcionará a todos los clientes y socios acceso a un sitio donde podrán:
- Cree un escenario de prueba en el que realmente puedan superar un umbral de límite de velocidad y generar un error 429.
- Pruebe y use el método X-Tasa-Límite-Restante valor del encabezado de respuesta (ya que este valor solo tiene sentido en los sitios donde la limitación de velocidad de API está activada).
IMPORTANTE - Si NO desea que se active la limitación de velocidad para uno de sus sitios de Brightspace que no sean de producción, comuníquese con su D2L, TAM y/o CSM antes del 9 de marzo.
Activar el registro incremental: 2 de marzo de 2020
Algunos de los comentarios que hemos recibido en repetidas ocasiones indican que desea saber si su aplicación de API se está "acercando" al valor del umbral de limitación de velocidad y cuándo. Para satisfacer esta solicitud, hemos agregado una nueva función de "registro incremental" a nuestra solución de limitación de velocidad. Nuestro plan es activar el registro incremental el 2 de marzo de 2020.
El registro incremental generará registros de límite de velocidad cuando cualquier aplicación de API use más de 30,000 créditos en un minuto. Se generarán registros adicionales cuando esa aplicación de API supere cualquier múltiplo de 10.000 por encima del nivel inicial de 30.000 créditos.
Por ejemplo, si una aplicación de API utiliza 72.000 créditos de API en un minuto, nuestra función de registro incremental generará 5 registros únicos: el primero será cuando la aplicación supere los 30.000 créditos, el siguiente cuando la aplicación supere los 40.000 créditos, el tercero 50.000 créditos, el 4.º 60.000 créditos y el último registro cuando supere los 70.000 créditos.
El registro incremental proporciona dos puntos de datos importantes:
- Nos proporciona a todos un medio para determinar qué aplicaciones de API se están "acercando" al umbral de 50.000 créditos/minuto.
- En el caso de las aplicaciones que superan el límite de 50.000 créditos, el registro incremental nos informa de cuánto ha superado el umbral la aplicación.
Activación de la limitación de velocidad - Lunes 8 de junio de 2020
Antes de la publicación de este artículo, habíamos comunicado que íbamos a activar la limitación de velocidad en algún momento de mayo de 2020. Basándonos en sus comentarios, hemos decidido mover la fecha de puesta en marcha al lunes 8 de junio de 2020 (para todos los sitios de producción). La retroalimentación general fue que mayo suele ser un mes ocupado para la recuperación de datos de Brightspace a través de la API.
Como se indicó anteriormente, si tiene inquietudes sobre la activación de la limitación de velocidad de API, informe a su D2L TAM y/o CSM. Incluya la aplicación API que le preocupa y la razón por la que no querría que se activara la limitación de velocidad en junio.