Politici de conversie pentru serviciul de administrare api azure, microsoft docs

Secțiuni de politici: intrare, ieșire, backend, on-error.

Domeniile de politică: global, produs, API, funcționare.

Politica de redirecționare a conținutului url suprascrie (ascunde) legăturile din textul de răspuns, astfel încât fiecare să indice către o legătură echivalentă prin poarta de acces. Utilizați secțiunea de ieșire pentru a suprascrie referințele textului de răspuns, astfel încât să indice către poarta de acces. Utilizați în secțiunea de intrare pentru efectul opus.







Această politică nu modifică valoarea antetului, de exemplu, antetul Locație. Pentru a modifica valorile antetului, utilizați politica set-header.

Regulă politică

Secțiuni de politici: de intrare, de ieșire.

Domeniile de politică: global, produs, API, funcționare.

Setarea serviciului intern

Regulă politică

În acest exemplu, politica internă de furnizare a serviciilor direcționează solicitările bazate pe valoarea versiunii transmise în șirul de interogări către serviciul intern diferit de cel specificat în API.

Dacă aveți nevoie de transformări suplimentare de interogări, puteți utiliza alte politici de conversie. De exemplu, pentru a elimina parametrul de interogare al unei versiuni după trimiterea unei cereri către o versiune de server specifică a versiunii, puteți utiliza politica Parametru șir de interogare pentru interogări pentru a elimina atributul de versiune redundantă.

În acest exemplu, politica direcționează cererea către serviciul intern Fabric folosind șirul de interogare userId ca tastă secțiune și utilizând replica primară a secțiunii.

Secțiuni de politici: inbound, backend.

Domeniile de politică: global, produs, API, funcționare.

Specificarea textului

Utilizați politica set-body. Pentru a seta textul mesajului pentru cererile de intrare și ieșire. Pentru a accesa textul mesajului, puteți utiliza proprietatea context.Request.Body sau context.Response.Body, în funcție de locul unde se află politica: în secțiunea de intrare sau ieșire.







Vă rugăm să rețineți că este pierdut și trebuie să fie stabilite, revenind textul înapoi în expresia în mod implicit atunci când accesați mesaje text utilizând context.Request.Body sau textul original context.Response.Body. Pentru a salva conținutul textului, setați parametrul conserveContent la adevărat la accesarea mesajului. Dacă preserveContent este setat la true și expresia returnează alt text, textul returnat este utilizat.

Luați în considerare următoarele recomandări atunci când utilizați politica set-body.

  • Dacă utilizați politica set-body pentru a returna un text nou sau actualizat. parametrul preserveContent nu trebuie să fie setat la true. deoarece specificați în mod explicit conținut nou text.
    • A păstra conținutul răspunsului în conducta de intrare nu are sens, deoarece nu există încă un răspuns.
    • Pentru a salva conținutul solicitării în conducta de ieșire nu are sens, deoarece în această etapă cererea a fost deja trimisă la partea de server.
    • Dacă această politică este utilizată atunci când nu există text de mesaj, de exemplu, în parametrul GET de intrare, este aruncată o excepție.

Pentru mai multe informații, consultați context.Request.Body. context.Response.Body și IMessage în tabelul cu variabile de context.

Regulă politică

Exemplu de text literal

Exemplu de accesare a textului ca șir De reținut că stocăm textul original al interogării, astfel încât să îl puteți referi mai târziu la aceasta.

Exemplu de accesare a textului ca obiect JObject Rețineți că nu am rezervat textul sursă al interogării, încercând astfel să îl accesăm mai târziu în conductă va duce la o excepție.

Filtrarea răspunsului în funcție de produs

Utilizarea șabloanelor lichide cu politica setată

În politica set-body, puteți configura utilizarea limbajului șablon Liquid pentru a converti textul unei interogări sau a unui răspuns. Acest lucru poate fi foarte eficient atunci când doriți să schimbați complet formatul mesajului.

Implementarea template-urilor de lichide utilizate în politica de stabilire a corpului. este configurat în modul C #. Acest lucru este important în special atunci când efectuați acțiuni cum ar fi filtrarea. De exemplu, dacă utilizați un filtru după dată, trebuie să utilizați stilul Pascal și să formatați data C #, ca în exemplul următor:

Pentru a utiliza șablonul Liquid pentru a lega corect textul XML, utilizați politica set-header. Setați Content-Type la aplicație / xml sau text / xml (sau orice alt tip care se termină în + xml). Pentru textul JSON, valoarea trebuie să fie aplicație / json sau text / json (sau orice alt tip care se termină cu + json).

Conversia JSON în SOAP folosind șablonul Liquid

Conversia JSON folosind șablonul Liquid







Articole similare

Trimiteți-le prietenilor: