Recapito push con HTTP

  • Articolo

Questo articolo si basa su Che cos'è Griglia di eventi di Azure? per fornire informazioni essenziali prima di iniziare a usare il pull e il recapito push di Griglia di eventi su HTTP. Vengono illustrati i concetti fondamentali, i modelli di risorse e le modalità di recapito dei messaggi supportati. Alla fine di questo documento sono disponibili collegamenti utili agli articoli che illustrano come usare Griglia di eventi e agli articoli che offrono informazioni concettuali approfondite.

Importante

Questo documento illustra come iniziare a usare le funzionalità di Griglia di eventi che usano il protocollo HTTP. Questo articolo è adatto agli utenti che devono integrare applicazioni nel cloud. Se è necessario comunicare i dati dei dispositivi IoT, vedere Panoramica del supporto MQTT in Griglia di eventi di Azure.

Concetti principali

CloudEvents

Griglia di eventi è conforme alla specifica Open Standard CloudEvents 1.0 di XMLF usando l'associazione del protocollo HTTP con formato JSON. Ciò significa che le soluzioni pubblicano e utilizzano messaggi di evento usando un formato simile all'esempio seguente:

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

Che cos'è un evento?

Un evento è la quantità minima di informazioni che descrivono completamente qualcosa che si è verificato in un sistema. Spesso si fa riferimento a un evento come illustrato in precedenza come evento discreto perché rappresenta un fatto distinto e autonomo su un sistema che fornisce informazioni utili. Gli esempi includono: com.yourcompany.Orders.OrderCreated, org.yourorg.GeneralLedger.AccountChanged, io.solutionname.Auth.MaximumNumberOfUserLoginAttemptsReached.

Nota

I termini eventi discreti, cloudevent o eventi vengono usati in modo intercambiabile per fare riferimento a tali messaggi che informano di una modifica dello stato di un sistema.

Per altre informazioni sugli eventi, vedere Terminologia di Griglia di eventi.

Un altro tipo di evento

La community degli utenti fa riferimento anche a eventi di questo tipo di messaggi che contengono un punto dati, ad esempio una sola lettura da un dispositivo o un singolo clic su una pagina dell'applicazione Web. Questo tipo di evento viene in genere analizzato in un intervallo di tempo o le dimensioni del flusso di eventi per derivare informazioni dettagliate ed eseguire un'azione. Nella documentazione di Griglia di eventi si fa riferimento a questo tipo di evento come punto dati, dati di streaming o telemetria. Si tratta di un tipo di dati che il supporto MQTT di Griglia di eventi e Hub eventi di Azure gestire in genere.

Argomenti e sottoscrizioni di eventi

Gli eventi pubblicati in Griglia di eventi vengono pubblicati in un argomento, ovvero una risorsa che contiene logicamente tutti gli eventi. Una sottoscrizione di eventi è una risorsa di configurazione associata a un singolo argomento. Tra le altre cose, si usa una sottoscrizione di eventi per impostare i criteri di selezione degli eventi per definire la raccolta di eventi disponibile per un sottoscrittore del set totale di eventi presenti in un argomento.

Diagram showing a topic and associated event subscriptions.

Recapito push

Il recapito push è supportato per le risorse seguenti. Fare clic sui collegamenti per altre informazioni su ognuno di essi.

  • Argomenti di sistema. Usare gli argomenti di sistema per ricevere eventi (di sistema) dai servizi di Azure.
  • Argomenti personalizzati. Usare argomenti personalizzati quando si desidera pubblicare gli eventi dell'applicazione.
  • Domini. I domini rappresentano un gruppo di argomenti di dominio in genere associati a una singola applicazione che richiede l'invio di eventi a diversi gruppi di utenti, organizzazioni o applicazioni. Un approccio comune consiste nell'associare un argomento di dominio a un gruppo di applicazioni di destinazione o utenti di un'organizzazione all'interno dello stesso tenant. Un'organizzazione può essere un team, una divisione in azienda, un'azienda e così via.
  • Argomenti dei partner. Usare gli argomenti dei partner quando si desidera utilizzare eventi di partner di terze parti.

Configurare una sottoscrizione di eventi in un argomento di sistema, personalizzato o partner per specificare criteri di filtro per gli eventi e impostare una destinazione su uno dei gestori eventi supportati.

Il diagramma seguente illustra le risorse che supportano il recapito push con alcuni gestori eventi supportati.

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

Nota

Per altre informazioni sul recapito push sugli spazi dei nomi di Griglia di eventi, vedere [namespace-push-delivery-overview.md].

Passaggi successivi

Gli articoli seguenti forniscono informazioni su come usare Griglia di eventi o fornire informazioni aggiuntive sui concetti.