Azure App Configuration en tant que source Event Grid

  • Article

Cet article fournit les propriétés et le schéma des événements Azure App Configuration. Pour une présentation des schémas d’événements, consultez Schéma d’événements Azure Event Grid. Cet article fournit également une liste de guides de démarrage rapide et de tutoriels permettant d’utiliser Azure App Configuration en tant que source d’événement.

Types d’événement disponibles

Event Grid utilise les abonnements aux événements pour acheminer les messages d’événements vers les abonnés. Azure App Configuration propose les types d’événements suivants :

Type d'événement Description
Microsoft.AppConfiguration.KeyValueModified Émis lorsqu’une valeur de clé est créée ou remplacée.
Microsoft.AppConfiguration.KeyValueDeleted Émis lorsqu’une valeur de clé est supprimée.
Microsoft.AppConfiguration.SnapshotCreated Déclenché lorsqu’une capture instantanée est créée.
Microsoft.AppConfiguration.SnapshotModified Déclenché lorsqu’une capture instantanée est modifiée.

Schéma d’événement

Un événement contient les données générales suivantes :

Propriété Type Description
source string Chemin d’accès complet à la source de l’événement. Ce champ n’est pas modifiable. Event Grid fournit cette valeur.
subject string Chemin de l’objet de l’événement, défini par le serveur de publication.
type string Un des types d’événements inscrits pour cette source d’événement.
time string L’heure à quelle l’événement est généré selon l’heure UTC du fournisseur.
id string Identificateur unique de l’événement.
data object Données de l’événement App Configuration.
specversion string Version de la spécification de schéma CloudEvents.

L’objet de données comporte les propriétés suivantes :

Événement clé-valeur

Propriété Type Description
key string La clé de la paire clé-valeur qui a été modifiée ou supprimée.
label string Le cas échéant, l’étiquette de la paire clé-valeur qui a été modifiée ou supprimée.
etag string Pour le paramètre KeyValueModified, l’etag de la nouvelle paire clé-valeur. Pour le paramètre KeyValueDeleted, l’etag de la paire clé-valeur qui a été supprimée.
syncToken string Le jeton de synchronisation représentant l’état du serveur après l’événement clé-valeur.

Événement de capture instantanée

Propriété Type Description
name string Le nom de la capture instantanée qui a été créée ou modifiée.
etag string Pour SnapshotCreated l’etag de la nouvelle capture instantanée. Pour SnapshotModified l’etag de la capture instantanée qui a été modifiée.
syncToken string Le jeton de synchronisation représentant l’état du serveur après l’événement de capture instantanée.

Exemple d’événement

L’exemple suivant montre le schéma d’un événement de valeur de clé modifié :

[{
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/kv/Foo?label=FizzBuzz",
  "data": {
    "key": "Foo",
    "label": "FizzBuzz",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0"
  },
  "type": "Microsoft.AppConfiguration.KeyValueModified",
  "time": "2019-05-31T20:05:03Z",
  "specversion": "1.0"
}]

L’exemple suivant montre le schéma d’un événement clé-valeur supprimé :

[{
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/kv/Foo?label=FizzBuzz",
  "data": {
    "key": "Foo",
    "label": "FizzBuzz",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0"
  },
  "type": "Microsoft.AppConfiguration.KeyValueDeleted",
  "time": "2019-05-31T20:05:03Z",
  "specversion": "1.0"
}]

L’exemple suivant montre le schéma d’un événement de capture instantanée créé :

[{
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/kvsnapshots/Foo",
  "type": "Microsoft.AppConfiguration.SnapshotCreated",
  "time": "2023-09-02T20:05:03.0000000Z",
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "data": {
    "name": "Foo",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0",
    "syncToken": "zAJw6V16=Njo1IzUxNjQ2NzM=;sn=5164673"
  },
  "specversion": "1.0"
}]

L’exemple suivant montre le schéma d’un événement de capture instantanée modifié :

[{
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/snapshots/Foo",
  "type": "Microsoft.AppConfiguration.SnapshotModified",
  "time": "2023-09-03T20:05:03.0000000Z",
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "data": {
    "name": "Foo",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0",
    "syncToken": "zAJw6V16=Njo1IzUxNjQ2NzM=;sn=5164673"
  },
  "specversion": "1.0"
}]

Tutoriels et articles de procédures

Intitulé Description
Réagir aux événements Azure App Configuration à l’aide d’Event Grid Vue d’ensemble de l’intégration d’Azure App Configuration avec Event Grid.
Utiliser Event Grid pour les notifications de changement de données Découvrez comment utiliser des abonnements aux événements Azure App Configuration pour envoyer des événements de modification de clé-valeur à un point de terminaison web.

Étapes suivantes