本文提供Azure 应用程序配置事件的属性和架构。 有关事件架构的简介,请参阅Azure 事件网格事件架构。 它还提供了一系列快速入门和教程,用于将Azure 应用程序配置用作事件源。
可用事件类型
事件网格使用事件订阅将事件消息路由到订阅方。 Azure 应用程序配置发出以下事件类型:
| 事件类型 | 说明 |
|---|---|
| Microsoft。AppConfiguration.KeyValueModified | 创建或替换键值时引发。 |
| Microsoft。AppConfiguration.KeyValueDeleted | 删除键值时引发。 |
| Microsoft。AppConfiguration.SnapshotCreated | 创建快照时引发。 |
| Microsoft。AppConfiguration.SnapshotModified | 修改快照时引发。 |
事件架构
事件具有以下顶层数据:
| 财产 | 类型 | 说明 |
|---|---|---|
source |
字符串 | 事件源的完整资源路径。 此字段不可写入。 事件网格提供此值。 |
subject |
字符串 | Publisher定义的事件主题路径。 |
type |
字符串 | 该事件源的其中一种注册事件类型。 |
time |
字符串 | 事件生成的时间是基于提供者的 UTC 时间。 |
id |
字符串 | 事件的唯一标识符。 |
data |
对象 | 应用配置事件数据。 |
specversion |
字符串 | CloudEvents 架构规范版本。 |
数据对象具有以下属性:
键值事件
| 财产 | 类型 | 说明 |
|---|---|---|
key |
字符串 | 已修改或删除的键值键。 |
label |
字符串 | 已修改或删除的键值的标签(如果有)。 |
etag |
字符串 | 对于 KeyValueModified 新键值的 etag。 对于 KeyValueDeleted 已删除的键值 etag。 |
syncToken |
字符串 | 表示键值事件后服务器状态的同步令牌。 |
快照事件
| 财产 | 类型 | 说明 |
|---|---|---|
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"
}]
以下示例显示了键值删除事件的架构:
[{
"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"
}]
教程与操作方法
| 标题 | 说明 |
|---|---|
| 使用事件网格使用事件网格Azure 应用程序配置事件 | 将Azure 应用程序配置与事件网格集成概述。 |
| 对数据更改通知使用事件网格 | 了解如何使用Azure 应用程序配置事件订阅将键值修改事件发送到 Web 终结点。 |
后续步骤
- 有关Azure 事件网格简介,请参阅 什么是事件网格?
- 有关创建Azure 事件网格订阅的详细信息,请参阅 Event Grid 订阅架构。
- 有关使用Azure 应用程序配置事件的简介,请参阅使用事件网格获取数据更改通知。