Condividi tramite


Hub eventi di Azure come destinazione del gestore nelle sottoscrizioni agli argomenti dello spazio dei nomi di Grigli di eventi di Azure

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

Usare Event Hubs quando la soluzione riceve eventi da Event Grid più rapidamente di quanto possa elaborarli. Quando gli eventi si trovano in un hub eventi, l'applicazione può elaborare gli eventi dall'hub eventi in base alla propria pianificazione. È possibile ridimensionare l'elaborazione degli eventi per gestire gli eventi in ingresso.

Intestazioni del messaggio

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

Nome della 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 namespace di Event Grid. Attualmente l'unico valore possibile è false. È progettato per aiutare i gestori eventi a distinguere tra gli eventi recapitati tramite namespace di Event Grid e topic personalizzati di Event Grid/topic di sistema/namespace partner ecc.
aeg-metadata-version Versione della metadata relativa all'evento. Rappresenta la versione specifica per lo schema di eventi cloud.

Esempi REST

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

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

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

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

Sottoscrizione di eventi con destinazione dead-letter configurata in un gestore di eventi in Event Hubs

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

Sottoscrizione di eventi con proprietà di recapito configurate su un gestore di eventi di Event Hubs

{
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Push",
      "push": {
        "deliveryWithResourceIdentity": {
          "identity": {
            "type": "SystemAssigned"
          },
          "destination": {
            "endpointType": "EventHub",
            "properties": {
              "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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 consegna specifiche di Event Hubs

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

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

Nome dell'intestazione Tipo di intestazione
PartitionKey Statico o dinamico

Per ulteriori informazioni, vedere Proprietà di recapito personalizzate nei namespace.

Portale di Azure

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.

Screenshot che mostra la pagina Crea sottoscrizione con Push selezionato come Modalità di recapito.

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

Azure CLI

Per istruzioni dettagliate, vedere Configurare Hub eventi di destinazione.

Passaggi successivi