Microsoft. EventGrid eventSubscriptions

Определение ресурса Bicep

Тип ресурса eventSubscriptions можно развернуть с помощью операций, предназначенных для следующих операций:

  • Tenant - См. tenant deployment commandsManagement groups - См. команды развертывания management group deploySubscription - См. команды развертывания подпискиResource groups - См. resource Команды развертывания групп

Для получения списка изменённых свойств в каждой версии API см. журнал изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.EventGrid/eventSubscriptions, добавьте следующий Bicep в ваш шаблон.

resource symbolicname 'Microsoft.EventGrid/eventSubscriptions@2025-07-15-preview' = {
  scope: resourceSymbolicName or scope
  name: 'string'
  properties: {
    deadLetterDestination: {
      endpointType: 'string'
      // For remaining properties, see DeadLetterDestination objects
    }
    deadLetterWithResourceIdentity: {
      deadLetterDestination: {
        endpointType: 'string'
        // For remaining properties, see DeadLetterDestination objects
      }
      identity: {
        federatedIdentityCredentialInfo: {
          federatedClientId: 'string'
        }
        type: 'string'
        userAssignedIdentity: 'string'
      }
    }
    deliveryWithResourceIdentity: {
      destination: {
        endpointType: 'string'
        // For remaining properties, see EventSubscriptionDestination objects
      }
      identity: {
        federatedIdentityCredentialInfo: {
          federatedClientId: 'string'
        }
        type: 'string'
        userAssignedIdentity: 'string'
      }
    }
    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
        }
      ]
      enableAdvancedFilteringOnArrays: bool
      includedEventTypes: [
        'string'
      ]
      isSubjectCaseSensitive: bool
      subjectBeginsWith: 'string'
      subjectEndsWith: 'string'
    }
    labels: [
      'string'
    ]
    retryPolicy: {
      eventTimeToLiveInMinutes: int
      maxDeliveryAttempts: int
    }
  }
}

Объекты EventSubscriptionDestination

Задайте свойство endpointType , чтобы указать тип объекта.

Для AzureFunction используйте:

{
  endpointType: 'AzureFunction'
  properties: {
    deliveryAttributeMappings: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    maxEventsPerBatch: int
    preferredBatchSizeInKilobytes: int
    resourceId: 'string'
  }
}

Для EventHub используйте:

{
  endpointType: 'EventHub'
  properties: {
    deliveryAttributeMappings: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    resourceId: 'string'
  }
}

Для HybridConnection используйте:

{
  endpointType: 'HybridConnection'
  properties: {
    deliveryAttributeMappings: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    resourceId: 'string'
  }
}

Для MonitorAlert используйте:

{
  endpointType: 'MonitorAlert'
  properties: {
    actionGroups: [
      'string'
    ]
    description: 'string'
    severity: 'string'
  }
}

Для namespaceTopic используйте:

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

Для PartnerDestination используйте:

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

Для ServiceBusQueue используйте:

{
  endpointType: 'ServiceBusQueue'
  properties: {
    deliveryAttributeMappings: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    resourceId: 'string'
  }
}

Для ServiceBusTopic используйте:

{
  endpointType: 'ServiceBusTopic'
  properties: {
    deliveryAttributeMappings: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    resourceId: 'string'
  }
}

Для StorageQueue используйте:

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

Для WebHook используйте:

{
  endpointType: 'WebHook'
  properties: {
    azureActiveDirectoryApplicationIdOrUri: 'string'
    azureActiveDirectoryTenantId: 'string'
    deliveryAttributeMappings: [
      {
        name: 'string'
        type: 'string'
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    endpointUrl: 'string'
    maxEventsPerBatch: int
    minimumTlsVersionAllowed: 'string'
    preferredBatchSizeInKilobytes: int
  }
}

Объекты DeadLetterDestination

Задайте свойство endpointType , чтобы указать тип объекта.

Для StorageBlob используйте:

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

Объекты AdvancedFilter

Задайте свойство 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'
  ]
}

Объекты DeliveryAttributeMapping

Задайте свойство типа , чтобы указать тип объекта.

Для динамическихиспользуйте:

{
  properties: {
    sourceField: 'string'
  }
  type: 'Dynamic'
}

Для статическихиспользуйте:

{
  properties: {
    isSecret: bool
    value: 'string'
  }
  type: 'Static'
}

Значения свойств

Microsoft.EventGrid/eventSubscriptions

Name Description Value
name имя ресурса. строка (обязательно)
properties Свойства подписки на события. EventSubscriptionProperties
scope Используется при создании ресурса в области, отличной от области развертывания. Установите это свойство на символическое имя ресурса, чтобы применить ресурс extension resource.

AdvancedFilter

Name Description Value
key Поле или свойство в событии, на основе которого требуется отфильтровать. string
operatorType Установите значение 'BoolEquals' для типа BoolEqualsAdvancedFilter. Установите значение 'IsNotNull' для типа IsNotNullAdvancedFilter. Установите значение 'IsNullOrUndefined' для типа IsNullOrUndefinedAdvancedFilter. Установите значение 'NumberGreaterThan' для типа NumberGreaterThanAdvancedFilter. Установите значение 'NumberGreaterThanOrEquals' для типа NumberGreaterThanOrEqualsAdvancedFilter. Установите значение 'NumberIn' для типа NumberInAdvancedFilter. Установите значение 'NumberInRange' для типа NumberInRangeAdvancedFilter. Установите значение 'NumberLessThan' для типа NumberLessThanAdvancedFilter. Установите значение 'NumberLessThanOrEquals' для типа NumberLessThanOrEqualsAdvancedFilter. Установите значение 'NumberNotIn' для типа NumberNotInAdvancedFilter. Установите значение 'NumberNotInRange' для типа NumberNotInRangeAdvancedFilter. Установите значение 'StringBeginsWith' для типа StringBeginsWithAdvancedFilter. Установите значение 'StringContains' для типа StringContainsAdvancedFilter. Установите значение 'StringEndsWith' для типа StringEndsWithAdvancedFilter. Установите значение 'StringIn' для типа StringInAdvancedFilter. Установите значение 'StringNotBeginsWith' для типа StringNotBeginsWithAdvancedFilter. Установите значение 'StringNotContains' для типа StringNotContainsAdvancedFilter. Установите значение 'StringNotEndsWith' для типа StringNotEndsWithAdvancedFilter. Установите значение 'StringNotIn' для типа StringNotInAdvancedFilter. 'BoolEquals'
'IsNotNull'
'IsNullOrUndefined'
'NumberGreaterThan'
'NumberGreaterThanOrEquals'
'NumberIn'
'NumberInRange'
'NumberLessThan'
'NumberLessThanOrEquals'
'NumberNotIn'
'NumberNotInRange'
'StringBeginsWith'
'StringContains'
'StringEndsWith'
'StringIn'
'StringNotBeginsWith'
'StringNotContains'
'StringNotEndsWith'
'StringNotIn' (обязательно)

AzureFunctionEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'AzureFunction' (обязательно)
properties Azure Function Свойства назначения подписки на событие. AzureFunctionEventSubscriptionDestinationProperties

AzureFunctionEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
maxEventsPerBatch Максимальное количество событий в пакете. int
preferredBatchSizeInKilobytes Предпочтительный размер пакета в Килобайтах. int
resourceId Идентификатор ресурса Azure, представляющий конечную точку назначения функции Azure для подписки на событие. string

BoolEqualsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'BoolEquals' (обязательно)
value Логическое значение фильтра. bool

DeadLetterDestination

Name Description Value
endpointType Установите значение StorageBlob для типа StorageBlobDeadLetterDestination. 'StorageBlob' (обязательно)

DeadLetterWithResourceIdentity

Name Description Value
deadLetterDestination Сведения о назначении, в котором должны быть доставлены события для подписки на события.
Использует настройку управляемого удостоверения в родительском ресурсе (а именно, теме или домене) для получения маркеров проверки подлинности, используемых во время недоставки.
DeadLetterDestination
identity Удостоверение, используемое при недоставленных событиях. EventSubscriptionIdentity

DeliveryAttributeMapping

Name Description Value
name Имя атрибута доставки или заголовка. string
type Задайте для типа DynamicDeliveryAttributeMapping значение DynamicDeliveryAttributeMapping. Задайте для типа StaticDeliveryAttributeMapping значение StaticDeliveryAttributeMapping. 'Dynamic'
'Статический' (обязательно)

DeliveryWithResourceIdentity

Name Description Value
destination Сведения о назначении, в котором должны быть доставлены события для подписки на события.
Использует настройку управляемого удостоверения в родительском ресурсе (а именно, теме или домене) для получения маркеров проверки подлинности, используемых во время доставки.
EventSubscriptionDestination
identity Удостоверение, используемое при доставке событий. EventSubscriptionIdentity

DynamicDeliveryAttributeMapping

Name Description Value
properties Свойства сопоставления атрибутов динамической доставки. DynamicDeliveryAttributeMappingProperties
type Тип атрибута доставки или имени заголовка. «Динамический» (обязательно)

DynamicDeliveryAttributeMappingProperties

Name Description Value
sourceField Путь JSON в событии, которое содержит значение атрибута. string

EventHubEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. «EventHub» (обязательно)
properties Свойства концентратора событий назначения подписки на события. EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
resourceId Azure Resource Id, представляющий конечную точку назначения Event Hub для подписки на событие. string

EventSubscriptionDestination

Name Description Value
endpointType Установите значение "AzureFunction" для типа AzureFunctionEventSubscriptionDestination. Задайте для типа EventHubEventSubscriptionDestination значение EventHubEventSubscriptionDestination. Установите значение HybridConnection для типа HybridConnectionEventSubscriptionDestination. Установите значение MonitorAlert для типа MonitorAlertEventSubscriptionDestination. Задайте значение NamespaceTopic для типа NamespaceTopicEventSubscriptionDestination. Установите значение "PartnerDestination" для типа PartnerEventSubscriptionDestination. Задайте значение ServiceBusQueue для типа ServiceBusQueueEventSubscriptionDestination. Задайте значение ServiceBusTopic для типа ServiceBusTopicEventSubscriptionDestination. Установите значение StorageQueue для типа StorageQueueEventSubscriptionDestination. Задайте значение WebHook для типа WebHookEventSubscriptionDestination. 'AzureFunction'
'EventHub'
'HybridConnection'
'MonitorAlert'
'NamespaceTopic'
'PartnerDestination'
'ServiceBusQueue'
'ServiceBusTopic'
'StorageQueue'
'WebHook' (обязательно)

EventSubscriptionFilter

Name Description Value
advancedFilters Массив расширенных фильтров, используемых для фильтрации подписок на события. AdvancedFilter[]
enableAdvancedFilteringOnArrays Позволяет вычислять расширенные фильтры по массиву значений вместо ожидания сингулярного значения. bool
includedEventTypes Список применимых типов событий, которые должны быть частью подписки на события. Если требуется подписаться на все типы событий по умолчанию, задайте для параметра IncludedEventTypes значение NULL. string[]
isSubjectCaseSensitive Указывает, являются ли свойства SubjectBeginsWith и SubjectEndsWith фильтра
следует сравнить с учетом регистра.
bool
subjectBeginsWith Необязательная строка для фильтрации событий подписки на основе префикса пути к ресурсу.
Формат этого мероприятия зависит от publisher мероприятия.
Подстановочные знаки не поддерживаются в этом пути.
string
subjectEndsWith Необязательная строка для фильтрации событий подписки на основе суффикса пути к ресурсу.
Подстановочные знаки не поддерживаются в этом пути.
string

EventSubscriptionIdentity

Name Description Value
federatedIdentityCredentialInfo Сведения о федеративных учетных данных удостоверениях (FIC), используемых при доставке ресурсов. FederatedIdentityCredentialInfo
type Тип управляемого удостоверения, используемого. Может быть либо SystemAssigned, либо UserAssigned. 'SystemAssigned'
'UserAssigned'
userAssignedIdentity Удостоверение пользователя, связанное с ресурсом. string

EventSubscriptionProperties

Name Description Value
deadLetterDestination Место назначения недоставленной буквы подписки на событие. Любое событие, которое не может быть доставлено в место назначения, отправляется в место назначения недоставленной буквы.
Использует идентичность Сетка событий Azure для получения токенов аутентификации, используемых во время доставки / мертвого письма.
DeadLetterDestination
deadLetterWithResourceIdentity Место назначения недоставленной буквы подписки на событие. Любое событие, которое не может быть доставлено в место назначения, отправляется в место назначения недоставленной буквы.
Использует настройку управляемого удостоверения в родительском ресурсе (а именно, теме или домене) для получения маркеров проверки подлинности, используемых во время доставки или недоставки.
DeadLetterWithResourceIdentity
deliveryWithResourceIdentity Сведения о назначении, в котором должны быть доставлены события для подписки на события.
Использует настройку управляемого удостоверения в родительском ресурсе (а именно, теме или домене) для получения маркеров проверки подлинности, используемых во время доставки или недоставки.
DeliveryWithResourceIdentity
destination Сведения о назначении, в котором должны быть доставлены события для подписки на события.
Использует идентичность Сетка событий Azure для получения токенов аутентификации, используемых во время доставки / мертвого письма.
EventSubscriptionDestination
eventDeliverySchema Схема доставки событий для подписки на события. 'CloudEventSchemaV1_0'
'CustomInputSchema'
'EventGridSchema'
expirationTimeUtc Срок действия подписки на событие. string
filter Сведения о фильтре для подписки на события. EventSubscriptionFilter
labels Список определяемых пользователем меток. string[]
retryPolicy Политика повторных попыток для событий. Это можно использовать для настройки максимального количества попыток доставки и времени жизни для событий. RetryPolicy

FederatedIdentityCredentialInfo

Name Description Value
federatedClientId Многоарендное приложение Microsoft Entra ID, с которым связан Федеративный идентификатор (FIC). string

Constraints:
Минимальная длина = 36
Максимальная длина = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ (обязательно)

HybridConnectionEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'HybridConnection' (обязательно)
properties Свойства гибридного подключения назначения подписки на событие. HybridConnectionEventSubscriptionDestinationProperties

HybridConnectionEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
resourceId Azure Resource ID гибридного соединения, которое является назначением для подписки на событие. string

IsNotNullAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'IsNotNull' (обязательно)

IsNullOrUndefinedAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'IsNullOrUndefined' (обязательно)

MonitorAlertEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'MonitorAlert' (обязательно)
properties Отслеживайте свойства оповещений назначения подписки на события. MonitorAlertEventSubscriptionDestinationProperties

MonitorAlertEventSubscriptionDestinationProperties

Name Description Value
actionGroups Список идентификаторов ARM групп действий, которые будут активироваться при каждом оповещении, запущенном с помощью этой подписки на событие.
Каждый идентификатор RESOURCE ARM должен соответствовать этому шаблону: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Insights/actionGroups/{ActionGroupName}.
string[]
description Описание, которое будет присоединено к каждому оповещению, запущенному через эту подписку на событие. string
severity Серьезность, которая будет присоединена к каждому оповещению, запущенному через эту подписку на события.
Это поле должно быть предоставлено.
'Sev0'
'Sev1'
'Sev2'
'Sev3'
'Sev4'

NamespaceTopicEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'NamespaceTopic' (обязательно)
properties Свойства раздела пространства имен назначения подписки на события. NamespaceTopicEventSubscriptionDestinationProperties

NamespaceTopicEventSubscriptionDestinationProperties

Name Description Value
resourceId Идентификатор ресурса Azure, который представляет конечную точку назначения Event Grid Namespace Namespace Themspace для подписки на событие.
Это поле необходимо, и ресурс раздела пространства имен уже должен существовать.
Идентификатор RESOURCE ARM должен соответствовать этому шаблону: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.EventGrid/namespaces/{NamespaceName}/topic/{TopicName}.
string

NumberGreaterThanAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberGreaterThan' (обязательно)
value Значение фильтра. int

NumberGreaterThanOrEqualsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberGreaterThanOrEquals' (обязательно)
value Значение фильтра. int

NumberInAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberIn' (обязательно)
values Набор значений фильтра. int[]

NumberInRangeAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberInRange' (обязательно)
values Набор значений фильтра. int[][]

NumberLessThanAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberLessThan' (обязательно)
value Значение фильтра. int

NumberLessThanOrEqualsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberLessThanOrEquals' (обязательно)
value Значение фильтра. int

NumberNotInAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberNotIn' (обязательно)
values Набор значений фильтра. int[]

NumberNotInRangeAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberNotInRange' (обязательно)
values Набор значений фильтра. int[][]

PartnerEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'PartnerDestination' (обязательно)
properties Свойства назначения партнера для назначения подписки на события. PartnerEventSubscriptionDestinationProperties

PartnerEventSubscriptionDestinationProperties

Name Description Value
resourceId Идентификатор ресурса Azure, представляющий конечную точку партнерского назначения подписки на событие. string

RetryPolicy

Name Description Value
eventTimeToLiveInMinutes Время жизни (в минутах) для событий. int
maxDeliveryAttempts Максимальное количество попыток повторных попыток доставки для событий. int

ServiceBusQueueEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'ServiceBusQueue' (обязательно)
properties служебная шина Свойства места подписки на событие. ServiceBusQueueEventSubscriptionDestinationProperties

ServiceBusQueueEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
resourceId Идентификатор ресурса Azure, представляющий конечную точку назначения служебная шина подписки на событие. string

ServiceBusTopicEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'ServiceBusTopic' (обязательно)
properties служебная шина Тематические свойства направления подписки на событие. ServiceBusTopicEventSubscriptionDestinationProperties

ServiceBusTopicEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
resourceId Идентификатор ресурса Azure, представляющий конечную точку назначения темы служебная шина подписки на событие. string

StaticDeliveryAttributeMapping

Name Description Value
properties Свойства сопоставления атрибутов статической доставки. StaticDeliveryAttributeMappingProperties
type Тип атрибута доставки или имени заголовка. 'Статический' (обязательно)

StaticDeliveryAttributeMappingProperties

Name Description Value
isSecret Логический флаг, чтобы определить, содержит ли атрибут конфиденциальную информацию. bool
value Значение атрибута доставки. string

StorageBlobDeadLetterDestination

Name Description Value
endpointType Тип конечной точки для назначения недоставленной буквы 'StorageBlob' (обязательно)
properties Свойства мёртвого назначения, основанного на Storage Blob, StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

Name Description Value
blobContainerName Название контейнера Storage blob, который является местом назначения событий deadletter string
resourceId Идентификатор ресурса Azure аккаунта хранения, который является назначением событий deadletter string

StorageQueueEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'StorageQueue' (обязательно)
properties Storage Queue Свойства назначения подписки на событие. StorageQueueEventSubscriptionDestinationProperties

StorageQueueEventSubscriptionDestinationProperties

Name Description Value
queueMessageTimeToLiveInSeconds Время очереди сообщения Storage достигает секунд. Это значение не может быть нулевым или отрицательным, за исключением использования -1, чтобы указать, что время жизни сообщения бесконечно. int
queueName Название очереди Storage находится под аккаунтом storage, который является получателем подписки на событие. string
resourceId Идентификатор ресурса Azure аккаунта хранения, содержащего очередь, являющуюся получателем подписки на событие. string

StringBeginsWithAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringBeginsWith' (обязательно)
values Набор значений фильтра. string[]

StringContainsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringContains' (обязательно)
values Набор значений фильтра. string[]

StringEndsWithAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringEndsWith' (обязательно)
values Набор значений фильтра. string[]

StringInAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringIn' (обязательно)
values Набор значений фильтра. string[]

StringNotBeginsWithAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringNotBeginsWith' (обязательно)
values Набор значений фильтра. string[]

StringNotContainsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringNotContains' (обязательно)
values Набор значений фильтра. string[]

StringNotEndsWithAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringNotEndsWith' (обязательно)
values Набор значений фильтра. string[]

StringNotInAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringNotIn' (обязательно)
values Набор значений фильтра. string[]

WebHookEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'WebHook' (обязательно)
properties Свойства веб-перехватчика назначения подписки на события. WebHookEventSubscriptionDestinationProperties

WebHookEventSubscriptionDestinationProperties

Name Description Value
azureActiveDirectoryApplicationIdOrUri Microsoft Entra ID Application ID или URI позволяет получить токен доступа, который будет включён в качестве токена носителя в запросах на доставку. string
azureActiveDirectoryTenantId Идентификатор арендатора Microsoft Entra ID позволяет получить токен доступа, который будет включён в качестве токена носителя в запросах на доставку. string
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
endpointUrl URL-адрес, представляющий конечную точку назначения подписки на событие. string

Constraints:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
maxEventsPerBatch Максимальное количество событий в пакете. int
minimumTlsVersionAllowed Минимальная версия TLS, которая должна поддерживаться конечной точкой веб-перехватчика '1.0'
'1.1'
'1.2'
preferredBatchSizeInKilobytes Предпочтительный размер пакета в Килобайтах. int

Примеры использования

Примеры Bicep

Простой пример развертывания подписки на события EventGrid.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-09-01' = {
  name: resourceName
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
    allowBlobPublicAccess: true
    allowCrossTenantReplication: true
    allowSharedKeyAccess: true
    defaultToOAuthAuthentication: false
    encryption: {
      keySource: 'Microsoft.Storage'
      services: {
        queue: {
          keyType: 'Service'
        }
        table: {
          keyType: 'Service'
        }
      }
    }
    isHnsEnabled: false
    isNfsV3Enabled: false
    isSftpEnabled: false
    minimumTlsVersion: 'TLS1_2'
    networkAcls: {
      defaultAction: 'Allow'
    }
    publicNetworkAccess: 'Enabled'
    supportsHttpsTrafficOnly: true
  }
}

resource eventSubscription 'Microsoft.EventGrid/eventSubscriptions@2021-12-01' = {
  name: resourceName
  scope: storageAccount
  properties: {
    destination: {
      endpointType: 'EventHub'
      properties: {
        resourceId: eventhub.id
      }
    }
    eventDeliverySchema: 'EventGridSchema'
    filter: {
      includedEventTypes: [
        'Microsoft.Storage.BlobCreated'
        'Microsoft.Storage.BlobRenamed'
      ]
    }
    labels: []
    retryPolicy: {
      eventTimeToLiveInMinutes: 144
      maxDeliveryAttempts: 10
    }
  }
}

resource namespace 'Microsoft.EventHub/namespaces@2022-01-01-preview' = {
  name: resourceName
  location: location
  sku: {
    capacity: 1
    name: 'Standard'
    tier: 'Standard'
  }
  properties: {
    disableLocalAuth: false
    isAutoInflateEnabled: false
    publicNetworkAccess: 'Enabled'
    zoneRedundant: false
  }
}

resource eventhub 'Microsoft.EventHub/namespaces/eventhubs@2021-11-01' = {
  name: resourceName
  parent: namespace
  properties: {
    messageRetentionInDays: 1
    partitionCount: 1
    status: 'Active'
  }
}

Примеры быстрого запуска Azure

Следующие шаблоны Azure Quickstart содержат Bicep образцов для развертывания этого типа ресурсов.

Bicep-файл Description
Создать Сетка событий Azure пользовательскую подписку на тему и очередь Создаёт пользовательскую тему Сетка событий Azure и подписку на очередь сервисной шины. Шаблон первоначально создан Маркусом Мейером.
Создать Сетка событий Azure пользовательскую тему и подписку Создаёт пользовательскую тему Сетка событий Azure и подписку webhook. Шаблон первоначально создан Джоном Дауном.

Определение ресурса шаблона ARM

Тип ресурса eventSubscriptions можно развернуть с помощью операций, предназначенных для следующих операций:

  • Tenant - См. tenant deployment commandsManagement groups - См. команды развертывания management group deploySubscription - См. команды развертывания подпискиResource groups - См. resource Команды развертывания групп

Для получения списка изменённых свойств в каждой версии API см. журнал изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.EventGrid/eventSubscriptions, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.EventGrid/eventSubscriptions",
  "apiVersion": "2025-07-15-preview",
  "name": "string",
  "properties": {
    "deadLetterDestination": {
      "endpointType": "string"
      // For remaining properties, see DeadLetterDestination objects
    },
    "deadLetterWithResourceIdentity": {
      "deadLetterDestination": {
        "endpointType": "string"
        // For remaining properties, see DeadLetterDestination objects
      },
      "identity": {
        "federatedIdentityCredentialInfo": {
          "federatedClientId": "string"
        },
        "type": "string",
        "userAssignedIdentity": "string"
      }
    },
    "deliveryWithResourceIdentity": {
      "destination": {
        "endpointType": "string"
        // For remaining properties, see EventSubscriptionDestination objects
      },
      "identity": {
        "federatedIdentityCredentialInfo": {
          "federatedClientId": "string"
        },
        "type": "string",
        "userAssignedIdentity": "string"
      }
    },
    "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
      } ],
      "enableAdvancedFilteringOnArrays": "bool",
      "includedEventTypes": [ "string" ],
      "isSubjectCaseSensitive": "bool",
      "subjectBeginsWith": "string",
      "subjectEndsWith": "string"
    },
    "labels": [ "string" ],
    "retryPolicy": {
      "eventTimeToLiveInMinutes": "int",
      "maxDeliveryAttempts": "int"
    }
  }
}

Объекты EventSubscriptionDestination

Задайте свойство endpointType , чтобы указать тип объекта.

Для AzureFunction используйте:

{
  "endpointType": "AzureFunction",
  "properties": {
    "deliveryAttributeMappings": [ {
      "name": "string",
      "type": "string"
      // For remaining properties, see DeliveryAttributeMapping objects
    } ],
    "maxEventsPerBatch": "int",
    "preferredBatchSizeInKilobytes": "int",
    "resourceId": "string"
  }
}

Для EventHub используйте:

{
  "endpointType": "EventHub",
  "properties": {
    "deliveryAttributeMappings": [ {
      "name": "string",
      "type": "string"
      // For remaining properties, see DeliveryAttributeMapping objects
    } ],
    "resourceId": "string"
  }
}

Для HybridConnection используйте:

{
  "endpointType": "HybridConnection",
  "properties": {
    "deliveryAttributeMappings": [ {
      "name": "string",
      "type": "string"
      // For remaining properties, see DeliveryAttributeMapping objects
    } ],
    "resourceId": "string"
  }
}

Для MonitorAlert используйте:

{
  "endpointType": "MonitorAlert",
  "properties": {
    "actionGroups": [ "string" ],
    "description": "string",
    "severity": "string"
  }
}

Для namespaceTopic используйте:

{
  "endpointType": "NamespaceTopic",
  "properties": {
    "resourceId": "string"
  }
}

Для PartnerDestination используйте:

{
  "endpointType": "PartnerDestination",
  "properties": {
    "resourceId": "string"
  }
}

Для ServiceBusQueue используйте:

{
  "endpointType": "ServiceBusQueue",
  "properties": {
    "deliveryAttributeMappings": [ {
      "name": "string",
      "type": "string"
      // For remaining properties, see DeliveryAttributeMapping objects
    } ],
    "resourceId": "string"
  }
}

Для ServiceBusTopic используйте:

{
  "endpointType": "ServiceBusTopic",
  "properties": {
    "deliveryAttributeMappings": [ {
      "name": "string",
      "type": "string"
      // For remaining properties, see DeliveryAttributeMapping objects
    } ],
    "resourceId": "string"
  }
}

Для StorageQueue используйте:

{
  "endpointType": "StorageQueue",
  "properties": {
    "queueMessageTimeToLiveInSeconds": "int",
    "queueName": "string",
    "resourceId": "string"
  }
}

Для WebHook используйте:

{
  "endpointType": "WebHook",
  "properties": {
    "azureActiveDirectoryApplicationIdOrUri": "string",
    "azureActiveDirectoryTenantId": "string",
    "deliveryAttributeMappings": [ {
      "name": "string",
      "type": "string"
      // For remaining properties, see DeliveryAttributeMapping objects
    } ],
    "endpointUrl": "string",
    "maxEventsPerBatch": "int",
    "minimumTlsVersionAllowed": "string",
    "preferredBatchSizeInKilobytes": "int"
  }
}

Объекты DeadLetterDestination

Задайте свойство endpointType , чтобы указать тип объекта.

Для StorageBlob используйте:

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

Объекты AdvancedFilter

Задайте свойство 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" ]
}

Объекты DeliveryAttributeMapping

Задайте свойство типа , чтобы указать тип объекта.

Для динамическихиспользуйте:

{
  "properties": {
    "sourceField": "string"
  },
  "type": "Dynamic"
}

Для статическихиспользуйте:

{
  "properties": {
    "isSecret": "bool",
    "value": "string"
  },
  "type": "Static"
}

Значения свойств

Microsoft.EventGrid/eventSubscriptions

Name Description Value
apiVersion Версия API «2025-07-15-превью»
name имя ресурса. строка (обязательно)
properties Свойства подписки на события. EventSubscriptionProperties
type Тип ресурса 'Microsoft.EventGrid/eventSubscriptions'

AdvancedFilter

Name Description Value
key Поле или свойство в событии, на основе которого требуется отфильтровать. string
operatorType Установите значение 'BoolEquals' для типа BoolEqualsAdvancedFilter. Установите значение 'IsNotNull' для типа IsNotNullAdvancedFilter. Установите значение 'IsNullOrUndefined' для типа IsNullOrUndefinedAdvancedFilter. Установите значение 'NumberGreaterThan' для типа NumberGreaterThanAdvancedFilter. Установите значение 'NumberGreaterThanOrEquals' для типа NumberGreaterThanOrEqualsAdvancedFilter. Установите значение 'NumberIn' для типа NumberInAdvancedFilter. Установите значение 'NumberInRange' для типа NumberInRangeAdvancedFilter. Установите значение 'NumberLessThan' для типа NumberLessThanAdvancedFilter. Установите значение 'NumberLessThanOrEquals' для типа NumberLessThanOrEqualsAdvancedFilter. Установите значение 'NumberNotIn' для типа NumberNotInAdvancedFilter. Установите значение 'NumberNotInRange' для типа NumberNotInRangeAdvancedFilter. Установите значение 'StringBeginsWith' для типа StringBeginsWithAdvancedFilter. Установите значение 'StringContains' для типа StringContainsAdvancedFilter. Установите значение 'StringEndsWith' для типа StringEndsWithAdvancedFilter. Установите значение 'StringIn' для типа StringInAdvancedFilter. Установите значение 'StringNotBeginsWith' для типа StringNotBeginsWithAdvancedFilter. Установите значение 'StringNotContains' для типа StringNotContainsAdvancedFilter. Установите значение 'StringNotEndsWith' для типа StringNotEndsWithAdvancedFilter. Установите значение 'StringNotIn' для типа StringNotInAdvancedFilter. 'BoolEquals'
'IsNotNull'
'IsNullOrUndefined'
'NumberGreaterThan'
'NumberGreaterThanOrEquals'
'NumberIn'
'NumberInRange'
'NumberLessThan'
'NumberLessThanOrEquals'
'NumberNotIn'
'NumberNotInRange'
'StringBeginsWith'
'StringContains'
'StringEndsWith'
'StringIn'
'StringNotBeginsWith'
'StringNotContains'
'StringNotEndsWith'
'StringNotIn' (обязательно)

AzureFunctionEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'AzureFunction' (обязательно)
properties Azure Function Свойства назначения подписки на событие. AzureFunctionEventSubscriptionDestinationProperties

AzureFunctionEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
maxEventsPerBatch Максимальное количество событий в пакете. int
preferredBatchSizeInKilobytes Предпочтительный размер пакета в Килобайтах. int
resourceId Идентификатор ресурса Azure, представляющий конечную точку назначения функции Azure для подписки на событие. string

BoolEqualsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'BoolEquals' (обязательно)
value Логическое значение фильтра. bool

DeadLetterDestination

Name Description Value
endpointType Установите значение StorageBlob для типа StorageBlobDeadLetterDestination. 'StorageBlob' (обязательно)

DeadLetterWithResourceIdentity

Name Description Value
deadLetterDestination Сведения о назначении, в котором должны быть доставлены события для подписки на события.
Использует настройку управляемого удостоверения в родительском ресурсе (а именно, теме или домене) для получения маркеров проверки подлинности, используемых во время недоставки.
DeadLetterDestination
identity Удостоверение, используемое при недоставленных событиях. EventSubscriptionIdentity

DeliveryAttributeMapping

Name Description Value
name Имя атрибута доставки или заголовка. string
type Задайте для типа DynamicDeliveryAttributeMapping значение DynamicDeliveryAttributeMapping. Задайте для типа StaticDeliveryAttributeMapping значение StaticDeliveryAttributeMapping. 'Dynamic'
'Статический' (обязательно)

DeliveryWithResourceIdentity

Name Description Value
destination Сведения о назначении, в котором должны быть доставлены события для подписки на события.
Использует настройку управляемого удостоверения в родительском ресурсе (а именно, теме или домене) для получения маркеров проверки подлинности, используемых во время доставки.
EventSubscriptionDestination
identity Удостоверение, используемое при доставке событий. EventSubscriptionIdentity

DynamicDeliveryAttributeMapping

Name Description Value
properties Свойства сопоставления атрибутов динамической доставки. DynamicDeliveryAttributeMappingProperties
type Тип атрибута доставки или имени заголовка. «Динамический» (обязательно)

DynamicDeliveryAttributeMappingProperties

Name Description Value
sourceField Путь JSON в событии, которое содержит значение атрибута. string

EventHubEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. «EventHub» (обязательно)
properties Свойства концентратора событий назначения подписки на события. EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
resourceId Azure Resource Id, представляющий конечную точку назначения Event Hub для подписки на событие. string

EventSubscriptionDestination

Name Description Value
endpointType Установите значение "AzureFunction" для типа AzureFunctionEventSubscriptionDestination. Задайте для типа EventHubEventSubscriptionDestination значение EventHubEventSubscriptionDestination. Установите значение HybridConnection для типа HybridConnectionEventSubscriptionDestination. Установите значение MonitorAlert для типа MonitorAlertEventSubscriptionDestination. Задайте значение NamespaceTopic для типа NamespaceTopicEventSubscriptionDestination. Установите значение "PartnerDestination" для типа PartnerEventSubscriptionDestination. Задайте значение ServiceBusQueue для типа ServiceBusQueueEventSubscriptionDestination. Задайте значение ServiceBusTopic для типа ServiceBusTopicEventSubscriptionDestination. Установите значение StorageQueue для типа StorageQueueEventSubscriptionDestination. Задайте значение WebHook для типа WebHookEventSubscriptionDestination. 'AzureFunction'
'EventHub'
'HybridConnection'
'MonitorAlert'
'NamespaceTopic'
'PartnerDestination'
'ServiceBusQueue'
'ServiceBusTopic'
'StorageQueue'
'WebHook' (обязательно)

EventSubscriptionFilter

Name Description Value
advancedFilters Массив расширенных фильтров, используемых для фильтрации подписок на события. AdvancedFilter[]
enableAdvancedFilteringOnArrays Позволяет вычислять расширенные фильтры по массиву значений вместо ожидания сингулярного значения. bool
includedEventTypes Список применимых типов событий, которые должны быть частью подписки на события. Если требуется подписаться на все типы событий по умолчанию, задайте для параметра IncludedEventTypes значение NULL. string[]
isSubjectCaseSensitive Указывает, являются ли свойства SubjectBeginsWith и SubjectEndsWith фильтра
следует сравнить с учетом регистра.
bool
subjectBeginsWith Необязательная строка для фильтрации событий подписки на основе префикса пути к ресурсу.
Формат этого мероприятия зависит от publisher мероприятия.
Подстановочные знаки не поддерживаются в этом пути.
string
subjectEndsWith Необязательная строка для фильтрации событий подписки на основе суффикса пути к ресурсу.
Подстановочные знаки не поддерживаются в этом пути.
string

EventSubscriptionIdentity

Name Description Value
federatedIdentityCredentialInfo Сведения о федеративных учетных данных удостоверениях (FIC), используемых при доставке ресурсов. FederatedIdentityCredentialInfo
type Тип управляемого удостоверения, используемого. Может быть либо SystemAssigned, либо UserAssigned. 'SystemAssigned'
'UserAssigned'
userAssignedIdentity Удостоверение пользователя, связанное с ресурсом. string

EventSubscriptionProperties

Name Description Value
deadLetterDestination Место назначения недоставленной буквы подписки на событие. Любое событие, которое не может быть доставлено в место назначения, отправляется в место назначения недоставленной буквы.
Использует идентичность Сетка событий Azure для получения токенов аутентификации, используемых во время доставки / мертвого письма.
DeadLetterDestination
deadLetterWithResourceIdentity Место назначения недоставленной буквы подписки на событие. Любое событие, которое не может быть доставлено в место назначения, отправляется в место назначения недоставленной буквы.
Использует настройку управляемого удостоверения в родительском ресурсе (а именно, теме или домене) для получения маркеров проверки подлинности, используемых во время доставки или недоставки.
DeadLetterWithResourceIdentity
deliveryWithResourceIdentity Сведения о назначении, в котором должны быть доставлены события для подписки на события.
Использует настройку управляемого удостоверения в родительском ресурсе (а именно, теме или домене) для получения маркеров проверки подлинности, используемых во время доставки или недоставки.
DeliveryWithResourceIdentity
destination Сведения о назначении, в котором должны быть доставлены события для подписки на события.
Использует идентичность Сетка событий Azure для получения токенов аутентификации, используемых во время доставки / мертвого письма.
EventSubscriptionDestination
eventDeliverySchema Схема доставки событий для подписки на события. 'CloudEventSchemaV1_0'
'CustomInputSchema'
'EventGridSchema'
expirationTimeUtc Срок действия подписки на событие. string
filter Сведения о фильтре для подписки на события. EventSubscriptionFilter
labels Список определяемых пользователем меток. string[]
retryPolicy Политика повторных попыток для событий. Это можно использовать для настройки максимального количества попыток доставки и времени жизни для событий. RetryPolicy

FederatedIdentityCredentialInfo

Name Description Value
federatedClientId Многоарендное приложение Microsoft Entra ID, с которым связан Федеративный идентификатор (FIC). string

Constraints:
Минимальная длина = 36
Максимальная длина = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ (обязательно)

HybridConnectionEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'HybridConnection' (обязательно)
properties Свойства гибридного подключения назначения подписки на событие. HybridConnectionEventSubscriptionDestinationProperties

HybridConnectionEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
resourceId Azure Resource ID гибридного соединения, которое является назначением для подписки на событие. string

IsNotNullAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'IsNotNull' (обязательно)

IsNullOrUndefinedAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'IsNullOrUndefined' (обязательно)

MonitorAlertEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'MonitorAlert' (обязательно)
properties Отслеживайте свойства оповещений назначения подписки на события. MonitorAlertEventSubscriptionDestinationProperties

MonitorAlertEventSubscriptionDestinationProperties

Name Description Value
actionGroups Список идентификаторов ARM групп действий, которые будут активироваться при каждом оповещении, запущенном с помощью этой подписки на событие.
Каждый идентификатор RESOURCE ARM должен соответствовать этому шаблону: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Insights/actionGroups/{ActionGroupName}.
string[]
description Описание, которое будет присоединено к каждому оповещению, запущенному через эту подписку на событие. string
severity Серьезность, которая будет присоединена к каждому оповещению, запущенному через эту подписку на события.
Это поле должно быть предоставлено.
'Sev0'
'Sev1'
'Sev2'
'Sev3'
'Sev4'

NamespaceTopicEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'NamespaceTopic' (обязательно)
properties Свойства раздела пространства имен назначения подписки на события. NamespaceTopicEventSubscriptionDestinationProperties

NamespaceTopicEventSubscriptionDestinationProperties

Name Description Value
resourceId Идентификатор ресурса Azure, который представляет конечную точку назначения Event Grid Namespace Namespace Themspace для подписки на событие.
Это поле необходимо, и ресурс раздела пространства имен уже должен существовать.
Идентификатор RESOURCE ARM должен соответствовать этому шаблону: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.EventGrid/namespaces/{NamespaceName}/topic/{TopicName}.
string

NumberGreaterThanAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberGreaterThan' (обязательно)
value Значение фильтра. int

NumberGreaterThanOrEqualsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberGreaterThanOrEquals' (обязательно)
value Значение фильтра. int

NumberInAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberIn' (обязательно)
values Набор значений фильтра. int[]

NumberInRangeAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberInRange' (обязательно)
values Набор значений фильтра. int[][]

NumberLessThanAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberLessThan' (обязательно)
value Значение фильтра. int

NumberLessThanOrEqualsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberLessThanOrEquals' (обязательно)
value Значение фильтра. int

NumberNotInAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberNotIn' (обязательно)
values Набор значений фильтра. int[]

NumberNotInRangeAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberNotInRange' (обязательно)
values Набор значений фильтра. int[][]

PartnerEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'PartnerDestination' (обязательно)
properties Свойства назначения партнера для назначения подписки на события. PartnerEventSubscriptionDestinationProperties

PartnerEventSubscriptionDestinationProperties

Name Description Value
resourceId Идентификатор ресурса Azure, представляющий конечную точку партнерского назначения подписки на событие. string

RetryPolicy

Name Description Value
eventTimeToLiveInMinutes Время жизни (в минутах) для событий. int
maxDeliveryAttempts Максимальное количество попыток повторных попыток доставки для событий. int

ServiceBusQueueEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'ServiceBusQueue' (обязательно)
properties служебная шина Свойства места подписки на событие. ServiceBusQueueEventSubscriptionDestinationProperties

ServiceBusQueueEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
resourceId Идентификатор ресурса Azure, представляющий конечную точку назначения служебная шина подписки на событие. string

ServiceBusTopicEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'ServiceBusTopic' (обязательно)
properties служебная шина Тематические свойства направления подписки на событие. ServiceBusTopicEventSubscriptionDestinationProperties

ServiceBusTopicEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
resourceId Идентификатор ресурса Azure, представляющий конечную точку назначения темы служебная шина подписки на событие. string

StaticDeliveryAttributeMapping

Name Description Value
properties Свойства сопоставления атрибутов статической доставки. StaticDeliveryAttributeMappingProperties
type Тип атрибута доставки или имени заголовка. 'Статический' (обязательно)

StaticDeliveryAttributeMappingProperties

Name Description Value
isSecret Логический флаг, чтобы определить, содержит ли атрибут конфиденциальную информацию. bool
value Значение атрибута доставки. string

StorageBlobDeadLetterDestination

Name Description Value
endpointType Тип конечной точки для назначения недоставленной буквы 'StorageBlob' (обязательно)
properties Свойства мёртвого назначения, основанного на Storage Blob, StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

Name Description Value
blobContainerName Название контейнера Storage blob, который является местом назначения событий deadletter string
resourceId Идентификатор ресурса Azure аккаунта хранения, который является назначением событий deadletter string

StorageQueueEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'StorageQueue' (обязательно)
properties Storage Queue Свойства назначения подписки на событие. StorageQueueEventSubscriptionDestinationProperties

StorageQueueEventSubscriptionDestinationProperties

Name Description Value
queueMessageTimeToLiveInSeconds Время очереди сообщения Storage достигает секунд. Это значение не может быть нулевым или отрицательным, за исключением использования -1, чтобы указать, что время жизни сообщения бесконечно. int
queueName Название очереди Storage находится под аккаунтом storage, который является получателем подписки на событие. string
resourceId Идентификатор ресурса Azure аккаунта хранения, содержащего очередь, являющуюся получателем подписки на событие. string

StringBeginsWithAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringBeginsWith' (обязательно)
values Набор значений фильтра. string[]

StringContainsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringContains' (обязательно)
values Набор значений фильтра. string[]

StringEndsWithAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringEndsWith' (обязательно)
values Набор значений фильтра. string[]

StringInAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringIn' (обязательно)
values Набор значений фильтра. string[]

StringNotBeginsWithAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringNotBeginsWith' (обязательно)
values Набор значений фильтра. string[]

StringNotContainsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringNotContains' (обязательно)
values Набор значений фильтра. string[]

StringNotEndsWithAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringNotEndsWith' (обязательно)
values Набор значений фильтра. string[]

StringNotInAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringNotIn' (обязательно)
values Набор значений фильтра. string[]

WebHookEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'WebHook' (обязательно)
properties Свойства веб-перехватчика назначения подписки на события. WebHookEventSubscriptionDestinationProperties

WebHookEventSubscriptionDestinationProperties

Name Description Value
azureActiveDirectoryApplicationIdOrUri Microsoft Entra ID Application ID или URI позволяет получить токен доступа, который будет включён в качестве токена носителя в запросах на доставку. string
azureActiveDirectoryTenantId Идентификатор арендатора Microsoft Entra ID позволяет получить токен доступа, который будет включён в качестве токена носителя в запросах на доставку. string
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
endpointUrl URL-адрес, представляющий конечную точку назначения подписки на событие. string

Constraints:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
maxEventsPerBatch Максимальное количество событий в пакете. int
minimumTlsVersionAllowed Минимальная версия TLS, которая должна поддерживаться конечной точкой веб-перехватчика '1.0'
'1.1'
'1.2'
preferredBatchSizeInKilobytes Предпочтительный размер пакета в Килобайтах. int

Примеры использования

Шаблоны быстрого запуска Azure

Следующие Azure шаблоны быстрого запуска развёртают этот тип ресурса.

Template Description
Создать Сетка событий Azure пользовательскую подписку на тему и очередь

Развернуться на Azure
Создаёт пользовательскую тему Сетка событий Azure и подписку на очередь сервисной шины. Шаблон первоначально создан Маркусом Мейером.
Создать Сетка событий Azure пользовательскую тему и подписку

Развернуться на Azure
Создаёт пользовательскую тему Сетка событий Azure и подписку webhook. Шаблон первоначально создан Джоном Дауном.
создание настраиваемой подписки сетки событий Azure

Развернуться на Azure
Создает пользовательскую тему Сетка событий Azure и подписку на тему сервисной шины. Шаблон первоначально создан Маркусом Мейером.
Create Event Grid — пользовательский обработчик тем и хаб событий

Развернуться на Azure
Создаёт пользовательский тематический и event hub Сетка событий Azure для обработки событий.
Create Event Grid подписка для событий ресурсов

Развернуться на Azure
Создаёт подписку Event Grid либо на группу ресурсов, либо на подписку Azure.
Пользовательская тема/подписка Сетка событий Azure с CloudEvents

Развернуться на Azure
Создаёт пользовательскую тему Сетка событий Azure, подписку webhook со схемой CloudEvents и логическое приложение в качестве обработчика событий. Шаблон первоначально создан ДжастинОм Yoo.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса eventSubscriptions можно развернуть с помощью операций, предназначенных для следующих операций:

  • Арендатор* Управленческие группы* Подписка* Группы ресурсов

Для получения списка изменённых свойств в каждой версии API см. журнал изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.EventGrid/eventSubscriptions, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/eventSubscriptions@2025-07-15-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      deadLetterDestination = {
        endpointType = "string"
        // For remaining properties, see DeadLetterDestination objects
      }
      deadLetterWithResourceIdentity = {
        deadLetterDestination = {
          endpointType = "string"
          // For remaining properties, see DeadLetterDestination objects
        }
        identity = {
          federatedIdentityCredentialInfo = {
            federatedClientId = "string"
          }
          type = "string"
          userAssignedIdentity = "string"
        }
      }
      deliveryWithResourceIdentity = {
        destination = {
          endpointType = "string"
          // For remaining properties, see EventSubscriptionDestination objects
        }
        identity = {
          federatedIdentityCredentialInfo = {
            federatedClientId = "string"
          }
          type = "string"
          userAssignedIdentity = "string"
        }
      }
      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
          }
        ]
        enableAdvancedFilteringOnArrays = bool
        includedEventTypes = [
          "string"
        ]
        isSubjectCaseSensitive = bool
        subjectBeginsWith = "string"
        subjectEndsWith = "string"
      }
      labels = [
        "string"
      ]
      retryPolicy = {
        eventTimeToLiveInMinutes = int
        maxDeliveryAttempts = int
      }
    }
  }
}

Объекты EventSubscriptionDestination

Задайте свойство endpointType , чтобы указать тип объекта.

Для AzureFunction используйте:

{
  endpointType = "AzureFunction"
  properties = {
    deliveryAttributeMappings = [
      {
        name = "string"
        type = "string"
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    maxEventsPerBatch = int
    preferredBatchSizeInKilobytes = int
    resourceId = "string"
  }
}

Для EventHub используйте:

{
  endpointType = "EventHub"
  properties = {
    deliveryAttributeMappings = [
      {
        name = "string"
        type = "string"
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    resourceId = "string"
  }
}

Для HybridConnection используйте:

{
  endpointType = "HybridConnection"
  properties = {
    deliveryAttributeMappings = [
      {
        name = "string"
        type = "string"
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    resourceId = "string"
  }
}

Для MonitorAlert используйте:

{
  endpointType = "MonitorAlert"
  properties = {
    actionGroups = [
      "string"
    ]
    description = "string"
    severity = "string"
  }
}

Для namespaceTopic используйте:

{
  endpointType = "NamespaceTopic"
  properties = {
    resourceId = "string"
  }
}

Для PartnerDestination используйте:

{
  endpointType = "PartnerDestination"
  properties = {
    resourceId = "string"
  }
}

Для ServiceBusQueue используйте:

{
  endpointType = "ServiceBusQueue"
  properties = {
    deliveryAttributeMappings = [
      {
        name = "string"
        type = "string"
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    resourceId = "string"
  }
}

Для ServiceBusTopic используйте:

{
  endpointType = "ServiceBusTopic"
  properties = {
    deliveryAttributeMappings = [
      {
        name = "string"
        type = "string"
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    resourceId = "string"
  }
}

Для StorageQueue используйте:

{
  endpointType = "StorageQueue"
  properties = {
    queueMessageTimeToLiveInSeconds = int
    queueName = "string"
    resourceId = "string"
  }
}

Для WebHook используйте:

{
  endpointType = "WebHook"
  properties = {
    azureActiveDirectoryApplicationIdOrUri = "string"
    azureActiveDirectoryTenantId = "string"
    deliveryAttributeMappings = [
      {
        name = "string"
        type = "string"
        // For remaining properties, see DeliveryAttributeMapping objects
      }
    ]
    endpointUrl = "string"
    maxEventsPerBatch = int
    minimumTlsVersionAllowed = "string"
    preferredBatchSizeInKilobytes = int
  }
}

Объекты DeadLetterDestination

Задайте свойство endpointType , чтобы указать тип объекта.

Для StorageBlob используйте:

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

Объекты AdvancedFilter

Задайте свойство 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"
  ]
}

Объекты DeliveryAttributeMapping

Задайте свойство типа , чтобы указать тип объекта.

Для динамическихиспользуйте:

{
  properties = {
    sourceField = "string"
  }
  type = "Dynamic"
}

Для статическихиспользуйте:

{
  properties = {
    isSecret = bool
    value = "string"
  }
  type = "Static"
}

Значения свойств

Microsoft.EventGrid/eventSubscriptions

Name Description Value
name имя ресурса. строка (обязательно)
parent_id Идентификатор ресурса для применения этого ресурса расширения. строка (обязательно)
properties Свойства подписки на события. EventSubscriptionProperties
type Тип ресурса "Microsoft.EventGrid/eventSubscriptions@2025-07-15-preview"

AdvancedFilter

Name Description Value
key Поле или свойство в событии, на основе которого требуется отфильтровать. string
operatorType Установите значение 'BoolEquals' для типа BoolEqualsAdvancedFilter. Установите значение 'IsNotNull' для типа IsNotNullAdvancedFilter. Установите значение 'IsNullOrUndefined' для типа IsNullOrUndefinedAdvancedFilter. Установите значение 'NumberGreaterThan' для типа NumberGreaterThanAdvancedFilter. Установите значение 'NumberGreaterThanOrEquals' для типа NumberGreaterThanOrEqualsAdvancedFilter. Установите значение 'NumberIn' для типа NumberInAdvancedFilter. Установите значение 'NumberInRange' для типа NumberInRangeAdvancedFilter. Установите значение 'NumberLessThan' для типа NumberLessThanAdvancedFilter. Установите значение 'NumberLessThanOrEquals' для типа NumberLessThanOrEqualsAdvancedFilter. Установите значение 'NumberNotIn' для типа NumberNotInAdvancedFilter. Установите значение 'NumberNotInRange' для типа NumberNotInRangeAdvancedFilter. Установите значение 'StringBeginsWith' для типа StringBeginsWithAdvancedFilter. Установите значение 'StringContains' для типа StringContainsAdvancedFilter. Установите значение 'StringEndsWith' для типа StringEndsWithAdvancedFilter. Установите значение 'StringIn' для типа StringInAdvancedFilter. Установите значение 'StringNotBeginsWith' для типа StringNotBeginsWithAdvancedFilter. Установите значение 'StringNotContains' для типа StringNotContainsAdvancedFilter. Установите значение 'StringNotEndsWith' для типа StringNotEndsWithAdvancedFilter. Установите значение 'StringNotIn' для типа StringNotInAdvancedFilter. 'BoolEquals'
'IsNotNull'
'IsNullOrUndefined'
'NumberGreaterThan'
'NumberGreaterThanOrEquals'
'NumberIn'
'NumberInRange'
'NumberLessThan'
'NumberLessThanOrEquals'
'NumberNotIn'
'NumberNotInRange'
'StringBeginsWith'
'StringContains'
'StringEndsWith'
'StringIn'
'StringNotBeginsWith'
'StringNotContains'
'StringNotEndsWith'
'StringNotIn' (обязательно)

AzureFunctionEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'AzureFunction' (обязательно)
properties Azure Function Свойства назначения подписки на событие. AzureFunctionEventSubscriptionDestinationProperties

AzureFunctionEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
maxEventsPerBatch Максимальное количество событий в пакете. int
preferredBatchSizeInKilobytes Предпочтительный размер пакета в Килобайтах. int
resourceId Идентификатор ресурса Azure, представляющий конечную точку назначения функции Azure для подписки на событие. string

BoolEqualsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'BoolEquals' (обязательно)
value Логическое значение фильтра. bool

DeadLetterDestination

Name Description Value
endpointType Установите значение StorageBlob для типа StorageBlobDeadLetterDestination. 'StorageBlob' (обязательно)

DeadLetterWithResourceIdentity

Name Description Value
deadLetterDestination Сведения о назначении, в котором должны быть доставлены события для подписки на события.
Использует настройку управляемого удостоверения в родительском ресурсе (а именно, теме или домене) для получения маркеров проверки подлинности, используемых во время недоставки.
DeadLetterDestination
identity Удостоверение, используемое при недоставленных событиях. EventSubscriptionIdentity

DeliveryAttributeMapping

Name Description Value
name Имя атрибута доставки или заголовка. string
type Задайте для типа DynamicDeliveryAttributeMapping значение DynamicDeliveryAttributeMapping. Задайте для типа StaticDeliveryAttributeMapping значение StaticDeliveryAttributeMapping. 'Dynamic'
'Статический' (обязательно)

DeliveryWithResourceIdentity

Name Description Value
destination Сведения о назначении, в котором должны быть доставлены события для подписки на события.
Использует настройку управляемого удостоверения в родительском ресурсе (а именно, теме или домене) для получения маркеров проверки подлинности, используемых во время доставки.
EventSubscriptionDestination
identity Удостоверение, используемое при доставке событий. EventSubscriptionIdentity

DynamicDeliveryAttributeMapping

Name Description Value
properties Свойства сопоставления атрибутов динамической доставки. DynamicDeliveryAttributeMappingProperties
type Тип атрибута доставки или имени заголовка. «Динамический» (обязательно)

DynamicDeliveryAttributeMappingProperties

Name Description Value
sourceField Путь JSON в событии, которое содержит значение атрибута. string

EventHubEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. «EventHub» (обязательно)
properties Свойства концентратора событий назначения подписки на события. EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
resourceId Azure Resource Id, представляющий конечную точку назначения Event Hub для подписки на событие. string

EventSubscriptionDestination

Name Description Value
endpointType Установите значение "AzureFunction" для типа AzureFunctionEventSubscriptionDestination. Задайте для типа EventHubEventSubscriptionDestination значение EventHubEventSubscriptionDestination. Установите значение HybridConnection для типа HybridConnectionEventSubscriptionDestination. Установите значение MonitorAlert для типа MonitorAlertEventSubscriptionDestination. Задайте значение NamespaceTopic для типа NamespaceTopicEventSubscriptionDestination. Установите значение "PartnerDestination" для типа PartnerEventSubscriptionDestination. Задайте значение ServiceBusQueue для типа ServiceBusQueueEventSubscriptionDestination. Задайте значение ServiceBusTopic для типа ServiceBusTopicEventSubscriptionDestination. Установите значение StorageQueue для типа StorageQueueEventSubscriptionDestination. Задайте значение WebHook для типа WebHookEventSubscriptionDestination. 'AzureFunction'
'EventHub'
'HybridConnection'
'MonitorAlert'
'NamespaceTopic'
'PartnerDestination'
'ServiceBusQueue'
'ServiceBusTopic'
'StorageQueue'
'WebHook' (обязательно)

EventSubscriptionFilter

Name Description Value
advancedFilters Массив расширенных фильтров, используемых для фильтрации подписок на события. AdvancedFilter[]
enableAdvancedFilteringOnArrays Позволяет вычислять расширенные фильтры по массиву значений вместо ожидания сингулярного значения. bool
includedEventTypes Список применимых типов событий, которые должны быть частью подписки на события. Если требуется подписаться на все типы событий по умолчанию, задайте для параметра IncludedEventTypes значение NULL. string[]
isSubjectCaseSensitive Указывает, являются ли свойства SubjectBeginsWith и SubjectEndsWith фильтра
следует сравнить с учетом регистра.
bool
subjectBeginsWith Необязательная строка для фильтрации событий подписки на основе префикса пути к ресурсу.
Формат этого мероприятия зависит от publisher мероприятия.
Подстановочные знаки не поддерживаются в этом пути.
string
subjectEndsWith Необязательная строка для фильтрации событий подписки на основе суффикса пути к ресурсу.
Подстановочные знаки не поддерживаются в этом пути.
string

EventSubscriptionIdentity

Name Description Value
federatedIdentityCredentialInfo Сведения о федеративных учетных данных удостоверениях (FIC), используемых при доставке ресурсов. FederatedIdentityCredentialInfo
type Тип управляемого удостоверения, используемого. Может быть либо SystemAssigned, либо UserAssigned. 'SystemAssigned'
'UserAssigned'
userAssignedIdentity Удостоверение пользователя, связанное с ресурсом. string

EventSubscriptionProperties

Name Description Value
deadLetterDestination Место назначения недоставленной буквы подписки на событие. Любое событие, которое не может быть доставлено в место назначения, отправляется в место назначения недоставленной буквы.
Использует идентичность Сетка событий Azure для получения токенов аутентификации, используемых во время доставки / мертвого письма.
DeadLetterDestination
deadLetterWithResourceIdentity Место назначения недоставленной буквы подписки на событие. Любое событие, которое не может быть доставлено в место назначения, отправляется в место назначения недоставленной буквы.
Использует настройку управляемого удостоверения в родительском ресурсе (а именно, теме или домене) для получения маркеров проверки подлинности, используемых во время доставки или недоставки.
DeadLetterWithResourceIdentity
deliveryWithResourceIdentity Сведения о назначении, в котором должны быть доставлены события для подписки на события.
Использует настройку управляемого удостоверения в родительском ресурсе (а именно, теме или домене) для получения маркеров проверки подлинности, используемых во время доставки или недоставки.
DeliveryWithResourceIdentity
destination Сведения о назначении, в котором должны быть доставлены события для подписки на события.
Использует идентичность Сетка событий Azure для получения токенов аутентификации, используемых во время доставки / мертвого письма.
EventSubscriptionDestination
eventDeliverySchema Схема доставки событий для подписки на события. 'CloudEventSchemaV1_0'
'CustomInputSchema'
'EventGridSchema'
expirationTimeUtc Срок действия подписки на событие. string
filter Сведения о фильтре для подписки на события. EventSubscriptionFilter
labels Список определяемых пользователем меток. string[]
retryPolicy Политика повторных попыток для событий. Это можно использовать для настройки максимального количества попыток доставки и времени жизни для событий. RetryPolicy

FederatedIdentityCredentialInfo

Name Description Value
federatedClientId Многоарендное приложение Microsoft Entra ID, с которым связан Федеративный идентификатор (FIC). string

Constraints:
Минимальная длина = 36
Максимальная длина = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ (обязательно)

HybridConnectionEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'HybridConnection' (обязательно)
properties Свойства гибридного подключения назначения подписки на событие. HybridConnectionEventSubscriptionDestinationProperties

HybridConnectionEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
resourceId Azure Resource ID гибридного соединения, которое является назначением для подписки на событие. string

IsNotNullAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'IsNotNull' (обязательно)

IsNullOrUndefinedAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'IsNullOrUndefined' (обязательно)

MonitorAlertEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'MonitorAlert' (обязательно)
properties Отслеживайте свойства оповещений назначения подписки на события. MonitorAlertEventSubscriptionDestinationProperties

MonitorAlertEventSubscriptionDestinationProperties

Name Description Value
actionGroups Список идентификаторов ARM групп действий, которые будут активироваться при каждом оповещении, запущенном с помощью этой подписки на событие.
Каждый идентификатор RESOURCE ARM должен соответствовать этому шаблону: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Insights/actionGroups/{ActionGroupName}.
string[]
description Описание, которое будет присоединено к каждому оповещению, запущенному через эту подписку на событие. string
severity Серьезность, которая будет присоединена к каждому оповещению, запущенному через эту подписку на события.
Это поле должно быть предоставлено.
'Sev0'
'Sev1'
'Sev2'
'Sev3'
'Sev4'

NamespaceTopicEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'NamespaceTopic' (обязательно)
properties Свойства раздела пространства имен назначения подписки на события. NamespaceTopicEventSubscriptionDestinationProperties

NamespaceTopicEventSubscriptionDestinationProperties

Name Description Value
resourceId Идентификатор ресурса Azure, который представляет конечную точку назначения Event Grid Namespace Namespace Themspace для подписки на событие.
Это поле необходимо, и ресурс раздела пространства имен уже должен существовать.
Идентификатор RESOURCE ARM должен соответствовать этому шаблону: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.EventGrid/namespaces/{NamespaceName}/topic/{TopicName}.
string

NumberGreaterThanAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberGreaterThan' (обязательно)
value Значение фильтра. int

NumberGreaterThanOrEqualsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberGreaterThanOrEquals' (обязательно)
value Значение фильтра. int

NumberInAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberIn' (обязательно)
values Набор значений фильтра. int[]

NumberInRangeAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberInRange' (обязательно)
values Набор значений фильтра. int[][]

NumberLessThanAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberLessThan' (обязательно)
value Значение фильтра. int

NumberLessThanOrEqualsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberLessThanOrEquals' (обязательно)
value Значение фильтра. int

NumberNotInAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberNotIn' (обязательно)
values Набор значений фильтра. int[]

NumberNotInRangeAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'NumberNotInRange' (обязательно)
values Набор значений фильтра. int[][]

PartnerEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'PartnerDestination' (обязательно)
properties Свойства назначения партнера для назначения подписки на события. PartnerEventSubscriptionDestinationProperties

PartnerEventSubscriptionDestinationProperties

Name Description Value
resourceId Идентификатор ресурса Azure, представляющий конечную точку партнерского назначения подписки на событие. string

RetryPolicy

Name Description Value
eventTimeToLiveInMinutes Время жизни (в минутах) для событий. int
maxDeliveryAttempts Максимальное количество попыток повторных попыток доставки для событий. int

ServiceBusQueueEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'ServiceBusQueue' (обязательно)
properties служебная шина Свойства места подписки на событие. ServiceBusQueueEventSubscriptionDestinationProperties

ServiceBusQueueEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
resourceId Идентификатор ресурса Azure, представляющий конечную точку назначения служебная шина подписки на событие. string

ServiceBusTopicEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'ServiceBusTopic' (обязательно)
properties служебная шина Тематические свойства направления подписки на событие. ServiceBusTopicEventSubscriptionDestinationProperties

ServiceBusTopicEventSubscriptionDestinationProperties

Name Description Value
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
resourceId Идентификатор ресурса Azure, представляющий конечную точку назначения темы служебная шина подписки на событие. string

StaticDeliveryAttributeMapping

Name Description Value
properties Свойства сопоставления атрибутов статической доставки. StaticDeliveryAttributeMappingProperties
type Тип атрибута доставки или имени заголовка. 'Статический' (обязательно)

StaticDeliveryAttributeMappingProperties

Name Description Value
isSecret Логический флаг, чтобы определить, содержит ли атрибут конфиденциальную информацию. bool
value Значение атрибута доставки. string

StorageBlobDeadLetterDestination

Name Description Value
endpointType Тип конечной точки для назначения недоставленной буквы 'StorageBlob' (обязательно)
properties Свойства мёртвого назначения, основанного на Storage Blob, StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

Name Description Value
blobContainerName Название контейнера Storage blob, который является местом назначения событий deadletter string
resourceId Идентификатор ресурса Azure аккаунта хранения, который является назначением событий deadletter string

StorageQueueEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'StorageQueue' (обязательно)
properties Storage Queue Свойства назначения подписки на событие. StorageQueueEventSubscriptionDestinationProperties

StorageQueueEventSubscriptionDestinationProperties

Name Description Value
queueMessageTimeToLiveInSeconds Время очереди сообщения Storage достигает секунд. Это значение не может быть нулевым или отрицательным, за исключением использования -1, чтобы указать, что время жизни сообщения бесконечно. int
queueName Название очереди Storage находится под аккаунтом storage, который является получателем подписки на событие. string
resourceId Идентификатор ресурса Azure аккаунта хранения, содержащего очередь, являющуюся получателем подписки на событие. string

StringBeginsWithAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringBeginsWith' (обязательно)
values Набор значений фильтра. string[]

StringContainsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringContains' (обязательно)
values Набор значений фильтра. string[]

StringEndsWithAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringEndsWith' (обязательно)
values Набор значений фильтра. string[]

StringInAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringIn' (обязательно)
values Набор значений фильтра. string[]

StringNotBeginsWithAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringNotBeginsWith' (обязательно)
values Набор значений фильтра. string[]

StringNotContainsAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringNotContains' (обязательно)
values Набор значений фильтра. string[]

StringNotEndsWithAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringNotEndsWith' (обязательно)
values Набор значений фильтра. string[]

StringNotInAdvancedFilter

Name Description Value
operatorType Тип оператора, используемый для фильтрации, например NumberIn, StringContains, BoolEquals и других. 'StringNotIn' (обязательно)
values Набор значений фильтра. string[]

WebHookEventSubscriptionDestination

Name Description Value
endpointType Тип конечной точки для назначения подписки на события. 'WebHook' (обязательно)
properties Свойства веб-перехватчика назначения подписки на события. WebHookEventSubscriptionDestinationProperties

WebHookEventSubscriptionDestinationProperties

Name Description Value
azureActiveDirectoryApplicationIdOrUri Microsoft Entra ID Application ID или URI позволяет получить токен доступа, который будет включён в качестве токена носителя в запросах на доставку. string
azureActiveDirectoryTenantId Идентификатор арендатора Microsoft Entra ID позволяет получить токен доступа, который будет включён в качестве токена носителя в запросах на доставку. string
deliveryAttributeMappings Сведения о атрибуте доставки. DeliveryAttributeMapping[]
endpointUrl URL-адрес, представляющий конечную точку назначения подписки на событие. string

Constraints:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
maxEventsPerBatch Максимальное количество событий в пакете. int
minimumTlsVersionAllowed Минимальная версия TLS, которая должна поддерживаться конечной точкой веб-перехватчика '1.0'
'1.1'
'1.2'
preferredBatchSizeInKilobytes Предпочтительный размер пакета в Килобайтах. int

Примеры использования

Примеры Terraform

Простой пример развертывания подписки на события EventGrid.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "namespace" {
  type      = "Microsoft.EventHub/namespaces@2022-01-01-preview"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      disableLocalAuth     = false
      isAutoInflateEnabled = false
      publicNetworkAccess  = "Enabled"
      zoneRedundant        = false
    }
    sku = {
      capacity = 1
      name     = "Standard"
      tier     = "Standard"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "storageAccount" {
  type      = "Microsoft.Storage/storageAccounts@2021-09-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    kind = "StorageV2"
    properties = {
      accessTier                   = "Hot"
      allowBlobPublicAccess        = true
      allowCrossTenantReplication  = true
      allowSharedKeyAccess         = true
      defaultToOAuthAuthentication = false
      encryption = {
        keySource = "Microsoft.Storage"
        services = {
          queue = {
            keyType = "Service"
          }
          table = {
            keyType = "Service"
          }
        }
      }
      isHnsEnabled      = false
      isNfsV3Enabled    = false
      isSftpEnabled     = false
      minimumTlsVersion = "TLS1_2"
      networkAcls = {
        defaultAction = "Allow"
      }
      publicNetworkAccess      = "Enabled"
      supportsHttpsTrafficOnly = true
    }
    sku = {
      name = "Standard_LRS"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "eventhub" {
  type      = "Microsoft.EventHub/namespaces/eventhubs@2021-11-01"
  parent_id = azapi_resource.namespace.id
  name      = var.resource_name
  body = {
    properties = {
      messageRetentionInDays = 1
      partitionCount         = 1
      status                 = "Active"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "eventSubscription" {
  type      = "Microsoft.EventGrid/eventSubscriptions@2021-12-01"
  parent_id = azapi_resource.storageAccount.id
  name      = var.resource_name
  body = {
    properties = {
      deadLetterDestination = null
      destination = {
        endpointType = "EventHub"
        properties = {
          deliveryAttributeMappings = null
          resourceId                = azapi_resource.eventhub.id
        }
      }
      eventDeliverySchema = "EventGridSchema"
      filter = {
        includedEventTypes = [
          "Microsoft.Storage.BlobCreated",
          "Microsoft.Storage.BlobRenamed",
        ]
      }
      labels = [
      ]
      retryPolicy = {
        eventTimeToLiveInMinutes = 144
        maxDeliveryAttempts      = 10
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}