API-szabályozási útmutató az Azure Data Manager for Agriculture szolgáltatáshoz
A szabályozás korlátozza a szolgáltatáshoz érkező kérések számát az erőforrások túlhasználatának megakadályozása érdekében. Az Azure Data Manager for Agriculture REST API szabályozása konzisztensebb teljesítményt tesz lehetővé azoknak az ügyfeleknek, akik a szolgáltatás API-jait hívják.
Az Azure Data Manager for Agriculture nagy mennyiségű kérést képes kezelni. Ha néhány ügyfél túl sok kérést küld, a szabályozás segít fenntartani az optimális teljesítményt és megbízhatóságot minden ügyfél számára.
A szabályozás korlátai a kiválasztott verziótól és az ügyfél által használt termék képességeiből függnek. Az Azure Data Manager for Agriculture két különböző verziót támogat:
- Standard: Az általánosan ajánlott verzió.
- Alapszintű: Alkalmas prototípus-készítésre.
Ezek a korlátok három időablakon belül (percenként, öt percenként és havonta) működnek, hogy védelmet nyújtsunk a hirtelen megnövekedett forgalom ellen.
Ez a cikk bemutatja, hogyan követheti nyomon azoknak a kéréseknek a számát, amelyek a korlát elérése előtt maradnak, és hogyan válaszolhat a korlát elérésekor. Ezekre az API-kra szabályozási korlátozások vonatkoznak.
API-k besorolása
Az Azure Data Manager for Agriculture API-k három fő kategóriába sorolhatók:
- Írási műveletek: AZ OLYAN REST API-metódusokat használó API-k, mint a
PATCH,POSTésDELETEaz adatok módosítása. - Olvasási műveletek: OLYAN API-k, amelyek a REST API metódustípust
GEThasználják az adatok lekéréséhez, beleértve a metódustípusPOSTkeresési API-jait is. - Hosszan futó feladatműveletek: A REST API metódustípust
PUThasználó, hosszú ideig futó aszinkron feladat API-k.
Az alábbi táblázatban ismertetett összes rendelkezésre álló kvótaegység meg van osztva ezek között a kategóriák között. Ha például a teljes kvótát írási műveletekre használja, az azt jelenti, hogy más műveletekre nincs fennmaradó kvóta. Minden művelet egy adott kvótaegységet használ fel, amely segít nyomon követni a fennmaradó kvótát a további felhasználáshoz.
| Művelet | Egységköltség minden kéréshez |
|---|---|
| Írás | 5 |
| Olvasás | 1 1 |
| Hosszú ideig futó feladat: megoldási következtetés | 5 |
| Hosszan futó feladat: farmművelet | 5 |
| Hosszan futó feladat: kép raszterizálása | 2 |
| Hosszú ideig futó feladat: entitás kaszkádolt törlése | 2 |
| Hosszú ideig futó feladat: időjárás-betöltés | 0 |
| Hosszú ideig futó feladat: műholdbetöltés | 0 |
1Egynél több elem beolvasásakor a válaszban visszaadott minden egyes elemnél extra egységköltséget kell figyelembe venni.
Az alapszintű verzió API-korlátai
Az alábbi táblázat az alapverzió összes elérhető egységét sorolja fel kategóriánként:
| Művelet | Szabályozási időablak | Egységek alaphelyzetbe állítása minden időablak után |
|---|---|---|
| Írás/olvasás | Percenként | 25 000 |
| Írás/olvasás | Ötpercenként | 100 000 |
| Írás/olvasás | Havonta | 5,000,000 |
| Hosszan futó feladat | Ötpercenként | 1000 |
| Hosszan futó feladat | Havonta | 100 000 |
A Standard verzió API-korlátai
A Standard verzió az alapverzióhoz képest havonta ötszörösére növeli az API-kvótát. Az összes többi kvótakorlát változatlan marad.
Az alábbi táblázat felsorolja a standard verzió kategóriánkénti összes elérhető egységét:
| Művelet | Szabályozási időablak | Egységek alaphelyzetbe állítása minden időablak után |
|---|---|---|
| Írás/olvasás | Percenként | 25 000 |
| Írás/olvasás | Ötpercenként | 100 000 |
| Írás/olvasás | Havonta | 25 000 000 1 |
| Hosszan futó feladat | Ötpercenként | 1000 |
| Hosszan futó feladat | Havonta | 500 000 1 |
1Ez a korlát ötszöröse az alapverzió korlátjának.
Hibakód
Ha eléri a korlátot, a HTTP-állapotkód 429 Túl sok kérést kap. A válasz tartalmaz egy újrapróbálkozási értéket , amely meghatározza, hogy az alkalmazás hány másodpercet várjon (vagy aludjon) a következő kérés elküldése előtt.
Ha az újrapróbálkozás értéke előtt küld egy kérést, a rendszer nem dolgozza fel a kérést, és új újrapróbálkozást ad vissza. A megadott idő leteltét követően ismét kérhet kéréseket az Azure Data Manager for Agriculture szolgáltatáshoz. A TCP-kapcsolat létrehozása vagy a különböző felhasználói hitelesítési módszerek használata nem kerüli el ezeket a korlátokat, mivel ezek az egyes bérlőkre vonatkoznak.
Gyakori kérdések
Ha a lefoglalt API-kvótát teljes egészében az írási műveletekhez merítem ki egy percnyi időkereten belül, sikeresen kérhetek olvasási műveleteket ugyanazon az időkereten belül?
A kvótakorlátok meg vannak osztva a felsorolt műveleti kategóriák között. Ha a teljes kvótát írási műveletekhez használja, az azt jelenti, hogy más műveletekre nincs fennmaradó kvóta. Ez a cikk az egyes műveletekhez felhasznált kvótaegységeket ismerteti.
Hogyan számíthatom ki egy adott időablakban engedélyezett sikeres kérelmek teljes számát?
A sikeres API-kérések teljes engedélyezett száma a kiépített verziótól és a kérések teljesítésének időkeretétől függ.
A Standard verzióval például 25 000 -et (az egységeket minden időablak után alaphelyzetbe állíthatja) / 5 -öt (az egyes kérések egységköltsége) = 5000 írási művelet API-ját egyperces időkereten belül. 4000 írási és 5000 olvasási művelet kombinációját is használhatja, amely 4000 * 5 + 5 000 * 1 = 25 000 teljes fogyasztási egységet eredményez.
Hasonlóképpen, az alapverzió esetében 5 000 000 000 műveletet hajthat végre (az egységek minden időablak után alaphelyzetbe állnak) / 1 (egységköltség minden kéréshez) = 5 000 000 olvasási művelet API-ját egy hónapos időkereten belül.
Hány érzékelőeseményt tud az ügyfél maximális számként beszedni?
A rendszer óránként legfeljebb 100 000 eseménybetöltést tesz lehetővé. Bár az új eseményeket folyamatosan elfogadják, a feldolgozás késhet. A késés azt jelentheti, hogy ezek az események nem érhetők el azonnal valós idejű kimenő forgatókönyvekhez a betöltés mellett.