Usługa Azure Event Hubs jako miejsce docelowe programu obsługi w subskrypcjach w tematach przestrzeni nazw usługi Azure Event Grid

Procedura obsługi zdarzeń to miejsce, w którym jest wysyłane zdarzenie. Procedura obsługi wykonuje akcję w celu przetworzenia zdarzenia. Oto lista obsługiwanych programów obsługi zdarzeń dla tematów przestrzeni nazw:

• Azure Event Hubs
• Elementy webhook

Użyj usługi Event Hubs , gdy rozwiązanie pobiera zdarzenia z usługi Event Grid szybciej niż może przetwarzać zdarzenia. Gdy zdarzenia znajdują się w centrum zdarzeń, aplikacja może przetwarzać zdarzenia z centrum zdarzeń zgodnie z własnym harmonogramem. Przetwarzanie zdarzeń można skalować w celu obsługi zdarzeń przychodzących.

Nagłówki komunikatów

Poniżej przedstawiono właściwości odbierane w nagłówku zdarzenia lub komunikatu wysyłanego do usługi Event Hubs:

Nazwa właściwości	Opis
aeg-subscription-name	Nazwa subskrypcji zdarzeń.
aeg-delivery-count	Liczba prób wykonanych dla zdarzenia.
aeg-output-event-id	Identyfikator zdarzenia wygenerowanego przez system.
aeg-compatibility-mode-enabled	Ta właściwość jest dostępna i ustawiana tylko podczas dostarczania za pośrednictwem przestrzeni nazw usługi Event Grid. Obecnie jedyną możliwą wartością jest fałsz. Ma to na celu ułatwienie procedur obsługi zdarzeń rozróżniania zdarzeń dostarczanych za pośrednictwem przestrzeni nazw usługi Event Grid, a niestandardowych tematów usługi Event Grid/tematów systemowych/przestrzeni nazw partnerów itp.
aeg-metadata-version	Wersja metadanych zdarzenia. Reprezentuje wersję specyfikacji schematu zdarzeń w chmurze.

Przykłady rest

Subskrypcja zdarzeń z usługą Event Hubs jako program obsługi zdarzeń przy użyciu tożsamości przypisanej przez system

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

Subskrypcja zdarzeń z usługą Event Hubs jako procedura obsługi zdarzeń przy użyciu tożsamości przypisanej przez użytkownika

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

Subskrypcja zdarzeń z miejscem docelowym deadletter skonfigurowanym w programie obsługi zdarzeń usługi 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}"
            }
          }
        }
      }
    }
  }
}

Subskrypcja zdarzeń z właściwościami dostarczania skonfigurowanymi w programie obsługi zdarzeń usługi 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"
                  }
                }
              ]
            }
          }
        }
      }
    }
  }
}

Właściwości dostarczania specyficzne dla usługi Event Hubs

Subskrypcje zdarzeń umożliwiają konfigurowanie nagłówków HTTP uwzględnionych w dostarczanych zdarzeniach. Ta funkcja umożliwia ustawienie niestandardowych nagłówków, których wymaga miejsce docelowe. Możesz ustawić nagłówki niestandardowe dla zdarzeń dostarczanych do usługi Azure Event Hubs.

Jeśli chcesz opublikować zdarzenia w określonej partycji w centrum zdarzeń, ustaw PartitionKey właściwość w subskrypcji zdarzeń, aby określić klucz partycji identyfikujący docelową partycję centrum zdarzeń.

Nazwa nagłówka	Typ nagłówka
PartitionKey	Tryb statyczny lub dynamiczny

Aby uzyskać więcej informacji, zobacz Niestandardowe właściwości dostarczania w przestrzeniach nazw.

Azure Portal

Podczas tworzenia subskrypcji zdarzeń z trybem dostarczania zdarzeń ustawionym na wartość Wypychanie możesz wybrać usługę Event Hubs jako typ procedury obsługi zdarzeń i skonfigurować centrum zdarzeń jako procedurę obsługi.

Aby uzyskać instrukcje krok po kroku, zobacz Use Event Hubs a destination for namespace topics (Używanie usługi Event Hubs jako miejsca docelowego dla tematów przestrzeni nazw).

Interfejs wiersza polecenia platformy Azure

Aby uzyskać instrukcje krok po kroku, zobacz Konfigurowanie usługi Event Hubs jako miejsca docelowego.

Następne kroki

• Dostarczanie wypychane przestrzeni nazw usługi Event Grid.