Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Filtrer les événements pour un abonné

Un filtre sélectionne les événements que reçoit un abonné. Attachez a FilterConfiguration à l'abonné à l'aide d'un ou de plusieurs filtres, chacun désignant a Scope et a Pattern dans la syntaxe du modèle d' EventBridge événement. Par exemple, un DATA filtre avec le modèle ne {"detail":{"amount":[{"numeric":[">",500]}]}} livre que les commandes de plus de 500 publiées avecPutEvents. Cette page décrit le modèle de filtre ; pour les opérateurs de modèle, voirModèles d' EventBridge événements Amazon. Les filtres d'abonnés ne prennent pas en charge la mise en correspondance des caractères génériques.

Comment fonctionne le filtrage

Chaque filtre comporte deux parties : aScope, qui est la partie de l'événement que le filtre examine (DATAMETADATA, ou SYSTEM_METADATA ; voirStructure de l'événement : données, métadonnées et métadonnées du système), et aPattern, un modèle d'événement fourni sous forme de chaîne JSON. EventBridge combine les filtres dans une configuration avec ET : un événement doit correspondre à chaque filtre avant que l'abonné ne le reçoive. Un abonné qui n'a pas FilterConfiguration reçu tous les événements.

Les trois scopes

Exemple : filtrez un événement publié avec PutRawEvents

PutRawEventspublie une charge utile avec un type de contenu. Un DATA filtre correspond directement à la charge utile et un METADATA filtre correspond à la carte de métadonnées de l'éditeur. La configuration suivante comporte un filtre par étendue ; l'abonné reçoit un événement uniquement lorsque les trois correspondent : la charge utile amount est supérieure à 500, la clé de métadonnées region est EU et le type de contenu est JSON.

{
    "Filters": [
        { "Scope": "DATA", "Pattern": "{\"amount\":[{\"numeric\":[\">\",500]}]}" },
        { "Scope": "METADATA", "Pattern": "{\"region\":[\"EU\"]}" },
        { "Scope": "SYSTEM_METADATA", "Pattern": "{\"ContentType\":[\"application/json\"]}" }
    ]
}

Exemple : filtrez un événement publié avec PutEvents

PutEventspublie un événement dans l' EventBridge enveloppe, construite à partir des élémentsSource,, DetailType ResourcesTime, et de l'entréeDetail. Un DATA filtre correspond à cette enveloppe, le vôtre étant Detail imbriqué en dessousdetail. L'événement ContentType estapplication/eventbridge+json, aws:Source et aws:DetailType vient du et de l'entréeDetailType, Source et l'enveloppe expose également source et detail-type dans la DATA portée. La configuration suivante correspond lorsque le amount détail est supérieur à 500 et que la source estcom.myapp.storage.

{
    "Filters": [
        { "Scope": "DATA", "Pattern": "{\"detail\":{\"amount\":[{\"numeric\":[\">\",500]}]}}" },
        { "Scope": "SYSTEM_METADATA", "Pattern": "{\"aws:Source\":[\"com.myapp.storage\"]}" }
    ]
}

Exemple : filtrer les événements à partir d'une source d'événements

Les événements ingérés par une source d'événements arrivent dans l' EventBridge enveloppe, avec le service ou le partenaire d'origine. aws:Source Pour ne recevoir que les événements créés par des objets Amazon S3 pour un compartiment, faites correspondre le service SYSTEM_METADATA et le compartiment. DATA Pour un partenaire, faites correspondre le nom de la source de l'événement partenaire, par exemple avec un « prefix activé aws.partner/example.com ».

{
    "Filters": [
        { "Scope": "SYSTEM_METADATA", "Pattern": "{\"aws:Source\":[\"aws.s3\"]}" },
        { "Scope": "DATA", "Pattern": "{\"detail-type\":[\"Object Created\"],\"detail\":{\"bucket\":{\"name\":[\"amzn-s3-demo-bucket\"]}}}" }
    ]
}

Comportement et limites

Un motif écrit pour la mauvaise forme n'échoue pas ; il ne correspond à rien. Avant de compter sur un abonné, publiez un événement qui devrait correspondre et un autre qui ne devrait pas correspondre, et vérifiez les deux au niveau de la cible.