Condividi tramite

spazio dei nomi Griglia di eventi di Azure (anteprima) come origine di Griglia di eventi

  • Articolo

Questo articolo fornisce le proprietà e lo schema per gli eventi dello spazio dei nomi Griglia di eventi di Azure. Per un'introduzione agli schemi di eventi, vedere Schema di eventi di Griglia di eventi di Azure.

Tipi di evento disponibili

Griglia di eventi di Azure spazio dei nomi (anteprima) genera i tipi di evento seguenti:

Tipo di evento Descrizione
Microsoft.EventGrid.MQTTClientSessionConnected Pubblicato quando la sessione di un client MQTT è connessa a Griglia di eventi.
Microsoft.EventGrid.MQTTClientSessionDisconnected Pubblicato quando la sessione di un client MQTT viene disconnessa da Griglia di eventi.
Microsoft.EventGrid.MQTTClientCreatedOrUpdated Pubblicato quando un client MQTT viene creato o aggiornato nello spazio dei nomi di Griglia di eventi.
Microsoft.EventGrid.MQTTClientDeleted Pubblicato quando un client MQTT viene eliminato dallo spazio dei nomi di Griglia di eventi.

Evento di esempio

Questo evento di esempio mostra lo schema di un evento generato quando la sessione di un client MQTT è connessa a Griglia di eventi:

[{
  "id": "5249c38a-a048-46dd-8f60-df34fcdab06c",
  "eventTime": "2023-07-29T01:23:49.6454046Z",
  "eventType": "Microsoft.EventGrid.MQTTClientSessionConnected",
  "topic": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1/sessions/session1",
  "dataVersion": "1",
  "metadataVersion": "1",
  "data": {
    "namespaceName": "myns",
    "clientAuthenticationName": "client1",
    "clientSessionName": "session1",
    "sequenceNumber": 1
  }
}]

Questo evento di esempio mostra lo schema di un evento generato quando la sessione di un client MQTT viene disconnessa a Griglia di eventi:

[{
  "id": "e30e5174-787d-4e19-8812-580148bfcf7b",
  "eventTime": "2023-07-29T01:27:40.2446871Z",
  "eventType": "Microsoft.EventGrid.MQTTClientSessionDisconnected",
  "topic": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1/sessions/session1",
  "dataVersion": "1",
  "metadataVersion": "1",
  "data": {
    "namespaceName": "myns",
    "clientAuthenticationName": "client1",
    "clientSessionName": "session1",
    "sequenceNumber": 1,
    "disconnectionReason": "ClientInitiatedDisconnect"
  }
}]

Questo evento di esempio mostra lo schema di un evento generato quando viene creato o aggiornato un client MQTT nello spazio dei nomi di Griglia di eventi:

[{
  "id": "383d1562-c95f-4095-936c-688e72c6b2bb",
  "eventTime": "2023-07-29T01:14:35.8928724Z",
  "eventType": "Microsoft.EventGrid.MQTTClientCreatedOrUpdated",
  "topic": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1",
  "dataVersion": "1",
  "metadataVersion": "1",
  "data": {
    "createdOn": "2023-07-29T01:14:34.2048108Z",
    "updatedOn": "2023-07-29T01:14:34.2048108Z",
    "namespaceName": "myns",
    "clientName": "client1",
    "clientAuthenticationName": "client1",
    "state": "Enabled",
    "attributes": {
      "attribute1": "value1"
    }
  }
}]

Questo evento di esempio mostra lo schema di un evento generato quando un client MQTT viene eliminato dallo spazio dei nomi di Griglia di eventi:

[{
  "id": "2a93aaf9-66c2-4f8e-9ba3-8d899c10bf17",
  "eventTime": "2023-07-29T01:30:52.5620566Z",
  "eventType": "Microsoft.EventGrid.MQTTClientDeleted",
  "topic": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1",
  "dataVersion": "1",
  "metadataVersion": "1",
  "data": {
    "clientName": "client1",
    "clientAuthenticationName": "client1",
    "namespaceName": "myns"
  }
}]

Proprietà degli eventi

Tutti gli eventi contengono gli stessi dati di livello principale:

Proprietà Type Descrizione
id string Identificatore univoco dell'evento.
topic string Percorso risorsa completo dell'origine evento. Questo campo non è scrivibile. Questo valore viene fornito da Griglia di eventi.
subject string Percorso dell'oggetto dell'evento definito dall'origine di pubblicazione.
eventType string Uno dei tipi di evento registrati per l'origine evento.
eventTime string Ora di generazione dell'evento in base all'ora UTC del provider.
data object Dati degli eventi dello spazio dei nomi di Griglia di eventi.
dataVersion string Versione dello schema dell'oggetto dati. La versione dello schema è definita dall'origine di pubblicazione.
metadataVersion string Versione dello schema dei metadati dell'evento. Lo schema delle proprietà di primo livello è definito da Griglia di eventi. Questo valore viene specificato da Griglia di eventi.

L'oggetto dati contiene le proprietà seguenti:

Proprietà Type Descrizione
namespaceName string Nome dello spazio dei nomi di Griglia di eventi in cui il client MQTT è stato connesso o disconnesso.
clientAuthenticationName string Identificatore univoco per il client MQTT presentato dal client al servizio per l'autenticazione. Questa stringa con distinzione tra maiuscole e minuscole può contenere fino a 128 caratteri e supporta caratteri UTF-8.
clientSessionName string Identificatore univoco per la sessione del client MQTT. Questa stringa con distinzione tra maiuscole e minuscole può contenere fino a 128 caratteri e supporta caratteri UTF-8.
sequenceNumber long Numero che consente di indicare l'ordine di eventi connessi o disconnessi della sessione client MQTT. All'evento più recente è associato un numero di sequenza maggiore di quello dell'evento precedente.
disconnectionReason string Motivo della disconnessione della sessione del client MQTT. Il valore può essere uno dei valori nella tabella motivi di disconnessione.
createdOn string Ora di creazione della risorsa client in base all'ora UTC del provider.
updatedOn string Ora dell'ultimo aggiornamento della risorsa client in base all'ora UTC del provider. Se la risorsa client non è mai stata aggiornata, questo valore è identico al valore della proprietà 'createdOn'
clientName string Ora dell'ultimo aggiornamento della risorsa client in base all'ora UTC del provider. Se la risorsa client non è mai stata aggiornata, questo valore è identico al valore della proprietà 'createOn'.
state string Stato configurato del client. Il valore può essere Abilitato o Disabilitato.
attributes string Matrice di attributi di coppia chiave-valore assegnati alla risorsa client.

Motivi di disconnessione:

Nell'elenco seguente vengono illustrati i diversi valori per la disconnessioneReason e la relativa descrizione:

Motivo di disconnessione Descrizione
ClientAuthenticationError il client è stato disconnesso per qualsiasi motivo di autenticazione (ad esempio, certificato scaduto, client disabilitato o configurazione client modificato)
ClientAuthorizationError il client è stato disconnesso per qualsiasi motivo di autorizzazione( ad esempio, a causa di una modifica nella configurazione di spazi di argomenti, associazioni di autorizzazioni o gruppi client)
ClientError il client ha inviato una richiesta non valida o usato una delle funzionalità non supportate che hanno generato una terminazione della connessione dal servizio.
ClientInitiatedDisconnect il client avvia una disconnessione normale tramite un pacchetto DISCONNECT per MQTT o un frame di chiusura per MQTT su WebSocket.
ConnectionLost la connessione client-server viene persa.
IpForbidden l'indirizzo IP del client viene bloccato da filtro IP o dalla configurazione dei collegamenti privati.
QuotaExceeded il client ha superato uno o più dei limiti di limitazione che hanno causato una terminazione della connessione dal servizio.
ServerError la connessione è stata terminata a causa di un errore imprevisto del server
ServerInitiatedDisconnect il server avvia una disconnessione normale per qualsiasi motivo operativo
SessionOverflow la coda del client per i messaggi QoS1 non riconosciuti ha raggiunto il limite, che ha generato una terminazione della connessione dal server
SessionTakenOver il client si riconnette con lo stesso nome di autenticazione, che ha generato la terminazione della connessione precedente.

Passaggi successivi

  • Per altre informazioni sugli argomenti relativi al sistema griglia di eventi, vedere Argomenti di sistema
  • Per informazioni sugli eventi generati dallo spazio dei nomi Griglia di eventi e su come usarli, vedere Eventi ciclo di vita del client MQTT.