Partilhar via


Microsoft.EventGrid eventSubscriptions 2019-01-01

Definição de recursos do bíceps

O tipo de recurso eventSubscriptions pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.EventGrid/eventSubscriptions, adicione o seguinte Bicep ao seu modelo.

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

Objetos EventSubscriptionDestination

Defina a propriedade endpointType para especificar o tipo de objeto.

Para EventHub, use:

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

Para HybridConnection, use:

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

Para StorageQueue , use:

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

Para WebHook, use:

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

Objetos DeadLetterDestination

Defina a propriedade endpointType para especificar o tipo de objeto.

Para StorageBlob , use:

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

Valores de propriedade

DeadLetterDestination

Designação Descrição Valor
endpointType Defina como 'StorageBlob' para o tipo StorageBlobDeadLetterDestination. 'StorageBlob' (obrigatório)

EventHubEventSubscriptionDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da assinatura do evento 'EventHub' (obrigatório)
propriedades Propriedades do Hub de Eventos do destino da assinatura do evento EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

Designação Descrição Valor
resourceId A Id de Recursos do Azure que representa o ponto de extremidade de um destino do Hub de Eventos de uma assinatura de evento. string

EventSubscriptionDestination

Designação Descrição Valor
endpointType Defina como 'EventHub' para o tipo EventHubEventSubscriptionDestination. Defina como 'HybridConnection' para o tipo HybridConnectionEventSubscriptionDestination. Defina como 'StorageQueue' para o tipo StorageQueueEventSubscriptionDestination. Defina como 'WebHook' para o tipo WebHookEventSubscriptionDestination. 'EventHub'
'HybridConnection'
'StorageQueue'
'WebHook' (obrigatório)

EventSubscriptionFilter

Designação Descrição Valor
incluídoTipos de Evento Uma lista de tipos de eventos aplicáveis que precisam fazer parte da assinatura do evento.
Se desejar inscrever-se em todos os tipos de evento, a cadeia de caracteres "all" precisa ser especificada como um elemento nesta lista.
string[]
isSubjectCaseSensitive Especifica se as propriedades SubjectBeginsWith e SubjectEndsWith do filtro
devem ser comparados de forma sensível a maiúsculas e minúsculas.
Bool
assuntoComeçaCom Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um prefixo de caminho de recurso.
O formato depende do editor dos eventos.
Não há suporte para caracteres curinga neste caminho.
string
assuntoTermina Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um sufixo de caminho de recurso.
Não há suporte para caracteres curinga neste caminho.
string

EventSubscriptionProperties

Designação Descrição Valor
deadLetterDestino O destino DeadLetter da assinatura do evento. DeadLetterDestination
destino Informações sobre o destino onde os eventos devem ser entregues para a assinatura do evento. EventSubscriptionDestination
filtrar Informações sobre o filtro para a assinatura do evento. EventSubscriptionFilter
rótulos Lista de rótulos definidos pelo usuário. string[]
retryPolicy A política de repetição para eventos. Isso pode ser usado para configurar o número máximo de tentativas de entrega e o tempo de vida dos eventos. RetryPolicy

HybridConnectionEventSubscriptionDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da assinatura do evento 'HybridConnection' (obrigatório)
propriedades Propriedades de conexão híbrida do destino da assinatura do evento HybridConnectionEventSubscriptionDestinationProperties

HybridConnectionEventSubscriptionDestinationProperties

Designação Descrição Valor
resourceId A ID de Recurso do Azure de uma conexão híbrida que é o destino de uma assinatura de evento. string

Microsoft.EventGrid/eventSubscriptions

Designação Descrição Valor
Designação O nome do recurso string (obrigatório)
propriedades Propriedades da subscrição do evento EventSubscriptionProperties
Âmbito de aplicação Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .

RetryPolicy

Designação Descrição Valor
eventTimeToLiveInMinutes Time To Live (em minutos) para eventos. Int
maxDeliveryTentativas Número máximo de tentativas de repetição de entrega para eventos. Int

StorageBlobDeadLetterDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da letra morta 'StorageBlob' (obrigatório)
propriedades As propriedades do destino de deadletter baseado em Blob de Armazenamento StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

Designação Descrição Valor
blobContainerName O nome do contêiner de blob de armazenamento que é o destino dos eventos deadletter string
resourceId A ID de Recurso do Azure da conta de armazenamento que é o destino dos eventos deadletter. Por exemplo: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/microsoft. Storage/storageAccounts/{StorageAccountName} string

StorageQueueEventSubscriptionDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da assinatura do evento 'StorageQueue' (obrigatório)
propriedades Propriedades da fila de armazenamento do destino da assinatura do evento StorageQueueEventSubscriptionDestinationProperties

StorageQueueEventSubscriptionDestinationProperties

Designação Descrição Valor
queueName O nome da fila de armazenamento em uma conta de armazenamento que é o destino de uma assinatura de evento. string
resourceId A ID de Recurso do Azure da conta de armazenamento que contém a fila que é o destino de uma assinatura de evento. string

WebHookEventSubscriptionDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da assinatura do evento 'WebHook' (obrigatório)
propriedades Propriedades WebHook do destino da assinatura do evento WebHookEventSubscriptionDestinationProperties

WebHookEventSubscriptionDestinationProperties

Designação Descrição Valor
endpointUrl A URL que representa o ponto de extremidade do destino de uma assinatura de evento. string

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
Criar Tópico Personalizado da Grade de Eventos do Azure e de Assinatura de Fila Cria um tópico personalizado da Grade de Eventos do Azure e uma assinatura de fila de barramento de serviço. Modelo originalmente de autoria de Markus Meyer.
Criar tópico personalizado da grade de eventos do Azure e de assinatura Cria um tópico personalizado da Grade de Eventos do Azure e uma assinatura de webhook. Modelo originalmente criado por John Downs.

Definição de recurso de modelo ARM

O tipo de recurso eventSubscriptions pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.EventGrid/eventSubscriptions, adicione o seguinte JSON ao seu modelo.

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

Objetos EventSubscriptionDestination

Defina a propriedade endpointType para especificar o tipo de objeto.

Para EventHub, use:

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

Para HybridConnection, use:

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

Para StorageQueue , use:

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

Para WebHook, use:

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

Objetos DeadLetterDestination

Defina a propriedade endpointType para especificar o tipo de objeto.

Para StorageBlob , use:

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

Valores de propriedade

DeadLetterDestination

Designação Descrição Valor
endpointType Defina como 'StorageBlob' para o tipo StorageBlobDeadLetterDestination. 'StorageBlob' (obrigatório)

EventHubEventSubscriptionDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da assinatura do evento 'EventHub' (obrigatório)
propriedades Propriedades do Hub de Eventos do destino da assinatura do evento EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

Designação Descrição Valor
resourceId A Id de Recursos do Azure que representa o ponto de extremidade de um destino do Hub de Eventos de uma assinatura de evento. string

EventSubscriptionDestination

Designação Descrição Valor
endpointType Defina como 'EventHub' para o tipo EventHubEventSubscriptionDestination. Defina como 'HybridConnection' para o tipo HybridConnectionEventSubscriptionDestination. Defina como 'StorageQueue' para o tipo StorageQueueEventSubscriptionDestination. Defina como 'WebHook' para o tipo WebHookEventSubscriptionDestination. 'EventHub'
'HybridConnection'
'StorageQueue'
'WebHook' (obrigatório)

EventSubscriptionFilter

Designação Descrição Valor
incluídoTipos de Evento Uma lista de tipos de eventos aplicáveis que precisam fazer parte da assinatura do evento.
Se desejar inscrever-se em todos os tipos de evento, a cadeia de caracteres "all" precisa ser especificada como um elemento nesta lista.
string[]
isSubjectCaseSensitive Especifica se as propriedades SubjectBeginsWith e SubjectEndsWith do filtro
devem ser comparados de forma sensível a maiúsculas e minúsculas.
Bool
assuntoComeçaCom Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um prefixo de caminho de recurso.
O formato depende do editor dos eventos.
Não há suporte para caracteres curinga neste caminho.
string
assuntoTermina Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um sufixo de caminho de recurso.
Não há suporte para caracteres curinga neste caminho.
string

EventSubscriptionProperties

Designação Descrição Valor
deadLetterDestino O destino DeadLetter da assinatura do evento. DeadLetterDestination
destino Informações sobre o destino onde os eventos devem ser entregues para a assinatura do evento. EventSubscriptionDestination
filtrar Informações sobre o filtro para a assinatura do evento. EventSubscriptionFilter
rótulos Lista de rótulos definidos pelo usuário. string[]
retryPolicy A política de repetição para eventos. Isso pode ser usado para configurar o número máximo de tentativas de entrega e o tempo de vida dos eventos. RetryPolicy

HybridConnectionEventSubscriptionDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da assinatura do evento 'HybridConnection' (obrigatório)
propriedades Propriedades de conexão híbrida do destino da assinatura do evento HybridConnectionEventSubscriptionDestinationProperties

HybridConnectionEventSubscriptionDestinationProperties

Designação Descrição Valor
resourceId A ID de Recurso do Azure de uma conexão híbrida que é o destino de uma assinatura de evento. string

Microsoft.EventGrid/eventSubscriptions

Designação Descrição Valor
apiVersion A versão api '2019-01-01'
Designação O nome do recurso string (obrigatório)
propriedades Propriedades da subscrição do evento EventSubscriptionProperties
tipo O tipo de recurso 'Microsoft.EventGrid/eventSubscriptions'

RetryPolicy

Designação Descrição Valor
eventTimeToLiveInMinutes Time To Live (em minutos) para eventos. Int
maxDeliveryTentativas Número máximo de tentativas de repetição de entrega para eventos. Int

StorageBlobDeadLetterDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da letra morta 'StorageBlob' (obrigatório)
propriedades As propriedades do destino de deadletter baseado em Blob de Armazenamento StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

Designação Descrição Valor
blobContainerName O nome do contêiner de blob de armazenamento que é o destino dos eventos deadletter string
resourceId A ID de Recurso do Azure da conta de armazenamento que é o destino dos eventos deadletter. Por exemplo: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/microsoft. Storage/storageAccounts/{StorageAccountName} string

StorageQueueEventSubscriptionDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da assinatura do evento 'StorageQueue' (obrigatório)
propriedades Propriedades da fila de armazenamento do destino da assinatura do evento StorageQueueEventSubscriptionDestinationProperties

StorageQueueEventSubscriptionDestinationProperties

Designação Descrição Valor
queueName O nome da fila de armazenamento em uma conta de armazenamento que é o destino de uma assinatura de evento. string
resourceId A ID de Recurso do Azure da conta de armazenamento que contém a fila que é o destino de uma assinatura de evento. string

WebHookEventSubscriptionDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da assinatura do evento 'WebHook' (obrigatório)
propriedades Propriedades WebHook do destino da assinatura do evento WebHookEventSubscriptionDestinationProperties

WebHookEventSubscriptionDestinationProperties

Designação Descrição Valor
endpointUrl A URL que representa o ponto de extremidade do destino de uma assinatura de evento. string

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Criar Tópico Personalizado da Grade de Eventos do Azure e de Assinatura de Fila

Implantar no Azure
Cria um tópico personalizado da Grade de Eventos do Azure e uma assinatura de fila de barramento de serviço. Modelo originalmente de autoria de Markus Meyer.
Criar tópico personalizado da grade de eventos do Azure e de assinatura

Implantar no Azure
Cria um tópico personalizado da Grade de Eventos do Azure e uma assinatura de webhook. Modelo originalmente criado por John Downs.
Criar de Subscrição de Tópico Personalizado da Grelha de Eventos do Azure

Implantar no Azure
Cria um tópico personalizado da Grade de Eventos do Azure e uma assinatura de tópico do barramento de serviço. Modelo originalmente de autoria de Markus Meyer.
Criar tópico personalizado da Grade de Eventos e manipulador de hub de eventos

Implantar no Azure
Cria um tópico personalizado da Grade de Eventos do Azure e um hub de eventos para manipular os eventos.
Criar subscrição da Grelha de Eventos para eventos de recursos

Implantar no Azure
Cria a assinatura da Grade de Eventos para o grupo de recursos ou a assinatura do Azure.
Tópico/assinatura personalizada da grade de eventos do Azure com o CloudEvents

Implantar no Azure
Cria um tópico personalizado da Grade de Eventos do Azure, uma assinatura de webhook com esquema CloudEvents e um Aplicativo Lógico como manipulador de eventos. Modelo originalmente criado por Justin Yoo.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso eventSubscriptions pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.EventGrid/eventSubscriptions, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/eventSubscriptions@2019-01-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
      }
      filter = {
        includedEventTypes = [
          "string"
        ]
        isSubjectCaseSensitive = bool
        subjectBeginsWith = "string"
        subjectEndsWith = "string"
      }
      labels = [
        "string"
      ]
      retryPolicy = {
        eventTimeToLiveInMinutes = int
        maxDeliveryAttempts = int
      }
    }
  })
}

Objetos EventSubscriptionDestination

Defina a propriedade endpointType para especificar o tipo de objeto.

Para EventHub, use:

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

Para HybridConnection, use:

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

Para StorageQueue , use:

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

Para WebHook, use:

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

Objetos DeadLetterDestination

Defina a propriedade endpointType para especificar o tipo de objeto.

Para StorageBlob , use:

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

Valores de propriedade

DeadLetterDestination

Designação Descrição Valor
endpointType Defina como 'StorageBlob' para o tipo StorageBlobDeadLetterDestination. 'StorageBlob' (obrigatório)

EventHubEventSubscriptionDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da assinatura do evento 'EventHub' (obrigatório)
propriedades Propriedades do Hub de Eventos do destino da assinatura do evento EventHubEventSubscriptionDestinationProperties

EventHubEventSubscriptionDestinationProperties

Designação Descrição Valor
resourceId A Id de Recursos do Azure que representa o ponto de extremidade de um destino do Hub de Eventos de uma assinatura de evento. string

EventSubscriptionDestination

Designação Descrição Valor
endpointType Defina como 'EventHub' para o tipo EventHubEventSubscriptionDestination. Defina como 'HybridConnection' para o tipo HybridConnectionEventSubscriptionDestination. Defina como 'StorageQueue' para o tipo StorageQueueEventSubscriptionDestination. Defina como 'WebHook' para o tipo WebHookEventSubscriptionDestination. 'EventHub'
'HybridConnection'
'StorageQueue'
'WebHook' (obrigatório)

EventSubscriptionFilter

Designação Descrição Valor
incluídoTipos de Evento Uma lista de tipos de eventos aplicáveis que precisam fazer parte da assinatura do evento.
Se desejar inscrever-se em todos os tipos de evento, a cadeia de caracteres "all" precisa ser especificada como um elemento nesta lista.
string[]
isSubjectCaseSensitive Especifica se as propriedades SubjectBeginsWith e SubjectEndsWith do filtro
devem ser comparados de forma sensível a maiúsculas e minúsculas.
Bool
assuntoComeçaCom Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um prefixo de caminho de recurso.
O formato depende do editor dos eventos.
Não há suporte para caracteres curinga neste caminho.
string
assuntoTermina Uma cadeia de caracteres opcional para filtrar eventos para uma assinatura de evento com base em um sufixo de caminho de recurso.
Não há suporte para caracteres curinga neste caminho.
string

EventSubscriptionProperties

Designação Descrição Valor
deadLetterDestino O destino DeadLetter da assinatura do evento. DeadLetterDestination
destino Informações sobre o destino onde os eventos devem ser entregues para a assinatura do evento. EventSubscriptionDestination
filtrar Informações sobre o filtro para a assinatura do evento. EventSubscriptionFilter
rótulos Lista de rótulos definidos pelo usuário. string[]
retryPolicy A política de repetição para eventos. Isso pode ser usado para configurar o número máximo de tentativas de entrega e o tempo de vida dos eventos. RetryPolicy

HybridConnectionEventSubscriptionDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da assinatura do evento 'HybridConnection' (obrigatório)
propriedades Propriedades de conexão híbrida do destino da assinatura do evento HybridConnectionEventSubscriptionDestinationProperties

HybridConnectionEventSubscriptionDestinationProperties

Designação Descrição Valor
resourceId A ID de Recurso do Azure de uma conexão híbrida que é o destino de uma assinatura de evento. string

Microsoft.EventGrid/eventSubscriptions

Designação Descrição Valor
Designação O nome do recurso string (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. string (obrigatório)
propriedades Propriedades da subscrição do evento EventSubscriptionProperties
tipo O tipo de recurso "Microsoft.EventGrid/eventSubscriptions@2019-01-01"

RetryPolicy

Designação Descrição Valor
eventTimeToLiveInMinutes Time To Live (em minutos) para eventos. Int
maxDeliveryTentativas Número máximo de tentativas de repetição de entrega para eventos. Int

StorageBlobDeadLetterDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da letra morta 'StorageBlob' (obrigatório)
propriedades As propriedades do destino de deadletter baseado em Blob de Armazenamento StorageBlobDeadLetterDestinationProperties

StorageBlobDeadLetterDestinationProperties

Designação Descrição Valor
blobContainerName O nome do contêiner de blob de armazenamento que é o destino dos eventos deadletter string
resourceId A ID de Recurso do Azure da conta de armazenamento que é o destino dos eventos deadletter. Por exemplo: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/microsoft. Storage/storageAccounts/{StorageAccountName} string

StorageQueueEventSubscriptionDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da assinatura do evento 'StorageQueue' (obrigatório)
propriedades Propriedades da fila de armazenamento do destino da assinatura do evento StorageQueueEventSubscriptionDestinationProperties

StorageQueueEventSubscriptionDestinationProperties

Designação Descrição Valor
queueName O nome da fila de armazenamento em uma conta de armazenamento que é o destino de uma assinatura de evento. string
resourceId A ID de Recurso do Azure da conta de armazenamento que contém a fila que é o destino de uma assinatura de evento. string

WebHookEventSubscriptionDestination

Designação Descrição Valor
endpointType Tipo de ponto de extremidade para o destino da assinatura do evento 'WebHook' (obrigatório)
propriedades Propriedades WebHook do destino da assinatura do evento WebHookEventSubscriptionDestinationProperties

WebHookEventSubscriptionDestinationProperties

Designação Descrição Valor
endpointUrl A URL que representa o ponto de extremidade do destino de uma assinatura de evento. string