Поделиться через

Конфигурация приложений Azure в качестве источника Сетки событий

  • Статья

В этой статье описаны свойства и схема для событий Конфигурации приложений Azure. Общие сведения о схемах событий см. в статье Схема событий службы "Сетка событий Azure". Здесь также приводится список кратких руководств и учебников по использованию Конфигурации приложений Azure в качестве источника событий.

Доступные типы событий

Сетка событий использует подписки на события для маршрутизации сообщений о событиях подписчикам. Конфигурация приложений Azure выдает события перечисленных ниже типов.

Тип события Description
Microsoft.AppConfiguration.KeyValueModified Инициируется при создании или замене пары "ключ-значение".
Microsoft.AppConfiguration.KeyValueDeleted Инициируется при удалении пары "ключ-значение".
Microsoft.AppConfiguration.SnapshotCreated Вызывается при создании моментального снимка.
Microsoft.AppConfiguration.SnapshotModified Вызывается при изменении моментального снимка.

Схема событий

Событие содержит следующие высокоуровневые данные:

Свойство Type Описание:
source строка Полный путь к ресурсу источника событий. Это поле защищено от записи. Это значение предоставляет Сетка событий.
subject строка Определенный издателем путь к субъекту события.
type строка Один из зарегистрированных типов событий для этого источника событий.
time строка Время создания события с учетом времени поставщика в формате UTC.
id строка Уникальный идентификатор события.
data объект Данные события Конфигурации приложений.
specversion строка Версия спецификации схемы CloudEvents.

Объект данных имеет следующие свойства:

Событие key-value

Свойство Type Описание:
key строка Ключ пары «ключ-значение», которая была изменена или удалена.
label строка Ярлык измененной или удаленной пары "ключ-значение" (при наличии такового).
etag строка Для KeyValueModified — etag новой пары "ключ-значение". Для KeyValueDeleted etag удаленной пары «ключ-значение».
syncToken строка Маркер синхронизации, представляющий состояние сервера после события key-value.

Моментальный снимок

Свойство Type Описание:
name строка Имя созданного или измененного моментального снимка.
etag строка Для SnapshotCreated etag нового моментального снимка. Для SnapshotModified etag моментального снимка, который был изменен.
syncToken строка Маркер синхронизации, представляющий состояние сервера после события моментального снимка.

Пример события

В следующем примере показана схема события изменения пары "ключ-значение".

[{
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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"
}]

В следующем примере показана схема удаленного события key-value:

[{
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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"
}]

В следующем примере показана схема созданного события создания моментального снимка:

[{
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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"
}]

В следующем примере показана схема измененного события моментального снимка:

[{
  "source": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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"
}]

Практические руководства и другие учебные материалы

Заголовок Description
Реагирование на события Конфигурации приложений с помощью Сетки событий Общие сведения об интеграции Конфигурации приложений Azure с Сеткой событий.
Использование сетки событий для уведомлений об изменении данных Узнайте, как настроить подписки на события Конфигурации приложений Azure для отправки событий изменения пары "ключ-значение" на конечную веб-точку.

Следующие шаги