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ű, munkaterület
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
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