共用方式為

Azure 應用程式組態作為事件方格來源

  • 發行項

本文提供 Azure 應用程式組態事件的屬性和結構描述。 如需事件結構描述的簡介，請參閱 Azure Event Grid 事件結構描述。 其也會提供快速入門和教學課程的清單，以使用 Azure 應用程式組態作為事件來源。

可用的事件類型

事件方格會使用事件訂閱路由傳送事件訊息至訂閱者。 Azure 應用程式組態會發出下列事件類型：

事件類型 描述
Microsoft.AppConfiguration.KeyValueModified 建立或取代機碼值時引發。
Microsoft.AppConfiguration.KeyValueDeleted 刪除機碼值時引發。
Microsoft.AppConfiguration.SnapshotCreated 建立快照集時引發。
Microsoft.AppConfiguration.SnapshotModified 修改快照集時引發。

結構描述

事件具有下列的最高層級資料：

屬性 類型​ 描述
topic string 事件來源的完整資源路徑。 此欄位無法寫入。 事件方格提供此值。
subject string 發行者定義事件主旨的路徑。
eventType string 此事件來源已註冊的事件類型之一。
eventTime string 事件產生的時間，以提供者的 UTC 時間為準。
id string 事件的唯一識別碼。
data object 應用程式組態事件資料。
dataVersion string 資料物件的結構描述版本。 發行者會定義結構描述版本。
metadataVersion string 事件中繼資料的結構描述版本。 「事件方格」會定義最上層屬性的結構描述。 事件方格提供此值。

資料物件具有下列屬性：

機碼值事件

屬性 類型​ 描述
key string 已修改或刪除的機碼值索引鍵。
label string 已修改或刪除的機碼值標籤，如果有的話。
etag string 針對新機碼值的 KeyValueModified 實體標記。 針對已刪除的機碼值 KeyValueDeleted 實體標記。
syncToken string 表示機碼值事件之後伺服器狀態的同步權杖。

快照集事件

屬性 類型​ 描述
name string 已建立或經修改之快照集的名稱。
etag string 針對 SnapshotCreated，新快照集的實體標記。 針對 SnapshotModified，已修改之快照集的實體標記。
syncToken string 表示快照集事件之後伺服器狀態的同步權杖。

事件範例

下列範例顯示機碼值修改事件的結構描述：

[{
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "topic": "/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"
  },
  "eventType": "Microsoft.AppConfiguration.KeyValueModified",
  "eventTime": "2019-05-31T20:05:03Z",
  "dataVersion": "1",
  "metadataVersion": "1"
}]

下列範例顯示機碼值刪除事件的結構描述：

[{
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "topic": "/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"
  },
  "eventType": "Microsoft.AppConfiguration.KeyValueDeleted",
  "eventTime": "2019-05-31T20:05:03Z",
  "dataVersion": "1",
  "metadataVersion": "1"
}]

下列範例顯示快照集建立事件的結構描述：

[{
  "id": "84e17ea4-66db-4b54-8050-df8f7763f87b",
  "topic": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/microsoft.appconfiguration/configurationstores/contoso",
  "subject": "https://contoso.azconfig.io/snapshots/Foo",
  "data": {
    "Name": "Foo",
    "etag": "FnUExLaj2moIi4tJX9AXn9sakm0",
    "syncToken": "zAJw6V16=Njo1IzUxNjQ2NzM=;sn=5164673"
  },
  "eventType": "Microsoft.AppConfiguration.SnapshotCreated",
  "eventTime": "2023-09-02T20:05:03Z",
  "dataVersion": "1",
  "metadataVersion": "1"
}]

下列範例顯示快照集修改事件的結構描述：

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

教學課程和操作說明

標題 描述
使用事件方格來回應 Azure 應用程式組態事件 整合 Azure 應用程式組態與事件方格的概觀。
使用事件方格進行資料變更通知 了解如何設定 Azure 應用程式組態事件訂用帳戶，以將索引鍵/值修改事件傳送至 Web 端點。

下一步