Dela via

Push-leverans med HTTP

  • Artikel

Den här artikeln bygger på Vad är Azure Event Grid? för att tillhandahålla viktig information innan du börjar använda Event Grids pull- och push-leverans via HTTP. Den omfattar grundläggande begrepp, resursmodeller och meddelandeleveranslägen som stöds. I slutet av det här dokumentet hittar du användbara länkar till artiklar som vägleder dig om hur du använder Event Grid och till artiklar som erbjuder djupgående konceptuell information.

Viktigt!

Det här dokumentet hjälper dig att komma igång med Event Grid-funktioner som använder HTTP-protokollet. Den här artikeln är lämplig för användare som behöver integrera program i molnet. Om du behöver kommunicera IoT-enhetsdata kan du läsa Översikt över MQTT-supporten i Azure Event Grid.

Huvudkoncept

CloudEvents

Event Grid överensstämmer med CNCF:s öppna CloudEvents 1.0-standardspecifikation med http-protokollbindningen med JSON-format. Det innebär att dina lösningar publicerar och använder händelsemeddelanden med ett format som liknar följande exempel:

{
    "specversion" : "1.0",
    "type" : "com.yourcompany.order.created",
    "source" : "https://yourcompany.com/orders/",
    "subject" : "O-28964",
    "id" : "A234-1234-1234",
    "time" : "2018-04-05T17:31:00Z",
    "comexampleextension1" : "value",
    "comexampleothervalue" : 5,
    "datacontenttype" : "application/json",
    "data" : {
       "orderId" : "O-28964",
       "URL" : "https://com.yourcompany/orders/O-28964"
    }
}

Vad är en händelse?

En händelse är den minsta mängd information som helt beskriver något som hände i ett system. Vi refererar ofta till en händelse som visas ovan som en diskret händelse eftersom den representerar ett distinkt, fristående faktum om ett system som ger en insikt som kan användas. Exempel är: com.yourcompany.Orders.OrderCreated, org.yourorg.GeneralLedger.AccountChanged, io.solutionname.Auth.MaximumNumberOfUserLoginAttemptsReached.

Kommentar

Vi använder omväxlande termerna diskreta händelser, cloudevents eller bara händelser för att referera till de meddelanden som informerar om en ändring av ett systemtillstånd.

Mer information om händelser finns i Event Grid-terminologin.

En annan typ av händelse

Användarcommunityn refererar också till händelser till den typ av meddelanden som bär en datapunkt, till exempel en enda läsning från en enhet eller ett enda klick på en webbappssida. Den typen av händelse analyseras vanligtvis under ett tidsfönster eller händelseströmsstorlek för att härleda insikter och vidta en åtgärd. I Event Grids dokumentation refererar vi till den typen av händelse som datapunkt, strömmande data eller telemetri. De är en typ av data som Event Grids MQTT-stöd och Azure Event Hubs vanligtvis hanterar.

Ämnen och händelseprenumerationer

Händelser som publiceras i Event Grid hamnar i ett ämne, vilket är en resurs som logiskt innehåller alla händelser. En händelseprenumeration är en konfigurationsresurs som är associerad med ett enskilt ämne. Du kan bland annat använda en händelseprenumeration för att ange kriterier för händelseval för att definiera den händelsesamling som är tillgänglig för en prenumerant av den totala uppsättningen händelser som finns i ett ämne.

Diagram showing a topic and associated event subscriptions.

Push-leverans

Push-leverans stöds för följande resurser. Klicka på länkarna om du vill veta mer om var och en av dem.

  • Systemämnen. Använd systemavsnitt för att ta emot (system)-händelser från Azure-tjänster.
  • Anpassade ämnen. Använd anpassade ämnen när du vill publicera programmets händelser.
  • Domäner. Domäner representerar en grupp med domänämnen som vanligtvis är associerade med ett enda program som kräver att händelser skickas till olika grupper av användare, organisationer eller program. En vanlig metod är att associera ett domänämne med en grupp målprogram eller användare av en organisation inom samma klientorganisation. En organisation kan vara ett team, en division i företaget, ett företag osv.
  • Partnerämnen. Använd partnerämnen när du vill använda händelser från tredjepartspartner.

Konfigurera en händelseprenumeration på ett system-, anpassat eller partnerämne för att ange ett filtreringsvillkor för händelser och ange ett mål till en av de händelsehanterare som stöds.

Följande diagram illustrerar de resurser som stöder push-leverans med några av de händelsehanterare som stöds.

High-level diagram showing all the topic types that support push delivery, namely System, Custom, Domain, and Partner topics.

Kommentar

Om du är intresserad av att veta mer om push-leverans på Event Grid-namnområden kan du läsa [namespace-push-delivery-overview.md].

Nästa steg

I följande artiklar får du information om hur du använder Event Grid eller ger dig ytterligare information om begrepp.