Azure-alkalmazás Konfiguráció Event Grid-forrásként

Ez a cikk Azure-alkalmazás konfigurációs események tulajdonságait és sémáját ismerteti. Az eseménysémákról az Azure Event Grid eseményséma című témakörben olvashat. Emellett felsorolja a Azure-alkalmazás-konfiguráció eseményforrásként való használatához használható rövid útmutatókat és oktatóanyagokat.

Elérhető eseménytípusok

Az Event Grid esemény-előfizetésekkel irányítja át az eseményüzeneteket az előfizetőknek. Azure-alkalmazás konfiguráció a következő eseménytípusokat bocsátja ki:

Eseménytípus Leírás
Microsoft.AppConfiguration.KeyValueModified Kulcs-érték létrehozásakor vagy cseréjekor történik.
Microsoft.AppConfiguration.KeyValueDeleted Kulcsérték törlésekor történik.
Microsoft.AppConfiguration.SnapshotCreated Pillanatkép létrehozásakor merül fel.
Microsoft.AppConfiguration.SnapshotModified Pillanatkép módosításakor emelik ki.

Eseményséma

Egy esemény a következő legfelső szintű adatokkal rendelkezik:

Tulajdonság Típus Leírás
source húr Az eseményforrás teljes erőforrás-elérési útja. Ez a mező nem írható. Az értéket az Event Grid adja meg.
subject húr Az esemény tárgyra mutató, a közzétevő által megadott elérési út.
type húr Az eseményforráshoz felvett eseménytípusok egyike.
time húr Az esemény létrehozásának időpontja a szolgáltató UTC-ideje alapján.
id húr Az esemény egyedi azonosítója.
data object Alkalmazáskonfigurációs eseményadatok.
specversion húr A CloudEvents sémaspecifikációs verziója.

Az adatobjektum a következő tulajdonságokkal rendelkezik:

Kulcs-érték esemény

Tulajdonság Típus Leírás
key húr A módosított vagy törölt kulcsérték kulcsa.
label húr A módosított vagy törölt kulcsérték címkéje, ha van ilyen.
etag húr Az KeyValueModified új kulcs-érték etagje. A KeyValueDeleted törölt kulcs-érték etagje esetében.
syncToken húr A kiszolgáló állapotát a kulcs-érték esemény után jelölő szinkronizálási jogkivonat.

Pillanatkép-esemény

Tulajdonság Típus Leírás
name húr A létrehozott vagy módosított pillanatkép neve.
etag húr Az SnapshotCreated új pillanatkép etagje számára. A módosított pillanatkép etagjének esetében SnapshotModified .
syncToken húr A pillanatkép-esemény után a kiszolgáló állapotát jelképező szinkronizálási jogkivonat.

Példaesemény

Az alábbi példa egy kulcs-érték módosított esemény sémáját mutatja be:

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

Az alábbi példa egy kulcs-érték törölt esemény sémáját mutatja be:

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

Az alábbi példa egy pillanatkép által létrehozott esemény sémáját mutatja be:

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

Az alábbi példa egy pillanatkép-módosított esemény sémáját mutatja be:

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

Oktatóanyagok és útmutatók

Cím Leírás
Reagálás Azure-alkalmazás konfigurációs eseményekre az Event Grid használatával A Azure-alkalmazás Konfiguráció és az Event Grid integrálásának áttekintése.
Az Event Grid használata adatváltozási értesítésekhez Megtudhatja, hogyan küldhet kulcs-érték módosítási eseményeket a webvégpontnak Azure-alkalmazás konfigurációs esemény-előfizetések használatával.

Következő lépések