Kérelem továbbítása
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
- Szabályzatszakaszok: háttérrendszer
- Szabályzathatókörök: globális, munkaterület, termék, API, művelet
- Átjárók: klasszikus, v2, használat, saját üzemeltetésű, munkaterület
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ó 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