Delen via

Richtlijnen voor API-beperking voor Azure Data Manager for Agriculture

  • Artikel

Beperking beperkt het aantal aanvragen voor een service in een tijdsperiode om te voorkomen dat resources te veel worden gebruikt. Door de beperking van de REST API in Azure Data Manager for Agriculture kunt u binnen een bepaalde periode consistentere prestaties leveren voor klanten die de API's van de service aanroepen.

Azure Data Manager for Agriculture kan een groot aantal aanvragen verwerken. Als er een overweldigend aantal aanvragen van een paar klanten optreedt, helpt beperking de optimale prestaties en betrouwbaarheid voor alle klanten te behouden.

Beperkingslimieten zijn afhankelijk van de geselecteerde versie en de mogelijkheden van het product dat een klant gebruikt. Azure Data Manager for Agriculture ondersteunt twee verschillende versies:

  • Standaard: de versie die we over het algemeen aanbevelen.
  • Basis: Geschikt voor prototypevereisten.

Deze limieten werken binnen drie tijdvensters (per één minuut, per vijf minuten en per één maand) om te beschermen tegen plotselinge pieken in het verkeer.

In dit artikel leest u hoe u het aantal aanvragen kunt bijhouden dat blijft voordat u de limiet bereikt en hoe u kunt reageren wanneer u de limiet bereikt. Beperkingslimieten zijn van toepassing op deze API's.

Classificatie van API's

Azure Data Manager for Agriculture-API's worden onderverdeeld in drie hoofdcategorieën:

  • Schrijfbewerkingen: API's die gebruikmaken van REST API-methoden, zoals PATCH, POSTen DELETE voor het wijzigen van gegevens.
  • Leesbewerkingen: API's die gebruikmaken van het type GET REST API-methode om gegevens op te halen, inclusief zoek-API's van het methodetype POST.
  • Langlopende taakbewerkingen: langlopende asynchrone taak-API's die gebruikmaken van het type PUTREST API-methode.

De totale beschikbare quotumeenheden, zoals uitgelegd in de volgende tabel, worden gedeeld tussen deze categorieën. Als u bijvoorbeeld het volledige quotum voor schrijfbewerkingen gebruikt, betekent dit geen resterend quotum voor andere bewerkingen. Elke bewerking verbruikt een specifieke quotumeenheid, waarmee u het resterende quotum voor verder gebruik kunt bijhouden.

Operation Eenheidskosten voor elke aanvraag
Schrijven 5
Read 1 1
Langlopende taak: oplossingsdeductie 5
Langlopende taak: farmbewerking 5
Langlopende taak: rasterisering van afbeeldingen 2
Langlopende taak: trapsgewijs verwijderen van een entiteit 2
Langlopende taak: weeropname 1
Langlopende taak: satellietopname 1

1Er wordt rekening gehouden met extra eenheidskosten voor elk item dat in het antwoord wordt geretourneerd wanneer u meer dan één item ophalt.

API-limieten voor de Basic-versie

De volgende tabel bevat het totale aantal beschikbare eenheden per categorie voor de Basic-versie:

Operation Tijdvenster voor beperking Eenheden opnieuw instellen na elk tijdvenster
Schrijven/lezen Per minuut 25,000
Schrijven/lezen Per vijf minuten 100.000
Schrijven/lezen Per maand 5,000,000
Langlopende taak Per vijf minuten 1000
Langlopende taak Per maand 100.000

API-limieten voor de Standard-versie

De Standard-versie biedt een vijfvoudige toename van HET API-quotum per maand, vergeleken met de Basic-versie. Alle andere quotumlimieten blijven ongewijzigd.

De volgende tabel bevat het totale aantal beschikbare eenheden per categorie voor de Standard-versie:

Operation Tijdvenster voor beperking Eenheden opnieuw instellen na elk tijdvenster
Schrijven/lezen Per minuut 25,000
Schrijven/lezen Per vijf minuten 100.000
Schrijven/lezen Per maand 25.000.000 1
Langlopende taak Per vijf minuten 1000
Langlopende taak Per maand 500.000 1

1Deze limiet is vijf keer de limiet van de Basic-versie.

Foutcode

Wanneer u de limiet bereikt, ontvangt u de HTTP-statuscode 429 Te veel aanvragen. Het antwoord bevat een waarde voor opnieuw proberen na , waarmee het aantal seconden wordt opgegeven dat uw toepassing moet wachten (of in de slaapstand) moet staan voordat de volgende aanvraag wordt verzonden.

Als u een aanvraag verzendt voordat de waarde voor opnieuw proberen is verstreken, wordt uw aanvraag niet verwerkt en wordt er een nieuwe waarde voor opnieuw proberen geretourneerd. Nadat de opgegeven tijd is verstreken, kunt u opnieuw aanvragen indienen bij Azure Data Manager for Agriculture. Als u probeert een TCP-verbinding tot stand te brengen of verschillende methoden voor gebruikersverificatie gebruikt, worden deze limieten niet overgeslagen, omdat deze specifiek zijn voor elke tenant.

Veelgestelde vragen

Als ik het toegewezen API-quotum volledig uitput voor schrijfbewerkingen binnen een tijdvenster per minuut, kan ik aanvragen voor leesbewerkingen binnen hetzelfde tijdvenster indienen?

De quotumlimieten worden gedeeld tussen de vermelde bewerkingscategorieën. Het gebruik van het volledige quotum voor schrijfbewerkingen impliceert geen resterend quotum voor andere bewerkingen. In dit artikel worden de specifieke quotumeenheden beschreven die voor elke bewerking worden gebruikt.

Hoe kan ik het totale aantal geslaagde aanvragen berekenen dat is toegestaan voor een bepaald tijdvenster?

Het totale toegestane aantal geslaagde API-aanvragen is afhankelijk van de versie die u hebt ingericht en het tijdvenster waarin u aanvragen doet.

Met de Standard-versie kunt u bijvoorbeeld 25.000 (eenheden opnieuw instellen na elk tijdvenster) / 5 (eenheidskosten voor elke aanvraag) = 5.000 schrijfbewerkings-API's binnen een tijdvenster van één minuut. U kunt ook een combinatie van 4.000 schrijfbewerkingen en 5.000 leesbewerkingen gebruiken, wat resulteert in 4.000 * 5 + 5.000 * 1 = 25.000 totale verbruikseenheden.

Op dezelfde manier kunt u voor de Basic-versie 5.000.000 (eenheden opnieuw instellen na elk tijdvenster) / 1 (eenheidskosten voor elke aanvraag) = 5.000.000 leesbewerking-API's binnen een periode van één maand.

Hoeveel sensorgebeurtenissen kan een klant opnemen als het maximumaantal?

Het systeem staat maximaal 100.000 gebeurtenisopnamen per uur toe. Hoewel nieuwe gebeurtenissen voortdurend worden geaccepteerd, kan er een vertraging in de verwerking optreden. De vertraging kan betekenen dat deze gebeurtenissen niet direct beschikbaar zijn voor realtime uitgaande scenario's naast de opname.

Volgende stappen