Egyirányú kérés küldése
A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint
A send-one-way-request
szabályzat anélkül küldi el a megadott kérést a megadott URL-címre, hogy választ vár.
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
<send-one-way-request mode="new | copy" timeout="time in seconds">
<set-url>request URL</set-url>
<set-method>...</set-method>
<set-header>...</set-header>
<set-body>...</set-body>
<authentication-certificate thumbprint="thumbprint" />
</send-one-way-request>
Attribútumok
Attribútum | Leírás | Kötelező | Alapértelmezett |
---|---|---|---|
mód | Meghatározza, hogy ez egy new kérés, vagy copy az aktuális kérelem fejléceinek és törzsének egy része. A kimenő szabályzat szakaszban mode=copy nem inicializálja a kérelem törzsét. A szabályzatkifejezések engedélyezettek. |
Nem | new |
timeout | Az URL-cím hívásának meghiúsulása előtt másodpercekben megadott időtúllépési időköz. A szabályzatkifejezések engedélyezettek. | Nem | 60 |
Elemek
Elem | Leírás | Kötelező |
---|---|---|
set-url | A kérés URL-címe. A szabályzatkifejezések engedélyezettek. | Nem, ha mode=copy ; egyébként igen. |
set-method | Beállítja a kérés metódusát. A szabályzatkifejezések nem engedélyezettek. | Nem, ha mode=copy ; egyébként igen. |
set-header | Beállít egy fejlécet a kérelemben. Több set-header elem használata több kérelemfejléchez. |
Nem |
set-body | Beállítja a kérelem törzsét. | Nem |
hitelesítés-tanúsítvány |
Egy attribútumban thumbprint megadott ügyfélhitelesítéshez használandó tanúsítvány. |
Nem |
helyettes | A kérelem átirányítása HTTP-proxyn keresztül. | Nem |
Használat
- Szabályzatszakaszok: bejövő, kimenő, háttérrendszer, hiba
- 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ű
Példa
Ez a példa a send-one-way-request
szabályzatot használja arra, hogy üzenetet küldjön egy Slack-csevegőszobába, ha a HTTP-válaszkód nagyobb vagy egyenlő 500-nál. A mintával kapcsolatos további információkért lásd : Az Azure API Management szolgáltatás külső szolgáltatásainak használata.
<choose>
<when condition="@(context.Response.StatusCode >= 500)">
<send-one-way-request mode="new" timeout="20">
<set-url>https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX</set-url>
<set-method>POST</set-method>
<set-body>@{
return new JObject(
new JProperty("username","APIM Alert"),
new JProperty("icon_emoji", ":ghost:"),
new JProperty("text", String.Format("{0} {1}\nHost: {2}\n{3} {4}\n User: {5}",
context.Request.Method,
context.Request.Url.Path + context.Request.Url.QueryString,
context.Request.Url.Host,
context.Response.StatusCode,
context.Response.StatusReason,
context.User.Email
))
).ToString();
}</set-body>
</send-one-way-request>
</when>
</choose>
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