Dela via


Event Grid på Kubernetes – händelsefiltrering för prenumerationer

Med Event Grid i Kubernetes kan du ange filter för alla egenskaper i json-nyttolasten. Dessa filter modelleras som en uppsättning AND-villkor, där varje yttre villkor har valfria inre ELLER-villkor. För varje AND-villkor anger du följande värden:

  • OperatorType – typen av jämförelse.
  • Nyckel – json-sökvägen till egenskapen där filtret ska tillämpas.
  • Värde – referensvärdet som filtret körs mot (eller) Värden – den uppsättning referensvärden som filtret körs mot.

Viktigt

Event Grid på Kubernetes med Azure Arc är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan serviceavtal och rekommenderas inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

Filtrera efter händelsetyp

Som standard skickas alla händelsetyper (type attribut) för händelsekällan till slutpunkten. Du kan välja att endast skicka vissa händelsetyper till slutpunkten. JSON-syntaxen för filtrering efter händelsetyp är:

"filter": {
  "includedEventTypes": [
    "orderCreated",
    "orderUpdated"
  ]
}

I exemplet ovan skickas de enda händelserna av typen orderCreated och orderUpdated händelserna till prenumerantslutpunkten.

Här är en exempelhändelse:

[{
      "specVersion": "1.0",
      "type" : "orderCreated",
      "source": "myCompanyName/us/webCommerceChannel/myOnlineCommerceSiteBrandName",
      "id" : "eventId-n",
      "time" : "2020-12-25T20:54:07+00:00",
      "subject" : "account/acct-123224/order/o-123456",
      "dataSchema" : "1.0",
      "data" : {
         "orderId" : "123",
         "orderType" : "PO",
         "reference" : "https://www.myCompanyName.com/orders/123"
      }
}]

Filtrera efter ämne

För enkel filtrering efter ämne anger du ett start- eller slutvärde för ämnet. JSON-syntaxen för filtrering efter ämne är:

"filter": {
  "subjectBeginsWith": "/account/acct-123224/"
}

Filtret som konfigurerades ovan skickar till exempel alla beställningar som är associerade med kontot acct-123224 till prenumerantslutpunkten.

När du publicerar händelser i ämnen skapar du ämnen för dina händelser på ett sätt som gör det enkelt för prenumeranter att veta om de är intresserade av händelsen. Prenumeranter använder ämnesegenskapen för att filtrera och dirigera händelser. Överväg att lägga till sökvägen där händelsen inträffade, så att prenumeranter kan filtrera efter segment i den sökvägen. Sökvägen gör det möjligt för prenumeranter att filtrera händelser smalt eller brett. Om du anger en sökväg för tre segment, till exempel /A/B/C i ämnet, kan prenumeranter filtrera efter det första segmentet /A för att få en bred uppsättning händelser. Dessa prenumeranter får händelser med ämnen som /A/B/C eller /A/D/E. Andra prenumeranter kan filtrera efter /A/B för att få en smalare uppsättning händelser.

Filtrera efter värden i händelsedata

Mer information om avancerad filtrering finns i avsnittet Avancerad filtrering i artikeln Event Grid på Azure . Följande funktioner och operatorer stöds inte av Event Grid i Kubernetes.

  • Filtrera på matrisdata i nycklar för inkommande händelser
  • Tillåt filtrering på CloudEvents-tilläggskontextattribut.
  • Följande operatorer
    • StringNotContains
    • StringNotBeginsWith
    • StringNotEndsWith
    • NumberInRange
    • NumberNotInRange
    • IsNullOrUndefined
    • IsNotNull

Nästa steg

Mer information om mål och hanterare som stöds av Event Grid i Azure Arc för Kubernetes finns i Event Grid på Kubernetes – Händelsehanterare.