Vlastní vlastnosti doručení

  • Článek

Odběry událostí umožňují nastavit hlavičky HTTP, které jsou součástí doručených událostí. Tato funkce umožňuje nastavit vlastní hlavičky, které jsou požadovány cílem. Při vytváření odběru událostí můžete nastavit až 10 hlaviček. Každá hodnota záhlaví by neměla být větší než 4 096 bajtů (4K).

U událostí, které se doručují do následujících cílů, můžete nastavit vlastní hlavičky:

  • Webhooky
  • Témata a fronty služby Azure Service Bus
  • Azure Event Hubs
  • Azure Functions
  • Hybridní Připojení azure Relay

Při vytváření odběru událostí na webu Azure Portal můžete pomocí karty Vlastnosti doručení nastavit vlastní hlavičky HTTP. Tato stránka umožňuje nastavit pevné a dynamické hodnoty záhlaví.

Nastavení statických hodnot záhlaví

Pokud chcete nastavit záhlaví s pevnou hodnotou, zadejte název záhlaví a jeho hodnotu do odpovídajících polí:

Delivery properties - static

Možná budete chtít zkontrolovat , jestli je tajný kód? Když poskytujete citlivá data. Viditelnost citlivých dat na webu Azure Portal závisí na oprávnění RBAC uživatele.

Nastavení dynamických hodnot záhlaví

Hodnotu záhlaví můžete nastavit na základě vlastnosti příchozí události. Pomocí syntaxe JsonPath můžete odkazovat na hodnotu vlastnosti příchozí události, která se má použít jako hodnota hlavičky v odchozích požadavcích. Podporují se pouze hodnoty JSON řetězce, čísla a logické hodnoty. Pokud chcete například nastavit hodnotu hlavičky s názvem Kanál pomocí hodnoty systému příchozích událostí v datech události, nakonfigurujte odběr událostí následujícím způsobem:

Delivery properties - dynamic

Použití Azure CLI

--delivery-attribute-mapping Parametr použijte při vytváření předplatného az eventgrid event-subscription create pomocí příkazu. Tady je příklad:

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

Příklady

V této části najdete několik příkladů použití vlastností doručení.

Nastavení autorizační hlavičky s nosným tokenem (nestandardní příklad)

Nastavte hodnotu na autorizační hlavičku pro identifikaci požadavku pomocí obslužné rutiny Webhooku. Autorizační hlavičku můžete nastavit, pokud webhook nechráníte pomocí ID Microsoft Entra.

Název hlavičky Typ záhlaví Hodnota hlavičky
Authorization staticky. BEARER SlAV32hkKG...

Odchozí požadavky by teď měly obsahovat hlavičku nastavenou pro odběr události:

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

Authorization: BEARER SlAV32hkKG...

Poznámka:

Definování autorizačních hlaviček je rozumná možnost, pokud je vaším cílem webhook. Neměly by se používat pro funkce, které mají předplacené ID prostředku, Service Bus, Event Hubs a hybridní Připojení, protože tyto cíle podporují vlastní schémata ověřování při použití se službou Event Grid.

Příklad služby Service Bus

Azure Service Bus podporuje použití následujících vlastností zpráv při odesílání jednotlivých zpráv.

Název hlavičky Typ záhlaví
MessageId dynamicky,
PartitionKey Statické nebo dynamické
SessionId Statické nebo dynamické
CorrelationId Statické nebo dynamické
Label Statické nebo dynamické
ReplyTo Statické nebo dynamické
ReplyToSessionId Statické nebo dynamické
To Statické nebo dynamické
ViaPartitionKey Statické nebo dynamické

Poznámka:

  • Výchozí hodnota MessageId je interní ID události Event Gridu. Můžete ho přepsat. Například, data.field.
  • Můžete nastavit pouze jednu SessionId nebo MessageId.

Při odesílání zpráv do front nebo témat služby Service Bus můžete také zadat vlastní vlastnosti. Nepoužívejte předponu aeg- , protože ji používají systémové vlastnosti v záhlavích zpráv. Seznam vlastností záhlaví zprávy najdete v tématu Service Bus jako obslužná rutina události.

Příklad služby Event Hubs

Pokud potřebujete publikovat události do konkrétního oddílu v centru událostí, nastavte PartitionKey vlastnost odběru událostí tak, aby určila klíč oddílu, který identifikuje cílový oddíl centra událostí.

Název hlavičky Typ záhlaví
PartitionKey Statické nebo dynamické

Při odesílání zpráv do centra událostí můžete také zadat vlastní vlastnosti. Nepoužívejte předponu aeg- pro název vlastnosti, protože ji používají systémové vlastnosti v záhlavích zpráv. Seznam vlastností záhlaví zprávy najdete v tématu Event Hubs jako obslužná rutina události.

Konfigurace doby živého přenosu odchozích událostí do front azure Storage

V případě cíle front azure Storage můžete nakonfigurovat pouze dobu, kdy se odchozí zpráva doručí do fronty Azure Storage. Pokud není zadán žádný čas, výchozí doba živé zprávy je 7 dní. Událost můžete také nastavit tak, aby nikdy nevypršla.

Delivery properties - storage queue

Další kroky

Další informace o doručení událostí najdete v následujícím článku: