Megosztás a következőn keresztül:

Használati kvóta beállítása kulcs szerint

  • Cikk

A KÖVETKEZŐKRE VONATKOZIK: Fejlesztő | Alapszintű | Standard | Prémium

A quota-by-key szabályzat kulcsonként kényszeríti ki a megújítható vagy élettartamú hívásmennyiséget és/vagy sávszélesség-kvótát. A kulcs tetszőleges sztringértékkel rendelkezhet, és általában egy szabályzatkifejezéssel adható meg. Az opcionális növekményes feltétel hozzáadható annak meghatározásához, hogy mely kéréseket kell beleszámítani a kvótába. Ha több szabályzat is növelné ugyanazt a kulcsértéket, az kérésenként csak egyszer növekszik. 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. A szabályzat konfigurálásához a portál egy irányított, űrlapalapú szerkesztőt biztosít. 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-by-key calls="number"
              bandwidth="kilobytes"
              renewal-period="seconds"
              increment-condition="condition"
              counter-key="key value"
              first-period-start="date-time" />

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, bandwidthvagy 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, bandwidthvagy mindkettőt együtt kell megadni. n/a
számlálókulcs A kulcs, amelyet a quota policy. Minden kulcsértékhez egyetlen számlálót használ a rendszer minden olyan hatókörhöz, amelyen a szabályzat konfigurálva van. A szabályzatkifejezések engedélyezettek. Igen n/a
növekményes feltétel A logikai kifejezés, amely megadja, hogy a kérést bele kell-e számolni a kvótába (true). A szabályzatkifejezések engedélyezettek. Nem 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 kezdetét a program a következőhöz viszonyítva first-period-startszámítja ki: . Minimális időtartam: 300 másodperc. Ha renewal-period 0 értékre van állítva, az időszak végtelenre van állítva. A szabályzatkifejezések nem engedélyezettek. Igen n/a
első időszak kezdete A kvótamegújítási időszakok kezdő dátuma és időpontja, az ISO yyyy-MM-ddTHH:mm:ssZ 8601 szabványnak megfelelően. A szabályzatkifejezések nem engedélyezettek. Nem 0001-01-01T00:00:00Z

Használat

Használati megjegyzések

Az counter-key attribútumértéknek egyedinek kell lennie az API Management-példány összes API-jában, ha nem szeretné megosztani az összes többi API-t.

Példa

<policies>
    <inbound>
        <base />
        <quota-by-key calls="10000" bandwidth="40000" renewal-period="3600"
                      increment-condition="@(context.Response.StatusCode >= 200 && context.Response.StatusCode < 400)"
                      counter-key="@(context.Request.IpAddress)" />
    </inbound>
    <outbound>
        <base />
    </outbound>
</policies>

A szabályzatra vonatkozó további információkért és példákért tekintse meg az Azure API Management speciális kérésszabályozását.

Kapcsolódó tartalom

A szabályzatok használatával kapcsolatos további információkért lásd: