Hub eventi di Azure come destinazione del gestore nelle sottoscrizioni per gli argomenti dello spazio dei nomi di Griglia di eventi di Azure

Articolo
05/22/2024

Un gestore eventi è il punto in cui viene inviato l'evento. Il gestore esegue un'azione per elaborare l'evento. Ecco l'elenco dei gestori degli eventi supportati per gli argomenti degli spazi dei nomi:

Usare Hub eventi quando la soluzione riceve gli eventi da Griglia di eventi più velocemente di quanto sia possibile elaborarli. Una volta che gli eventi si trovano in un hub eventi, l'applicazione può elaborare gli eventi dall'hub eventi in base a una propria pianificazione. È possibile ridimensionare l'elaborazione per gestire gli eventi in arrivo.

Intestazioni del messaggio

Ecco le proprietà ricevute nell'intestazione di un evento o di un messaggio inviato a Hub eventi:

Nome proprietà	Descrizione
`aeg-subscription-name`	Nome della sottoscrizione di eventi.
`aeg-delivery-count`	Numero di tentativi effettuati per l'evento.
`aeg-output-event-id`	ID evento generato dal sistema.
`aeg-compatibility-mode-enabled`	Questa proprietà è disponibile e impostata solo quando viene recapitata tramite gli spazi dei nomi di Griglia di eventi. Al momento, l'unico valore possibile è False. È progettata per consentire ai gestori eventi di distinguere tra gli eventi recapitati tramite gli spazi dei nomi di Griglia di eventi e gli argomenti/argomenti di sistema/spazi dei nomi partner personalizzati di Griglia di eventi
`aeg-metadata-version`	Versione dei metadati dell'evento. Rappresenta la versione specifica per lo schema di eventi cloud.

Esempi REST

Sottoscrizione di eventi con Hub eventi come gestore degli eventi con l'identità assegnata dal sistema

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "SystemAssigned"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        }
      }
    }
  }
}

Sottoscrizione di eventi con Hub eventi come gestore degli eventi con l'identità assegnata dall'utente

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        }
      }
    }
  }
}

Sottoscrizione di eventi con destinazione inserita nella coda di messaggi non recapitabili configurata in un gestore eventi di Hub eventi

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}"
            }
          }
        },
        "deadLetterDestinationWithResourceIdentity": {
          "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{user-identity-name}"
          },
          "deadLetterDestination": {
            "endpointType": "StorageBlob",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.Storage/storageAccounts/{storage-account-name}",
              "blobContainerName": "{blob-container-name}"
            }
          }
        }
      }
    }
  }
}

Sottoscrizione di eventi con proprietà di recapito configurate in un gestore eventi di Hub eventi

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "SystemAssigned"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/{resource-group}/providers/Microsoft.EventHub/namespaces/{namespace-name}/eventhubs/{eventhub-name}",
              "deliveryAttributeMappings": [
                {
                  "name": "somestaticname",
                  "type": "Static",
                  "properties": {
                    "value": "somestaticvalue"
                  }
                },
                {
                  "name": "somedynamicname",
                  "type": "Dynamic",
                  "properties": {
                    "sourceField": "subject"
                  }
                }
              ]
            }
          }
        }
      }
    }
  }
}

Proprietà di recapito specifiche di Hub eventi

Le sottoscrizioni di eventi consentono di configurare le intestazioni HTTP incluse negli eventi recapitati. Questa funzionalità consente di impostare intestazioni personalizzate richieste dalla destinazione. È possibile impostare intestazioni personalizzate sugli eventi recapitati a Hub eventi di Azure.

Se occorre pubblicare eventi in una partizione specifica all'interno di un hub eventi, impostare la proprietà PartitionKey nella sottoscrizione di eventi per specificare la chiave di partizione che identifica la partizione di Hub eventi di destinazione.

Nome intestazione	Tipo di intestazione
`PartitionKey`	Statico o dinamico

Per altre informazioni, vedere Proprietà di recapito personalizzate negli spazi dei nomi.

Azure portal

Quando si crea una sottoscrizione di eventi con modalità di recapito eventi impostata su Push, è possibile selezionare Hub eventi come tipo di gestore eventi e configurare un hub eventi come gestore.

Per istruzioni dettagliate, vedere Usare Hub eventi come destinazione per gli argomenti dello spazio dei nomi.

Interfaccia della riga di comando di Azure

Per istruzioni dettagliate, vedere Configurare Hub eventi come destinazione.

Passaggi successivi

Recapito push dello spazio dei nomi di Griglia di eventi.

Condividi tramite