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

發行項
12/16/2024

Bicep 資源定義

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

資源群組 - 請參閱資源群組部署命令

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

資源格式

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

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

DeadLetterDestination 物件

設定 endpointType 屬性，以指定對象的類型。

針對 StorageBlob，請使用：

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

屬性值

BoolEqualsFilter

名字	描述	價值
operatorType	用於篩選的運算符類型，例如 NumberIn、StringContains、BoolEquals 等。	'BoolEquals' （必要）
價值	布爾篩選值。	bool

DeadLetterDestination

名字	描述	價值
endpointType	針對 storageBlobDeadLetterDestination類型設定為 'StorageBlob'。	'StorageBlob' （必要）

DeadLetterWithResourceIdentity

名字	描述	價值
deadLetterDestination	事件訂閱必須傳遞事件目的地的相關信息。使用父資源上的受控識別設定（即主題或網域）來取得傳遞/寄不出的信件期間所使用的驗證令牌。	DeadLetterDestination
身份	當寄不出的信件事件時要使用的身分識別。	EventSubscriptionIdentity

DeliveryConfiguration

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

EventSubscriptionIdentity

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

濾波器

名字	描述	價值
鑰匙	事件中的欄位/屬性，根據您想要篩選的欄位/屬性。	字串
operatorType	將類型設定為 'BoolEquals'，BoolEqualsFilter。針對isNotNullFilter 類型設定為 'IsNotNull'，。針對 isNullOrUndefined 類型設定為 'IsNullOrUndefined' IsNullOrUndefinedFilter。針對 type NumberGreaterThanFilter，設定為 'NumberGreaterThan'。針對 type NumberGreaterThanOrEqualsFilter，設定為 'NumberGreaterThanOrEquals'。將 type NumberInFilter設定為 'NumberIn'。針對 type NumberInRangeFilter，設定為 'NumberInRange'。將類型設定為 'NumberLessThan' NumberLessThanFilter。針對 type NumberLessThanOrEqualsFilter，設定為 'NumberLessThanOrEquals'。將 type NumberNotInFilter設定為 'NumberNotIn'。針對 type NumberNotInRangeFilter，設定為 'NumberNotInRange'。在 stringBeginsWithFilter類型設定為 'StringBeginsWith'。針對 stringContainsFilter 類型設定為 'StringContains'，。針對 stringEndsWithfilter 類型設定為 'StringEndsWith'，。針對 stringInFilter 類型設定為『StringIn』，。針對 stringNotBeginsWithsWith 類型設定為 'StringNotBeginsWithFilter '，。將類型設定為 'StringNotContains' StringNotContainsFilter。針對 stringNotEndsWith 類型設定為『StringNotEndsWith』，。針對 stringNotInFilter 類型設定為『StringNotIn』，。	'BoolEquals' 'IsNotNull' 'IsNullOrUndefined' 'NumberGreaterThan' 'NumberGreaterThanOrEquals' 'NumberIn' 'NumberInRange' 'NumberLessThan' 'NumberLessThanOrEquals' 'NumberNotIn' 'NumberNotInRange' 'StringBeginsWith' 'StringContains' 'StringEndsWith' 'StringIn' 'StringNotBeginsWith' 'StringNotContains' 'StringNotEndsWith' 'StringNotIn' （必要）

FiltersConfiguration

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

IsNotNullFilter

名字	描述	價值
operatorType	用於篩選的運算符類型，例如 NumberIn、StringContains、BoolEquals 等。	'IsNotNull' （必要）

IsNullOrUndefinedFilter

名字	描述	價值
operatorType	用於篩選的運算符類型，例如 NumberIn、StringContains、BoolEquals 等。	'IsNullOrUndefined' （必要）

Microsoft.EventGrid/namespaces/topics/eventSubscriptions

名字	描述	價值
名字	資源名稱	字串約束：最小長度 = 3 最大長度 = 50 模式 = `^[a-zA-Z0-9-]*$` （必要）
父母	在 Bicep 中，您可以指定子資源的父資源。只有在父資源外部宣告子資源時，才需要新增這個屬性。如需詳細資訊，請參閱父資源外部的子資源。	類型資源的符號名稱：命名空間/主題
性能	事件訂閱的屬性。	SubscriptionProperties

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[][]

QueueInfo

名字	描述	價值
deadLetterDestinationWithResourceIdentity	事件訂閱的寄不出的信件目的地。無法傳遞至其目的地的任何事件都會傳送至寄不出的信件目的地。使用父資源上的受控識別設定（即主題）來取得傳遞/寄不出的信件期間所使用的驗證令牌。	DeadLetterWithResourceIdentity
eventTimeToLive	ISO 8601 格式的時間範圍持續時間，決定從發佈訊息的時間起，訂閱可以使用多久的訊息。此持續時間值使用下列格式表示：'P（n）Y（n）M（n）DT（n）H（n）M（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

StorageBlobDeadLetterDestination

名字	描述	價值
endpointType	寄不出的信件目的地的端點類型	'StorageBlob' （必要）
性能	記憶體 Blob 型死機目的地的屬性	StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

名字	描述	價值
blobContainerName	記憶體 Blob 容器的名稱，該容器是死機事件的目的地	字串
resourceId	記憶體帳戶的 Azure 資源識別符，這是死機事件的目的地	字串

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[]

SubscriptionProperties

名字	描述	價值
deliveryConfiguration	事件訂閱傳遞設定的相關信息。	DeliveryConfiguration
eventDeliverySchema	事件訂閱的事件傳遞架構。	'CloudEventSchemaV1_0'
filtersConfiguration	事件訂閱篩選的相關信息。	FiltersConfiguration

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": "string",
      "queue": {
        "deadLetterDestinationWithResourceIdentity": {
          "deadLetterDestination": {
            "endpointType": "string"
            // For remaining properties, see DeadLetterDestination objects
          },
          "identity": {
            "type": "string",
            "userAssignedIdentity": "string"
          }
        },
        "eventTimeToLive": "string",
        "maxDeliveryCount": "int",
        "receiveLockDurationInSeconds": "int"
      }
    },
    "eventDeliverySchema": "string",
    "filtersConfiguration": {
      "filters": [ {
        "key": "string",
        "operatorType": "string"
        // For remaining properties, see Filter objects
      } ],
      "includedEventTypes": [ "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" ]
}

DeadLetterDestination 物件

設定 endpointType 屬性，以指定對象的類型。

針對 StorageBlob，請使用：

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

屬性值

BoolEqualsFilter

名字	描述	價值
operatorType	用於篩選的運算符類型，例如 NumberIn、StringContains、BoolEquals 等。	'BoolEquals' （必要）
價值	布爾篩選值。	bool

DeadLetterDestination

名字	描述	價值
endpointType	針對 storageBlobDeadLetterDestination類型設定為 'StorageBlob'。	'StorageBlob' （必要）

DeadLetterWithResourceIdentity

名字	描述	價值
deadLetterDestination	事件訂閱必須傳遞事件目的地的相關信息。使用父資源上的受控識別設定（即主題或網域）來取得傳遞/寄不出的信件期間所使用的驗證令牌。	DeadLetterDestination
身份	當寄不出的信件事件時要使用的身分識別。	EventSubscriptionIdentity

DeliveryConfiguration

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

EventSubscriptionIdentity

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

濾波器

名字	描述	價值
鑰匙	事件中的欄位/屬性，根據您想要篩選的欄位/屬性。	字串
operatorType	將類型設定為 'BoolEquals'，BoolEqualsFilter。針對isNotNullFilter 類型設定為 'IsNotNull'，。針對 isNullOrUndefined 類型設定為 'IsNullOrUndefined' IsNullOrUndefinedFilter。針對 type NumberGreaterThanFilter，設定為 'NumberGreaterThan'。針對 type NumberGreaterThanOrEqualsFilter，設定為 'NumberGreaterThanOrEquals'。將 type NumberInFilter設定為 'NumberIn'。針對 type NumberInRangeFilter，設定為 'NumberInRange'。將類型設定為 'NumberLessThan' NumberLessThanFilter。針對 type NumberLessThanOrEqualsFilter，設定為 'NumberLessThanOrEquals'。將 type NumberNotInFilter設定為 'NumberNotIn'。針對 type NumberNotInRangeFilter，設定為 'NumberNotInRange'。在 stringBeginsWithFilter類型設定為 'StringBeginsWith'。針對 stringContainsFilter 類型設定為 'StringContains'，。針對 stringEndsWithfilter 類型設定為 'StringEndsWith'，。針對 stringInFilter 類型設定為『StringIn』，。針對 stringNotBeginsWithsWith 類型設定為 'StringNotBeginsWithFilter '，。將類型設定為 'StringNotContains' StringNotContainsFilter。針對 stringNotEndsWith 類型設定為『StringNotEndsWith』，。針對 stringNotInFilter 類型設定為『StringNotIn』，。	'BoolEquals' 'IsNotNull' 'IsNullOrUndefined' 'NumberGreaterThan' 'NumberGreaterThanOrEquals' 'NumberIn' 'NumberInRange' 'NumberLessThan' 'NumberLessThanOrEquals' 'NumberNotIn' 'NumberNotInRange' 'StringBeginsWith' 'StringContains' 'StringEndsWith' 'StringIn' 'StringNotBeginsWith' 'StringNotContains' 'StringNotEndsWith' 'StringNotIn' （必要）

FiltersConfiguration

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

IsNotNullFilter

名字	描述	價值
operatorType	用於篩選的運算符類型，例如 NumberIn、StringContains、BoolEquals 等。	'IsNotNull' （必要）

IsNullOrUndefinedFilter

名字	描述	價值
operatorType	用於篩選的運算符類型，例如 NumberIn、StringContains、BoolEquals 等。	'IsNullOrUndefined' （必要）

Microsoft.EventGrid/namespaces/topics/eventSubscriptions

名字	描述	價值
apiVersion	API 版本	'2023-06-01-preview'
名字	資源名稱	字串約束：最小長度 = 3 最大長度 = 50 模式 = `^[a-zA-Z0-9-]*$` （必要）
性能	事件訂閱的屬性。	SubscriptionProperties
類型	資源類型	'Microsoft.EventGrid/namespaces/topics/eventSubscriptions'

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[][]

QueueInfo

名字	描述	價值
deadLetterDestinationWithResourceIdentity	事件訂閱的寄不出的信件目的地。無法傳遞至其目的地的任何事件都會傳送至寄不出的信件目的地。使用父資源上的受控識別設定（即主題）來取得傳遞/寄不出的信件期間所使用的驗證令牌。	DeadLetterWithResourceIdentity
eventTimeToLive	ISO 8601 格式的時間範圍持續時間，決定從發佈訊息的時間起，訂閱可以使用多久的訊息。此持續時間值使用下列格式表示：'P（n）Y（n）M（n）DT（n）H（n）M（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

StorageBlobDeadLetterDestination

名字	描述	價值
endpointType	寄不出的信件目的地的端點類型	'StorageBlob' （必要）
性能	記憶體 Blob 型死機目的地的屬性	StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

名字	描述	價值
blobContainerName	記憶體 Blob 容器的名稱，該容器是死機事件的目的地	字串
resourceId	記憶體帳戶的 Azure 資源識別符，這是死機事件的目的地	字串

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[]

SubscriptionProperties

名字	描述	價值
deliveryConfiguration	事件訂閱傳遞設定的相關信息。	DeliveryConfiguration
eventDeliverySchema	事件訂閱的事件傳遞架構。	'CloudEventSchemaV1_0'
filtersConfiguration	事件訂閱篩選的相關信息。	FiltersConfiguration

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"
  body = jsonencode({
    properties = {
      deliveryConfiguration = {
        deliveryMode = "string"
        queue = {
          deadLetterDestinationWithResourceIdentity = {
            deadLetterDestination = {
              endpointType = "string"
              // For remaining properties, see DeadLetterDestination objects
            }
            identity = {
              type = "string"
              userAssignedIdentity = "string"
            }
          }
          eventTimeToLive = "string"
          maxDeliveryCount = int
          receiveLockDurationInSeconds = int
        }
      }
      eventDeliverySchema = "string"
      filtersConfiguration = {
        filters = [
          {
            key = "string"
            operatorType = "string"
            // For remaining properties, see Filter objects
          }
        ]
        includedEventTypes = [
          "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"
  ]
}

DeadLetterDestination 物件

設定 endpointType 屬性，以指定對象的類型。

針對 StorageBlob，請使用：

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

屬性值

BoolEqualsFilter

名字	描述	價值
operatorType	用於篩選的運算符類型，例如 NumberIn、StringContains、BoolEquals 等。	'BoolEquals' （必要）
價值	布爾篩選值。	bool

DeadLetterDestination

名字	描述	價值
endpointType	針對 storageBlobDeadLetterDestination類型設定為 'StorageBlob'。	'StorageBlob' （必要）

DeadLetterWithResourceIdentity

名字	描述	價值
deadLetterDestination	事件訂閱必須傳遞事件目的地的相關信息。使用父資源上的受控識別設定（即主題或網域）來取得傳遞/寄不出的信件期間所使用的驗證令牌。	DeadLetterDestination
身份	當寄不出的信件事件時要使用的身分識別。	EventSubscriptionIdentity

DeliveryConfiguration

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

EventSubscriptionIdentity

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

濾波器

名字	描述	價值
鑰匙	事件中的欄位/屬性，根據您想要篩選的欄位/屬性。	字串
operatorType	將類型設定為 'BoolEquals'，BoolEqualsFilter。針對isNotNullFilter 類型設定為 'IsNotNull'，。針對 isNullOrUndefined 類型設定為 'IsNullOrUndefined' IsNullOrUndefinedFilter。針對 type NumberGreaterThanFilter，設定為 'NumberGreaterThan'。針對 type NumberGreaterThanOrEqualsFilter，設定為 'NumberGreaterThanOrEquals'。將 type NumberInFilter設定為 'NumberIn'。針對 type NumberInRangeFilter，設定為 'NumberInRange'。將類型設定為 'NumberLessThan' NumberLessThanFilter。針對 type NumberLessThanOrEqualsFilter，設定為 'NumberLessThanOrEquals'。將 type NumberNotInFilter設定為 'NumberNotIn'。針對 type NumberNotInRangeFilter，設定為 'NumberNotInRange'。在 stringBeginsWithFilter類型設定為 'StringBeginsWith'。針對 stringContainsFilter 類型設定為 'StringContains'，。針對 stringEndsWithfilter 類型設定為 'StringEndsWith'，。針對 stringInFilter 類型設定為『StringIn』，。針對 stringNotBeginsWithsWith 類型設定為 'StringNotBeginsWithFilter '，。將類型設定為 'StringNotContains' StringNotContainsFilter。針對 stringNotEndsWith 類型設定為『StringNotEndsWith』，。針對 stringNotInFilter 類型設定為『StringNotIn』，。	'BoolEquals' 'IsNotNull' 'IsNullOrUndefined' 'NumberGreaterThan' 'NumberGreaterThanOrEquals' 'NumberIn' 'NumberInRange' 'NumberLessThan' 'NumberLessThanOrEquals' 'NumberNotIn' 'NumberNotInRange' 'StringBeginsWith' 'StringContains' 'StringEndsWith' 'StringIn' 'StringNotBeginsWith' 'StringNotContains' 'StringNotEndsWith' 'StringNotIn' （必要）

FiltersConfiguration

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

IsNotNullFilter

名字	描述	價值
operatorType	用於篩選的運算符類型，例如 NumberIn、StringContains、BoolEquals 等。	'IsNotNull' （必要）

IsNullOrUndefinedFilter

名字	描述	價值
operatorType	用於篩選的運算符類型，例如 NumberIn、StringContains、BoolEquals 等。	'IsNullOrUndefined' （必要）

Microsoft.EventGrid/namespaces/topics/eventSubscriptions

名字	描述	價值
名字	資源名稱	字串約束：最小長度 = 3 最大長度 = 50 模式 = `^[a-zA-Z0-9-]*$` （必要）
parent_id	此資源為父系之資源的標識碼。	類型資源的標識碼：命名空間/主題
性能	事件訂閱的屬性。	SubscriptionProperties
類型	資源類型	“Microsoft.EventGrid/namespaces/topics/eventSubscriptions@2023-06-01-preview”

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[][]

QueueInfo

名字	描述	價值
deadLetterDestinationWithResourceIdentity	事件訂閱的寄不出的信件目的地。無法傳遞至其目的地的任何事件都會傳送至寄不出的信件目的地。使用父資源上的受控識別設定（即主題）來取得傳遞/寄不出的信件期間所使用的驗證令牌。	DeadLetterWithResourceIdentity
eventTimeToLive	ISO 8601 格式的時間範圍持續時間，決定從發佈訊息的時間起，訂閱可以使用多久的訊息。此持續時間值使用下列格式表示：'P（n）Y（n）M（n）DT（n）H（n）M（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

StorageBlobDeadLetterDestination

名字	描述	價值
endpointType	寄不出的信件目的地的端點類型	'StorageBlob' （必要）
性能	記憶體 Blob 型死機目的地的屬性	StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

名字	描述	價值
blobContainerName	記憶體 Blob 容器的名稱，該容器是死機事件的目的地	字串
resourceId	記憶體帳戶的 Azure 資源識別符，這是死機事件的目的地	字串

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[]

SubscriptionProperties

名字	描述	價值
deliveryConfiguration	事件訂閱傳遞設定的相關信息。	DeliveryConfiguration
eventDeliverySchema	事件訂閱的事件傳遞架構。	'CloudEventSchemaV1_0'
filtersConfiguration	事件訂閱篩選的相關信息。	FiltersConfiguration

共用方式為

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

Bicep 資源定義

資源格式

篩選物件

DeadLetterDestination 物件

屬性值

BoolEqualsFilter

DeadLetterDestination

DeadLetterWithResourceIdentity

DeliveryConfiguration

EventSubscriptionIdentity

濾波器

FiltersConfiguration

IsNotNullFilter

IsNullOrUndefinedFilter

Microsoft.EventGrid/namespaces/topics/eventSubscriptions

NumberGreaterThanFilter

NumberGreaterThanOrEqualsFilter

NumberInFilter

NumberInRangeFilter

NumberLessThanFilter

NumberLessThanOrEqualsFilter

NumberNotInFilter

NumberNotInRangeFilter

QueueInfo

StorageBlobDeadLetterDestination

StorageBlobDeadLetterDestinationProperties

StringBeginsWithFilter

StringContainsFilter

StringEndsWithFilter

StringInFilter

StringNotBeginsWithFilter

StringNotContainsFilter

StringNotEndsWithFilter

StringNotInFilter

SubscriptionProperties

ARM 樣本資源定義

資源格式

篩選物件

DeadLetterDestination 物件

屬性值

BoolEqualsFilter

DeadLetterDestination

DeadLetterWithResourceIdentity

DeliveryConfiguration

EventSubscriptionIdentity

濾波器

FiltersConfiguration

IsNotNullFilter

IsNullOrUndefinedFilter

Microsoft.EventGrid/namespaces/topics/eventSubscriptions

NumberGreaterThanFilter

NumberGreaterThanOrEqualsFilter

NumberInFilter

NumberInRangeFilter

NumberLessThanFilter

NumberLessThanOrEqualsFilter

NumberNotInFilter

NumberNotInRangeFilter

QueueInfo

StorageBlobDeadLetterDestination

StorageBlobDeadLetterDestinationProperties

StringBeginsWithFilter

StringContainsFilter

StringEndsWithFilter

StringInFilter

StringNotBeginsWithFilter

StringNotContainsFilter

StringNotEndsWithFilter

StringNotInFilter

SubscriptionProperties

Terraform （AzAPI 提供者） 資源定義

資源格式

篩選物件

DeadLetterDestination 物件

屬性值

BoolEqualsFilter

DeadLetterDestination

DeadLetterWithResourceIdentity

Terraform （AzAPI 提供者）資源定義