Megosztás a következőn keresztül:

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

  • Cikk

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:

Kézbesítési tulajdonságok – statikus

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

Kézbesítési tulajdonságok – dinamikus

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ézbesítési tulajdonságok – tárolási üzenetsor

Következő lépések

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