Wypychanie dostarczania za pomocą protokołu HTTP

  • Artykuł

Ten artykuł opiera się na artykule Co to jest usługa Azure Event Grid? w celu udostępnienia podstawowych informacji przed rozpoczęciem korzystania z dostarczania ściągania i wypychania usługi Event Grid za pośrednictwem protokołu HTTP. Obejmuje ona podstawowe pojęcia, modele zasobów i obsługiwane tryby dostarczania komunikatów. Na końcu tego dokumentu znajdziesz przydatne linki do artykułów, które prowadzą Cię do korzystania z usługi Event Grid i artykułów, które oferują szczegółowe informacje koncepcyjne.

Ważne

Ten dokument ułatwia rozpoczęcie pracy z funkcjami usługi Event Grid korzystającymi z protokołu HTTP. Ten artykuł jest odpowiedni dla użytkowników, którzy muszą integrować aplikacje w chmurze. Jeśli potrzebujesz komunikować się z danymi urządzenia IoT, zobacz Omówienie obsługi protokołu MQTT w usłudze Azure Event Grid.

Podstawowe pojęcia

CloudEvents

Usługa Event Grid jest zgodna z otwartą standardową specyfikacją CLOUDEvents 1.0 firmy CNCF przy użyciu powiązania protokołu HTTP z formatem JSON. Oznacza to, że rozwiązania publikują i używają komunikatów o zdarzeniach przy użyciu formatu podobnego do następującego przykładu:

{
    "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"
    }
}

Co to jest zdarzenie?

Zdarzenie to najmniejsza ilość informacji, które w pełni opisują coś, co wydarzyło się w systemie. Często odnosimy się do zdarzenia, jak pokazano powyżej jako odrębne zdarzenie, ponieważ reprezentuje on odrębny, samodzielny fakt dotyczący systemu, który zapewnia wgląd, który może być możliwy do działania. Przykłady obejmują: com.yourcompany.Orders.OrderCreated, org.yourorg.GeneralLedger.AccountChanged, io.solutionname.Auth.MaximumNumberOfUserLoginAttemptsReached.

Uwaga

Zamiennie używamy terminów zdarzenia dyskretne, cloudevents lub tylko zdarzenia , aby odwoływać się do tych komunikatów, które informują o zmianie stanu systemu.

Aby uzyskać więcej informacji na temat zdarzeń, zobacz Terminologia usługi Event Grid.

Inny rodzaj zdarzenia

Społeczność użytkowników odnosi się również do zdarzeń tego typu komunikatów, które przenoszą punkt danych, takich jak pojedyncze odczyty z urządzenia lub pojedyncze kliknięcie strony aplikacji internetowej. Tego rodzaju zdarzenie jest zwykle analizowane w oknie czasu lub rozmiarze strumienia zdarzeń w celu uzyskania szczegółowych informacji i podjęcia akcji. W dokumentacji usługi Event Grid odwołujemy się do tego rodzaju zdarzenia jako punktu danych, danych przesyłanych strumieniowo lub telemetrii. Są one rodzajem danych obsługiwanych przez usługę MQTT usługi Event Grid i usługi Azure Event Hubs.

Tematy i subskrypcje zdarzeń

Zdarzenia publikowane w usłudze Event Grid znajdują się w temacie, który jest zasobem, który logicznie zawiera wszystkie zdarzenia. Subskrypcja zdarzeń to zasób konfiguracji skojarzony z jednym tematem. Między innymi za pomocą subskrypcji zdarzeń można ustawić kryteria wyboru zdarzeń, aby zdefiniować kolekcję zdarzeń dostępną dla subskrybenta z całkowitego zestawu zdarzeń znajdujących się w temacie.

Diagram showing a topic and associated event subscriptions.

Dostarczanie wypychane

Dostarczanie wypychane jest obsługiwane dla następujących zasobów. Kliknij linki, aby dowiedzieć się więcej o każdym z nich.

  • Tematy systemowe. Tematy systemowe umożliwiają odbieranie zdarzeń (systemowych) z usług platformy Azure.
  • Tematy niestandardowe. Użyj tematów niestandardowych, jeśli chcesz opublikować zdarzenia aplikacji.
  • Domeny. Domeny reprezentują grupę tematów domeny zwykle skojarzonych z jedną aplikacją, która wymaga wysyłania zdarzeń do innej grupy użytkowników, organizacji lub aplikacji. Typowym podejściem jest skojarzenie tematu domeny z grupą aplikacji docelowych lub użytkowników organizacji w ramach tej samej dzierżawy. Organizacja może być zespołem, oddziałem w firmie, firmą itp.
  • Tematy dla partnerów. Użyj tematów partnerów, jeśli chcesz korzystać ze zdarzeń od partnerów innych firm.

Skonfiguruj subskrypcję zdarzeń w temacie systemowym, niestandardowym lub partnerskim, aby określić kryteria filtrowania zdarzeń i ustawić miejsce docelowe na jedną z obsługiwanych procedur obsługi zdarzeń.

Na poniższym diagramie przedstawiono zasoby, które obsługują dostarczanie wypychane przy użyciu niektórych obsługiwanych programów obsługi zdarzeń.

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

Uwaga

Jeśli chcesz dowiedzieć się więcej na temat dostarczania wypychanych w przestrzeniach nazw usługi Event Grid, zobacz [namespace-push-delivery-overview.md].

Następne kroki

Poniższe artykuły zawierają informacje na temat korzystania z usługi Event Grid lub dostarczania dodatkowych informacji na temat pojęć.