事件网格订阅架构

若要创建一个事件网格订阅,将请求发送到创建事件订阅操作。 使用以下格式:

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"
    }
  }
}

后续步骤