事件格線訂用帳戶的結構描述

若要建立事件格線訂用帳戶，請將要求傳送至建立事件訂用帳戶作業。 請使用下列格式：

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 及 "-"。 本文描述要求主體的屬性和結構描述。  

事件訂用帳戶屬性

屬性	類型	Description
目的地	object	定義端點的物件。
filter	object	篩選事件類型的選擇性欄位。

目的地物件

屬性	類型	描述
endpointType	字串	訂用帳戶的端點類型 (webhook/HTTP、事件中樞或佇列)。
endpointUrl	字串	此事件訂用帳戶中事件的目的地 URL。

篩選物件

屬性	類型	描述
includedEventTypes	array	事件訊息中的事件類型完全符合這些事件類型名稱其中之一時，即會符合。 事件名稱不符合事件來源的已註冊事件類型名稱時，會引發錯誤。 預設會符合所有事件類型。
subjectBeginsWith	字串	事件訊息中對主體欄位的前置詞符合篩選。 預設值或空字串會符合全部。
subjectEndsWith	字串	事件訊息中對主體欄位的後置詞符合篩選。 預設值或空字串會符合全部。
isSubjectCaseSensitive	字串	控制篩選的區分大小寫比對。
enableAdvancedFilteringOnArrays	boolean	啟用在進階篩選中使用索引鍵的陣列。 如需詳細資訊，請參閱進階篩選。

範例訂用帳戶的結構描述

{
  "properties": {
    "destination": {
      "endpointType": "webhook",
      "properties": {
          "endpointUrl": "https://example.azurewebsites.net/api/HttpTriggerCSharp1?code=VXbGWce53l48Mt8wuotr0GPmyJ/nDT4hgdFj9DpBiRt38qqnnm5OFg=="
      }
    },
    "filter": {
      "includedEventTypes": [ "Microsoft.Storage.BlobCreated", "Microsoft.Storage.BlobDeleted" ],
      "subjectBeginsWith": "/blobServices/default/containers/mycontainer/blobs/log",
      "subjectEndsWith": ".jpg",
      "isSubjectCaseSensitive ": "true"
    }
  }
}

後續步驟

• 若要初步了解事件格線，請參閱什麼是事件格線？