Compartir a través de

Microsoft.EventGrid eventSubscriptions 2019-06-01

  • Artículo

Definición de recursos de Bicep

El tipo de recurso eventSubscriptions es un recurso de extensión, lo que significa que puede aplicarlo a otro recurso.

Use la scope propiedad de este recurso para establecer el ámbito de este recurso. Consulte Establecimiento del ámbito en los recursos de extensión en Bicep.

El tipo de recurso eventSubscriptions se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.EventGrid/eventSubscriptions, agregue el siguiente bicep a la plantilla.

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

Objetos DeadLetterDestination

Establezca la propiedad endpointType para especificar el tipo de objeto.

Para StorageBlob, use:

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

Objetos EventSubscriptionDestination

Establezca la propiedad endpointType para especificar el tipo de objeto.

Para EventHub, use:

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

Para HybridConnection, use:

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

Para ServiceBusQueue, use:

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

Para StorageQueue, use:

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

Para WebHook, use:

  endpointType: 'WebHook'
  properties: {
    endpointUrl: 'string'
  }

Objetos AdvancedFilter

Establezca la propiedad operatorType para especificar el tipo de objeto.

Para BoolEquals, use:

  operatorType: 'BoolEquals'
  value: bool

Para NumberGreaterThan, use:

  operatorType: 'NumberGreaterThan'
  value: int

Para NumberGreaterThanOrEquals, use:

  operatorType: 'NumberGreaterThanOrEquals'
  value: int

Para NumberIn, use:

  operatorType: 'NumberIn'
  values: [
    int
  ]

Para NumberLessThan, use:

  operatorType: 'NumberLessThan'
  value: int

Para NumberLessThanOrEquals, use:

  operatorType: 'NumberLessThanOrEquals'
  value: int

Para NumberNotIn, use:

  operatorType: 'NumberNotIn'
  values: [
    int
  ]

Para StringBeginsWith, use:

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

Para StringContains, use:

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

Para StringEndsWith, use:

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

Para StringIn, use:

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

Para StringNotIn, use:

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

Valores de propiedad

eventSubscriptions

Nombre Descripción Value
name El nombre del recurso string (obligatorio)

Límite de caracteres: 3-64

Caracteres válidos:
Caracteres alfanuméricos y guiones.
scope Use al crear un recurso de extensión en un ámbito diferente del ámbito de implementación. Recurso de destino

Para Bicep, establezca esta propiedad en el nombre simbólico del recurso para aplicar el recurso de extensión.
properties Propiedades de la suscripción de eventos EventSubscriptionProperties

EventSubscriptionProperties

Nombre Descripción Valor
deadLetterDestination Destino DeadLetter de la suscripción de eventos. DeadLetterDestination
destination Información sobre el destino donde se deben entregar los eventos para la suscripción de eventos. EventSubscriptionDestination
expirationTimeUtc Hora de expiración de la suscripción de eventos. string
filter Información sobre el filtro de la suscripción de eventos. EventSubscriptionFilter
labels Lista de etiquetas definidas por el usuario. string[]
retryPolicy Directiva de reintento para eventos. Esto se puede usar para configurar el número máximo de intentos de entrega y el tiempo de vida de los eventos. RetryPolicy

DeadLetterDestination

Nombre Descripción Valor
endpointType Establecimiento del tipo de objeto StorageBlob (obligatorio)

StorageBlobDeadLetterDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de mensajes fallidos 'StorageBlob' (obligatorio)
properties Las propiedades del destino de la instancia de Storage Blob based deadletter StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

Nombre Descripción Valor
blobContainerName Nombre del contenedor de blobs de Storage que es el destino de los eventos de mensajes fallidos. string
resourceId El identificador de recurso de Azure de la cuenta de almacenamiento que es el destino de los eventos fallidos. string

EventSubscriptionDestination

Nombre Descripción Valor
endpointType Establecimiento del tipo de objeto EventHub
HybridConnection
ServiceBusQueue
StorageQueue
WebHook (obligatorio)

EventHubEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos 'EventHub' (obligatorio)
properties Propiedades del centro de eventos del destino de la suscripción de eventos EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

Nombre Descripción Value
resourceId Identificador de recurso de Azure que representa el punto de conexión de un destino del centro de eventos de una suscripción de eventos. string

HybridConnectionEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos "HybridConnection" (obligatorio)
properties Propiedades de conexión híbrida del destino de la suscripción de eventos HybridConnectionEventSubscriptionDestinationProperti...

HybridConnectionEventSubscriptionDestinationProperti...

Nombre Descripción Value
resourceId Identificador de recurso de Azure de una conexión híbrida que es el destino de una suscripción de eventos. string

ServiceBusQueueEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos 'ServiceBusQueue' (obligatorio)
properties Propiedades de Service Bus del destino de la suscripción de eventos ServiceBusQueueEventSubscriptionDestinationPropertie...

ServiceBusQueueEventSubscriptionDestinationPropertie...

Nombre Descripción Value
resourceId Identificador de recurso de Azure que representa el punto de conexión del destino de Service Bus de una suscripción de eventos. string

StorageQueueEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos "StorageQueue" (obligatorio)
properties Propiedades de la cola de almacenamiento del destino de la suscripción de eventos StorageQueueEventSubscriptionDestinationProperties

StorageQueueEventSubscriptionDestinationProperties

Nombre Descripción Valor
queueName Nombre de la cola de Storage en una cuenta de almacenamiento que es el destino de una suscripción de eventos. string
resourceId Identificador de recurso de Azure de la cuenta de almacenamiento que contiene la cola que es el destino de una suscripción de eventos. string

WebHookEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos 'WebHook' (obligatorio)
properties Propiedades de webHook del destino de la suscripción de eventos WebHookEventSubscriptionDestinationProperties

WebHookEventSubscriptionDestinationProperties

Nombre Descripción Valor
endpointUrl Dirección URL que representa el punto de conexión del destino de una suscripción de eventos. string

EventSubscriptionFilter

Nombre Descripción Valor
advancedFilters Matriz de filtros avanzados que se usan para filtrar suscripciones de eventos. AdvancedFilter[]
includedEventTypes Lista de tipos de eventos aplicables que deben formar parte de la suscripción de eventos. Si desea suscribirse a todos los tipos de eventos predeterminados, establezca IncludedEventTypes en null. string[]
isSubjectCaseSensitive Especifica si las propiedades SubjectBeginsWith y SubjectEndsWith del filtro
debe compararse de una manera que distingue mayúsculas de minúsculas.		 bool
subjectBeginsWith Cadena opcional para filtrar los eventos de una suscripción de eventos en función de un prefijo de ruta de acceso de recurso.
El formato de esto depende del publicador de los eventos.
No se admiten caracteres comodín en esta ruta de acceso.		 string
subjectEndsWith Cadena opcional para filtrar los eventos de una suscripción de eventos en función de un sufijo de ruta de acceso de recurso.
No se admiten caracteres comodín en esta ruta de acceso.
 string

AdvancedFilter

Nombre Descripción Valor
key Campo o propiedad del evento en función del cual desea filtrar. string
operatorType Establecimiento del tipo de objeto BoolEquals
NumberGreaterThan
NumberGreaterThanOrEquals
NumberIn
NumberLessThan
NumberLessThanOrEquals
NumberNotIn
StringBeginsWith
StringContains
StringEndsWith
StringIn
StringNotIn (obligatorio)

BoolEqualsAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'BoolEquals' (obligatorio)
value Valor de filtro booleano. bool

NumberGreaterThanAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'NumberGreaterThan' (obligatorio)
value El valor de filtro. int

NumberGreaterThanOrEqualsAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'NumberGreaterThanOrEquals' (obligatorio)
value El valor de filtro. int

NumberInAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'NumberIn' (obligatorio)
valores Conjunto de valores de filtro. int[]

NumberLessThanAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'NumberLessThan' (obligatorio)
value El valor de filtro. int

NumberLessThanOrEqualsAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'NumberLessThanOrEquals' (obligatorio)
value El valor de filtro. int

NumberNotInAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'NumberNotIn' (obligatorio)
valores Conjunto de valores de filtro. int[]

StringBeginsWithAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'StringBeginsWith' (obligatorio)
valores Conjunto de valores de filtro. string[]

StringContainsAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'StringContains' (obligatorio)
valores Conjunto de valores de filtro. string[]

StringEndsWithAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'StringEndsWith' (obligatorio)
valores Conjunto de valores de filtro. string[]

StringInAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'StringIn' (obligatorio)
valores Conjunto de valores de filtro. string[]

StringNotInAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'StringNotIn' (obligatorio)
valores Conjunto de valores de filtro. string[]

RetryPolicy

Nombre Descripción Valor
eventTimeToLiveInMinutes Período de vida (en minutos) para eventos. int
maxDeliveryAttempts Número máximo de reintentos de entrega para eventos. int

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Crear Azure Event Grid tema personalizado y suscripción

Implementación en Azure		 Crea un Azure Event Grid tema personalizado y una suscripción de webhook. Plantilla originalmente creadas por John Downs.
Tema o suscripción de Azure Event Grid personalizados con CloudEvents

Implementación en Azure		 Crea un tema de Azure Event Grid personalizado, una suscripción de webhook que tiene el esquema CloudEvents y una aplicación lógica como controlador de eventos. Plantilla originalmente creadas por Justin Yoo.
Creación de un tema personalizado de Event Grid y un controlador del centro de eventos

Implementación en Azure		 Crea un Azure Event Grid tema personalizado y centro de eventos para controlar los eventos.
Creación de una suscripción de Event Grid para eventos de recursos

Implementación en Azure		 Crea una suscripción de Event Grid a un grupo de recursos o a una suscripción de Azure.
Crear Azure Event Grid tema personalizado y suscripción de cola

Implementación en Azure		 Crea un Azure Event Grid tema personalizado y una suscripción de cola de Service Bus. Plantilla originalmente creadas por Markus Meyer.
Crear Azure Event Grid suscripción a temas personalizados

Implementación en Azure		 Crea un Azure Event Grid tema personalizado y una suscripción de tema de Service Bus. Plantilla originalmente creadas por Markus Meyer.

Definición de recursos de plantilla de ARM

El tipo de recurso eventSubscriptions es un recurso de extensión, lo que significa que puede aplicarlo a otro recurso.

Use la scope propiedad de este recurso para establecer el ámbito de este recurso. Consulte Establecimiento del ámbito en los recursos de extensión en plantillas de ARM.

El tipo de recurso eventSubscriptions se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.EventGrid/eventSubscriptions, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.EventGrid/eventSubscriptions",
  "apiVersion": "2019-06-01",
  "name": "string",
  "scope": "string",
  "properties": {
    "deadLetterDestination": {
      "endpointType": "string"
      // For remaining properties, see DeadLetterDestination objects
    },
    "destination": {
      "endpointType": "string"
      // For remaining properties, see EventSubscriptionDestination objects
    },
    "expirationTimeUtc": "string",
    "filter": {
      "advancedFilters": [
        {
          "key": "string",
          "operatorType": "string"
          // For remaining properties, see AdvancedFilter objects
        }
      ],
      "includedEventTypes": [ "string" ],
      "isSubjectCaseSensitive": "bool",
      "subjectBeginsWith": "string",
      "subjectEndsWith": "string"
    },
    "labels": [ "string" ],
    "retryPolicy": {
      "eventTimeToLiveInMinutes": "int",
      "maxDeliveryAttempts": "int"
    }
  }
}

Objetos DeadLetterDestination

Establezca la propiedad endpointType para especificar el tipo de objeto.

Para StorageBlob, use:

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

Objetos EventSubscriptionDestination

Establezca la propiedad endpointType para especificar el tipo de objeto.

Para EventHub, use:

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

Para HybridConnection, use:

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

Para ServiceBusQueue, use:

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

Para StorageQueue, use:

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

Para WebHook, use:

  "endpointType": "WebHook",
  "properties": {
    "endpointUrl": "string"
  }

Objetos AdvancedFilter

Establezca la propiedad operatorType para especificar el tipo de objeto.

Para BoolEquals, use:

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

Para NumberGreaterThan, use:

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

Para NumberGreaterThanOrEquals, use:

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

Para NumberIn, use:

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

Para NumberLessThan, use:

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

Para NumberLessThanOrEquals, use:

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

Para NumberNotIn, use:

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

Para StringBeginsWith, use:

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

Para StringContains, use:

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

Para StringEndsWith, use:

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

Para StringIn, use:

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

Para StringNotIn, use:

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

Valores de propiedad

eventSubscriptions

Nombre Descripción Value
type Tipo de recurso 'Microsoft.EventGrid/eventSubscriptions'
apiVersion La versión de la API de recursos '2019-06-01'
name El nombre del recurso string (obligatorio)

Límite de caracteres: 3-64

Caracteres válidos:
Caracteres alfanuméricos y guiones.
scope Use al crear un recurso de extensión en un ámbito diferente al ámbito de implementación. Recurso de destino

Para JSON, establezca el valor en el nombre completo del recurso al que se aplicará el recurso de extensión .
properties Propiedades de la suscripción de eventos EventSubscriptionProperties

EventSubscriptionProperties

Nombre Descripción Valor
deadLetterDestination Destino DeadLetter de la suscripción de eventos. DeadLetterDestination
destination Información sobre el destino en el que se deben entregar los eventos para la suscripción de eventos. EventSubscriptionDestination
expirationTimeUtc Hora de expiración de la suscripción de eventos. string
filter Información sobre el filtro de la suscripción de eventos. EventSubscriptionFilter
labels Lista de etiquetas definidas por el usuario. string[]
retryPolicy Directiva de reintento para eventos. Esto se puede usar para configurar el número máximo de intentos de entrega y el tiempo de vida de los eventos. RetryPolicy

DeadLetterDestination

Nombre Descripción Valor
endpointType Establecimiento del tipo de objeto StorageBlob (obligatorio)

StorageBlobDeadLetterDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de mensajes fallidos 'StorageBlob' (obligatorio)
properties Las propiedades del destino de mensajes fallidos basados en Storage Blob StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

Nombre Descripción Valor
blobContainerName Nombre del contenedor de blobs de Storage que es el destino de los eventos deadletter. string
resourceId Identificador de recurso de Azure de la cuenta de almacenamiento que es el destino de los eventos deadletter. string

EventSubscriptionDestination

Nombre Descripción Valor
endpointType Establecimiento del tipo de objeto EventHub
HybridConnection
ServiceBusQueue
StorageQueue
WebHook (obligatorio)

EventHubEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos 'EventHub' (obligatorio)
properties Propiedades del centro de eventos del destino de la suscripción de eventos EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

Nombre Descripción Value
resourceId Identificador de recurso de Azure que representa el punto de conexión de un destino del centro de eventos de una suscripción de eventos. string

HybridConnectionEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos 'HybridConnection' (obligatorio)
properties Propiedades de conexión híbrida del destino de la suscripción de eventos HybridConnectionEventSubscriptionDestinationProperti...

HybridConnectionEventSubscriptionDestinationProperti...

Nombre Descripción Value
resourceId Identificador de recurso de Azure de una conexión híbrida que es el destino de una suscripción de eventos. string

ServiceBusQueueEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos 'ServiceBusQueue' (obligatorio)
properties Propiedades de Service Bus del destino de la suscripción de eventos ServiceBusQueueEventSubscriptionDestinationPropertie...

ServiceBusQueueEventSubscriptionDestinationPropertie...

Nombre Descripción Value
resourceId Identificador de recurso de Azure que representa el punto de conexión del destino de Service Bus de una suscripción de eventos. string

StorageQueueEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos 'StorageQueue' (obligatorio)
properties Propiedades de la cola de almacenamiento del destino de la suscripción de eventos StorageQueueEventSubscriptionDestinationProperties

StorageQueueEventSubscriptionDestinationProperties

Nombre Descripción Valor
queueName Nombre de la cola de Storage en una cuenta de almacenamiento que es el destino de una suscripción de eventos. string
resourceId Identificador de recurso de Azure de la cuenta de almacenamiento que contiene la cola que es el destino de una suscripción de eventos. string

WebHookEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos 'WebHook' (obligatorio)
properties Propiedades de webHook del destino de la suscripción de eventos WebHookEventSubscriptionDestinationProperties

WebHookEventSubscriptionDestinationProperties

Nombre Descripción Valor
endpointUrl Dirección URL que representa el punto de conexión del destino de una suscripción de eventos. string

EventSubscriptionFilter

Nombre Descripción Valor
advancedFilters Matriz de filtros avanzados que se usan para filtrar suscripciones de eventos. AdvancedFilter[]
includedEventTypes Lista de tipos de eventos aplicables que deben formar parte de la suscripción de eventos. Si desea suscribirse a todos los tipos de eventos predeterminados, establezca IncludedEventTypes en null. string[]
isSubjectCaseSensitive Especifica si las propiedades SubjectBeginsWith y SubjectEndsWith del filtro
debe compararse de una manera sensible a mayúsculas y minúsculas.		 bool
subjectBeginsWith Cadena opcional para filtrar eventos de una suscripción de eventos en función de un prefijo de ruta de acceso de recurso.
El formato de esto depende del publicador de los eventos.
Los caracteres comodín no se admiten en esta ruta de acceso.		 string
subjectEndsWith Cadena opcional para filtrar eventos de una suscripción de eventos en función de un sufijo de ruta de acceso de recurso.
Los caracteres comodín no se admiten en esta ruta de acceso.
 string

AdvancedFilter

Nombre Descripción Valor
key Campo o propiedad en el evento en función del cual desea filtrar. string
operatorType Establecimiento del tipo de objeto BoolEquals
NumberGreaterThan
NumberGreaterThanOrEquals
NumberIn
NumberLessThan
NumberLessThanOrEquals
NumberNotIn
StringBeginsWith
StringContains
StringEndsWith
StringIn
StringNotIn (obligatorio)

BoolEqualsAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador utilizado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'BoolEquals' (obligatorio)
value Valor de filtro booleano. bool

NumberGreaterThanAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador utilizado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'NumberGreaterThan' (obligatorio)
value El valor de filtro. int

NumberGreaterThanOrEqualsAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'NumberGreaterThanOrEquals' (obligatorio)
value El valor de filtro. int

NumberInAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'NumberIn' (obligatorio)
valores Conjunto de valores de filtro. int[]

NumberLessThanAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'NumberLessThan' (obligatorio)
value El valor de filtro. int

NumberLessThanOrEqualsAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'NumberLessThanOrEquals' (obligatorio)
value El valor de filtro. int

NumberNotInAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'NumberNotIn' (obligatorio)
valores Conjunto de valores de filtro. int[]

StringBeginsWithAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'StringBeginsWith' (obligatorio)
valores Conjunto de valores de filtro. string[]

StringContainsAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'StringContains' (obligatorio)
valores Conjunto de valores de filtro. string[]

StringEndsWithAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'StringEndsWith' (obligatorio)
valores Conjunto de valores de filtro. string[]

StringInAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'StringIn' (obligatorio)
valores Conjunto de valores de filtro. string[]

StringNotInAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. 'StringNotIn' (obligatorio)
valores Conjunto de valores de filtro. string[]

RetryPolicy

Nombre Descripción Valor
eventTimeToLiveInMinutes Período de vida (en minutos) para eventos. int
maxDeliveryAttempts Número máximo de reintentos de entrega para eventos. int

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Crear Azure Event Grid tema personalizado y suscripción

Implementación en Azure		 Crea un Azure Event Grid tema personalizado y una suscripción de webhook. Plantilla originalmente creadas por John Downs.
Tema o suscripción de Azure Event Grid personalizados con CloudEvents

Implementación en Azure		 Crea un tema de Azure Event Grid personalizado, una suscripción de webhook que tiene el esquema CloudEvents y una aplicación lógica como controlador de eventos. Plantilla originalmente creadas por Justin Yoo.
Creación de un tema personalizado de Event Grid y un controlador del centro de eventos

Implementación en Azure		 Crea un Azure Event Grid tema personalizado y centro de eventos para controlar los eventos.
Creación de una suscripción de Event Grid para eventos de recursos

Implementación en Azure		 Crea una suscripción de Event Grid a un grupo de recursos o a una suscripción de Azure.
Crear Azure Event Grid tema personalizado y suscripción de cola

Implementación en Azure		 Crea un Azure Event Grid tema personalizado y una suscripción de cola de Service Bus. Plantilla originalmente creadas por Markus Meyer.
Crear Azure Event Grid suscripción a temas personalizados

Implementación en Azure		 Crea un Azure Event Grid tema personalizado y una suscripción de tema de Service Bus. Plantilla originalmente creadas por Markus Meyer.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso eventSubscriptions es un recurso de extensión, lo que significa que puede aplicarlo a otro recurso.

Use la parent_id propiedad de este recurso para establecer el ámbito de este recurso.

El tipo de recurso eventSubscriptions se puede implementar con operaciones que tienen como destino:

  • Grupos de recursos
  • Suscripciones

Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.EventGrid/eventSubscriptions, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/eventSubscriptions@2019-06-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      deadLetterDestination = {
        endpointType = "string"
        // For remaining properties, see DeadLetterDestination objects
      }
      destination = {
        endpointType = "string"
        // For remaining properties, see EventSubscriptionDestination objects
      }
      expirationTimeUtc = "string"
      filter = {
        advancedFilters = [
          {
            key = "string"
            operatorType = "string"
            // For remaining properties, see AdvancedFilter objects
          }
        ]
        includedEventTypes = [
          "string"
        ]
        isSubjectCaseSensitive = bool
        subjectBeginsWith = "string"
        subjectEndsWith = "string"
      }
      labels = [
        "string"
      ]
      retryPolicy = {
        eventTimeToLiveInMinutes = int
        maxDeliveryAttempts = int
      }
    }
  })
}

Objetos DeadLetterDestination

Establezca la propiedad endpointType para especificar el tipo de objeto.

Para StorageBlob, use:

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

Objetos EventSubscriptionDestination

Establezca la propiedad endpointType para especificar el tipo de objeto.

Para EventHub, use:

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

Para HybridConnection, use:

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

Para ServiceBusQueue, use:

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

Para StorageQueue, use:

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

Para WebHook, use:

  endpointType = "WebHook"
  properties = {
    endpointUrl = "string"
  }

Objetos AdvancedFilter

Establezca la propiedad operatorType para especificar el tipo de objeto.

Para BoolEquals, use:

  operatorType = "BoolEquals"
  value = bool

Para NumberGreaterThan, use:

  operatorType = "NumberGreaterThan"
  value = int

Para NumberGreaterThanOrEquals, use:

  operatorType = "NumberGreaterThanOrEquals"
  value = int

Para NumberIn, use:

  operatorType = "NumberIn"
  values = [
    int
  ]

Para NumberLessThan, use:

  operatorType = "NumberLessThan"
  value = int

Para NumberLessThanOrEquals, use:

  operatorType = "NumberLessThanOrEquals"
  value = int

Para NumberNotIn, use:

  operatorType = "NumberNotIn"
  values = [
    int
  ]

Para StringBeginsWith, use:

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

Para StringContains, use:

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

Para StringEndsWith, use:

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

Para StringIn, use:

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

Para StringNotIn, use:

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

Valores de propiedad

eventSubscriptions

Nombre Descripción Value
type Tipo de recurso "Microsoft.EventGrid/eventSubscriptions@2019-06-01"
name El nombre del recurso string (obligatorio)

Límite de caracteres: 3-64

Caracteres válidos:
Caracteres alfanuméricos y guiones.
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. string (obligatorio)
properties Propiedades de la suscripción de eventos EventSubscriptionProperties

EventSubscriptionProperties

Nombre Descripción Valor
deadLetterDestination Destino DeadLetter de la suscripción de eventos. DeadLetterDestination
destination Información sobre el destino en el que se deben entregar los eventos para la suscripción de eventos. EventSubscriptionDestination
expirationTimeUtc Hora de expiración de la suscripción de eventos. string
filter Información sobre el filtro de la suscripción de eventos. EventSubscriptionFilter
labels Lista de etiquetas definidas por el usuario. string[]
retryPolicy Directiva de reintento para eventos. Se puede usar para configurar el número máximo de intentos de entrega y el tiempo de vida de los eventos. RetryPolicy

DeadLetterDestination

Nombre Descripción Valor
endpointType Establecimiento del tipo de objeto StorageBlob (obligatorio)

StorageBlobDeadLetterDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de mensajes fallidos "StorageBlob" (obligatorio)
properties Las propiedades del destino de la instancia de Storage Blob based deadletter StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

Nombre Descripción Valor
blobContainerName Nombre del contenedor de blobs de Storage que es el destino de los eventos de mensajes fallidos. string
resourceId El identificador de recurso de Azure de la cuenta de almacenamiento que es el destino de los eventos fallidos. string

EventSubscriptionDestination

Nombre Descripción Valor
endpointType Establecimiento del tipo de objeto EventHub
HybridConnection
ServiceBusQueue
StorageQueue
WebHook (obligatorio)

EventHubEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos "EventHub" (obligatorio)
properties Propiedades del centro de eventos del destino de la suscripción de eventos EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

Nombre Descripción Value
resourceId Identificador de recurso de Azure que representa el punto de conexión de un destino del centro de eventos de una suscripción de eventos. string

HybridConnectionEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos "HybridConnection" (obligatorio)
properties Propiedades de conexión híbrida del destino de la suscripción de eventos HybridConnectionEventSubscriptionDestinationProperti...

HybridConnectionEventSubscriptionDestinationProperti...

Nombre Descripción Value
resourceId Identificador de recurso de Azure de una conexión híbrida que es el destino de una suscripción de eventos. string

ServiceBusQueueEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos "ServiceBusQueue" (obligatorio)
properties Propiedades de Service Bus del destino de la suscripción de eventos ServiceBusQueueEventSubscriptionDestinationPropertie...

ServiceBusQueueEventSubscriptionDestinationPropertie...

Nombre Descripción Value
resourceId Identificador de recurso de Azure que representa el punto de conexión del destino de Service Bus de una suscripción de eventos. string

StorageQueueEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos "StorageQueue" (obligatorio)
properties Propiedades de la cola de almacenamiento del destino de la suscripción de eventos StorageQueueEventSubscriptionDestinationProperties

StorageQueueEventSubscriptionDestinationProperties

Nombre Descripción Valor
queueName Nombre de la cola de Storage en una cuenta de almacenamiento que es el destino de una suscripción de eventos. string
resourceId Identificador de recurso de Azure de la cuenta de almacenamiento que contiene la cola que es el destino de una suscripción de eventos. string

WebHookEventSubscriptionDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de la suscripción de eventos "WebHook" (obligatorio)
properties Propiedades de webHook del destino de la suscripción de eventos WebHookEventSubscriptionDestinationProperties

WebHookEventSubscriptionDestinationProperties

Nombre Descripción Valor
endpointUrl Dirección URL que representa el punto de conexión del destino de una suscripción de eventos. string

EventSubscriptionFilter

Nombre Descripción Valor
advancedFilters Matriz de filtros avanzados que se usan para filtrar suscripciones de eventos. AdvancedFilter[]
includedEventTypes Lista de tipos de eventos aplicables que deben formar parte de la suscripción de eventos. Si desea suscribirse a todos los tipos de eventos predeterminados, establezca IncludedEventTypes en null. string[]
isSubjectCaseSensitive Especifica si las propiedades SubjectBeginsWith y SubjectEndsWith del filtro
debe compararse de una manera que distingue mayúsculas de minúsculas.		 bool
subjectBeginsWith Cadena opcional para filtrar los eventos de una suscripción de eventos en función de un prefijo de ruta de acceso de recurso.
El formato de esto depende del publicador de los eventos.
No se admiten caracteres comodín en esta ruta de acceso.		 string
subjectEndsWith Cadena opcional para filtrar los eventos de una suscripción de eventos en función de un sufijo de ruta de acceso de recurso.
No se admiten caracteres comodín en esta ruta de acceso.
 string

AdvancedFilter

Nombre Descripción Valor
key Campo o propiedad del evento en función del cual desea filtrar. string
operatorType Establecimiento del tipo de objeto BoolEquals
NumberGreaterThan
NumberGreaterThanOrEquals
NumberIn
NumberLessThan
NumberLessThanOrEquals
NumberNotIn
StringBeginsWith
StringContains
StringEndsWith
StringIn
StringNotIn (obligatorio)

BoolEqualsAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. "BoolEquals" (obligatorio)
value Valor de filtro booleano. bool

NumberGreaterThanAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. "NumberGreaterThan" (obligatorio)
value El valor de filtro. int

NumberGreaterThanOrEqualsAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. "NumberGreaterThanOrEquals" (obligatorio)
value El valor de filtro. int

NumberInAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. "NumberIn" (obligatorio)
valores Conjunto de valores de filtro. int[]

NumberLessThanAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. "NumberLessThan" (obligatorio)
value El valor de filtro. int

NumberLessThanOrEqualsAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. "NumberLessThanOrEquals" (obligatorio)
value El valor de filtro. int

NumberNotInAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. "NumberNotIn" (obligatorio)
valores Conjunto de valores de filtro. int[]

StringBeginsWithAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. "StringBeginsWith" (obligatorio)
valores Conjunto de valores de filtro. string[]

StringContainsAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. "StringContains" (obligatorio)
valores Conjunto de valores de filtro. string[]

StringEndsWithAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. "StringEndsWith" (obligatorio)
valores Conjunto de valores de filtro. string[]

StringInAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. "StringIn" (obligatorio)
valores Conjunto de valores de filtro. string[]

StringNotInAdvancedFilter

Nombre Descripción Valor
operatorType Tipo de operador usado para filtrar, por ejemplo, NumberIn, StringContains, BoolEquals y otros. "StringNotIn" (obligatorio)
valores Conjunto de valores de filtro. string[]

RetryPolicy

Nombre Descripción Valor
eventTimeToLiveInMinutes Período de vida (en minutos) para eventos. int
maxDeliveryAttempts Número máximo de reintentos de entrega para eventos. int