Használati kvóta beállítása előfizetés szerint
A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint
A quota
szabályzat előfizetésenként egy megújítható vagy élettartamú hívásmennyiséget és/vagy sávszélesség-kvótát kényszerít ki. A kvóta túllépésekor a hívó válaszállapot-kódot 403 Forbidden
kap, és a válasz tartalmaz egy Retry-After
fejlécet, amelynek értéke az ajánlott újrapróbálkozási időköz másodpercben.
A sebességkorlátok és a kvóták közötti különbség megértéséhez tekintse meg a sebességkorlátokat és a kvótákat.
Feljegyzés
Amikor a mögöttes számítási erőforrások újraindulnak a szolgáltatási platformon, az API Management a kvóta elérése után is kezelheti a kérelmeket rövid ideig.
Feljegyzés
Állítsa be a szabályzat elemeit és gyermekelemeit a szabályzatutasításban megadott sorrendben. További információ az API Management-szabályzatok beállításáról és szerkesztéséről.
Szabályzatutasítás
<quota calls="number" bandwidth="kilobytes" renewal-period="seconds">
<api name="API name" id="API id" calls="number">
<operation name="operation name" id="operation id" calls="number" />
</api>
</quota>
Attribútumok
Attribútum | Leírás | Kötelező | Alapértelmezett |
---|---|---|---|
bandwidth | A maximálisan engedélyezett kilobájtok száma a megadott időintervallumban renewal-period . A szabályzatkifejezések nem engedélyezettek. |
Vagy calls , bandwidth vagy mindkettőt együtt kell megadni. |
n/a |
Hívások | Az engedélyezett hívások maximális száma a megadott időintervallumban renewal-period . A szabályzatkifejezések nem engedélyezettek. |
Vagy calls , bandwidth vagy mindkettőt együtt kell megadni. |
n/a |
megújítási időszak | A rögzített időszak másodpercben megadott hossza, amely után a kvóta alaphelyzetbe áll. Az egyes időszakok kezdete az előfizetés kezdő időpontjához viszonyítva lesz kiszámítva. Ha renewal-period a beállítás értéke 0 végtelen. A szabályzatkifejezések nem engedélyezettek. |
Igen | n/a |
Elemek
Elem | Leírás | Kötelező |
---|---|---|
api | Adjon hozzá egy vagy több elemet, hogy híváskvótát rendeljen a termék API-ihoz. A termék- és API-híváskvóták egymástól függetlenül lesznek alkalmazva. Az API-ra vagy a name id . Ha mindkét attribútum meg van adva, id a rendszer használja és name figyelmen kívül hagyja. |
Nem |
művelet | Adjon hozzá egy vagy több elemet, hogy híváskvótát rendeljen egy API-n belüli műveletekhez. A termék-, API- és műveleti híváskvóták egymástól függetlenül lesznek alkalmazva. A műveletre a vagy id a segítségével name lehet hivatkozni. Ha mindkét attribútum meg van adva, id a rendszer használja és name figyelmen kívül hagyja. |
Nem |
api-attribútumok
Attribútum | Leírás | Kötelező | Alapértelmezett |
---|---|---|---|
név | Annak az API-nak a neve, amelyre alkalmazni szeretné a híváskvótakorlátot. | Vagy name meg id kell adni. |
n/a |
id | Annak az API-nak az azonosítója, amelyre alkalmazni szeretné a híváskvótakorlátot. | Vagy name meg id kell adni. |
n/a |
bandwidth | A maximálisan engedélyezett kilobájtok száma a megadott időintervallumban renewal-period . A szabályzatkifejezések nem engedélyezettek. |
Vagy calls , bandwidth vagy mindkettőt együtt kell megadni. |
n/a |
Hívások | Az engedélyezett hívások maximális száma a megadott időintervallumban renewal-period . A szabályzatkifejezések nem engedélyezettek. |
Vagy calls , bandwidth vagy mindkettőt együtt kell megadni. |
n/a |
megújítási időszak | A rögzített időszak másodpercben megadott hossza, amely után a kvóta alaphelyzetbe áll. Az egyes időszakok kezdete az előfizetés kezdő időpontjához viszonyítva lesz kiszámítva. Ha renewal-period a beállítás értéke 0 végtelen. A szabályzatkifejezések nem engedélyezettek. |
Igen | n/a |
műveleti attribútumok
Attribútum | Leírás | Kötelező | Alapértelmezett |
---|---|---|---|
név | Annak a műveletnek a neve, amelyre alkalmazni szeretné a híváskvótakorlátot. | Vagy name meg id kell adni. |
n/a |
id | Annak a műveletnek az azonosítója, amelyre alkalmazni szeretné a híváskvótakorlátot. | Vagy name meg id kell adni. |
n/a |
bandwidth | A maximálisan engedélyezett kilobájtok száma a megadott időintervallumban renewal-period . A szabályzatkifejezések nem engedélyezettek. |
Vagy calls , bandwidth vagy mindkettőt együtt kell megadni. |
n/a |
Hívások | Az engedélyezett hívások maximális száma a megadott időintervallumban renewal-period . A szabályzatkifejezések nem engedélyezettek. |
Vagy calls , bandwidth vagy mindkettőt együtt kell megadni. |
n/a |
megújítási időszak | A rögzített időszak másodpercben megadott hossza, amely után a kvóta alaphelyzetbe áll. Az egyes időszakok kezdete az előfizetés kezdő időpontjához viszonyítva lesz kiszámítva. Ha renewal-period a beállítás értéke 0 végtelen. A szabályzatkifejezések nem engedélyezettek. |
Igen | n/a |
Használat
- Szabályzatszakaszok: bejövő
- Szabályzat hatókörei: termék
- Átjárók: klasszikus, v2, használat, saját üzemeltetésű, munkaterület
Használati megjegyzések
- Ez a szabályzat szabályzatdefiníciónként csak egyszer használható.
- Ezt a szabályzatot csak akkor alkalmazza a rendszer, ha egy API-t egy előfizetési kulccsal érnek el.
Példa
<policies>
<inbound>
<base />
<quota calls="10000" bandwidth="40000" renewal-period="3600" />
</inbound>
<outbound>
<base />
</outbound>
</policies>
Kapcsolódó szabályzatok
Kapcsolódó tartalom
A szabályzatok használatával kapcsolatos további információkért lásd:
- Oktatóanyag: AZ API átalakítása és védelme
- Szabályzathivatkozás a szabályzatutasságok és azok beállításainak teljes listájához
- Házirend-kifejezések
- Házirendek beállítása vagy szerkesztése
- Szabályzatkonfigurációk újrafelhasználása
- Szabályzatrészletek adattára
- Azure API Management policy toolkit
- Szabályzatok létrehozása a Microsoft Copilot használatával az Azure-ban