Teilen über

Azure App Configuration als Event Grid-Quelle

  • Artikel

In diesem Artikel werden die Eigenschaften und das Schema für Azure App Configuration-Ereignisse beschrieben. Eine Einführung in Ereignisschemas finden Sie unter Azure Event Grid-Ereignisschema. Außerdem erhalten Sie eine Liste mit Schnellstarts und Tutorials, die Azure App Configuration als Ereignisquelle verwenden.

Verfügbare Ereignistypen

Event Grid verwendet Ereignisabonnements zum Weiterleiten von Ereignisnachrichten an Abonnenten. Azure App Configuration gibt die folgenden Ereignistypen aus:

Ereignistyp BESCHREIBUNG
Microsoft.AppConfiguration.KeyValueModified Wird ausgelöst, wenn ein Schlüssel-Wert-Paar erstellt oder ersetzt wird.
Microsoft.AppConfiguration.KeyValueDeleted Wird ausgelöst, wenn ein Schlüssel-Wert-Paar gelöscht wird.
Microsoft.AppConfiguration.SnapshotCreated Wird ausgelöst, wenn eine Momentaufnahme erstellt wird.
Microsoft.AppConfiguration.SnapshotModified Wird ausgelöst, wenn eine Momentaufnahme geändert wird.

Ereignisschema

Ein Ereignis weist die folgenden Daten auf oberster Ebene aus:

Eigenschaft Typ Beschreibung
source Zeichenfolge Vollständiger Ressourcenpfaf zur Ereignisquelle. Dieses Feld ist nicht beschreibbar. Dieser Wert wird von Event Grid bereitgestellt.
subject Zeichenfolge Vom Herausgeber definierter Pfad zum Ereignisbetreff
type Zeichenfolge Einer der registrierten Ereignistypen für die Ereignisquelle.
time Zeichenfolge Die Zeit, in der das Ereignis generiert wird, basierend auf der UTC-Zeit des Anbieters.
id Zeichenfolge Eindeutiger Bezeichner für das Ereignis.
data Objekt (object) App Configuration-Ereignisdaten.
specversion Zeichenfolge Version der CloudEvents-Schemaspezifikation.

Das Datenobjekt weist die folgenden Eigenschaften auf:

Schlüssel-Wert-Ereignis

Eigenschaft Typ Beschreibung
key Zeichenfolge Der Schlüssel des Schlüssel-Wert-Paars, das geändert oder gelöscht wurde.
label Zeichenfolge Die Bezeichnung (sofern vorhanden) des Schlüssel-Wert-Paars, das geändert oder gelöscht wurde.
etag Zeichenfolge Für KeyValueModified: Das ETag des neuen Schlüssel-Wert-Paars. Für KeyValueDeleted: Das ETag des gelöschten Schlüssel-Wert-Paars.
syncToken Zeichenfolge Das Synchronisierungstoken, das den Serverstatus nach dem Schlüsselwertereignis darstellt.

Momentaufnahmenereignis

Eigenschaft Typ Beschreibung
name string Der Name der Momentaufnahme, die erstellt oder geändert wurde.
etag Zeichenfolge Für SnapshotCreated das Etag der neuen Momentaufnahme. Für SnapshotModified das Etag der Momentaufnahme, die geändert wurde.
syncToken Zeichenfolge Das Synchronisierungstoken, das den Serverstatus nach dem Momentaufnahme-Ereignis darstellt.

Beispielereignis

Das folgende Beispiel zeigt das Schema eines Ereignisses aufgrund eines geänderten Schlüssel-Wert-Paars:

[{
  "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"
}]

Das folgende Beispiel zeigt das Schema eines Ereignisses aufgrund eines gelöschten Schlüssel-Wert-Paars:

[{
  "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"
}]

Das folgende Beispiel zeigt das Schema eines erstellten Momentaufnahme-Ereignis:

[{
  "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"
}]

Das folgende Beispiel zeigt das Schema eines geänderten Momentaufnahme-Ereignis:

[{
  "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"
}]

Tutorials und Anleitungen

Titel BESCHREIBUNG
Reacting to Azure App Configuration events (Reagieren auf Azure App Configuration-Ereignisse) Übersicht über die Integration von Azure App Configuration in Event Grid.
Verwenden von Event Grid für Datenänderungsbenachrichtigungen Erfahren Sie, wie Sie Azure App Configuration-Ereignisabonnements verwenden, um Schlüssel-Wert-Änderungsereignisse an einen Webendpunkt zu senden.

Nächste Schritte