Tároló gyorsítótárazásához

A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint

A cache-store szabályzat a megadott gyorsítótárbeállításoknak megfelelően gyorsítótárazza a válaszokat. Ez a szabályzat olyan esetekben alkalmazható, amikor a választartalmak állandóak maradnak egy adott időszakban. A válasz-gyorsítótárazás csökkenti a háttérbeli webkiszolgálóra vonatkozó sávszélesség- és feldolgozási követelményeket, valamint csökkenti az API-használók által érzékelt késést.

Feljegyzés

Ennek a szabályzatnak rendelkeznie kell egy megfelelő get from cache szabályzattal.

Fontos

A beépített gyorsítótár változékony, és az ugyanabban a régióban lévő összes egység megosztja ugyanabban az API Management szolgáltatásban.

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

<cache-store duration="seconds" cache-response="true | false" />

Attribútumok

Attribútum Leírás Kötelező Alapértelmezett
időtartam A gyorsítótárazott bejegyzések élettartamának beállítása másodpercben megadva. A szabályzatkifejezések engedélyezettek. Igen n/a
gyorsítótár-válasz Állítsa be az true aktuális HTTP-válasz gyorsítótárazására. Ha az attribútum nincs megadva, csak az állapotkóddal 200 OK rendelkező HTTP-válaszok lesznek gyorsítótárazva. A szabályzatkifejezések engedélyezettek. Nem false

Használat

Használati megjegyzések

  • Az API Management csak a HTTP GET-kérelmekre adott válaszokat gyorsítótárazza.
  • Ez a szabályzat csak egyszer használható egy szabályzatszakaszban.
  • Javasoljuk, hogy a gyorsítótár-keresés után azonnal konfiguráljon egy sebességkorlátozó szabályzatot (vagy kulcsonkénti sebességkorlátozási szabályzatot). Ez segít abban, hogy a háttérszolgáltatás túlterhelt legyen, ha a gyorsítótár nem érhető el.

Példák

Példa a megfelelő gyorsítótár-keresési szabályzattal

Ez a példa bemutatja, hogyan használható a cache-store szabályzat és a cache-lookup szabályzat a válaszok gyorsítótárazására a beépített API Management-gyorsítótárban.

Feljegyzés

Adjon hozzá egy sebességkorlát-szabályzatot (vagy kulcsonkénti sebességkorlátozási szabályzatot) a gyorsítótár-keresés után, hogy korlátozza a hívások számát, és megakadályozza a háttérszolgáltatás túlterhelését abban az esetben, ha a gyorsítótár nem érhető el.

<policies>
    <inbound>
        <base />
        <cache-lookup vary-by-developer="false" vary-by-developer-groups="false" downstream-caching-type="none" must-revalidate="true" caching-type="internal" >
            <vary-by-query-parameter>version</vary-by-query-parameter>
        </cache-lookup>
        <rate-limit calls="10" renewal-period="60" />
    </inbound>
    <outbound>
        <cache-store duration="seconds" />
        <base />
    </outbound>
</policies>

Példa szabályzatkifejezések használatával

Ez a példa bemutatja, hogyan konfigurálhatja az API Management válasz gyorsítótárazási időtartamát, amely megfelel a háttérszolgáltatás irányelvében Cache-Control meghatározott válasz gyorsítótárazásának.

<!-- The following cache policy snippets demonstrate how to control API Management response cache duration with Cache-Control headers sent by the backend service. -->

<!-- Copy this snippet into the inbound section -->
<cache-lookup vary-by-developer="false" vary-by-developer-groups="false" downstream-caching-type="public" must-revalidate="true" >
  <vary-by-header>Accept</vary-by-header>
  <vary-by-header>Accept-Charset</vary-by-header>
</cache-lookup>
 <rate-limit calls="10" renewal-period="60" />

<!-- Copy this snippet into the outbound section. Note that cache duration is set to the max-age value provided in the Cache-Control header received from the backend service or to the default value of 5 min if none is found  -->
<cache-store duration="@{
    var header = context.Response.Headers.GetValueOrDefault("Cache-Control","");        
    var maxAge = Regex.Match(header, "@(max-age=(?<maxAge>\\d+))").Groups["maxAge"]?.Value;
    return (!string.IsNullOrEmpty(maxAge))?int.Parse(maxAge):300; }" />

További információ: Szabályzatkifejezések és környezeti változó.

Kapcsolódó tartalom

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

  • Last updated on