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

Kérelem továbbítása

  • Cikk

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

A forward-request házirend továbbítja a bejövő kérést a kérelemkörnyezetben megadott háttérszolgáltatásnak. A háttérszolgáltatás URL-címe az API-beállításokban van megadva, és a beállított háttérszolgáltatás-szabályzattal módosítható.

Fontos

  • Ez a szabályzat a kérések API-háttérrendszernek való továbbításához szükséges. Alapértelmezés szerint az API Management beállítja ezt a szabályzatot a globális hatókörben.
  • A szabályzat eltávolítása azt eredményezi, hogy a kérés nem lesz továbbítva a háttérszolgáltatásnak. A kimenő szakaszban lévő szabályzatokat a rendszer azonnal kiértékeli a bejövő szakaszban lévő szabályzatok sikeres befejezése után.

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

<forward-request http-version="1 | 2or1 | 2" timeout="time in seconds (alternatively, use timeout-ms)" | timeout-ms="time in milliseconds (alternatively, use timeout)" continue-timeout="time in seconds" follow-redirects="false | true" buffer-request-body="false | true" buffer-response="true | false" fail-on-error-status-code="false | true"/>

Attribútumok

Attribútum Leírás Kötelező Alapértelmezett
timeout Az időtúllépési hiba felmerülése előtt másodpercek alatt meg kell várni, amíg a háttérszolgáltatás visszaadja a HTTP-válaszfejléceket. A minimális érték 0 másodperc. A 240 másodpercnél nagyobb értékeket nem lehet tiszteletben tartani, mert a mögöttes hálózati infrastruktúra ezen idő után megszakadhat az inaktív kapcsolatok. A szabályzatkifejezések engedélyezettek. Megadhatja vagy timeout timeout-ms mindkettőt, de mindkettőt nem. Nem 300
időtúllépés-ms Ezredmásodpercben meg kell várni, amíg a háttérszolgáltatás visszaadja a HTTP-válaszfejléceket az időtúllépési hiba felmerülése előtt. A minimális érték 0 ms. A szabályzatkifejezések engedélyezettek. Megadhatja vagy timeout timeout-ms mindkettőt, de mindkettőt nem. Nem N.A.
folytatási időtúllépés Az az idő másodpercben, amíg a háttérszolgáltatás időtúllépési hiba felmerülése előtt visszaad 100 Continue egy állapotkódot. A szabályzatkifejezések engedélyezettek. Nem N.A.
http-verzió A HTTP-válasz háttérszolgáltatásnak való küldésekor használandó HTTP-specifikációs verzió. Ha ezt használja 2or1, az átjáró a HTTP /2/1-et részesíti előnyben, de ha a HTTP /2 nem működik, térjen vissza a HTTP /1-hez. Nem 0
követő átirányítások Megadja, hogy a háttérszolgáltatásból érkező átirányításokat az átjáró követi-e vagy adja vissza a hívónak. A szabályzatkifejezések engedélyezettek. Nem false
puffer-request-body Ha be van trueállítva, a rendszer puffereli a kérést, és újrapróbálkozáskor újra felhasználja. Nem false
puffer-válasz Hatással van az adattömbre adott válaszok feldolgozására. Ha be van falseállítva, a háttérrendszertől kapott összes adattömb azonnal visszakerül a hívónak. Ha be van trueállítva, a rendszer puffereli az adattömböket (8 KB, kivéve, ha a stream vége észlelhető), és csak ezután adja vissza a hívónak.

false Állítson be olyan háttérrendszereket, mint például a kiszolgáló által küldött eseményeket (SSE), amelyek megkövetelik a tartalom azonnali visszaadását vagy streamelését a hívónak. A szabályzatkifejezések nem engedélyezettek.		 Nem true
fail-on-error-status-code Ha be van trueállítva, a 400 és 599 közötti tartomány válaszkódjainak hibakeresési szakaszát aktiválja. A szabályzatkifejezések nem engedélyezettek. Nem false

Használat

Példák

Kérés küldése HTTP/2 háttérrendszernek

Az alábbi API-szintű szabályzat az összes API-kérést egy HTTP/2 háttérszolgáltatásnak továbbítja.

<!-- api level -->
<policies>
    <inbound>
        <base/>
    </inbound>
    <backend>
        <forward-request http-version="2or1"/>
    </backend>
    <outbound>
        <base/>
    </outbound>
</policies>

Ez http /2 vagy gRPC számítási feladatokhoz szükséges, és jelenleg csak a saját üzemeltetésű átjáróban támogatott. További információ az API Gateway áttekintésében.

Kérelem továbbítása időtúllépési időközzel

A következő API-szintű szabályzat 60 másodperces időtúllépési intervallummal továbbítja az összes API-kérést a háttérszolgáltatásnak.

<!-- api level -->
<policies>
    <inbound>
        <base/>
    </inbound>
    <backend>
        <forward-request timeout="60"/>
    </backend>
    <outbound>
        <base/>
    </outbound>
</policies>

Házirend öröklése szülőhatókörből

Ez a műveleti szintű szabályzat az base elem használatával örökli a háttérházirendet a szülő API-szint hatóköréből.

<!-- operation level -->
<policies>
    <inbound>
        <base/>
    </inbound>
    <backend>
        <base/>
    </backend>
    <outbound>
        <base/>
    </outbound>
</policies>

Ne örökölje a házirendet a szülő hatóköréből

Ez a műveleti szintű szabályzat explicit módon továbbítja az összes kérést a háttérszolgáltatásnak 120-es időtúllépéssel, és nem örökli a szülő API-szintű háttérszabályzatot. Ha a háttérszolgáltatás 400 és 599 közötti hibaállapot-kóddal válaszol, a hibaszakasz aktiválódik.

<!-- operation level -->
<policies>
    <inbound>
        <base/>
    </inbound>
    <backend>
        <forward-request timeout="120" fail-on-error-status-code="true" />
        <!-- effective policy. note the absence of <base/> -->
    </backend>
    <outbound>
        <base/>
    </outbound>
</policies>

Ne továbbítsa a kéréseket a háttérrendszernek

Ez a műveleti szintű szabályzat nem továbbítja a kéréseket a háttérszolgáltatásnak.

<!-- operation level -->
<policies>
    <inbound>
        <base/>
    </inbound>
    <backend>
        <!-- no forwarding to backend -->
    </backend>
    <outbound>
        <base/>
    </outbound>
</policies>

Kapcsolódó tartalom

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