Dela via


Azure App Configuration som en Event Grid-källa

Den här artikeln innehåller egenskaper och schema för Azure App Configuration-händelser. En introduktion till händelsescheman finns i Händelseschema för Azure Event Grid. Det ger dig också en lista över snabbstarter och självstudier för att använda Azure App Configuration som händelsekälla.

Tillgängliga händelsetyper

Event Grid använder händelseprenumerationer för att dirigera händelsemeddelanden till prenumeranter. Azure App Configuration genererar följande händelsetyper:

Händelsetyp beskrivning
Microsoft.AppConfiguration.KeyValueModified Utlöses när ett nyckelvärde skapas eller ersätts.
Microsoft.AppConfiguration.KeyValueDeleted Utlöses när ett nyckelvärde tas bort.
Microsoft.AppConfiguration.SnapshotCreated Utlöses när en ögonblicksbild skapas.
Microsoft.AppConfiguration.SnapshotModified Utlöses när en ögonblicksbild ändras.

Händelseschema

En händelse har följande data på den översta nivån:

Property Type Description
source sträng Fullständig resurssökväg till händelsekällan. Det här fältet kan inte skrivas. Event Grid ger det här värdet.
subject sträng Utgivardefinierad sökväg till händelseobjektet.
type sträng En av de registrerade händelsetyperna för den här händelsekällan.
time sträng Den tid då händelsen genereras baserat på leverantörens UTC-tid.
id sträng Unik identifierare för händelsen.
data objekt Händelsedata för App Configuration.
specversion sträng CloudEvents schemaspecifikationsversion.

Dataobjektet har följande egenskaper:

Nyckelvärdeshändelse

Property Type Description
key sträng Nyckeln för nyckelvärdet som ändrades eller togs bort.
label sträng Etiketten, om någon, för nyckelvärdet som ändrades eller togs bort.
etag sträng För KeyValueModified etag för det nya nyckelvärdet. För KeyValueDeleted etag för nyckelvärdet som togs bort.
syncToken sträng Synkroniseringstoken som representerar servertillståndet efter nyckel/värde-händelsen.

Händelse för ögonblicksbild

Property Type Description
name sträng Namnet på ögonblicksbilden som skapades eller ändrades.
etag sträng För SnapshotCreated etag för den nya ögonblicksbilden. För SnapshotModified etag för ögonblicksbilden som ändrades.
syncToken sträng Synkroniseringstoken som representerar servertillståndet efter händelsen med ögonblicksbilden.

Exempelhändelse

I följande exempel visas schemat för en ändrad nyckel/värde-händelse:

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

I följande exempel visas schemat för en nyckel/värde-borttagen händelse:

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

I följande exempel visas schemat för en händelse som skapats av en ögonblicksbild:

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

I följande exempel visas schemat för en händelse som ändrats av en ögonblicksbild:

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

Självstudier och instruktioner

Title Description
Reagera på Azure App Configuration-händelser med hjälp av Event Grid Översikt över integrering av Azure App Configuration med Event Grid.
Använda Event Grid för meddelanden om dataändring Lär dig hur du använder händelseprenumerationer i Azure App Configuration för att skicka ändringshändelser för nyckelvärden till en webbslutpunkt.

Nästa steg