Egyéni kézbesítési tulajdonságok

Az esemény-előfizetések lehetővé teszik a kézbesített eseményekben szereplő HTTP-fejlécek beállítását. Ez a funkció lehetővé teszi a célhoz szükséges egyéni fejlécek beállítását. Esemény-előfizetés létrehozásakor legfeljebb 10 fejlécet állíthat be. Az egyes fejlécértékek nem lehetnek nagyobbak 4096 (4K) bájtnál.

Az egyéni fejléceket a következő célhelyekre kézbesített eseményeken állíthatja be:

• Webhooks
• Azure Service Bus-témakörök és üzenetsorok
• Azure Event Hubs
• Azure Functions
• Hibrid Azure Relay-Csatlakozás ions

Amikor esemény-előfizetést hoz létre az Azure Portalon, a Kézbesítés tulajdonságai lapon egyéni HTTP-fejléceket állíthat be. Ezen a lapon rögzített és dinamikus fejlécértékeket állíthat be.

Statikus fejlécértékek beállítása

Ha rögzített értékű fejléceket szeretne beállítani, adja meg a fejléc nevét és értékét a megfelelő mezőkben:

Érdemes lehet ellenőrizni , hogy titkos-e? amikor bizalmas adatokat ad meg. A bizalmas adatok láthatósága az Azure Portalon a felhasználó RBAC-engedélyétől függ.

Dinamikus fejlécértékek beállítása

A fejléc értékét egy bejövő esemény tulajdonsága alapján állíthatja be. A JsonPath szintaxissal hivatkozhat egy bejövő esemény tulajdonságértékére, amelyet a kimenő kérések fejlécének értékeként kell használni. Csak a sztring, a szám és a logikai JSON-értékek támogatottak. Ha például egy Csatorna nevű fejléc értékét szeretné beállítani az eseményadatokban a bejövő eseménytulajdonság-rendszer értékével, konfigurálja az esemény-előfizetést a következő módon:

Use Azure CLI

Használja a paramétert --delivery-attribute-mapping előfizetés létrehozásakor a az eventgrid event-subscription create parancs használatával. Here's an example:

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éldák

Ez a szakasz néhány példát mutat be a kézbesítési tulajdonságok használatára.

Az Engedélyezési fejléc beállítása tulajdonosi jogkivonattal (nem normatív példa)

Állítson be egy értéket egy engedélyezési fejlécre a kérés webhookkezelővel való azonosításához. Az engedélyezési fejléc akkor állítható be, ha nem a Microsoft Entra-azonosítóval védi a webhookot.

Fejléc neve	Fejléc típusa	Fejléc értéke
Authorization	Statikus	BEARER SlAV32hkKG...

A kimenő kérelmeknek mostantól tartalmazniuk kell az esemény-előfizetésben beállított fejlécet:

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

Authorization: BEARER SlAV32hkKG...

Megjegyzés:

Az engedélyezési fejlécek definiálása ésszerű lehetőség, ha a cél webhook. Nem használható erőforrás-azonosítóval, Service Bus-, Event Hubs- és hibrid Csatlakozás ionokkal előfizetett függvényekhez, mivel ezek a célhelyek támogatják a saját hitelesítési sémáikat az Event Grid használatakor.

Példa a Service Busra

Az Azure Service Bus az alábbi üzenettulajdonságok használatát támogatja egyetlen üzenet küldésekor.

Fejléc neve	Fejléc típusa
MessageId	Dinamikus
PartitionKey	Statikus vagy dinamikus.
SessionId	Statikus vagy dinamikus.
CorrelationId	Statikus vagy dinamikus.
Label	Statikus vagy dinamikus.
ReplyTo	Statikus vagy dinamikus.
ReplyToSessionId	Statikus vagy dinamikus.
To	Statikus vagy dinamikus.
ViaPartitionKey	Statikus vagy dinamikus.

Megjegyzés:

• Az alapértelmezett érték MessageId az Event Grid-esemény belső azonosítója. Felülbírálhatja. For example, data.field.
• A beállításokat csak vagy a következőre állíthatja be SessionIdMessageId:

Egyéni tulajdonságokat is megadhat, amikor üzeneteket küld a Service Bus üzenetsoraiba vagy témaköreibe. Ne használja az aeg- előtagot az üzenetfejlécek rendszertulajdonságai által használt módon. Az üzenetfejléc tulajdonságainak listáját a Service Bus eseménykezelőként tekintheti meg

Példa az Event Hubsra

Ha eseményeket kell közzétennie egy eseményközpont egy adott partícióján, állítsa be az PartitionKey esemény-előfizetés tulajdonságát a cél eseményközpont partícióját azonosító partíciókulcs megadásához.

Fejléc neve	Fejléc típusa
PartitionKey	Statikus vagy dinamikus.

Egyéni tulajdonságokat is megadhat, amikor üzeneteket küld egy eseményközpontba. Ne használja a aeg- tulajdonságnév előtagját, mivel azt a rendszertulajdonságok használják az üzenetfejlécekben. Az üzenetfejléc tulajdonságainak listáját az Event Hubs eseménykezelőként tekintheti meg

Az Azure Storage-üzenetsorok felé kimenő eseményeken való élettartam konfigurálása

Az Azure Storage-üzenetsorok célhelyéhez csak akkor konfigurálhatja a kimenő üzenet élettartamát, ha az egy Azure Storage-üzenetsorba lett kézbesítve. Ha nincs megadva idő, az üzenet alapértelmezett élettartama 7 nap. Beállíthatja azt is, hogy az esemény soha ne járjon le.

Következő lépések

Az eseménykézbesítésről az alábbi cikkben talál további információt:

• Kézbesítés és újrapróbálkozás
• Webhook eseménykézbesítés
• Eseményszűrés