Microsoft.EventGrid 命名空間/topics/eventSubscriptions 2023-06-01-preview

Bicep 資源定義

命名空間/topics/eventSubscriptions 資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.EventGrid/namespaces/topics/eventSubscriptions 資源,請將下列 Bicep 新增至您的範本。

resource symbolicname 'Microsoft.EventGrid/namespaces/topics/eventSubscriptions@2023-06-01-preview' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    deliveryConfiguration: {
      deliveryMode: 'Queue'
      queue: {
        deadLetterDestinationWithResourceIdentity: {
          deadLetterDestination: {
            endpointType: 'string'
            // For remaining properties, see DeadLetterDestination objects
          }
          identity: {
            type: 'string'
            userAssignedIdentity: 'string'
          }
        }
        eventTimeToLive: 'string'
        maxDeliveryCount: int
        receiveLockDurationInSeconds: int
      }
    }
    eventDeliverySchema: 'CloudEventSchemaV1_0'
    filtersConfiguration: {
      filters: [
        {
          key: 'string'
          operatorType: 'string'
          // For remaining properties, see Filter objects
        }
      ]
      includedEventTypes: [
        'string'
      ]
    }
  }
}

DeadLetterDestination 物件

設定 endpointType 屬性以指定物件的類型。

針對 StorageBlob,請使用:

  endpointType: 'StorageBlob'
  properties: {
    blobContainerName: 'string'
    resourceId: 'string'
  }

篩選物件

設定 operatorType 屬性以指定物件的類型。

針對 BoolEquals,請使用:

  operatorType: 'BoolEquals'
  value: bool

針對 IsNotNull,請使用:

  operatorType: 'IsNotNull'

針對 IsNullOrUndefined,請使用:

  operatorType: 'IsNullOrUndefined'

針對 NumberGreaterThan,請使用:

  operatorType: 'NumberGreaterThan'
  value: int

針對 NumberGreaterThanOrEquals,請使用:

  operatorType: 'NumberGreaterThanOrEquals'
  value: int

針對 NumberIn,請使用:

  operatorType: 'NumberIn'
  values: [
    int
  ]

針對 NumberInRange,請使用:

  operatorType: 'NumberInRange'
  values: [
    [
      int
    ]
  ]

針對 NumberLessThan,請使用:

  operatorType: 'NumberLessThan'
  value: int

針對 NumberLessThanOrEquals,請使用:

  operatorType: 'NumberLessThanOrEquals'
  value: int

針對 NumberNotIn,請使用:

  operatorType: 'NumberNotIn'
  values: [
    int
  ]

針對 NumberNotInRange,請使用:

  operatorType: 'NumberNotInRange'
  values: [
    [
      int
    ]
  ]

針對 StringBeginsWith,請使用:

  operatorType: 'StringBeginsWith'
  values: [
    'string'
  ]

針對 StringContains,請使用:

  operatorType: 'StringContains'
  values: [
    'string'
  ]

針對 StringEndsWith,請使用:

  operatorType: 'StringEndsWith'
  values: [
    'string'
  ]

針對 StringIn,請使用:

  operatorType: 'StringIn'
  values: [
    'string'
  ]

針對 StringNotBeginsWith,請使用:

  operatorType: 'StringNotBeginsWith'
  values: [
    'string'
  ]

針對 StringNotContains,請使用:

  operatorType: 'StringNotContains'
  values: [
    'string'
  ]

針對 StringNotEndsWith,請使用:

  operatorType: 'StringNotEndsWith'
  values: [
    'string'
  ]

針對 StringNotIn,請使用:

  operatorType: 'StringNotIn'
  values: [
    'string'
  ]

屬性值

namespaces/topics/eventSubscriptions

名稱 描述
NAME 資源名稱

瞭解如何在 Bicep 中設定子資源的名稱和類型。
需要字串 ()
父系 (parent) 在 Bicep 中,您可以指定子資源的父資源。 只有在父資源外部宣告子資源時,才需要新增此屬性。

如需詳細資訊,請參閱 父資源外部的子資源
類型資源的符號名稱: 主題
properties 事件訂閱的屬性。 SubscriptionProperties

SubscriptionProperties

名稱 描述
deliveryConfiguration 事件訂閱傳遞組態的相關信息。 DeliveryConfiguration
eventDeliverySchema 事件訂閱的事件傳遞架構。 'CloudEventSchemaV1_0'
filtersConfiguration 事件訂閱篩選的相關信息。 FiltersConfiguration

DeliveryConfiguration

名稱 描述
deliveryMode 事件訂閱的傳遞模式。 'Queue'
queue 當 deliveryMode 是佇列,並代表佇列訂閱的相關信息時,應該填入這個屬性。 QueueInfo

QueueInfo

名稱 描述
deadLetterDestinationWithResourceIdentity 事件訂閱的寄不出的信件目的地。 無法傳遞至目的地的任何事件都會傳送至寄不出的信件目的地。
使用父資源上的受控識別設定 (也就是主題) ,以取得傳遞/寄不出的信件期間所使用的驗證令牌。
DeadLetterWithResourceIdentity
eventTimeToLive ISO 8601 格式的時間範圍持續時間,決定從訊息發佈時間起,訂用帳戶可以使用多少時間的訊息。
此持續時間值會使用下列格式來表示:'P (n) Y (n) M (n) DT (n) H (n) M (n) S',其中:
- (n) 會取代為 (n) 之後每個 time 元素的值。
- P 是 (期間或期間) 指示項,而且一律放在持續時間的開頭。
- Y 是年份指示項,且會遵循年數的值。
- M 是月份指示項,且會遵循月份數的值。
- W 是周指示項,並遵循周數的值。
- D 是日期指示項,其會遵循天數的值。
- T 是時間指示項,且在時間元件之前。
- H 是小時指示項,並遵循小時數的值。
- M 是分鐘指示項,且會遵循分鐘數的值。
- S 是第二個指示項,其會遵循秒數的值。
此持續時間值無法設定大於主題的 EventRetentionInDays。 這是選擇性欄位,其最小值為 1 分鐘,且決定其最大值
依主題的 EventRetentionInDays 值。 以下是有效值的範例:
- 'P0DT23H12M' 或 'PT23H12M':持續時間為 23 小時和 12 分鐘。
- 'P1D' 或 'P1DT0H0M0S':持續時間為 1 天。
字串
maxDeliveryCount 事件的最大傳遞計數。 int
receiveLockDurationInSeconds 用戶端收到訊息 () 狀態並等候接受、釋放或拒絕的秒數上限,以秒為單位。
如果用戶端收到訊息之後經過此時間,且未轉換為已接受的 (未處理) 、釋出或拒絕,
訊息可供重新傳遞使用。 這是選擇性欄位,預設值為 60 秒,最小值為 60 秒,最大值為 300 秒。
int

DeadLetterWithResourceIdentity

名稱 描述
deadLetterDestination 事件訂閱必須傳遞事件之目的地的相關信息。
使用父資源上的受控識別設定 (名稱為主題或網域) ,以取得傳遞/寄不出的信件期間所使用的驗證令牌。
DeadLetterDestination
身分識別 當寄不出的信件事件時要使用的身分識別。 EventSubscriptionIdentity

DeadLetterDestination

名稱 描述
endpointType 設定物件類型 需要 StorageBlob ()

StorageBlobDeadLetterDestination

名稱 描述
endpointType 無效信件目的地的端點類型 'StorageBlob' (必要)
properties 記憶體 Blob 型寄不出的目的地屬性 StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

名稱 描述
blobContainerName 記憶體 Blob 容器的名稱,該容器是寄不出的事件目的地 字串
resourceId 記憶體帳戶的 Azure 資源識別符,該帳戶是死信事件目的地 字串

EventSubscriptionIdentity

名稱 描述
類型 使用的受控識別類型。 類型 'SystemAssigned, UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。 類型 『None』 將會移除任何身分識別。 'SystemAssigned'
'UserAssigned'
userAssignedIdentity 與資源相關聯的使用者身分識別。 字串

FiltersConfiguration

名稱 描述
filters 篩選事件訂閱所使用的篩選陣列。 Filter[]
includedEventTypes 需要屬於事件訂閱一部分的適用事件類型清單。 如果需要訂閱所有預設事件類型,請將 IncludedEventTypes 設定為 null。 string[]

篩選

名稱 描述
索引鍵 事件中的欄位/屬性,根據您要篩選的欄位/屬性。 字串
operatorType 設定物件類型 BoolEquals
IsNotNull
IsNullOrUndefined
NumberGreaterThan
NumberGreaterThanOrEquals
NumberIn
NumberInRange
NumberLessThan
NumberLessThanOrEquals
NumberNotIn
NumberNotInRange
StringBeginsWith
StringContains
StringEndsWith
StringIn
StringNotBeginsWith
StringNotContains
StringNotEndsWith
需要 StringNotIn ()

BoolEqualsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'BoolEquals' (必要)
布爾篩選值。 bool

IsNotNullFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'IsNotNull' (必要)

IsNullOrUndefinedFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'IsNullOrUndefined' (必要)

NumberGreaterThanFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 必要) 'NumberGreaterThan' (
篩選值。 int

NumberGreaterThanOrEqualsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'NumberGreaterThanOrEquals' (必要)
篩選值。 int

NumberInFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'NumberIn' (必要)
篩選值集。 int[]

NumberInRangeFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 需要 'NumberInRange' ()
篩選值集。 int[][]

NumberLessThanFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 必要 ('NumberLessThan')
篩選值。 int

NumberLessThanOrEqualsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 必要) 'NumberLessThanOrEquals' (
篩選值。 int

NumberNotInFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 需要 『NumberNotIn』 ()
篩選值集。 int[]

NumberNotInRangeFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 必要) ('NumberNotInRange'
篩選值集。 int[][]

StringBeginsWithFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'StringBeginsWith' (必要)
篩選值集。 string[]

StringContainsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'StringContains' (必要)
篩選值集。 string[]

StringEndsWithFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'StringEndsWith' (必要)
篩選值集。 string[]

StringInFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'StringIn' (必要)
篩選值集。 string[]

StringNotBeginsWithFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'StringNotBeginsWith' (必要)
篩選值集。 string[]

StringNotContainsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'StringNotContains' (必要)
篩選值集。 string[]

StringNotEndsWithFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'StringNotEndsWith' (必要)
篩選值集。 string[]

StringNotInFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'StringNotIn' (必要)
篩選值集。 string[]

ARM 範本資源定義

命名空間/topics/eventSubscriptions 資源類型可以使用目標作業來部署:

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄

資源格式

若要建立 Microsoft.EventGrid/namespaces/topics/eventSubscriptions 資源,請將下列 JSON 新增至您的範本。

{
  "type": "Microsoft.EventGrid/namespaces/topics/eventSubscriptions",
  "apiVersion": "2023-06-01-preview",
  "name": "string",
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "Queue",
      "queue": {
        "deadLetterDestinationWithResourceIdentity": {
          "deadLetterDestination": {
            "endpointType": "string"
            // For remaining properties, see DeadLetterDestination objects
          },
          "identity": {
            "type": "string",
            "userAssignedIdentity": "string"
          }
        },
        "eventTimeToLive": "string",
        "maxDeliveryCount": "int",
        "receiveLockDurationInSeconds": "int"
      }
    },
    "eventDeliverySchema": "CloudEventSchemaV1_0",
    "filtersConfiguration": {
      "filters": [
        {
          "key": "string",
          "operatorType": "string"
          // For remaining properties, see Filter objects
        }
      ],
      "includedEventTypes": [ "string" ]
    }
  }
}

DeadLetterDestination 物件

設定 endpointType 屬性以指定物件的類型。

針對 StorageBlob,請使用:

  "endpointType": "StorageBlob",
  "properties": {
    "blobContainerName": "string",
    "resourceId": "string"
  }

篩選物件

設定 operatorType 屬性以指定物件的類型。

針對 BoolEquals,請使用:

  "operatorType": "BoolEquals",
  "value": "bool"

針對 IsNotNull,請使用:

  "operatorType": "IsNotNull"

針對 IsNullOrUndefined,請使用:

  "operatorType": "IsNullOrUndefined"

針對 NumberGreaterThan,請使用:

  "operatorType": "NumberGreaterThan",
  "value": "int"

針對 NumberGreaterThanOrEquals,請使用:

  "operatorType": "NumberGreaterThanOrEquals",
  "value": "int"

針對 NumberIn,請使用:

  "operatorType": "NumberIn",
  "values": [ "int" ]

針對 NumberInRange,請使用:

  "operatorType": "NumberInRange",
  "values": [ [ "int" ] ]

針對 NumberLessThan,請使用:

  "operatorType": "NumberLessThan",
  "value": "int"

針對 NumberLessThanOrEquals,請使用:

  "operatorType": "NumberLessThanOrEquals",
  "value": "int"

針對 NumberNotIn,請使用:

  "operatorType": "NumberNotIn",
  "values": [ "int" ]

針對 NumberNotInRange,請使用:

  "operatorType": "NumberNotInRange",
  "values": [ [ "int" ] ]

針對 StringBeginsWith,請使用:

  "operatorType": "StringBeginsWith",
  "values": [ "string" ]

針對 StringContains,請使用:

  "operatorType": "StringContains",
  "values": [ "string" ]

針對 StringEndsWith,請使用:

  "operatorType": "StringEndsWith",
  "values": [ "string" ]

針對 StringIn,請使用:

  "operatorType": "StringIn",
  "values": [ "string" ]

針對 StringNotBeginsWith,請使用:

  "operatorType": "StringNotBeginsWith",
  "values": [ "string" ]

針對 StringNotContains,請使用:

  "operatorType": "StringNotContains",
  "values": [ "string" ]

針對 StringNotEndsWith,請使用:

  "operatorType": "StringNotEndsWith",
  "values": [ "string" ]

針對 StringNotIn,請使用:

  "operatorType": "StringNotIn",
  "values": [ "string" ]

屬性值

namespaces/topics/eventSubscriptions

名稱 描述
類型 資源類型 'Microsoft.EventGrid/namespaces/topics/eventSubscriptions'
apiVersion 資源 API 版本 '2023-06-01-preview'
NAME 資源名稱

請參閱如何在 JSON ARM 樣本中設定子資源的名稱和類型。
字串 (必要)
properties 事件訂閱的屬性。 SubscriptionProperties

SubscriptionProperties

名稱 描述
deliveryConfiguration 事件訂閱傳遞組態的相關信息。 DeliveryConfiguration
eventDeliverySchema 事件訂閱的事件傳遞架構。 'CloudEventSchemaV1_0'
filtersConfiguration 事件訂閱篩選的相關信息。 FiltersConfiguration

DeliveryConfiguration

名稱 描述
deliveryMode 事件訂閱的傳遞模式。 'Queue'
queue 當 deliveryMode 是佇列時,應該填入此屬性,並代表佇列訂閱的相關信息。 QueueInfo

QueueInfo

名稱 描述
deadLetterDestinationWithResourceIdentity 事件訂閱的寄不出的信件目的地。 無法傳遞至目的地的任何事件都會傳送至寄不出的信件目的地。
在父資源上使用受控識別設定 (,也就是主題) ,以取得傳遞/寄不出的信件期間所使用的驗證令牌。
DeadLetterWithResourceIdentity
eventTimeToLive ISO 8601 格式的時間範圍持續時間,決定從訊息發佈時間起,訂閱可以使用多少時間長度。
此持續時間值是以下列格式表示:'P (n) Y (n) M (n) DT (n) H (n) M (n) S',其中:
- (n) 會取代為 (n) 後面每個時間元素的值。
- P 是持續時間 (或期間) 指示項,且一律放在持續時間的開頭。
- Y 是年份指示項,它會遵循年數的值。
- M 是月份指示項,它會遵循月份數的值。
- W 是周指示項,它會遵循周數的值。
- D 是日期指示項,它會遵循天數的值。
- T 是時間指示項,且在時間元件之前。
- H 是小時指示項,它會遵循小時數的值。
- M 是分鐘指示項,它會遵循分鐘數的值。
- S 是第二個指示項,它會遵循秒數的值。
此持續時間值無法設定大於主題的 EventRetentionInDays。 這是選擇性欄位,其最小值為 1 分鐘,且決定其最大值
依主題的 EventRetentionInDays 值。 以下是有效值的範例:
- 'P0DT23H12M' 或 'PT23H12M':持續時間為 23 小時和 12 分鐘。
- 'P1D' 或 'P1DT0H0M0S':持續時間為 1 天。
字串
maxDeliveryCount 事件的最大傳遞計數。 int
receiveLockDurationInSeconds 用戶端 () 狀態收到訊息並等候接受、釋放或拒絕的秒數上限。
如果用戶端收到訊息之後經過此時間,且未轉換成已接受的 (未處理) 、釋放或拒絕,
訊息可供重新傳遞。 這是選擇性欄位,預設值為 60 秒,最小值為 60 秒,最大值為 300 秒。
int

DeadLetterWithResourceIdentity

名稱 描述
deadLetterDestination 事件訂用帳戶必須傳遞事件之目的地的相關信息。
在父資源上使用受控識別設定 (,也就是主題或網域) ,以取得傳遞/寄不出的信件期間所使用的驗證令牌。
DeadLetterDestination
身分識別 死信事件時要使用的身分識別。 EventSubscriptionIdentity

DeadLetterDestination

名稱 描述
endpointType 設定物件類型 StorageBlob (必要)

StorageBlobDeadLetterDestination

名稱 描述
endpointType 寄不出的信件目的地端點類型 'StorageBlob' (必要)
properties 記憶體 Blob 型死信目的地的屬性 StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

名稱 描述
blobContainerName 記憶體 Blob 容器的名稱,該容器是寄不出的事件目的地 字串
resourceId 記憶體帳戶的 Azure 資源識別符,該帳戶是寄不出的事件目的地 字串

EventSubscriptionIdentity

名稱 描述
類型 使用的受控識別類型。 類型 'SystemAssigned, UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。 類型 『None』 將會移除任何身分識別。 'SystemAssigned'
'UserAssigned'
userAssignedIdentity 與資源相關聯的使用者身分識別。 字串

FiltersConfiguration

名稱 描述
filters 篩選事件訂閱所使用的篩選陣列。 Filter[]
includedEventTypes 需要屬於事件訂用帳戶一部分的適用事件類型清單。 如果想要訂閱所有預設事件類型,請將 IncludedEventTypes 設定為 null。 string[]

篩選

名稱 描述
索引鍵 事件中的欄位/屬性,根據您要篩選的欄位/屬性。 字串
operatorType 設定物件類型 BoolEquals
IsNotNull
IsNullOrUndefined
NumberGreaterThan
NumberGreaterThanOrEquals
NumberIn
NumberInRange
NumberLessThan
NumberLessThanOrEquals
NumberNotIn
NumberNotInRange
StringBeginsWith
StringContains
StringEndsWith
StringIn
StringNotBeginsWith
StringNotContains
StringNotEndsWith
需要 StringNotIn ()

BoolEqualsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 'BoolEquals' (必要)
布爾篩選值。 bool

IsNotNullFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'IsNotNull' (必要)

IsNullOrUndefinedFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'IsNullOrUndefined' (必要)

NumberGreaterThanFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 必要) 'NumberGreaterThan' (
篩選值。 int

NumberGreaterThanOrEqualsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'NumberGreaterThanOrEquals' (必要)
篩選值。 int

NumberInFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 需要 『NumberIn』 ()
篩選值集。 int[]

NumberInRangeFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 需要 'NumberInRange' ()
篩選值集。 int[][]

NumberLessThanFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 必要 ('NumberLessThan')
篩選值。 int

NumberLessThanOrEqualsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'NumberLessThanOrEquals' (必要)
篩選值。 int

NumberNotInFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 需要 『NumberNotIn』 ()
篩選值集。 int[]

NumberNotInRangeFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'NumberNotInRange' (必要)
篩選值集。 int[][]

StringBeginsWithFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'StringBeginsWith' (必要)
篩選值集。 string[]

StringContainsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'StringContains' (必要)
篩選值集。 string[]

StringEndsWithFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'StringEndsWith' (必要)
篩選值集。 string[]

StringInFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'StringIn' (必要)
篩選值集。 string[]

StringNotBeginsWithFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'StringNotBeginsWith' (必要)
篩選值集。 string[]

StringNotContainsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'StringNotContains' (必要)
篩選值集。 string[]

StringNotEndsWithFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'StringNotEndsWith' (必要)
篩選值集。 string[]

StringNotInFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 'StringNotIn' (必要)
篩選值集。 string[]

Terraform (AzAPI 提供者) 資源定義

命名空間/topics/eventSubscriptions 資源類型可以使用目標作業來部署:

  • 資源群組

如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。

資源格式

若要建立 Microsoft.EventGrid/namespaces/topics/eventSubscriptions 資源,請將下列 Terraform 新增至範本。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/namespaces/topics/eventSubscriptions@2023-06-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      deliveryConfiguration = {
        deliveryMode = "Queue"
        queue = {
          deadLetterDestinationWithResourceIdentity = {
            deadLetterDestination = {
              endpointType = "string"
              // For remaining properties, see DeadLetterDestination objects
            }
            identity = {
              type = "string"
              userAssignedIdentity = "string"
            }
          }
          eventTimeToLive = "string"
          maxDeliveryCount = int
          receiveLockDurationInSeconds = int
        }
      }
      eventDeliverySchema = "CloudEventSchemaV1_0"
      filtersConfiguration = {
        filters = [
          {
            key = "string"
            operatorType = "string"
            // For remaining properties, see Filter objects
          }
        ]
        includedEventTypes = [
          "string"
        ]
      }
    }
  })
}

DeadLetterDestination 物件

設定 endpointType 屬性以指定物件的類型。

針對 StorageBlob,請使用:

  endpointType = "StorageBlob"
  properties = {
    blobContainerName = "string"
    resourceId = "string"
  }

篩選物件

設定 operatorType 屬性以指定物件的類型。

針對 BoolEquals,請使用:

  operatorType = "BoolEquals"
  value = bool

針對 IsNotNull,請使用:

  operatorType = "IsNotNull"

針對 IsNullOrUndefined,請使用:

  operatorType = "IsNullOrUndefined"

針對 NumberGreaterThan,請使用:

  operatorType = "NumberGreaterThan"
  value = int

針對 NumberGreaterThanOrEquals,請使用:

  operatorType = "NumberGreaterThanOrEquals"
  value = int

針對 NumberIn,請使用:

  operatorType = "NumberIn"
  values = [
    int
  ]

針對 NumberInRange,請使用:

  operatorType = "NumberInRange"
  values = [
    [
      int
    ]
  ]

針對 NumberLessThan,請使用:

  operatorType = "NumberLessThan"
  value = int

針對 NumberLessThanOrEquals,請使用:

  operatorType = "NumberLessThanOrEquals"
  value = int

針對 NumberNotIn,請使用:

  operatorType = "NumberNotIn"
  values = [
    int
  ]

針對 NumberNotInRange,請使用:

  operatorType = "NumberNotInRange"
  values = [
    [
      int
    ]
  ]

針對 StringBeginsWith,請使用:

  operatorType = "StringBeginsWith"
  values = [
    "string"
  ]

針對 StringContains,請使用:

  operatorType = "StringContains"
  values = [
    "string"
  ]

針對 StringEndsWith,請使用:

  operatorType = "StringEndsWith"
  values = [
    "string"
  ]

針對 StringIn,請使用:

  operatorType = "StringIn"
  values = [
    "string"
  ]

針對 StringNotBeginsWith,請使用:

  operatorType = "StringNotBeginsWith"
  values = [
    "string"
  ]

針對 StringNotContains,請使用:

  operatorType = "StringNotContains"
  values = [
    "string"
  ]

針對 StringNotEndsWith,請使用:

  operatorType = "StringNotEndsWith"
  values = [
    "string"
  ]

針對 StringNotIn,請使用:

  operatorType = "StringNotIn"
  values = [
    "string"
  ]

屬性值

namespaces/topics/eventSubscriptions

名稱 描述
類型 資源類型 “Microsoft.EventGrid/namespaces/topics/eventSubscriptions@2023-06-01-preview”
NAME 資源名稱 字串 (必要)
parent_id 此資源之父系的資源標識碼。 類型資源的標識碼: 主題
properties 事件訂閱的屬性。 SubscriptionProperties

SubscriptionProperties

名稱 描述
deliveryConfiguration 事件訂閱傳遞組態的相關信息。 DeliveryConfiguration
eventDeliverySchema 事件訂閱的事件傳遞架構。 “CloudEventSchemaV1_0”
filtersConfiguration 事件訂閱篩選的相關信息。 FiltersConfiguration

DeliveryConfiguration

名稱 描述
deliveryMode 事件訂閱的傳遞模式。 “Queue”
queue 當 deliveryMode 是佇列時,應該填入此屬性,並代表佇列訂閱的相關信息。 QueueInfo

QueueInfo

名稱 描述
deadLetterDestinationWithResourceIdentity 事件訂閱的寄不出的信件目的地。 無法傳遞至目的地的任何事件都會傳送至寄不出的信件目的地。
在父資源上使用受控識別設定 (,也就是主題) ,以取得傳遞/寄不出的信件期間所使用的驗證令牌。
DeadLetterWithResourceIdentity
eventTimeToLive ISO 8601 格式的時間範圍持續時間,決定從訊息發佈時間起,訂閱可以使用多少時間長度。
此持續時間值是以下列格式表示:'P (n) Y (n) M (n) DT (n) H (n) M (n) S',其中:
- (n) 會取代為 (n) 後面每個時間元素的值。
- P 是持續時間 (或期間) 指示項,且一律放在持續時間的開頭。
- Y 是年份指示項,它會遵循年數的值。
- M 是月份指示項,它會遵循月份數的值。
- W 是周指示項,它會遵循周數的值。
- D 是日期指示項,它會遵循天數的值。
- T 是時間指示項,且在時間元件之前。
- H 是小時指示項,它會遵循小時數的值。
- M 是分鐘指示項,它會遵循分鐘數的值。
- S 是第二個指示項,它會遵循秒數的值。
此持續時間值無法設定大於主題的 EventRetentionInDays。 這是選擇性欄位,其最小值為 1 分鐘,且決定其最大值
依主題的 EventRetentionInDays 值。 以下是有效值的範例:
- 'P0DT23H12M' 或 'PT23H12M':持續時間為 23 小時和 12 分鐘。
- 'P1D' 或 'P1DT0H0M0S':持續時間為 1 天。
字串
maxDeliveryCount 事件的最大傳遞計數。 int
receiveLockDurationInSeconds 用戶端 () 狀態收到訊息並等候接受、釋放或拒絕的秒數上限。
如果用戶端收到訊息之後經過此時間,且未轉換成已接受的 (未處理) 、釋放或拒絕,
訊息可供重新傳遞。 這是選擇性欄位,預設值為 60 秒,最小值為 60 秒,最大值為 300 秒。
int

DeadLetterWithResourceIdentity

名稱 描述
deadLetterDestination 事件訂用帳戶必須傳遞事件之目的地的相關信息。
在父資源上使用受控識別設定 (,也就是主題或網域) ,以取得傳遞/寄不出的信件期間所使用的驗證令牌。
DeadLetterDestination
身分識別 死信事件時要使用的身分識別。 EventSubscriptionIdentity

DeadLetterDestination

名稱 描述
endpointType 設定物件類型 StorageBlob (必要)

StorageBlobDeadLetterDestination

名稱 描述
endpointType 無效信件目的地的端點類型 “StorageBlob” (必要)
properties 記憶體 Blob 型寄不出的目的地屬性 StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

名稱 描述
blobContainerName 記憶體 Blob 容器的名稱,該容器是寄不出的事件目的地 字串
resourceId 記憶體帳戶的 Azure 資源識別符,該帳戶是死信事件目的地 字串

EventSubscriptionIdentity

名稱 描述
類型 使用的受控識別類型。 類型 'SystemAssigned, UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。 類型 『None』 將會移除任何身分識別。 “SystemAssigned”
“UserAssigned”
userAssignedIdentity 與資源相關聯的使用者身分識別。 字串

FiltersConfiguration

名稱 描述
filters 篩選事件訂閱所使用的篩選陣列。 Filter[]
includedEventTypes 需要屬於事件訂閱一部分的適用事件類型清單。 如果需要訂閱所有預設事件類型,請將 IncludedEventTypes 設定為 null。 string[]

篩選

名稱 描述
索引鍵 事件中的欄位/屬性,根據您要篩選的欄位/屬性。 字串
operatorType 設定物件類型 BoolEquals
IsNotNull
IsNullOrUndefined
NumberGreaterThan
NumberGreaterThanOrEquals
NumberIn
NumberInRange
NumberLessThan
NumberLessThanOrEquals
NumberNotIn
NumberNotInRange
StringBeginsWith
StringContains
StringEndsWith
StringIn
StringNotBeginsWith
StringNotContains
StringNotEndsWith
需要 StringNotIn ()

BoolEqualsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 “BoolEquals” (必要)
布爾篩選值。 bool

IsNotNullFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 “IsNotNull” (必要)

IsNullOrUndefinedFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 “IsNullOrUndefined” (必要)

NumberGreaterThanFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 必要) “NumberGreaterThan” (
篩選值。 int

NumberGreaterThanOrEqualsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 “NumberGreaterThanOrEquals” (必要)
篩選值。 int

NumberInFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 “NumberIn” (必要)
篩選值集。 int[]

NumberInRangeFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 必要) 的 「NumberInRange」 (
篩選值集。 int[][]

NumberLessThanFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 必要) “NumberLessThan” (
篩選值。 int

NumberLessThanOrEqualsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 “NumberLessThanOrEquals” (必要)
篩選值。 int

NumberNotInFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 必要 (「NumberNotIn」)
篩選值集。 int[]

NumberNotInRangeFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 “NumberNotInRange” (必要)
篩選值集。 int[][]

StringBeginsWithFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 “StringBeginsWith” (必要)
篩選值集。 string[]

StringContainsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 “StringContains” (必要)
篩選值集。 string[]

StringEndsWithFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 和其他類型。 “StringEndsWith” (必要)
篩選值集。 string[]

StringInFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 “StringIn” (必要)
篩選值集。 string[]

StringNotBeginsWithFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 “StringNotBeginsWith” (必要)
篩選值集。 string[]

StringNotContainsFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 “StringNotContains” (必要)
篩選值集。 string[]

StringNotEndsWithFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 “StringNotEndsWith” (必要)
篩選值集。 string[]

StringNotInFilter

名稱 描述
operatorType 用於篩選的運算符類型,例如 NumberIn、StringContains、BoolEquals 等等。 “StringNotIn” (必要)
篩選值集。 string[]