Microsoft.EventGrid systemTopics/eventSubscriptions 2024-06-01-preview

Choose a deployment language

Bicep ARM template Terraform

Bicep resource definition

The systemTopics/eventSubscriptions resource type can be deployed with operations that target:

• Resource groups - See resource group deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.EventGrid/systemTopics/eventSubscriptions resource, add the following Bicep to your template.

Bicep

resource symbolicname 'Microsoft.EventGrid/systemTopics/eventSubscriptions@2024-06-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    deadLetterDestination: {
      endpointType: 'string'
      // For remaining properties, see DeadLetterDestination objects
    }
    deadLetterWithResourceIdentity: {
      deadLetterDestination: {
        endpointType: 'string'
        // For remaining properties, see DeadLetterDestination objects
      }
      identity: {
        type: 'string'
        userAssignedIdentity: 'string'
      }
    }
    deliveryWithResourceIdentity: {
      destination: {
        endpointType: 'string'
        // For remaining properties, see EventSubscriptionDestination objects
      }
      identity: {
        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 objects

Set the endpointType property to specify the type of object.

For AzureFunction, use:

Bicep

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

For EventHub, use:

Bicep

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

For HybridConnection, use:

Bicep

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

For MonitorAlert, use:

Bicep

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

For NamespaceTopic, use:

Bicep

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

For PartnerDestination, use:

Bicep

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

For ServiceBusQueue, use:

Bicep

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

For ServiceBusTopic, use:

Bicep

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

For StorageQueue, use:

Bicep

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

For WebHook, use:

Bicep

{
  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 objects

Set the endpointType property to specify the type of object.

For StorageBlob, use:

Bicep

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

AdvancedFilter objects

Set the operatorType property to specify the type of object.

For BoolEquals, use:

Bicep

{
  operatorType: 'BoolEquals'
  value: bool
}

For IsNotNull, use:

Bicep

{
  operatorType: 'IsNotNull'
}

For IsNullOrUndefined, use:

Bicep

{
  operatorType: 'IsNullOrUndefined'
}

For NumberGreaterThan, use:

Bicep

{
  operatorType: 'NumberGreaterThan'
  value: int
}

For NumberGreaterThanOrEquals, use:

Bicep

{
  operatorType: 'NumberGreaterThanOrEquals'
  value: int
}

For NumberIn, use:

Bicep

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

For NumberInRange, use:

Bicep

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

For NumberLessThan, use:

Bicep

{
  operatorType: 'NumberLessThan'
  value: int
}

For NumberLessThanOrEquals, use:

Bicep

{
  operatorType: 'NumberLessThanOrEquals'
  value: int
}

For NumberNotIn, use:

Bicep

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

For NumberNotInRange, use:

Bicep

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

For StringBeginsWith, use:

Bicep

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

For StringContains, use:

Bicep

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

For StringEndsWith, use:

Bicep

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

For StringIn, use:

Bicep

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

For StringNotBeginsWith, use:

Bicep

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

For StringNotContains, use:

Bicep

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

For StringNotEndsWith, use:

Bicep

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

For StringNotIn, use:

Bicep

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

DeliveryAttributeMapping objects

Set the type property to specify the type of object.

For Dynamic, use:

Bicep

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

For Static, use:

Bicep

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

Property Values

AdvancedFilter

Name	Description	Value
key	The field/property in the event based on which you want to filter.	string
operatorType	Set to 'BoolEquals' for type BoolEqualsAdvancedFilter. Set to 'IsNotNull' for type IsNotNullAdvancedFilter. Set to 'IsNullOrUndefined' for type IsNullOrUndefinedAdvancedFilter. Set to 'NumberGreaterThan' for type NumberGreaterThanAdvancedFilter. Set to 'NumberGreaterThanOrEquals' for type NumberGreaterThanOrEqualsAdvancedFilter. Set to 'NumberIn' for type NumberInAdvancedFilter. Set to 'NumberInRange' for type NumberInRangeAdvancedFilter. Set to 'NumberLessThan' for type NumberLessThanAdvancedFilter. Set to 'NumberLessThanOrEquals' for type NumberLessThanOrEqualsAdvancedFilter. Set to 'NumberNotIn' for type NumberNotInAdvancedFilter. Set to 'NumberNotInRange' for type NumberNotInRangeAdvancedFilter. Set to 'StringBeginsWith' for type StringBeginsWithAdvancedFilter. Set to 'StringContains' for type StringContainsAdvancedFilter. Set to 'StringEndsWith' for type StringEndsWithAdvancedFilter. Set to 'StringIn' for type StringInAdvancedFilter. Set to 'StringNotBeginsWith' for type StringNotBeginsWithAdvancedFilter. Set to 'StringNotContains' for type StringNotContainsAdvancedFilter. Set to 'StringNotEndsWith' for type StringNotEndsWithAdvancedFilter. Set to 'StringNotIn' for type StringNotInAdvancedFilter.	'BoolEquals' 'IsNotNull' 'IsNullOrUndefined' 'NumberGreaterThan' 'NumberGreaterThanOrEquals' 'NumberIn' 'NumberInRange' 'NumberLessThan' 'NumberLessThanOrEquals' 'NumberNotIn' 'NumberNotInRange' 'StringBeginsWith' 'StringContains' 'StringEndsWith' 'StringIn' 'StringNotBeginsWith' 'StringNotContains' 'StringNotEndsWith' 'StringNotIn' (required)

AzureFunctionEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'AzureFunction' (required)
properties	Azure Function Properties of the event subscription destination.	AzureFunctionEventSubscriptionDestinationProperties

AzureFunctionEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
maxEventsPerBatch	Maximum number of events per batch.	int
preferredBatchSizeInKilobytes	Preferred batch size in Kilobytes.	int
resourceId	The Azure Resource Id that represents the endpoint of the Azure Function destination of an event subscription.	string

BoolEqualsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'BoolEquals' (required)
value	The boolean filter value.	bool

DeadLetterDestination

Name	Description	Value
endpointType	Set to 'StorageBlob' for type StorageBlobDeadLetterDestination.	'StorageBlob' (required)

DeadLetterWithResourceIdentity

Name	Description	Value
deadLetterDestination	Information about the destination where events have to be delivered for the event subscription. Uses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during dead-lettering.	DeadLetterDestination
identity	The identity to use when dead-lettering events.	EventSubscriptionIdentity

DeliveryAttributeMapping

Name	Description	Value
name	Name of the delivery attribute or header.	string
type	Set to 'Dynamic' for type DynamicDeliveryAttributeMapping. Set to 'Static' for type StaticDeliveryAttributeMapping.	'Dynamic' 'Static' (required)

DeliveryWithResourceIdentity

Name	Description	Value
destination	Information about the destination where events have to be delivered for the event subscription. Uses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery.	EventSubscriptionDestination
identity	The identity to use when delivering events.	EventSubscriptionIdentity

DynamicDeliveryAttributeMapping

Name	Description	Value
properties	Properties of dynamic delivery attribute mapping.	DynamicDeliveryAttributeMappingProperties
type	Type of the delivery attribute or header name.	'Dynamic' (required)

DynamicDeliveryAttributeMappingProperties

Name	Description	Value
sourceField	JSON path in the event which contains attribute value.	string

EventHubEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'EventHub' (required)
properties	Event Hub Properties of the event subscription destination.	EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
resourceId	The Azure Resource Id that represents the endpoint of an Event Hub destination of an event subscription.	string

EventSubscriptionDestination

Name	Description	Value
endpointType	Set to 'AzureFunction' for type AzureFunctionEventSubscriptionDestination. Set to 'EventHub' for type EventHubEventSubscriptionDestination. Set to 'HybridConnection' for type HybridConnectionEventSubscriptionDestination. Set to 'MonitorAlert' for type MonitorAlertEventSubscriptionDestination. Set to 'NamespaceTopic' for type NamespaceTopicEventSubscriptionDestination. Set to 'PartnerDestination' for type PartnerEventSubscriptionDestination. Set to 'ServiceBusQueue' for type ServiceBusQueueEventSubscriptionDestination. Set to 'ServiceBusTopic' for type ServiceBusTopicEventSubscriptionDestination. Set to 'StorageQueue' for type StorageQueueEventSubscriptionDestination. Set to 'WebHook' for type WebHookEventSubscriptionDestination.	'AzureFunction' 'EventHub' 'HybridConnection' 'MonitorAlert' 'NamespaceTopic' 'PartnerDestination' 'ServiceBusQueue' 'ServiceBusTopic' 'StorageQueue' 'WebHook' (required)

EventSubscriptionFilter

Name	Description	Value
advancedFilters	An array of advanced filters that are used for filtering event subscriptions.	AdvancedFilter[]
enableAdvancedFilteringOnArrays	Allows advanced filters to be evaluated against an array of values instead of expecting a singular value.	bool
includedEventTypes	A list of applicable event types that need to be part of the event subscription. If it is desired to subscribe to all default event types, set the IncludedEventTypes to null.	string[]
isSubjectCaseSensitive	Specifies if the SubjectBeginsWith and SubjectEndsWith properties of the filter should be compared in a case sensitive manner.	bool
subjectBeginsWith	An optional string to filter events for an event subscription based on a resource path prefix. The format of this depends on the publisher of the events. Wildcard characters are not supported in this path.	string
subjectEndsWith	An optional string to filter events for an event subscription based on a resource path suffix. Wildcard characters are not supported in this path.	string

EventSubscriptionIdentity

Name	Description	Value
type	The type of managed identity used. Can be either 'SystemAssigned' or 'UserAssigned'.	'SystemAssigned' 'UserAssigned'
userAssignedIdentity	The user identity associated with the resource.	string

EventSubscriptionProperties

Name	Description	Value
deadLetterDestination	The dead letter destination of the event subscription. Any event that cannot be delivered to its' destination is sent to the dead letter destination. Uses Azure Event Grid's identity to acquire the authentication tokens being used during delivery / dead-lettering.	DeadLetterDestination
deadLetterWithResourceIdentity	The dead letter destination of the event subscription. Any event that cannot be delivered to its' destination is sent to the dead letter destination. Uses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery / dead-lettering.	DeadLetterWithResourceIdentity
deliveryWithResourceIdentity	Information about the destination where events have to be delivered for the event subscription. Uses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery / dead-lettering.	DeliveryWithResourceIdentity
destination	Information about the destination where events have to be delivered for the event subscription. Uses Azure Event Grid's identity to acquire the authentication tokens being used during delivery / dead-lettering.	EventSubscriptionDestination
eventDeliverySchema	The event delivery schema for the event subscription.	'CloudEventSchemaV1_0' 'CustomInputSchema' 'EventGridSchema'
expirationTimeUtc	Expiration time of the event subscription.	string
filter	Information about the filter for the event subscription.	EventSubscriptionFilter
labels	List of user defined labels.	string[]
retryPolicy	The retry policy for events. This can be used to configure maximum number of delivery attempts and time to live for events.	RetryPolicy

HybridConnectionEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'HybridConnection' (required)
properties	Hybrid connection Properties of the event subscription destination.	HybridConnectionEventSubscriptionDestinationProperties

HybridConnectionEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
resourceId	The Azure Resource ID of an hybrid connection that is the destination of an event subscription.	string

IsNotNullAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'IsNotNull' (required)

IsNullOrUndefinedAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'IsNullOrUndefined' (required)

Microsoft.EventGrid/systemTopics/eventSubscriptions

Name	Description	Value
name	The resource name	string (required)
parent	In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource. For more information, see Child resource outside parent resource.	Symbolic name for resource of type: systemTopics
properties	Properties of the event subscription.	EventSubscriptionProperties

MonitorAlertEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'MonitorAlert' (required)
properties	Monitor Alert properties of the event subscription destination.	MonitorAlertEventSubscriptionDestinationProperties

MonitorAlertEventSubscriptionDestinationProperties

Name	Description	Value
actionGroups	The list of ARM Ids of Action Groups that will be triggered on every Alert fired through this event subscription. Each resource ARM Id should follow this pattern: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Insights/actionGroups/{ActionGroupName}.	string[]
description	The description that will be attached to every Alert fired through this event subscription.	string
severity	The severity that will be attached to every Alert fired through this event subscription. This field must be provided.	'Sev0' 'Sev1' 'Sev2' 'Sev3' 'Sev4'

NamespaceTopicEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'NamespaceTopic' (required)
properties	Namespace Topic properties of the event subscription destination.	NamespaceTopicEventSubscriptionDestinationProperties

NamespaceTopicEventSubscriptionDestinationProperties

Name	Description	Value
resourceId	The Azure resource Id that represents the endpoint of the Event Grid Namespace Topic destination of an event subscription. This field is required and the Namespace Topic resource listed must already exist. The resource ARM Id should follow this pattern: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.EventGrid/namespaces/{NamespaceName}/topics/{TopicName}.	string

NumberGreaterThanAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberGreaterThan' (required)
value	The filter value.	int

NumberGreaterThanOrEqualsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberGreaterThanOrEquals' (required)
value	The filter value.	int

NumberInAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberIn' (required)
values	The set of filter values.	int[]

NumberInRangeAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberInRange' (required)
values	The set of filter values.	int[][]

NumberLessThanAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberLessThan' (required)
value	The filter value.	int

NumberLessThanOrEqualsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberLessThanOrEquals' (required)
value	The filter value.	int

NumberNotInAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberNotIn' (required)
values	The set of filter values.	int[]

NumberNotInRangeAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberNotInRange' (required)
values	The set of filter values.	int[][]

PartnerEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'PartnerDestination' (required)
properties	Partner Destination Properties of the event subscription destination.	PartnerEventSubscriptionDestinationProperties

PartnerEventSubscriptionDestinationProperties

Name	Description	Value
resourceId	The Azure Resource Id that represents the endpoint of a Partner Destination of an event subscription.	string

RetryPolicy

Name	Description	Value
eventTimeToLiveInMinutes	Time To Live (in minutes) for events.	int
maxDeliveryAttempts	Maximum number of delivery retry attempts for events.	int

ServiceBusQueueEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'ServiceBusQueue' (required)
properties	Service Bus Properties of the event subscription destination.	ServiceBusQueueEventSubscriptionDestinationProperties

ServiceBusQueueEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
resourceId	The Azure Resource Id that represents the endpoint of the Service Bus destination of an event subscription.	string

ServiceBusTopicEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'ServiceBusTopic' (required)
properties	Service Bus Topic Properties of the event subscription destination.	ServiceBusTopicEventSubscriptionDestinationProperties

ServiceBusTopicEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
resourceId	The Azure Resource Id that represents the endpoint of the Service Bus Topic destination of an event subscription.	string

StaticDeliveryAttributeMapping

Name	Description	Value
properties	Properties of static delivery attribute mapping.	StaticDeliveryAttributeMappingProperties
type	Type of the delivery attribute or header name.	'Static' (required)

StaticDeliveryAttributeMappingProperties

Name	Description	Value
isSecret	Boolean flag to tell if the attribute contains sensitive information .	bool
value	Value of the delivery attribute.	string

StorageBlobDeadLetterDestination

Name	Description	Value
endpointType	Type of the endpoint for the dead letter destination	'StorageBlob' (required)
properties	The properties of the Storage Blob based deadletter destination	StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

Name	Description	Value
blobContainerName	The name of the Storage blob container that is the destination of the deadletter events	string
resourceId	The Azure Resource ID of the storage account that is the destination of the deadletter events	string

StorageQueueEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'StorageQueue' (required)
properties	Storage Queue Properties of the event subscription destination.	StorageQueueEventSubscriptionDestinationProperties

StorageQueueEventSubscriptionDestinationProperties

Name	Description	Value
queueMessageTimeToLiveInSeconds	Storage queue message time to live in seconds. This value cannot be zero or negative with the exception of using -1 to indicate that the Time To Live of the message is Infinite.	int
queueName	The name of the Storage queue under a storage account that is the destination of an event subscription.	string
resourceId	The Azure Resource ID of the storage account that contains the queue that is the destination of an event subscription.	string

StringBeginsWithAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringBeginsWith' (required)
values	The set of filter values.	string[]

StringContainsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringContains' (required)
values	The set of filter values.	string[]

StringEndsWithAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringEndsWith' (required)
values	The set of filter values.	string[]

StringInAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringIn' (required)
values	The set of filter values.	string[]

StringNotBeginsWithAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringNotBeginsWith' (required)
values	The set of filter values.	string[]

StringNotContainsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringNotContains' (required)
values	The set of filter values.	string[]

StringNotEndsWithAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringNotEndsWith' (required)
values	The set of filter values.	string[]

StringNotInAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringNotIn' (required)
values	The set of filter values.	string[]

WebHookEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'WebHook' (required)
properties	WebHook Properties of the event subscription destination.	WebHookEventSubscriptionDestinationProperties

WebHookEventSubscriptionDestinationProperties

Name	Description	Value
azureActiveDirectoryApplicationIdOrUri	The Azure Active Directory Application ID or URI to get the access token that will be included as the bearer token in delivery requests.	string
azureActiveDirectoryTenantId	The Azure Active Directory Tenant ID to get the access token that will be included as the bearer token in delivery requests.	string
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
endpointUrl	The URL that represents the endpoint of the destination of an event subscription.	string Constraints: Sensitive value. Pass in as a secure parameter.
maxEventsPerBatch	Maximum number of events per batch.	int
minimumTlsVersionAllowed	Minimum TLS version that should be supported by webhook endpoint	'1.0' '1.1' '1.2'
preferredBatchSizeInKilobytes	Preferred batch size in Kilobytes.	int

Usage Examples

Azure Quickstart Samples

The following Azure Quickstart templates contain Bicep samples for deploying this resource type.

Bicep File	Description
Create Blob Storage and Event Grid subscription to the Blob	Creates Azure Blob Storage account and then creates an Event Grid subscription to that Blob.
Deploy Azure Data Explorer db with Event Grid connection	Deploy Azure Data Explorer db with Event Grid connection.

ARM template resource definition

The systemTopics/eventSubscriptions resource type can be deployed with operations that target:

• Resource groups - See resource group deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.EventGrid/systemTopics/eventSubscriptions resource, add the following JSON to your template.

JSON

{
  "type": "Microsoft.EventGrid/systemTopics/eventSubscriptions",
  "apiVersion": "2024-06-01-preview",
  "name": "string",
  "properties": {
    "deadLetterDestination": {
      "endpointType": "string"
      // For remaining properties, see DeadLetterDestination objects
    },
    "deadLetterWithResourceIdentity": {
      "deadLetterDestination": {
        "endpointType": "string"
        // For remaining properties, see DeadLetterDestination objects
      },
      "identity": {
        "type": "string",
        "userAssignedIdentity": "string"
      }
    },
    "deliveryWithResourceIdentity": {
      "destination": {
        "endpointType": "string"
        // For remaining properties, see EventSubscriptionDestination objects
      },
      "identity": {
        "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 objects

Set the endpointType property to specify the type of object.

For AzureFunction, use:

JSON

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

For EventHub, use:

JSON

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

For HybridConnection, use:

JSON

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

For MonitorAlert, use:

JSON

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

For NamespaceTopic, use:

JSON

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

For PartnerDestination, use:

JSON

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

For ServiceBusQueue, use:

JSON

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

For ServiceBusTopic, use:

JSON

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

For StorageQueue, use:

JSON

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

For WebHook, use:

JSON

{
  "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 objects

Set the endpointType property to specify the type of object.

For StorageBlob, use:

JSON

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

AdvancedFilter objects

Set the operatorType property to specify the type of object.

For BoolEquals, use:

JSON

{
  "operatorType": "BoolEquals",
  "value": "bool"
}

For IsNotNull, use:

JSON

{
  "operatorType": "IsNotNull"
}

For IsNullOrUndefined, use:

JSON

{
  "operatorType": "IsNullOrUndefined"
}

For NumberGreaterThan, use:

JSON

{
  "operatorType": "NumberGreaterThan",
  "value": "int"
}

For NumberGreaterThanOrEquals, use:

JSON

{
  "operatorType": "NumberGreaterThanOrEquals",
  "value": "int"
}

For NumberIn, use:

JSON

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

For NumberInRange, use:

JSON

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

For NumberLessThan, use:

JSON

{
  "operatorType": "NumberLessThan",
  "value": "int"
}

For NumberLessThanOrEquals, use:

JSON

{
  "operatorType": "NumberLessThanOrEquals",
  "value": "int"
}

For NumberNotIn, use:

JSON

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

For NumberNotInRange, use:

JSON

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

For StringBeginsWith, use:

JSON

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

For StringContains, use:

JSON

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

For StringEndsWith, use:

JSON

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

For StringIn, use:

JSON

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

For StringNotBeginsWith, use:

JSON

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

For StringNotContains, use:

JSON

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

For StringNotEndsWith, use:

JSON

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

For StringNotIn, use:

JSON

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

DeliveryAttributeMapping objects

Set the type property to specify the type of object.

For Dynamic, use:

JSON

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

For Static, use:

JSON

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

Property Values

AdvancedFilter

Name	Description	Value
key	The field/property in the event based on which you want to filter.	string
operatorType	Set to 'BoolEquals' for type BoolEqualsAdvancedFilter. Set to 'IsNotNull' for type IsNotNullAdvancedFilter. Set to 'IsNullOrUndefined' for type IsNullOrUndefinedAdvancedFilter. Set to 'NumberGreaterThan' for type NumberGreaterThanAdvancedFilter. Set to 'NumberGreaterThanOrEquals' for type NumberGreaterThanOrEqualsAdvancedFilter. Set to 'NumberIn' for type NumberInAdvancedFilter. Set to 'NumberInRange' for type NumberInRangeAdvancedFilter. Set to 'NumberLessThan' for type NumberLessThanAdvancedFilter. Set to 'NumberLessThanOrEquals' for type NumberLessThanOrEqualsAdvancedFilter. Set to 'NumberNotIn' for type NumberNotInAdvancedFilter. Set to 'NumberNotInRange' for type NumberNotInRangeAdvancedFilter. Set to 'StringBeginsWith' for type StringBeginsWithAdvancedFilter. Set to 'StringContains' for type StringContainsAdvancedFilter. Set to 'StringEndsWith' for type StringEndsWithAdvancedFilter. Set to 'StringIn' for type StringInAdvancedFilter. Set to 'StringNotBeginsWith' for type StringNotBeginsWithAdvancedFilter. Set to 'StringNotContains' for type StringNotContainsAdvancedFilter. Set to 'StringNotEndsWith' for type StringNotEndsWithAdvancedFilter. Set to 'StringNotIn' for type StringNotInAdvancedFilter.	'BoolEquals' 'IsNotNull' 'IsNullOrUndefined' 'NumberGreaterThan' 'NumberGreaterThanOrEquals' 'NumberIn' 'NumberInRange' 'NumberLessThan' 'NumberLessThanOrEquals' 'NumberNotIn' 'NumberNotInRange' 'StringBeginsWith' 'StringContains' 'StringEndsWith' 'StringIn' 'StringNotBeginsWith' 'StringNotContains' 'StringNotEndsWith' 'StringNotIn' (required)

AzureFunctionEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'AzureFunction' (required)
properties	Azure Function Properties of the event subscription destination.	AzureFunctionEventSubscriptionDestinationProperties

AzureFunctionEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
maxEventsPerBatch	Maximum number of events per batch.	int
preferredBatchSizeInKilobytes	Preferred batch size in Kilobytes.	int
resourceId	The Azure Resource Id that represents the endpoint of the Azure Function destination of an event subscription.	string

BoolEqualsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'BoolEquals' (required)
value	The boolean filter value.	bool

DeadLetterDestination

Name	Description	Value
endpointType	Set to 'StorageBlob' for type StorageBlobDeadLetterDestination.	'StorageBlob' (required)

DeadLetterWithResourceIdentity

Name	Description	Value
deadLetterDestination	Information about the destination where events have to be delivered for the event subscription. Uses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during dead-lettering.	DeadLetterDestination
identity	The identity to use when dead-lettering events.	EventSubscriptionIdentity

DeliveryAttributeMapping

Name	Description	Value
name	Name of the delivery attribute or header.	string
type	Set to 'Dynamic' for type DynamicDeliveryAttributeMapping. Set to 'Static' for type StaticDeliveryAttributeMapping.	'Dynamic' 'Static' (required)

DeliveryWithResourceIdentity

Name	Description	Value
destination	Information about the destination where events have to be delivered for the event subscription. Uses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery.	EventSubscriptionDestination
identity	The identity to use when delivering events.	EventSubscriptionIdentity

DynamicDeliveryAttributeMapping

Name	Description	Value
properties	Properties of dynamic delivery attribute mapping.	DynamicDeliveryAttributeMappingProperties
type	Type of the delivery attribute or header name.	'Dynamic' (required)

DynamicDeliveryAttributeMappingProperties

Name	Description	Value
sourceField	JSON path in the event which contains attribute value.	string

EventHubEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'EventHub' (required)
properties	Event Hub Properties of the event subscription destination.	EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
resourceId	The Azure Resource Id that represents the endpoint of an Event Hub destination of an event subscription.	string

EventSubscriptionDestination

Name	Description	Value
endpointType	Set to 'AzureFunction' for type AzureFunctionEventSubscriptionDestination. Set to 'EventHub' for type EventHubEventSubscriptionDestination. Set to 'HybridConnection' for type HybridConnectionEventSubscriptionDestination. Set to 'MonitorAlert' for type MonitorAlertEventSubscriptionDestination. Set to 'NamespaceTopic' for type NamespaceTopicEventSubscriptionDestination. Set to 'PartnerDestination' for type PartnerEventSubscriptionDestination. Set to 'ServiceBusQueue' for type ServiceBusQueueEventSubscriptionDestination. Set to 'ServiceBusTopic' for type ServiceBusTopicEventSubscriptionDestination. Set to 'StorageQueue' for type StorageQueueEventSubscriptionDestination. Set to 'WebHook' for type WebHookEventSubscriptionDestination.	'AzureFunction' 'EventHub' 'HybridConnection' 'MonitorAlert' 'NamespaceTopic' 'PartnerDestination' 'ServiceBusQueue' 'ServiceBusTopic' 'StorageQueue' 'WebHook' (required)

EventSubscriptionFilter

Name	Description	Value
advancedFilters	An array of advanced filters that are used for filtering event subscriptions.	AdvancedFilter[]
enableAdvancedFilteringOnArrays	Allows advanced filters to be evaluated against an array of values instead of expecting a singular value.	bool
includedEventTypes	A list of applicable event types that need to be part of the event subscription. If it is desired to subscribe to all default event types, set the IncludedEventTypes to null.	string[]
isSubjectCaseSensitive	Specifies if the SubjectBeginsWith and SubjectEndsWith properties of the filter should be compared in a case sensitive manner.	bool
subjectBeginsWith	An optional string to filter events for an event subscription based on a resource path prefix. The format of this depends on the publisher of the events. Wildcard characters are not supported in this path.	string
subjectEndsWith	An optional string to filter events for an event subscription based on a resource path suffix. Wildcard characters are not supported in this path.	string

EventSubscriptionIdentity

Name	Description	Value
type	The type of managed identity used. Can be either 'SystemAssigned' or 'UserAssigned'.	'SystemAssigned' 'UserAssigned'
userAssignedIdentity	The user identity associated with the resource.	string

EventSubscriptionProperties

Name	Description	Value
deadLetterDestination	The dead letter destination of the event subscription. Any event that cannot be delivered to its' destination is sent to the dead letter destination. Uses Azure Event Grid's identity to acquire the authentication tokens being used during delivery / dead-lettering.	DeadLetterDestination
deadLetterWithResourceIdentity	The dead letter destination of the event subscription. Any event that cannot be delivered to its' destination is sent to the dead letter destination. Uses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery / dead-lettering.	DeadLetterWithResourceIdentity
deliveryWithResourceIdentity	Information about the destination where events have to be delivered for the event subscription. Uses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery / dead-lettering.	DeliveryWithResourceIdentity
destination	Information about the destination where events have to be delivered for the event subscription. Uses Azure Event Grid's identity to acquire the authentication tokens being used during delivery / dead-lettering.	EventSubscriptionDestination
eventDeliverySchema	The event delivery schema for the event subscription.	'CloudEventSchemaV1_0' 'CustomInputSchema' 'EventGridSchema'
expirationTimeUtc	Expiration time of the event subscription.	string
filter	Information about the filter for the event subscription.	EventSubscriptionFilter
labels	List of user defined labels.	string[]
retryPolicy	The retry policy for events. This can be used to configure maximum number of delivery attempts and time to live for events.	RetryPolicy

HybridConnectionEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'HybridConnection' (required)
properties	Hybrid connection Properties of the event subscription destination.	HybridConnectionEventSubscriptionDestinationProperties

HybridConnectionEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
resourceId	The Azure Resource ID of an hybrid connection that is the destination of an event subscription.	string

IsNotNullAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'IsNotNull' (required)

IsNullOrUndefinedAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'IsNullOrUndefined' (required)

Microsoft.EventGrid/systemTopics/eventSubscriptions

Name	Description	Value
apiVersion	The api version	'2024-06-01-preview'
name	The resource name	string (required)
properties	Properties of the event subscription.	EventSubscriptionProperties
type	The resource type	'Microsoft.EventGrid/systemTopics/eventSubscriptions'

MonitorAlertEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'MonitorAlert' (required)
properties	Monitor Alert properties of the event subscription destination.	MonitorAlertEventSubscriptionDestinationProperties

MonitorAlertEventSubscriptionDestinationProperties

Name	Description	Value
actionGroups	The list of ARM Ids of Action Groups that will be triggered on every Alert fired through this event subscription. Each resource ARM Id should follow this pattern: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Insights/actionGroups/{ActionGroupName}.	string[]
description	The description that will be attached to every Alert fired through this event subscription.	string
severity	The severity that will be attached to every Alert fired through this event subscription. This field must be provided.	'Sev0' 'Sev1' 'Sev2' 'Sev3' 'Sev4'

NamespaceTopicEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'NamespaceTopic' (required)
properties	Namespace Topic properties of the event subscription destination.	NamespaceTopicEventSubscriptionDestinationProperties

NamespaceTopicEventSubscriptionDestinationProperties

Name	Description	Value
resourceId	The Azure resource Id that represents the endpoint of the Event Grid Namespace Topic destination of an event subscription. This field is required and the Namespace Topic resource listed must already exist. The resource ARM Id should follow this pattern: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.EventGrid/namespaces/{NamespaceName}/topics/{TopicName}.	string

NumberGreaterThanAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberGreaterThan' (required)
value	The filter value.	int

NumberGreaterThanOrEqualsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberGreaterThanOrEquals' (required)
value	The filter value.	int

NumberInAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberIn' (required)
values	The set of filter values.	int[]

NumberInRangeAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberInRange' (required)
values	The set of filter values.	int[][]

NumberLessThanAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberLessThan' (required)
value	The filter value.	int

NumberLessThanOrEqualsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberLessThanOrEquals' (required)
value	The filter value.	int

NumberNotInAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberNotIn' (required)
values	The set of filter values.	int[]

NumberNotInRangeAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberNotInRange' (required)
values	The set of filter values.	int[][]

PartnerEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'PartnerDestination' (required)
properties	Partner Destination Properties of the event subscription destination.	PartnerEventSubscriptionDestinationProperties

PartnerEventSubscriptionDestinationProperties

Name	Description	Value
resourceId	The Azure Resource Id that represents the endpoint of a Partner Destination of an event subscription.	string

RetryPolicy

Name	Description	Value
eventTimeToLiveInMinutes	Time To Live (in minutes) for events.	int
maxDeliveryAttempts	Maximum number of delivery retry attempts for events.	int

ServiceBusQueueEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'ServiceBusQueue' (required)
properties	Service Bus Properties of the event subscription destination.	ServiceBusQueueEventSubscriptionDestinationProperties

ServiceBusQueueEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
resourceId	The Azure Resource Id that represents the endpoint of the Service Bus destination of an event subscription.	string

ServiceBusTopicEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'ServiceBusTopic' (required)
properties	Service Bus Topic Properties of the event subscription destination.	ServiceBusTopicEventSubscriptionDestinationProperties

ServiceBusTopicEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
resourceId	The Azure Resource Id that represents the endpoint of the Service Bus Topic destination of an event subscription.	string

StaticDeliveryAttributeMapping

Name	Description	Value
properties	Properties of static delivery attribute mapping.	StaticDeliveryAttributeMappingProperties
type	Type of the delivery attribute or header name.	'Static' (required)

StaticDeliveryAttributeMappingProperties

Name	Description	Value
isSecret	Boolean flag to tell if the attribute contains sensitive information .	bool
value	Value of the delivery attribute.	string

StorageBlobDeadLetterDestination

Name	Description	Value
endpointType	Type of the endpoint for the dead letter destination	'StorageBlob' (required)
properties	The properties of the Storage Blob based deadletter destination	StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

Name	Description	Value
blobContainerName	The name of the Storage blob container that is the destination of the deadletter events	string
resourceId	The Azure Resource ID of the storage account that is the destination of the deadletter events	string

StorageQueueEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'StorageQueue' (required)
properties	Storage Queue Properties of the event subscription destination.	StorageQueueEventSubscriptionDestinationProperties

StorageQueueEventSubscriptionDestinationProperties

Name	Description	Value
queueMessageTimeToLiveInSeconds	Storage queue message time to live in seconds. This value cannot be zero or negative with the exception of using -1 to indicate that the Time To Live of the message is Infinite.	int
queueName	The name of the Storage queue under a storage account that is the destination of an event subscription.	string
resourceId	The Azure Resource ID of the storage account that contains the queue that is the destination of an event subscription.	string

StringBeginsWithAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringBeginsWith' (required)
values	The set of filter values.	string[]

StringContainsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringContains' (required)
values	The set of filter values.	string[]

StringEndsWithAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringEndsWith' (required)
values	The set of filter values.	string[]

StringInAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringIn' (required)
values	The set of filter values.	string[]

StringNotBeginsWithAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringNotBeginsWith' (required)
values	The set of filter values.	string[]

StringNotContainsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringNotContains' (required)
values	The set of filter values.	string[]

StringNotEndsWithAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringNotEndsWith' (required)
values	The set of filter values.	string[]

StringNotInAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringNotIn' (required)
values	The set of filter values.	string[]

WebHookEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'WebHook' (required)
properties	WebHook Properties of the event subscription destination.	WebHookEventSubscriptionDestinationProperties

WebHookEventSubscriptionDestinationProperties

Name	Description	Value
azureActiveDirectoryApplicationIdOrUri	The Azure Active Directory Application ID or URI to get the access token that will be included as the bearer token in delivery requests.	string
azureActiveDirectoryTenantId	The Azure Active Directory Tenant ID to get the access token that will be included as the bearer token in delivery requests.	string
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
endpointUrl	The URL that represents the endpoint of the destination of an event subscription.	string Constraints: Sensitive value. Pass in as a secure parameter.
maxEventsPerBatch	Maximum number of events per batch.	int
minimumTlsVersionAllowed	Minimum TLS version that should be supported by webhook endpoint	'1.0' '1.1' '1.2'
preferredBatchSizeInKilobytes	Preferred batch size in Kilobytes.	int

Usage Examples

Azure Quickstart Templates

The following Azure Quickstart templates deploy this resource type.

Template	Description
Create Blob Storage and Event Grid subscription to the Blob	Creates Azure Blob Storage account and then creates an Event Grid subscription to that Blob.
Deploy Azure Data Explorer db with Event Grid connection	Deploy Azure Data Explorer db with Event Grid connection.

Terraform (AzAPI provider) resource definition

The systemTopics/eventSubscriptions resource type can be deployed with operations that target:

• Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.EventGrid/systemTopics/eventSubscriptions resource, add the following Terraform to your template.

Terraform

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/systemTopics/eventSubscriptions@2024-06-01-preview"
  name = "string"
  body = jsonencode({
    properties = {
      deadLetterDestination = {
        endpointType = "string"
        // For remaining properties, see DeadLetterDestination objects
      }
      deadLetterWithResourceIdentity = {
        deadLetterDestination = {
          endpointType = "string"
          // For remaining properties, see DeadLetterDestination objects
        }
        identity = {
          type = "string"
          userAssignedIdentity = "string"
        }
      }
      deliveryWithResourceIdentity = {
        destination = {
          endpointType = "string"
          // For remaining properties, see EventSubscriptionDestination objects
        }
        identity = {
          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 objects

Set the endpointType property to specify the type of object.

For AzureFunction, use:

Terraform

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

For EventHub, use:

Terraform

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

For HybridConnection, use:

Terraform

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

For MonitorAlert, use:

Terraform

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

For NamespaceTopic, use:

Terraform

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

For PartnerDestination, use:

Terraform

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

For ServiceBusQueue, use:

Terraform

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

For ServiceBusTopic, use:

Terraform

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

For StorageQueue, use:

Terraform

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

For WebHook, use:

Terraform

{
  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 objects

Set the endpointType property to specify the type of object.

For StorageBlob, use:

Terraform

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

AdvancedFilter objects

Set the operatorType property to specify the type of object.

For BoolEquals, use:

Terraform

{
  operatorType = "BoolEquals"
  value = bool
}

For IsNotNull, use:

Terraform

{
  operatorType = "IsNotNull"
}

For IsNullOrUndefined, use:

Terraform

{
  operatorType = "IsNullOrUndefined"
}

For NumberGreaterThan, use:

Terraform

{
  operatorType = "NumberGreaterThan"
  value = int
}

For NumberGreaterThanOrEquals, use:

Terraform

{
  operatorType = "NumberGreaterThanOrEquals"
  value = int
}

For NumberIn, use:

Terraform

{
  operatorType = "NumberIn"
  values = [
    int
  ]
}

For NumberInRange, use:

Terraform

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

For NumberLessThan, use:

Terraform

{
  operatorType = "NumberLessThan"
  value = int
}

For NumberLessThanOrEquals, use:

Terraform

{
  operatorType = "NumberLessThanOrEquals"
  value = int
}

For NumberNotIn, use:

Terraform

{
  operatorType = "NumberNotIn"
  values = [
    int
  ]
}

For NumberNotInRange, use:

Terraform

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

For StringBeginsWith, use:

Terraform

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

For StringContains, use:

Terraform

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

For StringEndsWith, use:

Terraform

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

For StringIn, use:

Terraform

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

For StringNotBeginsWith, use:

Terraform

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

For StringNotContains, use:

Terraform

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

For StringNotEndsWith, use:

Terraform

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

For StringNotIn, use:

Terraform

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

DeliveryAttributeMapping objects

Set the type property to specify the type of object.

For Dynamic, use:

Terraform

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

For Static, use:

Terraform

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

Property Values

AdvancedFilter

Name	Description	Value
key	The field/property in the event based on which you want to filter.	string
operatorType	Set to 'BoolEquals' for type BoolEqualsAdvancedFilter. Set to 'IsNotNull' for type IsNotNullAdvancedFilter. Set to 'IsNullOrUndefined' for type IsNullOrUndefinedAdvancedFilter. Set to 'NumberGreaterThan' for type NumberGreaterThanAdvancedFilter. Set to 'NumberGreaterThanOrEquals' for type NumberGreaterThanOrEqualsAdvancedFilter. Set to 'NumberIn' for type NumberInAdvancedFilter. Set to 'NumberInRange' for type NumberInRangeAdvancedFilter. Set to 'NumberLessThan' for type NumberLessThanAdvancedFilter. Set to 'NumberLessThanOrEquals' for type NumberLessThanOrEqualsAdvancedFilter. Set to 'NumberNotIn' for type NumberNotInAdvancedFilter. Set to 'NumberNotInRange' for type NumberNotInRangeAdvancedFilter. Set to 'StringBeginsWith' for type StringBeginsWithAdvancedFilter. Set to 'StringContains' for type StringContainsAdvancedFilter. Set to 'StringEndsWith' for type StringEndsWithAdvancedFilter. Set to 'StringIn' for type StringInAdvancedFilter. Set to 'StringNotBeginsWith' for type StringNotBeginsWithAdvancedFilter. Set to 'StringNotContains' for type StringNotContainsAdvancedFilter. Set to 'StringNotEndsWith' for type StringNotEndsWithAdvancedFilter. Set to 'StringNotIn' for type StringNotInAdvancedFilter.	'BoolEquals' 'IsNotNull' 'IsNullOrUndefined' 'NumberGreaterThan' 'NumberGreaterThanOrEquals' 'NumberIn' 'NumberInRange' 'NumberLessThan' 'NumberLessThanOrEquals' 'NumberNotIn' 'NumberNotInRange' 'StringBeginsWith' 'StringContains' 'StringEndsWith' 'StringIn' 'StringNotBeginsWith' 'StringNotContains' 'StringNotEndsWith' 'StringNotIn' (required)

AzureFunctionEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'AzureFunction' (required)
properties	Azure Function Properties of the event subscription destination.	AzureFunctionEventSubscriptionDestinationProperties

AzureFunctionEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
maxEventsPerBatch	Maximum number of events per batch.	int
preferredBatchSizeInKilobytes	Preferred batch size in Kilobytes.	int
resourceId	The Azure Resource Id that represents the endpoint of the Azure Function destination of an event subscription.	string

BoolEqualsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'BoolEquals' (required)
value	The boolean filter value.	bool

DeadLetterDestination

Name	Description	Value
endpointType	Set to 'StorageBlob' for type StorageBlobDeadLetterDestination.	'StorageBlob' (required)

DeadLetterWithResourceIdentity

Name	Description	Value
deadLetterDestination	Information about the destination where events have to be delivered for the event subscription. Uses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during dead-lettering.	DeadLetterDestination
identity	The identity to use when dead-lettering events.	EventSubscriptionIdentity

DeliveryAttributeMapping

Name	Description	Value
name	Name of the delivery attribute or header.	string
type	Set to 'Dynamic' for type DynamicDeliveryAttributeMapping. Set to 'Static' for type StaticDeliveryAttributeMapping.	'Dynamic' 'Static' (required)

DeliveryWithResourceIdentity

Name	Description	Value
destination	Information about the destination where events have to be delivered for the event subscription. Uses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery.	EventSubscriptionDestination
identity	The identity to use when delivering events.	EventSubscriptionIdentity

DynamicDeliveryAttributeMapping

Name	Description	Value
properties	Properties of dynamic delivery attribute mapping.	DynamicDeliveryAttributeMappingProperties
type	Type of the delivery attribute or header name.	'Dynamic' (required)

DynamicDeliveryAttributeMappingProperties

Name	Description	Value
sourceField	JSON path in the event which contains attribute value.	string

EventHubEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'EventHub' (required)
properties	Event Hub Properties of the event subscription destination.	EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
resourceId	The Azure Resource Id that represents the endpoint of an Event Hub destination of an event subscription.	string

EventSubscriptionDestination

Name	Description	Value
endpointType	Set to 'AzureFunction' for type AzureFunctionEventSubscriptionDestination. Set to 'EventHub' for type EventHubEventSubscriptionDestination. Set to 'HybridConnection' for type HybridConnectionEventSubscriptionDestination. Set to 'MonitorAlert' for type MonitorAlertEventSubscriptionDestination. Set to 'NamespaceTopic' for type NamespaceTopicEventSubscriptionDestination. Set to 'PartnerDestination' for type PartnerEventSubscriptionDestination. Set to 'ServiceBusQueue' for type ServiceBusQueueEventSubscriptionDestination. Set to 'ServiceBusTopic' for type ServiceBusTopicEventSubscriptionDestination. Set to 'StorageQueue' for type StorageQueueEventSubscriptionDestination. Set to 'WebHook' for type WebHookEventSubscriptionDestination.	'AzureFunction' 'EventHub' 'HybridConnection' 'MonitorAlert' 'NamespaceTopic' 'PartnerDestination' 'ServiceBusQueue' 'ServiceBusTopic' 'StorageQueue' 'WebHook' (required)

EventSubscriptionFilter

Name	Description	Value
advancedFilters	An array of advanced filters that are used for filtering event subscriptions.	AdvancedFilter[]
enableAdvancedFilteringOnArrays	Allows advanced filters to be evaluated against an array of values instead of expecting a singular value.	bool
includedEventTypes	A list of applicable event types that need to be part of the event subscription. If it is desired to subscribe to all default event types, set the IncludedEventTypes to null.	string[]
isSubjectCaseSensitive	Specifies if the SubjectBeginsWith and SubjectEndsWith properties of the filter should be compared in a case sensitive manner.	bool
subjectBeginsWith	An optional string to filter events for an event subscription based on a resource path prefix. The format of this depends on the publisher of the events. Wildcard characters are not supported in this path.	string
subjectEndsWith	An optional string to filter events for an event subscription based on a resource path suffix. Wildcard characters are not supported in this path.	string

EventSubscriptionIdentity

Name	Description	Value
type	The type of managed identity used. Can be either 'SystemAssigned' or 'UserAssigned'.	'SystemAssigned' 'UserAssigned'
userAssignedIdentity	The user identity associated with the resource.	string

EventSubscriptionProperties

Name	Description	Value
deadLetterDestination	The dead letter destination of the event subscription. Any event that cannot be delivered to its' destination is sent to the dead letter destination. Uses Azure Event Grid's identity to acquire the authentication tokens being used during delivery / dead-lettering.	DeadLetterDestination
deadLetterWithResourceIdentity	The dead letter destination of the event subscription. Any event that cannot be delivered to its' destination is sent to the dead letter destination. Uses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery / dead-lettering.	DeadLetterWithResourceIdentity
deliveryWithResourceIdentity	Information about the destination where events have to be delivered for the event subscription. Uses the managed identity setup on the parent resource (namely, topic or domain) to acquire the authentication tokens being used during delivery / dead-lettering.	DeliveryWithResourceIdentity
destination	Information about the destination where events have to be delivered for the event subscription. Uses Azure Event Grid's identity to acquire the authentication tokens being used during delivery / dead-lettering.	EventSubscriptionDestination
eventDeliverySchema	The event delivery schema for the event subscription.	'CloudEventSchemaV1_0' 'CustomInputSchema' 'EventGridSchema'
expirationTimeUtc	Expiration time of the event subscription.	string
filter	Information about the filter for the event subscription.	EventSubscriptionFilter
labels	List of user defined labels.	string[]
retryPolicy	The retry policy for events. This can be used to configure maximum number of delivery attempts and time to live for events.	RetryPolicy

HybridConnectionEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'HybridConnection' (required)
properties	Hybrid connection Properties of the event subscription destination.	HybridConnectionEventSubscriptionDestinationProperties

HybridConnectionEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
resourceId	The Azure Resource ID of an hybrid connection that is the destination of an event subscription.	string

IsNotNullAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'IsNotNull' (required)

IsNullOrUndefinedAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'IsNullOrUndefined' (required)

Microsoft.EventGrid/systemTopics/eventSubscriptions

Name	Description	Value
name	The resource name	string (required)
parent_id	The ID of the resource that is the parent for this resource.	ID for resource of type: systemTopics
properties	Properties of the event subscription.	EventSubscriptionProperties
type	The resource type	"Microsoft.EventGrid/systemTopics/eventSubscriptions@2024-06-01-preview"

MonitorAlertEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'MonitorAlert' (required)
properties	Monitor Alert properties of the event subscription destination.	MonitorAlertEventSubscriptionDestinationProperties

MonitorAlertEventSubscriptionDestinationProperties

Name	Description	Value
actionGroups	The list of ARM Ids of Action Groups that will be triggered on every Alert fired through this event subscription. Each resource ARM Id should follow this pattern: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Insights/actionGroups/{ActionGroupName}.	string[]
description	The description that will be attached to every Alert fired through this event subscription.	string
severity	The severity that will be attached to every Alert fired through this event subscription. This field must be provided.	'Sev0' 'Sev1' 'Sev2' 'Sev3' 'Sev4'

NamespaceTopicEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'NamespaceTopic' (required)
properties	Namespace Topic properties of the event subscription destination.	NamespaceTopicEventSubscriptionDestinationProperties

NamespaceTopicEventSubscriptionDestinationProperties

Name	Description	Value
resourceId	The Azure resource Id that represents the endpoint of the Event Grid Namespace Topic destination of an event subscription. This field is required and the Namespace Topic resource listed must already exist. The resource ARM Id should follow this pattern: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.EventGrid/namespaces/{NamespaceName}/topics/{TopicName}.	string

NumberGreaterThanAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberGreaterThan' (required)
value	The filter value.	int

NumberGreaterThanOrEqualsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberGreaterThanOrEquals' (required)
value	The filter value.	int

NumberInAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberIn' (required)
values	The set of filter values.	int[]

NumberInRangeAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberInRange' (required)
values	The set of filter values.	int[][]

NumberLessThanAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberLessThan' (required)
value	The filter value.	int

NumberLessThanOrEqualsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberLessThanOrEquals' (required)
value	The filter value.	int

NumberNotInAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberNotIn' (required)
values	The set of filter values.	int[]

NumberNotInRangeAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'NumberNotInRange' (required)
values	The set of filter values.	int[][]

PartnerEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'PartnerDestination' (required)
properties	Partner Destination Properties of the event subscription destination.	PartnerEventSubscriptionDestinationProperties

PartnerEventSubscriptionDestinationProperties

Name	Description	Value
resourceId	The Azure Resource Id that represents the endpoint of a Partner Destination of an event subscription.	string

RetryPolicy

Name	Description	Value
eventTimeToLiveInMinutes	Time To Live (in minutes) for events.	int
maxDeliveryAttempts	Maximum number of delivery retry attempts for events.	int

ServiceBusQueueEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'ServiceBusQueue' (required)
properties	Service Bus Properties of the event subscription destination.	ServiceBusQueueEventSubscriptionDestinationProperties

ServiceBusQueueEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
resourceId	The Azure Resource Id that represents the endpoint of the Service Bus destination of an event subscription.	string

ServiceBusTopicEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'ServiceBusTopic' (required)
properties	Service Bus Topic Properties of the event subscription destination.	ServiceBusTopicEventSubscriptionDestinationProperties

ServiceBusTopicEventSubscriptionDestinationProperties

Name	Description	Value
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
resourceId	The Azure Resource Id that represents the endpoint of the Service Bus Topic destination of an event subscription.	string

StaticDeliveryAttributeMapping

Name	Description	Value
properties	Properties of static delivery attribute mapping.	StaticDeliveryAttributeMappingProperties
type	Type of the delivery attribute or header name.	'Static' (required)

StaticDeliveryAttributeMappingProperties

Name	Description	Value
isSecret	Boolean flag to tell if the attribute contains sensitive information .	bool
value	Value of the delivery attribute.	string

StorageBlobDeadLetterDestination

Name	Description	Value
endpointType	Type of the endpoint for the dead letter destination	'StorageBlob' (required)
properties	The properties of the Storage Blob based deadletter destination	StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

Name	Description	Value
blobContainerName	The name of the Storage blob container that is the destination of the deadletter events	string
resourceId	The Azure Resource ID of the storage account that is the destination of the deadletter events	string

StorageQueueEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'StorageQueue' (required)
properties	Storage Queue Properties of the event subscription destination.	StorageQueueEventSubscriptionDestinationProperties

StorageQueueEventSubscriptionDestinationProperties

Name	Description	Value
queueMessageTimeToLiveInSeconds	Storage queue message time to live in seconds. This value cannot be zero or negative with the exception of using -1 to indicate that the Time To Live of the message is Infinite.	int
queueName	The name of the Storage queue under a storage account that is the destination of an event subscription.	string
resourceId	The Azure Resource ID of the storage account that contains the queue that is the destination of an event subscription.	string

StringBeginsWithAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringBeginsWith' (required)
values	The set of filter values.	string[]

StringContainsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringContains' (required)
values	The set of filter values.	string[]

StringEndsWithAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringEndsWith' (required)
values	The set of filter values.	string[]

StringInAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringIn' (required)
values	The set of filter values.	string[]

StringNotBeginsWithAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringNotBeginsWith' (required)
values	The set of filter values.	string[]

StringNotContainsAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringNotContains' (required)
values	The set of filter values.	string[]

StringNotEndsWithAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringNotEndsWith' (required)
values	The set of filter values.	string[]

StringNotInAdvancedFilter

Name	Description	Value
operatorType	The operator type used for filtering, e.g., NumberIn, StringContains, BoolEquals and others.	'StringNotIn' (required)
values	The set of filter values.	string[]

WebHookEventSubscriptionDestination

Name	Description	Value
endpointType	Type of the endpoint for the event subscription destination.	'WebHook' (required)
properties	WebHook Properties of the event subscription destination.	WebHookEventSubscriptionDestinationProperties

WebHookEventSubscriptionDestinationProperties

Name	Description	Value
azureActiveDirectoryApplicationIdOrUri	The Azure Active Directory Application ID or URI to get the access token that will be included as the bearer token in delivery requests.	string
azureActiveDirectoryTenantId	The Azure Active Directory Tenant ID to get the access token that will be included as the bearer token in delivery requests.	string
deliveryAttributeMappings	Delivery attribute details.	DeliveryAttributeMapping[]
endpointUrl	The URL that represents the endpoint of the destination of an event subscription.	string Constraints: Sensitive value. Pass in as a secure parameter.
maxEventsPerBatch	Maximum number of events per batch.	int
minimumTlsVersionAllowed	Minimum TLS version that should be supported by webhook endpoint	'1.0' '1.1' '1.2'
preferredBatchSizeInKilobytes	Preferred batch size in Kilobytes.	int