Niestandardowe właściwości dostarczania

Subskrypcje zdarzeń umożliwiają konfigurowanie nagłówków HTTP uwzględnionych w dostarczanych zdarzeniach. Ta funkcja umożliwia ustawianie niestandardowych nagłówków wymaganych przez miejsce docelowe. Podczas tworzenia subskrypcji zdarzeń można skonfigurować maksymalnie 10 nagłówków. Każda wartość nagłówka nie powinna być większa niż 4096 (4K) bajtów.

Możesz ustawić nagłówki niestandardowe dla zdarzeń dostarczanych do następujących miejsc docelowych:

• Webhooks
• Tematy i kolejki usługi Azure Service Bus
• Azure Event Hubs
• Azure Functions
• Połączenia hybrydowe usługi Azure Relay

When creating an event subscription in the Azure portal, you can use the Delivery Properties tab to set custom HTTP headers. Ta strona umożliwia ustawianie stałych i dynamicznych wartości nagłówka.

Ustawianie statycznych wartości nagłówka

Aby ustawić nagłówki o stałej wartości, podaj nazwę nagłówka i jego wartość w odpowiednich polach:

You might want to check Is secret? when you're providing sensitive data. Widoczność poufnych danych w witrynie Azure Portal zależy od uprawnień RBAC użytkownika.

Ustawianie dynamicznych wartości nagłówka

Wartość nagłówka można ustawić na podstawie właściwości w zdarzeniu przychodzącym. Składnia JsonPath służy do odwoływania się do wartości właściwości zdarzenia przychodzącego, która ma być używana jako wartość nagłówka w żądaniach wychodzących. Obsługiwane są tylko wartości JSON ciągu, liczby i wartości logicznej. For example, to set the value of a header named Channel using the value of the incoming event property system in the event data, configure your event subscription in the following way:

Interfejs wiersza polecenia platformy Azure

Użyj parametru --delivery-attribute-mapping podczas tworzenia subskrypcji przy użyciu az eventgrid event-subscription create polecenia . Oto przykład:

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true
    --delivery-attribute-mapping staticproperty1 static somestaticvalue2 true 
    --delivery-attribute-mapping staticproperty2 static somestaticvalue3 false 
    --delivery-attribute-mapping dynamicproperty1 dynamic data.key1

Examples

Ta sekcja zawiera kilka przykładów użycia właściwości dostarczania.

Ustawianie nagłówka autoryzacji przy użyciu tokenu elementu nośnego (przykład nie normacyjny)

Ustaw wartość na nagłówek autoryzacji, aby zidentyfikować żądanie za pomocą programu obsługi elementu webhook. Nagłówek autoryzacji można ustawić, jeśli element webhook nie jest chroniony za pomocą identyfikatora Entra firmy Microsoft.

Żądania wychodzące powinny teraz zawierać nagłówek ustawiony w subskrypcji zdarzeń:

POST /home.html HTTP/1.1
Host: acme.com

Authorization: BEARER SlAV32hkKG...

Przykład usługi Service Bus

Usługa Azure Service Bus obsługuje używanie następujących właściwości komunikatów podczas wysyłania pojedynczych komunikatów.

Można również określić właściwości niestandardowe podczas wysyłania komunikatów do kolejek lub tematów usługi Service Bus. Nie używaj prefiksu aeg- , ponieważ jest używany przez właściwości systemowe w nagłówkach komunikatów. Aby uzyskać listę właściwości nagłówka komunikatów, zobacz Service Bus jako program obsługi zdarzeń

Przykład usługi 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ń.

Można również określić właściwości niestandardowe podczas wysyłania komunikatów do centrum zdarzeń. Nie używaj prefiksu aeg- dla nazwy właściwości, ponieważ jest on używany przez właściwości systemowe w nagłówkach komunikatów. Aby uzyskać listę właściwości nagłówka wiadomości, zobacz Event Hubs jako program obsługi zdarzeń

Konfigurowanie czasu wygaśnięcia zdarzeń wychodzących do kolejek usługi Azure Storage

W przypadku miejsca docelowego kolejek usługi Azure Storage można skonfigurować tylko czas wygaśnięcia komunikatu wychodzącego, gdy zostanie on dostarczony do kolejki usługi Azure Storage. Jeśli nie zostanie podany czas, domyślny czas wygaśnięcia wiadomości wynosi 7 dni. Możesz również ustawić zdarzenie tak, aby nigdy nie wygasało.

Next steps

Aby uzyskać więcej informacji na temat dostarczania zdarzeń, zobacz następujący artykuł:

• Dostarczanie i ponawianie prób
• Endpoint validation
• Event filtering