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

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

  • Cikk

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

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ó tartalom

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