你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft.EventGrid eventSubscriptions 2020-06-01

项目
12/20/2024

Bicep 资源定义

可以使用目标操作部署 eventSubscriptions 资源类型：

有关每个 API 版本中已更改属性的列表，请参阅更改日志。

资源格式

若要创建 Microsoft.EventGrid/eventSubscriptions 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.EventGrid/eventSubscriptions@2020-06-01' = {
  scope: resourceSymbolicName or scope
  name: 'string'
  properties: {
    deadLetterDestination: {
      endpointType: 'string'
      // For remaining properties, see DeadLetterDestination objects
    }
    destination: {
      endpointType: 'string'
      // For remaining properties, see EventSubscriptionDestination objects
    }
    eventDeliverySchema: 'string'
    expirationTimeUtc: 'string'
    filter: {
      advancedFilters: [
        {
          key: 'string'
          operatorType: 'string'
          // For remaining properties, see AdvancedFilter objects
        }
      ]
      includedEventTypes: [
        'string'
      ]
      isSubjectCaseSensitive: bool
      subjectBeginsWith: 'string'
      subjectEndsWith: 'string'
    }
    labels: [
      'string'
    ]
    retryPolicy: {
      eventTimeToLiveInMinutes: int
      maxDeliveryAttempts: int
    }
  }
}

DeadLetterDestination 对象

设置 endpointType 属性以指定对象的类型。

对于 StorageBlob，请使用：

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

EventSubscriptionDestination 对象

设置 endpointType 属性以指定对象的类型。

对于 azureFunction，请使用：

{
  endpointType: 'AzureFunction'
  properties: {
    maxEventsPerBatch: int
    preferredBatchSizeInKilobytes: int
    resourceId: 'string'
  }
}

对于 EventHub，请使用：

{
  endpointType: 'EventHub'
  properties: {
    resourceId: 'string'
  }
}

对于 HybridConnection，请使用：

{
  endpointType: 'HybridConnection'
  properties: {
    resourceId: 'string'
  }
}

对于 ServiceBusQueue，请使用：

{
  endpointType: 'ServiceBusQueue'
  properties: {
    resourceId: 'string'
  }
}

对于 ServiceBusTopic，请使用：

{
  endpointType: 'ServiceBusTopic'
  properties: {
    resourceId: 'string'
  }
}

对于 StorageQueue，请使用：

{
  endpointType: 'StorageQueue'
  properties: {
    queueName: 'string'
    resourceId: 'string'
  }
}

对于 WebHook，请使用：

{
  endpointType: 'WebHook'
  properties: {
    azureActiveDirectoryApplicationIdOrUri: 'string'
    azureActiveDirectoryTenantId: 'string'
    endpointUrl: 'string'
    maxEventsPerBatch: int
    preferredBatchSizeInKilobytes: int
  }
}

AdvancedFilter 对象

设置 operatorType 属性以指定对象的类型。

对于 BoolEquals，请使用：

{
  operatorType: 'BoolEquals'
  value: bool
}

对于 NumberGreaterThan，请使用：

{
  operatorType: 'NumberGreaterThan'
  value: int
}

对于 NumberGreaterThanOrEquals，请使用：

{
  operatorType: 'NumberGreaterThanOrEquals'
  value: int
}

对于 NumberIn，请使用：

{
  operatorType: 'NumberIn'
  values: [
    int
  ]
}

对于 NumberLessThan，请使用：

{
  operatorType: 'NumberLessThan'
  value: int
}

对于 NumberLessThanOrEquals，请使用：

{
  operatorType: 'NumberLessThanOrEquals'
  value: int
}

对于 NumberNotIn，请使用：

{
  operatorType: 'NumberNotIn'
  values: [
    int
  ]
}

对于 StringBeginsWith，请使用：

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

对于 StringContains，请使用：

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

对于 StringEndsWith，请使用：

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

对于 StringIn，请使用：

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

对于 StringNotIn，请使用：

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

属性值

AdvancedFilter

名字	描述	价值
钥匙	要根据要筛选的事件中的字段/属性。	字符串
operatorType	对于 type BoolEqualsAdvancedFilter，设置为“BoolEquals”。对于 type NumberGreaterThanAdvancedFilter，设置为“NumberGreaterThan”。对于 type NumberGreaterThanOrEqualsAdvancedFilter，设置为“NumberGreaterThanOrEquals”。对于 type NumberInAdvancedFilter，设置为“NumberIn”。对于 type NumberLessThanAdvancedFilter，设置为“NumberLessThan”。对于 type NumberLessThanOrEqualsAdvancedFilter，设置为“NumberLessThanOrEquals”。对于 type NumberNotInAdvancedFilter，设置为“NumberNotIn”。对于 type StringBeginsWithAdvancedFilter，设置为“StringBeginsWith”。对于 stringContainsAdvancedFilter，请设置为 “StringContains”类型。对于 type StringEndsWithAdvancedFilter，设置为“StringEndsWith”。对于 type StringInAdvancedFilter，设置为“StringIn”。对于 stringNotInAdvancedFilter类型，请设置为“StringNotIn”。	“BoolEquals” “NumberGreaterThan” “NumberGreaterThanOrEquals” “NumberIn” “NumberLessThan” “NumberLessThanOrEquals” “NumberNotIn” “StringBeginsWith” “StringContains” “StringEndsWith” “StringIn” “StringNotIn”（必需）

AzureFunctionEventSubscriptionDestination

名字	描述	价值
endpointType	事件订阅目标的终结点类型。	“AzureFunction”（必需）
性能	事件订阅目标的 Azure 函数属性。	AzureFunctionEventSubscriptionDestinationProperties

AzureFunctionEventSubscriptionDestinationProperties

名字	描述	价值
maxEventsPerBatch	每个批处理的最大事件数。	int
preferredBatchSizeInKilobytes	首选批大小（以千字节为单位）。	int
resourceId	表示事件订阅的 Azure Function 目标的终结点的 Azure 资源 ID。	字符串

BoolEqualsAdvancedFilter

名字	描述	价值
operatorType	用于筛选的运算符类型，例如 NumberIn、StringContains、BoolEquals 等。	“BoolEquals”（必需）
价值	布尔筛选器值。	bool

DeadLetterDestination

名字	描述	价值
endpointType	对于 StorageBlobDeadLetterDestination，请设置为“StorageBlob”。	“StorageBlob”（必需）

EventHubEventSubscriptionDestination

名字	描述	价值
endpointType	事件订阅目标的终结点类型。	“EventHub”（必需）
性能	事件订阅目标的事件中心属性。	EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

名字	描述	价值
resourceId	表示事件订阅的事件中心目标的终结点的 Azure 资源 ID。	字符串

EventSubscriptionDestination

名字	描述	价值
endpointType	对于 AzureFunctionEventSubscriptionDestination类型，设置为“AzureFunction”。设置为 EventHubEventSubscriptionDestination类型的“EventHub”。对于 HybridConnectionEventSubscriptionDestination，请设置为“HybridConnection”。对于 ServiceBusQueueEventSubscriptionDestination，请设置为“ServiceBusQueue”。对于 ServiceBusTopicEventSubscriptionDestination，请设置为“ServiceBusTopic”。对于 type StorageQueueEventSubscriptionDestination，设置为“StorageQueue”。对于 WebHookEventSubscriptionDestination，请设置为“WebHook”。	“AzureFunction” “EventHub” “HybridConnection” “ServiceBusQueue” “ServiceBusTopic” “StorageQueue” “WebHook”（必需）

EventSubscriptionFilter

名字	描述	价值
advancedFilters	用于筛选事件订阅的高级筛选器数组。	AdvancedFilter[]
includedEventTypes	需要属于事件订阅的适用事件类型的列表。如果需要订阅所有默认事件类型，请将 IncludedEventTypes 设置为 null。	string[]
isSubjectCaseSensitive	指定筛选器的 SubjectBeginsWith 和 SubjectEndsWith 属性应以区分大小写的方式进行比较。	bool
subjectBeginsWith	一个可选字符串，用于根据资源路径前缀筛选事件订阅的事件。此格式取决于事件的发布者。此路径不支持通配符。	字符串
subjectEndsWith	一个可选字符串，用于根据资源路径后缀筛选事件订阅的事件。此路径不支持通配符。	字符串

EventSubscriptionProperties

名字	描述	价值
deadLetterDestination	事件订阅的 DeadLetter 目标。	DeadLetterDestination
目的地	有关事件订阅必须传送事件的目标的信息。	EventSubscriptionDestination
eventDeliverySchema	事件订阅的事件传送架构。	“CloudEventSchemaV1_0” “CustomInputSchema” “EventGridSchema”
expirationTimeUtc	事件订阅的过期时间。	字符串
滤波器	有关事件订阅筛选器的信息。	EventSubscriptionFilter
标签	用户定义的标签列表。	string[]
retryPolicy	事件的重试策略。这可用于配置事件的最大传递尝试次数和生存时间。	RetryPolicy

HybridConnectionEventSubscriptionDestination

名字	描述	价值
endpointType	事件订阅目标的终结点类型。	“HybridConnection”（必需）
性能	事件订阅目标的混合连接属性。	HybridConnectionEventSubscriptionDestinationProperties

HybridConnectionEventSubscriptionDestinationProperties

名字	描述	价值
resourceId	作为事件订阅目标的混合连接的 Azure 资源 ID。	字符串