Compartir a través de


Espacios de nombres Microsoft.EventGrid/topics/eventSubscriptions 2023-06-01-preview

Definición de recursos de Bicep

El tipo de recurso namespaces/topics/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 recurso

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

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

Objetos DeadLetterDestination

Establezca la propiedad endpointType para especificar el tipo de objeto.

Para StorageBlob, use:

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

Filtrar objetos

Establezca la propiedad operatorType para especificar el tipo de objeto.

Para boolEquals, use:

{
  operatorType: 'BoolEquals'
  value: bool
}

Para IsNotNull, use:

{
  operatorType: 'IsNotNull'
}

Para isNullOrUndefined, use:

{
  operatorType: 'IsNullOrUndefined'
}

Para NumberGreaterThan, use:

{
  operatorType: 'NumberGreaterThan'
  value: int
}

Para NumberGreaterThanOrEquals, use:

{
  operatorType: 'NumberGreaterThanOrEquals'
  value: int
}

Para NumberIn, use:

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

Para NumberInRange, use:

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

Para NumberLessThan, use:

{
  operatorType: 'NumberLessThan'
  value: int
}

Para NumberLessThanOrEquals, use:

{
  operatorType: 'NumberLessThanOrEquals'
  value: int
}

Para NumberNotIn, use:

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

Para NumberNotInRange, use:

{
  operatorType: 'NumberNotInRange'
  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 StringNotBeginsWith, use:

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

Para StringNotContains, use:

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

Para StringNotEndsWith, use:

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

Para StringNotIn, use:

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

Valores de propiedad

BoolEqualsFilter

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

DeadLetterDestination

Nombre Descripción Valor
endpointType Establezca en "StorageBlob" para el tipo StorageBlobDeadLetterDestination. 'StorageBlob' (obligatorio)

DeadLetterWithResourceIdentity

Nombre Descripción Valor
deadLetterDestination Información sobre el destino en el que se deben entregar los eventos para la suscripción de eventos.
Usa la configuración de identidad administrada en el recurso primario (es decir, tema o dominio) para adquirir los tokens de autenticación que se usan durante la entrega o mensajes fallidos.
DeadLetterDestination
identidad Identidad que se va a usar cuando se produzcan eventos de mensajes fallidos. EventSubscriptionIdentity

DeliveryConfiguration

Nombre Descripción Valor
deliveryMode Modo de entrega de la suscripción de eventos. 'Cola'
cola Esta propiedad debe rellenarse cuando deliveryMode es queue y representa información sobre la suscripción de cola. queueInfo

EventSubscriptionIdentity

Nombre Descripción Valor
tipo Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará cualquier identidad. 'SystemAssigned'
'UserAssigned'
userAssignedIdentity Identidad de usuario asociada al recurso. cuerda

Filtro

Nombre Descripción Valor
llave Campo o propiedad del evento en función del cual desea filtrar. cuerda
operatorType Establezca en "BoolEquals" para el tipo BoolEqualsFilter. Establezca en "IsNotNull" para el tipo IsNotNullFilter. Establezca en "IsNullOrUndefined" para el tipo IsNullOrUndefinedFilter. Establezca en "NumberGreaterThan" para el tipo NumberGreaterThanFilter. Establezca en "NumberGreaterThanOrEquals" para el tipo NumberGreaterThanOrEqualsFilter. Establezca en "NumberIn" para el tipo NumberInFilter. Establezca en "NumberInRange" para el tipo NumberInRangeFilter. Establezca en "NumberLessThan" para el tipo NumberLessThanFilter. Establezca en "NumberLessThanOrEquals" para el tipo NumberLessThanOrEqualsFilter. Establezca en "NumberNotIn" para el tipo NumberNotInFilter. Establezca en "NumberNotInRange" para el tipo NumberNotInRangeFilter. Establezca en "StringBeginsWith" para el tipo StringBeginsWithFilter. Establezca en "StringContains" para el tipo StringContainsFilter. Establezca en "StringEndsWith" para el tipo StringEndsWithFilter. Establezca en "StringIn" para el tipo StringInFilter. Establezca en "StringNotBeginsWith" para el tipo StringNotBeginsWithFilter. Establezca en "StringNotContains" para el tipo StringNotContainsFilter. Establezca en "StringNotEndsWith" para el tipo StringNotEndsWithFilter. Establezca en "StringNotIn" para el tipo StringNotInFilter. 'BoolEquals'
'IsNotNull'
'IsNullOrUndefined'
'NumberGreaterThan'
'NumberGreaterThanOrEquals'
'NumberIn'
'NumberInRange'
'NumberLessThan'
'NumberLessThanOrEquals'
'NumberNotIn'
'NumberNotInRange'
'StringBeginsWith'
'StringContains'
'StringEndsWith'
'StringIn'
'StringNotBeginsWith'
'StringNotContains'
'StringNotEndsWith'
'StringNotIn' (obligatorio)

FiltersConfiguration

Nombre Descripción Valor
filtros Matriz de filtros que se usan para filtrar suscripciones de eventos. filtro[]
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[]

IsNotNullFilter

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

IsNullOrUndefinedFilter

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

Microsoft.EventGrid/namespaces/topics/eventSubscriptions

Nombre Descripción Valor
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 50
Patrón = ^[a-zA-Z0-9-]*$ (obligatorio)
padre En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.
Nombre simbólico del recurso de tipo: espacios de nombres o temas
Propiedades Propiedades de la suscripción de eventos. subscriptionProperties

NumberGreaterThanFilter

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

NumberGreaterThanOrEqualsFilter

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

NumberInFilter

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

NumberInRangeFilter

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

NumberLessThanFilter

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

NumberLessThanOrEqualsFilter

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

NumberNotInFilter

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

NumberNotInRangeFilter

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

QueueInfo

Nombre Descripción Valor
deadLetterDestinationWithResourceIdentity Destino de mensajes fallidos de la suscripción de eventos. Cualquier evento que no se pueda entregar a su destino se envía al destino de mensajes fallidos.
Usa la configuración de identidad administrada en el recurso primario (es decir, tema) para adquirir los tokens de autenticación que se usan durante la entrega o los mensajes fallidos.
DeadLetterWithResourceIdentity
eventTimeToLive Duración del intervalo de tiempo en formato ISO 8601 que determina cuánto tiempo están disponibles los mensajes para la suscripción desde el momento en que se publicó el mensaje.
Este valor de duración se expresa con el siguiente formato: 'P(n)Y(n)M(n)DT(n)H(n)M(n)S', donde:
- (n) se reemplaza por el valor de cada elemento de hora que sigue a (n).
- P es el designador de duración (o período) y siempre se coloca al principio de la duración.
- Y es el designador de año y sigue el valor del número de años.
- M es el designador de mes y sigue el valor del número de meses.
- W es el designador de semana y sigue el valor del número de semanas.
- D es el designador de día y sigue el valor del número de días.
- T es el designador de tiempo y precede a los componentes de hora.
- H es el designador de hora y sigue el valor del número de horas.
- M es el designador de minutos y sigue el valor del número de minutos.
- S es el segundo designador y sigue el valor del número de segundos.
Este valor de duración no se puede establecer mayor que EventRetentionInDays del tema. Es un campo opcional donde su valor mínimo es de 1 minuto y se determina su máximo.
por el valor EventRetentionInDays del tema. A continuación se muestran ejemplos de valores válidos:
- "P0DT23H12M" o "PT23H12M": durante 23 horas y 12 minutos.
- "P1D" o "P1DT0H0M0S": durante 1 día.
cuerda
maxDeliveryCount Recuento máximo de entregas de los eventos. Int
receiveLockDurationInSeconds Período máximo en segundos en el que una vez que el mensaje está en estado recibido (por el cliente) y esperando ser aceptado, liberado o rechazado.
Si este tiempo ha transcurrido después de que el cliente haya recibido un mensaje y no haya pasado a aceptado (no procesado), liberado o rechazado,
el mensaje está disponible para redelivery. Se trata de un campo opcional, donde el valor predeterminado es 60 segundos, el mínimo es de 60 segundos y el máximo es de 300 segundos.
Int

StorageBlobDeadLetterDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de mensajes fallidos 'StorageBlob' (obligatorio)
Propiedades Las propiedades del destino de deadletter basado en blobs de almacenamiento StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

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

StringBeginsWithFilter

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

StringContainsFilter

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

StringEndsWithFilter

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

StringInFilter

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

StringNotBeginsWithFilter

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

StringNotContainsFilter

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

StringNotEndsWithFilter

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

StringNotInFilter

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

SubscriptionProperties

Nombre Descripción Valor
deliveryConfiguration Información sobre la configuración de entrega de la suscripción de eventos. DeliveryConfiguration
eventDeliverySchema Esquema de entrega de eventos para la suscripción de eventos. "CloudEventSchemaV1_0"
filtersConfiguration Información sobre el filtro de la suscripción de eventos. FiltersConfiguration

Definición de recursos de plantilla de ARM

El tipo de recurso namespaces/topics/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 recurso

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

{
  "type": "Microsoft.EventGrid/namespaces/topics/eventSubscriptions",
  "apiVersion": "2023-06-01-preview",
  "name": "string",
  "properties": {
    "deliveryConfiguration": {
      "deliveryMode": "string",
      "queue": {
        "deadLetterDestinationWithResourceIdentity": {
          "deadLetterDestination": {
            "endpointType": "string"
            // For remaining properties, see DeadLetterDestination objects
          },
          "identity": {
            "type": "string",
            "userAssignedIdentity": "string"
          }
        },
        "eventTimeToLive": "string",
        "maxDeliveryCount": "int",
        "receiveLockDurationInSeconds": "int"
      }
    },
    "eventDeliverySchema": "string",
    "filtersConfiguration": {
      "filters": [ {
        "key": "string",
        "operatorType": "string"
        // For remaining properties, see Filter objects
      } ],
      "includedEventTypes": [ "string" ]
    }
  }
}

Objetos DeadLetterDestination

Establezca la propiedad endpointType para especificar el tipo de objeto.

Para StorageBlob, use:

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

Filtrar objetos

Establezca la propiedad operatorType para especificar el tipo de objeto.

Para boolEquals, use:

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

Para IsNotNull, use:

{
  "operatorType": "IsNotNull"
}

Para isNullOrUndefined, use:

{
  "operatorType": "IsNullOrUndefined"
}

Para NumberGreaterThan, use:

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

Para NumberGreaterThanOrEquals, use:

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

Para NumberIn, use:

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

Para NumberInRange, use:

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

Para NumberLessThan, use:

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

Para NumberLessThanOrEquals, use:

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

Para NumberNotIn, use:

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

Para NumberNotInRange, use:

{
  "operatorType": "NumberNotInRange",
  "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 StringNotBeginsWith, use:

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

Para StringNotContains, use:

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

Para StringNotEndsWith, use:

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

Para StringNotIn, use:

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

Valores de propiedad

BoolEqualsFilter

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

DeadLetterDestination

Nombre Descripción Valor
endpointType Establezca en "StorageBlob" para el tipo StorageBlobDeadLetterDestination. 'StorageBlob' (obligatorio)

DeadLetterWithResourceIdentity

Nombre Descripción Valor
deadLetterDestination Información sobre el destino en el que se deben entregar los eventos para la suscripción de eventos.
Usa la configuración de identidad administrada en el recurso primario (es decir, tema o dominio) para adquirir los tokens de autenticación que se usan durante la entrega o mensajes fallidos.
DeadLetterDestination
identidad Identidad que se va a usar cuando se produzcan eventos de mensajes fallidos. EventSubscriptionIdentity

DeliveryConfiguration

Nombre Descripción Valor
deliveryMode Modo de entrega de la suscripción de eventos. 'Cola'
cola Esta propiedad debe rellenarse cuando deliveryMode es queue y representa información sobre la suscripción de cola. queueInfo

EventSubscriptionIdentity

Nombre Descripción Valor
tipo Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará cualquier identidad. 'SystemAssigned'
'UserAssigned'
userAssignedIdentity Identidad de usuario asociada al recurso. cuerda

Filtro

Nombre Descripción Valor
llave Campo o propiedad del evento en función del cual desea filtrar. cuerda
operatorType Establezca en "BoolEquals" para el tipo BoolEqualsFilter. Establezca en "IsNotNull" para el tipo IsNotNullFilter. Establezca en "IsNullOrUndefined" para el tipo IsNullOrUndefinedFilter. Establezca en "NumberGreaterThan" para el tipo NumberGreaterThanFilter. Establezca en "NumberGreaterThanOrEquals" para el tipo NumberGreaterThanOrEqualsFilter. Establezca en "NumberIn" para el tipo NumberInFilter. Establezca en "NumberInRange" para el tipo NumberInRangeFilter. Establezca en "NumberLessThan" para el tipo NumberLessThanFilter. Establezca en "NumberLessThanOrEquals" para el tipo NumberLessThanOrEqualsFilter. Establezca en "NumberNotIn" para el tipo NumberNotInFilter. Establezca en "NumberNotInRange" para el tipo NumberNotInRangeFilter. Establezca en "StringBeginsWith" para el tipo StringBeginsWithFilter. Establezca en "StringContains" para el tipo StringContainsFilter. Establezca en "StringEndsWith" para el tipo StringEndsWithFilter. Establezca en "StringIn" para el tipo StringInFilter. Establezca en "StringNotBeginsWith" para el tipo StringNotBeginsWithFilter. Establezca en "StringNotContains" para el tipo StringNotContainsFilter. Establezca en "StringNotEndsWith" para el tipo StringNotEndsWithFilter. Establezca en "StringNotIn" para el tipo StringNotInFilter. 'BoolEquals'
'IsNotNull'
'IsNullOrUndefined'
'NumberGreaterThan'
'NumberGreaterThanOrEquals'
'NumberIn'
'NumberInRange'
'NumberLessThan'
'NumberLessThanOrEquals'
'NumberNotIn'
'NumberNotInRange'
'StringBeginsWith'
'StringContains'
'StringEndsWith'
'StringIn'
'StringNotBeginsWith'
'StringNotContains'
'StringNotEndsWith'
'StringNotIn' (obligatorio)

FiltersConfiguration

Nombre Descripción Valor
filtros Matriz de filtros que se usan para filtrar suscripciones de eventos. filtro[]
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[]

IsNotNullFilter

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

IsNullOrUndefinedFilter

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

Microsoft.EventGrid/namespaces/topics/eventSubscriptions

Nombre Descripción Valor
apiVersion La versión de api '2023-06-01-preview'
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 50
Patrón = ^[a-zA-Z0-9-]*$ (obligatorio)
Propiedades Propiedades de la suscripción de eventos. subscriptionProperties
tipo El tipo de recurso 'Microsoft.EventGrid/namespaces/topics/eventSubscriptions'

NumberGreaterThanFilter

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

NumberGreaterThanOrEqualsFilter

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

NumberInFilter

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

NumberInRangeFilter

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

NumberLessThanFilter

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

NumberLessThanOrEqualsFilter

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

NumberNotInFilter

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

NumberNotInRangeFilter

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

QueueInfo

Nombre Descripción Valor
deadLetterDestinationWithResourceIdentity Destino de mensajes fallidos de la suscripción de eventos. Cualquier evento que no se pueda entregar a su destino se envía al destino de mensajes fallidos.
Usa la configuración de identidad administrada en el recurso primario (es decir, tema) para adquirir los tokens de autenticación que se usan durante la entrega o los mensajes fallidos.
DeadLetterWithResourceIdentity
eventTimeToLive Duración del intervalo de tiempo en formato ISO 8601 que determina cuánto tiempo están disponibles los mensajes para la suscripción desde el momento en que se publicó el mensaje.
Este valor de duración se expresa con el siguiente formato: 'P(n)Y(n)M(n)DT(n)H(n)M(n)S', donde:
- (n) se reemplaza por el valor de cada elemento de hora que sigue a (n).
- P es el designador de duración (o período) y siempre se coloca al principio de la duración.
- Y es el designador de año y sigue el valor del número de años.
- M es el designador de mes y sigue el valor del número de meses.
- W es el designador de semana y sigue el valor del número de semanas.
- D es el designador de día y sigue el valor del número de días.
- T es el designador de tiempo y precede a los componentes de hora.
- H es el designador de hora y sigue el valor del número de horas.
- M es el designador de minutos y sigue el valor del número de minutos.
- S es el segundo designador y sigue el valor del número de segundos.
Este valor de duración no se puede establecer mayor que EventRetentionInDays del tema. Es un campo opcional donde su valor mínimo es de 1 minuto y se determina su máximo.
por el valor EventRetentionInDays del tema. A continuación se muestran ejemplos de valores válidos:
- "P0DT23H12M" o "PT23H12M": durante 23 horas y 12 minutos.
- "P1D" o "P1DT0H0M0S": durante 1 día.
cuerda
maxDeliveryCount Recuento máximo de entregas de los eventos. Int
receiveLockDurationInSeconds Período máximo en segundos en el que una vez que el mensaje está en estado recibido (por el cliente) y esperando ser aceptado, liberado o rechazado.
Si este tiempo ha transcurrido después de que el cliente haya recibido un mensaje y no haya pasado a aceptado (no procesado), liberado o rechazado,
el mensaje está disponible para redelivery. Se trata de un campo opcional, donde el valor predeterminado es 60 segundos, el mínimo es de 60 segundos y el máximo es de 300 segundos.
Int

StorageBlobDeadLetterDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de mensajes fallidos 'StorageBlob' (obligatorio)
Propiedades Las propiedades del destino de deadletter basado en blobs de almacenamiento StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

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

StringBeginsWithFilter

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

StringContainsFilter

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

StringEndsWithFilter

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

StringInFilter

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

StringNotBeginsWithFilter

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

StringNotContainsFilter

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

StringNotEndsWithFilter

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

StringNotInFilter

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

SubscriptionProperties

Nombre Descripción Valor
deliveryConfiguration Información sobre la configuración de entrega de la suscripción de eventos. DeliveryConfiguration
eventDeliverySchema Esquema de entrega de eventos para la suscripción de eventos. "CloudEventSchemaV1_0"
filtersConfiguration Información sobre el filtro de la suscripción de eventos. FiltersConfiguration

Ejemplos de uso

Definición de recursos de Terraform (proveedor AzAPI)

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

  • grupos de recursos de

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

Formato de recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/namespaces/topics/eventSubscriptions@2023-06-01-preview"
  name = "string"
  body = {
    properties = {
      deliveryConfiguration = {
        deliveryMode = "string"
        queue = {
          deadLetterDestinationWithResourceIdentity = {
            deadLetterDestination = {
              endpointType = "string"
              // For remaining properties, see DeadLetterDestination objects
            }
            identity = {
              type = "string"
              userAssignedIdentity = "string"
            }
          }
          eventTimeToLive = "string"
          maxDeliveryCount = int
          receiveLockDurationInSeconds = int
        }
      }
      eventDeliverySchema = "string"
      filtersConfiguration = {
        filters = [
          {
            key = "string"
            operatorType = "string"
            // For remaining properties, see Filter objects
          }
        ]
        includedEventTypes = [
          "string"
        ]
      }
    }
  }
}

Objetos DeadLetterDestination

Establezca la propiedad endpointType para especificar el tipo de objeto.

Para StorageBlob, use:

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

Filtrar objetos

Establezca la propiedad operatorType para especificar el tipo de objeto.

Para boolEquals, use:

{
  operatorType = "BoolEquals"
  value = bool
}

Para IsNotNull, use:

{
  operatorType = "IsNotNull"
}

Para isNullOrUndefined, use:

{
  operatorType = "IsNullOrUndefined"
}

Para NumberGreaterThan, use:

{
  operatorType = "NumberGreaterThan"
  value = int
}

Para NumberGreaterThanOrEquals, use:

{
  operatorType = "NumberGreaterThanOrEquals"
  value = int
}

Para NumberIn, use:

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

Para NumberInRange, use:

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

Para NumberLessThan, use:

{
  operatorType = "NumberLessThan"
  value = int
}

Para NumberLessThanOrEquals, use:

{
  operatorType = "NumberLessThanOrEquals"
  value = int
}

Para NumberNotIn, use:

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

Para NumberNotInRange, use:

{
  operatorType = "NumberNotInRange"
  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 StringNotBeginsWith, use:

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

Para StringNotContains, use:

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

Para StringNotEndsWith, use:

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

Para StringNotIn, use:

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

Valores de propiedad

BoolEqualsFilter

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

DeadLetterDestination

Nombre Descripción Valor
endpointType Establezca en "StorageBlob" para el tipo StorageBlobDeadLetterDestination. 'StorageBlob' (obligatorio)

DeadLetterWithResourceIdentity

Nombre Descripción Valor
deadLetterDestination Información sobre el destino en el que se deben entregar los eventos para la suscripción de eventos.
Usa la configuración de identidad administrada en el recurso primario (es decir, tema o dominio) para adquirir los tokens de autenticación que se usan durante la entrega o mensajes fallidos.
DeadLetterDestination
identidad Identidad que se va a usar cuando se produzcan eventos de mensajes fallidos. EventSubscriptionIdentity

DeliveryConfiguration

Nombre Descripción Valor
deliveryMode Modo de entrega de la suscripción de eventos. 'Cola'
cola Esta propiedad debe rellenarse cuando deliveryMode es queue y representa información sobre la suscripción de cola. queueInfo

EventSubscriptionIdentity

Nombre Descripción Valor
tipo Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará cualquier identidad. 'SystemAssigned'
'UserAssigned'
userAssignedIdentity Identidad de usuario asociada al recurso. cuerda

Filtro

Nombre Descripción Valor
llave Campo o propiedad del evento en función del cual desea filtrar. cuerda
operatorType Establezca en "BoolEquals" para el tipo BoolEqualsFilter. Establezca en "IsNotNull" para el tipo IsNotNullFilter. Establezca en "IsNullOrUndefined" para el tipo IsNullOrUndefinedFilter. Establezca en "NumberGreaterThan" para el tipo NumberGreaterThanFilter. Establezca en "NumberGreaterThanOrEquals" para el tipo NumberGreaterThanOrEqualsFilter. Establezca en "NumberIn" para el tipo NumberInFilter. Establezca en "NumberInRange" para el tipo NumberInRangeFilter. Establezca en "NumberLessThan" para el tipo NumberLessThanFilter. Establezca en "NumberLessThanOrEquals" para el tipo NumberLessThanOrEqualsFilter. Establezca en "NumberNotIn" para el tipo NumberNotInFilter. Establezca en "NumberNotInRange" para el tipo NumberNotInRangeFilter. Establezca en "StringBeginsWith" para el tipo StringBeginsWithFilter. Establezca en "StringContains" para el tipo StringContainsFilter. Establezca en "StringEndsWith" para el tipo StringEndsWithFilter. Establezca en "StringIn" para el tipo StringInFilter. Establezca en "StringNotBeginsWith" para el tipo StringNotBeginsWithFilter. Establezca en "StringNotContains" para el tipo StringNotContainsFilter. Establezca en "StringNotEndsWith" para el tipo StringNotEndsWithFilter. Establezca en "StringNotIn" para el tipo StringNotInFilter. 'BoolEquals'
'IsNotNull'
'IsNullOrUndefined'
'NumberGreaterThan'
'NumberGreaterThanOrEquals'
'NumberIn'
'NumberInRange'
'NumberLessThan'
'NumberLessThanOrEquals'
'NumberNotIn'
'NumberNotInRange'
'StringBeginsWith'
'StringContains'
'StringEndsWith'
'StringIn'
'StringNotBeginsWith'
'StringNotContains'
'StringNotEndsWith'
'StringNotIn' (obligatorio)

FiltersConfiguration

Nombre Descripción Valor
filtros Matriz de filtros que se usan para filtrar suscripciones de eventos. filtro[]
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[]

IsNotNullFilter

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

IsNullOrUndefinedFilter

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

Microsoft.EventGrid/namespaces/topics/eventSubscriptions

Nombre Descripción Valor
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 50
Patrón = ^[a-zA-Z0-9-]*$ (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: espacios de nombres o temas
Propiedades Propiedades de la suscripción de eventos. subscriptionProperties
tipo El tipo de recurso "Microsoft.EventGrid/namespaces/topics/eventSubscriptions@2023-06-01-preview"

NumberGreaterThanFilter

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

NumberGreaterThanOrEqualsFilter

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

NumberInFilter

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

NumberInRangeFilter

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

NumberLessThanFilter

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

NumberLessThanOrEqualsFilter

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

NumberNotInFilter

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

NumberNotInRangeFilter

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

QueueInfo

Nombre Descripción Valor
deadLetterDestinationWithResourceIdentity Destino de mensajes fallidos de la suscripción de eventos. Cualquier evento que no se pueda entregar a su destino se envía al destino de mensajes fallidos.
Usa la configuración de identidad administrada en el recurso primario (es decir, tema) para adquirir los tokens de autenticación que se usan durante la entrega o los mensajes fallidos.
DeadLetterWithResourceIdentity
eventTimeToLive Duración del intervalo de tiempo en formato ISO 8601 que determina cuánto tiempo están disponibles los mensajes para la suscripción desde el momento en que se publicó el mensaje.
Este valor de duración se expresa con el siguiente formato: 'P(n)Y(n)M(n)DT(n)H(n)M(n)S', donde:
- (n) se reemplaza por el valor de cada elemento de hora que sigue a (n).
- P es el designador de duración (o período) y siempre se coloca al principio de la duración.
- Y es el designador de año y sigue el valor del número de años.
- M es el designador de mes y sigue el valor del número de meses.
- W es el designador de semana y sigue el valor del número de semanas.
- D es el designador de día y sigue el valor del número de días.
- T es el designador de tiempo y precede a los componentes de hora.
- H es el designador de hora y sigue el valor del número de horas.
- M es el designador de minutos y sigue el valor del número de minutos.
- S es el segundo designador y sigue el valor del número de segundos.
Este valor de duración no se puede establecer mayor que EventRetentionInDays del tema. Es un campo opcional donde su valor mínimo es de 1 minuto y se determina su máximo.
por el valor EventRetentionInDays del tema. A continuación se muestran ejemplos de valores válidos:
- "P0DT23H12M" o "PT23H12M": durante 23 horas y 12 minutos.
- "P1D" o "P1DT0H0M0S": durante 1 día.
cuerda
maxDeliveryCount Recuento máximo de entregas de los eventos. Int
receiveLockDurationInSeconds Período máximo en segundos en el que una vez que el mensaje está en estado recibido (por el cliente) y esperando ser aceptado, liberado o rechazado.
Si este tiempo ha transcurrido después de que el cliente haya recibido un mensaje y no haya pasado a aceptado (no procesado), liberado o rechazado,
el mensaje está disponible para redelivery. Se trata de un campo opcional, donde el valor predeterminado es 60 segundos, el mínimo es de 60 segundos y el máximo es de 300 segundos.
Int

StorageBlobDeadLetterDestination

Nombre Descripción Valor
endpointType Tipo del punto de conexión para el destino de mensajes fallidos 'StorageBlob' (obligatorio)
Propiedades Las propiedades del destino de deadletter basado en blobs de almacenamiento StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

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

StringBeginsWithFilter

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

StringContainsFilter

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

StringEndsWithFilter

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

StringInFilter

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

StringNotBeginsWithFilter

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

StringNotContainsFilter

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

StringNotEndsWithFilter

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

StringNotInFilter

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

SubscriptionProperties

Nombre Descripción Valor
deliveryConfiguration Información sobre la configuración de entrega de la suscripción de eventos. DeliveryConfiguration
eventDeliverySchema Esquema de entrega de eventos para la suscripción de eventos. "CloudEventSchemaV1_0"
filtersConfiguration Información sobre el filtro de la suscripción de eventos. FiltersConfiguration