Pokyny k omezování rozhraní API pro Azure Data Manager pro zemědělství
Omezování omezuje počet požadavků na službu v časovém rozsahu, aby se zabránilo nadměrnému využití prostředků. Omezování rozhraní REST API v Azure Data Manageru pro zemědělství umožňuje konzistentnější výkon v časovém rozsahu pro zákazníky, kteří volají rozhraní API služby.
Azure Data Manager pro zemědělství dokáže zpracovat velký objem požadavků. Pokud u několika zákazníků dochází k zahlcení počtu požadavků, pomáhá omezování udržovat optimální výkon a spolehlivost pro všechny zákazníky.
Omezení omezení jsou podmíněná vybranou verzí a možnostmi produktu, který zákazník používá. Azure Data Manager pro zemědělství podporuje dvě odlišné verze:
- Standard: Obecně doporučujeme verzi.
- Základní: Vhodné pro požadavky na vytváření prototypů.
Tato omezení fungují do tří časových intervalů (za minutu, za pět minut a za jeden měsíc), aby se zajistilo proti náhlému nárůstu provozu.
V tomto článku se dozvíte, jak sledovat počet požadavků, které zůstávají před dosažením limitu, a jak reagovat, když dosáhnete limitu. Omezení omezení se vztahují na tato rozhraní API.
Klasifikace rozhraní API
Rozhraní API Azure Data Manageru pro zemědělství spadají do tří hlavních kategorií:
- Operace zápisu: Rozhraní API, která používají metody rozhraní REST API, jako je
PATCH,POSTaDELETEpro změnu dat. - Operace čtení: Rozhraní API, která používají typ
GETmetody REST API k načtení dat, včetně rozhraní API vyhledávání typuPOSTmetody . - Dlouhotrvající operace úloh: Dlouhotrvající asynchronní rozhraní API úloh, která používají typ
PUTmetody REST API .
Mezi tyto kategorie jsou sdíleny celkové dostupné jednotky kvót, jak je vysvětleno v následující tabulce. Například použití celé kvóty pro operace zápisu znamená, že žádná zbývající kvóta pro jiné operace. Každá operace využívá konkrétní jednotku kvóty, která vám pomůže sledovat zbývající kvótu pro další použití.
| Operace | Jednotkové náklady na každou žádost |
|---|---|
| Write | 5 |
| Čteno | 1 1 |
| Dlouhotrvající úloha: odvození řešení | 5 |
| Dlouhotrvající úloha: operace farmy | 5 |
| Dlouhotrvající úloha: rasterizace obrázků | 2 |
| Dlouhotrvající úloha: kaskádové odstranění entity | 2 |
| Dlouhotrvající úloha: příjem počasí | 0 |
| Dlouhotrvající úloha: příjem satelitních dat | 0 |
1Při načítání více než jedné položky se bere v úvahu dodatečné jednotkové náklady pro každou položku vrácenou v odpovědi.
Omezení rozhraní API pro základní verzi
Následující tabulka uvádí celkový počet dostupných jednotek na kategorii pro základní verzi:
| Operace | Časové období omezování | Jednotky se resetují po každém časovém intervalu. |
|---|---|---|
| Zápis/čtení | Za jednu minutu | 25,000 |
| Zápis/čtení | Za pět minut | 100 000 |
| Zápis/čtení | Za jeden měsíc | 5,000,000 |
| Dlouhotrvající úloha | Za pět minut | 1000 |
| Dlouhotrvající úloha | Za jeden měsíc | 100 000 |
Omezení rozhraní API pro standardní verzi
Verze Standard nabízí pětinásobné zvýšení kvóty rozhraní API za měsíc v porovnání s verzí Basic. Všechny ostatní limity kvót zůstanou beze změny.
Následující tabulka uvádí celkový počet dostupných jednotek na kategorii pro standardní verzi:
| Operace | Časové období omezování | Jednotky se resetují po každém časovém intervalu. |
|---|---|---|
| Zápis/čtení | Za jednu minutu | 25,000 |
| Zápis/čtení | Za pět minut | 100 000 |
| Zápis/čtení | Za jeden měsíc | 25 000 000 1 |
| Dlouhotrvající úloha | Za pět minut | 1000 |
| Dlouhotrvající úloha | Za jeden měsíc | 500 000 1 |
1Tento limit je pětkrát limit základní verze.
Kód chyby
Když dosáhnete limitu, obdržíte stavový kód HTTP 429 Příliš mnoho požadavků. Odpověď obsahuje hodnotu Opakování po , která určuje počet sekund, po které má aplikace čekat (nebo spát) před odesláním dalšího požadavku.
Pokud odešlete požadavek před uplynutím hodnoty opakování, požadavek se nezpracuje a vrátí se nová hodnota opakování. Po uplynutí zadaného času můžete žádosti znovu odeslat do Azure Data Manageru pro zemědělství. Při pokusu o navázání připojení TCP nebo použití různých metod ověřování uživatelů se tato omezení neobejde, protože jsou specifické pro každého tenanta.
Nejčastější dotazy
Pokud plně vyčerpám přidělenou kvótu rozhraní API pro operace zápisu během minutového časového intervalu, můžu úspěšně vytvořit požadavky na operace čtení ve stejném časovém intervalu?
Limity kvót jsou sdíleny mezi uvedenými kategoriemi operací. Použití celé kvóty pro operace zápisu neznamená žádnou zbývající kvótu pro jiné operace. Tento článek podrobně popisuje konkrétní jednotky kvót spotřebované pro každou operaci.
Jak můžu vypočítat celkový počet úspěšných požadavků povolených pro určitý časový interval?
Celkový povolený počet úspěšných požadavků rozhraní API závisí na vámi zřízené verzi a časovém intervalu, ve kterém požadavky provedete.
S verzí Standard můžete například provést 25 000 (jednotky resetovat po každém časovém intervalu) / 5 (jednotkové náklady na každou žádost) = 5 000 rozhraní API operací zápisu během jedné minuty. Nebo můžete použít kombinaci 4 000 operací zápisu a 5 000 operací čtení, což vede k 4 000 × 5 + 5 000 × 1 = 25 000 celkových jednotek spotřeby.
Podobně můžete pro verzi Basic provést 5 000 000 jednotek (jednotky resetovat po každém časovém intervalu) / 1 (jednotkové náklady na každou žádost) = 5 000 000 rozhraní API operace čtení v rámci jednorázového časového intervalu.
Kolik událostí senzoru může zákazník ingestovat jako maximální počet?
Systém umožňuje maximálně 100 000 ingestování událostí za hodinu. I když se nové události průběžně přijímají, může dojít ke zpoždění zpracování. Zpoždění může znamenat, že tyto události nejsou okamžitě dostupné pro scénáře výchozího přenosu dat v reálném čase spolu s příjmem dat.