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:
- Webhookok
- Azure Service Bus-témakörök és üzenetsorok
- Azure-eseményközpontok
- Azure Functions
- Hibrid Azure Relay-kapcsolatok
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:
Az Azure parancssori felület használatával
Használja a paramétert --delivery-attribute-mapping
előfizetés létrehozásakor a az eventgrid event-subscription create
parancs használatával. Példa:
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...
Feljegyzé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 kapcsolatokkal 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. |
Feljegyzés
- Az alapértelmezett érték
MessageId
az Event Grid-esemény belső azonosítója. Felülbírálhatja. Például:data.field
. - A beállításokat csak vagy a következőre állíthatja be
SessionId
MessageId
:
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: