Compartir a través de


Temas de Microsoft.EventGrid 2021-10-15-preview

Definición de recursos de Bicep

El tipo de recurso de temas 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/topics, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.EventGrid/topics@2021-10-15-preview' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    dataResidencyBoundary: 'string'
    disableLocalAuth: bool
    inboundIpRules: [
      {
        action: 'string'
        ipMask: 'string'
      }
    ]
    inputSchema: 'string'
    inputSchemaMapping: {
      inputSchemaMappingType: 'string'
      // For remaining properties, see InputSchemaMapping objects
    }
    publicNetworkAccess: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos InputSchemaMapping

Establezca la propiedad inputSchemaMappingType para especificar el tipo de objeto.

Para json, use:

{
  inputSchemaMappingType: 'Json'
  properties: {
    dataVersion: {
      defaultValue: 'string'
      sourceField: 'string'
    }
    eventTime: {
      sourceField: 'string'
    }
    eventType: {
      defaultValue: 'string'
      sourceField: 'string'
    }
    id: {
      sourceField: 'string'
    }
    subject: {
      defaultValue: 'string'
      sourceField: 'string'
    }
    topic: {
      sourceField: 'string'
    }
  }
}

Valores de propiedad

ExtendedLocation

Nombre Descripción Valor
nombre Nombre completo de la ubicación extendida. cuerda
tipo Tipo de la ubicación extendida. cuerda

IdentityInfo

Nombre Descripción Valor
principalId Identificador de entidad de seguridad de la identidad del recurso. cuerda
tenantId Identificador de inquilino del recurso. cuerda
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. 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recursos de ARM con el formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Esta propiedad no se usa actualmente y está reservada para uso futuro.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nombre Descripción Valor

InboundIpRule

Nombre Descripción Valor
acción Acción que se va a realizar en función de la coincidencia o ninguna coincidencia de IpMask. 'Permitir'
ipMask Dirección IP en notación CIDR, por ejemplo, 10.0.0.0/8. cuerda

InputSchemaMapping

Nombre Descripción Valor
inputSchemaMappingType Establezca en "Json" para el tipo JsonInputSchemaMapping. 'Json' (obligatorio)

JsonField

Nombre Descripción Valor
sourceField Nombre de un campo en el esquema de eventos de entrada que se va a usar como origen de una asignación. cuerda

JsonFieldWithDefault

Nombre Descripción Valor
defaultValue Valor predeterminado que se va a usar para la asignación cuando no se proporciona un SourceField o si no hay ninguna propiedad con el nombre especificado en la carga del evento JSON publicado. cuerda
sourceField Nombre de un campo en el esquema de eventos de entrada que se va a usar como origen de una asignación. cuerda

JsonInputSchemaMapping

Nombre Descripción Valor
inputSchemaMappingType Tipo de la asignación personalizada 'Json' (obligatorio)
Propiedades Propiedades JSON de la asignación de esquemas de entrada JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Nombre Descripción Valor
dataVersion Información de asignación de la propiedad DataVersion del evento de Event Grid. jsonFieldWithDefault
eventTime Información de asignación de la propiedad EventTime del evento de Event Grid. JsonField
eventType Información de asignación de la propiedad EventType del evento de Event Grid. jsonFieldWithDefault
identificación Información de asignación de la propiedad Id del evento de Event Grid. JsonField
Asunto Información de asignación para la propiedad Subject del evento de Event Grid. jsonFieldWithDefault
tema Información de asignación de la propiedad Topic del evento de Event Grid. JsonField

Microsoft.EventGrid/topics

Nombre Descripción Valor
extendedLocation Ubicación extendida del recurso. ExtendedLocation
identidad Información de identidad del recurso. IdentityInfo
amable Tipo de recurso. "Azure"
"AzureArc"
ubicación Ubicación del recurso. string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades del tema. TopicProperties
Sku Plan de tarifa de Sku para el tema. ResourceSku de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

ResourceSku

Nombre Descripción Valor
nombre Nombre de Sku del recurso. Los valores posibles son: Básico o Premium. "Básico"
'Premium'

TopicProperties

Nombre Descripción Valor
dataResidencyBoundary Límite de residencia de datos del recurso. 'WithinGeopair'
'WithinRegion'
disableLocalAuth Este valor booleano se usa para habilitar o deshabilitar la autenticación local. El valor predeterminado es false. Cuando la propiedad se establece en true, solo se usará el token de AAD para autenticarse si el usuario puede publicar en el tema. Bool
inboundIpRules Esto se puede usar para restringir el tráfico de direcciones IP específicas en lugar de todas las direcciones IP. Nota: Estos se consideran solo si PublicNetworkAccess está habilitado. inboundIpRule []
inputSchema Esto determina el formato que Event Grid debe esperar para los eventos entrantes publicados en el tema. "CloudEventSchemaV1_0"
'CustomEventSchema'
'EventGridSchema'
inputSchemaMapping Esto permite la publicación mediante esquemas de eventos personalizados. Se puede especificar InputSchemaMapping para asignar varias propiedades de un esquema de origen a varias propiedades necesarias del esquema EventGridEvent. InputSchemaMapping
publicNetworkAccess Esto determina si se permite el tráfico a través de la red pública. De forma predeterminada, está habilitado.
Puede restringir aún más a direcciones IP específicas configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" />
'Deshabilitado'
'Habilitado'

TrackedResourceTags

Nombre Descripción Valor

UserIdentityProperties

Nombre Descripción Valor
clientId Identificador de cliente de la identidad asignada por el usuario. cuerda
principalId Identificador principal de la identidad asignada por el usuario. cuerda

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.

Archivo de Bicep Descripción
crear temas personalizados de Azure Event Grid y de suscripción de cola Crea un tema personalizado de Azure Event Grid y una suscripción de cola de Service Bus. Plantilla originalmente creadas por Markus Meyer.
creación de un tema personalizado de Azure Event Grid y de suscripción Crea un tema personalizado de Azure Event Grid y una suscripción de webhook. Plantilla originalmente creadas por John Downs.

Definición de recursos de plantilla de ARM

El tipo de recurso de temas 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/topics, agregue el siguiente json a la plantilla.

{
  "type": "Microsoft.EventGrid/topics",
  "apiVersion": "2021-10-15-preview",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "dataResidencyBoundary": "string",
    "disableLocalAuth": "bool",
    "inboundIpRules": [
      {
        "action": "string",
        "ipMask": "string"
      }
    ],
    "inputSchema": "string",
    "inputSchemaMapping": {
      "inputSchemaMappingType": "string"
      // For remaining properties, see InputSchemaMapping objects
    },
    "publicNetworkAccess": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objetos InputSchemaMapping

Establezca la propiedad inputSchemaMappingType para especificar el tipo de objeto.

Para json, use:

{
  "inputSchemaMappingType": "Json",
  "properties": {
    "dataVersion": {
      "defaultValue": "string",
      "sourceField": "string"
    },
    "eventTime": {
      "sourceField": "string"
    },
    "eventType": {
      "defaultValue": "string",
      "sourceField": "string"
    },
    "id": {
      "sourceField": "string"
    },
    "subject": {
      "defaultValue": "string",
      "sourceField": "string"
    },
    "topic": {
      "sourceField": "string"
    }
  }
}

Valores de propiedad

ExtendedLocation

Nombre Descripción Valor
nombre Nombre completo de la ubicación extendida. cuerda
tipo Tipo de la ubicación extendida. cuerda

IdentityInfo

Nombre Descripción Valor
principalId Identificador de entidad de seguridad de la identidad del recurso. cuerda
tenantId Identificador de inquilino del recurso. cuerda
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. 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recursos de ARM con el formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Esta propiedad no se usa actualmente y está reservada para uso futuro.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nombre Descripción Valor

InboundIpRule

Nombre Descripción Valor
acción Acción que se va a realizar en función de la coincidencia o ninguna coincidencia de IpMask. 'Permitir'
ipMask Dirección IP en notación CIDR, por ejemplo, 10.0.0.0/8. cuerda

InputSchemaMapping

Nombre Descripción Valor
inputSchemaMappingType Establezca en "Json" para el tipo JsonInputSchemaMapping. 'Json' (obligatorio)

JsonField

Nombre Descripción Valor
sourceField Nombre de un campo en el esquema de eventos de entrada que se va a usar como origen de una asignación. cuerda

JsonFieldWithDefault

Nombre Descripción Valor
defaultValue Valor predeterminado que se va a usar para la asignación cuando no se proporciona un SourceField o si no hay ninguna propiedad con el nombre especificado en la carga del evento JSON publicado. cuerda
sourceField Nombre de un campo en el esquema de eventos de entrada que se va a usar como origen de una asignación. cuerda

JsonInputSchemaMapping

Nombre Descripción Valor
inputSchemaMappingType Tipo de la asignación personalizada 'Json' (obligatorio)
Propiedades Propiedades JSON de la asignación de esquemas de entrada JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Nombre Descripción Valor
dataVersion Información de asignación de la propiedad DataVersion del evento de Event Grid. jsonFieldWithDefault
eventTime Información de asignación de la propiedad EventTime del evento de Event Grid. JsonField
eventType Información de asignación de la propiedad EventType del evento de Event Grid. jsonFieldWithDefault
identificación Información de asignación de la propiedad Id del evento de Event Grid. JsonField
Asunto Información de asignación para la propiedad Subject del evento de Event Grid. jsonFieldWithDefault
tema Información de asignación de la propiedad Topic del evento de Event Grid. JsonField

Microsoft.EventGrid/topics

Nombre Descripción Valor
apiVersion La versión de api "2021-10-15-preview"
extendedLocation Ubicación extendida del recurso. ExtendedLocation
identidad Información de identidad del recurso. IdentityInfo
amable Tipo de recurso. "Azure"
"AzureArc"
ubicación Ubicación del recurso. string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades del tema. TopicProperties
Sku Plan de tarifa de Sku para el tema. ResourceSku de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso "Microsoft.EventGrid/topics"

ResourceSku

Nombre Descripción Valor
nombre Nombre de Sku del recurso. Los valores posibles son: Básico o Premium. "Básico"
'Premium'

TopicProperties

Nombre Descripción Valor
dataResidencyBoundary Límite de residencia de datos del recurso. 'WithinGeopair'
'WithinRegion'
disableLocalAuth Este valor booleano se usa para habilitar o deshabilitar la autenticación local. El valor predeterminado es false. Cuando la propiedad se establece en true, solo se usará el token de AAD para autenticarse si el usuario puede publicar en el tema. Bool
inboundIpRules Esto se puede usar para restringir el tráfico de direcciones IP específicas en lugar de todas las direcciones IP. Nota: Estos se consideran solo si PublicNetworkAccess está habilitado. inboundIpRule []
inputSchema Esto determina el formato que Event Grid debe esperar para los eventos entrantes publicados en el tema. "CloudEventSchemaV1_0"
'CustomEventSchema'
'EventGridSchema'
inputSchemaMapping Esto permite la publicación mediante esquemas de eventos personalizados. Se puede especificar InputSchemaMapping para asignar varias propiedades de un esquema de origen a varias propiedades necesarias del esquema EventGridEvent. InputSchemaMapping
publicNetworkAccess Esto determina si se permite el tráfico a través de la red pública. De forma predeterminada, está habilitado.
Puede restringir aún más a direcciones IP específicas configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" />
'Deshabilitado'
'Habilitado'

TrackedResourceTags

Nombre Descripción Valor

UserIdentityProperties

Nombre Descripción Valor
clientId Identificador de cliente de la identidad asignada por el usuario. cuerda
principalId Identificador principal de la identidad asignada por el usuario. cuerda

Plantillas de inicio rápido

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

Plantilla Descripción
crear temas personalizados de Azure Event Grid y de suscripción de cola

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

Implementación en Azure
Crea un tema personalizado de Azure Event Grid y una suscripción de webhook. Plantilla originalmente creadas por John Downs.
crear una suscripción a temas personalizados de Azure Event Grid

Implementación en Azure
Crea un tema personalizado de Azure Event Grid y una suscripción a temas de Service Bus. Plantilla originalmente creadas por Markus Meyer.
creación de temas personalizados de Event Grid y del controlador del centro de eventos

Implementación en Azure
Crea un tema personalizado de Azure Event Grid y un centro de eventos para controlar los eventos.
tema o suscripción personalizados de Azure Event Grid con CloudEvents

Implementación en Azure
Crea un tema personalizado de Azure Event Grid, 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.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso de temas 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/topics, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/topics@2021-10-15-preview"
  name = "string"
  identity = {
    principalId = "string"
    tenantId = "string"
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  kind = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      dataResidencyBoundary = "string"
      disableLocalAuth = bool
      inboundIpRules = [
        {
          action = "string"
          ipMask = "string"
        }
      ]
      inputSchema = "string"
      inputSchemaMapping = {
        inputSchemaMappingType = "string"
        // For remaining properties, see InputSchemaMapping objects
      }
      publicNetworkAccess = "string"
    }
  })
}

Objetos InputSchemaMapping

Establezca la propiedad inputSchemaMappingType para especificar el tipo de objeto.

Para json, use:

{
  inputSchemaMappingType = "Json"
  properties = {
    dataVersion = {
      defaultValue = "string"
      sourceField = "string"
    }
    eventTime = {
      sourceField = "string"
    }
    eventType = {
      defaultValue = "string"
      sourceField = "string"
    }
    id = {
      sourceField = "string"
    }
    subject = {
      defaultValue = "string"
      sourceField = "string"
    }
    topic = {
      sourceField = "string"
    }
  }
}

Valores de propiedad

ExtendedLocation

Nombre Descripción Valor
nombre Nombre completo de la ubicación extendida. cuerda
tipo Tipo de la ubicación extendida. cuerda

IdentityInfo

Nombre Descripción Valor
principalId Identificador de entidad de seguridad de la identidad del recurso. cuerda
tenantId Identificador de inquilino del recurso. cuerda
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. 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recursos de ARM con el formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Esta propiedad no se usa actualmente y está reservada para uso futuro.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nombre Descripción Valor

InboundIpRule

Nombre Descripción Valor
acción Acción que se va a realizar en función de la coincidencia o ninguna coincidencia de IpMask. 'Permitir'
ipMask Dirección IP en notación CIDR, por ejemplo, 10.0.0.0/8. cuerda

InputSchemaMapping

Nombre Descripción Valor
inputSchemaMappingType Establezca en "Json" para el tipo JsonInputSchemaMapping. 'Json' (obligatorio)

JsonField

Nombre Descripción Valor
sourceField Nombre de un campo en el esquema de eventos de entrada que se va a usar como origen de una asignación. cuerda

JsonFieldWithDefault

Nombre Descripción Valor
defaultValue Valor predeterminado que se va a usar para la asignación cuando no se proporciona un SourceField o si no hay ninguna propiedad con el nombre especificado en la carga del evento JSON publicado. cuerda
sourceField Nombre de un campo en el esquema de eventos de entrada que se va a usar como origen de una asignación. cuerda

JsonInputSchemaMapping

Nombre Descripción Valor
inputSchemaMappingType Tipo de la asignación personalizada 'Json' (obligatorio)
Propiedades Propiedades JSON de la asignación de esquemas de entrada JsonInputSchemaMappingProperties

JsonInputSchemaMappingProperties

Nombre Descripción Valor
dataVersion Información de asignación de la propiedad DataVersion del evento de Event Grid. jsonFieldWithDefault
eventTime Información de asignación de la propiedad EventTime del evento de Event Grid. JsonField
eventType Información de asignación de la propiedad EventType del evento de Event Grid. jsonFieldWithDefault
identificación Información de asignación de la propiedad Id del evento de Event Grid. JsonField
Asunto Información de asignación para la propiedad Subject del evento de Event Grid. jsonFieldWithDefault
tema Información de asignación de la propiedad Topic del evento de Event Grid. JsonField

Microsoft.EventGrid/topics

Nombre Descripción Valor
extendedLocation Ubicación extendida del recurso. ExtendedLocation
identidad Información de identidad del recurso. IdentityInfo
amable Tipo de recurso. "Azure"
"AzureArc"
ubicación Ubicación del recurso. string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades del tema. TopicProperties
Sku Plan de tarifa de Sku para el tema. ResourceSku de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.EventGrid/topics@2021-10-15-preview"

ResourceSku

Nombre Descripción Valor
nombre Nombre de Sku del recurso. Los valores posibles son: Básico o Premium. "Básico"
'Premium'

TopicProperties

Nombre Descripción Valor
dataResidencyBoundary Límite de residencia de datos del recurso. 'WithinGeopair'
'WithinRegion'
disableLocalAuth Este valor booleano se usa para habilitar o deshabilitar la autenticación local. El valor predeterminado es false. Cuando la propiedad se establece en true, solo se usará el token de AAD para autenticarse si el usuario puede publicar en el tema. Bool
inboundIpRules Esto se puede usar para restringir el tráfico de direcciones IP específicas en lugar de todas las direcciones IP. Nota: Estos se consideran solo si PublicNetworkAccess está habilitado. inboundIpRule []
inputSchema Esto determina el formato que Event Grid debe esperar para los eventos entrantes publicados en el tema. "CloudEventSchemaV1_0"
'CustomEventSchema'
'EventGridSchema'
inputSchemaMapping Esto permite la publicación mediante esquemas de eventos personalizados. Se puede especificar InputSchemaMapping para asignar varias propiedades de un esquema de origen a varias propiedades necesarias del esquema EventGridEvent. InputSchemaMapping
publicNetworkAccess Esto determina si se permite el tráfico a través de la red pública. De forma predeterminada, está habilitado.
Puede restringir aún más a direcciones IP específicas configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" />
'Deshabilitado'
'Habilitado'

TrackedResourceTags

Nombre Descripción Valor

UserIdentityProperties

Nombre Descripción Valor
clientId Identificador de cliente de la identidad asignada por el usuario. cuerda
principalId Identificador principal de la identidad asignada por el usuario. cuerda