Rewrite URL (URL-átírás)

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

A rewrite-uri szabályzat átalakítja a kérelem URL-címét a nyilvános űrlapjáról a webszolgáltatás által várt űrlapra, ahogyan az az alábbi példában látható.

• Nyilvános URL-cím – http://api.example.com/storenumber/ordernumber

• Kérelem URL-címe – http://api.example.com/v2/US/hardware/storenumber&ordernumber?City&State

Ez a szabályzat akkor használható, ha egy emberi és/vagy böngészőbarát URL-címet a webszolgáltatás által várt URL-formátummá kell alakítani. Ezt a szabályzatot csak akkor kell alkalmazni, ha egy másik URL-formátumot ad ki, például tiszta URL-címeket, RESTful URL-eket, felhasználóbarát URL-címeket vagy keresőoptimalizáló URL-eket, amelyek kizárólag olyan szerkezeti URL-címek, amelyek nem tartalmaznak lekérdezési sztringet, és ehelyett csak az erőforrás elérési útját tartalmazzák (a séma és a szolgáltató után). Ez gyakran esztétikai, használhatósági vagy keresőoptimalizálási (SEO) célokra történik.

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

<rewrite-uri template="uri template" copy-unmatched-params="true | false" />

Attribútumok

Név	Leírás	Kötelező	Alapértelmezett
sablon	A webszolgáltatás tényleges URL-címe bármilyen lekérdezési sztringparaméterrel. A szabályzatkifejezések engedélyezettek. Kifejezések használata esetén a teljes értéknek kifejezésnek kell lennie.	Igen	n/a
copy-unmatched-params	Megadja, hogy a bejövő kérelemben szereplő, az eredeti URL-sablonban nem szereplő lekérdezési paraméterek hozzáadódnak-e az átírási sablon által meghatározott URL-címhez. A szabályzatkifejezések engedélyezettek.	Nem	true

Használat

• Szabályzatszakaszok: bejövő
• 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ű

Használati megjegyzések

Lekérdezési sztringparamétereket csak a szabályzat használatával adhat hozzá. Az átírt URL-címhez nem adhat hozzá további sablonút-paramétereket.

Példa

<policies>
    <inbound>
        <base />
        <rewrite-uri template="/v2/US/hardware/{storenumber}&{ordernumber}?City=city&State=state" />
    </inbound>
    <outbound>
        <base />
    </outbound>
</policies>

<!-- Assuming incoming request is /get?a=b&c=d and operation template is set to /get?a={b} -->
<policies>
    <inbound>
        <base />
        <rewrite-uri template="/put" />
    </inbound>
    <outbound>
        <base />
    </outbound>
</policies>
<!-- Resulting URL will be /put?c=d -->

<!-- Assuming incoming request is /get?a=b&c=d and operation template is set to /get?a={b} -->
<policies>
    <inbound>
        <base />
        <rewrite-uri template="/put" copy-unmatched-params="false" />
    </inbound>
    <outbound>
        <base />
    </outbound>
</policies>
<!-- Resulting URL will be /put -->

Kapcsolódó szabályzatok

• Transzformáció

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
• Szabályzatok létrehozása a Microsoft Copilot használatával az Azure-ban