Schéma d’abonnement à Event Grid

Article
06/01/2023

Pour créer un abonnement Event Grid, envoyez une requête à l’opération Créer un abonnement aux événements. Utilisez le format suivant :

PUT /subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/{resource-provider}/{resource-type}/{resource-name}/Microsoft.EventGrid/eventSubscriptions/{event-type-definitions}?api-version=2018-01-01

Par exemple, pour créer un abonnement aux événements pour un compte de stockage nommé examplestorage dans un groupe de ressources nommé examplegroup, utilisez le format suivant :

PUT /subscriptions/{subscription-id}/resourceGroups/examplegroup/providers/Microsoft.Storage/storageaccounts/examplestorage/Microsoft.EventGrid/eventSubscriptions/{event-type-definitions}?api-version=2018-01-01

Le nom de l’abonnement aux événements doit contenir entre 3 et 64 caractères et ne peut contenir que les caractères a-z, A-Z, 0-9 et "-". L’article décrit les propriétés et le schéma pour le corps de la requête.

Propriétés de l’abonnement aux événements

Propriété	Type	Description
destination	object	Objet qui définit le point de terminaison.
filter	object	Champ facultatif pour filtrer les types d’événements.

objet de destination

Propriété	Type	Description
endpointType	string	Type de point de terminaison pour l’abonnement (webhook/HTTP, concentrateur d’événements ou file d’attente).
endpointUrl	string	URL de destination des événements dans cet abonnement aux événements.

objet de filtre

Propriété	Type	Description
includedEventTypes	tableau	Affiche une correspondance lorsque le type d’événement du message d’événement correspond exactement à l’un de ces noms de type d’événement. Génère une erreur lorsque le nom de l’événement ne correspond pas aux noms de type d’événement inscrits pour la source d’événements. Génère une correspondance pour tous les types d’événements.
subjectBeginsWith	string	Filtre de correspondance de préfixe appliqué au champ objet du message de l’événement. La chaîne vide ou par défaut représente une correspondance générale.
subjectEndsWith	string	Filtre de correspondance de suffixe appliqué au champ objet du message de l’événement. La chaîne vide ou par défaut représente une correspondance générale.
isSubjectCaseSensitive	string	Contrôle la correspondance sensible à la casse pour les filtres.
enableAdvancedFilteringOnArrays	boolean	Permet d’utiliser des tableaux pour les clés dans le filtrage avancé. Pour plus d’informations, consultez Filtrage avancé.

Exemple de schéma d’abonnement

{
  "properties": {
    "destination": {
      "endpointType": "webhook",
      "properties": {
          "endpointUrl": "https://example.azurewebsites.net/api/HttpTriggerCSharp1?code=VXbGWce53l48Mt8wuotr0GPmyJ/nDT4hgdFj9DpBiRt38qqnnm5OFg=="
      }
    },
    "filter": {
      "includedEventTypes": [ "Microsoft.Storage.BlobCreated", "Microsoft.Storage.BlobDeleted" ],
      "subjectBeginsWith": "/blobServices/default/containers/mycontainer/blobs/log",
      "subjectEndsWith": ".jpg",
      "isSubjectCaseSensitive ": "true"
    }
  }
}

Étapes suivantes

Pour une présentation d’Event Grid, consultez l’article What is Event Grid? (Présentation d’Event Grid).

Partage via