Vlastní vlastnosti doručení

Článek
10/26/2023

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í:

Vlastnosti doručení – statické

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:

Vlastnosti doručení – dynamické

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.

Vlastnosti doručení – fronta úložiště

Další kroky

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

Sdílet prostřednictvím