事件网格订阅架构
若要创建一个事件网格订阅,将请求发送到创建事件订阅操作。 使用以下格式:
PUT /subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/{resource-provider}/{resource-type}/{resource-name}/Microsoft.EventGrid/eventSubscriptions/{event-type-definitions}?api-version=2018-01-01
例如,若要在名为 examplegroup
的资源组中创建名为 examplestorage
的存储帐户的事件订阅,请使用以下格式:
PUT /subscriptions/{subscription-id}/resourceGroups/examplegroup/providers/Microsoft.Storage/storageaccounts/examplestorage/Microsoft.EventGrid/eventSubscriptions/{event-type-definitions}?api-version=2018-01-01
事件订阅名称的长度必须为 3-64 个字符,并且只能包含 a-z、A-Z、0-9 和“-”。 本文介绍请求正文的属性和架构。
事件订阅属性
属性 | 类型 | 描述 |
---|---|---|
destination | object | 定义终结点的对象。 |
filter | object | 用于筛选事件类型的可选字段。 |
目标对象
属性 | 类型 | 说明 |
---|---|---|
endpointType | 字符串 | 订阅(webhook/HTTP、事件中心或队列)的终结点类型。 |
endpointUrl | 字符串 | 此事件订阅中的事件的目标 URL。 |
筛选器对象
属性 | 类型 | 说明 |
---|---|---|
includedEventTypes | array | 当事件消息中的事件类型与这些事件类型名称之一完全匹配时匹配。 当事件名称与事件源的已注册事件类型名称不匹配时,将引发错误。 默认匹配所有事件类型。 |
subjectBeginsWith | 字符串 | 事件消息中使用者字段的前缀匹配筛选器。 默认或空字符串匹配所有类型。 |
subjectEndsWith | 字符串 | 事件消息中使用者字段的后缀匹配筛选器。 默认或空字符串匹配所有类型。 |
isSubjectCaseSensitive | 字符串 | 用于筛选器的区分大小写匹配的控件。 |
enableAdvancedFilteringOnArrays | boolean | 支持在高级筛选中对键使用数组。 有关详细信息,请参阅“高级模式”。 |
订阅架构示例
{
"properties": {
"destination": {
"endpointType": "webhook",
"properties": {
"endpointUrl": "https://example.chinacloudsites.cn/api/HttpTriggerCSharp1?code=VXbGWce53l48Mt8wuotr0GPmyJ/nDT4hgdFj9DpBiRt38qqnnm5OFg=="
}
},
"filter": {
"includedEventTypes": [ "Microsoft.Storage.BlobCreated", "Microsoft.Storage.BlobDeleted" ],
"subjectBeginsWith": "/blobServices/default/containers/mycontainer/blobs/log",
"subjectEndsWith": ".jpg",
"isSubjectCaseSensitive ": "true"
}
}
}
后续步骤
- 有关事件网格的介绍,请参阅什么是事件网格?