API-kiintiöt: erota määrä, nopeus ja rinnakkaisuus

Tiivistelmä

Täysi kiintiö, pyyntöryöppy ja liialliset samanaikaiset työt vaativat eri toimia. Lue sopimus ennen uusintoja tai uusia tilejä.

Tyhjä suojattu palvelin- ja verkkokäytävä
Tässä artikkelissa

Tunnista saavutettu raja

HTTP 429 tarkoittaa liian monia pyyntöjä ja voi sisältää Retry-After-otsakkeen. Laskenta ja soveltamisala ovat palvelukohtaisia. Pieni keskiarvo ei estä lyhyen aikaikkunan ylitystä.

KäsiteRajattu asiaHyödyllinen toimi
KiintiöMäärä ajanjaksollaSuunnittele jaettu budjetti.
NopeusSaapumiset lyhyessä ikkunassaHajauta aloitukset.
RinnakkaisuusKäynnissä olevat työtRajaa samanaikainen työ.
Retry-After: 120Odota 120 sekuntiaTarkista kokonaisaika ja uusittavuus.

Suunnittele sallittu kuorma

  • Tarkista laskenta-avain: tili, projekti, käyttäjä tai reitti. Selvitä nollauksen aikavyöhyke, toimintokohtainen kustannus ja jaetut budjetit.
  • Tasaa ryöpyt rajatulla jonolla ja rajoita käynnissä olevia töitä erikseen. Välitä peruutukset ja poista tarpeettomat työt.
  • Tulkitse Retry-After HTTP-päivämääräksi tai sekunneiksi. Noudata sitä kokonaisaikarajan puitteissa ja määritä rajattu odotus sen puuttuessa.

Arvioi uusinta kiertämättä suojaa

429 ei todista toiminnon turvallista uusittavuutta. Tarkista idempotenssi, aikaraja ja yritysmäärä. Mittaa hylkäykset ja jono; vähennä jatkuvaa ylitarvetta tai sovi riittävä kapasiteetti.

Alkuperäiset lähteet

Tee nopeusrajoitusten väärinkäytöstä havaittavaa.

Pyyntörajoitukset toimivat paremmin, kun ne erottavat laillisen käytön epänormaalista käyttäytymisestä ja tuottavat tulkittavan tapahtuman. Pelkät virhekoodit voivat piilottaa väärinkäyttökuvion alun, keston ja ulottuvuuden.

  • Kirjaa kynnysarvo, päätös, reitti ja vähimmäiskonteksti ilman salaisuuksia.
  • Korreloi toistuvat kieltoilmoitukset vaikutuksiin laillisiin käyttäjiin.
  • Testaa, johtavatko hälytykset tutkimukseen tai suhteelliseen hienosäätöön.

Ensisijainen lähde: ACSC and partners — Event logging and threat detection. Aiheeseen liittyvä menetelmä: lue käytännön opas.