Schéma d’abonnement à Event Grid

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).